@itwin/presentation-hierarchies 0.1.0

package/lib/esm/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/esm/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/esm/hierarchies/internal/LoggingUtils.js

@@ -0,0 +1,50 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { tap } from "rxjs";
+import { trimWhitespace } from "@itwin/presentation-shared";
+import { getLogger } from "../Logging";
+/** @internal */
+export function doLog(props) {
+    const logger = getLogger();
+    const severity = props.severity ?? "trace";
+    if (!logger.isEnabled(props.category, severity)) {
+        return;
+    }
+    const logFunc = getLogFunc(logger, severity);
+    logFunc(props.category, props.message());
+}
+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 */
+export function log(props) {
+    return tap((n) => doLog({ ...props, message: () => props.message(n) }));
+}
+/** @internal */
+// istanbul ignore next
+export function createQueryLogMessage(query) {
+    const ctes = query.ctes?.map((cte) => `    ${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: ${trimWhitespace(query.ecsql)}, \n`;
+    if (bindings) {
+        output += `  bindings: [${bindings}], \n`;
+    }
+    output += "}";
+    return output;
+}
+//# sourceMappingURL=LoggingUtils.js.map

package/lib/esm/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,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,EAAoC,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AASvC,gBAAgB;AAChB,MAAM,UAAU,KAAK,CAAC,KAAsB;IAC1C,MAAM,MAAM,GAAG,SAAS,EAAE,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;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,MAAM,UAAU,GAAG,CAAc,KAAmC;IAClE,OAAO,GAAG,CAAc,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;AAED,gBAAgB;AAChB,uBAAuB;AACvB,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,cAAc,CAAC,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,cAAc,CAAC,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","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/esm/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/esm/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/esm/hierarchies/internal/SubscriptionScheduler.js

@@ -0,0 +1,53 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { asapScheduler, connectable, defer, EMPTY, finalize, iif, mergeMap, observeOn, onErrorResumeNextWith, queueScheduler, Subject, subscribeOn, tap, } from "rxjs";
+/** @internal */
+export class SubscriptionScheduler {
+    _scheduler = new Subject();
+    constructor(concurrency) {
+        this._scheduler
+            .pipe(mergeMap((sourceObservable) => {
+            return sourceObservable.pipe(
+            // connect source observable when scheduler subscribes
+            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.
+            observeOn(queueScheduler), 
+            // Delay the connection until another event loop task
+            subscribeOn(asapScheduler), 
+            // Ignore errors in this pipeline without suppressing them for other subscribers
+            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 defer(() => {
+            let unsubscribed = false;
+            const connectableObservable = connectable(iif(() => unsubscribed, EMPTY, source), {
+                connector: () => new Subject(),
+                resetOnDisconnect: false,
+            });
+            this._scheduler.next(connectableObservable);
+            return connectableObservable.pipe(finalize(() => {
+                unsubscribed = true;
+            }));
+        });
+    }
+}
+//# sourceMappingURL=SubscriptionScheduler.js.map

package/lib/esm/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,OAAO,EACL,aAAa,EAEb,WAAW,EACX,KAAK,EACL,KAAK,EACL,QAAQ,EACR,GAAG,EACH,QAAQ,EAER,SAAS,EACT,qBAAqB,EACrB,cAAc,EACd,OAAO,EACP,WAAW,EACX,GAAG,GACJ,MAAM,MAAM,CAAC;AAEd,gBAAgB;AAChB,MAAM,OAAO,qBAAqB;IACxB,UAAU,GAAG,IAAI,OAAO,EAAwB,CAAC;IACzD,YAAY,WAAmB;QAC7B,IAAI,CAAC,UAAU;aACZ,IAAI,CACH,QAAQ,CAAC,CAAC,gBAAgB,EAAE,EAAE;YAC5B,OAAO,gBAAgB,CAAC,IAAI;YAC1B,sDAAsD;YACtD,GAAG,CAAC;gBACF,SAAS,EAAE,GAAG,EAAE;oBACd,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC7B,CAAC;aACF,CAAC;YACF,0GAA0G;YAC1G,4EAA4E;YAC5E,SAAS,CAAC,cAAc,CAAC;YACzB,qDAAqD;YACrD,WAAW,CAAC,aAAa,CAAC;YAC1B,gFAAgF;YAChF,qBAAqB,EAAE,CACxB,CAAC;QACJ,CAAC,EAAE,WAAW,CAAC,CAChB;YACD,wCAAwC;aACvC,SAAS,EAAE,CAAC;IACjB,CAAC;IACD;;;;;;;;OAQG;IACI,oBAAoB,CAAI,MAAqB;QAClD,OAAO,KAAK,CAAC,GAAG,EAAE;YAChB,IAAI,YAAY,GAAG,KAAK,CAAC;YACzB,MAAM,qBAAqB,GAAG,WAAW,CACvC,GAAG,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,EACtC;gBACE,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,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,QAAQ,CAAC,GAAG,EAAE;gBACZ,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF","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/esm/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/esm/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/esm/hierarchies/internal/TreeNodesReader.js

@@ -0,0 +1,41 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { from, map } from "rxjs";
+import { parseInstanceLabel } from "@itwin/presentation-shared";
+import { NodeSelectClauseColumnNames } from "../NodeSelectQueryFactory";
+/** @internal */
+export function readNodes(props) {
+    const { queryExecutor, query, limit } = props;
+    const parser = props?.parser ?? defaultNodesParser;
+    const config = {
+        rowFormat: "ECSqlPropertyNames",
+        ...(limit !== undefined ? { limit } : undefined),
+    };
+    return from(queryExecutor.createQueryReader(query, config)).pipe(map(parser));
+}
+/* eslint-enable @typescript-eslint/naming-convention */
+/** @internal */
+export 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: 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),
+    };
+}
+//# sourceMappingURL=TreeNodesReader.js.map

package/lib/esm/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,OAAO,EAAE,IAAI,EAAE,GAAG,EAAc,MAAM,MAAM,CAAC;AAE7C,OAAO,EAAiB,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAI/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AASxE,gBAAgB;AAChB,MAAM,UAAU,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,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAChF,CAAC;AAmBD,wDAAwD;AAExD,gBAAgB;AAChB,MAAM,UAAU,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,kBAAkB,CAAC,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","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/esm/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/esm/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/esm/hierarchies/internal/operators/DetermineChildren.js

@@ -0,0 +1,30 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { concatMap, map, of } from "rxjs";
+import { createNodeIdentifierForLogging, createOperatorLoggingNamespace } from "../Common";
+import { log } from "../LoggingUtils";
+import { releaseMainThreadOnItemsCount } from "./ReleaseMainThread";
+const OPERATOR_NAME = "DetermineChildren";
+/** @internal */
+export const LOGGING_NAMESPACE = createOperatorLoggingNamespace(OPERATOR_NAME);
+/**
+ * Ensures all input nodes have their children determined.
+ *
+ * @internal
+ */
+export function createDetermineChildrenOperator(hasNodes) {
+    return function (nodes) {
+        return nodes.pipe(log({ category: LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `in: ${createNodeIdentifierForLogging(n)}` }), releaseMainThreadOnItemsCount(200), concatMap((n) => {
+            if (n.children !== undefined) {
+                return of(n);
+            }
+            return hasNodes(n).pipe(log({
+                category: LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ (hasChildrenFlag) => `${createNodeIdentifierForLogging(n)}: determined children: ${hasChildrenFlag}`,
+            }), map((hasChildrenFlag) => Object.assign(n, { children: hasChildrenFlag })));
+        }), log({ category: LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `out: ${createNodeIdentifierForLogging(n)}` }));
+    };
+}
+//# sourceMappingURL=DetermineChildren.js.map

package/lib/esm/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,OAAO,EAAE,SAAS,EAAE,GAAG,EAAc,EAAE,EAAE,MAAM,MAAM,CAAC;AAEtD,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAC1C,gBAAgB;AAChB,MAAM,CAAC,MAAM,iBAAiB,GAAG,8BAA8B,CAAC,aAAa,CAAC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,QAA+D;IAC7G,OAAO,UAAU,KAAyC;QACxD,OAAO,KAAK,CAAC,IAAI,CACf,GAAG,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAC3H,6BAA6B,CAAC,GAAG,CAAC,EAClC,SAAS,CAAC,CAAC,CAAyB,EAAsC,EAAE;YAC1E,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACf,CAAC;YACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACrB,GAAG,CAAC;gBACF,QAAQ,EAAE,iBAAiB;gBAC3B,OAAO,EAAE,0BAA0B,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,0BAA0B,eAAe,EAAE;aACzI,CAAC,EACF,GAAG,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC,CAC1E,CAAC;QACJ,CAAC,CAAC,EACF,GAAG,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,8BAA8B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAC7H,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { 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/esm/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/esm/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/esm/hierarchies/internal/operators/Grouping.js

@@ -0,0 +1,156 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { concat, concatAll, delay, EMPTY, expand, finalize, from, last, map, merge, mergeMap, of, reduce, tap, toArray } from "rxjs";
+import { assert, StopWatch } from "@itwin/core-bentley";
+import { HierarchyNode, } from "../../HierarchyNode";
+import { createNodeIdentifierForLogging, createOperatorLoggingNamespace } from "../Common";
+import { doLog, log } from "../LoggingUtils";
+import { assignAutoExpand } from "./grouping/AutoExpand";
+import { createBaseClassGroupingHandlers } from "./grouping/BaseClassGrouping";
+import { createClassGroups } from "./grouping/ClassGrouping";
+import { applyGroupHidingParams } from "./grouping/GroupHiding";
+import { createLabelGroups } from "./grouping/LabelGrouping";
+import { createPropertiesGroupingHandlers } from "./grouping/PropertiesGrouping";
+import { releaseMainThreadOnItemsCount } from "./ReleaseMainThread";
+import { tapOnce } from "./TapOnce";
+const OPERATOR_NAME = "Grouping";
+/** @internal */
+export const LOGGING_NAMESPACE = createOperatorLoggingNamespace(OPERATOR_NAME);
+const PERF_LOGGING_NAMESPACE = `${LOGGING_NAMESPACE}.Performance`;
+/** @internal */
+export function createGroupingOperator(imodelAccess, parentNode, valueFormatter, localizedStrings, onGroupingNodeCreated, groupingHandlers) {
+    return function (nodes) {
+        return nodes.pipe(log({ category: LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `in: ${createNodeIdentifierForLogging(n)}` }), tapOnce(() => {
+            doLog({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Starting grouping (parent: ${createNodeIdentifierForLogging(parentNode)})`,
+            });
+        }), reduce((resolvedNodes, node) => {
+            if (HierarchyNode.isInstancesNode(node)) {
+                resolvedNodes.instanceNodes.push(node);
+            }
+            else {
+                resolvedNodes.restNodes.push(node);
+            }
+            return resolvedNodes;
+        }, { instanceNodes: [], restNodes: [] }), tap(({ instanceNodes, restNodes }) => {
+            doLog({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Nodes partitioned. Got ${instanceNodes.length} instance nodes and ${restNodes.length} rest nodes.`,
+            });
+        }), mergeMap((res) => {
+            const out = of(res);
+            const totalNodes = res.instanceNodes.length + res.restNodes.length;
+            // istanbul ignore next
+            return totalNodes <= 1000 ? out : out.pipe(delay(0));
+        }), mergeMap(({ instanceNodes, restNodes }) => {
+            const timer = new StopWatch(undefined, true);
+            const groupingHandlersObs = groupingHandlers
+                ? from(groupingHandlers)
+                : createGroupingHandlers(imodelAccess, parentNode, instanceNodes, valueFormatter, localizedStrings);
+            return merge(groupingHandlersObs.pipe(toArray(), mergeMap((createdGroupingHandlers) => groupInstanceNodes(instanceNodes, restNodes.length, createdGroupingHandlers, parentNode, onGroupingNodeCreated)), finalize(() => {
+                doLog({
+                    category: PERF_LOGGING_NAMESPACE,
+                    message: /* istanbul ignore next */ () => `Grouping ${instanceNodes.length} nodes took ${timer.elapsedSeconds.toFixed(3)} s`,
+                });
+            })), from(restNodes));
+        }), releaseMainThreadOnItemsCount(500), log({ category: LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `out: ${createNodeIdentifierForLogging(n)}` }));
+    };
+}
+function groupInstanceNodes(nodes, extraSiblings, groupingHandlers, parentNode, onGroupingNodeCreated) {
+    if (groupingHandlers.length === 0) {
+        return from(nodes);
+    }
+    return of({ handlerIndex: 0 }).pipe(expand(({ handlerIndex, result: curr }) => {
+        if (handlerIndex >= groupingHandlers.length) {
+            return EMPTY;
+        }
+        const timer = new StopWatch(undefined, true);
+        const currentHandler = groupingHandlers[handlerIndex];
+        return from(currentHandler(curr?.ungrouped ?? nodes, curr?.grouped ?? [])).pipe(log({
+            category: PERF_LOGGING_NAMESPACE,
+            message: /* istanbul ignore next */ () => `Grouping handler ${handlerIndex} exclusively took ${timer.elapsedSeconds.toFixed(3)} s.`,
+        }), mergeMap((result) => {
+            if (result.grouped.length === 0) {
+                return of({ handlerIndex: handlerIndex + 1, result: { ...result, grouped: curr?.grouped ?? [] } });
+            }
+            const groupingPostProcessingTimer = new StopWatch(undefined, true);
+            return of(result).pipe(map((r) => applyGroupHidingParams(r, extraSiblings)), map((r) => assignAutoExpand(r)), map((r) => ({ handlerIndex: handlerIndex + 1, result: { ...r, grouped: mergeInPlace(curr?.grouped, r.grouped) } })), log({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Post-processing grouping handler ${handlerIndex} exclusively took ${groupingPostProcessingTimer.elapsedSeconds.toFixed(3)} s.`,
+            }), delay(0));
+        }), log({
+            category: PERF_LOGGING_NAMESPACE,
+            message: /* istanbul ignore next */ () => `Total time for grouping handler ${handlerIndex}: ${timer.elapsedSeconds.toFixed(3)} s.`,
+        }));
+    }), last(), mergeMap(({ result }) => {
+        result.grouped.forEach((groupingNode) => {
+            onGroupingNodeCreated?.(groupingNode);
+            if (!parentNode) {
+                return;
+            }
+            if (HierarchyNode.isGroupingNode(parentNode)) {
+                groupingNode.nonGroupingAncestor = parentNode.nonGroupingAncestor;
+                return;
+            }
+            // not sure why type checker doesn't pick this up
+            assert(HierarchyNode.isCustom(parentNode) || 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 */
+export function createGroupingHandlers(imodelAccess, parentNode, processedInstanceNodes, valueFormatter, localizedStrings) {
+    const timer = new StopWatch();
+    const groupingLevel = getNodeGroupingLevel(parentNode);
+    return concat(groupingLevel <= GroupingLevel.Class
+        ? concat(from(createBaseClassGroupingHandlers(imodelAccess, parentNode, processedInstanceNodes)).pipe(concatAll()), of(async (allNodes) => createClassGroups(imodelAccess, parentNode, allNodes)))
+        : EMPTY, groupingLevel <= GroupingLevel.Property
+        ? from(createPropertiesGroupingHandlers(imodelAccess, parentNode, processedInstanceNodes, valueFormatter, localizedStrings)).pipe(concatAll())
+        : EMPTY, groupingLevel < GroupingLevel.Label ? of(async (allNodes) => createLabelGroups(allNodes)) : EMPTY).pipe(tap({
+        subscribe: () => {
+            doLog({
+                category: PERF_LOGGING_NAMESPACE,
+                message: /* istanbul ignore next */ () => `Start creating grouping handlers`,
+            });
+            timer.start();
+        },
+    }), finalize(() => {
+        doLog({
+            category: PERF_LOGGING_NAMESPACE,
+            message: /* istanbul ignore next */ () => `Creating grouping handlers took ${timer.elapsedSeconds.toFixed(3)} s`,
+        });
+    }));
+}
+function getNodeGroupingLevel(node) {
+    if (node && HierarchyNode.isClassGroupingNode(node)) {
+        return GroupingLevel.Class;
+    }
+    if (node && HierarchyNode.isPropertyGroupingNode(node)) {
+        return GroupingLevel.Property;
+    }
+    if (node && 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

package/lib/esm/hierarchies/internal/operators/Grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grouping.js","sourceRoot":"","sources":["../../../../../src/hierarchies/internal/operators/Grouping.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 { concat, concatAll, delay, EMPTY, expand, finalize, from, last, map, merge, mergeMap, Observable, of, reduce, tap, toArray } from \"rxjs\";\nimport { assert, StopWatch } from \"@itwin/core-bentley\";\nimport { ECClassHierarchyInspector, ECSchemaProvider, IPrimitiveValueFormatter } from \"@itwin/presentation-shared\";\nimport {\n  HierarchyNode,\n  ParentHierarchyNode,\n  ProcessedGroupingHierarchyNode,\n  ProcessedHierarchyNode,\n  ProcessedInstanceHierarchyNode,\n} from \"../../HierarchyNode\";\nimport { createNodeIdentifierForLogging, createOperatorLoggingNamespace } from \"../Common\";\nimport { doLog, log } from \"../LoggingUtils\";\nimport { assignAutoExpand } from \"./grouping/AutoExpand\";\nimport { createBaseClassGroupingHandlers } from \"./grouping/BaseClassGrouping\";\nimport { createClassGroups } from \"./grouping/ClassGrouping\";\nimport { applyGroupHidingParams } from \"./grouping/GroupHiding\";\nimport { createLabelGroups } from \"./grouping/LabelGrouping\";\nimport { createPropertiesGroupingHandlers, PropertiesGroupingLocalizedStrings } from \"./grouping/PropertiesGrouping\";\nimport { releaseMainThreadOnItemsCount } from \"./ReleaseMainThread\";\nimport { tapOnce } from \"./TapOnce\";\n\nconst OPERATOR_NAME = \"Grouping\";\n/** @internal */\nexport const LOGGING_NAMESPACE = createOperatorLoggingNamespace(OPERATOR_NAME);\nconst PERF_LOGGING_NAMESPACE = `${LOGGING_NAMESPACE}.Performance`;\n\n/** @internal */\nexport function createGroupingOperator(\n  imodelAccess: ECSchemaProvider & ECClassHierarchyInspector,\n  parentNode: ParentHierarchyNode | undefined,\n  valueFormatter: IPrimitiveValueFormatter,\n  localizedStrings: PropertiesGroupingLocalizedStrings,\n  onGroupingNodeCreated?: (groupingNode: ProcessedGroupingHierarchyNode) => void,\n  groupingHandlers?: GroupingHandler[],\n) {\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      tapOnce(() => {\n        doLog({\n          category: PERF_LOGGING_NAMESPACE,\n          message: /* istanbul ignore next */ () => `Starting grouping (parent: ${createNodeIdentifierForLogging(parentNode)})`,\n        });\n      }),\n      reduce<ProcessedHierarchyNode, { instanceNodes: ProcessedInstanceHierarchyNode[]; restNodes: ProcessedHierarchyNode[] }>(\n        (resolvedNodes, node) => {\n          if (HierarchyNode.isInstancesNode(node)) {\n            resolvedNodes.instanceNodes.push(node);\n          } else {\n            resolvedNodes.restNodes.push(node);\n          }\n          return resolvedNodes;\n        },\n        { instanceNodes: [], restNodes: [] },\n      ),\n      tap(({ instanceNodes, restNodes }) => {\n        doLog({\n          category: PERF_LOGGING_NAMESPACE,\n          message: /* istanbul ignore next */ () => `Nodes partitioned. Got ${instanceNodes.length} instance nodes and ${restNodes.length} rest nodes.`,\n        });\n      }),\n      mergeMap((res) => {\n        const out = of(res);\n        const totalNodes = res.instanceNodes.length + res.restNodes.length;\n        // istanbul ignore next\n        return totalNodes <= 1000 ? out : out.pipe(delay(0));\n      }),\n      mergeMap(({ instanceNodes, restNodes }): Observable<ProcessedHierarchyNode> => {\n        const timer = new StopWatch(undefined, true);\n        const groupingHandlersObs: Observable<GroupingHandler> = groupingHandlers\n          ? from(groupingHandlers)\n          : createGroupingHandlers(imodelAccess, parentNode, instanceNodes, valueFormatter, localizedStrings);\n        return merge(\n          groupingHandlersObs.pipe(\n            toArray(),\n            mergeMap((createdGroupingHandlers) =>\n              groupInstanceNodes(instanceNodes, restNodes.length, createdGroupingHandlers, parentNode, onGroupingNodeCreated),\n            ),\n            finalize(() => {\n              doLog({\n                category: PERF_LOGGING_NAMESPACE,\n                message: /* istanbul ignore next */ () => `Grouping ${instanceNodes.length} nodes took ${timer.elapsedSeconds.toFixed(3)} s`,\n              });\n            }),\n          ),\n          from(restNodes),\n        );\n      }),\n      releaseMainThreadOnItemsCount(500),\n      log({ category: LOGGING_NAMESPACE, message: /* istanbul ignore next */ (n) => `out: ${createNodeIdentifierForLogging(n)}` }),\n    );\n  };\n}\n\n/** @internal */\nexport type ProcessedInstancesGroupingHierarchyNode = Omit<ProcessedGroupingHierarchyNode, \"children\"> & { children: ProcessedInstanceHierarchyNode[] };\n\n/** @internal */\nexport interface GroupingHandlerResult {\n  /** Expected to be sorted by label. */\n  grouped: Array<ProcessedInstancesGroupingHierarchyNode>;\n  /** Expected to be sorted by label. */\n  ungrouped: ProcessedInstanceHierarchyNode[];\n  groupingType: GroupingType;\n}\n\n/** @internal */\nexport type GroupingType = \"label\" | \"class\" | \"base-class\" | \"property\";\n\n/** @internal */\nexport type GroupingHandler = (\n  nodesToGroup: ProcessedInstanceHierarchyNode[],\n  nodesAlreadyGrouped: ProcessedInstancesGroupingHierarchyNode[],\n) => Promise<GroupingHandlerResult>;\n\nfunction groupInstanceNodes(\n  nodes: ProcessedInstanceHierarchyNode[],\n  extraSiblings: number,\n  groupingHandlers: GroupingHandler[],\n  parentNode: ParentHierarchyNode | undefined,\n  onGroupingNodeCreated?: (groupingNode: ProcessedGroupingHierarchyNode) => void,\n): Observable<ProcessedGroupingHierarchyNode | ProcessedInstanceHierarchyNode> {\n  if (groupingHandlers.length === 0) {\n    return from(nodes);\n  }\n  return of<{ handlerIndex: number; result?: GroupingHandlerResult | undefined }>({ handlerIndex: 0 }).pipe(\n    expand(({ handlerIndex, result: curr }) => {\n      if (handlerIndex >= groupingHandlers.length) {\n        return EMPTY;\n      }\n      const timer = new StopWatch(undefined, true);\n      const currentHandler = groupingHandlers[handlerIndex];\n      return from(currentHandler(curr?.ungrouped ?? nodes, curr?.grouped ?? [])).pipe(\n        log({\n          category: PERF_LOGGING_NAMESPACE,\n          message: /* istanbul ignore next */ () => `Grouping handler ${handlerIndex} exclusively took ${timer.elapsedSeconds.toFixed(3)} s.`,\n        }),\n        mergeMap((result) => {\n          if (result.grouped.length === 0) {\n            return of({ handlerIndex: handlerIndex + 1, result: { ...result, grouped: curr?.grouped ?? [] } });\n          }\n          const groupingPostProcessingTimer = new StopWatch(undefined, true);\n          return of(result).pipe(\n            map((r) => applyGroupHidingParams(r, extraSiblings)),\n            map((r) => assignAutoExpand(r)),\n            map((r) => ({ handlerIndex: handlerIndex + 1, result: { ...r, grouped: mergeInPlace(curr?.grouped, r.grouped) } })),\n            log({\n              category: PERF_LOGGING_NAMESPACE,\n              message: /* istanbul ignore next */ () =>\n                `Post-processing grouping handler ${handlerIndex} exclusively took ${groupingPostProcessingTimer.elapsedSeconds.toFixed(3)} s.`,\n            }),\n            delay(0),\n          );\n        }),\n        log({\n          category: PERF_LOGGING_NAMESPACE,\n          message: /* istanbul ignore next */ () => `Total time for grouping handler ${handlerIndex}: ${timer.elapsedSeconds.toFixed(3)} s.`,\n        }),\n      );\n    }),\n    last(),\n    mergeMap(({ result }) => {\n      result.grouped.forEach((groupingNode) => {\n        onGroupingNodeCreated?.(groupingNode);\n        if (!parentNode) {\n          return;\n        }\n        if (HierarchyNode.isGroupingNode(parentNode)) {\n          groupingNode.nonGroupingAncestor = parentNode.nonGroupingAncestor;\n          return;\n        }\n        // not sure why type checker doesn't pick this up\n        assert(HierarchyNode.isCustom(parentNode) || HierarchyNode.isInstancesNode(parentNode));\n        groupingNode.nonGroupingAncestor = parentNode;\n      });\n      return mergeInPlace<ProcessedGroupingHierarchyNode | ProcessedInstanceHierarchyNode>(result.grouped, result.ungrouped);\n    }),\n  );\n}\n\nfunction mergeInPlace<T>(target: T[] | undefined, source: T[]) {\n  if (!target || target.length === 0) {\n    return source;\n  }\n  for (const item of source) {\n    target.push(item);\n  }\n  return target;\n}\n\n/** @internal */\nexport function createGroupingHandlers(\n  imodelAccess: ECSchemaProvider & ECClassHierarchyInspector,\n  parentNode: ParentHierarchyNode | undefined,\n  processedInstanceNodes: ProcessedInstanceHierarchyNode[],\n  valueFormatter: IPrimitiveValueFormatter,\n  localizedStrings: PropertiesGroupingLocalizedStrings,\n): Observable<GroupingHandler> {\n  const timer = new StopWatch();\n  const groupingLevel = getNodeGroupingLevel(parentNode);\n  return concat(\n    groupingLevel <= GroupingLevel.Class\n      ? concat(\n          from(createBaseClassGroupingHandlers(imodelAccess, parentNode, processedInstanceNodes)).pipe(concatAll()),\n          of<GroupingHandler>(async (allNodes) => createClassGroups(imodelAccess, parentNode, allNodes)),\n        )\n      : EMPTY,\n    groupingLevel <= GroupingLevel.Property\n      ? from(createPropertiesGroupingHandlers(imodelAccess, parentNode, processedInstanceNodes, valueFormatter, localizedStrings)).pipe(concatAll())\n      : EMPTY,\n    groupingLevel < GroupingLevel.Label ? of<GroupingHandler>(async (allNodes) => createLabelGroups(allNodes)) : EMPTY,\n  ).pipe(\n    tap({\n      subscribe: () => {\n        doLog({\n          category: PERF_LOGGING_NAMESPACE,\n          message: /* istanbul ignore next */ () => `Start creating grouping handlers`,\n        });\n        timer.start();\n      },\n    }),\n    finalize(() => {\n      doLog({\n        category: PERF_LOGGING_NAMESPACE,\n        message: /* istanbul ignore next */ () => `Creating grouping handlers took ${timer.elapsedSeconds.toFixed(3)} s`,\n      });\n    }),\n  );\n}\n\nfunction getNodeGroupingLevel(node: ParentHierarchyNode | undefined): GroupingLevel {\n  if (node && HierarchyNode.isClassGroupingNode(node)) {\n    return GroupingLevel.Class;\n  }\n  if (node && HierarchyNode.isPropertyGroupingNode(node)) {\n    return GroupingLevel.Property;\n  }\n  if (node && HierarchyNode.isLabelGroupingNode(node)) {\n    return GroupingLevel.Label;\n  }\n  return GroupingLevel.None;\n}\n\nenum GroupingLevel {\n  None = 0,\n  Class = 2,\n  Property = 3,\n  Label = 4,\n}\n"]}

package/lib/esm/hierarchies/internal/operators/HideIfNoChildren.d.ts

@@ -0,0 +1,11 @@
+import { Observable } from "rxjs";
+import { ProcessedHierarchyNode } from "../../HierarchyNode";
+/** @internal */
+export declare const LOGGING_NAMESPACE: string;
+/**
+ * Creates an operator that hides nodes with no children if they have a `hideIfNoChildren` handling param.
+ *
+ * @internal
+ */
+export declare function createHideIfNoChildrenOperator(hasNodes: (node: ProcessedHierarchyNode) => Observable<boolean>): (nodes: Observable<ProcessedHierarchyNode>) => Observable<ProcessedHierarchyNode>;
+//# sourceMappingURL=HideIfNoChildren.d.ts.map

package/lib/esm/hierarchies/internal/operators/HideIfNoChildren.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HideIfNoChildren.d.ts","sourceRoot":"","sources":["../../../../../src/hierarchies/internal/operators/HideIfNoChildren.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuC,UAAU,EAAE,MAAM,MAAM,CAAC;AACvE,OAAO,EAA+C,sBAAsB,EAAkC,MAAM,qBAAqB,CAAC;AAM1I,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,QAAgD,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,UAAU,CAAC,OAAO,CAAC,WACpF,WAAW,sBAAsB,CAAC,KAAG,WAAW,sBAAsB,CAAC,CAoDhG"}