@itwin/presentation-hierarchies 0.1.0

package/lib/cjs/hierarchies/internal/operators/grouping/AutoExpand.js

@@ -0,0 +1,27 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assignAutoExpand = void 0;
+const Shared_1 = require("./Shared");
+/** @internal */
+function assignAutoExpand(props) {
+    for (const node of props.grouped) {
+        let autoExpandProp;
+        (0, Shared_1.iterateChildNodeGroupingParams)(node, props.groupingType, (groupingProps) => {
+            if (autoExpandProp === "always") {
+                return true;
+            }
+            autoExpandProp = groupingProps?.autoExpand ? groupingProps.autoExpand : autoExpandProp;
+            return;
+        });
+        if (autoExpandProp === "always" || (autoExpandProp === "single-child" && node.children.length === 1)) {
+            node.autoExpand = true;
+        }
+    }
+    return props;
+}
+exports.assignAutoExpand = assignAutoExpand;
+//# sourceMappingURL=AutoExpand.js.map

package/lib/cjs/hierarchies/internal/operators/grouping/AutoExpand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoExpand.js","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/AutoExpand.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAIhG,qCAA0D;AAE1D,gBAAgB;AAChB,SAAgB,gBAAgB,CAAC,KAA4B;IAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,cAAuD,CAAC;QAC5D,IAAA,uCAA8B,EAAC,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,aAAa,EAAE,EAAE;YACzE,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,cAAc,GAAG,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;YACvF,OAAO;QACT,CAAC,CAAC,CAAC;QACH,IAAI,cAAc,KAAK,QAAQ,IAAI,CAAC,cAAc,KAAK,cAAc,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACrG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAfD,4CAeC","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 { HierarchyNodeAutoExpandProp } from \"../../../HierarchyNode\";\nimport { GroupingHandlerResult } from \"../Grouping\";\nimport { iterateChildNodeGroupingParams } from \"./Shared\";\n\n/** @internal */\nexport function assignAutoExpand(props: GroupingHandlerResult): GroupingHandlerResult {\n  for (const node of props.grouped) {\n    let autoExpandProp: HierarchyNodeAutoExpandProp | undefined;\n    iterateChildNodeGroupingParams(node, props.groupingType, (groupingProps) => {\n      if (autoExpandProp === \"always\") {\n        return true;\n      }\n      autoExpandProp = groupingProps?.autoExpand ? groupingProps.autoExpand : autoExpandProp;\n      return;\n    });\n    if (autoExpandProp === \"always\" || (autoExpandProp === \"single-child\" && node.children.length === 1)) {\n      node.autoExpand = true;\n    }\n  }\n  return props;\n}\n"]}

package/lib/cjs/hierarchies/internal/operators/grouping/BaseClassGrouping.d.ts

@@ -0,0 +1,10 @@
+import { EC, ECClassHierarchyInspector, ECSchemaProvider } from "@itwin/presentation-shared";
+import { ParentHierarchyNode, ProcessedInstanceHierarchyNode } from "../../../HierarchyNode";
+import { GroupingHandler, GroupingHandlerResult } from "../Grouping";
+/** @internal */
+export declare function getBaseClassGroupingECClasses(schemaProvider: ECSchemaProvider, parentNode: ParentHierarchyNode | undefined, nodes: ProcessedInstanceHierarchyNode[]): Promise<EC.Class[]>;
+/** @internal */
+export declare function createBaseClassGroupsForSingleBaseClass(nodes: ProcessedInstanceHierarchyNode[], baseECClass: EC.Class, classHierarchyInspector: ECClassHierarchyInspector): Promise<GroupingHandlerResult>;
+/** @internal */
+export declare function createBaseClassGroupingHandlers(imodelAccess: ECSchemaProvider & ECClassHierarchyInspector, parentNode: ParentHierarchyNode | undefined, nodes: ProcessedInstanceHierarchyNode[]): Promise<GroupingHandler[]>;
+//# sourceMappingURL=BaseClassGrouping.d.ts.map

package/lib/cjs/hierarchies/internal/operators/grouping/BaseClassGrouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseClassGrouping.d.ts","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/BaseClassGrouping.ts"],"names":[],"mappings":"AAKA,OAAO,EAA8C,EAAE,EAAE,yBAAyB,EAAE,gBAAgB,EAAY,MAAM,4BAA4B,CAAC;AACnJ,OAAO,EAAiB,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAE5G,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAErE,gBAAgB;AAChB,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,gBAAgB,EAChC,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,KAAK,EAAE,8BAA8B,EAAE,GACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAyBrB;AAED,gBAAgB;AAChB,wBAAsB,uCAAuC,CAC3D,KAAK,EAAE,8BAA8B,EAAE,EACvC,WAAW,EAAE,EAAE,CAAC,KAAK,EACrB,uBAAuB,EAAE,yBAAyB,GACjD,OAAO,CAAC,qBAAqB,CAAC,CA0ChC;AAsCD,gBAAgB;AAChB,wBAAsB,+BAA+B,CACnD,YAAY,EAAE,gBAAgB,GAAG,yBAAyB,EAC1D,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,KAAK,EAAE,8BAA8B,EAAE,GACtC,OAAO,CAAC,eAAe,EAAE,CAAC,CAG5B"}

package/lib/cjs/hierarchies/internal/operators/grouping/BaseClassGrouping.js

@@ -0,0 +1,115 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBaseClassGroupingHandlers = exports.createBaseClassGroupsForSingleBaseClass = exports.getBaseClassGroupingECClasses = void 0;
+const presentation_shared_1 = require("@itwin/presentation-shared");
+const HierarchyNode_1 = require("../../../HierarchyNode");
+/** @internal */
+async function getBaseClassGroupingECClasses(schemaProvider, parentNode, nodes) {
+    // Get all base class names that are provided in the grouping information
+    const baseClassesFullClassNames = await getGroupingBaseClassNames(nodes);
+    if (baseClassesFullClassNames.size === 0) {
+        return [];
+    }
+    const releaseMainThread = (0, presentation_shared_1.createMainThreadReleaseOnTimePassedHandler)();
+    const baseClasses = [];
+    for (const fullName of baseClassesFullClassNames) {
+        await releaseMainThread();
+        baseClasses.push(await (0, presentation_shared_1.getClass)(schemaProvider, fullName));
+    }
+    const sortedClasses = await sortByBaseClass(baseClasses.filter((baseClass) => baseClass.isRelationshipClass() || baseClass.isEntityClass()));
+    if (parentNode && HierarchyNode_1.HierarchyNode.isClassGroupingNode(parentNode)) {
+        // if we have a class grouping node, we can cut the front of sortedClasses up to a point where our grouping class is
+        const cutPosition = sortedClasses.findIndex((c) => c.fullName === parentNode.key.className);
+        if (cutPosition >= 0) {
+            return sortedClasses.slice(cutPosition + 1);
+        }
+        return [];
+    }
+    return sortedClasses;
+}
+exports.getBaseClassGroupingECClasses = getBaseClassGroupingECClasses;
+/** @internal */
+async function createBaseClassGroupsForSingleBaseClass(nodes, baseECClass, classHierarchyInspector) {
+    const releaseMainThread = (0, presentation_shared_1.createMainThreadReleaseOnTimePassedHandler)();
+    const groupedNodes = new Array();
+    const ungroupedNodes = new Array();
+    const baseClassFullName = baseECClass.fullName;
+    for (const node of nodes) {
+        await releaseMainThread();
+        if (!node.processingParams?.grouping?.byBaseClasses ||
+            !node.processingParams.grouping.byBaseClasses.fullClassNames.some((className) => className === baseClassFullName)) {
+            ungroupedNodes.push(node);
+            continue;
+        }
+        const fullCurrentNodeClassName = node.key.instanceKeys[0].className;
+        const baseCheckerResult = classHierarchyInspector.classDerivesFrom(fullCurrentNodeClassName, baseClassFullName);
+        // istanbul ignore next
+        const isCurrentNodeClassOfBase = baseCheckerResult instanceof Promise ? await baseCheckerResult : baseCheckerResult;
+        if (isCurrentNodeClassOfBase) {
+            groupedNodes.push(node);
+        }
+        else {
+            ungroupedNodes.push(node);
+        }
+    }
+    const result = { grouped: [], ungrouped: ungroupedNodes, groupingType: "base-class" };
+    if (groupedNodes.length > 0) {
+        const groupingNodeKey = {
+            type: "class-grouping",
+            className: baseClassFullName,
+        };
+        result.grouped.push({
+            label: baseECClass.label ?? baseECClass.name,
+            key: groupingNodeKey,
+            parentKeys: [...groupedNodes[0].parentKeys],
+            groupedInstanceKeys: groupedNodes.flatMap((groupedInstanceNode) => groupedInstanceNode.key.instanceKeys),
+            children: groupedNodes.map((gn) => Object.assign(gn, { parentKeys: [...gn.parentKeys, groupingNodeKey] })),
+        });
+    }
+    return result;
+}
+exports.createBaseClassGroupsForSingleBaseClass = createBaseClassGroupsForSingleBaseClass;
+async function getGroupingBaseClassNames(nodes) {
+    const releaseMainThread = (0, presentation_shared_1.createMainThreadReleaseOnTimePassedHandler)();
+    const baseClasses = new Set();
+    for (const node of nodes) {
+        await releaseMainThread();
+        if (node.processingParams?.grouping?.byBaseClasses) {
+            for (const className of node.processingParams.grouping.byBaseClasses.fullClassNames) {
+                baseClasses.add(className);
+            }
+        }
+    }
+    return baseClasses;
+}
+async function sortByBaseClass(classes) {
+    if (classes.length === 0) {
+        return classes;
+    }
+    const output = [classes[0]];
+    for (let inputIndex = 1; inputIndex < classes.length; ++inputIndex) {
+        let wasAdded = false;
+        for (let outputIndex = output.length - 1; outputIndex >= 0; --outputIndex) {
+            if (await classes[inputIndex].is(output[outputIndex])) {
+                output.splice(outputIndex + 1, 0, classes[inputIndex]);
+                wasAdded = true;
+                break;
+            }
+        }
+        if (!wasAdded) {
+            output.splice(0, 0, classes[inputIndex]);
+        }
+    }
+    return output;
+}
+/** @internal */
+async function createBaseClassGroupingHandlers(imodelAccess, parentNode, nodes) {
+    const baseClassGroupingECClasses = await getBaseClassGroupingECClasses(imodelAccess, parentNode, nodes);
+    return baseClassGroupingECClasses.map((baseECClass) => async (allNodes) => createBaseClassGroupsForSingleBaseClass(allNodes, baseECClass, imodelAccess));
+}
+exports.createBaseClassGroupingHandlers = createBaseClassGroupingHandlers;
+//# sourceMappingURL=BaseClassGrouping.js.map

package/lib/cjs/hierarchies/internal/operators/grouping/BaseClassGrouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseClassGrouping.js","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/BaseClassGrouping.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAEhG,oEAAmJ;AACnJ,0DAA4G;AAI5G,gBAAgB;AACT,KAAK,UAAU,6BAA6B,CACjD,cAAgC,EAChC,UAA2C,EAC3C,KAAuC;IAEvC,yEAAyE;IACzE,MAAM,yBAAyB,GAAG,MAAM,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACzE,IAAI,yBAAyB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAA,gEAA0C,GAAE,CAAC;IACvE,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,QAAQ,IAAI,yBAAyB,EAAE,CAAC;QACjD,MAAM,iBAAiB,EAAE,CAAC;QAC1B,WAAW,CAAC,IAAI,CAAC,MAAM,IAAA,8BAAQ,EAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAE7I,IAAI,UAAU,IAAI,6BAAa,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,oHAAoH;QACpH,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5F,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,aAAa,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AA7BD,sEA6BC;AAED,gBAAgB;AACT,KAAK,UAAU,uCAAuC,CAC3D,KAAuC,EACvC,WAAqB,EACrB,uBAAkD;IAElD,MAAM,iBAAiB,GAAG,IAAA,gEAA0C,GAAE,CAAC;IACvE,MAAM,YAAY,GAAG,IAAI,KAAK,EAAkC,CAAC;IACjE,MAAM,cAAc,GAAG,IAAI,KAAK,EAAkC,CAAC;IACnE,MAAM,iBAAiB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,iBAAiB,EAAE,CAAC;QAC1B,IACE,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,EAAE,aAAa;YAC/C,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,iBAAiB,CAAC,EACjH,CAAC;YACD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,wBAAwB,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpE,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAAC;QAChH,uBAAuB;QACvB,MAAM,wBAAwB,GAAG,iBAAiB,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAEpH,IAAI,wBAAwB,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAA0B,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7G,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,eAAe,GAAyB;YAC5C,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,iBAAiB;SAC7B,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;YAClB,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI;YAC5C,GAAG,EAAE,eAAe;YACpB,UAAU,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC3C,mBAAmB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,mBAAmB,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC;YACxG,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;SAC3G,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AA9CD,0FA8CC;AAED,KAAK,UAAU,yBAAyB,CAAC,KAAuC;IAC9E,MAAM,iBAAiB,GAAG,IAAA,gEAA0C,GAAE,CAAC;IACvE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,iBAAiB,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;YACnD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC;gBACpF,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAmB;IAChD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC;QACnE,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,IAAI,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,WAAW,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC;YAC1E,IAAI,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;gBACvD,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gBAAgB;AACT,KAAK,UAAU,+BAA+B,CACnD,YAA0D,EAC1D,UAA2C,EAC3C,KAAuC;IAEvC,MAAM,0BAA0B,GAAG,MAAM,6BAA6B,CAAC,YAAY,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACxG,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,uCAAuC,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;AAC3J,CAAC;AAPD,0EAOC","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 { createMainThreadReleaseOnTimePassedHandler, EC, ECClassHierarchyInspector, ECSchemaProvider, getClass } from \"@itwin/presentation-shared\";\nimport { HierarchyNode, ParentHierarchyNode, ProcessedInstanceHierarchyNode } from \"../../../HierarchyNode\";\nimport { ClassGroupingNodeKey } from \"../../../HierarchyNodeKey\";\nimport { GroupingHandler, GroupingHandlerResult } from \"../Grouping\";\n\n/** @internal */\nexport async function getBaseClassGroupingECClasses(\n  schemaProvider: ECSchemaProvider,\n  parentNode: ParentHierarchyNode | undefined,\n  nodes: ProcessedInstanceHierarchyNode[],\n): Promise<EC.Class[]> {\n  // Get all base class names that are provided in the grouping information\n  const baseClassesFullClassNames = await getGroupingBaseClassNames(nodes);\n  if (baseClassesFullClassNames.size === 0) {\n    return [];\n  }\n\n  const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();\n  const baseClasses = [];\n  for (const fullName of baseClassesFullClassNames) {\n    await releaseMainThread();\n    baseClasses.push(await getClass(schemaProvider, fullName));\n  }\n  const sortedClasses = await sortByBaseClass(baseClasses.filter((baseClass) => baseClass.isRelationshipClass() || baseClass.isEntityClass()));\n\n  if (parentNode && HierarchyNode.isClassGroupingNode(parentNode)) {\n    // if we have a class grouping node, we can cut the front of sortedClasses up to a point where our grouping class is\n    const cutPosition = sortedClasses.findIndex((c) => c.fullName === parentNode.key.className);\n    if (cutPosition >= 0) {\n      return sortedClasses.slice(cutPosition + 1);\n    }\n    return [];\n  }\n\n  return sortedClasses;\n}\n\n/** @internal */\nexport async function createBaseClassGroupsForSingleBaseClass(\n  nodes: ProcessedInstanceHierarchyNode[],\n  baseECClass: EC.Class,\n  classHierarchyInspector: ECClassHierarchyInspector,\n): Promise<GroupingHandlerResult> {\n  const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();\n  const groupedNodes = new Array<ProcessedInstanceHierarchyNode>();\n  const ungroupedNodes = new Array<ProcessedInstanceHierarchyNode>();\n  const baseClassFullName = baseECClass.fullName;\n  for (const node of nodes) {\n    await releaseMainThread();\n    if (\n      !node.processingParams?.grouping?.byBaseClasses ||\n      !node.processingParams.grouping.byBaseClasses.fullClassNames.some((className) => className === baseClassFullName)\n    ) {\n      ungroupedNodes.push(node);\n      continue;\n    }\n    const fullCurrentNodeClassName = node.key.instanceKeys[0].className;\n\n    const baseCheckerResult = classHierarchyInspector.classDerivesFrom(fullCurrentNodeClassName, baseClassFullName);\n    // istanbul ignore next\n    const isCurrentNodeClassOfBase = baseCheckerResult instanceof Promise ? await baseCheckerResult : baseCheckerResult;\n\n    if (isCurrentNodeClassOfBase) {\n      groupedNodes.push(node);\n    } else {\n      ungroupedNodes.push(node);\n    }\n  }\n\n  const result: GroupingHandlerResult = { grouped: [], ungrouped: ungroupedNodes, groupingType: \"base-class\" };\n  if (groupedNodes.length > 0) {\n    const groupingNodeKey: ClassGroupingNodeKey = {\n      type: \"class-grouping\",\n      className: baseClassFullName,\n    };\n    result.grouped.push({\n      label: baseECClass.label ?? baseECClass.name,\n      key: groupingNodeKey,\n      parentKeys: [...groupedNodes[0].parentKeys],\n      groupedInstanceKeys: groupedNodes.flatMap((groupedInstanceNode) => groupedInstanceNode.key.instanceKeys),\n      children: groupedNodes.map((gn) => Object.assign(gn, { parentKeys: [...gn.parentKeys, groupingNodeKey] })),\n    });\n  }\n  return result;\n}\n\nasync function getGroupingBaseClassNames(nodes: ProcessedInstanceHierarchyNode[]) {\n  const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();\n  const baseClasses = new Set<string>();\n  for (const node of nodes) {\n    await releaseMainThread();\n    if (node.processingParams?.grouping?.byBaseClasses) {\n      for (const className of node.processingParams.grouping.byBaseClasses.fullClassNames) {\n        baseClasses.add(className);\n      }\n    }\n  }\n  return baseClasses;\n}\n\nasync function sortByBaseClass(classes: EC.Class[]): Promise<EC.Class[]> {\n  if (classes.length === 0) {\n    return classes;\n  }\n  const output: EC.Class[] = [classes[0]];\n  for (let inputIndex = 1; inputIndex < classes.length; ++inputIndex) {\n    let wasAdded = false;\n    for (let outputIndex = output.length - 1; outputIndex >= 0; --outputIndex) {\n      if (await classes[inputIndex].is(output[outputIndex])) {\n        output.splice(outputIndex + 1, 0, classes[inputIndex]);\n        wasAdded = true;\n        break;\n      }\n    }\n    if (!wasAdded) {\n      output.splice(0, 0, classes[inputIndex]);\n    }\n  }\n\n  return output;\n}\n\n/** @internal */\nexport async function createBaseClassGroupingHandlers(\n  imodelAccess: ECSchemaProvider & ECClassHierarchyInspector,\n  parentNode: ParentHierarchyNode | undefined,\n  nodes: ProcessedInstanceHierarchyNode[],\n): Promise<GroupingHandler[]> {\n  const baseClassGroupingECClasses = await getBaseClassGroupingECClasses(imodelAccess, parentNode, nodes);\n  return baseClassGroupingECClasses.map((baseECClass) => async (allNodes) => createBaseClassGroupsForSingleBaseClass(allNodes, baseECClass, imodelAccess));\n}\n"]}

package/lib/cjs/hierarchies/internal/operators/grouping/ClassGrouping.d.ts

@@ -0,0 +1,6 @@
+import { ECSchemaProvider } from "@itwin/presentation-shared";
+import { ParentHierarchyNode, ProcessedInstanceHierarchyNode } from "../../../HierarchyNode";
+import { GroupingHandlerResult } from "../Grouping";
+/** @internal */
+export declare function createClassGroups(schemaProvider: ECSchemaProvider, parentNode: ParentHierarchyNode | undefined, nodes: ProcessedInstanceHierarchyNode[]): Promise<GroupingHandlerResult>;
+//# sourceMappingURL=ClassGrouping.d.ts.map

package/lib/cjs/hierarchies/internal/operators/grouping/ClassGrouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassGrouping.d.ts","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/ClassGrouping.ts"],"names":[],"mappings":"AAKA,OAAO,EAA8C,gBAAgB,EAAY,MAAM,4BAA4B,CAAC;AACpH,OAAO,EAAiB,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAE5G,OAAO,EAAE,qBAAqB,EAA2C,MAAM,aAAa,CAAC;AAa7F,gBAAgB;AAChB,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,gBAAgB,EAChC,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,KAAK,EAAE,8BAA8B,EAAE,GACtC,OAAO,CAAC,qBAAqB,CAAC,CAuBhC"}

package/lib/cjs/hierarchies/internal/operators/grouping/ClassGrouping.js

@@ -0,0 +1,56 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClassGroups = void 0;
+const presentation_shared_1 = require("@itwin/presentation-shared");
+const HierarchyNode_1 = require("../../../HierarchyNode");
+/** @internal */
+async function createClassGroups(schemaProvider, parentNode, nodes) {
+    const parentNodeClass = parentNode && HierarchyNode_1.HierarchyNode.isClassGroupingNode(parentNode) ? parentNode.key.className : undefined;
+    const groupings = { ungrouped: [], grouped: new Map() };
+    const releaseMainThread = (0, presentation_shared_1.createMainThreadReleaseOnTimePassedHandler)();
+    for (const node of nodes) {
+        await releaseMainThread();
+        const nodeClassName = node.key.instanceKeys[0].className;
+        if (node.processingParams?.grouping?.byClass && nodeClassName !== parentNodeClass) {
+            let groupingInfo = groupings.grouped.get(nodeClassName);
+            if (!groupingInfo) {
+                const nodeClass = await (0, presentation_shared_1.getClass)(schemaProvider, nodeClassName);
+                groupingInfo = {
+                    class: nodeClass,
+                    groupedNodes: [],
+                };
+                groupings.grouped.set(nodeClassName, groupingInfo);
+            }
+            groupingInfo.groupedNodes.push(node);
+            continue;
+        }
+        groupings.ungrouped.push(node);
+    }
+    return createGroupingNodes(groupings);
+}
+exports.createClassGroups = createClassGroups;
+async function createGroupingNodes(groupings) {
+    const groupedNodes = new Array();
+    const releaseMainThread = (0, presentation_shared_1.createMainThreadReleaseOnTimePassedHandler)();
+    for (const [, entry] of groupings.grouped) {
+        await releaseMainThread();
+        const groupingNodeKey = {
+            type: "class-grouping",
+            className: entry.class.fullName,
+        };
+        const groupedNodeParentKeys = entry.groupedNodes[0].parentKeys;
+        groupedNodes.push({
+            label: entry.class.label ?? entry.class.name,
+            key: groupingNodeKey,
+            parentKeys: groupedNodeParentKeys,
+            groupedInstanceKeys: entry.groupedNodes.flatMap((groupedInstanceNode) => groupedInstanceNode.key.instanceKeys),
+            children: entry.groupedNodes.map((gn) => Object.assign(gn, { parentKeys: [...groupedNodeParentKeys, groupingNodeKey] })),
+        });
+    }
+    return { grouped: groupedNodes, ungrouped: groupings.ungrouped, groupingType: "class" };
+}
+//# sourceMappingURL=ClassGrouping.js.map

package/lib/cjs/hierarchies/internal/operators/grouping/ClassGrouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassGrouping.js","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/ClassGrouping.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { createMainThreadReleaseOnTimePassedHandler, ECSchemaProvider, getClass } from \"@itwin/presentation-shared\";\nimport { HierarchyNode, ParentHierarchyNode, ProcessedInstanceHierarchyNode } from \"../../../HierarchyNode\";\nimport { ClassGroupingNodeKey } from \"../../../HierarchyNodeKey\";\nimport { GroupingHandlerResult, ProcessedInstancesGroupingHierarchyNode } from \"../Grouping\";\n\ninterface ClassInfo {\n  fullName: string;\n  name: string;\n  label?: string;\n}\n\ninterface ClassGroupingInformation {\n  ungrouped: ProcessedInstanceHierarchyNode[];\n  grouped: Map<string, { class: ClassInfo; groupedNodes: ProcessedInstanceHierarchyNode[] }>;\n}\n\n/** @internal */\nexport async function createClassGroups(\n  schemaProvider: ECSchemaProvider,\n  parentNode: ParentHierarchyNode | undefined,\n  nodes: ProcessedInstanceHierarchyNode[],\n): Promise<GroupingHandlerResult> {\n  const parentNodeClass = parentNode && HierarchyNode.isClassGroupingNode(parentNode) ? parentNode.key.className : undefined;\n  const groupings: ClassGroupingInformation = { ungrouped: [], grouped: new Map() };\n  const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();\n  for (const node of nodes) {\n    await releaseMainThread();\n    const nodeClassName = node.key.instanceKeys[0].className;\n    if (node.processingParams?.grouping?.byClass && nodeClassName !== parentNodeClass) {\n      let groupingInfo = groupings.grouped.get(nodeClassName);\n      if (!groupingInfo) {\n        const nodeClass = await getClass(schemaProvider, nodeClassName);\n        groupingInfo = {\n          class: nodeClass,\n          groupedNodes: [],\n        };\n        groupings.grouped.set(nodeClassName, groupingInfo);\n      }\n      groupingInfo.groupedNodes.push(node);\n      continue;\n    }\n    groupings.ungrouped.push(node);\n  }\n  return createGroupingNodes(groupings);\n}\n\nasync function createGroupingNodes(groupings: ClassGroupingInformation): Promise<GroupingHandlerResult> {\n  const groupedNodes = new Array<ProcessedInstancesGroupingHierarchyNode>();\n  const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();\n  for (const [, entry] of groupings.grouped) {\n    await releaseMainThread();\n    const groupingNodeKey: ClassGroupingNodeKey = {\n      type: \"class-grouping\",\n      className: entry.class.fullName,\n    };\n    const groupedNodeParentKeys = entry.groupedNodes[0].parentKeys;\n    groupedNodes.push({\n      label: entry.class.label ?? entry.class.name,\n      key: groupingNodeKey,\n      parentKeys: groupedNodeParentKeys,\n      groupedInstanceKeys: entry.groupedNodes.flatMap((groupedInstanceNode) => groupedInstanceNode.key.instanceKeys),\n      children: entry.groupedNodes.map((gn) => Object.assign(gn, { parentKeys: [...groupedNodeParentKeys, groupingNodeKey] })),\n    });\n  }\n  return { grouped: groupedNodes, ungrouped: groupings.ungrouped, groupingType: \"class\" };\n}\n"]}

package/lib/cjs/hierarchies/internal/operators/grouping/GroupHiding.d.ts

@@ -0,0 +1,4 @@
+import { GroupingHandlerResult } from "../Grouping";
+/** @internal */
+export declare function applyGroupHidingParams(props: GroupingHandlerResult, extraSiblings: number): GroupingHandlerResult;
+//# sourceMappingURL=GroupHiding.d.ts.map

package/lib/cjs/hierarchies/internal/operators/grouping/GroupHiding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupHiding.d.ts","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/GroupHiding.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAyD,MAAM,aAAa,CAAC;AAG3G,gBAAgB;AAChB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,GAAG,qBAAqB,CA+BjH"}

package/lib/cjs/hierarchies/internal/operators/grouping/GroupHiding.js

@@ -0,0 +1,54 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyGroupHidingParams = void 0;
+const Shared_1 = require("./Shared");
+/** @internal */
+function applyGroupHidingParams(props, extraSiblings) {
+    const { grouped, ungrouped, groupingType } = props;
+    if (grouped.length === 0) {
+        return props;
+    }
+    // handle the "no siblings" case
+    if (grouped.length === 1 && ungrouped.length === 0 && extraSiblings === 0) {
+        const hideParams = getHideOptionsFromNodeProcessingParams(grouped[0], groupingType);
+        if (hideParams.hideIfNoSiblings) {
+            return { groupingType, grouped: [], ungrouped: grouped[0].children };
+        }
+    }
+    // handle the "no children" case
+    const filteredGrouped = new Array();
+    for (const node of grouped) {
+        if (node.children.length === 1) {
+            const hideParams = getHideOptionsFromNodeProcessingParams(node, groupingType);
+            if (hideParams.hideIfOneGroupedNode) {
+                ungrouped.push(node.children[0]);
+                continue;
+            }
+        }
+        filteredGrouped.push(node);
+    }
+    return {
+        groupingType,
+        grouped: filteredGrouped,
+        ungrouped,
+    };
+}
+exports.applyGroupHidingParams = applyGroupHidingParams;
+function getHideOptionsFromNodeProcessingParams(groupingNode, groupingType) {
+    let hideIfNoSiblings = false;
+    let hideIfOneGroupedNode = false;
+    (0, Shared_1.iterateChildNodeGroupingParams)(groupingNode, groupingType, (groupingProps) => {
+        if (hideIfNoSiblings && hideIfOneGroupedNode) {
+            return true;
+        }
+        hideIfNoSiblings ||= !!groupingProps?.hideIfNoSiblings;
+        hideIfOneGroupedNode ||= !!groupingProps?.hideIfOneGroupedNode;
+        return;
+    });
+    return { hideIfNoSiblings, hideIfOneGroupedNode };
+}
+//# sourceMappingURL=GroupHiding.js.map

package/lib/cjs/hierarchies/internal/operators/grouping/GroupHiding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupHiding.js","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/GroupHiding.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAGhG,qCAA0D;AAE1D,gBAAgB;AAChB,SAAgB,sBAAsB,CAAC,KAA4B,EAAE,aAAqB;IACxF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,UAAU,GAAG,sCAAsC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACpF,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC;YAChC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,MAAM,eAAe,GAAG,IAAI,KAAK,EAA2C,CAAC;IAC7E,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,sCAAsC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC9E,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC;gBACpC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjC,SAAS;YACX,CAAC;QACH,CAAC;QACD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO;QACL,YAAY;QACZ,OAAO,EAAE,eAAe;QACxB,SAAS;KACV,CAAC;AACJ,CAAC;AA/BD,wDA+BC;AAED,SAAS,sCAAsC,CAC7C,YAAqD,EACrD,YAA0B;IAE1B,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,oBAAoB,GAAG,KAAK,CAAC;IACjC,IAAA,uCAA8B,EAAC,YAAY,EAAE,YAAY,EAAE,CAAC,aAAa,EAAE,EAAE;QAC3E,IAAI,gBAAgB,IAAI,oBAAoB,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,gBAAgB,KAAK,CAAC,CAAC,aAAa,EAAE,gBAAgB,CAAC;QACvD,oBAAoB,KAAK,CAAC,CAAC,aAAa,EAAE,oBAAoB,CAAC;QAC/D,OAAO;IACT,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;AACpD,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 { GroupingHandlerResult, GroupingType, ProcessedInstancesGroupingHierarchyNode } from \"../Grouping\";\nimport { iterateChildNodeGroupingParams } from \"./Shared\";\n\n/** @internal */\nexport function applyGroupHidingParams(props: GroupingHandlerResult, extraSiblings: number): GroupingHandlerResult {\n  const { grouped, ungrouped, groupingType } = props;\n  if (grouped.length === 0) {\n    return props;\n  }\n\n  // handle the \"no siblings\" case\n  if (grouped.length === 1 && ungrouped.length === 0 && extraSiblings === 0) {\n    const hideParams = getHideOptionsFromNodeProcessingParams(grouped[0], groupingType);\n    if (hideParams.hideIfNoSiblings) {\n      return { groupingType, grouped: [], ungrouped: grouped[0].children };\n    }\n  }\n\n  // handle the \"no children\" case\n  const filteredGrouped = new Array<ProcessedInstancesGroupingHierarchyNode>();\n  for (const node of grouped) {\n    if (node.children.length === 1) {\n      const hideParams = getHideOptionsFromNodeProcessingParams(node, groupingType);\n      if (hideParams.hideIfOneGroupedNode) {\n        ungrouped.push(node.children[0]);\n        continue;\n      }\n    }\n    filteredGrouped.push(node);\n  }\n  return {\n    groupingType,\n    grouped: filteredGrouped,\n    ungrouped,\n  };\n}\n\nfunction getHideOptionsFromNodeProcessingParams(\n  groupingNode: ProcessedInstancesGroupingHierarchyNode,\n  groupingType: GroupingType,\n): { hideIfNoSiblings: boolean; hideIfOneGroupedNode: boolean } {\n  let hideIfNoSiblings = false;\n  let hideIfOneGroupedNode = false;\n  iterateChildNodeGroupingParams(groupingNode, groupingType, (groupingProps) => {\n    if (hideIfNoSiblings && hideIfOneGroupedNode) {\n      return true;\n    }\n    hideIfNoSiblings ||= !!groupingProps?.hideIfNoSiblings;\n    hideIfOneGroupedNode ||= !!groupingProps?.hideIfOneGroupedNode;\n    return;\n  });\n  return { hideIfNoSiblings, hideIfOneGroupedNode };\n}\n"]}

package/lib/cjs/hierarchies/internal/operators/grouping/LabelGrouping.d.ts

@@ -0,0 +1,5 @@
+import { ProcessedInstanceHierarchyNode } from "../../../HierarchyNode";
+import { GroupingHandlerResult } from "../Grouping";
+/** @internal */
+export declare function createLabelGroups(nodes: ProcessedInstanceHierarchyNode[]): Promise<GroupingHandlerResult>;
+//# sourceMappingURL=LabelGrouping.d.ts.map

package/lib/cjs/hierarchies/internal/operators/grouping/LabelGrouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LabelGrouping.d.ts","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/LabelGrouping.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE,OAAO,EAAE,qBAAqB,EAA2C,MAAM,aAAa,CAAC;AAE7F,gBAAgB;AAChB,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,8BAA8B,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoD/G"}

package/lib/cjs/hierarchies/internal/operators/grouping/LabelGrouping.js

@@ -0,0 +1,61 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLabelGroups = void 0;
+const Common_1 = require("../../Common");
+/** @internal */
+async function createLabelGroups(nodes) {
+    const ungrouped = new Array();
+    const nodesToMergeMap = new Map();
+    const nodesToGroupMap = new Map();
+    for (const node of nodes) {
+        const byLabel = node.processingParams?.grouping?.byLabel;
+        if (!byLabel) {
+            ungrouped.push(node);
+            continue;
+        }
+        const nodeMapKeyIdentifier = `label:"${node.label}";groupId:${JSON.stringify(typeof byLabel === "object" ? byLabel.groupId : undefined)}`;
+        const map = typeof byLabel === "object" && byLabel.action === "merge" ? nodesToMergeMap : nodesToGroupMap;
+        let list = map.get(nodeMapKeyIdentifier);
+        if (!list) {
+            list = [];
+            map.set(nodeMapKeyIdentifier, list);
+        }
+        list.push(node);
+    }
+    nodesToMergeMap.forEach((entry) => {
+        let finalNode = entry[0];
+        for (let i = 1; i < entry.length; ++i) {
+            finalNode = (0, Common_1.mergeNodes)(finalNode, entry[i]);
+        }
+        ungrouped.push(finalNode);
+    });
+    const groupedNodes = new Array();
+    nodesToGroupMap.forEach((entry) => {
+        const byLabel = entry[0].processingParams?.grouping?.byLabel;
+        const groupId = typeof byLabel === "object" ? byLabel.groupId : undefined;
+        const groupingNodeKey = {
+            type: "label-grouping",
+            label: entry[0].label,
+            groupId,
+        };
+        const groupedNodeParentKeys = entry[0].parentKeys;
+        groupedNodes.push({
+            label: entry[0].label,
+            key: groupingNodeKey,
+            parentKeys: groupedNodeParentKeys,
+            groupedInstanceKeys: entry.flatMap((groupedInstanceNode) => groupedInstanceNode.key.instanceKeys),
+            children: entry.map((gn) => Object.assign(gn, { parentKeys: [...groupedNodeParentKeys, groupingNodeKey] })),
+        });
+    });
+    return {
+        groupingType: "label",
+        grouped: groupedNodes,
+        ungrouped,
+    };
+}
+exports.createLabelGroups = createLabelGroups;
+//# sourceMappingURL=LabelGrouping.js.map

package/lib/cjs/hierarchies/internal/operators/grouping/LabelGrouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LabelGrouping.js","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/LabelGrouping.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { ProcessedInstanceHierarchyNode } from \"../../../HierarchyNode\";\nimport { LabelGroupingNodeKey } from \"../../../HierarchyNodeKey\";\nimport { mergeNodes } from \"../../Common\";\nimport { GroupingHandlerResult, ProcessedInstancesGroupingHierarchyNode } from \"../Grouping\";\n\n/** @internal */\nexport async function createLabelGroups(nodes: ProcessedInstanceHierarchyNode[]): Promise<GroupingHandlerResult> {\n  const ungrouped = new Array<ProcessedInstanceHierarchyNode>();\n  const nodesToMergeMap = new Map<string, ProcessedInstanceHierarchyNode[]>();\n  const nodesToGroupMap = new Map<string, ProcessedInstanceHierarchyNode[]>();\n  for (const node of nodes) {\n    const byLabel = node.processingParams?.grouping?.byLabel;\n    if (!byLabel) {\n      ungrouped.push(node);\n      continue;\n    }\n    const nodeMapKeyIdentifier = `label:\"${node.label}\";groupId:${JSON.stringify(typeof byLabel === \"object\" ? byLabel.groupId : undefined)}`;\n    const map = typeof byLabel === \"object\" && byLabel.action === \"merge\" ? nodesToMergeMap : nodesToGroupMap;\n    let list = map.get(nodeMapKeyIdentifier);\n    if (!list) {\n      list = [];\n      map.set(nodeMapKeyIdentifier, list);\n    }\n    list.push(node);\n  }\n\n  nodesToMergeMap.forEach((entry) => {\n    let finalNode = entry[0];\n    for (let i = 1; i < entry.length; ++i) {\n      finalNode = mergeNodes(finalNode, entry[i]);\n    }\n    ungrouped.push(finalNode);\n  });\n\n  const groupedNodes = new Array<ProcessedInstancesGroupingHierarchyNode>();\n  nodesToGroupMap.forEach((entry) => {\n    const byLabel = entry[0].processingParams?.grouping?.byLabel;\n    const groupId = typeof byLabel === \"object\" ? byLabel.groupId : undefined;\n    const groupingNodeKey: LabelGroupingNodeKey = {\n      type: \"label-grouping\",\n      label: entry[0].label,\n      groupId,\n    };\n    const groupedNodeParentKeys = entry[0].parentKeys;\n    groupedNodes.push({\n      label: entry[0].label,\n      key: groupingNodeKey,\n      parentKeys: groupedNodeParentKeys,\n      groupedInstanceKeys: entry.flatMap((groupedInstanceNode) => groupedInstanceNode.key.instanceKeys),\n      children: entry.map((gn) => Object.assign(gn, { parentKeys: [...groupedNodeParentKeys, groupingNodeKey] })),\n    });\n  });\n\n  return {\n    groupingType: \"label\",\n    grouped: groupedNodes,\n    ungrouped,\n  };\n}\n"]}

package/lib/cjs/hierarchies/internal/operators/grouping/PropertiesGrouping.d.ts

@@ -0,0 +1,31 @@
+import { EC, ECClassHierarchyInspector, ECSchemaProvider, IPrimitiveValueFormatter } from "@itwin/presentation-shared";
+import { HierarchyNodePropertiesGroupingParams, HierarchyNodePropertyGroup, HierarchyNodePropertyValueRange, ParentHierarchyNode, ProcessedInstanceHierarchyNode } from "../../../HierarchyNode";
+import { GroupingHandler, GroupingHandlerResult, ProcessedInstancesGroupingHierarchyNode } from "../Grouping";
+/** @internal */
+export interface PropertiesGroupingLocalizedStrings {
+    other: string;
+    unspecified: string;
+}
+/** @internal */
+export interface PropertyGroupInfo {
+    ecClass: EC.Class;
+    previousPropertiesGroupingInfo: PreviousPropertiesGroupingInfo;
+    propertyGroup: Omit<HierarchyNodePropertyGroup, "propertyValue">;
+}
+/** @internal */
+export type PreviousPropertiesGroupingInfo = Array<{
+    propertiesClassName: string;
+    propertyName: string;
+    isRange?: boolean;
+}>;
+/** @internal */
+export declare function createPropertyGroups(nodesToGroup: ProcessedInstanceHierarchyNode[], nodesAlreadyGrouped: ProcessedInstancesGroupingHierarchyNode[], handlerGroupingParams: PropertyGroupInfo, valueFormatter: IPrimitiveValueFormatter, localizedStrings: PropertiesGroupingLocalizedStrings, classHierarchyInspector: ECClassHierarchyInspector): Promise<GroupingHandlerResult>;
+/** @internal */
+export declare function getUniquePropertiesGroupInfo(schemaProvider: ECSchemaProvider, parentNode: ParentHierarchyNode | undefined, nodes: ProcessedInstanceHierarchyNode[]): Promise<Array<PropertyGroupInfo>>;
+/** @internal */
+export declare function doPreviousPropertiesMatch(previousPropertiesGroupingInfo: PreviousPropertiesGroupingInfo, nodesProperties: HierarchyNodePropertiesGroupingParams): boolean;
+/** @internal */
+export declare function doRangesMatch(ranges1: HierarchyNodePropertyValueRange[] | undefined, ranges2: HierarchyNodePropertyValueRange[] | undefined): boolean;
+/** @internal */
+export declare function createPropertiesGroupingHandlers(imodelAccess: ECSchemaProvider & ECClassHierarchyInspector, parentNode: ParentHierarchyNode | undefined, nodes: ProcessedInstanceHierarchyNode[], valueFormatter: IPrimitiveValueFormatter, localizedStrings: PropertiesGroupingLocalizedStrings): Promise<GroupingHandler[]>;
+//# sourceMappingURL=PropertiesGrouping.d.ts.map

package/lib/cjs/hierarchies/internal/operators/grouping/PropertiesGrouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertiesGrouping.d.ts","sourceRoot":"","sources":["../../../../../../src/hierarchies/internal/operators/grouping/PropertiesGrouping.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,EAAE,EACF,yBAAyB,EACzB,gBAAgB,EAEhB,wBAAwB,EAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,qCAAqC,EACrC,0BAA0B,EAC1B,+BAA+B,EAC/B,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AAY9G,gBAAgB;AAChB,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC;IAClB,8BAA8B,EAAE,8BAA8B,CAAC;IAC/D,aAAa,EAAE,IAAI,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC;CAClE;AAED,gBAAgB;AAChB,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAAC;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE7H,gBAAgB;AAChB,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,8BAA8B,EAAE,EAC9C,mBAAmB,EAAE,uCAAuC,EAAE,EAC9D,qBAAqB,EAAE,iBAAiB,EACxC,cAAc,EAAE,wBAAwB,EACxC,gBAAgB,EAAE,kCAAkC,EACpD,uBAAuB,EAAE,yBAAyB,GACjD,OAAO,CAAC,qBAAqB,CAAC,CAuJhC;AA8ED,gBAAgB;AAChB,wBAAsB,4BAA4B,CAChD,cAAc,EAAE,gBAAgB,EAChC,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,KAAK,EAAE,8BAA8B,EAAE,GACtC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAqDnC;AAoCD,gBAAgB;AAChB,wBAAgB,yBAAyB,CACvC,8BAA8B,EAAE,8BAA8B,EAC9D,eAAe,EAAE,qCAAqC,GACrD,OAAO,CAUT;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,OAAO,EAAE,+BAA+B,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,+BAA+B,EAAE,GAAG,SAAS,GAAG,OAAO,CAwBrJ;AAED,gBAAgB;AAChB,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,gBAAgB,GAAG,yBAAyB,EAC1D,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,KAAK,EAAE,8BAA8B,EAAE,EACvC,cAAc,EAAE,wBAAwB,EACxC,gBAAgB,EAAE,kCAAkC,GACnD,OAAO,CAAC,eAAe,EAAE,CAAC,CAM5B"}