@itwin/presentation-hierarchies 0.3.0 → 0.5.0

package/lib/esm/hierarchies/LimitingECSqlQueryExecutor.js

@@ -2,10 +2,10 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
-import { StopWatch } from "@itwin/core-bentley";
-import { createMainThreadReleaseOnTimePassedHandler, } from "@itwin/presentation-shared";
+import { Guid, StopWatch } from "@itwin/core-bentley";
+import { createMainThreadReleaseOnTimePassedHandler, trimWhitespace, } from "@itwin/presentation-shared";
 import { RowsLimitExceededError } from "./HierarchyErrors";
-import { LOGGING_NAMESPACE as CommonLoggingNamespace } from "./internal/Common";
+import { LOGGING_NAMESPACE as BASE_LOGGING_NAMESPACE, LOGGING_NAMESPACE_PERFORMANCE as BASE_LOGGING_NAMESPACE_PERFORMANCE } from "./internal/Common";
 import { doLog } from "./internal/LoggingUtils";
 /**
  * Creates an `LimitingECSqlQueryExecutor` that throws `RowsLimitExceededError` if the query exceeds given amount of rows.
@@ -16,7 +16,7 @@ export function createLimitingECSqlQueryExecutor(baseExecutor, defaultLimit) {
         async *createQueryReader(query, config) {
             const { limit: configLimit, ...restConfig } = config ?? {};
             const limit = configLimit ?? defaultLimit;
-            const perfLogger = createQueryPerformanceLogger();
+            const queryLogger = createQueryLogger(query);
             const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();
             // handle "unbounded" case without a buffer
             const reader = baseExecutor.createQueryReader({ ...query, ecsql: addLimit(query.ecsql, limit) }, restConfig);
@@ -24,12 +24,12 @@ export function createLimitingECSqlQueryExecutor(baseExecutor, defaultLimit) {
                 try {
                     for await (const row of reader) {
                         await releaseMainThread();
-                        perfLogger.onStep();
+                        queryLogger.onStep();
                         yield row;
                     }
                 }
                 finally {
-                    perfLogger.onComplete();
+                    queryLogger.onComplete();
                 }
                 return;
             }
@@ -38,7 +38,7 @@ export function createLimitingECSqlQueryExecutor(baseExecutor, defaultLimit) {
             try {
                 for await (const row of reader) {
                     await releaseMainThread();
-                    perfLogger.onStep();
+                    queryLogger.onStep();
                     buffer.push(row);
                     if (buffer.length > limit) {
                         throw new RowsLimitExceededError(limit);
@@ -46,7 +46,7 @@ export function createLimitingECSqlQueryExecutor(baseExecutor, defaultLimit) {
                 }
             }
             finally {
-                perfLogger.onComplete();
+                queryLogger.onComplete();
             }
             for (const row of buffer) {
                 await releaseMainThread();
@@ -65,8 +65,14 @@ function addLimit(ecsql, limit) {
     LIMIT ${limit + 1}
   `;
 }
-const LOGGING_NAMESPACE = `${CommonLoggingNamespace}.QueryPerformance`;
-function createQueryPerformanceLogger(firstStepWarningThreshold = 3000, allRowsWarningThreshold = 5000) {
+const LOGGING_NAMESPACE = `${BASE_LOGGING_NAMESPACE}.Queries`;
+const LOGGING_NAMESPACE_PERFORMANCE = `${BASE_LOGGING_NAMESPACE_PERFORMANCE}.Queries`;
+function createQueryLogger(query, firstStepWarningThreshold = 3000, allRowsWarningThreshold = 5000) {
+    const queryId = Guid.createValue();
+    doLog({
+        category: LOGGING_NAMESPACE,
+        message: /* istanbul ignore next */ () => `Executing query [${queryId}]: ${createQueryLogMessage(query)}`,
+    });
     let firstStep = true;
     let rowsCount = 0;
     const timer = new StopWatch(undefined, true);
@@ -75,9 +81,9 @@ function createQueryPerformanceLogger(firstStepWarningThreshold = 3000, allRowsW
             if (firstStep) {
                 // istanbul ignore next
                 doLog({
-                    category: LOGGING_NAMESPACE,
+                    category: LOGGING_NAMESPACE_PERFORMANCE,
                     severity: timer.current.milliseconds >= firstStepWarningThreshold ? "warning" : "trace",
-                    message: () => `First step took ${timer.currentSeconds} s.`,
+                    message: () => `[${queryId}] First step took ${timer.currentSeconds} s.`,
                 });
                 firstStep = false;
             }
@@ -86,11 +92,26 @@ function createQueryPerformanceLogger(firstStepWarningThreshold = 3000, allRowsW
         onComplete() {
             // istanbul ignore next
             doLog({
-                category: LOGGING_NAMESPACE,
+                category: LOGGING_NAMESPACE_PERFORMANCE,
                 severity: timer.current.milliseconds >= allRowsWarningThreshold ? "warning" : "trace",
-                message: () => `Query took ${timer.currentSeconds} s. for ${rowsCount} rows.`,
+                message: () => `[${queryId}] Query took ${timer.currentSeconds} s. for ${rowsCount} rows.`,
             });
         },
     };
 }
+// istanbul ignore next
+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=LimitingECSqlQueryExecutor.js.map

package/lib/esm/hierarchies/LimitingECSqlQueryExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"LimitingECSqlQueryExecutor.js","sourceRoot":"","sources":["../../../src/hierarchies/LimitingECSqlQueryExecutor.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 { StopWatch } from \"@itwin/core-bentley\";\nimport {\n  createMainThreadReleaseOnTimePassedHandler,\n  ECSqlQueryDef,\n  ECSqlQueryExecutor,\n  ECSqlQueryReaderOptions,\n  ECSqlQueryRow,\n} from \"@itwin/presentation-shared\";\nimport { RowsLimitExceededError } from \"./HierarchyErrors\";\nimport { LOGGING_NAMESPACE as CommonLoggingNamespace } from \"./internal/Common\";\nimport { doLog } from \"./internal/LoggingUtils\";\n\n/**\n * An interface for something that knows how to create a limiting ECSQL query reader.\n * @beta\n */\nexport interface LimitingECSqlQueryExecutor {\n  /**\n   * Creates a query reader for given query, but makes sure it doesn't return more than the configured\n   * limit of rows.\n   * @throws `RowsLimitExceededError` when the query returns more than configured limit of rows.\n   */\n  createQueryReader(\n    query: ECSqlQueryDef,\n    config?: ECSqlQueryReaderOptions & { limit?: number | \"unbounded\" },\n  ): ReturnType<ECSqlQueryExecutor[\"createQueryReader\"]>;\n}\n\n/**\n * Creates an `LimitingECSqlQueryExecutor` that throws `RowsLimitExceededError` if the query exceeds given amount of rows.\n * @beta\n */\nexport function createLimitingECSqlQueryExecutor(baseExecutor: ECSqlQueryExecutor, defaultLimit: number | \"unbounded\"): LimitingECSqlQueryExecutor {\n  return {\n    async *createQueryReader(query: ECSqlQueryDef, config?: ECSqlQueryReaderOptions & { limit?: number | \"unbounded\" }) {\n      const { limit: configLimit, ...restConfig } = config ?? {};\n      const limit = configLimit ?? defaultLimit;\n      const perfLogger = createQueryPerformanceLogger();\n      const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();\n\n      // handle \"unbounded\" case without a buffer\n      const reader = baseExecutor.createQueryReader({ ...query, ecsql: addLimit(query.ecsql, limit) }, restConfig);\n      if (limit === \"unbounded\") {\n        try {\n          for await (const row of reader) {\n            await releaseMainThread();\n            perfLogger.onStep();\n            yield row;\n          }\n        } finally {\n          perfLogger.onComplete();\n        }\n        return;\n      }\n\n      // avoid streaming until we know the number of rows is okay\n      const buffer: ECSqlQueryRow[] = [];\n      try {\n        for await (const row of reader) {\n          await releaseMainThread();\n          perfLogger.onStep();\n          buffer.push(row);\n          if (buffer.length > limit) {\n            throw new RowsLimitExceededError(limit);\n          }\n        }\n      } finally {\n        perfLogger.onComplete();\n      }\n\n      for (const row of buffer) {\n        await releaseMainThread();\n        yield row;\n      }\n    },\n  };\n}\n\nfunction addLimit(ecsql: string, limit: number | \"unbounded\") {\n  if (limit === \"unbounded\") {\n    return ecsql;\n  }\n  return `\n    SELECT *\n    FROM (${ecsql})\n    LIMIT ${limit + 1}\n  `;\n}\n\nconst LOGGING_NAMESPACE = `${CommonLoggingNamespace}.QueryPerformance`;\nfunction createQueryPerformanceLogger(firstStepWarningThreshold = 3000, allRowsWarningThreshold = 5000) {\n  let firstStep = true;\n  let rowsCount = 0;\n  const timer = new StopWatch(undefined, true);\n  return {\n    onStep() {\n      if (firstStep) {\n        // istanbul ignore next\n        doLog({\n          category: LOGGING_NAMESPACE,\n          severity: timer.current.milliseconds >= firstStepWarningThreshold ? \"warning\" : \"trace\",\n          message: () => `First step took ${timer.currentSeconds} s.`,\n        });\n        firstStep = false;\n      }\n      ++rowsCount;\n    },\n    onComplete() {\n      // istanbul ignore next\n      doLog({\n        category: LOGGING_NAMESPACE,\n        severity: timer.current.milliseconds >= allRowsWarningThreshold ? \"warning\" : \"trace\",\n        message: () => `Query took ${timer.currentSeconds} s. for ${rowsCount} rows.`,\n      });\n    },\n  };\n}\n"]}
+{"version":3,"file":"LimitingECSqlQueryExecutor.js","sourceRoot":"","sources":["../../../src/hierarchies/LimitingECSqlQueryExecutor.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 { Guid, StopWatch } from \"@itwin/core-bentley\";\nimport {\n  createMainThreadReleaseOnTimePassedHandler,\n  ECSqlQueryDef,\n  ECSqlQueryExecutor,\n  ECSqlQueryReaderOptions,\n  ECSqlQueryRow,\n  trimWhitespace,\n} from \"@itwin/presentation-shared\";\nimport { RowsLimitExceededError } from \"./HierarchyErrors\";\nimport { LOGGING_NAMESPACE as BASE_LOGGING_NAMESPACE, LOGGING_NAMESPACE_PERFORMANCE as BASE_LOGGING_NAMESPACE_PERFORMANCE } from \"./internal/Common\";\nimport { doLog } from \"./internal/LoggingUtils\";\n\n/**\n * An interface for something that knows how to create a limiting ECSQL query reader.\n * @beta\n */\nexport interface LimitingECSqlQueryExecutor {\n  /**\n   * Creates a query reader for given query, but makes sure it doesn't return more than the configured\n   * limit of rows.\n   * @throws `RowsLimitExceededError` when the query returns more than configured limit of rows.\n   */\n  createQueryReader(\n    query: ECSqlQueryDef,\n    config?: ECSqlQueryReaderOptions & { limit?: number | \"unbounded\" },\n  ): ReturnType<ECSqlQueryExecutor[\"createQueryReader\"]>;\n}\n\n/**\n * Creates an `LimitingECSqlQueryExecutor` that throws `RowsLimitExceededError` if the query exceeds given amount of rows.\n * @beta\n */\nexport function createLimitingECSqlQueryExecutor(baseExecutor: ECSqlQueryExecutor, defaultLimit: number | \"unbounded\"): LimitingECSqlQueryExecutor {\n  return {\n    async *createQueryReader(query: ECSqlQueryDef, config?: ECSqlQueryReaderOptions & { limit?: number | \"unbounded\" }) {\n      const { limit: configLimit, ...restConfig } = config ?? {};\n      const limit = configLimit ?? defaultLimit;\n      const queryLogger = createQueryLogger(query);\n      const releaseMainThread = createMainThreadReleaseOnTimePassedHandler();\n\n      // handle \"unbounded\" case without a buffer\n      const reader = baseExecutor.createQueryReader({ ...query, ecsql: addLimit(query.ecsql, limit) }, restConfig);\n      if (limit === \"unbounded\") {\n        try {\n          for await (const row of reader) {\n            await releaseMainThread();\n            queryLogger.onStep();\n            yield row;\n          }\n        } finally {\n          queryLogger.onComplete();\n        }\n        return;\n      }\n\n      // avoid streaming until we know the number of rows is okay\n      const buffer: ECSqlQueryRow[] = [];\n      try {\n        for await (const row of reader) {\n          await releaseMainThread();\n          queryLogger.onStep();\n          buffer.push(row);\n          if (buffer.length > limit) {\n            throw new RowsLimitExceededError(limit);\n          }\n        }\n      } finally {\n        queryLogger.onComplete();\n      }\n\n      for (const row of buffer) {\n        await releaseMainThread();\n        yield row;\n      }\n    },\n  };\n}\n\nfunction addLimit(ecsql: string, limit: number | \"unbounded\") {\n  if (limit === \"unbounded\") {\n    return ecsql;\n  }\n  return `\n    SELECT *\n    FROM (${ecsql})\n    LIMIT ${limit + 1}\n  `;\n}\n\nconst LOGGING_NAMESPACE = `${BASE_LOGGING_NAMESPACE}.Queries`;\nconst LOGGING_NAMESPACE_PERFORMANCE = `${BASE_LOGGING_NAMESPACE_PERFORMANCE}.Queries`;\nfunction createQueryLogger(query: ECSqlQueryDef, firstStepWarningThreshold = 3000, allRowsWarningThreshold = 5000) {\n  const queryId = Guid.createValue();\n  doLog({\n    category: LOGGING_NAMESPACE,\n    message: /* istanbul ignore next */ () => `Executing query [${queryId}]: ${createQueryLogMessage(query)}`,\n  });\n\n  let firstStep = true;\n  let rowsCount = 0;\n  const timer = new StopWatch(undefined, true);\n  return {\n    onStep() {\n      if (firstStep) {\n        // istanbul ignore next\n        doLog({\n          category: LOGGING_NAMESPACE_PERFORMANCE,\n          severity: timer.current.milliseconds >= firstStepWarningThreshold ? \"warning\" : \"trace\",\n          message: () => `[${queryId}] First step took ${timer.currentSeconds} s.`,\n        });\n        firstStep = false;\n      }\n      ++rowsCount;\n    },\n    onComplete() {\n      // istanbul ignore next\n      doLog({\n        category: LOGGING_NAMESPACE_PERFORMANCE,\n        severity: timer.current.milliseconds >= allRowsWarningThreshold ? \"warning\" : \"trace\",\n        message: () => `[${queryId}] Query took ${timer.currentSeconds} s. for ${rowsCount} rows.`,\n      });\n    },\n  };\n}\n\n// istanbul ignore next\nfunction 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/NodeSelectQueryFactory.d.ts

@@ -1,6 +1,7 @@
 import { Id64String } from "@itwin/core-bentley";
 import { GenericInstanceFilter } from "@itwin/core-common";
 import { ECClassHierarchyInspector, ECSchemaProvider } from "@itwin/presentation-shared";
+import { HierarchyNodeAutoExpandProp } from "./HierarchyNode";
 /**
  * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns
  * created by the factory.
@@ -105,7 +106,7 @@ type ECSqlSelectClauseLabelGroupingParams = boolean | ECSqlValueSelector | ECSql
 interface ECSqlSelectClauseGroupingParamsBase {
     hideIfNoSiblings?: boolean | ECSqlValueSelector;
     hideIfOneGroupedNode?: boolean | ECSqlValueSelector;
-    autoExpand?: string | ECSqlValueSelector;
+    autoExpand?: HierarchyNodeAutoExpandProp | ECSqlValueSelector;
 }
 /**
  * A data structure for defining properties grouping.
@@ -193,7 +194,18 @@ interface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGrou
 export interface NodesQueryClauseFactory {
     /** Create a SELECT clause in a format understood by nodes query parser used by `HierarchyProvider`. */
     createSelectClause(props: NodeSelectClauseProps): Promise<string>;
-    /** Create FROM, JOIN and WHERE clauses whose combination results in an ECSQL filter defined by given `GenericInstanceFilter`. */
+    /**
+     * Creates the necessary ECSQL snippets to create an instance filter described by the given `GenericInstanceFilter` argument.
+     * - `from` is set to either the `contentClass.fullName` or one of `filter.propertyClassNames`, depending on which is more specific.
+     * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `filter.relatedInstances`.
+     * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on
+     * `filter.filterClassNames` and by properties as described by `filter.rules`.
+     *
+     * Special cases:
+     * - If `filter` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.
+     * - If the provided content class doesn't intersect with the property class in provided filter, a special result
+     * is returned to make sure the resulting query is valid and doesn't return anything.
+     */
     createFilterClauses(props: {
         contentClass: {
             fullName: string;

package/lib/esm/hierarchies/NodeSelectQueryFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSelectQueryFactory.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NodeSelectQueryFactory.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.ts"],"names":[],"mappings":"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"}

package/lib/esm/hierarchies/NodeSelectQueryFactory.js

@@ -73,14 +73,14 @@ class NodeSelectQueryFactory {
     `;
     }
     /**
-     * Creates the necessary ECSQL snippets to create an instance filter described by the `def` argument.
-     * - `from` is set to either the `contentClass.fullName` or `def.propertyClassName`, depending on which is more specific.
-     * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `def.relatedInstances`.
+     * Creates the necessary ECSQL snippets to create an instance filter described by the `filter` argument.
+     * - `from` is set to either the `contentClass.fullName` or one of `filter.propertyClassNames`, depending on which is more specific.
+     * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `filter.relatedInstances`.
      * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on
-     * `def.filterClassNames` and by properties as described by `def.rules`.
+     * `filter.filterClassNames` and by properties as described by `filter.rules`.
      *
      * Special cases:
-     * - If `def` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.
+     * - If `filter` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.
      * - If the provided content class doesn't intersect with the property class in provided filter, a special result
      * is returned to make sure the resulting query is valid and doesn't return anything.
      */

package/lib/esm/hierarchies/NodeSelectQueryFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSelectQueryFactory.js","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.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 { assert, Id64String } from \"@itwin/core-bentley\";\nimport {\n  GenericInstanceFilter,\n  GenericInstanceFilterRelationshipStep,\n  GenericInstanceFilterRule,\n  GenericInstanceFilterRuleGroup,\n  GenericInstanceFilterRuleGroupOperator,\n  GenericInstanceFilterRuleOperator,\n  GenericInstanceFilterRuleValue,\n} from \"@itwin/core-common\";\nimport { EC, ECClassHierarchyInspector, ECSchemaProvider, ECSql, getClass, parseFullClassName, PrimitiveValue } from \"@itwin/presentation-shared\";\n\n/**\n * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns\n * created by the factory.\n *\n * @beta\n */\nexport enum NodeSelectClauseColumnNames {\n  /** Full class name of the instance the node represents. Type: `string` in format `{schema name}:{class name}`. */\n  FullClassName = \"FullClassName\",\n  /** ECInstance ID of the instance the node represents. Type: `Id64String`. */\n  ECInstanceId = \"ECInstanceId\",\n  /** Display label. Type: `string`. */\n  DisplayLabel = \"DisplayLabel\",\n  /**\n   * A flag indicating if the node has children. Type: `boolean`. Values:\n   * - `false` - node never has children.\n   * - `true` - node always has children.\n   * - NULL - unknown, needs to be determined by requesting children for the node.\n   */\n  HasChildren = \"HasChildren\",\n  /** A flag indicating that a node should be hidden if it has no children. Type: `boolean`. */\n  HideIfNoChildren = \"HideIfNoChildren\",\n  /** A flag indicating that a node should be hidden and its children should be displayed instead. Type: `boolean`. */\n  HideNodeInHierarchy = \"HideNodeInHierarchy\",\n  /** A serialized JSON object for providing grouping information. */\n  Grouping = \"Grouping\",\n  /** A serialized JSON object for associating a node with additional data. */\n  ExtendedData = \"ExtendedData\",\n  /** A flag indicating the node should be auto-expanded when it's loaded. */\n  AutoExpand = \"AutoExpand\",\n  /** A flag indicating the node supports child hierarchy level filtering. */\n  SupportsFiltering = \"SupportsFiltering\",\n}\n\n/**\n * A data structure for defining an ECSQL value selector.\n * @beta\n */\ninterface ECSqlValueSelector {\n  selector: string;\n}\n\n/**\n * Props for `NodeSelectClauseFactory.createSelectClause`.\n * @beta\n */\ninterface NodeSelectClauseProps {\n  ecClassId: ECSqlValueSelector;\n  ecInstanceId: ECSqlValueSelector;\n  nodeLabel: string | ECSqlValueSelector;\n  extendedData?: {\n    [key: string]: Id64String | string | number | boolean | ECSqlValueSelector;\n  };\n  autoExpand?: boolean | ECSqlValueSelector;\n  supportsFiltering?: boolean | ECSqlValueSelector;\n  hasChildren?: boolean | ECSqlValueSelector;\n  hideNodeInHierarchy?: boolean | ECSqlValueSelector;\n  hideIfNoChildren?: boolean | ECSqlValueSelector;\n  grouping?: ECSqlSelectClauseGroupingParams;\n}\n\n/**\n * A data structure for defining nodes' grouping requirements.\n * @beta\n */\ninterface ECSqlSelectClauseGroupingParams {\n  byLabel?: ECSqlSelectClauseLabelGroupingParams;\n  byClass?: boolean | ECSqlSelectClauseGroupingParamsBase | ECSqlValueSelector;\n  byBaseClasses?: ECSqlSelectClauseBaseClassGroupingParams;\n  byProperties?: ECSqlSelectClausePropertiesGroupingParams;\n}\n\n/**\n * A data structure for defining label grouping params.\n * @beta\n */\ninterface ECSqlSelectClauseLabelGroupingBaseParams {\n  /** Label grouping option that determines whether to group nodes or to merge them. Defaults to \"group\".*/\n  action?: \"group\" | \"merge\";\n  /** Id that needs to match for nodes to be grouped or merged.*/\n  groupId?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining label merging.\n * @beta\n */\ninterface ECSqlSelectClauseLabelGroupingMergeParams extends ECSqlSelectClauseLabelGroupingBaseParams {\n  action: \"merge\";\n}\n\n/**\n * A data structure for defining label grouping.\n * @beta\n */\ninterface ECSqlSelectClauseLabelGroupingGroupParams extends ECSqlSelectClauseLabelGroupingBaseParams, ECSqlSelectClauseGroupingParamsBase {\n  action?: \"group\";\n}\n\n/**\n * A data structure for defining possible label grouping types.\n * @beta\n */\ntype ECSqlSelectClauseLabelGroupingParams =\n  | boolean\n  | ECSqlValueSelector\n  | ECSqlSelectClauseLabelGroupingMergeParams\n  | ECSqlSelectClauseLabelGroupingGroupParams;\n\n/**\n * A data structure for defining base grouping parameters shared across all types of grouping.\n * @beta\n */\ninterface ECSqlSelectClauseGroupingParamsBase {\n  hideIfNoSiblings?: boolean | ECSqlValueSelector;\n  hideIfOneGroupedNode?: boolean | ECSqlValueSelector;\n  autoExpand?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining properties grouping.\n * @beta\n */\ninterface ECSqlSelectClausePropertiesGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  /**\n   * Full name of a class whose properties are used to group the node. Only has effect if the node\n   * represents an instance of that class.\n   *\n   * Full class name format: `SchemaName.ClassName`.\n   */\n  propertiesClassName: string;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value is not set or is set to an empty string.\n   *\n   * Label of the created grouping node will be `Not Specified`.\n   */\n  createGroupForUnspecifiedValues?: boolean | ECSqlValueSelector;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value doesn't fit within any of the provided\n   * ranges, or is not a numeric value.\n   *\n   * Label of the created grouping node will be `Other`.\n   */\n  createGroupForOutOfRangeValues?: boolean | ECSqlValueSelector;\n  /**\n   * Properties of the specified class, by which the nodes should be grouped.\n   *\n   * Example usage:\n   * ```ts\n   * propertyGroups: [\n   *   {\n   *     propertyName: \"type\",\n   *     propertyClassAlias: \"this\"\n   *   },\n   *   {\n   *     propertyName: \"length\",\n   *     propertyClassAlias: \"x\",\n   *     ranges: [\n   *       { fromValue: 1, toValue: 10, rangeLabel: \"Small\" },\n   *       { fromValue: 11, toValue: 20, rangeLabel: \"Medium\" }\n   *     ]\n   *   },\n   * ]\n   * ```\n   */\n  propertyGroups: ECSqlSelectClausePropertyGroup[];\n}\n\n/**\n * A data structure for defining specific properties' grouping params.\n * @beta\n */\ninterface ECSqlSelectClausePropertyGroup {\n  /** A string indicating the name of the property to group by. */\n  propertyName: string;\n  /** Alias to of the class containing the property. Used to select the property value. */\n  propertyClassAlias: string;\n  /** Ranges are used to group nodes by numeric properties which are within specified bounds. */\n  ranges?: ECSqlSelectClausePropertyValueRange[];\n}\n\n/**\n * A data structure for defining boundaries for a value.\n * @beta\n */\ninterface ECSqlSelectClausePropertyValueRange {\n  /** Defines the lower bound of the range. */\n  fromValue: number | ECSqlValueSelector;\n  /** Defines the upper bound of the range. */\n  toValue: number | ECSqlValueSelector;\n  /** Defines the range label. Will be used as grouping node's display label. */\n  rangeLabel?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining base class grouping.\n * @beta\n */\ninterface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  fullClassNames: string[] | ECSqlValueSelector[];\n}\n\n/**\n * An interface of a factory that knows how to create nodes' select ECSQL query.\n * @beta\n */\nexport interface NodesQueryClauseFactory {\n  /** Create a SELECT clause in a format understood by nodes query parser used by `HierarchyProvider`. */\n  createSelectClause(props: NodeSelectClauseProps): Promise<string>;\n\n  /** Create FROM, JOIN and WHERE clauses whose combination results in an ECSQL filter defined by given `GenericInstanceFilter`. */\n  createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }>;\n}\n\n/**\n * Creates an instance of `NodeSelectQueryFactory` that .\n * @beta\n */\nexport function createNodesQueryClauseFactory(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }): NodesQueryClauseFactory {\n  return new NodeSelectQueryFactory(props);\n}\n\n/** A factory for creating a nodes' select ECSQL query. */\nclass NodeSelectQueryFactory {\n  private _imodelAccess: ECSchemaProvider & ECClassHierarchyInspector;\n\n  public constructor(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }) {\n    this._imodelAccess = props.imodelAccess;\n  }\n\n  /** Create a SELECT clause in a format understood by results reader of the library. */\n  public async createSelectClause(props: NodeSelectClauseProps) {\n    // note: the columns order must match the order in `NodeSelectClauseColumnNames`\n    return `\n      ec_ClassName(${props.ecClassId.selector}) AS ${NodeSelectClauseColumnNames.FullClassName},\n      ${props.ecInstanceId.selector} AS ${NodeSelectClauseColumnNames.ECInstanceId},\n      ${createECSqlValueSelector(props.nodeLabel)} AS ${NodeSelectClauseColumnNames.DisplayLabel},\n      CAST(${createECSqlValueSelector(props.hasChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HasChildren},\n      CAST(${createECSqlValueSelector(props.hideIfNoChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideIfNoChildren},\n      CAST(${createECSqlValueSelector(props.hideNodeInHierarchy)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideNodeInHierarchy},\n      ${props.grouping ? createGroupingSelector(props.grouping) : \"CAST(NULL AS TEXT)\"} AS ${NodeSelectClauseColumnNames.Grouping},\n      ${\n        props.extendedData\n          ? `json_object(${Object.entries(props.extendedData)\n              .map(([key, value]) => `'${key}', ${createECSqlValueSelector(value)}`)\n              .join(\", \")})`\n          : \"CAST(NULL AS TEXT)\"\n      } AS ${NodeSelectClauseColumnNames.ExtendedData},\n      CAST(${createECSqlValueSelector(props.autoExpand)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.AutoExpand},\n      CAST(${createECSqlValueSelector(props.supportsFiltering)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.SupportsFiltering}\n    `;\n  }\n\n  /**\n   * Creates the necessary ECSQL snippets to create an instance filter described by the `def` argument.\n   * - `from` is set to either the `contentClass.fullName` or `def.propertyClassName`, depending on which is more specific.\n   * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `def.relatedInstances`.\n   * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on\n   * `def.filterClassNames` and by properties as described by `def.rules`.\n   *\n   * Special cases:\n   * - If `def` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.\n   * - If the provided content class doesn't intersect with the property class in provided filter, a special result\n   * is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  public async createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }> {\n    const { contentClass, filter } = props;\n    if (!filter) {\n      // undefined filter means we don't want any filtering to be applied\n      return { from: contentClass.fullName, joins: \"\", where: \"\" };\n    }\n\n    const from = await specializeContentClass({\n      classHierarchyInspector: this._imodelAccess,\n      contentClassName: contentClass.fullName,\n      filterClassNames: filter.propertyClassNames,\n    });\n    if (!from) {\n      // filter class doesn't intersect with content class - make sure the query returns nothing by returning a `FALSE` WHERE clause\n      return { from: contentClass.fullName, joins: \"\", where: \"FALSE\" };\n    }\n\n    /**\n     * TODO:\n     * There may be similar related instance paths, e.g.:\n     * - A -> B -> C,\n     * - A -> B -> D.\n     * At this moment we're handling each path individually which means A and B would get joined twice. We could look into\n     * creating a join tree first, e.g.\n     *         C\n     *        /\n     * A -> B\n     *        \\\n     *         D\n     */\n    const joins = await Promise.all(\n      filter.relatedInstances.map(async (rel, i) =>\n        ECSql.createRelationshipPathJoinClause({\n          schemaProvider: this._imodelAccess,\n          path: assignRelationshipPathAliases(rel.path, i, contentClass.alias, rel.alias),\n        }),\n      ),\n    );\n\n    const whereConditions = new Array<string>();\n    if (filter.filteredClassNames && filter.filteredClassNames.length > 0) {\n      whereConditions.push(\n        `${ECSql.createRawPropertyValueSelector(contentClass.alias, \"ECClassId\")} IS (\n          ${filter.filteredClassNames\n            .map(parseFullClassName)\n            .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n            .join(\", \")}\n        )`,\n      );\n    }\n    const classAliasMap = new Map<string, string>([[contentClass.alias, from]]);\n    filter.relatedInstances.forEach(({ path, alias }) => path.length > 0 && classAliasMap.set(alias, path[path.length - 1].targetClassName));\n    const propertiesFilter = await createWhereClause(\n      contentClass.alias,\n      async (alias) => {\n        const aliasClassName = classAliasMap.get(alias);\n        return aliasClassName ? getClass(this._imodelAccess, aliasClassName) : undefined;\n      },\n      filter.rules,\n    );\n    if (propertiesFilter) {\n      whereConditions.push(propertiesFilter);\n    }\n\n    return {\n      from,\n      joins: joins.join(\"\\n\"),\n      where: whereConditions.join(\" AND \"),\n    };\n  }\n}\n\nfunction createECSqlValueSelector(input: undefined | PrimitiveValue | ECSqlValueSelector) {\n  if (input === undefined) {\n    return \"NULL\";\n  }\n  if (isSelector(input)) {\n    return input.selector;\n  }\n  return ECSql.createRawPrimitiveValueSelector(input);\n}\n\nfunction isSelector(x: any): x is ECSqlValueSelector {\n  return !!x.selector;\n}\n\nfunction createGroupingSelector(grouping: ECSqlSelectClauseGroupingParams): string {\n  const groupingSelectors = new Array<{ key: string; selector: string }>();\n\n  grouping.byLabel &&\n    groupingSelectors.push({\n      key: \"byLabel\",\n      selector:\n        typeof grouping.byLabel === \"boolean\" || isSelector(grouping.byLabel)\n          ? createECSqlValueSelector(grouping.byLabel)\n          : serializeJsonObject(createLabelGroupingBaseParamsSelectors(grouping.byLabel)),\n    });\n\n  grouping.byClass &&\n    groupingSelectors.push({\n      key: \"byClass\",\n      selector:\n        typeof grouping.byClass === \"boolean\" || isSelector(grouping.byClass)\n          ? createECSqlValueSelector(grouping.byClass)\n          : serializeJsonObject(createBaseGroupingParamSelectors(grouping.byClass)),\n    });\n\n  grouping.byBaseClasses &&\n    groupingSelectors.push({\n      key: \"byBaseClasses\",\n      selector: serializeJsonObject([\n        {\n          key: \"fullClassNames\",\n          selector: `json_array(${grouping.byBaseClasses.fullClassNames.map((className) => createECSqlValueSelector(className)).join(\", \")})`,\n        },\n        ...createBaseGroupingParamSelectors(grouping.byBaseClasses),\n      ]),\n    });\n\n  grouping.byProperties &&\n    groupingSelectors.push({\n      key: \"byProperties\",\n      selector: serializeJsonObject([\n        {\n          key: \"propertiesClassName\",\n          selector: `${createECSqlValueSelector(grouping.byProperties.propertiesClassName)}`,\n        },\n        {\n          key: \"propertyGroups\",\n          selector: `json_array(${grouping.byProperties.propertyGroups\n            .map((propertyGroup) => serializeJsonObject(createPropertyGroupSelectors(propertyGroup)))\n            .join(\", \")})`,\n        },\n        ...(grouping.byProperties.createGroupForOutOfRangeValues !== undefined\n          ? [\n              {\n                key: \"createGroupForOutOfRangeValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForOutOfRangeValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...(grouping.byProperties.createGroupForUnspecifiedValues !== undefined\n          ? [\n              {\n                key: \"createGroupForUnspecifiedValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForUnspecifiedValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...createBaseGroupingParamSelectors(grouping.byProperties),\n      ]),\n    });\n\n  return serializeJsonObject(groupingSelectors);\n}\n\nfunction createLabelGroupingBaseParamsSelectors(byLabel: ECSqlSelectClauseLabelGroupingMergeParams | ECSqlSelectClauseLabelGroupingGroupParams) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (byLabel.action !== undefined) {\n    selectors.push({\n      key: \"action\",\n      selector: `${createECSqlValueSelector(byLabel.action)}`,\n    });\n  }\n  if (byLabel.groupId !== undefined) {\n    selectors.push({\n      key: \"groupId\",\n      selector: createECSqlValueSelector(byLabel.groupId),\n    });\n  }\n  if (byLabel.action !== \"merge\") {\n    selectors.push(...createBaseGroupingParamSelectors(byLabel));\n  }\n\n  return selectors;\n}\n\nfunction createPropertyGroupSelectors(propertyGroup: ECSqlSelectClausePropertyGroup) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  selectors.push(\n    {\n      key: \"propertyName\",\n      selector: `${createECSqlValueSelector(propertyGroup.propertyName)}`,\n    },\n    {\n      key: \"propertyValue\",\n      selector: `[${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}]`,\n    },\n  );\n  if (propertyGroup.ranges) {\n    selectors.push(createRangeParamSelectors(propertyGroup.ranges));\n  }\n  return selectors;\n}\n\nfunction createRangeParamSelectors(ranges: ECSqlSelectClausePropertyValueRange[]) {\n  return {\n    key: \"ranges\",\n    selector: `json_array(${ranges\n      .map((range) =>\n        serializeJsonObject([\n          {\n            key: \"fromValue\",\n            selector: createECSqlValueSelector(range.fromValue),\n          },\n          {\n            key: \"toValue\",\n            selector: createECSqlValueSelector(range.toValue),\n          },\n          ...(range.rangeLabel\n            ? [\n                {\n                  key: \"rangeLabel\",\n                  selector: `${createECSqlValueSelector(range.rangeLabel)}`,\n                },\n              ]\n            : []),\n        ]),\n      )\n      .join(\", \")})`,\n  };\n}\n\nfunction createBaseGroupingParamSelectors(params: ECSqlSelectClauseGroupingParamsBase) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (params.hideIfNoSiblings !== undefined) {\n    selectors.push({\n      key: \"hideIfNoSiblings\",\n      selector: createECSqlValueSelector(params.hideIfNoSiblings),\n    });\n  }\n  if (params.hideIfOneGroupedNode !== undefined) {\n    selectors.push({\n      key: \"hideIfOneGroupedNode\",\n      selector: createECSqlValueSelector(params.hideIfOneGroupedNode),\n    });\n  }\n  if (params.autoExpand !== undefined) {\n    selectors.push({\n      key: \"autoExpand\",\n      selector: createECSqlValueSelector(params.autoExpand),\n    });\n  }\n  return selectors;\n}\n\nfunction serializeJsonObject(selectors: Array<{ key: string; selector: string }>): string {\n  return `json_object(${selectors.map(({ key, selector }) => `'${key}', ${selector}`).join(\", \")})`;\n}\n\nasync function createWhereClause(\n  contentClassAlias: string,\n  classLoader: (alias: string) => Promise<EC.Class | undefined>,\n  rule: GenericInstanceFilterRule | GenericInstanceFilterRuleGroup,\n): Promise<string | undefined> {\n  if (GenericInstanceFilter.isFilterRuleGroup(rule)) {\n    const clause = (await Promise.all(rule.rules.map(async (r) => createWhereClause(contentClassAlias, classLoader, r))))\n      .filter((c) => !!c)\n      .join(` ${getECSqlLogicalOperator(rule.operator)} `);\n    return clause ? (rule.operator === \"or\" ? `(${clause})` : clause) : undefined;\n  }\n  const sourceAlias = rule.sourceAlias ? rule.sourceAlias : contentClassAlias;\n  const propertyValueSelector = ECSql.createRawPropertyValueSelector(sourceAlias, rule.propertyName);\n  if (isUnaryRuleOperator(rule.operator)) {\n    switch (rule.operator) {\n      case \"is-true\":\n        return propertyValueSelector;\n      case \"is-false\":\n        return `NOT ${propertyValueSelector}`;\n      case \"is-null\":\n        return `${propertyValueSelector} IS NULL`;\n      case \"is-not-null\":\n        return `${propertyValueSelector} IS NOT NULL`;\n    }\n  }\n  const ecsqlOperator = getECSqlComparisonOperator(rule.operator);\n  if (rule.value === undefined) {\n    throw new Error(`Rule \"${rule.propertyName}\" ${ecsqlOperator} is missing value.`);\n  }\n\n  const value = rule.value.rawValue;\n\n  if (rule.operator === \"like\" && typeof value === \"string\") {\n    const escapedValue = value.replace(/[%_\\\\]/g, \"\\\\$&\");\n    return `${propertyValueSelector} ${ecsqlOperator} '%${escapedValue}%' ESCAPE '\\\\'`;\n  }\n  const propertyClass = await classLoader(sourceAlias);\n  if (!propertyClass) {\n    throw new Error(`Class with alias \"${sourceAlias}\" not found.`);\n  }\n  const property = await propertyClass.getProperty(rule.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${rule.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n  if (property.isNavigation()) {\n    assert(rule.value !== undefined && GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector}.[Id] ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value.id)}`;\n  }\n  if (property.isEnumeration()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n  }\n  if (property.isPrimitive()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    switch (property.primitiveType) {\n      case \"Point2d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint2d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Point3d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint3d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[z]`, \"is-equal\", value.z)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Double\": {\n        assert(typeof value === \"number\");\n        if (rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\") {\n          return `${createFloatingPointEqualityClause(propertyValueSelector, rule.operator, value)}`;\n        }\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n      default: {\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n    }\n  }\n  throw new Error(\"Struct and array properties are not supported for filtering\");\n}\n\nfunction createFloatingPointEqualityClause(valueSelector: string, operator: \"is-equal\" | \"is-not-equal\", value: number) {\n  const [from, to] = getFloatingPointValueRange(value);\n  return `${valueSelector} ${operator === \"is-not-equal\" ? \"NOT \" : \"\"} BETWEEN ${from} AND ${to}`;\n}\n\nfunction getFloatingPointValueRange(value: number): [number, number] {\n  return [value - Number.EPSILON, value + Number.EPSILON];\n}\n\nfunction getECSqlLogicalOperator(op: GenericInstanceFilterRuleGroupOperator) {\n  switch (op) {\n    case \"and\":\n      return \"AND\";\n    case \"or\":\n      return \"OR\";\n  }\n}\n\nfunction isUnaryRuleOperator(\n  op: GenericInstanceFilterRuleOperator,\n): op is Extract<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\"> {\n  return op === \"is-true\" || op === \"is-false\" || op === \"is-null\" || op === \"is-not-null\";\n}\n\nfunction getECSqlComparisonOperator(op: Exclude<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\">) {\n  switch (op) {\n    case \"is-equal\":\n      return `=`;\n    case \"is-not-equal\":\n      return `<>`;\n    case \"greater\":\n      return `>`;\n    case \"greater-or-equal\":\n      return `>=`;\n    case \"less\":\n      return `<`;\n    case \"less-or-equal\":\n      return `<=`;\n    case \"like\":\n      return `LIKE`;\n  }\n}\n\ntype JoinRelationshipPath = Parameters<typeof ECSql.createRelationshipPathJoinClause>[0][\"path\"];\nfunction assignRelationshipPathAliases(\n  path: GenericInstanceFilterRelationshipStep[],\n  pathIndex: number,\n  sourceAlias: string,\n  targetAlias: string,\n): JoinRelationshipPath {\n  function createAlias(fullClassName: string, index: number) {\n    return `rel_${pathIndex}_${fullClassName.replaceAll(/[\\.:]/g, \"_\")}_${index}`;\n  }\n  const result: JoinRelationshipPath = [];\n  path.forEach((step, i) => {\n    result.push({\n      targetClassName: step.targetClassName,\n      relationshipName: step.relationshipClassName,\n      sourceClassName: step.sourceClassName,\n      relationshipReverse: !step.isForwardRelationship,\n      sourceAlias: i === 0 ? sourceAlias : result[i - 1].targetAlias,\n      relationshipAlias: createAlias(step.relationshipClassName, i),\n      targetAlias: i === path.length - 1 ? targetAlias : createAlias(step.targetClassName, i),\n      joinType: \"inner\",\n    });\n  });\n  return result;\n}\n\ninterface SpecializeContentClassProps {\n  classHierarchyInspector: ECClassHierarchyInspector;\n  contentClassName: string;\n  filterClassNames: string[];\n}\nasync function specializeContentClass(props: SpecializeContentClassProps): Promise<string | undefined> {\n  const filterClass = await getSpecializedPropertyClass(props.classHierarchyInspector, props.filterClassNames);\n  if (!filterClass) {\n    return props.contentClassName;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(filterClass, props.contentClassName)) {\n    return filterClass;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(props.contentClassName, filterClass)) {\n    return props.contentClassName;\n  }\n  return undefined;\n}\n\nasync function getSpecializedPropertyClass(classHierarchyInspector: ECClassHierarchyInspector, classes: string[]): Promise<string | undefined> {\n  if (classes.length === 0) {\n    return undefined;\n  }\n  const [currClassName, ...restClasses] = classes;\n  let resolvedClassName = currClassName;\n  for (const propClassName of restClasses) {\n    if (await classHierarchyInspector.classDerivesFrom(propClassName, resolvedClassName)) {\n      resolvedClassName = propClassName;\n    }\n  }\n  return resolvedClassName;\n}\n"]}
+{"version":3,"file":"NodeSelectQueryFactory.js","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.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 { assert, Id64String } from \"@itwin/core-bentley\";\nimport {\n  GenericInstanceFilter,\n  GenericInstanceFilterRelationshipStep,\n  GenericInstanceFilterRule,\n  GenericInstanceFilterRuleGroup,\n  GenericInstanceFilterRuleGroupOperator,\n  GenericInstanceFilterRuleOperator,\n  GenericInstanceFilterRuleValue,\n} from \"@itwin/core-common\";\nimport { EC, ECClassHierarchyInspector, ECSchemaProvider, ECSql, getClass, parseFullClassName, PrimitiveValue } from \"@itwin/presentation-shared\";\nimport { HierarchyNodeAutoExpandProp } from \"./HierarchyNode\";\n\n/**\n * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns\n * created by the factory.\n *\n * @beta\n */\nexport enum NodeSelectClauseColumnNames {\n  /** Full class name of the instance the node represents. Type: `string` in format `{schema name}:{class name}`. */\n  FullClassName = \"FullClassName\",\n  /** ECInstance ID of the instance the node represents. Type: `Id64String`. */\n  ECInstanceId = \"ECInstanceId\",\n  /** Display label. Type: `string`. */\n  DisplayLabel = \"DisplayLabel\",\n  /**\n   * A flag indicating if the node has children. Type: `boolean`. Values:\n   * - `false` - node never has children.\n   * - `true` - node always has children.\n   * - NULL - unknown, needs to be determined by requesting children for the node.\n   */\n  HasChildren = \"HasChildren\",\n  /** A flag indicating that a node should be hidden if it has no children. Type: `boolean`. */\n  HideIfNoChildren = \"HideIfNoChildren\",\n  /** A flag indicating that a node should be hidden and its children should be displayed instead. Type: `boolean`. */\n  HideNodeInHierarchy = \"HideNodeInHierarchy\",\n  /** A serialized JSON object for providing grouping information. */\n  Grouping = \"Grouping\",\n  /** A serialized JSON object for associating a node with additional data. */\n  ExtendedData = \"ExtendedData\",\n  /** A flag indicating the node should be auto-expanded when it's loaded. */\n  AutoExpand = \"AutoExpand\",\n  /** A flag indicating the node supports child hierarchy level filtering. */\n  SupportsFiltering = \"SupportsFiltering\",\n}\n\n/**\n * A data structure for defining an ECSQL value selector.\n * @beta\n */\ninterface ECSqlValueSelector {\n  selector: string;\n}\n\n/**\n * Props for `NodeSelectClauseFactory.createSelectClause`.\n * @beta\n */\ninterface NodeSelectClauseProps {\n  ecClassId: ECSqlValueSelector;\n  ecInstanceId: ECSqlValueSelector;\n  nodeLabel: string | ECSqlValueSelector;\n  extendedData?: {\n    [key: string]: Id64String | string | number | boolean | ECSqlValueSelector;\n  };\n  autoExpand?: boolean | ECSqlValueSelector;\n  supportsFiltering?: boolean | ECSqlValueSelector;\n  hasChildren?: boolean | ECSqlValueSelector;\n  hideNodeInHierarchy?: boolean | ECSqlValueSelector;\n  hideIfNoChildren?: boolean | ECSqlValueSelector;\n  grouping?: ECSqlSelectClauseGroupingParams;\n}\n\n/**\n * A data structure for defining nodes' grouping requirements.\n * @beta\n */\ninterface ECSqlSelectClauseGroupingParams {\n  byLabel?: ECSqlSelectClauseLabelGroupingParams;\n  byClass?: boolean | ECSqlSelectClauseGroupingParamsBase | ECSqlValueSelector;\n  byBaseClasses?: ECSqlSelectClauseBaseClassGroupingParams;\n  byProperties?: ECSqlSelectClausePropertiesGroupingParams;\n}\n\n/**\n * A data structure for defining label grouping params.\n * @beta\n */\ninterface ECSqlSelectClauseLabelGroupingBaseParams {\n  /** Label grouping option that determines whether to group nodes or to merge them. Defaults to \"group\".*/\n  action?: \"group\" | \"merge\";\n  /** Id that needs to match for nodes to be grouped or merged.*/\n  groupId?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining label merging.\n * @beta\n */\ninterface ECSqlSelectClauseLabelGroupingMergeParams extends ECSqlSelectClauseLabelGroupingBaseParams {\n  action: \"merge\";\n}\n\n/**\n * A data structure for defining label grouping.\n * @beta\n */\ninterface ECSqlSelectClauseLabelGroupingGroupParams extends ECSqlSelectClauseLabelGroupingBaseParams, ECSqlSelectClauseGroupingParamsBase {\n  action?: \"group\";\n}\n\n/**\n * A data structure for defining possible label grouping types.\n * @beta\n */\ntype ECSqlSelectClauseLabelGroupingParams =\n  | boolean\n  | ECSqlValueSelector\n  | ECSqlSelectClauseLabelGroupingMergeParams\n  | ECSqlSelectClauseLabelGroupingGroupParams;\n\n/**\n * A data structure for defining base grouping parameters shared across all types of grouping.\n * @beta\n */\ninterface ECSqlSelectClauseGroupingParamsBase {\n  hideIfNoSiblings?: boolean | ECSqlValueSelector;\n  hideIfOneGroupedNode?: boolean | ECSqlValueSelector;\n  autoExpand?: HierarchyNodeAutoExpandProp | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining properties grouping.\n * @beta\n */\ninterface ECSqlSelectClausePropertiesGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  /**\n   * Full name of a class whose properties are used to group the node. Only has effect if the node\n   * represents an instance of that class.\n   *\n   * Full class name format: `SchemaName.ClassName`.\n   */\n  propertiesClassName: string;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value is not set or is set to an empty string.\n   *\n   * Label of the created grouping node will be `Not Specified`.\n   */\n  createGroupForUnspecifiedValues?: boolean | ECSqlValueSelector;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value doesn't fit within any of the provided\n   * ranges, or is not a numeric value.\n   *\n   * Label of the created grouping node will be `Other`.\n   */\n  createGroupForOutOfRangeValues?: boolean | ECSqlValueSelector;\n  /**\n   * Properties of the specified class, by which the nodes should be grouped.\n   *\n   * Example usage:\n   * ```ts\n   * propertyGroups: [\n   *   {\n   *     propertyName: \"type\",\n   *     propertyClassAlias: \"this\"\n   *   },\n   *   {\n   *     propertyName: \"length\",\n   *     propertyClassAlias: \"x\",\n   *     ranges: [\n   *       { fromValue: 1, toValue: 10, rangeLabel: \"Small\" },\n   *       { fromValue: 11, toValue: 20, rangeLabel: \"Medium\" }\n   *     ]\n   *   },\n   * ]\n   * ```\n   */\n  propertyGroups: ECSqlSelectClausePropertyGroup[];\n}\n\n/**\n * A data structure for defining specific properties' grouping params.\n * @beta\n */\ninterface ECSqlSelectClausePropertyGroup {\n  /** A string indicating the name of the property to group by. */\n  propertyName: string;\n  /** Alias to of the class containing the property. Used to select the property value. */\n  propertyClassAlias: string;\n  /** Ranges are used to group nodes by numeric properties which are within specified bounds. */\n  ranges?: ECSqlSelectClausePropertyValueRange[];\n}\n\n/**\n * A data structure for defining boundaries for a value.\n * @beta\n */\ninterface ECSqlSelectClausePropertyValueRange {\n  /** Defines the lower bound of the range. */\n  fromValue: number | ECSqlValueSelector;\n  /** Defines the upper bound of the range. */\n  toValue: number | ECSqlValueSelector;\n  /** Defines the range label. Will be used as grouping node's display label. */\n  rangeLabel?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining base class grouping.\n * @beta\n */\ninterface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  fullClassNames: string[] | ECSqlValueSelector[];\n}\n\n/**\n * An interface of a factory that knows how to create nodes' select ECSQL query.\n * @beta\n */\nexport interface NodesQueryClauseFactory {\n  /** Create a SELECT clause in a format understood by nodes query parser used by `HierarchyProvider`. */\n  createSelectClause(props: NodeSelectClauseProps): Promise<string>;\n\n  /**\n   * Creates the necessary ECSQL snippets to create an instance filter described by the given `GenericInstanceFilter` argument.\n   * - `from` is set to either the `contentClass.fullName` or one of `filter.propertyClassNames`, depending on which is more specific.\n   * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `filter.relatedInstances`.\n   * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on\n   * `filter.filterClassNames` and by properties as described by `filter.rules`.\n   *\n   * Special cases:\n   * - If `filter` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.\n   * - If the provided content class doesn't intersect with the property class in provided filter, a special result\n   * is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }>;\n}\n\n/**\n * Creates an instance of `NodeSelectQueryFactory` that .\n * @beta\n */\nexport function createNodesQueryClauseFactory(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }): NodesQueryClauseFactory {\n  return new NodeSelectQueryFactory(props);\n}\n\n/** A factory for creating a nodes' select ECSQL query. */\nclass NodeSelectQueryFactory {\n  private _imodelAccess: ECSchemaProvider & ECClassHierarchyInspector;\n\n  public constructor(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }) {\n    this._imodelAccess = props.imodelAccess;\n  }\n\n  /** Create a SELECT clause in a format understood by results reader of the library. */\n  public async createSelectClause(props: NodeSelectClauseProps) {\n    // note: the columns order must match the order in `NodeSelectClauseColumnNames`\n    return `\n      ec_ClassName(${props.ecClassId.selector}) AS ${NodeSelectClauseColumnNames.FullClassName},\n      ${props.ecInstanceId.selector} AS ${NodeSelectClauseColumnNames.ECInstanceId},\n      ${createECSqlValueSelector(props.nodeLabel)} AS ${NodeSelectClauseColumnNames.DisplayLabel},\n      CAST(${createECSqlValueSelector(props.hasChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HasChildren},\n      CAST(${createECSqlValueSelector(props.hideIfNoChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideIfNoChildren},\n      CAST(${createECSqlValueSelector(props.hideNodeInHierarchy)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideNodeInHierarchy},\n      ${props.grouping ? createGroupingSelector(props.grouping) : \"CAST(NULL AS TEXT)\"} AS ${NodeSelectClauseColumnNames.Grouping},\n      ${\n        props.extendedData\n          ? `json_object(${Object.entries(props.extendedData)\n              .map(([key, value]) => `'${key}', ${createECSqlValueSelector(value)}`)\n              .join(\", \")})`\n          : \"CAST(NULL AS TEXT)\"\n      } AS ${NodeSelectClauseColumnNames.ExtendedData},\n      CAST(${createECSqlValueSelector(props.autoExpand)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.AutoExpand},\n      CAST(${createECSqlValueSelector(props.supportsFiltering)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.SupportsFiltering}\n    `;\n  }\n\n  /**\n   * Creates the necessary ECSQL snippets to create an instance filter described by the `filter` argument.\n   * - `from` is set to either the `contentClass.fullName` or one of `filter.propertyClassNames`, depending on which is more specific.\n   * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `filter.relatedInstances`.\n   * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on\n   * `filter.filterClassNames` and by properties as described by `filter.rules`.\n   *\n   * Special cases:\n   * - If `filter` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.\n   * - If the provided content class doesn't intersect with the property class in provided filter, a special result\n   * is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  public async createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }> {\n    const { contentClass, filter } = props;\n    if (!filter) {\n      // undefined filter means we don't want any filtering to be applied\n      return { from: contentClass.fullName, joins: \"\", where: \"\" };\n    }\n\n    const from = await specializeContentClass({\n      classHierarchyInspector: this._imodelAccess,\n      contentClassName: contentClass.fullName,\n      filterClassNames: filter.propertyClassNames,\n    });\n    if (!from) {\n      // filter class doesn't intersect with content class - make sure the query returns nothing by returning a `FALSE` WHERE clause\n      return { from: contentClass.fullName, joins: \"\", where: \"FALSE\" };\n    }\n\n    /**\n     * TODO:\n     * There may be similar related instance paths, e.g.:\n     * - A -> B -> C,\n     * - A -> B -> D.\n     * At this moment we're handling each path individually which means A and B would get joined twice. We could look into\n     * creating a join tree first, e.g.\n     *         C\n     *        /\n     * A -> B\n     *        \\\n     *         D\n     */\n    const joins = await Promise.all(\n      filter.relatedInstances.map(async (rel, i) =>\n        ECSql.createRelationshipPathJoinClause({\n          schemaProvider: this._imodelAccess,\n          path: assignRelationshipPathAliases(rel.path, i, contentClass.alias, rel.alias),\n        }),\n      ),\n    );\n\n    const whereConditions = new Array<string>();\n    if (filter.filteredClassNames && filter.filteredClassNames.length > 0) {\n      whereConditions.push(\n        `${ECSql.createRawPropertyValueSelector(contentClass.alias, \"ECClassId\")} IS (\n          ${filter.filteredClassNames\n            .map(parseFullClassName)\n            .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n            .join(\", \")}\n        )`,\n      );\n    }\n    const classAliasMap = new Map<string, string>([[contentClass.alias, from]]);\n    filter.relatedInstances.forEach(({ path, alias }) => path.length > 0 && classAliasMap.set(alias, path[path.length - 1].targetClassName));\n    const propertiesFilter = await createWhereClause(\n      contentClass.alias,\n      async (alias) => {\n        const aliasClassName = classAliasMap.get(alias);\n        return aliasClassName ? getClass(this._imodelAccess, aliasClassName) : undefined;\n      },\n      filter.rules,\n    );\n    if (propertiesFilter) {\n      whereConditions.push(propertiesFilter);\n    }\n\n    return {\n      from,\n      joins: joins.join(\"\\n\"),\n      where: whereConditions.join(\" AND \"),\n    };\n  }\n}\n\nfunction createECSqlValueSelector(input: undefined | PrimitiveValue | ECSqlValueSelector) {\n  if (input === undefined) {\n    return \"NULL\";\n  }\n  if (isSelector(input)) {\n    return input.selector;\n  }\n  return ECSql.createRawPrimitiveValueSelector(input);\n}\n\nfunction isSelector(x: any): x is ECSqlValueSelector {\n  return !!x.selector;\n}\n\nfunction createGroupingSelector(grouping: ECSqlSelectClauseGroupingParams): string {\n  const groupingSelectors = new Array<{ key: string; selector: string }>();\n\n  grouping.byLabel &&\n    groupingSelectors.push({\n      key: \"byLabel\",\n      selector:\n        typeof grouping.byLabel === \"boolean\" || isSelector(grouping.byLabel)\n          ? createECSqlValueSelector(grouping.byLabel)\n          : serializeJsonObject(createLabelGroupingBaseParamsSelectors(grouping.byLabel)),\n    });\n\n  grouping.byClass &&\n    groupingSelectors.push({\n      key: \"byClass\",\n      selector:\n        typeof grouping.byClass === \"boolean\" || isSelector(grouping.byClass)\n          ? createECSqlValueSelector(grouping.byClass)\n          : serializeJsonObject(createBaseGroupingParamSelectors(grouping.byClass)),\n    });\n\n  grouping.byBaseClasses &&\n    groupingSelectors.push({\n      key: \"byBaseClasses\",\n      selector: serializeJsonObject([\n        {\n          key: \"fullClassNames\",\n          selector: `json_array(${grouping.byBaseClasses.fullClassNames.map((className) => createECSqlValueSelector(className)).join(\", \")})`,\n        },\n        ...createBaseGroupingParamSelectors(grouping.byBaseClasses),\n      ]),\n    });\n\n  grouping.byProperties &&\n    groupingSelectors.push({\n      key: \"byProperties\",\n      selector: serializeJsonObject([\n        {\n          key: \"propertiesClassName\",\n          selector: `${createECSqlValueSelector(grouping.byProperties.propertiesClassName)}`,\n        },\n        {\n          key: \"propertyGroups\",\n          selector: `json_array(${grouping.byProperties.propertyGroups\n            .map((propertyGroup) => serializeJsonObject(createPropertyGroupSelectors(propertyGroup)))\n            .join(\", \")})`,\n        },\n        ...(grouping.byProperties.createGroupForOutOfRangeValues !== undefined\n          ? [\n              {\n                key: \"createGroupForOutOfRangeValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForOutOfRangeValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...(grouping.byProperties.createGroupForUnspecifiedValues !== undefined\n          ? [\n              {\n                key: \"createGroupForUnspecifiedValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForUnspecifiedValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...createBaseGroupingParamSelectors(grouping.byProperties),\n      ]),\n    });\n\n  return serializeJsonObject(groupingSelectors);\n}\n\nfunction createLabelGroupingBaseParamsSelectors(byLabel: ECSqlSelectClauseLabelGroupingMergeParams | ECSqlSelectClauseLabelGroupingGroupParams) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (byLabel.action !== undefined) {\n    selectors.push({\n      key: \"action\",\n      selector: `${createECSqlValueSelector(byLabel.action)}`,\n    });\n  }\n  if (byLabel.groupId !== undefined) {\n    selectors.push({\n      key: \"groupId\",\n      selector: createECSqlValueSelector(byLabel.groupId),\n    });\n  }\n  if (byLabel.action !== \"merge\") {\n    selectors.push(...createBaseGroupingParamSelectors(byLabel));\n  }\n\n  return selectors;\n}\n\nfunction createPropertyGroupSelectors(propertyGroup: ECSqlSelectClausePropertyGroup) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  selectors.push(\n    {\n      key: \"propertyName\",\n      selector: `${createECSqlValueSelector(propertyGroup.propertyName)}`,\n    },\n    {\n      key: \"propertyValue\",\n      selector: `[${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}]`,\n    },\n  );\n  if (propertyGroup.ranges) {\n    selectors.push(createRangeParamSelectors(propertyGroup.ranges));\n  }\n  return selectors;\n}\n\nfunction createRangeParamSelectors(ranges: ECSqlSelectClausePropertyValueRange[]) {\n  return {\n    key: \"ranges\",\n    selector: `json_array(${ranges\n      .map((range) =>\n        serializeJsonObject([\n          {\n            key: \"fromValue\",\n            selector: createECSqlValueSelector(range.fromValue),\n          },\n          {\n            key: \"toValue\",\n            selector: createECSqlValueSelector(range.toValue),\n          },\n          ...(range.rangeLabel\n            ? [\n                {\n                  key: \"rangeLabel\",\n                  selector: `${createECSqlValueSelector(range.rangeLabel)}`,\n                },\n              ]\n            : []),\n        ]),\n      )\n      .join(\", \")})`,\n  };\n}\n\nfunction createBaseGroupingParamSelectors(params: ECSqlSelectClauseGroupingParamsBase) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (params.hideIfNoSiblings !== undefined) {\n    selectors.push({\n      key: \"hideIfNoSiblings\",\n      selector: createECSqlValueSelector(params.hideIfNoSiblings),\n    });\n  }\n  if (params.hideIfOneGroupedNode !== undefined) {\n    selectors.push({\n      key: \"hideIfOneGroupedNode\",\n      selector: createECSqlValueSelector(params.hideIfOneGroupedNode),\n    });\n  }\n  if (params.autoExpand !== undefined) {\n    selectors.push({\n      key: \"autoExpand\",\n      selector: createECSqlValueSelector(params.autoExpand),\n    });\n  }\n  return selectors;\n}\n\nfunction serializeJsonObject(selectors: Array<{ key: string; selector: string }>): string {\n  return `json_object(${selectors.map(({ key, selector }) => `'${key}', ${selector}`).join(\", \")})`;\n}\n\nasync function createWhereClause(\n  contentClassAlias: string,\n  classLoader: (alias: string) => Promise<EC.Class | undefined>,\n  rule: GenericInstanceFilterRule | GenericInstanceFilterRuleGroup,\n): Promise<string | undefined> {\n  if (GenericInstanceFilter.isFilterRuleGroup(rule)) {\n    const clause = (await Promise.all(rule.rules.map(async (r) => createWhereClause(contentClassAlias, classLoader, r))))\n      .filter((c) => !!c)\n      .join(` ${getECSqlLogicalOperator(rule.operator)} `);\n    return clause ? (rule.operator === \"or\" ? `(${clause})` : clause) : undefined;\n  }\n  const sourceAlias = rule.sourceAlias ? rule.sourceAlias : contentClassAlias;\n  const propertyValueSelector = ECSql.createRawPropertyValueSelector(sourceAlias, rule.propertyName);\n  if (isUnaryRuleOperator(rule.operator)) {\n    switch (rule.operator) {\n      case \"is-true\":\n        return propertyValueSelector;\n      case \"is-false\":\n        return `NOT ${propertyValueSelector}`;\n      case \"is-null\":\n        return `${propertyValueSelector} IS NULL`;\n      case \"is-not-null\":\n        return `${propertyValueSelector} IS NOT NULL`;\n    }\n  }\n  const ecsqlOperator = getECSqlComparisonOperator(rule.operator);\n  if (rule.value === undefined) {\n    throw new Error(`Rule \"${rule.propertyName}\" ${ecsqlOperator} is missing value.`);\n  }\n\n  const value = rule.value.rawValue;\n\n  if (rule.operator === \"like\" && typeof value === \"string\") {\n    const escapedValue = value.replace(/[%_\\\\]/g, \"\\\\$&\");\n    return `${propertyValueSelector} ${ecsqlOperator} '%${escapedValue}%' ESCAPE '\\\\'`;\n  }\n  const propertyClass = await classLoader(sourceAlias);\n  if (!propertyClass) {\n    throw new Error(`Class with alias \"${sourceAlias}\" not found.`);\n  }\n  const property = await propertyClass.getProperty(rule.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${rule.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n  if (property.isNavigation()) {\n    assert(rule.value !== undefined && GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector}.[Id] ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value.id)}`;\n  }\n  if (property.isEnumeration()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n  }\n  if (property.isPrimitive()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    switch (property.primitiveType) {\n      case \"Point2d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint2d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Point3d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint3d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[z]`, \"is-equal\", value.z)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Double\": {\n        assert(typeof value === \"number\");\n        if (rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\") {\n          return `${createFloatingPointEqualityClause(propertyValueSelector, rule.operator, value)}`;\n        }\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n      default: {\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n    }\n  }\n  throw new Error(\"Struct and array properties are not supported for filtering\");\n}\n\nfunction createFloatingPointEqualityClause(valueSelector: string, operator: \"is-equal\" | \"is-not-equal\", value: number) {\n  const [from, to] = getFloatingPointValueRange(value);\n  return `${valueSelector} ${operator === \"is-not-equal\" ? \"NOT \" : \"\"} BETWEEN ${from} AND ${to}`;\n}\n\nfunction getFloatingPointValueRange(value: number): [number, number] {\n  return [value - Number.EPSILON, value + Number.EPSILON];\n}\n\nfunction getECSqlLogicalOperator(op: GenericInstanceFilterRuleGroupOperator) {\n  switch (op) {\n    case \"and\":\n      return \"AND\";\n    case \"or\":\n      return \"OR\";\n  }\n}\n\nfunction isUnaryRuleOperator(\n  op: GenericInstanceFilterRuleOperator,\n): op is Extract<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\"> {\n  return op === \"is-true\" || op === \"is-false\" || op === \"is-null\" || op === \"is-not-null\";\n}\n\nfunction getECSqlComparisonOperator(op: Exclude<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\">) {\n  switch (op) {\n    case \"is-equal\":\n      return `=`;\n    case \"is-not-equal\":\n      return `<>`;\n    case \"greater\":\n      return `>`;\n    case \"greater-or-equal\":\n      return `>=`;\n    case \"less\":\n      return `<`;\n    case \"less-or-equal\":\n      return `<=`;\n    case \"like\":\n      return `LIKE`;\n  }\n}\n\ntype JoinRelationshipPath = Parameters<typeof ECSql.createRelationshipPathJoinClause>[0][\"path\"];\nfunction assignRelationshipPathAliases(\n  path: GenericInstanceFilterRelationshipStep[],\n  pathIndex: number,\n  sourceAlias: string,\n  targetAlias: string,\n): JoinRelationshipPath {\n  function createAlias(fullClassName: string, index: number) {\n    return `rel_${pathIndex}_${fullClassName.replaceAll(/[\\.:]/g, \"_\")}_${index}`;\n  }\n  const result: JoinRelationshipPath = [];\n  path.forEach((step, i) => {\n    result.push({\n      targetClassName: step.targetClassName,\n      relationshipName: step.relationshipClassName,\n      sourceClassName: step.sourceClassName,\n      relationshipReverse: !step.isForwardRelationship,\n      sourceAlias: i === 0 ? sourceAlias : result[i - 1].targetAlias,\n      relationshipAlias: createAlias(step.relationshipClassName, i),\n      targetAlias: i === path.length - 1 ? targetAlias : createAlias(step.targetClassName, i),\n      joinType: \"inner\",\n    });\n  });\n  return result;\n}\n\ninterface SpecializeContentClassProps {\n  classHierarchyInspector: ECClassHierarchyInspector;\n  contentClassName: string;\n  filterClassNames: string[];\n}\nasync function specializeContentClass(props: SpecializeContentClassProps): Promise<string | undefined> {\n  const filterClass = await getSpecializedPropertyClass(props.classHierarchyInspector, props.filterClassNames);\n  if (!filterClass) {\n    return props.contentClassName;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(filterClass, props.contentClassName)) {\n    return filterClass;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(props.contentClassName, filterClass)) {\n    return props.contentClassName;\n  }\n  return undefined;\n}\n\nasync function getSpecializedPropertyClass(classHierarchyInspector: ECClassHierarchyInspector, classes: string[]): Promise<string | undefined> {\n  if (classes.length === 0) {\n    return undefined;\n  }\n  const [currClassName, ...restClasses] = classes;\n  let resolvedClassName = currClassName;\n  for (const propClassName of restClasses) {\n    if (await classHierarchyInspector.classDerivesFrom(propClassName, resolvedClassName)) {\n      resolvedClassName = propClassName;\n    }\n  }\n  return resolvedClassName;\n}\n"]}

package/lib/esm/hierarchies/internal/ChildNodeObservablesCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChildNodeObservablesCache.d.ts","sourceRoot":"","sources":["../../../../src/hierarchies/internal/ChildNodeObservablesCache.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAyB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,gBAAgB;AAChB,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAEzE,gBAAgB;AAChB,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAE1E,gBAAgB;AAChB,MAAM,MAAM,0BAA0B,GAClC;IAAE,UAAU,EAAE,0BAA0B,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,UAAU,EAAE,wBAAwB,CAAC;IAAC,gBAAgB,EAAE,eAAe,CAAA;CAAE,CAAC;AAEhF,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,4GAA4G;IAC5G,OAAO,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAChD,qHAAqH;IACrH,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAC1D;AAED,gBAAgB;AAChB,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,qBAAa,yBAAyB;IACpC,OAAO,CAAC,IAAI,CAA0D;IACtE,OAAO,CAAC,MAAM,CAAiC;gBAE5B,KAAK,EAAE,8BAA8B;IAKxD,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,iBAAiB;IAyBlB,GAAG,CAAC,YAAY,EAAE,sBAAsB,EAAE,KAAK,EAAE,0BAA0B;IAK3E,GAAG,CAAC,YAAY,EAAE,sBAAsB,GAAG,0BAA0B,GAAG,SAAS;IAKjF,KAAK;CAGb"}
+{"version":3,"file":"ChildNodeObservablesCache.d.ts","sourceRoot":"","sources":["../../../../src/hierarchies/internal/ChildNodeObservablesCache.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAyB,MAAM,qBAAqB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,gBAAgB;AAChB,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAEzE,gBAAgB;AAChB,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAE1E,gBAAgB;AAChB,MAAM,MAAM,0BAA0B,GAClC;IAAE,UAAU,EAAE,0BAA0B,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,UAAU,EAAE,wBAAwB,CAAC;IAAC,gBAAgB,EAAE,eAAe,CAAA;CAAE,CAAC;AAEhF,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,4GAA4G;IAC5G,OAAO,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAChD,qHAAqH;IACrH,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAC1D;AAED,gBAAgB;AAChB,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,qBAAa,yBAAyB;IACpC,OAAO,CAAC,IAAI,CAA0D;IACtE,OAAO,CAAC,MAAM,CAAiC;gBAE5B,KAAK,EAAE,8BAA8B;IAKxD,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,iBAAiB;IAyBlB,GAAG,CAAC,YAAY,EAAE,sBAAsB,EAAE,KAAK,EAAE,0BAA0B;IAK3E,GAAG,CAAC,YAAY,EAAE,sBAAsB,GAAG,0BAA0B,GAAG,SAAS;IAKjF,KAAK;CAGb"}

package/lib/esm/hierarchies/internal/ChildNodeObservablesCache.js

@@ -14,11 +14,11 @@ export class ChildNodeObservablesCache {
     }
     createCacheKeys(props) {
         function createVariationKey() {
-            const { instanceFilter, hierarchyLevelSizeLimit } = props;
-            if (instanceFilter === undefined && hierarchyLevelSizeLimit === undefined) {
+            const { instanceFilter, hierarchyLevelSizeLimit, filteredInstanceKeys } = props;
+            if (instanceFilter === undefined && hierarchyLevelSizeLimit === undefined && filteredInstanceKeys === undefined) {
                 return undefined;
             }
-            return JSON.stringify({ instanceFilter, hierarchyLevelSizeLimit });
+            return JSON.stringify({ instanceFilter, hierarchyLevelSizeLimit, filteredInstanceKeys });
         }
         if (!props.parentNode) {
             return { primaryKey: [], variationKey: createVariationKey() };

package/lib/esm/hierarchies/internal/ChildNodeObservablesCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChildNodeObservablesCache.js","sourceRoot":"","sources":["../../../../src/hierarchies/internal/ChildNodeObservablesCache.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 { Observable } from \"rxjs\";\nimport { LRUCache, LRUDictionary, LRUMap } from \"@itwin/core-bentley\";\nimport { ParsedHierarchyNode, ProcessedHierarchyNode } from \"../HierarchyNode\";\nimport { HierarchyNodeKey } from \"../HierarchyNodeKey\";\nimport { GetHierarchyNodesProps } from \"../HierarchyProvider\";\n\n/** @internal */\nexport type ParsedQueryNodesObservable = Observable<ParsedHierarchyNode>;\n\n/** @internal */\nexport type ProcessedNodesObservable = Observable<ProcessedHierarchyNode>;\n\n/** @internal */\nexport type CachedNodesObservableEntry =\n  | { observable: ParsedQueryNodesObservable; processingStatus: \"none\" }\n  | { observable: ProcessedNodesObservable; processingStatus: \"pre-processed\" };\n\n/** @internal */\nexport interface ChildNodesCacheEntry {\n  /** Stores observables for the default case - no instance filter or custom limit for the hierarchy level. */\n  primary: CachedNodesObservableEntry | undefined;\n  /** Stores a limited number of variations with custom instance filter and/or custom limit for the hierarchy level. */\n  variations: LRUCache<string, CachedNodesObservableEntry>;\n}\n\n/** @internal */\nexport interface ChildNodeObservablesCacheProps {\n  size: number;\n  variationsCount?: number;\n}\n\n/** @internal */\nexport class ChildNodeObservablesCache {\n  private _map: LRUDictionary<HierarchyNodeKey[], ChildNodesCacheEntry>;\n  private _props: ChildNodeObservablesCacheProps;\n\n  public constructor(props: ChildNodeObservablesCacheProps) {\n    this._props = props;\n    this._map = new LRUDictionary<HierarchyNodeKey[], ChildNodesCacheEntry>(props.size, compareHierarchyNodeKeys);\n  }\n\n  private createCacheKeys(\n    props: Omit<GetHierarchyNodesProps, \"parentNode\"> & { parentNode: { key: HierarchyNodeKey; parentKeys: HierarchyNodeKey[] } | undefined },\n  ) {\n    function createVariationKey() {\n      const { instanceFilter, hierarchyLevelSizeLimit } = props;\n      if (instanceFilter === undefined && hierarchyLevelSizeLimit === undefined) {\n        return undefined;\n      }\n      return JSON.stringify({ instanceFilter, hierarchyLevelSizeLimit });\n    }\n\n    if (!props.parentNode) {\n      return { primaryKey: [], variationKey: createVariationKey() };\n    }\n\n    const parentKeys = props.parentNode.parentKeys;\n\n    return {\n      primaryKey: [...parentKeys, props.parentNode.key],\n      variationKey: createVariationKey(),\n    };\n  }\n\n  private getCacheAccessors(primaryKey: HierarchyNodeKey[], variationKey?: string) {\n    const getMapEntry = (create: boolean) => {\n      let entry = this._map.get(primaryKey);\n      if (!entry && create) {\n        entry = { primary: undefined, variations: new LRUMap(this._props.variationsCount ?? 1) };\n        this._map.set(primaryKey, entry);\n      }\n      return entry;\n    };\n    if (variationKey) {\n      return {\n        get: () => getMapEntry(false)?.variations.get(variationKey),\n        set: (value: CachedNodesObservableEntry) => {\n          getMapEntry(true)!.variations.set(variationKey, value);\n        },\n      };\n    }\n    return {\n      get: () => getMapEntry(false)?.primary,\n      set: (value: CachedNodesObservableEntry) => {\n        getMapEntry(true)!.primary = value;\n      },\n    };\n  }\n\n  public set(requestProps: GetHierarchyNodesProps, value: CachedNodesObservableEntry) {\n    const { primaryKey, variationKey } = this.createCacheKeys(requestProps);\n    this.getCacheAccessors(primaryKey, variationKey).set(value);\n  }\n\n  public get(requestProps: GetHierarchyNodesProps): CachedNodesObservableEntry | undefined {\n    const { primaryKey, variationKey } = this.createCacheKeys(requestProps);\n    return this.getCacheAccessors(primaryKey, variationKey).get();\n  }\n\n  public clear() {\n    this._map.clear();\n  }\n}\n\nfunction compareHierarchyNodeKeys(lhs: HierarchyNodeKey[], rhs: HierarchyNodeKey[]) {\n  if (lhs.length !== rhs.length) {\n    return lhs.length - rhs.length;\n  }\n  for (let i = 0; i < lhs.length; ++i) {\n    const keysCompareResult = HierarchyNodeKey.compare(lhs[i], rhs[i]);\n    if (keysCompareResult !== 0) {\n      return keysCompareResult;\n    }\n  }\n  return 0;\n}\n"]}
+{"version":3,"file":"ChildNodeObservablesCache.js","sourceRoot":"","sources":["../../../../src/hierarchies/internal/ChildNodeObservablesCache.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 { Observable } from \"rxjs\";\nimport { LRUCache, LRUDictionary, LRUMap } from \"@itwin/core-bentley\";\nimport { InstanceKey } from \"@itwin/presentation-shared\";\nimport { ParsedHierarchyNode, ProcessedHierarchyNode } from \"../HierarchyNode\";\nimport { HierarchyNodeKey } from \"../HierarchyNodeKey\";\nimport { GetHierarchyNodesProps } from \"../HierarchyProvider\";\n\n/** @internal */\nexport type ParsedQueryNodesObservable = Observable<ParsedHierarchyNode>;\n\n/** @internal */\nexport type ProcessedNodesObservable = Observable<ProcessedHierarchyNode>;\n\n/** @internal */\nexport type CachedNodesObservableEntry =\n  | { observable: ParsedQueryNodesObservable; processingStatus: \"none\" }\n  | { observable: ProcessedNodesObservable; processingStatus: \"pre-processed\" };\n\n/** @internal */\nexport interface ChildNodesCacheEntry {\n  /** Stores observables for the default case - no instance filter or custom limit for the hierarchy level. */\n  primary: CachedNodesObservableEntry | undefined;\n  /** Stores a limited number of variations with custom instance filter and/or custom limit for the hierarchy level. */\n  variations: LRUCache<string, CachedNodesObservableEntry>;\n}\n\n/** @internal */\nexport interface ChildNodeObservablesCacheProps {\n  size: number;\n  variationsCount?: number;\n}\n\n/** @internal */\nexport class ChildNodeObservablesCache {\n  private _map: LRUDictionary<HierarchyNodeKey[], ChildNodesCacheEntry>;\n  private _props: ChildNodeObservablesCacheProps;\n\n  public constructor(props: ChildNodeObservablesCacheProps) {\n    this._props = props;\n    this._map = new LRUDictionary<HierarchyNodeKey[], ChildNodesCacheEntry>(props.size, compareHierarchyNodeKeys);\n  }\n\n  private createCacheKeys(\n    props: Omit<GetHierarchyNodesProps, \"parentNode\"> & {\n      parentNode: { key: HierarchyNodeKey; parentKeys: HierarchyNodeKey[] } | undefined;\n      filteredInstanceKeys?: InstanceKey[];\n    },\n  ) {\n    function createVariationKey() {\n      const { instanceFilter, hierarchyLevelSizeLimit, filteredInstanceKeys } = props;\n      if (instanceFilter === undefined && hierarchyLevelSizeLimit === undefined && filteredInstanceKeys === undefined) {\n        return undefined;\n      }\n      return JSON.stringify({ instanceFilter, hierarchyLevelSizeLimit, filteredInstanceKeys });\n    }\n\n    if (!props.parentNode) {\n      return { primaryKey: [], variationKey: createVariationKey() };\n    }\n\n    const parentKeys = props.parentNode.parentKeys;\n\n    return {\n      primaryKey: [...parentKeys, props.parentNode.key],\n      variationKey: createVariationKey(),\n    };\n  }\n\n  private getCacheAccessors(primaryKey: HierarchyNodeKey[], variationKey?: string) {\n    const getMapEntry = (create: boolean) => {\n      let entry = this._map.get(primaryKey);\n      if (!entry && create) {\n        entry = { primary: undefined, variations: new LRUMap(this._props.variationsCount ?? 1) };\n        this._map.set(primaryKey, entry);\n      }\n      return entry;\n    };\n    if (variationKey) {\n      return {\n        get: () => getMapEntry(false)?.variations.get(variationKey),\n        set: (value: CachedNodesObservableEntry) => {\n          getMapEntry(true)!.variations.set(variationKey, value);\n        },\n      };\n    }\n    return {\n      get: () => getMapEntry(false)?.primary,\n      set: (value: CachedNodesObservableEntry) => {\n        getMapEntry(true)!.primary = value;\n      },\n    };\n  }\n\n  public set(requestProps: GetHierarchyNodesProps, value: CachedNodesObservableEntry) {\n    const { primaryKey, variationKey } = this.createCacheKeys(requestProps);\n    this.getCacheAccessors(primaryKey, variationKey).set(value);\n  }\n\n  public get(requestProps: GetHierarchyNodesProps): CachedNodesObservableEntry | undefined {\n    const { primaryKey, variationKey } = this.createCacheKeys(requestProps);\n    return this.getCacheAccessors(primaryKey, variationKey).get();\n  }\n\n  public clear() {\n    this._map.clear();\n  }\n}\n\nfunction compareHierarchyNodeKeys(lhs: HierarchyNodeKey[], rhs: HierarchyNodeKey[]) {\n  if (lhs.length !== rhs.length) {\n    return lhs.length - rhs.length;\n  }\n  for (let i = 0; i < lhs.length; ++i) {\n    const keysCompareResult = HierarchyNodeKey.compare(lhs[i], rhs[i]);\n    if (keysCompareResult !== 0) {\n      return keysCompareResult;\n    }\n  }\n  return 0;\n}\n"]}

package/lib/esm/hierarchies/internal/Common.d.ts

@@ -1,6 +1,30 @@
 import { HierarchyNode, ParentHierarchyNode, ParsedHierarchyNode, ProcessedCustomHierarchyNode, ProcessedInstanceHierarchyNode } from "../HierarchyNode";
-/** @internal */
+/**
+ * This is a logging namespace for public log messages that may be interesting to consumers.
+ * @internal
+ */
 export declare const LOGGING_NAMESPACE = "Presentation.Hierarchies";
+/**
+ * This is a logging namespace for public performance-related log messages that may be interesting to consumers.
+ * @internal
+ */
+export declare const LOGGING_NAMESPACE_PERFORMANCE = "Presentation.Hierarchies.Performance";
+/**
+ * This is a logging namespace for internal log messages that are only interesting to package contributors,
+ * but not the consumers.
+ * @internal
+ */
+export declare const LOGGING_NAMESPACE_INTERNAL = "Presentation.HierarchiesInternal";
+/**
+ * This is a logging namespace for internal performance-related log messages that are only interesting
+ * to package contributors, but not the consumers.
+ * @internal
+ */
+export declare const LOGGING_NAMESPACE_PERFORMANCE_INTERNAL = "Presentation.HierarchiesInternal.Performance";
+/** @internal */
+export declare function createOperatorLoggingNamespace(operatorName: string, baseCategory?: typeof LOGGING_NAMESPACE | typeof LOGGING_NAMESPACE_PERFORMANCE | typeof LOGGING_NAMESPACE_INTERNAL | typeof LOGGING_NAMESPACE_PERFORMANCE_INTERNAL): string;
+/** @internal */
+export declare function createNodeIdentifierForLogging(node: ParentHierarchyNode | HierarchyNode | ParsedHierarchyNode | undefined): string;
 /** @internal */
 export declare function mergeNodes<TNode extends ProcessedCustomHierarchyNode | ProcessedInstanceHierarchyNode>(lhs: TNode, rhs: TNode): TNode;
 /** @internal */
@@ -8,13 +32,9 @@ export declare function hasChildren<TNode extends {
     children?: boolean | Array<unknown>;
 }>(node: TNode): boolean;
 /** @internal */
-export declare function createOperatorLoggingNamespace(operatorName: string): string;
-/** @internal */
 export declare function compareNodesByLabel<TLhsNode extends {
     label: string;
 }, TRhsNode extends {
     label: string;
 }>(lhs: TLhsNode, rhs: TRhsNode): number;
-/** @internal */
-export declare function createNodeIdentifierForLogging(node: ParentHierarchyNode | HierarchyNode | ParsedHierarchyNode | undefined): string;
 //# sourceMappingURL=Common.d.ts.map

package/lib/esm/hierarchies/internal/Common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Common.d.ts","sourceRoot":"","sources":["../../../../src/hierarchies/internal/Common.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,aAAa,EAGb,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,kBAAkB,CAAC;AAG1B,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAuD5D,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,KAAK,SAAS,4BAA4B,GAAG,8BAA8B,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,CAkBrI;AAED,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,KAAK,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;CAAE,EAAE,IAAI,EAAE,KAAK,WAE7F;AAED,gBAAgB;AAChB,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,UAElE;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEhJ;AAED,gBAAgB;AAEhB,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,GAAG,mBAAmB,GAAG,SAAS,UAOzH"}
+{"version":3,"file":"Common.d.ts","sourceRoot":"","sources":["../../../../src/hierarchies/internal/Common.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,aAAa,EAGb,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,6BAA6B,yCAAqC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,iDAA8C,CAAC;AAElG,gBAAgB;AAChB,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,EACpB,YAAY,GACR,OAAO,iBAAiB,GACxB,OAAO,6BAA6B,GACpC,OAAO,0BAA0B,GACjC,OAAO,sCAA0D,UAGtE;AAED,gBAAgB;AAEhB,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,GAAG,mBAAmB,GAAG,SAAS,UAOzH;AAuDD,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,KAAK,SAAS,4BAA4B,GAAG,8BAA8B,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,CAkBrI;AAED,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,KAAK,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;CAAE,EAAE,IAAI,EAAE,KAAK,WAE7F;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEhJ"}