@itwin/presentation-hierarchies-react 2.0.0-alpha.53 → 2.0.0-alpha.55

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

@@ -0,0 +1 @@
+{"version":3,"file":"UseUnifiedSelection.d.ts","names":[],"sources":["../../../src/presentation-hierarchies-react/internal/UseUnifiedSelection.ts"],"mappings":";;;;;;;UAuBiB,4BAAA;EAoByG;;;EAhBxH,UAAA;EAAA;;;;;;;;;;;;;;EAgBA,8BAAA,IAAkC,IAAA,EAAM,wBAAA;IAA6B,GAAA,EAAK,cAAA;EAAA,GAAkB,eAAA,aAA4B,UAAA;;;;EAKxH,gBAAA,EAAkB,gBAAA;AAAA"}

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

@@ -0,0 +1,142 @@
+import { c } from "react-compiler-runtime";
+import { useEffect, useState } from "react";
+import { HierarchyNode } from "@itwin/presentation-hierarchies";
+import { assert } from "@itwin/core-bentley";
+import { Selectables } from "@itwin/unified-selection";
+
+//#region src/presentation-hierarchies-react/internal/UseUnifiedSelection.ts
+/** @internal */
+function useUnifiedTreeSelection(t0) {
+	const $ = c(6);
+	const { sourceName, selectionStorage, getTreeModelNode, createSelectableForGenericNode: t1 } = t0;
+	const createSelectableForGenericNode = t1 === void 0 ? defaultCreateSelectableForGenericNode : t1;
+	const [options, setOptions] = useState(_temp3);
+	let t2;
+	let t3;
+	if ($[0] !== createSelectableForGenericNode || $[1] !== getTreeModelNode || $[2] !== selectionStorage || $[3] !== sourceName) {
+		t2 = () => {
+			setOptions(createOptions(sourceName, selectionStorage, createSelectableForGenericNode, getTreeModelNode));
+			return selectionStorage.selectionChangeEvent.addListener((args) => {
+				if (args.level > 0) return;
+				setOptions(createOptions(sourceName, selectionStorage, createSelectableForGenericNode, getTreeModelNode));
+			});
+		};
+		t3 = [
+			selectionStorage,
+			createSelectableForGenericNode,
+			getTreeModelNode,
+			sourceName
+		];
+		$[0] = createSelectableForGenericNode;
+		$[1] = getTreeModelNode;
+		$[2] = selectionStorage;
+		$[3] = sourceName;
+		$[4] = t2;
+		$[5] = t3;
+	} else {
+		t2 = $[4];
+		t3 = $[5];
+	}
+	useEffect(t2, t3);
+	return options;
+}
+function _temp3() {
+	return {
+		isNodeSelected: _temp,
+		selectNodes: _temp2
+	};
+}
+function _temp2() {}
+function _temp() {
+	return false;
+}
+const defaultCreateSelectableForGenericNode = (node, treeModelNodeId) => ({
+	identifier: treeModelNodeId,
+	data: node,
+	async *loadInstanceKeys() {}
+});
+function createOptions(source, storage, createSelectableForGenericNode, getNode) {
+	return {
+		isNodeSelected: (nodeId) => {
+			const node = getNode(nodeId);
+			if (!node || node.id === void 0) return false;
+			for (const [imodelKey, nodeSelectables] of groupNodeSelectablesByIModelKey(node, createSelectableForGenericNode)) {
+				const storageSelectables = storage.getSelection({
+					imodelKey,
+					level: 0
+				});
+				if (Selectables.hasAny(storageSelectables, nodeSelectables)) return true;
+			}
+			return false;
+		},
+		selectNodes: (nodeIds, changeType) => {
+			const imodelSelectables = /* @__PURE__ */ new Map();
+			for (const nodeId of nodeIds) {
+				const node = getNode(nodeId);
+				if (!node || node.id === void 0) return;
+				for (const [imodelKey, nodeSelectables] of groupNodeSelectablesByIModelKey(node, createSelectableForGenericNode)) {
+					let selectablesList = imodelSelectables.get(imodelKey);
+					if (!selectablesList) {
+						selectablesList = [];
+						imodelSelectables.set(imodelKey, selectablesList);
+					}
+					nodeSelectables.forEach((selectable) => selectablesList.push(selectable));
+				}
+			}
+			imodelSelectables.forEach((selectables, imodelKey) => {
+				const actionProps = {
+					imodelKey,
+					source,
+					selectables,
+					level: 0
+				};
+				switch (changeType) {
+					case "add":
+						storage.addToSelection(actionProps);
+						return;
+					case "remove":
+						storage.removeFromSelection(actionProps);
+						return;
+					case "replace":
+						storage.replaceSelection(actionProps);
+						return;
+				}
+			});
+		}
+	};
+}
+function groupNodeSelectablesByIModelKey(modelNode, createSelectableForGenericNode) {
+	const hierarchyNode = modelNode.nodeData;
+	if (HierarchyNode.isInstancesNode(hierarchyNode)) return groupIModelInstanceKeys(hierarchyNode.key.instanceKeys);
+	if (HierarchyNode.isGroupingNode(hierarchyNode)) {
+		const groupingNodeSelectables = /* @__PURE__ */ new Map();
+		groupIModelInstanceKeys(hierarchyNode.groupedInstanceKeys).forEach((instanceKeys, imodelKey) => {
+			groupingNodeSelectables.set(imodelKey, [{
+				identifier: modelNode.id,
+				data: hierarchyNode,
+				async *loadInstanceKeys() {
+					for (const key of instanceKeys) yield key;
+				}
+			}]);
+		});
+		return groupingNodeSelectables;
+	}
+	assert(HierarchyNode.isGeneric(hierarchyNode));
+	return new Map([["", [createSelectableForGenericNode(hierarchyNode, modelNode.id)]]]);
+}
+function groupIModelInstanceKeys(instanceKeys) {
+	return instanceKeys.reduce((imodelSelectables, key) => {
+		const imodelKey = key.imodelKey ?? "";
+		let selectablesList = imodelSelectables.get(imodelKey);
+		if (!selectablesList) {
+			selectablesList = [];
+			imodelSelectables.set(imodelKey, selectablesList);
+		}
+		selectablesList.push(key);
+		return imodelSelectables;
+	}, /* @__PURE__ */ new Map());
+}
+
+//#endregion
+export { useUnifiedTreeSelection };
+//# sourceMappingURL=UseUnifiedSelection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UseUnifiedSelection.js","names":["useEffect","useState","assert","HierarchyNode","Selectables","GenericNodeKey","InstancesNodeKey","NonGroupingHierarchyNode","InstanceKey","Selectable","SelectionStorage","SelectionChangeType","TreeModelHierarchyNode","TreeModelRootNode","TreeSelectionOptions","isNodeSelected","nodeId","selectNodes","nodeIds","Array","changeType","UseUnifiedTreeSelectionProps","sourceName","createSelectableForGenericNode","node","key","treeModelNodeId","selectionStorage","useUnifiedTreeSelection","t0","$","_c","getTreeModelNode","t1","undefined","defaultCreateSelectableForGenericNode","options","setOptions","_temp3","t2","t3","createOptions","selectionChangeEvent","addListener","args","level","_temp","_temp2","NonNullable","identifier","data","loadInstanceKeys","source","storage","getNode","id","imodelKey","nodeSelectables","groupNodeSelectablesByIModelKey","storageSelectables","getSelection","hasAny","imodelSelectables","Map","selectablesList","get","set","forEach","selectable","push","selectables","actionProps","addToSelection","removeFromSelection","replaceSelection","modelNode","hierarchyNode","nodeData","isInstancesNode","groupIModelInstanceKeys","instanceKeys","isGroupingNode","groupingNodeSelectables","groupedInstanceKeys","isGeneric","reduce"],"sources":["../../../src/presentation-hierarchies-react/internal/UseUnifiedSelection.ts"],"sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { useEffect, useState } from \"react\";\nimport { assert } from \"@itwin/core-bentley\";\nimport { HierarchyNode } from \"@itwin/presentation-hierarchies\";\nimport { Selectables } from \"@itwin/unified-selection\";\n\nimport type { GenericNodeKey, InstancesNodeKey, NonGroupingHierarchyNode } from \"@itwin/presentation-hierarchies\";\nimport type { InstanceKey } from \"@itwin/presentation-shared\";\nimport type { Selectable, SelectionStorage } from \"@itwin/unified-selection\";\nimport type { SelectionChangeType } from \"../UseSelectionHandler.js\";\nimport type { TreeModelHierarchyNode, TreeModelRootNode } from \"./TreeModel.js\";\n\n/** @internal */\nexport interface TreeSelectionOptions {\n  isNodeSelected: (nodeId: string) => boolean;\n  selectNodes: (nodeIds: Array<string>, changeType: SelectionChangeType) => void;\n}\n\n/** @public */\nexport interface UseUnifiedTreeSelectionProps {\n  /**\n   * Identifier to distinguish this source of changes to the unified selection from another ones in the application.\n   */\n  sourceName: string;\n\n  /**\n   * An optional function that allows customizing the `Selectable` object that gets created for generic hierarchy nodes. When\n   * not supplied, the `Selectable` is created using the following signature:\n   * ```ts\n   * {\n   *   identifier: treeModelNodeId,\n   *   data: node,\n   *   async *loadInstanceKeys() {},\n   * }\n   * ```\n   *\n   * @param node Hierarchy node to create a selectable for.\n   * @param treeModelNodeId ID of the hierarchy node in the internal tree model. This ID uniquely identifies the node in the whole hierarchy, as opposed to `GenericNodeKey.id` contained within the `node`, which may not be unique.\n   */\n  createSelectableForGenericNode?: (node: NonGroupingHierarchyNode & { key: GenericNodeKey }, treeModelNodeId: string) => Selectable;\n\n  /**\n   * Unified selection storage to use for listening, getting and changing active selection.\n   */\n  selectionStorage: SelectionStorage;\n}\n\n/** @internal */\nexport function useUnifiedTreeSelection({\n  sourceName,\n  selectionStorage,\n  getTreeModelNode,\n  createSelectableForGenericNode = defaultCreateSelectableForGenericNode,\n}: UseUnifiedTreeSelectionProps & { getTreeModelNode: (nodeId: string) => TreeModelHierarchyNode | TreeModelRootNode | undefined }): TreeSelectionOptions {\n  const [options, setOptions] = useState<TreeSelectionOptions>(() => ({\n    isNodeSelected: /* c8 ignore next */ () => false,\n    selectNodes: /* c8 ignore next */ () => {},\n  }));\n\n  useEffect(() => {\n    // eslint-disable-next-line react-hooks/set-state-in-effect\n    setOptions(createOptions(sourceName, selectionStorage, createSelectableForGenericNode, getTreeModelNode));\n    return selectionStorage.selectionChangeEvent.addListener((args) => {\n      if (args.level > 0) {\n        return;\n      }\n      setOptions(createOptions(sourceName, selectionStorage, createSelectableForGenericNode, getTreeModelNode));\n    });\n  }, [selectionStorage, createSelectableForGenericNode, getTreeModelNode, sourceName]);\n\n  return options;\n}\n\nconst defaultCreateSelectableForGenericNode: NonNullable<UseUnifiedTreeSelectionProps[\"createSelectableForGenericNode\"]> = (\n  node,\n  treeModelNodeId,\n): Selectable => ({\n  identifier: treeModelNodeId,\n  data: node,\n  async *loadInstanceKeys() {},\n});\n\nfunction createOptions(\n  source: string,\n  storage: SelectionStorage,\n  createSelectableForGenericNode: NonNullable<UseUnifiedTreeSelectionProps[\"createSelectableForGenericNode\"]>,\n  getNode: (nodeId: string) => TreeModelHierarchyNode | TreeModelRootNode | undefined,\n): TreeSelectionOptions {\n  return {\n    isNodeSelected: (nodeId: string) => {\n      const node = getNode(nodeId);\n      if (!node || node.id === undefined) {\n        return false;\n      }\n      for (const [imodelKey, nodeSelectables] of groupNodeSelectablesByIModelKey(node, createSelectableForGenericNode)) {\n        const storageSelectables = storage.getSelection({ imodelKey, level: 0 });\n        if (Selectables.hasAny(storageSelectables, nodeSelectables)) {\n          return true;\n        }\n      }\n      return false;\n    },\n\n    selectNodes: (nodeIds: Array<string>, changeType: SelectionChangeType) => {\n      const imodelSelectables = new Map<string, Selectable[]>();\n      for (const nodeId of nodeIds) {\n        const node = getNode(nodeId);\n        if (!node || node.id === undefined) {\n          return;\n        }\n        for (const [imodelKey, nodeSelectables] of groupNodeSelectablesByIModelKey(node, createSelectableForGenericNode)) {\n          let selectablesList = imodelSelectables.get(imodelKey);\n          if (!selectablesList) {\n            selectablesList = [];\n            imodelSelectables.set(imodelKey, selectablesList);\n          }\n          nodeSelectables.forEach((selectable) => selectablesList.push(selectable));\n        }\n      }\n      imodelSelectables.forEach((selectables, imodelKey) => {\n        const actionProps = { imodelKey, source, selectables, level: 0 };\n        switch (changeType) {\n          case \"add\":\n            storage.addToSelection(actionProps);\n            return;\n          case \"remove\":\n            storage.removeFromSelection(actionProps);\n            return;\n          case \"replace\":\n            storage.replaceSelection(actionProps);\n            return;\n        }\n      });\n    },\n  };\n}\n\nfunction groupNodeSelectablesByIModelKey(\n  modelNode: TreeModelHierarchyNode,\n  createSelectableForGenericNode: NonNullable<UseUnifiedTreeSelectionProps[\"createSelectableForGenericNode\"]>,\n): Map<string, Selectable[]> {\n  const hierarchyNode = modelNode.nodeData;\n  if (HierarchyNode.isInstancesNode(hierarchyNode)) {\n    return groupIModelInstanceKeys(hierarchyNode.key.instanceKeys);\n  }\n  if (HierarchyNode.isGroupingNode(hierarchyNode)) {\n    const groupingNodeSelectables = new Map<string, Selectable[]>();\n    groupIModelInstanceKeys(hierarchyNode.groupedInstanceKeys).forEach((instanceKeys, imodelKey) => {\n      groupingNodeSelectables.set(imodelKey, [\n        {\n          identifier: modelNode.id,\n          data: hierarchyNode,\n          async *loadInstanceKeys() {\n            for (const key of instanceKeys) {\n              yield key;\n            }\n          },\n        },\n      ]);\n    });\n    return groupingNodeSelectables;\n  }\n  assert(HierarchyNode.isGeneric(hierarchyNode));\n  // note: generic nodes aren't associated with an imodel\n  return new Map([[\"\", [createSelectableForGenericNode(hierarchyNode, modelNode.id)]]]);\n}\n\nfunction groupIModelInstanceKeys(instanceKeys: InstancesNodeKey[\"instanceKeys\"]) {\n  return instanceKeys.reduce((imodelSelectables, key) => {\n    const imodelKey = key.imodelKey ?? \"\";\n    let selectablesList = imodelSelectables.get(imodelKey);\n    if (!selectablesList) {\n      selectablesList = [];\n      imodelSelectables.set(imodelKey, selectablesList);\n    }\n    selectablesList.push(key);\n    return imodelSelectables;\n  }, new Map<string, InstanceKey[]>());\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,43 @@
+import "./DisposePolyfill.js";
+import { HierarchyNodeKey } from "@itwin/presentation-hierarchies";
+
+//#region src/presentation-hierarchies-react/internal/Utils.ts
+/** @internal */
+function createNodeId(node) {
+	return [...node.parentKeys.map(serializeNodeKey), serializeNodeKey(node.key)].join(";");
+}
+function serializeNodeKey(key) {
+	return convertObjectValuesToString(key);
+}
+function convertObjectValuesToString(obj) {
+	return Object.entries(obj).map(([, value]) => {
+		if (typeof value === "object") return convertObjectValuesToString(value);
+		return String(value);
+	}).join(",");
+}
+/** @internal */
+function sameNodes(lhs, rhs) {
+	if (HierarchyNodeKey.compare(lhs.key, rhs.key) !== 0) return false;
+	if (lhs.parentKeys.length !== rhs.parentKeys.length) return false;
+	for (let i = lhs.parentKeys.length - 1; i >= 0; --i) if (HierarchyNodeKey.compare(lhs.parentKeys[i], rhs.parentKeys[i]) !== 0) return false;
+	return true;
+}
+/** @internal */
+const MAX_LIMIT_OVERRIDE = 1e4;
+/**
+* A helper that disposes the given object, if it's disposable.
+*
+* The first option is to dispose using the deprecated `dispose` method if it exists on the object.
+* If not, we use the new `Symbol.dispose` method. If that doesn't exist either, the object is
+* considered as non-disposable and nothing is done with it.
+*
+* @internal
+*/
+function safeDispose(disposable) {
+	if ("dispose" in disposable) disposable.dispose();
+	else if (Symbol.dispose in disposable) disposable[Symbol.dispose]();
+}
+
+//#endregion
+export { MAX_LIMIT_OVERRIDE, createNodeId, safeDispose, sameNodes };
+//# sourceMappingURL=Utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","names":["HierarchyNodeKey","HierarchyNode","createNodeId","node","Pick","parentKeys","map","serializeNodeKey","key","join","convertObjectValuesToString","obj","Object","entries","value","String","sameNodes","lhs","rhs","compare","length","i","MAX_LIMIT_OVERRIDE","safeDispose","disposable","Symbol","dispose"],"sources":["../../../src/presentation-hierarchies-react/internal/Utils.ts"],"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 \"./DisposePolyfill.js\";\n\nimport { HierarchyNodeKey } from \"@itwin/presentation-hierarchies\";\n\nimport type { HierarchyNode } from \"@itwin/presentation-hierarchies\";\n\n/** @internal */\nexport function createNodeId(node: Pick<HierarchyNode, \"key\" | \"parentKeys\">) {\n  return [...node.parentKeys.map(serializeNodeKey), serializeNodeKey(node.key)].join(\";\");\n}\n\nfunction serializeNodeKey(key: HierarchyNodeKey): string {\n  return convertObjectValuesToString(key);\n}\n\nfunction convertObjectValuesToString(obj: object): string {\n  return Object.entries(obj)\n    .map(([, value]) => {\n      if (typeof value === \"object\") {\n        return convertObjectValuesToString(value);\n      }\n      return String(value);\n    })\n    .join(\",\");\n}\n\n/** @internal */\nexport function sameNodes(lhs: HierarchyNode, rhs: HierarchyNode): boolean {\n  if (HierarchyNodeKey.compare(lhs.key, rhs.key) !== 0) {\n    return false;\n  }\n\n  if (lhs.parentKeys.length !== rhs.parentKeys.length) {\n    return false;\n  }\n\n  for (let i = lhs.parentKeys.length - 1; i >= 0; --i) {\n    if (HierarchyNodeKey.compare(lhs.parentKeys[i], rhs.parentKeys[i]) !== 0) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** @internal */\nexport const MAX_LIMIT_OVERRIDE = 10000;\n\n/**\n * A helper that disposes the given object, if it's disposable.\n *\n * The first option is to dispose using the deprecated `dispose` method if it exists on the object.\n * If not, we use the new `Symbol.dispose` method. If that doesn't exist either, the object is\n * considered as non-disposable and nothing is done with it.\n *\n * @internal\n */\nexport function safeDispose(disposable: {} | { [Symbol.dispose]: () => void } | { dispose: () => void }) {\n  if (\"dispose\" in disposable) {\n    disposable.dispose();\n  } else if (Symbol.dispose in disposable) {\n    disposable[Symbol.dispose]();\n  }\n}\n"],"mappings":";;;;;AAYA,SAAgBE,aAAaC,MAAiD;AAC5E,QAAO,CAAC,GAAGA,KAAKE,WAAWC,IAAIC,iBAAiB,EAAEA,iBAAiBJ,KAAKK,IAAI,CAAC,CAACC,KAAK,IAAI;;AAGzF,SAASF,iBAAiBC,KAA+B;AACvD,QAAOE,4BAA4BF,IAAI;;AAGzC,SAASE,4BAA4BC,KAAqB;AACxD,QAAOC,OAAOC,QAAQF,IAAI,CACvBL,KAAK,GAAGQ,WAAW;AAClB,MAAI,OAAOA,UAAU,SACnB,QAAOJ,4BAA4BI,MAAM;AAE3C,SAAOC,OAAOD,MAAM;GACpB,CACDL,KAAK,IAAI;;;AAId,SAAgBO,UAAUC,KAAoBC,KAA6B;AACzE,KAAIlB,iBAAiBmB,QAAQF,IAAIT,KAAKU,IAAIV,IAAI,KAAK,EACjD,QAAO;AAGT,KAAIS,IAAIZ,WAAWe,WAAWF,IAAIb,WAAWe,OAC3C,QAAO;AAGT,MAAK,IAAIC,IAAIJ,IAAIZ,WAAWe,SAAS,GAAGC,KAAK,GAAG,EAAEA,EAChD,KAAIrB,iBAAiBmB,QAAQF,IAAIZ,WAAWgB,IAAIH,IAAIb,WAAWgB,GAAG,KAAK,EACrE,QAAO;AAGX,QAAO;;;AAIT,MAAaC,qBAAqB;;;;;;;;;;AAWlC,SAAgBC,YAAYC,YAA6E;AACvG,KAAI,aAAaA,WACfA,YAAWE,SAAS;UACXD,OAAOC,WAAWF,WAC3BA,YAAWC,OAAOC,UAAU"}

package/lib/presentation-hierarchies-react/stratakit/ErrorItemRenderer.d.ts

@@ -0,0 +1,38 @@
+import { TreeNode } from "../TreeNode.js";
+import { HierarchyLevelDetails, TreeRendererProps } from "../Renderers.js";
+import { useErrorNodes } from "./FlatTreeNode.js";
+import { JSX } from "react";
+
+//#region src/presentation-hierarchies-react/stratakit/ErrorItemRenderer.d.ts
+/** @alpha */
+interface ErrorItemRendererProps extends Pick<TreeRendererProps, "getHierarchyLevelDetails"> {
+  /** A node containing an error. */
+  errorNode: ReturnType<typeof useErrorNodes>[number];
+  /** A callback to reload a hierarchy level when an error occurs and `retry` button is clicked. */
+  reloadTree: (options: {
+    parentNodeId: string | undefined;
+  }) => void;
+  /** A callback to scroll to the node associated with the error. */
+  scrollToNode: (errorNode: TreeNode) => void;
+  /** A callback to initiate filtering of the given hierarchy level. */
+  filterHierarchyLevel?: (hierarchyLevelDetails: HierarchyLevelDetails) => void;
+}
+/**
+ * Renders StrataKit `<ErrorRegion.Item />` for all supported error types:
+ * - `ResultSetTooLarge` - renders `resultLimitExceeded` message with actions to increase limit or apply filtering
+ * - `NoFilterMatches` - renders `noFilteredChildren` message with action to change filter
+ * - `ChildrenLoad` - renders `failedToCreateHierarchy` message with action to retry loading
+ * - `Unknown` - renders message set on error object.
+ *
+ * @alpha
+ */
+declare function ErrorItemRenderer({
+  errorNode,
+  getHierarchyLevelDetails,
+  filterHierarchyLevel,
+  reloadTree,
+  scrollToNode
+}: ErrorItemRendererProps): JSX.Element;
+//#endregion
+export { ErrorItemRenderer, ErrorItemRendererProps };
+//# sourceMappingURL=ErrorItemRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorItemRenderer.d.ts","names":[],"sources":["../../../src/presentation-hierarchies-react/stratakit/ErrorItemRenderer.tsx"],"mappings":";;;;;;;UAgBiB,sBAAA,SAA+B,IAAA,CAAK,iBAAA;EAApC;EAEf,SAAA,EAAW,UAAA,QAAkB,aAAA;;EAE7B,UAAA,GAAa,OAAA;IAAW,YAAA;EAAA;EAEE;EAA1B,YAAA,GAAe,SAAA,EAAW,QAAA;EANoB;EAQ9C,oBAAA,IAAwB,qBAAA,EAAuB,qBAAA;AAAA;;;;;;;;;;iBAYjC,iBAAA,CAAA;EACd,SAAA;EACA,wBAAA;EACA,oBAAA;EACA,UAAA;EACA;AAAA,GACC,sBAAA,GAAyB,GAAA,CAAI,OAAA"}

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

@@ -0,0 +1,381 @@
+import { MAX_LIMIT_OVERRIDE } from "../internal/Utils.js";
+import { useTranslation } from "./LocalizationContext.js";
+import { c } from "react-compiler-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { unstable_ErrorRegion } from "@stratakit/structures";
+import { Anchor, Text } from "@stratakit/bricks";
+
+//#region src/presentation-hierarchies-react/stratakit/ErrorItemRenderer.tsx
+/**
+* Renders StrataKit `<ErrorRegion.Item />` for all supported error types:
+* - `ResultSetTooLarge` - renders `resultLimitExceeded` message with actions to increase limit or apply filtering
+* - `NoFilterMatches` - renders `noFilteredChildren` message with action to change filter
+* - `ChildrenLoad` - renders `failedToCreateHierarchy` message with action to retry loading
+* - `Unknown` - renders message set on error object.
+*
+* @alpha
+*/
+function ErrorItemRenderer(t0) {
+	const $ = c(83);
+	const { errorNode, getHierarchyLevelDetails, filterHierarchyLevel, reloadTree, scrollToNode } = t0;
+	const translate = useTranslation();
+	if (errorNode.error.type === "ResultSetTooLarge") {
+		const limit = errorNode.error.resultSetSizeLimit;
+		let t1;
+		if ($[0] !== errorNode.id || $[1] !== getHierarchyLevelDetails) {
+			t1 = () => getHierarchyLevelDetails(errorNode.id)?.setSizeLimit(MAX_LIMIT_OVERRIDE);
+			$[0] = errorNode.id;
+			$[1] = getHierarchyLevelDetails;
+			$[2] = t1;
+		} else t1 = $[2];
+		const onOverrideLimit = t1;
+		let t2;
+		if ($[3] !== onOverrideLimit) {
+			t2 = () => {
+				onOverrideLimit();
+			};
+			$[3] = onOverrideLimit;
+			$[4] = t2;
+		} else t2 = $[4];
+		let t3;
+		if ($[5] !== translate) {
+			t3 = translate("increaseHierarchyLimit").replace("{{limit}}", MAX_LIMIT_OVERRIDE.toString());
+			$[5] = translate;
+			$[6] = t3;
+		} else t3 = $[6];
+		let t4;
+		if ($[7] !== limit) {
+			t4 = () => limit < MAX_LIMIT_OVERRIDE;
+			$[7] = limit;
+			$[8] = t4;
+		} else t4 = $[8];
+		let t5;
+		if ($[9] !== t2 || $[10] !== t3 || $[11] !== t4) {
+			t5 = {
+				action: t2,
+				label: t3,
+				condition: t4
+			};
+			$[9] = t2;
+			$[10] = t3;
+			$[11] = t4;
+			$[12] = t5;
+		} else t5 = $[12];
+		let t6;
+		if ($[13] !== errorNode.id || $[14] !== filterHierarchyLevel || $[15] !== getHierarchyLevelDetails) {
+			t6 = () => {
+				const hierarchyLevelDetails = getHierarchyLevelDetails(errorNode.id);
+				hierarchyLevelDetails && filterHierarchyLevel?.(hierarchyLevelDetails);
+			};
+			$[13] = errorNode.id;
+			$[14] = filterHierarchyLevel;
+			$[15] = getHierarchyLevelDetails;
+			$[16] = t6;
+		} else t6 = $[16];
+		let t7;
+		if ($[17] !== translate) {
+			t7 = translate("increaseHierarchyLimitWithFiltering");
+			$[17] = translate;
+			$[18] = t7;
+		} else t7 = $[18];
+		let t8;
+		if ($[19] !== errorNode.isFilterable || $[20] !== filterHierarchyLevel) {
+			t8 = () => !!filterHierarchyLevel && !!errorNode.isFilterable;
+			$[19] = errorNode.isFilterable;
+			$[20] = filterHierarchyLevel;
+			$[21] = t8;
+		} else t8 = $[21];
+		let t9;
+		if ($[22] !== t6 || $[23] !== t7 || $[24] !== t8) {
+			t9 = {
+				action: t6,
+				label: t7,
+				condition: t8
+			};
+			$[22] = t6;
+			$[23] = t7;
+			$[24] = t8;
+			$[25] = t9;
+		} else t9 = $[25];
+		let t10;
+		if ($[26] !== t5 || $[27] !== t9) {
+			t10 = [t5, t9];
+			$[26] = t5;
+			$[27] = t9;
+			$[28] = t10;
+		} else t10 = $[28];
+		let t11;
+		if ($[29] !== limit || $[30] !== translate) {
+			t11 = translate("resultLimitExceeded").replace("{{limit}}", limit.toString());
+			$[29] = limit;
+			$[30] = translate;
+			$[31] = t11;
+		} else t11 = $[31];
+		let t12;
+		if ($[32] !== errorNode || $[33] !== scrollToNode) {
+			t12 = () => scrollToNode(errorNode);
+			$[32] = errorNode;
+			$[33] = scrollToNode;
+			$[34] = t12;
+		} else t12 = $[34];
+		let t13;
+		if ($[35] !== errorNode || $[36] !== t10 || $[37] !== t11 || $[38] !== t12) {
+			t13 = /* @__PURE__ */ jsx(ErrorItemContainer, {
+				errorNode,
+				actions: t10,
+				message: t11,
+				scrollToElement: t12
+			});
+			$[35] = errorNode;
+			$[36] = t10;
+			$[37] = t11;
+			$[38] = t12;
+			$[39] = t13;
+		} else t13 = $[39];
+		return t13;
+	}
+	if (errorNode.error.type === "NoFilterMatches") {
+		let t1;
+		if ($[40] !== errorNode.id || $[41] !== filterHierarchyLevel || $[42] !== getHierarchyLevelDetails) {
+			t1 = () => {
+				const hierarchyLevelDetails_0 = getHierarchyLevelDetails(errorNode.id);
+				hierarchyLevelDetails_0 && filterHierarchyLevel?.(hierarchyLevelDetails_0);
+			};
+			$[40] = errorNode.id;
+			$[41] = filterHierarchyLevel;
+			$[42] = getHierarchyLevelDetails;
+			$[43] = t1;
+		} else t1 = $[43];
+		let t2;
+		if ($[44] !== translate) {
+			t2 = translate("noFilteredChildrenChangeFilter");
+			$[44] = translate;
+			$[45] = t2;
+		} else t2 = $[45];
+		let t3;
+		if ($[46] !== t1 || $[47] !== t2) {
+			t3 = [{
+				action: t1,
+				label: t2,
+				condition: _temp
+			}];
+			$[46] = t1;
+			$[47] = t2;
+			$[48] = t3;
+		} else t3 = $[48];
+		let t4;
+		if ($[49] !== translate) {
+			t4 = translate("noFilteredChildren");
+			$[49] = translate;
+			$[50] = t4;
+		} else t4 = $[50];
+		let t5;
+		if ($[51] !== errorNode || $[52] !== scrollToNode) {
+			t5 = () => scrollToNode(errorNode);
+			$[51] = errorNode;
+			$[52] = scrollToNode;
+			$[53] = t5;
+		} else t5 = $[53];
+		let t6;
+		if ($[54] !== errorNode || $[55] !== t3 || $[56] !== t4 || $[57] !== t5) {
+			t6 = /* @__PURE__ */ jsx(ErrorItemContainer, {
+				errorNode,
+				actions: t3,
+				message: t4,
+				scrollToElement: t5
+			});
+			$[54] = errorNode;
+			$[55] = t3;
+			$[56] = t4;
+			$[57] = t5;
+			$[58] = t6;
+		} else t6 = $[58];
+		return t6;
+	}
+	if (errorNode.error.type === "ChildrenLoad") {
+		let t1;
+		if ($[59] !== errorNode.id || $[60] !== reloadTree) {
+			t1 = () => reloadTree({ parentNodeId: errorNode.id });
+			$[59] = errorNode.id;
+			$[60] = reloadTree;
+			$[61] = t1;
+		} else t1 = $[61];
+		let t2;
+		if ($[62] !== translate) {
+			t2 = translate("retry");
+			$[62] = translate;
+			$[63] = t2;
+		} else t2 = $[63];
+		let t3;
+		if ($[64] !== t1 || $[65] !== t2) {
+			t3 = [{
+				action: t1,
+				label: t2,
+				condition: _temp2
+			}];
+			$[64] = t1;
+			$[65] = t2;
+			$[66] = t3;
+		} else t3 = $[66];
+		let t4;
+		if ($[67] !== translate) {
+			t4 = translate("failedToCreateHierarchy");
+			$[67] = translate;
+			$[68] = t4;
+		} else t4 = $[68];
+		let t5;
+		if ($[69] !== errorNode || $[70] !== scrollToNode) {
+			t5 = () => scrollToNode(errorNode);
+			$[69] = errorNode;
+			$[70] = scrollToNode;
+			$[71] = t5;
+		} else t5 = $[71];
+		let t6;
+		if ($[72] !== errorNode || $[73] !== t3 || $[74] !== t4 || $[75] !== t5) {
+			t6 = /* @__PURE__ */ jsx(ErrorItemContainer, {
+				errorNode,
+				actions: t3,
+				message: t4,
+				scrollToElement: t5
+			});
+			$[72] = errorNode;
+			$[73] = t3;
+			$[74] = t4;
+			$[75] = t5;
+			$[76] = t6;
+		} else t6 = $[76];
+		return t6;
+	}
+	let t1;
+	if ($[77] !== errorNode || $[78] !== scrollToNode) {
+		t1 = () => scrollToNode(errorNode);
+		$[77] = errorNode;
+		$[78] = scrollToNode;
+		$[79] = t1;
+	} else t1 = $[79];
+	let t2;
+	if ($[80] !== errorNode || $[81] !== t1) {
+		t2 = /* @__PURE__ */ jsx(ErrorItemContainer, {
+			errorNode,
+			message: errorNode.error.message,
+			scrollToElement: t1
+		});
+		$[80] = errorNode;
+		$[81] = t1;
+		$[82] = t2;
+	} else t2 = $[82];
+	return t2;
+}
+function _temp2() {
+	return true;
+}
+function _temp() {
+	return true;
+}
+function ErrorItemContainer(t0) {
+	const $ = c(10);
+	const { errorNode, message, actions, scrollToElement } = t0;
+	let t1;
+	if ($[0] !== errorNode.label || $[1] !== message || $[2] !== scrollToElement) {
+		t1 = /* @__PURE__ */ jsx(MessageWithLink, {
+			linkLabel: errorNode.label,
+			scrollToElement,
+			message
+		});
+		$[0] = errorNode.label;
+		$[1] = message;
+		$[2] = scrollToElement;
+		$[3] = t1;
+	} else t1 = $[3];
+	let t2;
+	if ($[4] !== actions) {
+		t2 = actions?.filter(_temp3).map(_temp4);
+		$[4] = actions;
+		$[5] = t2;
+	} else t2 = $[5];
+	let t3;
+	if ($[6] !== errorNode.id || $[7] !== t1 || $[8] !== t2) {
+		t3 = /* @__PURE__ */ jsx(unstable_ErrorRegion.Item, {
+			message: t1,
+			messageId: errorNode.id,
+			actions: t2
+		});
+		$[6] = errorNode.id;
+		$[7] = t1;
+		$[8] = t2;
+		$[9] = t3;
+	} else t3 = $[9];
+	return t3;
+}
+function _temp4(t0) {
+	const { label, action } = t0;
+	return /* @__PURE__ */ jsx(Text, {
+		variant: "body-sm",
+		children: /* @__PURE__ */ jsx(Anchor, {
+			onClick: action,
+			render: /* @__PURE__ */ jsx("button", {}),
+			children: label
+		})
+	}, label);
+}
+function _temp3(t0) {
+	const { condition } = t0;
+	return condition();
+}
+function MessageWithLink(t0) {
+	const $ = c(11);
+	const { linkLabel, scrollToElement, message } = t0;
+	let t1;
+	if ($[0] !== message) {
+		t1 = message.split("{{node}}", 2);
+		$[0] = message;
+		$[1] = t1;
+	} else t1 = $[1];
+	const splitMessage = t1;
+	let t2;
+	if ($[2] === Symbol.for("react.memo_cache_sentinel")) {
+		t2 = {
+			display: "flex",
+			whiteSpace: "pre",
+			flexWrap: "wrap"
+		};
+		$[2] = t2;
+	} else t2 = $[2];
+	let t3;
+	if ($[3] === Symbol.for("react.memo_cache_sentinel")) {
+		t3 = /* @__PURE__ */ jsx("button", {});
+		$[3] = t3;
+	} else t3 = $[3];
+	let t4;
+	if ($[4] !== linkLabel || $[5] !== scrollToElement) {
+		t4 = /* @__PURE__ */ jsx(Anchor, {
+			onClick: scrollToElement,
+			render: t3,
+			children: linkLabel
+		});
+		$[4] = linkLabel;
+		$[5] = scrollToElement;
+		$[6] = t4;
+	} else t4 = $[6];
+	const t5 = splitMessage[1] ? splitMessage[1] : null;
+	let t6;
+	if ($[7] !== splitMessage[0] || $[8] !== t4 || $[9] !== t5) {
+		t6 = /* @__PURE__ */ jsxs("div", {
+			style: t2,
+			children: [
+				splitMessage[0],
+				t4,
+				t5
+			]
+		});
+		$[7] = splitMessage[0];
+		$[8] = t4;
+		$[9] = t5;
+		$[10] = t6;
+	} else t6 = $[10];
+	return t6;
+}
+
+//#endregion
+export { ErrorItemRenderer };
+//# sourceMappingURL=ErrorItemRenderer.js.map