@itwin/presentation-hierarchies-react 2.0.0-alpha.3 → 2.0.0-alpha.30

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/TreeErrorRenderer.d.ts

@@ -0,0 +1,43 @@
+import { ReactElement } from "react";
+import { HierarchyLevelDetails, TreeRendererProps } from "../Renderers.js";
+import { ErrorItem } from "./FlatTreeNode.js";
+/**
+ * Interface containing error item related actions.
+ *
+ * @alpha
+ */
+interface TreeErrorItemProps {
+    /** A callback to reload a hierarchy level when an error occurs and `retry` button is clicked. */
+    reloadTree: (options: {
+        parentNodeId: string | undefined;
+        state: "reset";
+    }) => void;
+    /** Action to perform when the filter button is clicked for this node. */
+    onFilterClick?: (hierarchyLevelDetails: HierarchyLevelDetails) => void;
+    /** Action to perform when an error accurs and node label is clicked in the error message */
+    scrollToElement: (errorNode: ErrorItem) => void;
+}
+/**
+ * Interface containing building blocks for `TreeErrorRenderer`.
+ *
+ * @alpha
+ */
+interface TreeErrorRendererOwnProps {
+    /** List of errors to be displayed */
+    errorList: ErrorItem[];
+    renderError?: ({ errorItem, scrollToElement }: {
+        errorItem: ErrorItem;
+        scrollToElement: () => void;
+    }) => ReactElement;
+}
+/** @alpha */
+export type TreeErrorRendererProps = TreeErrorRendererOwnProps & TreeErrorItemProps & Pick<TreeRendererProps, "getHierarchyLevelDetails">;
+/**
+ * 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({ errorList, reloadTree, scrollToElement, getHierarchyLevelDetails, onFilterClick, renderError }: TreeErrorRendererProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TreeErrorRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeErrorRenderer.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/TreeErrorRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAIrC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C;;;;GAIG;AACH,UAAU,kBAAkB;IAC1B,iGAAiG;IACjG,UAAU,EAAE,CAAC,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACpF,yEAAyE;IACzE,aAAa,CAAC,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACvE,4FAA4F;IAC5F,eAAe,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACjD;AACD;;;;GAIG;AACH,UAAU,yBAAyB;IACjC,qCAAqC;IACrC,SAAS,EAAE,SAAS,EAAE,CAAC;IAEvB,WAAW,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,eAAe,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,YAAY,CAAC;CACvH;AAED,aAAa;AACb,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,GAAG,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,CAAC;AAE1I;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,wBAAwB,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,sBAAsB,2CAgFzJ"}

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

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+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";
+/**
+ * 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 function TreeErrorRenderer({ errorList, reloadTree, scrollToElement, getHierarchyLevelDetails, onFilterClick, renderError }) {
+    const { localizedStrings } = useLocalizationContext();
+    const errorItems = errorList.map(({ errorNode, expandTo }) => {
+        if (renderError) {
+            return renderError({ errorItem: { errorNode, expandTo }, scrollToElement: () => scrollToElement({ errorNode, expandTo }) });
+        }
+        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 && onFilterClick?.(hierarchyLevelDetails);
+                        },
+                        label: localizedStrings.increaseHierarchyLimitWithFiltering,
+                        condition: () => !!onFilterClick && !!errorNode?.isFilterable,
+                    },
+                ], message: localizedStrings.resultLimitExceeded.replace("{{limit}}", limit.toString()), scrollToElement: () => scrollToElement({ errorNode, expandTo }) }, errorNode.error.id));
+        }
+        if (errorNode.error?.type === "NoFilterMatches") {
+            return (_jsx(ErrorItemContainer, { errorNode: errorNode, actions: [
+                    {
+                        action: () => {
+                            const hierarchyLevelDetails = getHierarchyLevelDetails?.(errorNode.id);
+                            hierarchyLevelDetails && onFilterClick?.(hierarchyLevelDetails);
+                        },
+                        label: localizedStrings.noFilteredChildrenChangeFilter,
+                        condition: () => true,
+                    },
+                ], message: localizedStrings.noFilteredChildren, scrollToElement: () => scrollToElement({ errorNode, expandTo }) }, errorNode.error.id));
+        }
+        return (_jsx(ErrorItemContainer, { errorNode: errorNode, actions: [
+                {
+                    action: () => reloadTree({ parentNodeId: errorNode.id, state: "reset" }),
+                    label: localizedStrings.retry,
+                    condition: () => true,
+                },
+            ], message: localizedStrings.failedToCreateHierarchy, scrollToElement: () => scrollToElement({ errorNode, expandTo }) }, errorNode.id));
+    });
+    return (_jsx(ErrorRegion.Root, { style: { width: "100%" }, label: errorList.length !== 0 ? `${errorList.length} ${localizedStrings?.issuesFound}` : undefined, items: errorItems }));
+}
+function ErrorItemContainer({ errorNode, message, actions, scrollToElement }) {
+    return (_jsx(ErrorRegion.Item, { message: _jsx(MessageWithLink, { linkLabel: errorNode.label, scrollToElement: scrollToElement, message: message }), messageId: errorNode.id, actions: _jsx("div", { style: { display: "flex", flexDirection: "column" }, children: actions
+                ?.filter(({ condition }) => condition())
+                .map(({ label, action }) => (_jsx(Anchor, { onClick: action, 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: [_jsx(Text, { variant: "body-sm", children: splitMessage[0] }), _jsx(Anchor, { onClick: scrollToElement, children: linkLabel }), splitMessage[1] ? _jsx(Text, { variant: "body-sm", children: splitMessage[1] }) : null] }));
+}
+//# sourceMappingURL=TreeErrorRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeErrorRenderer.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/TreeErrorRenderer.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 { ReactElement } from \"react\";\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 { PresentationHierarchyNode } from \"../TreeNode.js\";\nimport { ErrorItem } from \"./FlatTreeNode.js\";\nimport { useLocalizationContext } from \"./LocalizationContext.js\";\n\n/**\n * Interface containing error item related actions.\n *\n * @alpha\n */\ninterface TreeErrorItemProps {\n  /** A callback to reload a hierarchy level when an error occurs and `retry` button is clicked. */\n  reloadTree: (options: { parentNodeId: string | undefined; state: \"reset\" }) => void;\n  /** Action to perform when the filter button is clicked for this node. */\n  onFilterClick?: (hierarchyLevelDetails: HierarchyLevelDetails) => void;\n  /** Action to perform when an error accurs and node label is clicked in the error message */\n  scrollToElement: (errorNode: ErrorItem) => void;\n}\n/**\n * Interface containing building blocks for `TreeErrorRenderer`.\n *\n * @alpha\n */\ninterface TreeErrorRendererOwnProps {\n  /** List of errors to be displayed */\n  errorList: ErrorItem[];\n  // Callback to render custom error messages. Component should be wrapped in `ErrorRegion.Item` from `@itwin/itwinui-react` package.\n  renderError?: ({ errorItem, scrollToElement }: { errorItem: ErrorItem; scrollToElement: () => void }) => ReactElement;\n}\n\n/** @alpha */\nexport type TreeErrorRendererProps = TreeErrorRendererOwnProps & TreeErrorItemProps & Pick<TreeRendererProps, \"getHierarchyLevelDetails\">;\n\n/**\n * A component that renders error display dropdown using the `unstable_ErrorRegion` component from `@itwin/itwinui-react`.\n * As input, the component uses a list of `ErrorNode` objects, which are generally created using the `useErrorList` hook.\n *\n * @alpha\n */\nexport function TreeErrorRenderer({ errorList, reloadTree, scrollToElement, getHierarchyLevelDetails, onFilterClick, renderError }: TreeErrorRendererProps) {\n  const { localizedStrings } = useLocalizationContext();\n  const errorItems = errorList.map(({ errorNode, expandTo }) => {\n    if (renderError) {\n      return renderError({ errorItem: { errorNode, expandTo }, scrollToElement: () => scrollToElement({ errorNode, expandTo }) });\n    }\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          key={errorNode.error.id}\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 && onFilterClick?.(hierarchyLevelDetails);\n              },\n              label: localizedStrings.increaseHierarchyLimitWithFiltering,\n              condition: () => !!onFilterClick && !!errorNode?.isFilterable,\n            },\n          ]}\n          message={localizedStrings.resultLimitExceeded.replace(\"{{limit}}\", limit.toString())}\n          scrollToElement={() => scrollToElement({ errorNode, expandTo })}\n        />\n      );\n    }\n    if (errorNode.error?.type === \"NoFilterMatches\") {\n      return (\n        <ErrorItemContainer\n          key={errorNode.error.id}\n          errorNode={errorNode}\n          actions={[\n            {\n              action: () => {\n                const hierarchyLevelDetails = getHierarchyLevelDetails?.(errorNode.id);\n                hierarchyLevelDetails && onFilterClick?.(hierarchyLevelDetails);\n              },\n              label: localizedStrings.noFilteredChildrenChangeFilter,\n              condition: () => true,\n            },\n          ]}\n          message={localizedStrings.noFilteredChildren}\n          scrollToElement={() => scrollToElement({ errorNode, expandTo })}\n        />\n      );\n    }\n    return (\n      <ErrorItemContainer\n        key={errorNode.id}\n        errorNode={errorNode}\n        actions={[\n          {\n            action: () => reloadTree({ parentNodeId: errorNode.id, state: \"reset\" }),\n            label: localizedStrings.retry,\n            condition: () => true,\n          },\n        ]}\n        message={localizedStrings.failedToCreateHierarchy}\n        scrollToElement={() => scrollToElement({ errorNode, expandTo })}\n      />\n    );\n  });\n\n  return (\n    <ErrorRegion.Root\n      style={{ width: \"100%\" }}\n      label={errorList.length !== 0 ? `${errorList.length} ${localizedStrings?.issuesFound}` : undefined}\n      items={errorItems}\n    />\n  );\n}\n\ntype ErrorItemContainerProps = {\n  errorNode: PresentationHierarchyNode;\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={\n        <div style={{ display: \"flex\", flexDirection: \"column\" }}>\n          {actions\n            ?.filter(({ condition }) => condition())\n            .map(({ label, action }) => (\n              <Anchor key={label} onClick={action}>\n                {label}\n              </Anchor>\n            ))}\n        </div>\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      <Text variant={\"body-sm\"}>{splitMessage[0]}</Text>\n      <Anchor onClick={scrollToElement}>{linkLabel}</Anchor>\n      {splitMessage[1] ? <Text variant={\"body-sm\"}>{splitMessage[1]}</Text> : null}\n    </div>\n  );\n}\n"]}

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

@@ -0,0 +1,49 @@
+import { ComponentPropsWithoutRef, FC, PropsWithRef, ReactElement, ReactNode, RefAttributes } from "react";
+import { Tree } from "@stratakit/structures";
+import { TreeRendererProps } from "../Renderers.js";
+import { PresentationHierarchyNode } from "../TreeNode.js";
+/** @alpha */
+type TreeNodeProps = ComponentPropsWithoutRef<typeof Tree.Item>;
+/** @alpha */
+export interface TreeNodeRendererOwnProps {
+    /** Node that is rendered. */
+    node: PresentationHierarchyNode;
+    /** Returns a label for a given node. */
+    getLabel?: (node: PresentationHierarchyNode) => ReactElement | undefined;
+    /** Returns sublabel for a given node. */
+    getSublabel?: (node: PresentationHierarchyNode) => ReactElement | undefined;
+    /** Action to perform when the node is clicked. */
+    onNodeClick?: (node: PresentationHierarchyNode, isSelected: boolean, event: React.MouseEvent<HTMLElement>) => void;
+    /** Action to perform when a key is pressed when the node is hovered on. */
+    onNodeKeyDown?: (node: PresentationHierarchyNode, isSelected: boolean, event: React.KeyboardEvent<HTMLElement>) => void;
+    /**
+     * Used to render elements between expander and label.
+     * E.g. icons, color picker, etc.
+     */
+    getDecorations?: (node: PresentationHierarchyNode) => ReactNode;
+    /**
+     * Callback that returns menu actions for tree item.
+     * Must return an array of `Tree.ItemAction` elements.
+     */
+    getMenuActions?: (node: PresentationHierarchyNode) => ReactNode[];
+    /**
+     * Callback that returns inline actions for tree item.
+     * Must return an array of `Tree.ItemAction` elements.
+     * Max 2 items.
+     */
+    getInlineActions?: (node: PresentationHierarchyNode) => ReactNode[];
+}
+/** @alpha */
+type TreeNodeRendererProps = Pick<TreeRendererProps, "expandNode" | "reloadTree"> & Omit<TreeNodeProps, "actions" | "label" | "expanded" | "unstable_decorations" | "error"> & TreeNodeRendererOwnProps;
+/**
+ * A component that renders given `FlatTreeNode` using the `Tree.Item` component from `@itwin/itwinui-react`. The
+ * `FlatTreeNode` objects for this renderer are generally created using the `useFlatTreeNodeList` hook.
+ *
+ * @see `TreeRenderer`
+ * @see https://itwinui.bentley.com/docs/tree
+ * @public
+ */
+export declare const StrataKitTreeNodeRenderer: FC<PropsWithRef<TreeNodeRendererProps & RefAttributes<HTMLElement>>>;
+export declare const PlaceholderNode: FC<PropsWithRef<Omit<TreeNodeProps, "onExpanded" | "label" | "actions" | "icon" | "error"> & RefAttributes<HTMLElement>>>;
+export {};
+//# sourceMappingURL=TreeNodeRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeNodeRenderer.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/TreeNodeRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,EACL,wBAAwB,EACxB,EAAE,EAKF,YAAY,EACZ,YAAY,EACZ,SAAS,EAET,aAAa,EAMd,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAI3D,aAAa;AACb,KAAK,aAAa,GAAG,wBAAwB,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AAEhE,aAAa;AACb,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,IAAI,EAAE,yBAAyB,CAAC;IAChC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,YAAY,GAAG,SAAS,CAAC;IACzE,yCAAyC;IACzC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,YAAY,GAAG,SAAS,CAAC;IAC5E,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACnH,2EAA2E;IAC3E,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACxH;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,SAAS,CAAC;IAChE;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,SAAS,EAAE,CAAC;IAClE;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,SAAS,EAAE,CAAC;CACrE;AAED,aAAa;AACb,KAAK,qBAAqB,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,YAAY,CAAC,GAC/E,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,sBAAsB,GAAG,OAAO,CAAC,GACxF,wBAAwB,CAAC;AAE3B;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,EAAE,CAAC,YAAY,CAAC,qBAAqB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAgH1G,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAKrJ,CAAC"}

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

@@ -0,0 +1,116 @@
+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 { forwardRef, memo, useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { Spinner, TextBox } from "@stratakit/bricks";
+import refreshSvg from "@stratakit/icons/refresh.svg";
+import { Tree } from "@stratakit/structures";
+import { useLocalizationContext } from "./LocalizationContext.js";
+import { useRenameContext } from "./RenameAction.js";
+/**
+ * A component that renders given `FlatTreeNode` using the `Tree.Item` component from `@itwin/itwinui-react`. The
+ * `FlatTreeNode` objects for this renderer are generally created using the `useFlatTreeNodeList` hook.
+ *
+ * @see `TreeRenderer`
+ * @see https://itwinui.bentley.com/docs/tree
+ * @public
+ */
+export const StrataKitTreeNodeRenderer = memo(forwardRef(function HierarchyNode({ node, selected, expandNode, onNodeClick, onNodeKeyDown, reloadTree, getLabel, getSublabel, getMenuActions, getInlineActions, getDecorations, ...treeItemProps }, forwardedRef) {
+    const nodeRef = useRef(null);
+    const ref = useMergedRefs(forwardedRef, nodeRef);
+    const { localizedStrings } = useLocalizationContext();
+    const renameContext = useRenameContext();
+    const label = useMemo(() => (getLabel ? getLabel(node) : node.label), [getLabel, node]);
+    const description = useMemo(() => (getSublabel ? getSublabel(node) : undefined), [getSublabel, node]);
+    const decorations = useMemo(() => getDecorations?.(node), [getDecorations, node]);
+    const inlineActions = useMemo(() => {
+        if (node.error !== undefined && node.error.type === "Unknown") {
+            return [
+                _jsx(Tree.ItemAction, { label: localizedStrings.retry, onClick: () => reloadTree({ parentNodeId: node.id, state: "reset" }), visible: true, icon: refreshSvg }, "retry"),
+            ];
+        }
+        if (!getInlineActions) {
+            return [];
+        }
+        return getInlineActions(node);
+    }, [node, getInlineActions, localizedStrings.retry, reloadTree]);
+    const expanded = useMemo(() => {
+        if (node.error) {
+            return undefined;
+        }
+        if (node.isExpanded || node.children === true || node.children.length > 0) {
+            return node.isExpanded;
+        }
+        return undefined;
+    }, [node.children, node.error, node.isExpanded]);
+    const isDisabled = treeItemProps["aria-disabled"] === true;
+    const { onLabelChanged, setIsRenaming, isRenaming } = renameContext ?? {};
+    const labelEditor = isRenaming ? (_jsx(LabelEditor, { initialLabel: node.label, onChange: (newLabel) => {
+            onLabelChanged?.(newLabel);
+            setIsRenaming?.(false);
+        }, onCancel: () => {
+            setIsRenaming?.(false);
+        } })) : undefined;
+    return (_jsx(Tree.Item, { ...treeItemProps, ref: ref, label: labelEditor ?? label, description: description, selected: selected, expanded: expanded, onExpandedChange: useCallback((isExpanded) => {
+            expandNode(node.id, isExpanded);
+        }, [node, expandNode]), onClick: useCallback((event) => {
+            if (isDisabled) {
+                return;
+            }
+            onNodeClick?.(node, !selected, event);
+        }, [node, isDisabled, selected, onNodeClick]), onKeyDown: useCallback((event) => {
+            // Ignore if it is called on the element inside, e.g. checkbox or expander
+            if (!isDisabled && event.target === nodeRef.current) {
+                onNodeKeyDown?.(node, !selected, event);
+            }
+        }, [onNodeKeyDown, selected, isDisabled, node]), inlineActions: inlineActions, actions: useMemo(() => (node.error === undefined && getMenuActions ? getMenuActions(node) : []), [getMenuActions, node]), unstable_decorations: decorations, error: node.error ? node.error.id : undefined }));
+}));
+export const PlaceholderNode = memo(forwardRef(function PlaceholderNode({ ...props }, forwardedRef) {
+    const { localizedStrings } = useLocalizationContext();
+    return _jsx(Tree.Item, { ...props, ref: forwardedRef, label: localizedStrings.loading, icon: _jsx(Spinner, { size: "small", title: localizedStrings.loading }) });
+}));
+function LabelEditor({ initialLabel, onChange, onCancel }) {
+    const inputRef = useRef(null);
+    const [newLabelValue, setNewLabelValue] = useState(initialLabel);
+    const handleLabelChange = () => {
+        if (initialLabel !== newLabelValue) {
+            onChange(newLabelValue);
+            return;
+        }
+        onCancel();
+    };
+    const cancelLabelChange = () => {
+        setNewLabelValue(initialLabel);
+        onCancel();
+    };
+    useEffect(() => {
+        if (inputRef.current) {
+            inputRef.current.focus();
+            inputRef.current.select();
+        }
+    }, []);
+    return (_jsx(TextBox.Root, { children: _jsx(TextBox.Input, { ref: inputRef, value: newLabelValue, onChange: (event) => setNewLabelValue(event.target.value), onBlur: handleLabelChange, onKeyDown: (event) => {
+                if (event.key === "Enter") {
+                    handleLabelChange();
+                }
+                else if (event.key === "Escape") {
+                    cancelLabelChange();
+                }
+            } }) }));
+}
+function useMergedRefs(...refs) {
+    return useCallback((instance) => {
+        refs.forEach((ref) => {
+            if (typeof ref === "function") {
+                ref(instance);
+            }
+            else if (ref) {
+                ref.current = instance;
+            }
+        });
+    }, // eslint-disable-next-line react-hooks/exhaustive-deps
+    [...refs]);
+}
+//# sourceMappingURL=TreeNodeRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeNodeRenderer.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/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 {\n  ComponentPropsWithoutRef,\n  FC,\n  forwardRef,\n  LegacyRef,\n  memo,\n  MutableRefObject,\n  PropsWithRef,\n  ReactElement,\n  ReactNode,\n  Ref,\n  RefAttributes,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { Spinner, TextBox } from \"@stratakit/bricks\";\nimport refreshSvg from \"@stratakit/icons/refresh.svg\";\nimport { Tree } from \"@stratakit/structures\";\nimport { TreeRendererProps } from \"../Renderers.js\";\nimport { PresentationHierarchyNode } from \"../TreeNode.js\";\nimport { useLocalizationContext } from \"./LocalizationContext.js\";\nimport { useRenameContext } from \"./RenameAction.js\";\n\n/** @alpha */\ntype TreeNodeProps = ComponentPropsWithoutRef<typeof Tree.Item>;\n\n/** @alpha */\nexport interface TreeNodeRendererOwnProps {\n  /** Node that is rendered. */\n  node: PresentationHierarchyNode;\n  /** Returns a label for a given node. */\n  getLabel?: (node: PresentationHierarchyNode) => ReactElement | undefined;\n  /** Returns sublabel for a given node. */\n  getSublabel?: (node: PresentationHierarchyNode) => ReactElement | undefined;\n  /** Action to perform when the node is clicked. */\n  onNodeClick?: (node: PresentationHierarchyNode, isSelected: boolean, event: React.MouseEvent<HTMLElement>) => void;\n  /** Action to perform when a key is pressed when the node is hovered on. */\n  onNodeKeyDown?: (node: PresentationHierarchyNode, isSelected: boolean, event: React.KeyboardEvent<HTMLElement>) => void;\n  /**\n   * Used to render elements between expander and label.\n   * E.g. icons, color picker, etc.\n   */\n  getDecorations?: (node: PresentationHierarchyNode) => ReactNode;\n  /**\n   * Callback that returns menu actions for tree item.\n   * Must return an array of `Tree.ItemAction` elements.\n   */\n  getMenuActions?: (node: PresentationHierarchyNode) => ReactNode[];\n  /**\n   * Callback that returns inline actions for tree item.\n   * Must return an array of `Tree.ItemAction` elements.\n   * Max 2 items.\n   */\n  getInlineActions?: (node: PresentationHierarchyNode) => ReactNode[];\n}\n\n/** @alpha */\ntype TreeNodeRendererProps = Pick<TreeRendererProps, \"expandNode\" | \"reloadTree\"> &\n  Omit<TreeNodeProps, \"actions\" | \"label\" | \"expanded\" | \"unstable_decorations\" | \"error\"> &\n  TreeNodeRendererOwnProps;\n\n/**\n * A component that renders given `FlatTreeNode` using the `Tree.Item` component from `@itwin/itwinui-react`. The\n * `FlatTreeNode` objects for this renderer are generally created using the `useFlatTreeNodeList` hook.\n *\n * @see `TreeRenderer`\n * @see https://itwinui.bentley.com/docs/tree\n * @public\n */\nexport const StrataKitTreeNodeRenderer: FC<PropsWithRef<TreeNodeRendererProps & RefAttributes<HTMLElement>>> = memo(\n  forwardRef<HTMLElement, TreeNodeRendererProps>(function HierarchyNode(\n    {\n      node,\n      selected,\n      expandNode,\n      onNodeClick,\n      onNodeKeyDown,\n      reloadTree,\n      getLabel,\n      getSublabel,\n      getMenuActions,\n      getInlineActions,\n      getDecorations,\n      ...treeItemProps\n    },\n    forwardedRef,\n  ) {\n    const nodeRef = useRef<HTMLElement>(null);\n    const ref = useMergedRefs(forwardedRef, nodeRef);\n    const { localizedStrings } = useLocalizationContext();\n    const renameContext = useRenameContext();\n\n    const label = useMemo(() => (getLabel ? getLabel(node) : node.label), [getLabel, node]);\n    const description = useMemo(() => (getSublabel ? getSublabel(node) : undefined), [getSublabel, node]);\n    const decorations = useMemo(() => getDecorations?.(node), [getDecorations, node]);\n    const inlineActions = useMemo(() => {\n      if (node.error !== undefined && node.error.type === \"Unknown\") {\n        return [\n          <Tree.ItemAction\n            key=\"retry\"\n            label={localizedStrings.retry}\n            onClick={() => reloadTree({ parentNodeId: node.id, state: \"reset\" })}\n            visible={true}\n            icon={refreshSvg}\n          />,\n        ];\n      }\n      if (!getInlineActions) {\n        return [];\n      }\n      return getInlineActions(node);\n    }, [node, getInlineActions, localizedStrings.retry, reloadTree]);\n\n    const expanded = useMemo(() => {\n      if (node.error) {\n        return undefined;\n      }\n\n      if (node.isExpanded || node.children === true || node.children.length > 0) {\n        return node.isExpanded;\n      }\n\n      return undefined;\n    }, [node.children, node.error, node.isExpanded]);\n\n    const isDisabled = treeItemProps[\"aria-disabled\"] === true;\n\n    const { onLabelChanged, setIsRenaming, isRenaming } = renameContext ?? {};\n    const labelEditor = isRenaming ? (\n      <LabelEditor\n        initialLabel={node.label}\n        onChange={(newLabel) => {\n          onLabelChanged?.(newLabel);\n          setIsRenaming?.(false);\n        }}\n        onCancel={() => {\n          setIsRenaming?.(false);\n        }}\n      />\n    ) : undefined;\n\n    return (\n      <Tree.Item\n        {...treeItemProps}\n        ref={ref}\n        label={labelEditor ?? label}\n        description={description}\n        selected={selected}\n        expanded={expanded}\n        onExpandedChange={useCallback(\n          (isExpanded: boolean) => {\n            expandNode(node.id, isExpanded);\n          },\n          [node, expandNode],\n        )}\n        onClick={useCallback<Required<TreeNodeProps>[\"onClick\"]>(\n          (event) => {\n            if (isDisabled) {\n              return;\n            }\n\n            onNodeClick?.(node, !selected, event);\n          },\n          [node, isDisabled, selected, onNodeClick],\n        )}\n        onKeyDown={useCallback<Required<TreeNodeProps>[\"onKeyDown\"]>(\n          (event) => {\n            // Ignore if it is called on the element inside, e.g. checkbox or expander\n            if (!isDisabled && event.target === nodeRef.current) {\n              onNodeKeyDown?.(node, !selected, event);\n            }\n          },\n          [onNodeKeyDown, selected, isDisabled, node],\n        )}\n        inlineActions={inlineActions}\n        actions={useMemo(() => (node.error === undefined && getMenuActions ? getMenuActions(node) : []), [getMenuActions, node])}\n        unstable_decorations={decorations}\n        error={node.error ? node.error.id : undefined}\n      />\n    );\n  }),\n);\n\nexport const PlaceholderNode: FC<PropsWithRef<Omit<TreeNodeProps, \"onExpanded\" | \"label\" | \"actions\" | \"icon\" | \"error\"> & RefAttributes<HTMLElement>>> = memo(\n  forwardRef<HTMLElement, Omit<TreeNodeProps, \"onExpanded\" | \"label\" | \"actions\" | \"icon\" | \"error\">>(function PlaceholderNode({ ...props }, forwardedRef) {\n    const { localizedStrings } = useLocalizationContext();\n    return <Tree.Item {...props} ref={forwardedRef} label={localizedStrings.loading} icon={<Spinner size={\"small\"} title={localizedStrings.loading} />} />;\n  }),\n);\n\nfunction LabelEditor({ initialLabel, onChange, onCancel }: { initialLabel: string; onChange: (newLabel: string) => void; onCancel: () => void }) {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const [newLabelValue, setNewLabelValue] = useState(initialLabel);\n  const handleLabelChange = () => {\n    if (initialLabel !== newLabelValue) {\n      onChange(newLabelValue);\n      return;\n    }\n    onCancel();\n  };\n\n  const cancelLabelChange = () => {\n    setNewLabelValue(initialLabel);\n    onCancel();\n  };\n\n  useEffect(() => {\n    if (inputRef.current) {\n      inputRef.current.focus();\n      inputRef.current.select();\n    }\n  }, []);\n\n  return (\n    <TextBox.Root>\n      <TextBox.Input\n        ref={inputRef}\n        value={newLabelValue}\n        onChange={(event) => setNewLabelValue(event.target.value)}\n        onBlur={handleLabelChange}\n        onKeyDown={(event) => {\n          if (event.key === \"Enter\") {\n            handleLabelChange();\n          } else if (event.key === \"Escape\") {\n            cancelLabelChange();\n          }\n        }}\n      />\n    </TextBox.Root>\n  );\n}\n\nfunction useMergedRefs<T>(...refs: ReadonlyArray<Ref<T> | LegacyRef<T> | undefined | null>) {\n  return useCallback(\n    (instance: T | null) => {\n      refs.forEach((ref) => {\n        if (typeof ref === \"function\") {\n          ref(instance);\n        } else if (ref) {\n          (ref as MutableRefObject<T | null>).current = instance;\n        }\n      });\n    }, // eslint-disable-next-line react-hooks/exhaustive-deps\n    [...refs],\n  );\n}\n"]}

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

@@ -0,0 +1,40 @@
+import { ComponentPropsWithoutRef, ReactElement } from "react";
+import { Tree } from "@stratakit/structures";
+import { TreeRendererProps } from "../Renderers.js";
+import { PresentationHierarchyNode } from "../TreeNode.js";
+import { SelectionMode } from "../UseSelectionHandler.js";
+import { LocalizationContextProvider } from "./LocalizationContext.js";
+import { TreeErrorRendererProps } from "./TreeErrorRenderer.js";
+import { StrataKitTreeNodeRenderer } from "./TreeNodeRenderer.js";
+/** @alpha */
+export type TreeProps = ComponentPropsWithoutRef<typeof Tree.Root>;
+/** @alpha */
+export type TreeNodeRendererProps = ComponentPropsWithoutRef<typeof StrataKitTreeNodeRenderer>;
+/** @alpha */
+interface TreeRendererOwnProps {
+    /** Active selection mode used by the tree. Defaults to `"single"`. */
+    selectionMode?: SelectionMode;
+    /** A render function for errors' display component. Defaults to `<TreeErrorRenderer />`. */
+    errorRenderer?: (props: TreeErrorRendererProps) => ReactElement;
+    /** Props that defines if current node supports editing. */
+    getEditingProps?: (node: PresentationHierarchyNode) => {
+        /**
+         * A callback that is invoked when node label is changed. Should be used together
+         * with `<RenameAction />` to enter label editing mode. Node label is not editable
+         * when this is not supplied.
+         */
+        onLabelChanged?: (newLabel: string) => void;
+    };
+}
+/** @alpha */
+type StrataKitTreeRendererProps = TreeRendererProps & Pick<TreeErrorRendererProps, "onFilterClick"> & Omit<TreeNodeRendererProps, "node" | "aria-level" | "aria-posinset" | "aria-setsize" | "reloadTree" | "selected" | "error"> & TreeRendererOwnProps & ComponentPropsWithoutRef<typeof LocalizationContextProvider>;
+/**
+ * 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
+ * @alpha
+ */
+export declare function StrataKitTreeRenderer({ rootNodes, selectNodes, selectionMode, expandNode, localizedStrings, getHierarchyLevelDetails, onFilterClick, reloadTree, isNodeSelected, errorRenderer, onNodeClick: onNodeClickOverride, onNodeKeyDown: onNodeKeyDownOverride, getEditingProps, ...treeProps }: StrataKitTreeRendererProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TreeRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeRenderer.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/TreeRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAmC,YAAY,EAA2C,MAAM,OAAO,CAAC;AACzI,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAuB,MAAM,2BAA2B,CAAC;AAG/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAqB,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAmB,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,aAAa;AACb,MAAM,MAAM,SAAS,GAAG,wBAAwB,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AAEnE,aAAa;AACb,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE/F,aAAa;AACb,UAAU,oBAAoB;IAC5B,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,4FAA4F;IAC5F,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,YAAY,CAAC;IAChE,2DAA2D;IAC3D,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK;QACrD;;;;WAIG;QACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;KAC7C,CAAC;CACH;AAED,aAAa;AACb,KAAK,0BAA0B,GAAG,iBAAiB,GACjD,IAAI,CAAC,sBAAsB,EAAE,eAAe,CAAC,GAC7C,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC,GAC3H,oBAAoB,GACpB,wBAAwB,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,WAAW,EACX,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAW,EAAE,mBAAmB,EAChC,aAAa,EAAE,qBAAqB,EACpC,eAAe,EACf,GAAG,SAAS,EACb,EAAE,0BAA0B,2CAsF5B"}

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

@@ -0,0 +1,93 @@
+import { createElement as _createElement } from "react";
+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 { forwardRef, memo, useCallback, useEffect, useMemo, useRef } from "react";
+import { Tree } from "@stratakit/structures";
+import { useVirtualizer } from "@tanstack/react-virtual";
+import { useSelectionHandler } from "../UseSelectionHandler.js";
+import { useEvent } from "../Utils.js";
+import { isPlaceholderItem, useErrorList, useFlatTreeItems } from "./FlatTreeNode.js";
+import { LocalizationContextProvider } from "./LocalizationContext.js";
+import { RenameContextProvider } from "./RenameAction.js";
+import { TreeErrorRenderer } from "./TreeErrorRenderer.js";
+import { PlaceholderNode, StrataKitTreeNodeRenderer } from "./TreeNodeRenderer.js";
+/**
+ * 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
+ * @alpha
+ */
+export function StrataKitTreeRenderer({ rootNodes, selectNodes, selectionMode, expandNode, localizedStrings, getHierarchyLevelDetails, onFilterClick, reloadTree, isNodeSelected, errorRenderer, onNodeClick: onNodeClickOverride, onNodeKeyDown: onNodeKeyDownOverride, getEditingProps, ...treeProps }) {
+    const { onNodeClick, onNodeKeyDown } = useSelectionHandler({
+        rootNodes,
+        selectNodes: selectNodes ?? noopSelectNodes,
+        selectionMode: selectionMode ?? "single",
+    });
+    const handleNodeClick = useEvent(onNodeClickOverride ?? onNodeClick);
+    const handleKeyDown = useEvent(onNodeKeyDownOverride ?? onNodeKeyDown);
+    const flatItems = useFlatTreeItems(rootNodes);
+    const errorList = useErrorList(rootNodes);
+    const scrollToNode = useRef(undefined);
+    const parentRef = useRef(null);
+    const virtualizer = useVirtualizer({
+        count: flatItems.length,
+        getScrollElement: () => parentRef.current,
+        getItemKey: (index) => flatItems[index].id,
+        estimateSize: () => 28,
+        overscan: 10,
+    });
+    const items = virtualizer.getVirtualItems();
+    const scrollToElement = useCallback(({ errorNode, expandTo }) => {
+        const index = flatItems.findIndex((flatItem) => flatItem.id === errorNode.id);
+        if (index === -1) {
+            expandTo((nodeId) => expandNode(nodeId, true));
+            scrollToNode.current = errorNode.id;
+            return;
+        }
+        virtualizer.scrollToIndex(index, { align: "end" });
+    }, [expandNode, flatItems, virtualizer]);
+    useEffect(() => {
+        if (scrollToNode.current === undefined) {
+            return;
+        }
+        const index = flatItems.findIndex((flatItem) => flatItem.id === scrollToNode.current);
+        if (index === -1) {
+            return;
+        }
+        virtualizer.scrollToIndex(index, { align: "end" });
+        scrollToNode.current = undefined;
+    }, [flatItems, virtualizer]);
+    const errorRendererProps = {
+        errorList,
+        scrollToElement,
+        getHierarchyLevelDetails,
+        onFilterClick,
+        reloadTree,
+    };
+    return (_jsxs(LocalizationContextProvider, { localizedStrings: localizedStrings, children: [errorRenderer ? errorRenderer(errorRendererProps) : _jsx(TreeErrorRenderer, { ...errorRendererProps }), _jsx("div", { style: { height: "100%", width: "100%", overflowY: "auto" }, ref: parentRef, children: _jsx(Tree.Root, { style: { height: virtualizer.getTotalSize(), minHeight: "100%", width: "100%", position: "relative", overflow: "hidden" }, children: items.map((virtualizedItem) => {
+                        const item = flatItems[virtualizedItem.index];
+                        const selected = isNodeSelected?.(item.id) ?? false;
+                        return (_createElement(VirtualTreeItem, { ...treeProps, onNodeClick: handleNodeClick, onNodeKeyDown: handleKeyDown, ref: virtualizer.measureElement, start: virtualizedItem.start, expandNode: expandNode, item: item, key: virtualizedItem.key, "data-index": virtualizedItem.index, reloadTree: reloadTree, selected: selected, getEditingProps: getEditingProps }));
+                    }) }) })] }));
+}
+const VirtualTreeItem = memo(forwardRef(function VirtualTreeItem({ start, item, getDecorations, getMenuActions, getInlineActions, getLabel, getSublabel, expandNode, reloadTree, onNodeClick, onNodeKeyDown, getEditingProps, ...props }, forwardedRef) {
+    const style = useMemo(() => ({
+        position: "absolute",
+        top: 0,
+        left: 0,
+        width: "100%",
+        transform: `translateY(${start}px)`,
+        willChange: "transform",
+    }), [start]);
+    if (isPlaceholderItem(item)) {
+        return _jsx(PlaceholderNode, { ...props, ref: forwardedRef, style: style, "aria-level": item.level, "aria-posinset": 1, "aria-setsize": 1 });
+    }
+    const editingProps = getEditingProps?.(item.node);
+    return (_jsx(RenameContextProvider, { onLabelChanged: editingProps?.onLabelChanged, children: _jsx(StrataKitTreeNodeRenderer, { ...props, ref: forwardedRef, style: style, "aria-level": item.level, "aria-posinset": item.posInLevel, "aria-setsize": item.levelSize, node: item.node, expandNode: expandNode, reloadTree: reloadTree, getDecorations: getDecorations, getMenuActions: getMenuActions, getInlineActions: getInlineActions, getLabel: getLabel, getSublabel: getSublabel, onNodeClick: onNodeClick, onNodeKeyDown: onNodeKeyDown }) }));
+}));
+function noopSelectNodes() { }
+//# sourceMappingURL=TreeRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeRenderer.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/TreeRenderer.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 { ComponentPropsWithoutRef, CSSProperties, forwardRef, memo, ReactElement, useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { Tree } from \"@stratakit/structures\";\nimport { useVirtualizer } from \"@tanstack/react-virtual\";\nimport { TreeRendererProps } from \"../Renderers.js\";\nimport { PresentationHierarchyNode } from \"../TreeNode.js\";\nimport { SelectionMode, useSelectionHandler } from \"../UseSelectionHandler.js\";\nimport { useEvent } from \"../Utils.js\";\nimport { ErrorItem, FlatTreeItem, isPlaceholderItem, useErrorList, useFlatTreeItems } from \"./FlatTreeNode.js\";\nimport { LocalizationContextProvider } from \"./LocalizationContext.js\";\nimport { RenameContextProvider } from \"./RenameAction.js\";\nimport { TreeErrorRenderer, TreeErrorRendererProps } from \"./TreeErrorRenderer.js\";\nimport { PlaceholderNode, StrataKitTreeNodeRenderer } from \"./TreeNodeRenderer.js\";\n\n/** @alpha */\nexport type TreeProps = ComponentPropsWithoutRef<typeof Tree.Root>;\n\n/** @alpha */\nexport type TreeNodeRendererProps = ComponentPropsWithoutRef<typeof StrataKitTreeNodeRenderer>;\n\n/** @alpha */\ninterface TreeRendererOwnProps {\n  /** Active selection mode used by the tree. Defaults to `\"single\"`. */\n  selectionMode?: SelectionMode;\n  /** A render function for errors' display component. Defaults to `<TreeErrorRenderer />`. */\n  errorRenderer?: (props: TreeErrorRendererProps) => ReactElement;\n  /** Props that defines if current node supports editing. */\n  getEditingProps?: (node: PresentationHierarchyNode) => {\n    /**\n     * A callback that is invoked when node label is changed. Should be used together\n     * with `<RenameAction />` to enter label editing mode. Node label is not editable\n     * when this is not supplied.\n     */\n    onLabelChanged?: (newLabel: string) => void;\n  };\n}\n\n/** @alpha */\ntype StrataKitTreeRendererProps = TreeRendererProps &\n  Pick<TreeErrorRendererProps, \"onFilterClick\"> &\n  Omit<TreeNodeRendererProps, \"node\" | \"aria-level\" | \"aria-posinset\" | \"aria-setsize\" | \"reloadTree\" | \"selected\" | \"error\"> &\n  TreeRendererOwnProps &\n  ComponentPropsWithoutRef<typeof LocalizationContextProvider>;\n\n/**\n * A component that renders a tree using the `Tree` component from `@itwin/itwinui-react`. The tree nodes\n * are rendered using `TreeNodeRenderer` component from this package.\n *\n * @see https://itwinui.bentley.com/docs/tree\n * @alpha\n */\nexport function StrataKitTreeRenderer({\n  rootNodes,\n  selectNodes,\n  selectionMode,\n  expandNode,\n  localizedStrings,\n  getHierarchyLevelDetails,\n  onFilterClick,\n  reloadTree,\n  isNodeSelected,\n  errorRenderer,\n  onNodeClick: onNodeClickOverride,\n  onNodeKeyDown: onNodeKeyDownOverride,\n  getEditingProps,\n  ...treeProps\n}: StrataKitTreeRendererProps) {\n  const { onNodeClick, onNodeKeyDown } = useSelectionHandler({\n    rootNodes,\n    selectNodes: selectNodes ?? noopSelectNodes,\n    selectionMode: selectionMode ?? \"single\",\n  });\n  const handleNodeClick = useEvent(onNodeClickOverride ?? onNodeClick);\n  const handleKeyDown = useEvent(onNodeKeyDownOverride ?? onNodeKeyDown);\n  const flatItems = useFlatTreeItems(rootNodes);\n  const errorList = useErrorList(rootNodes);\n\n  const scrollToNode = useRef<string | undefined>(undefined);\n  const parentRef = useRef<HTMLDivElement>(null);\n\n  const virtualizer = useVirtualizer({\n    count: flatItems.length,\n    getScrollElement: () => parentRef.current,\n    getItemKey: (index) => flatItems[index].id,\n    estimateSize: () => 28,\n    overscan: 10,\n  });\n\n  const items = virtualizer.getVirtualItems();\n\n  const scrollToElement = useCallback(\n    ({ errorNode, expandTo }: ErrorItem) => {\n      const index = flatItems.findIndex((flatItem) => flatItem.id === errorNode.id);\n      if (index === -1) {\n        expandTo((nodeId) => expandNode(nodeId, true));\n        scrollToNode.current = errorNode.id;\n        return;\n      }\n      virtualizer.scrollToIndex(index, { align: \"end\" });\n    },\n    [expandNode, flatItems, virtualizer],\n  );\n\n  useEffect(() => {\n    if (scrollToNode.current === undefined) {\n      return;\n    }\n    const index = flatItems.findIndex((flatItem) => flatItem.id === scrollToNode.current);\n    if (index === -1) {\n      return;\n    }\n    virtualizer.scrollToIndex(index, { align: \"end\" });\n    scrollToNode.current = undefined;\n  }, [flatItems, virtualizer]);\n\n  const errorRendererProps: TreeErrorRendererProps = {\n    errorList,\n    scrollToElement,\n    getHierarchyLevelDetails,\n    onFilterClick,\n    reloadTree,\n  };\n\n  return (\n    <LocalizationContextProvider localizedStrings={localizedStrings}>\n      {errorRenderer ? errorRenderer(errorRendererProps) : <TreeErrorRenderer {...errorRendererProps} />}\n      <div style={{ height: \"100%\", width: \"100%\", overflowY: \"auto\" }} ref={parentRef}>\n        <Tree.Root style={{ height: virtualizer.getTotalSize(), minHeight: \"100%\", width: \"100%\", position: \"relative\", overflow: \"hidden\" }}>\n          {items.map((virtualizedItem) => {\n            const item = flatItems[virtualizedItem.index];\n            const selected = isNodeSelected?.(item.id) ?? false;\n            return (\n              <VirtualTreeItem\n                {...treeProps}\n                onNodeClick={handleNodeClick}\n                onNodeKeyDown={handleKeyDown}\n                ref={virtualizer.measureElement}\n                start={virtualizedItem.start}\n                expandNode={expandNode}\n                item={item}\n                key={virtualizedItem.key}\n                data-index={virtualizedItem.index}\n                reloadTree={reloadTree}\n                selected={selected}\n                getEditingProps={getEditingProps}\n              />\n            );\n          })}\n        </Tree.Root>\n      </div>\n    </LocalizationContextProvider>\n  );\n}\n\ntype VirtualTreeItemProps = Omit<TreeNodeRendererProps, \"node\" | \"aria-level\" | \"aria-posinset\" | \"aria-setsize\"> & {\n  start: number;\n  item: FlatTreeItem;\n  getEditingProps?: TreeRendererOwnProps[\"getEditingProps\"];\n};\n\nconst VirtualTreeItem = memo(\n  forwardRef<HTMLElement, VirtualTreeItemProps>(function VirtualTreeItem(\n    {\n      start,\n      item,\n      getDecorations,\n      getMenuActions,\n      getInlineActions,\n      getLabel,\n      getSublabel,\n      expandNode,\n      reloadTree,\n      onNodeClick,\n      onNodeKeyDown,\n      getEditingProps,\n      ...props\n    },\n    forwardedRef,\n  ) {\n    const style: CSSProperties = useMemo(\n      () => ({\n        position: \"absolute\",\n        top: 0,\n        left: 0,\n        width: \"100%\",\n        transform: `translateY(${start}px)`,\n        willChange: \"transform\",\n      }),\n      [start],\n    );\n\n    if (isPlaceholderItem(item)) {\n      return <PlaceholderNode {...props} ref={forwardedRef} style={style} aria-level={item.level} aria-posinset={1} aria-setsize={1} />;\n    }\n\n    const editingProps = getEditingProps?.(item.node);\n    return (\n      <RenameContextProvider onLabelChanged={editingProps?.onLabelChanged}>\n        <StrataKitTreeNodeRenderer\n          {...props}\n          ref={forwardedRef}\n          style={style}\n          aria-level={item.level}\n          aria-posinset={item.posInLevel}\n          aria-setsize={item.levelSize}\n          node={item.node}\n          expandNode={expandNode}\n          reloadTree={reloadTree}\n          getDecorations={getDecorations}\n          getMenuActions={getMenuActions}\n          getInlineActions={getInlineActions}\n          getLabel={getLabel}\n          getSublabel={getSublabel}\n          onNodeClick={onNodeClick}\n          onNodeKeyDown={onNodeKeyDown}\n        />\n      </RenameContextProvider>\n    );\n  }),\n);\n\nfunction noopSelectNodes() {}\n"]}