@itwin/presentation-hierarchies 0.1.0

package/lib/cjs/hierarchies/internal/FilteringHierarchyDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilteringHierarchyDefinition.js","sourceRoot":"","sources":["../../../../src/hierarchies/internal/FilteringHierarchyDefinition.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 { ECClassHierarchyInspector, InstanceKey } from \"@itwin/presentation-shared\";\nimport {\n  CustomHierarchyNodeDefinition,\n  DefineHierarchyLevelProps,\n  HierarchyDefinition,\n  HierarchyLevelDefinition,\n  HierarchyNodesDefinition,\n  InstanceNodesQueryDefinition,\n  NodeParser,\n  NodePostProcessor,\n  NodePreProcessor,\n} from \"../HierarchyDefinition\";\nimport { HierarchyNode, ParsedHierarchyNode, ParsedInstanceHierarchyNode, ProcessedHierarchyNode } from \"../HierarchyNode\";\nimport { HierarchyNodeIdentifier, HierarchyNodeIdentifiersPath } from \"../HierarchyNodeIdentifier\";\nimport { defaultNodesParser } from \"./TreeNodesReader\";\n\n/** @internal */\nexport interface FilteringQueryBuilderProps {\n  classHierarchy: ECClassHierarchyInspector;\n  source: HierarchyDefinition;\n  nodeIdentifierPaths: HierarchyNodeIdentifiersPath[];\n}\n\n/** @internal */\nexport type FilteredHierarchyNode<TNode = ProcessedHierarchyNode> = TNode & {\n  isFilterTarget?: boolean;\n  filteredChildrenIdentifierPaths?: HierarchyNodeIdentifiersPath[];\n};\n\n/** @internal */\nexport class FilteringHierarchyDefinition implements HierarchyDefinition {\n  private _classHierarchy: ECClassHierarchyInspector;\n  private _source: HierarchyDefinition;\n  private _nodeIdentifierPaths: HierarchyNodeIdentifiersPath[];\n\n  public constructor(props: FilteringQueryBuilderProps) {\n    this._classHierarchy = props.classHierarchy;\n    this._source = props.source;\n    this._nodeIdentifierPaths = props.nodeIdentifierPaths;\n  }\n\n  public get preProcessNode(): NodePreProcessor {\n    return async (node) => {\n      const processedNode = this._source.preProcessNode ? await this._source.preProcessNode(node) : node;\n      if (processedNode?.processingParams?.hideInHierarchy && (node as FilteredHierarchyNode).isFilterTarget) {\n        // we want to hide target nodes if they have `hideInHierarchy` param\n        return undefined;\n      }\n      return processedNode;\n    };\n  }\n\n  public get postProcessNode(): NodePostProcessor {\n    return async (node: ProcessedHierarchyNode) => {\n      const processedNode = this._source.postProcessNode ? await this._source.postProcessNode(node) : node;\n      if (\n        // instance nodes get the auto-expand flag in `parseNode`, but grouping ones need to be handled during post-processing\n        HierarchyNode.isClassGroupingNode(node) &&\n        node.children.some((child: FilteredHierarchyNode) => child.isFilterTarget || child.filteredChildrenIdentifierPaths)\n      ) {\n        return Object.assign(processedNode, { autoExpand: true });\n      }\n      return processedNode;\n    };\n  }\n\n  public get parseNode(): NodeParser {\n    return (row: { [columnName: string]: any }): FilteredHierarchyNode<ParsedInstanceHierarchyNode> => {\n      const isFilterTarget: boolean = !!row[ECSQL_COLUMN_NAME_IsFilterTarget];\n      const parsedFilteredChildrenIdentifierPaths: HierarchyNodeIdentifiersPath[] | undefined = row[ECSQL_COLUMN_NAME_FilteredChildrenPaths]\n        ? JSON.parse(row[ECSQL_COLUMN_NAME_FilteredChildrenPaths])\n        : undefined;\n      const defaultNode = (this._source.parseNode ?? defaultNodesParser)(row);\n      return applyFilterAttributes(defaultNode, parsedFilteredChildrenIdentifierPaths, isFilterTarget);\n    };\n  }\n\n  public async defineHierarchyLevel(\n    props: DefineHierarchyLevelProps & { parentNode: FilteredHierarchyNode<DefineHierarchyLevelProps[\"parentNode\"]> | undefined },\n  ): Promise<HierarchyLevelDefinition> {\n    const sourceDefinitions = await this._source.defineHierarchyLevel(props);\n    const { filteredNodePaths, isParentFilterTarget } = this.getFilteringProps(props.parentNode);\n    if (!filteredNodePaths) {\n      return sourceDefinitions;\n    }\n\n    const filteredDefinitions: HierarchyLevelDefinition = [];\n    await Promise.all(\n      sourceDefinitions.map(async (definition) => {\n        let matchedDefinition: HierarchyNodesDefinition | undefined;\n        if (HierarchyNodesDefinition.isCustomNode(definition)) {\n          matchedDefinition = await matchFilters<{ key: string }>(\n            definition,\n            { filteredNodePaths, isParentFilterTarget },\n            async (id) => {\n              if (!HierarchyNodeIdentifier.isCustomNodeIdentifier(id)) {\n                return false;\n              }\n              return id.key === definition.node.key;\n            },\n            (def, matchingFilters, isFilterTarget) => {\n              const filteredChildrenIdentifierPaths = matchingFilters.reduce(\n                (r, c) => [...r, ...c.childrenIdentifierPaths],\n                new Array<HierarchyNodeIdentifiersPath>(),\n              );\n              return {\n                ...def,\n                node: applyFilterAttributes(def.node, filteredChildrenIdentifierPaths, isFilterTarget),\n              };\n            },\n          );\n        } else {\n          matchedDefinition = await matchFilters<InstanceKey>(\n            definition,\n            { filteredNodePaths, isParentFilterTarget },\n            async (id) => {\n              if (!HierarchyNodeIdentifier.isInstanceNodeIdentifier(id)) {\n                return false;\n              }\n              return this._classHierarchy.classDerivesFrom(id.className, definition.fullClassName);\n            },\n            (def, matchingFilters, isFilterTarget) => applyECInstanceIdsFilter(def, matchingFilters, isFilterTarget, !!isParentFilterTarget),\n          );\n        }\n        if (matchedDefinition) {\n          filteredDefinitions.push(matchedDefinition);\n        }\n      }),\n    );\n    return filteredDefinitions;\n  }\n\n  private getFilteringProps(parentNode: FilteredHierarchyNode<unknown> | undefined) {\n    if (!parentNode) {\n      return { filteredNodePaths: this._nodeIdentifierPaths, isParentFilterTarget: false };\n    }\n    return { filteredNodePaths: parentNode.filteredChildrenIdentifierPaths, isParentFilterTarget: parentNode.isFilterTarget };\n  }\n}\n\nasync function matchFilters<\n  TIdentifier extends HierarchyNodeIdentifier,\n  TDefinition = TIdentifier extends InstanceKey ? InstanceNodesQueryDefinition : CustomHierarchyNodeDefinition,\n>(\n  definition: TDefinition,\n  filteringProps: { filteredNodePaths: HierarchyNodeIdentifiersPath[]; isParentFilterTarget?: boolean },\n  predicate: (id: HierarchyNodeIdentifier) => Promise<boolean>,\n  matchedDefinitionProcessor: (\n    def: TDefinition,\n    matchingFilters: Array<{ id: TIdentifier; childrenIdentifierPaths: HierarchyNodeIdentifiersPath[] }>,\n    isFilterTarget: boolean,\n  ) => TDefinition,\n): Promise<TDefinition | undefined> {\n  const { filteredNodePaths, isParentFilterTarget } = filteringProps;\n  let isFilterTarget = false;\n  const matchingFilters: Array<{ id: TIdentifier; childrenIdentifierPaths: HierarchyNodeIdentifiersPath[] }> = [];\n  for (const path of filteredNodePaths) {\n    if (path.length === 0) {\n      continue;\n    }\n    const nodeId = path[0];\n    if (await predicate(nodeId)) {\n      let childrenIdentifierPaths = matchingFilters.find(({ id }) => HierarchyNodeIdentifier.equal(id, nodeId))?.childrenIdentifierPaths;\n      if (!childrenIdentifierPaths) {\n        childrenIdentifierPaths = [];\n        matchingFilters.push({\n          // ideally, `predicate` would act as a type guard to guarantee that `id` is `TIdentifier`, but at the moment\n          // async type guards aren't supported\n          id: nodeId as TIdentifier,\n          childrenIdentifierPaths,\n        });\n      }\n      const remainingPath = path.slice(1);\n      if (remainingPath.length > 0) {\n        childrenIdentifierPaths.push(remainingPath);\n      } else {\n        isFilterTarget = true;\n      }\n    }\n  }\n  if (isParentFilterTarget || matchingFilters.length > 0) {\n    return matchedDefinitionProcessor(definition, matchingFilters, isFilterTarget);\n  }\n  return undefined;\n}\n\nfunction applyFilterAttributes<TNode extends ParsedHierarchyNode>(\n  node: TNode,\n  filteredChildrenIdentifierPaths: HierarchyNodeIdentifiersPath[] | undefined,\n  isFilterTarget: boolean,\n): TNode {\n  const shouldAutoExpand = !!filteredChildrenIdentifierPaths?.some((path) => !!path.length);\n  return {\n    ...node,\n    ...(isFilterTarget ? { isFilterTarget } : undefined),\n    ...(shouldAutoExpand ? { autoExpand: true } : undefined),\n    ...(!!filteredChildrenIdentifierPaths?.length ? { filteredChildrenIdentifierPaths } : undefined),\n  };\n}\n\n/** @internal */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const ECSQL_COLUMN_NAME_FilteredChildrenPaths = \"FilteredChildrenPaths\";\n\n/** @internal */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const ECSQL_COLUMN_NAME_IsFilterTarget = \"IsFilterTarget\";\n\n/** @internal */\nexport function applyECInstanceIdsFilter(\n  def: InstanceNodesQueryDefinition,\n  matchingFilters: Array<{ id: InstanceKey; childrenIdentifierPaths: HierarchyNodeIdentifiersPath[] }>,\n  isFilterTarget: boolean,\n  isParentFilterTarget: boolean,\n): InstanceNodesQueryDefinition {\n  if (matchingFilters.length === 0) {\n    return def;\n  }\n  return {\n    ...def,\n    query: {\n      ...def.query,\n      ctes: [\n        ...(def.query.ctes ?? []),\n        // note: generally we'd use `VALUES (1,1),(2,2)`, but that doesn't work in ECSQL (https://github.com/iTwin/itwinjs-backlog/issues/865),\n        // so using UNION as a workaround\n        `FilteringInfo(ECInstanceId, FilteredChildrenPaths) AS (\n          ${matchingFilters\n            .map(({ id: key, childrenIdentifierPaths }) => `VALUES (${key.id}, '${JSON.stringify(childrenIdentifierPaths)}')`)\n            .join(\" UNION ALL \")}\n        )`,\n      ],\n      ecsql: `\n        SELECT\n          [q].*,\n          ${isFilterTarget ? \"1\" : \"0\"} AS [${ECSQL_COLUMN_NAME_IsFilterTarget}],\n          [f].[FilteredChildrenPaths] AS [${ECSQL_COLUMN_NAME_FilteredChildrenPaths}]\n        FROM (\n          ${def.query.ecsql}\n        ) [q]\n        ${isParentFilterTarget ? \"LEFT \" : \"\"} JOIN FilteringInfo [f] ON [f].[ECInstanceId] = [q].[ECInstanceId]\n      `,\n    },\n  };\n}\n"]}

package/lib/cjs/hierarchies/internal/LoggingUtils.d.ts

@@ -0,0 +1,14 @@
+import { ECSqlQueryDef, LogLevel } from "@itwin/presentation-shared";
+/** @internal */
+export interface LogMessageProps<TMessageArg = void> {
+    category: string;
+    severity?: LogLevel;
+    message: (arg: TMessageArg) => string;
+}
+/** @internal */
+export declare function doLog(props: LogMessageProps): void;
+/** @internal */
+export declare function log<TMessageArg>(props: LogMessageProps<TMessageArg>): import("rxjs").MonoTypeOperatorFunction<TMessageArg>;
+/** @internal */
+export declare function createQueryLogMessage(query: ECSqlQueryDef): string;
+//# sourceMappingURL=LoggingUtils.d.ts.map

package/lib/cjs/hierarchies/internal/LoggingUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggingUtils.d.ts","sourceRoot":"","sources":["../../../../src/hierarchies/internal/LoggingUtils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAW,QAAQ,EAAkB,MAAM,4BAA4B,CAAC;AAG9F,gBAAgB;AAChB,MAAM,WAAW,eAAe,CAAC,WAAW,GAAG,IAAI;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC;CACvC;AAED,gBAAgB;AAChB,wBAAgB,KAAK,CAAC,KAAK,EAAE,eAAe,QAQ3C;AAeD,gBAAgB;AAChB,wBAAgB,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,wDAEnE;AAED,gBAAgB;AAEhB,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAalE"}

package/lib/cjs/hierarchies/internal/LoggingUtils.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.createQueryLogMessage = exports.log = exports.doLog = void 0;
+const rxjs_1 = require("rxjs");
+const presentation_shared_1 = require("@itwin/presentation-shared");
+const Logging_1 = require("../Logging");
+/** @internal */
+function doLog(props) {
+    const logger = (0, Logging_1.getLogger)();
+    const severity = props.severity ?? "trace";
+    if (!logger.isEnabled(props.category, severity)) {
+        return;
+    }
+    const logFunc = getLogFunc(logger, severity);
+    logFunc(props.category, props.message());
+}
+exports.doLog = doLog;
+function getLogFunc(logger, severity) {
+    switch (severity) {
+        case "error":
+            return logger.logError.bind(logger);
+        case "warning":
+            return logger.logWarning.bind(logger);
+        case "info":
+            return logger.logInfo.bind(logger);
+        case "trace":
+            return logger.logTrace.bind(logger);
+    }
+}
+/** @internal */
+function log(props) {
+    return (0, rxjs_1.tap)((n) => doLog({ ...props, message: () => props.message(n) }));
+}
+exports.log = log;
+/** @internal */
+// istanbul ignore next
+function createQueryLogMessage(query) {
+    const ctes = query.ctes?.map((cte) => `    ${(0, presentation_shared_1.trimWhitespace)(cte)}`).join(", \n");
+    const bindings = query.bindings?.map((b) => JSON.stringify(b.value)).join(", ");
+    let output = "{\n";
+    if (ctes) {
+        output += `  ctes: [ \n${ctes} \n], \n`;
+    }
+    output += `  ecsql: ${(0, presentation_shared_1.trimWhitespace)(query.ecsql)}, \n`;
+    if (bindings) {
+        output += `  bindings: [${bindings}], \n`;
+    }
+    output += "}";
+    return output;
+}
+exports.createQueryLogMessage = createQueryLogMessage;
+//# sourceMappingURL=LoggingUtils.js.map

package/lib/cjs/hierarchies/internal/LoggingUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggingUtils.js","sourceRoot":"","sources":["../../../../src/hierarchies/internal/LoggingUtils.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAEhG,+BAA2B;AAC3B,oEAA8F;AAC9F,wCAAuC;AASvC,gBAAgB;AAChB,SAAgB,KAAK,CAAC,KAAsB;IAC1C,MAAM,MAAM,GAAG,IAAA,mBAAS,GAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;QAChD,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC;AARD,sBAQC;AAED,SAAS,UAAU,CAAC,MAAe,EAAE,QAAkB;IACrD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,SAAgB,GAAG,CAAc,KAAmC;IAClE,OAAO,IAAA,UAAG,EAAc,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC;AAFD,kBAEC;AAED,gBAAgB;AAChB,uBAAuB;AACvB,SAAgB,qBAAqB,CAAC,KAAoB;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,IAAA,oCAAc,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,eAAe,IAAI,UAAU,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,YAAY,IAAA,oCAAc,EAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACxD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,QAAQ,OAAO,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,GAAG,CAAC;IACd,OAAO,MAAM,CAAC;AAChB,CAAC;AAbD,sDAaC","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 { tap } from \"rxjs\";\nimport { ECSqlQueryDef, ILogger, LogLevel, trimWhitespace } from \"@itwin/presentation-shared\";\nimport { getLogger } from \"../Logging\";\n\n/** @internal */\nexport interface LogMessageProps<TMessageArg = void> {\n  category: string;\n  severity?: LogLevel;\n  message: (arg: TMessageArg) => string;\n}\n\n/** @internal */\nexport function doLog(props: LogMessageProps) {\n  const logger = getLogger();\n  const severity = props.severity ?? \"trace\";\n  if (!logger.isEnabled(props.category, severity)) {\n    return;\n  }\n  const logFunc = getLogFunc(logger, severity);\n  logFunc(props.category, props.message());\n}\n\nfunction getLogFunc(logger: ILogger, severity: LogLevel) {\n  switch (severity) {\n    case \"error\":\n      return logger.logError.bind(logger);\n    case \"warning\":\n      return logger.logWarning.bind(logger);\n    case \"info\":\n      return logger.logInfo.bind(logger);\n    case \"trace\":\n      return logger.logTrace.bind(logger);\n  }\n}\n\n/** @internal */\nexport function log<TMessageArg>(props: LogMessageProps<TMessageArg>) {\n  return tap<TMessageArg>((n) => doLog({ ...props, message: () => props.message(n) }));\n}\n\n/** @internal */\n// istanbul ignore next\nexport function createQueryLogMessage(query: ECSqlQueryDef): string {\n  const ctes = query.ctes?.map((cte) => `    ${trimWhitespace(cte)}`).join(\", \\n\");\n  const bindings = query.bindings?.map((b) => JSON.stringify(b.value)).join(\", \");\n  let output = \"{\\n\";\n  if (ctes) {\n    output += `  ctes: [ \\n${ctes} \\n], \\n`;\n  }\n  output += `  ecsql: ${trimWhitespace(query.ecsql)}, \\n`;\n  if (bindings) {\n    output += `  bindings: [${bindings}], \\n`;\n  }\n  output += \"}\";\n  return output;\n}\n"]}

package/lib/cjs/hierarchies/internal/SubscriptionScheduler.d.ts

@@ -0,0 +1,17 @@
+import { Observable } from "rxjs";
+/** @internal */
+export declare class SubscriptionScheduler {
+    private _scheduler;
+    constructor(concurrency: number);
+    /**
+     * Schedules `source` for subscription in the current scheduler.
+     *
+     * The actual scheduling is performed when the returned observable is subscribed to. To cancel, remove all subscribers
+     * from the returned observable.
+     *
+     * @param source Input observable for which to schedule a subscription.
+     * @returns Hot observable which starts emitting `source` values after subscription.
+     */
+    scheduleSubscription<T>(source: Observable<T>): Observable<T>;
+}
+//# sourceMappingURL=SubscriptionScheduler.d.ts.map

package/lib/cjs/hierarchies/internal/SubscriptionScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionScheduler.d.ts","sourceRoot":"","sources":["../../../../src/hierarchies/internal/SubscriptionScheduler.ts"],"names":[],"mappings":"AAKA,OAAO,EASL,UAAU,EAOX,MAAM,MAAM,CAAC;AAEd,gBAAgB;AAChB,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAAuC;gBAC7C,WAAW,EAAE,MAAM;IAwB/B;;;;;;;;OAQG;IACI,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;CAkBrE"}

package/lib/cjs/hierarchies/internal/SubscriptionScheduler.js

@@ -0,0 +1,57 @@
+"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.SubscriptionScheduler = void 0;
+const rxjs_1 = require("rxjs");
+/** @internal */
+class SubscriptionScheduler {
+    _scheduler = new rxjs_1.Subject();
+    constructor(concurrency) {
+        this._scheduler
+            .pipe((0, rxjs_1.mergeMap)((sourceObservable) => {
+            return sourceObservable.pipe(
+            // connect source observable when scheduler subscribes
+            (0, rxjs_1.tap)({
+                subscribe: () => {
+                    sourceObservable.connect();
+                },
+            }), 
+            // Guard against stack overflow when a lot of observables are scheduled. Without this operation `mergeMap`
+            // will process each observable that is present in the pipeline recursively.
+            (0, rxjs_1.observeOn)(rxjs_1.queueScheduler), 
+            // Delay the connection until another event loop task
+            (0, rxjs_1.subscribeOn)(rxjs_1.asapScheduler), 
+            // Ignore errors in this pipeline without suppressing them for other subscribers
+            (0, rxjs_1.onErrorResumeNextWith)());
+        }, concurrency))
+            // Start consuming scheduled observables
+            .subscribe();
+    }
+    /**
+     * Schedules `source` for subscription in the current scheduler.
+     *
+     * The actual scheduling is performed when the returned observable is subscribed to. To cancel, remove all subscribers
+     * from the returned observable.
+     *
+     * @param source Input observable for which to schedule a subscription.
+     * @returns Hot observable which starts emitting `source` values after subscription.
+     */
+    scheduleSubscription(source) {
+        return (0, rxjs_1.defer)(() => {
+            let unsubscribed = false;
+            const connectableObservable = (0, rxjs_1.connectable)((0, rxjs_1.iif)(() => unsubscribed, rxjs_1.EMPTY, source), {
+                connector: () => new rxjs_1.Subject(),
+                resetOnDisconnect: false,
+            });
+            this._scheduler.next(connectableObservable);
+            return connectableObservable.pipe((0, rxjs_1.finalize)(() => {
+                unsubscribed = true;
+            }));
+        });
+    }
+}
+exports.SubscriptionScheduler = SubscriptionScheduler;
+//# sourceMappingURL=SubscriptionScheduler.js.map

package/lib/cjs/hierarchies/internal/SubscriptionScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionScheduler.js","sourceRoot":"","sources":["../../../../src/hierarchies/internal/SubscriptionScheduler.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAEhG,+BAgBc;AAEd,gBAAgB;AAChB,MAAa,qBAAqB;IACxB,UAAU,GAAG,IAAI,cAAO,EAAwB,CAAC;IACzD,YAAY,WAAmB;QAC7B,IAAI,CAAC,UAAU;aACZ,IAAI,CACH,IAAA,eAAQ,EAAC,CAAC,gBAAgB,EAAE,EAAE;YAC5B,OAAO,gBAAgB,CAAC,IAAI;YAC1B,sDAAsD;YACtD,IAAA,UAAG,EAAC;gBACF,SAAS,EAAE,GAAG,EAAE;oBACd,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC7B,CAAC;aACF,CAAC;YACF,0GAA0G;YAC1G,4EAA4E;YAC5E,IAAA,gBAAS,EAAC,qBAAc,CAAC;YACzB,qDAAqD;YACrD,IAAA,kBAAW,EAAC,oBAAa,CAAC;YAC1B,gFAAgF;YAChF,IAAA,4BAAqB,GAAE,CACxB,CAAC;QACJ,CAAC,EAAE,WAAW,CAAC,CAChB;YACD,wCAAwC;aACvC,SAAS,EAAE,CAAC;IACjB,CAAC;IACD;;;;;;;;OAQG;IACI,oBAAoB,CAAI,MAAqB;QAClD,OAAO,IAAA,YAAK,EAAC,GAAG,EAAE;YAChB,IAAI,YAAY,GAAG,KAAK,CAAC;YACzB,MAAM,qBAAqB,GAAG,IAAA,kBAAW,EACvC,IAAA,UAAG,EAAC,GAAG,EAAE,CAAC,YAAY,EAAE,YAAK,EAAE,MAAM,CAAC,EACtC;gBACE,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,cAAO,EAAK;gBACjC,iBAAiB,EAAE,KAAK;aACzB,CACF,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC5C,OAAO,qBAAqB,CAAC,IAAI,CAC/B,IAAA,eAAQ,EAAC,GAAG,EAAE;gBACZ,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AArDD,sDAqDC","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  asapScheduler,\n  Connectable,\n  connectable,\n  defer,\n  EMPTY,\n  finalize,\n  iif,\n  mergeMap,\n  Observable,\n  observeOn,\n  onErrorResumeNextWith,\n  queueScheduler,\n  Subject,\n  subscribeOn,\n  tap,\n} from \"rxjs\";\n\n/** @internal */\nexport class SubscriptionScheduler {\n  private _scheduler = new Subject<Connectable<unknown>>();\n  constructor(concurrency: number) {\n    this._scheduler\n      .pipe(\n        mergeMap((sourceObservable) => {\n          return sourceObservable.pipe(\n            // connect source observable when scheduler subscribes\n            tap({\n              subscribe: () => {\n                sourceObservable.connect();\n              },\n            }),\n            // Guard against stack overflow when a lot of observables are scheduled. Without this operation `mergeMap`\n            // will process each observable that is present in the pipeline recursively.\n            observeOn(queueScheduler),\n            // Delay the connection until another event loop task\n            subscribeOn(asapScheduler),\n            // Ignore errors in this pipeline without suppressing them for other subscribers\n            onErrorResumeNextWith(),\n          );\n        }, concurrency),\n      )\n      // Start consuming scheduled observables\n      .subscribe();\n  }\n  /**\n   * Schedules `source` for subscription in the current scheduler.\n   *\n   * The actual scheduling is performed when the returned observable is subscribed to. To cancel, remove all subscribers\n   * from the returned observable.\n   *\n   * @param source Input observable for which to schedule a subscription.\n   * @returns Hot observable which starts emitting `source` values after subscription.\n   */\n  public scheduleSubscription<T>(source: Observable<T>): Observable<T> {\n    return defer(() => {\n      let unsubscribed = false;\n      const connectableObservable = connectable(\n        iif(() => unsubscribed, EMPTY, source),\n        {\n          connector: () => new Subject<T>(),\n          resetOnDisconnect: false,\n        },\n      );\n      this._scheduler.next(connectableObservable);\n      return connectableObservable.pipe(\n        finalize(() => {\n          unsubscribed = true;\n        }),\n      );\n    });\n  }\n}\n"]}

package/lib/cjs/hierarchies/internal/TreeNodesReader.d.ts

@@ -0,0 +1,37 @@
+import { Observable } from "rxjs";
+import { Id64String } from "@itwin/core-bentley";
+import { ECSqlQueryDef } from "@itwin/presentation-shared";
+import { NodeParser } from "../HierarchyDefinition";
+import { ParsedHierarchyNode, ParsedInstanceHierarchyNode } from "../HierarchyNode";
+import { LimitingECSqlQueryExecutor } from "../LimitingECSqlQueryExecutor";
+import { NodeSelectClauseColumnNames } from "../NodeSelectQueryFactory";
+interface ReadNodesProps {
+    queryExecutor: LimitingECSqlQueryExecutor;
+    query: ECSqlQueryDef;
+    limit?: number | "unbounded";
+    parser?: NodeParser;
+}
+/** @internal */
+export declare function readNodes(props: ReadNodesProps): Observable<ParsedHierarchyNode>;
+/**
+ * The interface should contain a member for each `NodeSelectClauseColumnNames` value.
+ * @internal
+ */
+export interface RowDef {
+    [NodeSelectClauseColumnNames.FullClassName]: string;
+    [NodeSelectClauseColumnNames.ECInstanceId]: Id64String;
+    [NodeSelectClauseColumnNames.DisplayLabel]: string;
+    [NodeSelectClauseColumnNames.HasChildren]?: boolean;
+    [NodeSelectClauseColumnNames.HideIfNoChildren]?: boolean;
+    [NodeSelectClauseColumnNames.HideNodeInHierarchy]?: boolean;
+    [NodeSelectClauseColumnNames.Grouping]?: string;
+    [NodeSelectClauseColumnNames.ExtendedData]?: string;
+    [NodeSelectClauseColumnNames.AutoExpand]?: boolean;
+    [NodeSelectClauseColumnNames.SupportsFiltering]?: boolean;
+}
+/** @internal */
+export declare function defaultNodesParser(row: {
+    [columnName: string]: any;
+}): ParsedInstanceHierarchyNode;
+export {};
+//# sourceMappingURL=TreeNodesReader.d.ts.map

package/lib/cjs/hierarchies/internal/TreeNodesReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeNodesReader.d.ts","sourceRoot":"","sources":["../../../../src/hierarchies/internal/TreeNodesReader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,UAAU,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAsB,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAyC,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC3H,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAExE,UAAU,cAAc;IACtB,aAAa,EAAE,0BAA0B,CAAC;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,gBAAgB;AAChB,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAQhF;AAED;;;GAGG;AAEH,MAAM,WAAW,MAAM;IACrB,CAAC,2BAA2B,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IACpD,CAAC,2BAA2B,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACvD,CAAC,2BAA2B,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IACnD,CAAC,2BAA2B,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC;IACpD,CAAC,2BAA2B,CAAC,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC;IACzD,CAAC,2BAA2B,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;IAC5D,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAChD,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;IACpD,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC;IACnD,CAAC,2BAA2B,CAAC,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC;CAC3D;AAGD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IAAE,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,GAAG,2BAA2B,CAoBlG"}

package/lib/cjs/hierarchies/internal/TreeNodesReader.js

@@ -0,0 +1,46 @@
+"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.defaultNodesParser = exports.readNodes = void 0;
+const rxjs_1 = require("rxjs");
+const presentation_shared_1 = require("@itwin/presentation-shared");
+const NodeSelectQueryFactory_1 = require("../NodeSelectQueryFactory");
+/** @internal */
+function readNodes(props) {
+    const { queryExecutor, query, limit } = props;
+    const parser = props?.parser ?? defaultNodesParser;
+    const config = {
+        rowFormat: "ECSqlPropertyNames",
+        ...(limit !== undefined ? { limit } : undefined),
+    };
+    return (0, rxjs_1.from)(queryExecutor.createQueryReader(query, config)).pipe((0, rxjs_1.map)(parser));
+}
+exports.readNodes = readNodes;
+/* eslint-enable @typescript-eslint/naming-convention */
+/** @internal */
+function defaultNodesParser(row) {
+    const typedRow = row;
+    const processingParams = {
+        ...(typedRow.HideIfNoChildren ? { hideIfNoChildren: true } : undefined),
+        ...(typedRow.HideNodeInHierarchy ? { hideInHierarchy: true } : undefined),
+        ...(typedRow.Grouping ? { grouping: JSON.parse(typedRow.Grouping) } : undefined),
+    };
+    return {
+        // don't format the label here - we're going to do that at node pre-processing step to handle both - instance and custom nodes
+        label: (0, presentation_shared_1.parseInstanceLabel)(typedRow.DisplayLabel),
+        key: {
+            type: "instances",
+            instanceKeys: [{ className: typedRow.FullClassName.replace(":", "."), id: typedRow.ECInstanceId }],
+        },
+        ...(typedRow.HasChildren !== undefined ? { children: !!typedRow.HasChildren } : undefined),
+        ...(typedRow.AutoExpand ? { autoExpand: true } : undefined),
+        ...(typedRow.SupportsFiltering ? { supportsFiltering: true } : undefined),
+        ...(typedRow.ExtendedData ? { extendedData: JSON.parse(typedRow.ExtendedData) } : undefined),
+        ...(Object.keys(processingParams).length > 0 ? { processingParams } : undefined),
+    };
+}
+exports.defaultNodesParser = defaultNodesParser;
+//# sourceMappingURL=TreeNodesReader.js.map

package/lib/cjs/hierarchies/internal/TreeNodesReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeNodesReader.js","sourceRoot":"","sources":["../../../../src/hierarchies/internal/TreeNodesReader.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAEhG,+BAA6C;AAE7C,oEAA+E;AAI/E,sEAAwE;AASxE,gBAAgB;AAChB,SAAgB,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,kBAAkB,CAAC;IACnD,MAAM,MAAM,GAAmE;QAC7E,SAAS,EAAE,oBAAoB;QAC/B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KACjD,CAAC;IACF,OAAO,IAAA,WAAI,EAAC,aAAa,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAA,UAAG,EAAC,MAAM,CAAC,CAAC,CAAC;AAChF,CAAC;AARD,8BAQC;AAmBD,wDAAwD;AAExD,gBAAgB;AAChB,SAAgB,kBAAkB,CAAC,GAAkC;IACnE,MAAM,QAAQ,GAAG,GAAa,CAAC;IAC/B,MAAM,gBAAgB,GAA0C;QAC9D,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KACjF,CAAC;IACF,OAAO;QACL,8HAA8H;QAC9H,KAAK,EAAE,IAAA,wCAAkB,EAAC,QAAQ,CAAC,YAAY,CAAC;QAChD,GAAG,EAAE;YACH,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC;SACnG;QACD,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1F,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KACjF,CAAC;AACJ,CAAC;AApBD,gDAoBC","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 { from, map, Observable } from \"rxjs\";\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { ECSqlQueryDef, parseInstanceLabel } from \"@itwin/presentation-shared\";\nimport { NodeParser } from \"../HierarchyDefinition\";\nimport { InstanceHierarchyNodeProcessingParams, ParsedHierarchyNode, ParsedInstanceHierarchyNode } from \"../HierarchyNode\";\nimport { LimitingECSqlQueryExecutor } from \"../LimitingECSqlQueryExecutor\";\nimport { NodeSelectClauseColumnNames } from \"../NodeSelectQueryFactory\";\n\ninterface ReadNodesProps {\n  queryExecutor: LimitingECSqlQueryExecutor;\n  query: ECSqlQueryDef;\n  limit?: number | \"unbounded\";\n  parser?: NodeParser;\n}\n\n/** @internal */\nexport function readNodes(props: ReadNodesProps): Observable<ParsedHierarchyNode> {\n  const { queryExecutor, query, limit } = props;\n  const parser = props?.parser ?? defaultNodesParser;\n  const config: Parameters<LimitingECSqlQueryExecutor[\"createQueryReader\"]>[1] = {\n    rowFormat: \"ECSqlPropertyNames\",\n    ...(limit !== undefined ? { limit } : undefined),\n  };\n  return from(queryExecutor.createQueryReader(query, config)).pipe(map(parser));\n}\n\n/**\n * The interface should contain a member for each `NodeSelectClauseColumnNames` value.\n * @internal\n */\n/* eslint-disable @typescript-eslint/naming-convention */\nexport interface RowDef {\n  [NodeSelectClauseColumnNames.FullClassName]: string;\n  [NodeSelectClauseColumnNames.ECInstanceId]: Id64String;\n  [NodeSelectClauseColumnNames.DisplayLabel]: string;\n  [NodeSelectClauseColumnNames.HasChildren]?: boolean;\n  [NodeSelectClauseColumnNames.HideIfNoChildren]?: boolean;\n  [NodeSelectClauseColumnNames.HideNodeInHierarchy]?: boolean;\n  [NodeSelectClauseColumnNames.Grouping]?: string;\n  [NodeSelectClauseColumnNames.ExtendedData]?: string;\n  [NodeSelectClauseColumnNames.AutoExpand]?: boolean;\n  [NodeSelectClauseColumnNames.SupportsFiltering]?: boolean;\n}\n/* eslint-enable @typescript-eslint/naming-convention */\n\n/** @internal */\nexport function defaultNodesParser(row: { [columnName: string]: any }): ParsedInstanceHierarchyNode {\n  const typedRow = row as RowDef;\n  const processingParams: InstanceHierarchyNodeProcessingParams = {\n    ...(typedRow.HideIfNoChildren ? { hideIfNoChildren: true } : undefined),\n    ...(typedRow.HideNodeInHierarchy ? { hideInHierarchy: true } : undefined),\n    ...(typedRow.Grouping ? { grouping: JSON.parse(typedRow.Grouping) } : undefined),\n  };\n  return {\n    // don't format the label here - we're going to do that at node pre-processing step to handle both - instance and custom nodes\n    label: parseInstanceLabel(typedRow.DisplayLabel),\n    key: {\n      type: \"instances\",\n      instanceKeys: [{ className: typedRow.FullClassName.replace(\":\", \".\"), id: typedRow.ECInstanceId }],\n    },\n    ...(typedRow.HasChildren !== undefined ? { children: !!typedRow.HasChildren } : undefined),\n    ...(typedRow.AutoExpand ? { autoExpand: true } : undefined),\n    ...(typedRow.SupportsFiltering ? { supportsFiltering: true } : undefined),\n    ...(typedRow.ExtendedData ? { extendedData: JSON.parse(typedRow.ExtendedData) } : undefined),\n    ...(Object.keys(processingParams).length > 0 ? { processingParams } : undefined),\n  };\n}\n"]}

package/lib/cjs/hierarchies/internal/operators/DetermineChildren.d.ts

@@ -0,0 +1,11 @@
+import { Observable } from "rxjs";
+import { ProcessedHierarchyNode } from "../../HierarchyNode";
+/** @internal */
+export declare const LOGGING_NAMESPACE: string;
+/**
+ * Ensures all input nodes have their children determined.
+ *
+ * @internal
+ */
+export declare function createDetermineChildrenOperator(hasNodes: (node: ProcessedHierarchyNode) => Observable<boolean>): (nodes: Observable<ProcessedHierarchyNode>) => Observable<ProcessedHierarchyNode>;
+//# sourceMappingURL=DetermineChildren.d.ts.map

package/lib/cjs/hierarchies/internal/operators/DetermineChildren.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetermineChildren.d.ts","sourceRoot":"","sources":["../../../../../src/hierarchies/internal/operators/DetermineChildren.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,UAAU,EAAM,MAAM,MAAM,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,QAAgD,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,UAAU,CAAC,OAAO,CAAC,WACrF,WAAW,sBAAsB,CAAC,KAAG,WAAW,sBAAsB,CAAC,CAmBhG"}

package/lib/cjs/hierarchies/internal/operators/DetermineChildren.js

@@ -0,0 +1,34 @@
+"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.createDetermineChildrenOperator = exports.LOGGING_NAMESPACE = void 0;
+const rxjs_1 = require("rxjs");
+const Common_1 = require("../Common");
+const LoggingUtils_1 = require("../LoggingUtils");
+const ReleaseMainThread_1 = require("./ReleaseMainThread");
+const OPERATOR_NAME = "DetermineChildren";
+/** @internal */
+exports.LOGGING_NAMESPACE = (0, Common_1.createOperatorLoggingNamespace)(OPERATOR_NAME);
+/**
+ * Ensures all input nodes have their children determined.
+ *
+ * @internal
+ */
+function createDetermineChildrenOperator(hasNodes) {
+    return function (nodes) {
+        return nodes.pipe((0, LoggingUtils_1.log)({ category: exports.LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `in: ${(0, Common_1.createNodeIdentifierForLogging)(n)}` }), (0, ReleaseMainThread_1.releaseMainThreadOnItemsCount)(200), (0, rxjs_1.concatMap)((n) => {
+            if (n.children !== undefined) {
+                return (0, rxjs_1.of)(n);
+            }
+            return hasNodes(n).pipe((0, LoggingUtils_1.log)({
+                category: exports.LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ (hasChildrenFlag) => `${(0, Common_1.createNodeIdentifierForLogging)(n)}: determined children: ${hasChildrenFlag}`,
+            }), (0, rxjs_1.map)((hasChildrenFlag) => Object.assign(n, { children: hasChildrenFlag })));
+        }), (0, LoggingUtils_1.log)({ category: exports.LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `out: ${(0, Common_1.createNodeIdentifierForLogging)(n)}` }));
+    };
+}
+exports.createDetermineChildrenOperator = createDetermineChildrenOperator;
+//# sourceMappingURL=DetermineChildren.js.map

package/lib/cjs/hierarchies/internal/operators/DetermineChildren.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetermineChildren.js","sourceRoot":"","sources":["../../../../../src/hierarchies/internal/operators/DetermineChildren.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAEhG,+BAAsD;AAEtD,sCAA2F;AAC3F,kDAAsC;AACtC,2DAAoE;AAEpE,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAC1C,gBAAgB;AACH,QAAA,iBAAiB,GAAG,IAAA,uCAA8B,EAAC,aAAa,CAAC,CAAC;AAE/E;;;;GAIG;AACH,SAAgB,+BAA+B,CAAC,QAA+D;IAC7G,OAAO,UAAU,KAAyC;QACxD,OAAO,KAAK,CAAC,IAAI,CACf,IAAA,kBAAG,EAAC,EAAE,QAAQ,EAAE,yBAAiB,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,IAAA,uCAA8B,EAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAC3H,IAAA,iDAA6B,EAAC,GAAG,CAAC,EAClC,IAAA,gBAAS,EAAC,CAAC,CAAyB,EAAsC,EAAE;YAC1E,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,IAAA,SAAE,EAAC,CAAC,CAAC,CAAC;YACf,CAAC;YACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACrB,IAAA,kBAAG,EAAC;gBACF,QAAQ,EAAE,yBAAiB;gBAC3B,OAAO,EAAE,0BAA0B,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,GAAG,IAAA,uCAA8B,EAAC,CAAC,CAAC,0BAA0B,eAAe,EAAE;aACzI,CAAC,EACF,IAAA,UAAG,EAAC,CAAC,eAAe,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC,CAC1E,CAAC;QACJ,CAAC,CAAC,EACF,IAAA,kBAAG,EAAC,EAAE,QAAQ,EAAE,yBAAiB,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,IAAA,uCAA8B,EAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAC7H,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AApBD,0EAoBC","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 { concatMap, map, Observable, of } from \"rxjs\";\nimport { ProcessedHierarchyNode } from \"../../HierarchyNode\";\nimport { createNodeIdentifierForLogging, createOperatorLoggingNamespace } from \"../Common\";\nimport { log } from \"../LoggingUtils\";\nimport { releaseMainThreadOnItemsCount } from \"./ReleaseMainThread\";\n\nconst OPERATOR_NAME = \"DetermineChildren\";\n/** @internal */\nexport const LOGGING_NAMESPACE = createOperatorLoggingNamespace(OPERATOR_NAME);\n\n/**\n * Ensures all input nodes have their children determined.\n *\n * @internal\n */\nexport function createDetermineChildrenOperator(hasNodes: (node: ProcessedHierarchyNode) => Observable<boolean>) {\n  return function (nodes: Observable<ProcessedHierarchyNode>): Observable<ProcessedHierarchyNode> {\n    return nodes.pipe(\n      log({ category: LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `in: ${createNodeIdentifierForLogging(n)}` }),\n      releaseMainThreadOnItemsCount(200),\n      concatMap((n: ProcessedHierarchyNode): Observable<ProcessedHierarchyNode> => {\n        if (n.children !== undefined) {\n          return of(n);\n        }\n        return hasNodes(n).pipe(\n          log({\n            category: LOGGING_NAMESPACE,\n            message: /* istanbul ignore next */ (hasChildrenFlag) => `${createNodeIdentifierForLogging(n)}: determined children: ${hasChildrenFlag}`,\n          }),\n          map((hasChildrenFlag) => Object.assign(n, { children: hasChildrenFlag })),\n        );\n      }),\n      log({ category: LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `out: ${createNodeIdentifierForLogging(n)}` }),\n    );\n  };\n}\n"]}

package/lib/cjs/hierarchies/internal/operators/Grouping.d.ts

@@ -0,0 +1,27 @@
+import { Observable } from "rxjs";
+import { ECClassHierarchyInspector, ECSchemaProvider, IPrimitiveValueFormatter } from "@itwin/presentation-shared";
+import { ParentHierarchyNode, ProcessedGroupingHierarchyNode, ProcessedHierarchyNode, ProcessedInstanceHierarchyNode } from "../../HierarchyNode";
+import { PropertiesGroupingLocalizedStrings } from "./grouping/PropertiesGrouping";
+/** @internal */
+export declare const LOGGING_NAMESPACE: string;
+/** @internal */
+export declare function createGroupingOperator(imodelAccess: ECSchemaProvider & ECClassHierarchyInspector, parentNode: ParentHierarchyNode | undefined, valueFormatter: IPrimitiveValueFormatter, localizedStrings: PropertiesGroupingLocalizedStrings, onGroupingNodeCreated?: (groupingNode: ProcessedGroupingHierarchyNode) => void, groupingHandlers?: GroupingHandler[]): (nodes: Observable<ProcessedHierarchyNode>) => Observable<ProcessedHierarchyNode>;
+/** @internal */
+export type ProcessedInstancesGroupingHierarchyNode = Omit<ProcessedGroupingHierarchyNode, "children"> & {
+    children: ProcessedInstanceHierarchyNode[];
+};
+/** @internal */
+export interface GroupingHandlerResult {
+    /** Expected to be sorted by label. */
+    grouped: Array<ProcessedInstancesGroupingHierarchyNode>;
+    /** Expected to be sorted by label. */
+    ungrouped: ProcessedInstanceHierarchyNode[];
+    groupingType: GroupingType;
+}
+/** @internal */
+export type GroupingType = "label" | "class" | "base-class" | "property";
+/** @internal */
+export type GroupingHandler = (nodesToGroup: ProcessedInstanceHierarchyNode[], nodesAlreadyGrouped: ProcessedInstancesGroupingHierarchyNode[]) => Promise<GroupingHandlerResult>;
+/** @internal */
+export declare function createGroupingHandlers(imodelAccess: ECSchemaProvider & ECClassHierarchyInspector, parentNode: ParentHierarchyNode | undefined, processedInstanceNodes: ProcessedInstanceHierarchyNode[], valueFormatter: IPrimitiveValueFormatter, localizedStrings: PropertiesGroupingLocalizedStrings): Observable<GroupingHandler>;
+//# sourceMappingURL=Grouping.d.ts.map

package/lib/cjs/hierarchies/internal/operators/Grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grouping.d.ts","sourceRoot":"","sources":["../../../../../src/hierarchies/internal/operators/Grouping.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuF,UAAU,EAA4B,MAAM,MAAM,CAAC;AAEjJ,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACnH,OAAO,EAEL,mBAAmB,EACnB,8BAA8B,EAC9B,sBAAsB,EACtB,8BAA8B,EAC/B,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAoC,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAKrH,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,QAAgD,CAAC;AAG/E,gBAAgB;AAChB,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,gBAAgB,GAAG,yBAAyB,EAC1D,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,cAAc,EAAE,wBAAwB,EACxC,gBAAgB,EAAE,kCAAkC,EACpD,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,8BAA8B,KAAK,IAAI,EAC9E,gBAAgB,CAAC,EAAE,eAAe,EAAE,WAEZ,WAAW,sBAAsB,CAAC,KAAG,WAAW,sBAAsB,CAAC,CAyDhG;AAED,gBAAgB;AAChB,MAAM,MAAM,uCAAuC,GAAG,IAAI,CAAC,8BAA8B,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,EAAE,8BAA8B,EAAE,CAAA;CAAE,CAAC;AAExJ,gBAAgB;AAChB,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,OAAO,EAAE,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxD,sCAAsC;IACtC,SAAS,EAAE,8BAA8B,EAAE,CAAC;IAC5C,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,gBAAgB;AAChB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzE,gBAAgB;AAChB,MAAM,MAAM,eAAe,GAAG,CAC5B,YAAY,EAAE,8BAA8B,EAAE,EAC9C,mBAAmB,EAAE,uCAAuC,EAAE,KAC3D,OAAO,CAAC,qBAAqB,CAAC,CAAC;AA6EpC,gBAAgB;AAChB,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,gBAAgB,GAAG,yBAAyB,EAC1D,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,sBAAsB,EAAE,8BAA8B,EAAE,EACxD,cAAc,EAAE,wBAAwB,EACxC,gBAAgB,EAAE,kCAAkC,GACnD,UAAU,CAAC,eAAe,CAAC,CA+B7B"}

package/lib/cjs/hierarchies/internal/operators/Grouping.js

@@ -0,0 +1,161 @@
+"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.createGroupingHandlers = exports.createGroupingOperator = exports.LOGGING_NAMESPACE = void 0;
+const rxjs_1 = require("rxjs");
+const core_bentley_1 = require("@itwin/core-bentley");
+const HierarchyNode_1 = require("../../HierarchyNode");
+const Common_1 = require("../Common");
+const LoggingUtils_1 = require("../LoggingUtils");
+const AutoExpand_1 = require("./grouping/AutoExpand");
+const BaseClassGrouping_1 = require("./grouping/BaseClassGrouping");
+const ClassGrouping_1 = require("./grouping/ClassGrouping");
+const GroupHiding_1 = require("./grouping/GroupHiding");
+const LabelGrouping_1 = require("./grouping/LabelGrouping");
+const PropertiesGrouping_1 = require("./grouping/PropertiesGrouping");
+const ReleaseMainThread_1 = require("./ReleaseMainThread");
+const TapOnce_1 = require("./TapOnce");
+const OPERATOR_NAME = "Grouping";
+/** @internal */
+exports.LOGGING_NAMESPACE = (0, Common_1.createOperatorLoggingNamespace)(OPERATOR_NAME);
+const PERF_LOGGING_NAMESPACE = `${exports.LOGGING_NAMESPACE}.Performance`;
+/** @internal */
+function createGroupingOperator(imodelAccess, parentNode, valueFormatter, localizedStrings, onGroupingNodeCreated, groupingHandlers) {
+    return function (nodes) {
+        return nodes.pipe((0, LoggingUtils_1.log)({ category: exports.LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `in: ${(0, Common_1.createNodeIdentifierForLogging)(n)}` }), (0, TapOnce_1.tapOnce)(() => {
+            (0, LoggingUtils_1.doLog)({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Starting grouping (parent: ${(0, Common_1.createNodeIdentifierForLogging)(parentNode)})`,
+            });
+        }), (0, rxjs_1.reduce)((resolvedNodes, node) => {
+            if (HierarchyNode_1.HierarchyNode.isInstancesNode(node)) {
+                resolvedNodes.instanceNodes.push(node);
+            }
+            else {
+                resolvedNodes.restNodes.push(node);
+            }
+            return resolvedNodes;
+        }, { instanceNodes: [], restNodes: [] }), (0, rxjs_1.tap)(({ instanceNodes, restNodes }) => {
+            (0, LoggingUtils_1.doLog)({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Nodes partitioned. Got ${instanceNodes.length} instance nodes and ${restNodes.length} rest nodes.`,
+            });
+        }), (0, rxjs_1.mergeMap)((res) => {
+            const out = (0, rxjs_1.of)(res);
+            const totalNodes = res.instanceNodes.length + res.restNodes.length;
+            // istanbul ignore next
+            return totalNodes <= 1000 ? out : out.pipe((0, rxjs_1.delay)(0));
+        }), (0, rxjs_1.mergeMap)(({ instanceNodes, restNodes }) => {
+            const timer = new core_bentley_1.StopWatch(undefined, true);
+            const groupingHandlersObs = groupingHandlers
+                ? (0, rxjs_1.from)(groupingHandlers)
+                : createGroupingHandlers(imodelAccess, parentNode, instanceNodes, valueFormatter, localizedStrings);
+            return (0, rxjs_1.merge)(groupingHandlersObs.pipe((0, rxjs_1.toArray)(), (0, rxjs_1.mergeMap)((createdGroupingHandlers) => groupInstanceNodes(instanceNodes, restNodes.length, createdGroupingHandlers, parentNode, onGroupingNodeCreated)), (0, rxjs_1.finalize)(() => {
+                (0, LoggingUtils_1.doLog)({
+                    category: PERF_LOGGING_NAMESPACE,
+                    message: /* istanbul ignore next */ () => `Grouping ${instanceNodes.length} nodes took ${timer.elapsedSeconds.toFixed(3)} s`,
+                });
+            })), (0, rxjs_1.from)(restNodes));
+        }), (0, ReleaseMainThread_1.releaseMainThreadOnItemsCount)(500), (0, LoggingUtils_1.log)({ category: exports.LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `out: ${(0, Common_1.createNodeIdentifierForLogging)(n)}` }));
+    };
+}
+exports.createGroupingOperator = createGroupingOperator;
+function groupInstanceNodes(nodes, extraSiblings, groupingHandlers, parentNode, onGroupingNodeCreated) {
+    if (groupingHandlers.length === 0) {
+        return (0, rxjs_1.from)(nodes);
+    }
+    return (0, rxjs_1.of)({ handlerIndex: 0 }).pipe((0, rxjs_1.expand)(({ handlerIndex, result: curr }) => {
+        if (handlerIndex >= groupingHandlers.length) {
+            return rxjs_1.EMPTY;
+        }
+        const timer = new core_bentley_1.StopWatch(undefined, true);
+        const currentHandler = groupingHandlers[handlerIndex];
+        return (0, rxjs_1.from)(currentHandler(curr?.ungrouped ?? nodes, curr?.grouped ?? [])).pipe((0, LoggingUtils_1.log)({
+            category: PERF_LOGGING_NAMESPACE,
+            message: /* istanbul ignore next */ () => `Grouping handler ${handlerIndex} exclusively took ${timer.elapsedSeconds.toFixed(3)} s.`,
+        }), (0, rxjs_1.mergeMap)((result) => {
+            if (result.grouped.length === 0) {
+                return (0, rxjs_1.of)({ handlerIndex: handlerIndex + 1, result: { ...result, grouped: curr?.grouped ?? [] } });
+            }
+            const groupingPostProcessingTimer = new core_bentley_1.StopWatch(undefined, true);
+            return (0, rxjs_1.of)(result).pipe((0, rxjs_1.map)((r) => (0, GroupHiding_1.applyGroupHidingParams)(r, extraSiblings)), (0, rxjs_1.map)((r) => (0, AutoExpand_1.assignAutoExpand)(r)), (0, rxjs_1.map)((r) => ({ handlerIndex: handlerIndex + 1, result: { ...r, grouped: mergeInPlace(curr?.grouped, r.grouped) } })), (0, LoggingUtils_1.log)({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Post-processing grouping handler ${handlerIndex} exclusively took ${groupingPostProcessingTimer.elapsedSeconds.toFixed(3)} s.`,
+            }), (0, rxjs_1.delay)(0));
+        }), (0, LoggingUtils_1.log)({
+            category: PERF_LOGGING_NAMESPACE,
+            message: /* istanbul ignore next */ () => `Total time for grouping handler ${handlerIndex}: ${timer.elapsedSeconds.toFixed(3)} s.`,
+        }));
+    }), (0, rxjs_1.last)(), (0, rxjs_1.mergeMap)(({ result }) => {
+        result.grouped.forEach((groupingNode) => {
+            onGroupingNodeCreated?.(groupingNode);
+            if (!parentNode) {
+                return;
+            }
+            if (HierarchyNode_1.HierarchyNode.isGroupingNode(parentNode)) {
+                groupingNode.nonGroupingAncestor = parentNode.nonGroupingAncestor;
+                return;
+            }
+            // not sure why type checker doesn't pick this up
+            (0, core_bentley_1.assert)(HierarchyNode_1.HierarchyNode.isCustom(parentNode) || HierarchyNode_1.HierarchyNode.isInstancesNode(parentNode));
+            groupingNode.nonGroupingAncestor = parentNode;
+        });
+        return mergeInPlace(result.grouped, result.ungrouped);
+    }));
+}
+function mergeInPlace(target, source) {
+    if (!target || target.length === 0) {
+        return source;
+    }
+    for (const item of source) {
+        target.push(item);
+    }
+    return target;
+}
+/** @internal */
+function createGroupingHandlers(imodelAccess, parentNode, processedInstanceNodes, valueFormatter, localizedStrings) {
+    const timer = new core_bentley_1.StopWatch();
+    const groupingLevel = getNodeGroupingLevel(parentNode);
+    return (0, rxjs_1.concat)(groupingLevel <= GroupingLevel.Class
+        ? (0, rxjs_1.concat)((0, rxjs_1.from)((0, BaseClassGrouping_1.createBaseClassGroupingHandlers)(imodelAccess, parentNode, processedInstanceNodes)).pipe((0, rxjs_1.concatAll)()), (0, rxjs_1.of)(async (allNodes) => (0, ClassGrouping_1.createClassGroups)(imodelAccess, parentNode, allNodes)))
+        : rxjs_1.EMPTY, groupingLevel <= GroupingLevel.Property
+        ? (0, rxjs_1.from)((0, PropertiesGrouping_1.createPropertiesGroupingHandlers)(imodelAccess, parentNode, processedInstanceNodes, valueFormatter, localizedStrings)).pipe((0, rxjs_1.concatAll)())
+        : rxjs_1.EMPTY, groupingLevel < GroupingLevel.Label ? (0, rxjs_1.of)(async (allNodes) => (0, LabelGrouping_1.createLabelGroups)(allNodes)) : rxjs_1.EMPTY).pipe((0, rxjs_1.tap)({
+        subscribe: () => {
+            (0, LoggingUtils_1.doLog)({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Start creating grouping handlers`,
+            });
+            timer.start();
+        },
+    }), (0, rxjs_1.finalize)(() => {
+        (0, LoggingUtils_1.doLog)({
+            category: PERF_LOGGING_NAMESPACE,
+            message: /* istanbul ignore next */ () => `Creating grouping handlers took ${timer.elapsedSeconds.toFixed(3)} s`,
+        });
+    }));
+}
+exports.createGroupingHandlers = createGroupingHandlers;
+function getNodeGroupingLevel(node) {
+    if (node && HierarchyNode_1.HierarchyNode.isClassGroupingNode(node)) {
+        return GroupingLevel.Class;
+    }
+    if (node && HierarchyNode_1.HierarchyNode.isPropertyGroupingNode(node)) {
+        return GroupingLevel.Property;
+    }
+    if (node && HierarchyNode_1.HierarchyNode.isLabelGroupingNode(node)) {
+        return GroupingLevel.Label;
+    }
+    return GroupingLevel.None;
+}
+var GroupingLevel;
+(function (GroupingLevel) {
+    GroupingLevel[GroupingLevel["None"] = 0] = "None";
+    GroupingLevel[GroupingLevel["Class"] = 2] = "Class";
+    GroupingLevel[GroupingLevel["Property"] = 3] = "Property";
+    GroupingLevel[GroupingLevel["Label"] = 4] = "Label";
+})(GroupingLevel || (GroupingLevel = {}));
+//# sourceMappingURL=Grouping.js.map