@itwin/presentation-hierarchies 2.0.0-alpha.16 → 2.0.0-alpha.18

package/lib/{esm/hierarchies → hierarchies}/imodel/NodeSelectQueryFactory.js

@@ -4,7 +4,7 @@
  *--------------------------------------------------------------------------------------------*/
 import { assert } from "@itwin/core-bentley";
 import { GenericInstanceFilter, GenericInstanceFilterRuleValue } from "@itwin/core-common";
-import { compareFullClassNames, ECSql, getClass, normalizeFullClassName, parseFullClassName, PrimitiveValue, } from "@itwin/presentation-shared";
+import { ECSql, getClass, normalizeFullClassName, parseFullClassName, PrimitiveValue, } from "@itwin/presentation-shared";
 /**
  * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns
  * created by the factory.
@@ -13,7 +13,7 @@ import { compareFullClassNames, ECSql, getClass, normalizeFullClassName, parseFu
  */
 export var NodeSelectClauseColumnNames;
 (function (NodeSelectClauseColumnNames) {
-    /** Full class name of the instance the node represents. Type: `string` in format `{schema name}:{class name}`. */
+    /** Full class name of the instance the node represents. Type: `string` in format `{schema name}.{class name}`. */
     NodeSelectClauseColumnNames["FullClassName"] = "FullClassName";
     /** ECInstance ID of the instance the node represents. Type: `Id64String`. */
     NodeSelectClauseColumnNames["ECInstanceId"] = "ECInstanceId";
@@ -41,6 +41,10 @@ export var NodeSelectClauseColumnNames;
 })(NodeSelectClauseColumnNames || (NodeSelectClauseColumnNames = {}));
 /**
  * Creates an instance of `NodeSelectQueryFactory`.
+ *
+ * The created factory caches metadata derived from the iModel's schemas (e.g. the tree of hidden classes for a
+ * given select class). The cache lives for the lifetime of the factory and is not invalidated automatically, so
+ * the factory must be re-created when the iModel's schemas may have changed.
  */
 export function createNodesQueryClauseFactory(props) {
     return new NodeSelectQueryFactory(props);
@@ -49,6 +53,7 @@ export function createNodesQueryClauseFactory(props) {
 class NodeSelectQueryFactory {
     _imodelAccess;
     _instanceLabelSelectClauseFactory;
+    _hiddenClassesTreeCache = new Map();
     constructor(props) {
         this._imodelAccess = props.imodelAccess;
         this._instanceLabelSelectClauseFactory = props.instanceLabelSelectClauseFactory;
@@ -57,7 +62,7 @@ class NodeSelectQueryFactory {
     async createSelectClause(props) {
         // note: the columns order must match the order in `NodeSelectClauseColumnNames`
         return `
-      ec_ClassName(${props.ecClassId.selector}) AS ${NodeSelectClauseColumnNames.FullClassName},
+      ec_ClassName(${props.ecClassId.selector}, 's.c') AS ${NodeSelectClauseColumnNames.FullClassName},
       ${props.ecInstanceId.selector} AS ${NodeSelectClauseColumnNames.ECInstanceId},
       ${createECSqlValueSelector(typeof props.nodeLabel === "object" && "of" in props.nodeLabel
             ? { selector: await this._instanceLabelSelectClauseFactory.createSelectClause(props.nodeLabel.of) }
@@ -92,8 +97,20 @@ class NodeSelectQueryFactory {
         const { from, joins, where } = filter
             ? await createInstanceFilterClauses({ imodelAccess: this._imodelAccess, contentClass, filter })
             : { from: contentClass.fullName, joins: [], where: [] };
-        const fromClass = await getClass(this._imodelAccess, normalizeFullClassName(from));
-        const hiddenClasses = await getHiddenClassesTree(fromClass);
+        const normalizedFrom = normalizeFullClassName(from);
+        const fromClass = await getClass(this._imodelAccess, normalizedFrom);
+        // The hidden-classes tree depends only on the select class and the (static) schema metadata, but it is
+        // expensive to compute (it recursively walks the whole derived-class subtree). The same select classes
+        // recur across every hierarchy level, so memoize the result per class for the lifetime of this factory.
+        let hiddenClassesPromise = this._hiddenClassesTreeCache.get(normalizedFrom);
+        if (!hiddenClassesPromise) {
+            hiddenClassesPromise = getHiddenClassesTree(this._imodelAccess, fromClass);
+            // Don't keep a rejected result cached - drop it so a later call can retry. Until this handler runs, the
+            // entry stays this same promise (concurrent calls get a cache hit), so an unconditional delete is safe.
+            hiddenClassesPromise.catch(() => this._hiddenClassesTreeCache.delete(normalizedFrom));
+            this._hiddenClassesTreeCache.set(normalizedFrom, hiddenClassesPromise);
+        }
+        const hiddenClasses = await hiddenClassesPromise;
         const hiddenClassesWhereClause = createWhereClauseForHiddenClasses(hiddenClasses, contentClass.alias);
         hiddenClassesWhereClause.hideClause && where.push(hiddenClassesWhereClause.hideClause);
         assert(!hiddenClassesWhereClause.showClause, "`showClause` is expected to always be empty here");
@@ -302,15 +319,15 @@ function createLabelGroupingBaseParamsSelectors(byLabel) {
 async function createPropertyGroupSelectors(propertyGroup, propertyClass, instanceLabelSelectClauseFactory) {
     const selectors = new Array();
     selectors.push({ key: "propertyName", selector: `${createECSqlValueSelector(propertyGroup.propertyName)}` });
-    const property = await propertyClass.getProperty(propertyGroup.propertyName);
+    const property = propertyClass.getProperty(propertyGroup.propertyName);
     if (!property) {
         throw new Error(`Property "${propertyGroup.propertyName}" not found in ECClass "${propertyClass.fullName}".`);
     }
     if (property.isNavigation()) {
-        const relationshipClass = await property.relationshipClass;
+        const relationshipClass = property.relationshipClass;
         const abstractConstraint = property.direction === "Forward"
-            ? await relationshipClass.target.abstractConstraint
-            : await relationshipClass.source.abstractConstraint;
+            ? relationshipClass.target.abstractConstraint
+            : relationshipClass.source.abstractConstraint;
         // TODO: MISSING_COVERAGE
         /* v8 ignore else -- @preserve */
         if (!abstractConstraint) {
@@ -380,7 +397,7 @@ async function createWhereClause(contentClassAlias, classLoader, rule) {
     if (!propertyClass) {
         throw new Error(`Class with alias "${sourceAlias}" not found.`);
     }
-    const property = await propertyClass.getProperty(rule.propertyName);
+    const property = propertyClass.getProperty(rule.propertyName);
     if (!property) {
         throw new Error(`Property "${rule.propertyName}" not found in ECClass "${propertyClass.fullName}".`);
     }
@@ -534,45 +551,65 @@ async function getSpecializedPropertyClass(classHierarchyInspector, classes) {
     }
     return resolvedClassName;
 }
-async function getHiddenClassesTree(selectClass, selectClassAttribute = "show") {
-    const derivedClasses = await getDirectDerivedClasses(selectClass);
-    const derivedClassSchemas = derivedClasses.reduce((acc, ecClass) => {
-        /* v8 ignore else -- @preserve */
-        if (!acc.set.has(ecClass.schema.name)) {
-            acc.schemas.push(ecClass.schema);
-            acc.set.add(ecClass.schema.name);
+async function getHiddenClassesTree(schemaProvider, selectClass, selectClassAttribute = "show") {
+    const derivedClassNames = selectClass.getDerivedClassNames({ onlyDirect: true });
+    const derivedClassNamesBySchema = derivedClassNames.reduce((acc, fullClassName) => {
+        const { schemaName, className } = parseFullClassName(fullClassName);
+        let entry = acc.get(schemaName);
+        if (!entry) {
+            entry = [];
+            acc.set(schemaName, entry);
         }
+        entry.push(className);
         return acc;
-    }, { set: new Set(), schemas: new Array() }).schemas;
-    const hiddenSchemas = new Map();
-    await Promise.all(derivedClassSchemas.map(async (ecSchema) => {
-        hiddenSchemas.set(ecSchema.name, await getHiddenSchemaAttribute(ecSchema));
+    }, new Map());
+    const derivedClassesBySchema = await Promise.all([...derivedClassNamesBySchema.entries()].map(async ([schemaName, classNames]) => {
+        const schema = await schemaProvider.getSchema(schemaName);
+        /* v8 ignore next 3 -- @preserve */
+        if (!schema) {
+            throw new Error(`Schema "${schemaName}" not found.`);
+        }
+        return {
+            schema,
+            classes: classNames.map((className) => {
+                const lookupClass = schema.getClass(className);
+                /* v8 ignore next 3 -- @preserve */
+                if (!lookupClass) {
+                    throw new Error(`Class "${className}" not found in schema "${schemaName}".`);
+                }
+                return lookupClass;
+            }),
+        };
     }));
-    const tree = (await Promise.all(derivedClasses.map(async (ecClass) => {
-        const hiddenClassAttr = await getHiddenClassAttribute(ecClass);
+    const hiddenSchemas = new Map();
+    for (const { schema } of derivedClassesBySchema) {
+        hiddenSchemas.set(schema.name, schema.isHidden ? "hide" : undefined);
+    }
+    return Promise.all(derivedClassesBySchema
+        .flatMap(({ classes }) => classes)
+        .map(async (ecClass) => {
+        const hiddenClassAttr = (() => {
+            switch (ecClass.isHidden) {
+                case true:
+                    return "hide";
+                case false:
+                    return "show";
+                default:
+                    return undefined;
+            }
+        })();
         const attr = hiddenClassAttr ?? hiddenSchemas.get(ecClass.schema.name);
         if (!attr || attr === selectClassAttribute) {
-            return getHiddenClassesTree(ecClass, selectClassAttribute);
+            return getHiddenClassesTree(schemaProvider, ecClass, selectClassAttribute);
         }
-        return [{ fullName: ecClass.fullName, state: attr, children: await getHiddenClassesTree(ecClass, attr) }];
-    }))).flat();
-    return tree;
-}
-async function getDirectDerivedClasses(ecClass) {
-    const allDerived = await ecClass.getDerivedClasses();
-    return (await Promise.all(allDerived.map(async (c) => ({ derived: c, base: await c.baseClass }))))
-        .filter(({ base }) => base && compareFullClassNames(base.fullName, ecClass.fullName) === 0)
-        .map(({ derived }) => derived);
-}
-async function getHiddenClassAttribute(ecClass) {
-    const customAttributes = await ecClass.getCustomAttributes();
-    const hiddenClassAttribute = customAttributes.get("CoreCustomAttributes.HiddenClass");
-    return hiddenClassAttribute ? (hiddenClassAttribute.Show ? "show" : "hide") : undefined;
-}
-async function getHiddenSchemaAttribute(ecSchema) {
-    const customAttributes = await ecSchema.getCustomAttributes();
-    const hiddenSchemaAttribute = customAttributes.get("CoreCustomAttributes.HiddenSchema");
-    return hiddenSchemaAttribute ? (hiddenSchemaAttribute.ShowClasses ? "show" : "hide") : undefined;
+        return [
+            {
+                fullName: ecClass.fullName,
+                state: attr,
+                children: await getHiddenClassesTree(schemaProvider, ecClass, attr),
+            },
+        ];
+    })).then((results) => results.flat());
 }
 function createWhereClauseForHiddenClasses(hiddenClasses, selectAlias) {
     const res = {};

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSelectQueryFactory.js","sourceRoot":"","sources":["../../../src/hierarchies/imodel/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 } from \"@itwin/core-bentley\";\nimport { GenericInstanceFilter, GenericInstanceFilterRuleValue } from \"@itwin/core-common\";\nimport {\n  ECSql,\n  getClass,\n  normalizeFullClassName,\n  parseFullClassName,\n  PrimitiveValue,\n} from \"@itwin/presentation-shared\";\n\nimport type { Id64String } from \"@itwin/core-bentley\";\nimport type {\n  GenericInstanceFilterRelationshipStep,\n  GenericInstanceFilterRule,\n  GenericInstanceFilterRuleGroup,\n  GenericInstanceFilterRuleGroupOperator,\n  GenericInstanceFilterRuleOperator,\n} from \"@itwin/core-common\";\nimport type { EC, ECSchemaProvider, IInstanceLabelSelectClauseFactory, Props } from \"@itwin/presentation-shared\";\nimport type { HierarchyNodeAutoExpandProp } from \"./IModelHierarchyNode.js\";\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 * @public\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 * @public\n */\ninterface ECSqlValueSelector {\n  selector: string;\n}\n\n/**\n * Props for `NodeSelectClauseFactory.createSelectClause`.\n * @public\n */\ninterface NodeSelectClauseProps {\n  ecClassId: ECSqlValueSelector;\n  ecInstanceId: ECSqlValueSelector;\n  nodeLabel: string | ECSqlValueSelector | { of: Props<IInstanceLabelSelectClauseFactory[\"createSelectClause\"]> };\n  extendedData?: { [key: string]: Id64String | string | number | boolean | ECSqlValueSelector };\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 * @public\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 * @public\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 * @public\n */\ninterface ECSqlSelectClauseLabelGroupingMergeParams extends ECSqlSelectClauseLabelGroupingBaseParams {\n  action: \"merge\";\n}\n\n/**\n * A data structure for defining label grouping.\n * @public\n */\ninterface ECSqlSelectClauseLabelGroupingGroupParams\n  extends ECSqlSelectClauseLabelGroupingBaseParams, ECSqlSelectClauseGroupingParamsBase {\n  action?: \"group\";\n}\n\n/**\n * A data structure for defining possible label grouping types.\n * @public\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 * @public\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 * @public\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: EC.FullClassNameDotNotation;\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 * @public\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 * @public\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 * @public\n */\ninterface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  fullClassNames: EC.FullClassNameDotNotation[] | ECSqlValueSelector[];\n}\n\n/**\n * An interface of a factory that knows how to create nodes' select ECSQL query.\n * @public\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 OR referenced schema items (classes/properties)\n   * don't exist in the iModel, a special result is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  createFilterClauses(props: {\n    contentClass: { fullName: EC.FullClassNameDotNotation; alias: string };\n    filter?: GenericInstanceFilter;\n  }): Promise<{ from: string; where: string; joins: string }>;\n}\n\n/**\n * Creates an instance of `NodeSelectQueryFactory`.\n *\n * The created factory caches metadata derived from the iModel's schemas (e.g. the tree of hidden classes for a\n * given select class). The cache lives for the lifetime of the factory and is not invalidated automatically, so\n * the factory must be re-created when the iModel's schemas may have changed.\n */\nexport function createNodesQueryClauseFactory(props: {\n  imodelAccess: ECSchemaProvider;\n  instanceLabelSelectClauseFactory: IInstanceLabelSelectClauseFactory;\n}): NodesQueryClauseFactory {\n  return new NodeSelectQueryFactory(props);\n}\n\n/** A factory for creating a nodes' select ECSQL query. */\nclass NodeSelectQueryFactory {\n  private _imodelAccess: ECSchemaProvider;\n  private _instanceLabelSelectClauseFactory: IInstanceLabelSelectClauseFactory;\n  private _hiddenClassesTreeCache = new Map<string, Promise<HiddenClassNode[]>>();\n\n  public constructor(props: {\n    imodelAccess: ECSchemaProvider;\n    instanceLabelSelectClauseFactory: IInstanceLabelSelectClauseFactory;\n  }) {\n    this._imodelAccess = props.imodelAccess;\n    this._instanceLabelSelectClauseFactory = props.instanceLabelSelectClauseFactory;\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}, 's.c') AS ${NodeSelectClauseColumnNames.FullClassName},\n      ${props.ecInstanceId.selector} AS ${NodeSelectClauseColumnNames.ECInstanceId},\n      ${createECSqlValueSelector(\n        typeof props.nodeLabel === \"object\" && \"of\" in props.nodeLabel\n          ? { selector: await this._instanceLabelSelectClauseFactory.createSelectClause(props.nodeLabel.of) }\n          : props.nodeLabel,\n      )} 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 ? await createGroupingSelector(props.grouping, this._imodelAccess, this._instanceLabelSelectClauseFactory) : \"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 OR referenced schema items (classes/properties)\n   * don't exist in the iModel, a special result is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  public async createFilterClauses(props: {\n    contentClass: { fullName: EC.FullClassNameDotNotation; alias: string };\n    filter?: GenericInstanceFilter;\n  }): Promise<{ from: string; where: string; joins: string }> {\n    const { contentClass, filter } = props;\n    const { from, joins, where } = filter\n      ? await createInstanceFilterClauses({ imodelAccess: this._imodelAccess, contentClass, filter })\n      : { from: contentClass.fullName, joins: [], where: [] };\n\n    const normalizedFrom = normalizeFullClassName(from);\n    const fromClass = await getClass(this._imodelAccess, normalizedFrom);\n    // The hidden-classes tree depends only on the select class and the (static) schema metadata, but it is\n    // expensive to compute (it recursively walks the whole derived-class subtree). The same select classes\n    // recur across every hierarchy level, so memoize the result per class for the lifetime of this factory.\n    let hiddenClassesPromise = this._hiddenClassesTreeCache.get(normalizedFrom);\n    if (!hiddenClassesPromise) {\n      hiddenClassesPromise = getHiddenClassesTree(this._imodelAccess, fromClass);\n      // Don't keep a rejected result cached - drop it so a later call can retry. Until this handler runs, the\n      // entry stays this same promise (concurrent calls get a cache hit), so an unconditional delete is safe.\n      hiddenClassesPromise.catch(() => this._hiddenClassesTreeCache.delete(normalizedFrom));\n      this._hiddenClassesTreeCache.set(normalizedFrom, hiddenClassesPromise);\n    }\n    const hiddenClasses = await hiddenClassesPromise;\n    const hiddenClassesWhereClause = createWhereClauseForHiddenClasses(hiddenClasses, contentClass.alias);\n    hiddenClassesWhereClause.hideClause && where.push(hiddenClassesWhereClause.hideClause);\n    assert(!hiddenClassesWhereClause.showClause, \"`showClause` is expected to always be empty here\");\n\n    return { from, joins: joins.join(\"\\n\"), where: where.join(\" AND \") };\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 */\nasync function createInstanceFilterClauses(props: {\n  imodelAccess: ECSchemaProvider;\n  contentClass: { fullName: EC.FullClassNameDotNotation; alias: string };\n  filter: GenericInstanceFilter;\n}): Promise<{ from: EC.FullClassNameDotNotation; where: string[]; joins: string[] }> {\n  const { imodelAccess, contentClass, filter } = props;\n\n  // In some cases the given filter means we want the query to return nothing - e.g. when filtering by classes that don't intersect\n  // with the given content class. Return a special result that makes sure the resulting query is valid, but returns no rows.\n  const DISABLE_QUERY = { from: contentClass.fullName, joins: [], where: [\"FALSE\"] };\n\n  const from = await specializeContentClass({\n    classHierarchyInspector: {\n      async classDerivesFrom(\n        derivedClassName: EC.FullClassNameDotNotation,\n        baseClassName: EC.FullClassNameDotNotation,\n      ): Promise<boolean> {\n        try {\n          return await imodelAccess.classDerivesFrom(derivedClassName, baseClassName);\n        } catch (e) {\n          /* v8 ignore else -- @preserve */\n          if (isSchemaOrClassNotFoundError(e)) {\n            // either derived or base class doesn't exist in this iModel\n            return false;\n          }\n\n          /* v8 ignore next -- @preserve */\n          throw e;\n        }\n      },\n    },\n    contentClassName: contentClass.fullName,\n    filterClassNames: filter.propertyClassNames.map(normalizeFullClassName),\n  });\n  if (!from) {\n    // filter class doesn't intersect with content class\n    return DISABLE_QUERY;\n  }\n\n  let filteredClassNamesInThisIModel: EC.FullClassNameDotNotation[] | undefined;\n  if (filter.filteredClassNames && filter.filteredClassNames.length > 0) {\n    filteredClassNamesInThisIModel = (\n      await Promise.all(\n        filter.filteredClassNames\n          .map(normalizeFullClassName)\n          .map(async (fullClassName) => ({\n            fullClassName,\n            filteredClass: await tryGetClass(imodelAccess, fullClassName),\n          })),\n      )\n    )\n      .filter(({ filteredClass }) => !!filteredClass)\n      .map(({ fullClassName }) => fullClassName);\n\n    if (filteredClassNamesInThisIModel.length === 0) {\n      // we had filter classes, but none of them exist in this iModel\n      return DISABLE_QUERY;\n    }\n  }\n\n  let joins: string[] | undefined;\n  try {\n    joins = await Promise.all(\n      filter.relatedInstances.map(async (rel, i) => {\n        const res = await ECSql.createRelationshipPathJoinClause({\n          schemaProvider: imodelAccess,\n          path: assignRelationshipPathAliases(rel.path, i, contentClass.alias, rel.alias),\n        });\n        assert(!res.bindings, \"Expecting no bindings as the relationship path has no instance filter.\");\n        return res.joins;\n      }),\n    );\n  } catch (e) {\n    /* v8 ignore else -- @preserve */\n    if (isSchemaOrClassNotFoundError(e)) {\n      // at least one related instance spec uses a class that doesn't exist in this iModel\n      return DISABLE_QUERY;\n    }\n\n    /* v8 ignore next -- @preserve */\n    throw e;\n  }\n\n  const classAliasMap = new Map<string, EC.FullClassNameDotNotation>([[contentClass.alias, from]]);\n  filter.relatedInstances.forEach(\n    ({ path, alias }) =>\n      path.length > 0 && classAliasMap.set(alias, normalizeFullClassName(path[path.length - 1].targetClassName)),\n  );\n  let propertiesFilter: string | undefined;\n  try {\n    propertiesFilter = await createWhereClause(\n      contentClass.alias,\n      async (alias) => {\n        const aliasClassName = classAliasMap.get(alias);\n        return aliasClassName ? getClass(imodelAccess, aliasClassName) : undefined;\n      },\n      filter.rules,\n    );\n  } catch (e) {\n    // note: don't need to worry about schemas & classes here, because that's taken care of above, when\n    // validating property class names & related instance defs\n    /* v8 ignore else -- @preserve */\n    if (isPropertyNotFoundError(e)) {\n      // filter uses a property that doesn't exist in this iModel\n      return DISABLE_QUERY;\n    }\n\n    /* v8 ignore next -- @preserve */\n    throw e;\n  }\n\n  const where = new Array<string>();\n  if (filteredClassNamesInThisIModel) {\n    where.push(\n      `${ECSql.createRawPropertyValueSelector(contentClass.alias, \"ECClassId\")} IS (\n          ${filteredClassNamesInThisIModel\n            .map(parseFullClassName)\n            .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n            .join(\", \")}\n        )`,\n    );\n  }\n  if (propertiesFilter) {\n    where.push(propertiesFilter);\n  }\n\n  return { from, joins, where };\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\nasync function createGroupingSelector(\n  grouping: ECSqlSelectClauseGroupingParams,\n  imodelAccess: ECSchemaProvider,\n  instanceLabelSelectClauseFactory: IInstanceLabelSelectClauseFactory,\n): Promise<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  // TODO: MISSING_COVERAGE\n  /* v8 ignore else -- @preserve */\n  if (grouping.byProperties) {\n    const propertyClass = await getClass(imodelAccess, grouping.byProperties.propertiesClassName);\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(${(\n            await Promise.all(\n              grouping.byProperties.propertyGroups.map(async (propertyGroup) =>\n                serializeJsonObject(\n                  await createPropertyGroupSelectors(propertyGroup, propertyClass, instanceLabelSelectClauseFactory),\n                ),\n              ),\n            )\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\n  return serializeJsonObject(groupingSelectors);\n}\n\nfunction createLabelGroupingBaseParamsSelectors(\n  byLabel: ECSqlSelectClauseLabelGroupingMergeParams | ECSqlSelectClauseLabelGroupingGroupParams,\n) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (byLabel.action !== undefined) {\n    selectors.push({ key: \"action\", selector: `${createECSqlValueSelector(byLabel.action)}` });\n  }\n  if (byLabel.groupId !== undefined) {\n    selectors.push({ key: \"groupId\", selector: createECSqlValueSelector(byLabel.groupId) });\n  }\n  if (byLabel.action !== \"merge\") {\n    selectors.push(...createBaseGroupingParamSelectors(byLabel));\n  }\n\n  return selectors;\n}\n\nasync function createPropertyGroupSelectors(\n  propertyGroup: ECSqlSelectClausePropertyGroup,\n  propertyClass: EC.Class,\n  instanceLabelSelectClauseFactory: IInstanceLabelSelectClauseFactory,\n) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  selectors.push({ key: \"propertyName\", selector: `${createECSqlValueSelector(propertyGroup.propertyName)}` });\n\n  const property = propertyClass.getProperty(propertyGroup.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${propertyGroup.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n\n  if (property.isNavigation()) {\n    const relationshipClass = property.relationshipClass;\n    const abstractConstraint =\n      property.direction === \"Forward\"\n        ? relationshipClass.target.abstractConstraint\n        : relationshipClass.source.abstractConstraint;\n    // TODO: MISSING_COVERAGE\n    /* v8 ignore else -- @preserve */\n    if (!abstractConstraint) {\n      throw new Error(`Could not determine class name for navigation property with direction \"${property.direction}\".`);\n    }\n\n    const fullName = abstractConstraint.fullName;\n    const targetAlias = \"target\";\n    selectors.push({\n      key: \"propertyValue\",\n      selector: `(\n          SELECT ${await instanceLabelSelectClauseFactory.createSelectClause({ className: fullName, classAlias: targetAlias })}\n          FROM ${fullName} AS ${targetAlias}\n          WHERE [${targetAlias}].[ECInstanceId] = [${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}].[Id]\n        )`,\n    });\n  } else {\n    selectors.push({\n      key: \"propertyValue\",\n      selector: `[${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}]`,\n    });\n  }\n\n  if (propertyGroup.ranges) {\n    selectors.push(createRangeParamSelectors(propertyGroup.ranges));\n  }\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          { key: \"fromValue\", selector: createECSqlValueSelector(range.fromValue) },\n          { key: \"toValue\", selector: createECSqlValueSelector(range.toValue) },\n          ...(range.rangeLabel\n            ? [{ key: \"rangeLabel\", selector: `${createECSqlValueSelector(range.rangeLabel)}` }]\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({ key: \"hideIfNoSiblings\", selector: createECSqlValueSelector(params.hideIfNoSiblings) });\n  }\n  if (params.hideIfOneGroupedNode !== undefined) {\n    selectors.push({ key: \"hideIfOneGroupedNode\", selector: createECSqlValueSelector(params.hideIfOneGroupedNode) });\n  }\n  if (params.autoExpand !== undefined) {\n    selectors.push({ key: \"autoExpand\", selector: createECSqlValueSelector(params.autoExpand) });\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 = (\n      await Promise.all(rule.rules.map(async (r) => createWhereClause(contentClassAlias, classLoader, r)))\n    )\n      .filter((c) => !!c)\n      .join(` ${getECSqlLogicalOperator(rule.operator)} `);\n    return clause ? (rule.operator === \"or\" ? `(${clause})` : clause) : undefined;\n  }\n\n  const sourceAlias = rule.sourceAlias ? rule.sourceAlias : contentClassAlias;\n  const propertyClass = await classLoader(sourceAlias);\n  if (!propertyClass) {\n    throw new Error(`Class with alias \"${sourceAlias}\" not found.`);\n  }\n  const property = propertyClass.getProperty(rule.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${rule.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n\n  const propertyValueSelector = ECSql.createRawPropertyValueSelector(sourceAlias, property.name);\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\n  if (property.isNavigation()) {\n    assert(GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector}.[Id] ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value.id)}`;\n  }\n  if (property.isEnumeration()) {\n    assert(!GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n  }\n  if (property.isPrimitive()) {\n    assert(!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(\n  valueSelector: string,\n  operator: \"is-equal\" | \"is-not-equal\",\n  value: number,\n) {\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(\n  op: Exclude<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\">,\n) {\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 = Extract<\n  Props<typeof ECSql.createRelationshipPathJoinClause>,\n  { schemaProvider: ECSchemaProvider }\n>[\"path\"];\nfunction assignRelationshipPathAliases(\n  path: GenericInstanceFilterRelationshipStep[],\n  pathIndex: number,\n  sourceAlias: string,\n  targetAlias: string,\n): JoinRelationshipPath {\n  function createAlias(fullClassName: EC.FullClassNameDotNotation, index: number) {\n    return `rel_${pathIndex}_${fullClassName.replaceAll(/[\\.:]/g, \"_\")}_${index}`;\n  }\n  const result: JoinRelationshipPath = [];\n  path.forEach((step, i) => {\n    const sourceClassName = normalizeFullClassName(step.sourceClassName);\n    const targetClassName = normalizeFullClassName(step.targetClassName);\n    const relationshipName = normalizeFullClassName(step.relationshipClassName);\n    result.push({\n      targetClassName,\n      relationshipName,\n      sourceClassName,\n      relationshipReverse: !step.isForwardRelationship,\n      sourceAlias: i === 0 ? sourceAlias : result[i - 1].targetAlias,\n      relationshipAlias: createAlias(relationshipName, i),\n      targetAlias: i === path.length - 1 ? targetAlias : createAlias(targetClassName, i),\n      joinType: \"inner\",\n    });\n  });\n  return result;\n}\n\ninterface SpecializeContentClassProps {\n  classHierarchyInspector: Pick<ECSchemaProvider, \"classDerivesFrom\">;\n  contentClassName: EC.FullClassNameDotNotation;\n  filterClassNames: EC.FullClassNameDotNotation[];\n}\nasync function specializeContentClass(\n  props: SpecializeContentClassProps,\n): Promise<EC.FullClassNameDotNotation | 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(\n  classHierarchyInspector: Pick<ECSchemaProvider, \"classDerivesFrom\">,\n  classes: EC.FullClassNameDotNotation[],\n): Promise<EC.FullClassNameDotNotation | 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\ninterface HiddenClassNode {\n  fullName: EC.FullClassNameDotNotation;\n  state: \"hide\" | \"show\";\n  children: HiddenClassNode[];\n}\n\nasync function getHiddenClassesTree(\n  schemaProvider: ECSchemaProvider,\n  selectClass: EC.Class,\n  selectClassAttribute: \"show\" | \"hide\" = \"show\",\n): Promise<HiddenClassNode[]> {\n  const derivedClassNames = selectClass.getDerivedClassNames({ onlyDirect: true });\n  const derivedClassNamesBySchema = derivedClassNames.reduce((acc, fullClassName) => {\n    const { schemaName, className } = parseFullClassName(fullClassName);\n    let entry = acc.get(schemaName);\n    if (!entry) {\n      entry = [];\n      acc.set(schemaName, entry);\n    }\n    entry.push(className);\n    return acc;\n  }, new Map<string, string[]>());\n  const derivedClassesBySchema = await Promise.all(\n    [...derivedClassNamesBySchema.entries()].map(async ([schemaName, classNames]) => {\n      const schema = await schemaProvider.getSchema(schemaName);\n      /* v8 ignore next 3 -- @preserve */\n      if (!schema) {\n        throw new Error(`Schema \"${schemaName}\" not found.`);\n      }\n      return {\n        schema,\n        classes: classNames.map((className) => {\n          const lookupClass = schema.getClass(className);\n          /* v8 ignore next 3 -- @preserve */\n          if (!lookupClass) {\n            throw new Error(`Class \"${className}\" not found in schema \"${schemaName}\".`);\n          }\n          return lookupClass;\n        }),\n      };\n    }),\n  );\n\n  const hiddenSchemas = new Map<string, \"hide\" | \"show\" | undefined>();\n  for (const { schema } of derivedClassesBySchema) {\n    hiddenSchemas.set(schema.name, schema.isHidden ? \"hide\" : undefined);\n  }\n\n  return Promise.all(\n    derivedClassesBySchema\n      .flatMap(({ classes }) => classes)\n      .map(async (ecClass): Promise<HiddenClassNode[]> => {\n        const hiddenClassAttr = (() => {\n          switch (ecClass.isHidden) {\n            case true:\n              return \"hide\";\n            case false:\n              return \"show\";\n            default:\n              return undefined;\n          }\n        })();\n        const attr = hiddenClassAttr ?? hiddenSchemas.get(ecClass.schema.name);\n        if (!attr || attr === selectClassAttribute) {\n          return getHiddenClassesTree(schemaProvider, ecClass, selectClassAttribute);\n        }\n        return [\n          {\n            fullName: ecClass.fullName,\n            state: attr,\n            children: await getHiddenClassesTree(schemaProvider, ecClass, attr),\n          },\n        ];\n      }),\n  ).then((results) => results.flat());\n}\n\nfunction createWhereClauseForHiddenClasses(\n  hiddenClasses: HiddenClassNode[],\n  selectAlias: string,\n): { showClause?: string; hideClause?: string } {\n  const res: { showClause?: string; hideClause?: string } = {};\n\n  const show = hiddenClasses.filter(({ state }) => state === \"show\");\n  if (show.length > 0) {\n    let showClause = `[${selectAlias}].[ECClassId] IS (${show\n      .map(({ fullName }) => parseFullClassName(fullName))\n      .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n      .join(\", \")})`;\n    const childClauses = createWhereClauseForHiddenClasses(\n      show.flatMap(({ children }) => children),\n      selectAlias,\n    );\n    if (childClauses.hideClause) {\n      showClause = `(${showClause} AND ${childClauses.hideClause})`;\n    }\n    res.showClause = showClause;\n  }\n\n  const hide = hiddenClasses.filter(({ state }) => state === \"hide\");\n  if (hide.length > 0) {\n    let hideClause = `[${selectAlias}].[ECClassId] IS NOT (${hide\n      .map(({ fullName }) => parseFullClassName(fullName))\n      .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n      .join(\", \")})`;\n    const childClauses = createWhereClauseForHiddenClasses(\n      hide.flatMap(({ children }) => children),\n      selectAlias,\n    );\n    if (childClauses.showClause) {\n      hideClause = `(${hideClause} OR ${childClauses.showClause})`;\n    }\n    res.hideClause = hideClause;\n  }\n\n  return res;\n}\n\nasync function tryGetClass(\n  schemaProvider: ECSchemaProvider,\n  fullClassName: EC.FullClassNameDotNotation,\n): Promise<EC.Class | undefined> {\n  try {\n    return await getClass(schemaProvider, fullClassName);\n  } catch (e) {\n    /* v8 ignore else -- @preserve */\n    if (isSchemaOrClassNotFoundError(e)) {\n      return undefined;\n    }\n\n    /* v8 ignore next -- @preserve */\n    throw e;\n  }\n}\nfunction isSchemaOrClassNotFoundError(e: unknown): e is Error {\n  return (\n    e instanceof Error &&\n    (!!e.message.match(/^Schema \"[\\w\\d_]+\" not found/) || !!e.message.match(/^Class \"[\\w\\d_\\.:]+\" not found/))\n  );\n}\nfunction isPropertyNotFoundError(e: unknown): e is Error {\n  return e instanceof Error && !!e.message.match(/^Property \"[\\w\\d]+\" not found in ECClass/);\n}\n"]}

package/lib/{esm/hierarchies → hierarchies}/imodel/PredicateBasedHierarchyDefinition.d.ts

@@ -1,5 +1,5 @@
 import type { Id64String } from "@itwin/core-bentley";
-import type { EC, ECClassHierarchyInspector } from "@itwin/presentation-shared";
+import type { EC, ECSchemaProvider } from "@itwin/presentation-shared";
 import type { GenericNodeKey, InstancesNodeKey } from "../HierarchyNodeKey.js";
 import type { DefineHierarchyLevelProps, HierarchyDefinition, HierarchyDefinitionParentNode, HierarchyLevelDefinition } from "./IModelHierarchyDefinition.js";
 /**
@@ -20,7 +20,7 @@ export type DefineInstanceNodeChildHierarchyLevelProps = Omit<DefineHierarchyLev
      * keys are grouped by class and a hierarchy level definition is requested for each combination of class and
      * instance IDs (with the same `parentNode`).
      */
-    parentNodeClassName: EC.FullClassName;
+    parentNodeClassName: EC.FullClassNameDotNotation;
     /**
      * ECInstanceIds of the parent instance node.
      *
@@ -47,7 +47,7 @@ interface InstancesNodeChildHierarchyLevelDefinition {
      * - The function version should return a boolean indicating whether this hierarchy level definition should be used
      * for the given parent node.
      */
-    parentInstancesNodePredicate: EC.FullClassName | ((parentNodeKey: InstancesNodeKey) => Promise<boolean>);
+    parentInstancesNodePredicate: EC.FullClassNameDotNotation | ((parentNodeKey: InstancesNodeKey) => Promise<boolean>);
     /**
      * Called to create a hierarchy level definition when the `parentInstancesNodePredicate` predicate passes.
      */
@@ -116,7 +116,7 @@ export type DefineRootHierarchyLevelProps = Omit<DefineHierarchyLevelProps, "par
  */
 interface PredicateBasedHierarchyDefinitionProps extends Pick<HierarchyDefinition, "parseNode" | "preProcessNode" | "postProcessNode"> {
     /** Access to ECClass hierarchy in the iModel */
-    classHierarchyInspector: ECClassHierarchyInspector;
+    imodelAccess: Pick<ECSchemaProvider, "classDerivesFrom">;
     /** Hierarchy level definitions */
     hierarchy: {
         /** Called to create the root hierarchy level definition. */

package/lib/hierarchies/imodel/PredicateBasedHierarchyDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PredicateBasedHierarchyDefinition.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/imodel/PredicateBasedHierarchyDefinition.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAAE,gBAAgB,EAAe,MAAM,4BAA4B,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,EAIzB,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,0CAA0C,GAAG,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,GAAG;IACvG,gCAAgC;IAChC,UAAU,EAAE,IAAI,CAAC,6BAA6B,EAAE,KAAK,CAAC,GAAG;QAAE,GAAG,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAEnF;;;;;;;OAOG;IACH,mBAAmB,EAAE,EAAE,CAAC,wBAAwB,CAAC;IAEjD;;;;;;;OAOG;IACH,qBAAqB,EAAE,UAAU,EAAE,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,UAAU,0CAA0C;IAClD;;;;;;;;;OASG;IACH,4BAA4B,EAAE,EAAE,CAAC,wBAAwB,GAAG,CAAC,CAAC,aAAa,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpH;;OAEG;IACH,WAAW,EAAE,CAAC,YAAY,EAAE,0CAA0C,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE7G;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,yCAAyC,GAAG,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,GAAG;IACtG,+BAA+B;IAC/B,UAAU,EAAE,IAAI,CAAC,6BAA6B,EAAE,KAAK,CAAC,GAAG;QAAE,GAAG,EAAE,cAAc,CAAA;KAAE,CAAC;CAClF,CAAC;AAEF;;;;GAIG;AACH,UAAU,wCAAwC;IAChD;;;OAGG;IACH,0BAA0B,EAAE,CAAC,aAAa,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhF;;OAEG;IACH,WAAW,EAAE,CAAC,YAAY,EAAE,yCAAyC,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAC7G;AAED;;;;GAIG;AACH,KAAK,sCAAsC,GACvC,0CAA0C,GAC1C,wCAAwC,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;AAE1F;;;GAGG;AACH,UAAU,sCAAuC,SAAQ,IAAI,CAC3D,mBAAmB,EACnB,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,CACnD;IACC,gDAAgD;IAChD,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IAEzD,kCAAkC;IAClC,SAAS,EAAE;QACT,4DAA4D;QAC5D,SAAS,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAEvF;;;WAGG;QACH,UAAU,EAAE,sCAAsC,EAAE,CAAC;KACtD,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,sCAAsC,GAC5C,mBAAmB,CAErB"}

package/lib/{esm/hierarchies → hierarchies}/imodel/PredicateBasedHierarchyDefinition.js

@@ -47,7 +47,7 @@ class PredicateBasedHierarchyDefinition {
         }
         if (parentNode && HierarchyNode.isInstancesNode(parentNode)) {
             const instancesParentNodeDefs = this._props.hierarchy.childNodes.filter(isInstancesNodeChildHierarchyLevelDefinition);
-            return firstValueFrom(from(groupInstanceIdsByClass(parentNode.key.instanceKeys).entries()).pipe(mergeMap(async ([parentNodeClassName, parentNodeInstanceIds]) => createHierarchyLevelDefinitions(this._props.classHierarchyInspector, instancesParentNodeDefs, {
+            return firstValueFrom(from(groupInstanceIdsByClass(parentNode.key.instanceKeys).entries()).pipe(mergeMap(async ([parentNodeClassName, parentNodeInstanceIds]) => createHierarchyLevelDefinitions(this._props.imodelAccess, instancesParentNodeDefs, {
                 ...props,
                 parentNodeClassName,
                 parentNodeInstanceIds,

package/lib/hierarchies/imodel/PredicateBasedHierarchyDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PredicateBasedHierarchyDefinition.js","sourceRoot":"","sources":["../../../src/hierarchies/imodel/PredicateBasedHierarchyDefinition.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 { concatMap, filter, firstValueFrom, from, mergeAll, mergeMap, toArray } from \"rxjs\";\nimport { HierarchyNode } from \"../HierarchyNode.js\";\n\nimport type { Id64String } from \"@itwin/core-bentley\";\nimport type { EC, ECSchemaProvider, InstanceKey } from \"@itwin/presentation-shared\";\nimport type { GenericNodeKey, InstancesNodeKey } from \"../HierarchyNodeKey.js\";\nimport type {\n  DefineHierarchyLevelProps,\n  HierarchyDefinition,\n  HierarchyDefinitionParentNode,\n  HierarchyLevelDefinition,\n  NodeParser,\n  NodePostProcessor,\n  NodePreProcessor,\n} from \"./IModelHierarchyDefinition.js\";\n\n/**\n * Props for defining child hierarchy level for specific parent instance node.\n * @see `createPredicateBasedHierarchyDefinition`\n * @public\n */\nexport type DefineInstanceNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent instance node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: InstancesNodeKey };\n\n  /**\n   * Full name of the parent instance node class.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeClassName: EC.FullClassNameDotNotation;\n\n  /**\n   * ECInstanceIds of the parent instance node.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeInstanceIds: Id64String[];\n};\n\n/**\n * A definition of a hierarchy level that should be used for specific parent instance nodes.\n * @see `createPredicateBasedHierarchyDefinition`\n * @public\n */\ninterface InstancesNodeChildHierarchyLevelDefinition {\n  /**\n   * A predicate for matching the parent instances node. This can be either a string or a predicate function:\n   *\n   * - The string version should specify full name of the parent instance node's class to match against when\n   * checking if this hierarchy level should be used for specific parent instance node. The check is polymorphic,\n   * so `BisCore.Element` class would match `BisCore.GeometricElement`, `BisCore.Category` and all other element classes.\n   *\n   * - The function version should return a boolean indicating whether this hierarchy level definition should be used\n   * for the given parent node.\n   */\n  parentInstancesNodePredicate: EC.FullClassNameDotNotation | ((parentNodeKey: InstancesNodeKey) => Promise<boolean>);\n\n  /**\n   * Called to create a hierarchy level definition when the `parentInstancesNodePredicate` predicate passes.\n   */\n  definitions: (requestProps: DefineInstanceNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n  /**\n   * If set to true, and node matches at least one of the previous definitions, this definition will not be applied.\n   *\n   * For example:\n   * ```ts\n   * {\n   *   parentInstancesNodePredicate: \"BisCore.GeometricElement3d\",\n   *   definitions: () => ...,\n   * },\n   * // This will apply to all elements, that are not `BisCore.GeometricElement3d`\n   * {\n   *   parentInstancesNodePredicate: \"BisCore.Element\",\n   *   onlyIfNotHandled: true,\n   *   definitions: () => ...,\n   * }\n   * ```\n   */\n  onlyIfNotHandled?: boolean;\n}\n\n/**\n * Props for defining child hierarchy level for specific generic parent node.\n * @see `createPredicateBasedHierarchyDefinition`\n * @public\n */\nexport type DefineGenericNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent generic node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: GenericNodeKey };\n};\n\n/**\n * A definition of a hierarchy level for that should be used for specific generic parent nodes.\n * @see `createPredicateBasedHierarchyDefinition`\n * @public\n */\ninterface GenericNodeChildHierarchyLevelDefinition {\n  /**\n   * A function that indicates whether this hierarchy level definition should be used for\n   * specific parent generic node.\n   */\n  parentGenericNodePredicate: (parentNodeKey: GenericNodeKey) => Promise<boolean>;\n\n  /**\n   * Called to create a hierarchy level definition when the `parentInstancesNodePredicate` predicate passes.\n   */\n  definitions: (requestProps: DefineGenericNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * A hierarchy level definition associated with specific parent instance or generic node. *\n * @see `createPredicateBasedHierarchyDefinition`\n * @public\n */\ntype PredicateBasedHierarchyLevelDefinition =\n  | InstancesNodeChildHierarchyLevelDefinition\n  | GenericNodeChildHierarchyLevelDefinition;\n\n/**\n * Props for defining root hierarchy level.\n * @see `createPredicateBasedHierarchyDefinition`\n * @public\n */\nexport type DefineRootHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\">;\n\n/**\n * Props for `createPredicateBasedHierarchyDefinition`.\n * @public\n */\ninterface PredicateBasedHierarchyDefinitionProps extends Pick<\n  HierarchyDefinition,\n  \"parseNode\" | \"preProcessNode\" | \"postProcessNode\"\n> {\n  /** Access to ECClass hierarchy in the iModel */\n  imodelAccess: Pick<ECSchemaProvider, \"classDerivesFrom\">;\n\n  /** Hierarchy level definitions */\n  hierarchy: {\n    /** Called to create the root hierarchy level definition. */\n    rootNodes: (props: DefineRootHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n    /**\n     * A list of child hierarchy level definitions. The list is first filtered based on\n     * the parent node and then is used to create child hierarchy level definitions.\n     */\n    childNodes: PredicateBasedHierarchyLevelDefinition[];\n  };\n}\n\n/**\n * Creates an instance of `HierarchyDefinition` that uses a somewhat declarative approach to define the\n * hierarchy - each hierarchy level is defined by specifying a parent node predicate and child hierarchy\n * level definitions, that are used when the predicate passes.\n *\n * @public\n */\nexport function createPredicateBasedHierarchyDefinition(\n  props: PredicateBasedHierarchyDefinitionProps,\n): HierarchyDefinition {\n  return new PredicateBasedHierarchyDefinition(props);\n}\n\nclass PredicateBasedHierarchyDefinition implements HierarchyDefinition {\n  public parseNode: NodeParser | undefined;\n  public preProcessNode: NodePreProcessor | undefined;\n  public postProcessNode: NodePostProcessor | undefined;\n\n  public constructor(private _props: PredicateBasedHierarchyDefinitionProps) {\n    if (this._props.parseNode) {\n      this.parseNode = this._props.parseNode;\n    }\n    if (this._props.preProcessNode) {\n      this.preProcessNode = this._props.preProcessNode;\n    }\n    if (this._props.postProcessNode) {\n      this.postProcessNode = this._props.postProcessNode;\n    }\n  }\n\n  /**\n   * Create hierarchy level definitions for specific hierarchy level.\n   * @param parentNode Parent node to create children definitions for.\n   */\n  public async defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition> {\n    const { parentNode } = props;\n\n    if (parentNode && HierarchyNode.isGeneric(parentNode)) {\n      return firstValueFrom(\n        from(this._props.hierarchy.childNodes).pipe(\n          filter(isGenericNodeChildHierarchyLevelDefinition),\n          mergeMap(async (def) => {\n            if (await def.parentGenericNodePredicate(parentNode.key)) {\n              return def.definitions({ ...props, parentNode });\n            }\n            return [];\n          }),\n          mergeAll(),\n          toArray(),\n        ),\n      );\n    }\n\n    if (parentNode && HierarchyNode.isInstancesNode(parentNode)) {\n      const instancesParentNodeDefs = this._props.hierarchy.childNodes.filter(\n        isInstancesNodeChildHierarchyLevelDefinition,\n      );\n      return firstValueFrom(\n        from(groupInstanceIdsByClass(parentNode.key.instanceKeys).entries()).pipe(\n          mergeMap(async ([parentNodeClassName, parentNodeInstanceIds]) =>\n            createHierarchyLevelDefinitions(this._props.imodelAccess, instancesParentNodeDefs, {\n              ...props,\n              parentNodeClassName,\n              parentNodeInstanceIds,\n              parentNode,\n            }),\n          ),\n          mergeAll(),\n          toArray(),\n        ),\n      );\n    }\n\n    return this._props.hierarchy.rootNodes(props);\n  }\n}\n\nasync function createHierarchyLevelDefinitions(\n  classHierarchy: Pick<ECSchemaProvider, \"classDerivesFrom\">,\n  defs: InstancesNodeChildHierarchyLevelDefinition[],\n  requestProps: DefineInstanceNodeChildHierarchyLevelProps,\n) {\n  return from(defs).pipe(\n    mergeMap(async (def, idx) => {\n      if (\n        typeof def.parentInstancesNodePredicate === \"string\" &&\n        (await classHierarchy.classDerivesFrom(requestProps.parentNodeClassName, def.parentInstancesNodePredicate))\n      ) {\n        return { def, idx };\n      }\n      if (\n        typeof def.parentInstancesNodePredicate === \"function\" &&\n        (await def.parentInstancesNodePredicate(requestProps.parentNode.key))\n      ) {\n        return { def, idx };\n      }\n      return undefined;\n    }),\n    filter((x): x is Exclude<typeof x, undefined> => !!x),\n    toArray(),\n    concatMap((x) => x.sort((a, b) => a.idx - b.idx).map(({ def }) => def)),\n    filter((def, idx) => !def.onlyIfNotHandled || idx === 0),\n    mergeMap(async (def) => def.definitions(requestProps)),\n    mergeAll(),\n  );\n}\n\nfunction groupInstanceIdsByClass(instanceKeys: InstanceKey[]) {\n  const instanceIdsByClass = new Map<EC.FullClassNameDotNotation, Id64String[]>();\n  instanceKeys.forEach((key) => {\n    let instanceIds = instanceIdsByClass.get(key.className);\n    if (!instanceIds) {\n      instanceIds = [];\n      instanceIdsByClass.set(key.className, instanceIds);\n    }\n    instanceIds.push(key.id);\n  });\n  return instanceIdsByClass;\n}\n\nfunction isGenericNodeChildHierarchyLevelDefinition(\n  def: PredicateBasedHierarchyLevelDefinition,\n): def is GenericNodeChildHierarchyLevelDefinition {\n  return !!(def as GenericNodeChildHierarchyLevelDefinition).parentGenericNodePredicate;\n}\n\nfunction isInstancesNodeChildHierarchyLevelDefinition(\n  def: PredicateBasedHierarchyLevelDefinition,\n): def is InstancesNodeChildHierarchyLevelDefinition {\n  return !!(def as InstancesNodeChildHierarchyLevelDefinition).parentInstancesNodePredicate;\n}\n"]}

package/lib/{cjs/hierarchies → hierarchies}/imodel/SearchHierarchyDefinition.d.ts

@@ -1,10 +1,10 @@
 import type { Observable } from "rxjs";
-import type { ECClassHierarchyInspector, InstanceKey } from "@itwin/presentation-shared";
+import type { ECSchemaProvider, InstanceKey } from "@itwin/presentation-shared";
 import type { HierarchySearchTree } from "../HierarchySearch.js";
 import type { DefineHierarchyLevelProps, HierarchyLevelDefinition, InstanceNodesQueryDefinition } from "../imodel/IModelHierarchyDefinition.js";
 import type { RxjsHierarchyDefinition, RxjsNodeParser, RxjsNodePostProcessor, RxjsNodePreProcessor } from "../internal/RxjsHierarchyDefinition.js";
 interface SearchHierarchyDefinitionProps {
-    imodelAccess: ECClassHierarchyInspector;
+    imodelAccess: Pick<ECSchemaProvider, "classDerivesFrom">;
     source: RxjsHierarchyDefinition;
     sourceName: string;
     targetPaths: HierarchySearchTree[];

package/lib/hierarchies/imodel/SearchHierarchyDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchHierarchyDefinition.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/imodel/SearchHierarchyDefinition.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,yBAAyB,EAEzB,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wCAAwC,CAAC;AAGhD,UAAU,8BAA8B;IACtC,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IACzD,MAAM,EAAE,uBAAuB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,gBAAgB;AAChB,qBAAa,yBAA0B,YAAW,uBAAuB;;IACvE,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,YAAY,CAAiB;IAGrC,YAAmB,KAAK,EAAE,8BAA8B,EAMvD;IAED,IAAW,cAAc,IAAI,oBAAoB,CAehD;IAED,IAAW,eAAe,IAAI,qBAAqB,CAalD;IAED,IAAW,SAAS,IAAI,cAAc,CAyDrC;IAEM,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,UAAU,CAAC,wBAAwB,CAAC,CA0GlG;CACF;AAED,gBAAgB;AAEhB,eAAO,MAAM,oCAAoC,uBAAuB,CAAC;AAEzE,gBAAgB;AAEhB,eAAO,MAAM,iCAAiC,oBAAoB,CAAC;AAenE,gBAAgB;AAChB,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,4BAA4B,EACjC,kBAAkB,EAAE,WAAW,EAAE,GAChC,4BAA4B,CAgC9B;AAED,gBAAgB;AAChB,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,4BAA4B,GAAG,4BAA4B,CAc1G"}

package/lib/{esm/hierarchies → hierarchies}/imodel/SearchHierarchyDefinition.js

@@ -3,7 +3,6 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import { defaultIfEmpty, defer, filter, firstValueFrom, map, merge, mergeAll, mergeMap, of, take, toArray } from "rxjs";
-import { compareFullClassNames } from "@itwin/presentation-shared";
 import { HierarchyNode } from "../HierarchyNode.js";
 import { HierarchyNodeIdentifier } from "../HierarchyNodeIdentifier.js";
 import { createHierarchySearchHelper } from "../HierarchySearch.js";
@@ -69,7 +68,7 @@ export class SearchHierarchyDefinition {
                     if (identifier.imodelKey && identifier.imodelKey !== imodelKey) {
                         return false;
                     }
-                    if (compareFullClassNames(identifier.className, rowInstanceKey.className) === 0) {
+                    if (identifier.className === rowInstanceKey.className) {
                         return true;
                     }
                     return firstValueFrom(merge(fromPossiblyPromise(this._imodelAccess.classDerivesFrom(identifier.className, rowInstanceKey.className)), fromPossiblyPromise(this._imodelAccess.classDerivesFrom(rowInstanceKey.className, identifier.className))).pipe(filter((classDerives) => classDerives), defaultIfEmpty(false), take(1)));
@@ -131,7 +130,7 @@ export class SearchHierarchyDefinition {
                     // duplicate it
                     for (const entry of entries) {
                         /* v8 ignore else -- @preserve */
-                        if (compareFullClassNames(entry.className, x.className) === 0 ||
+                        if (entry.className === x.className ||
                             (await imodelAccess.classDerivesFrom(entry.className, x.className)) ||
                             (await imodelAccess.classDerivesFrom(x.className, entry.className))) {
                             return undefined;
@@ -147,7 +146,7 @@ export class SearchHierarchyDefinition {
                     if (id.imodelKey && id.imodelKey !== props.imodelAccess.imodelKey) {
                         continue;
                     }
-                    if (compareFullClassNames(id.className, definition.fullClassName) !== 0 &&
+                    if (id.className !== definition.fullClassName &&
                         !(await Promise.all([
                             imodelAccess.classDerivesFrom(id.className, definition.fullClassName),
                             imodelAccess.classDerivesFrom(definition.fullClassName, id.className),

package/lib/hierarchies/imodel/SearchHierarchyDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchHierarchyDefinition.js","sourceRoot":"","sources":["../../../src/hierarchies/imodel/SearchHierarchyDefinition.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 { defaultIfEmpty, defer, filter, firstValueFrom, map, merge, mergeAll, mergeMap, of, take, toArray } from \"rxjs\";\nimport { HierarchyNode } from \"../HierarchyNode.js\";\nimport { HierarchyNodeIdentifier } from \"../HierarchyNodeIdentifier.js\";\nimport { createHierarchySearchHelper } from \"../HierarchySearch.js\";\nimport { HierarchyNodesDefinition } from \"../imodel/IModelHierarchyDefinition.js\";\nimport { NodeSelectClauseColumnNames } from \"../imodel/NodeSelectQueryFactory.js\";\nimport { defaultNodesParser } from \"../imodel/TreeNodesReader.js\";\nimport { fromPossiblyPromise } from \"../internal/Common.js\";\nimport { partition } from \"../internal/operators/Partition.js\";\nimport { ProcessedHierarchyNode } from \"./IModelHierarchyNode.js\";\n\nimport type { Observable } from \"rxjs\";\nimport type { Id64String } from \"@itwin/core-bentley\";\nimport type { ECSchemaProvider, InstanceKey } from \"@itwin/presentation-shared\";\nimport type { IModelInstanceKey } from \"../HierarchyNodeKey.js\";\nimport type { HierarchySearchTree } from \"../HierarchySearch.js\";\nimport type {\n  DefineHierarchyLevelProps,\n  GenericHierarchyNodeDefinition,\n  HierarchyLevelDefinition,\n  InstanceNodesQueryDefinition,\n} from \"../imodel/IModelHierarchyDefinition.js\";\nimport type {\n  RxjsHierarchyDefinition,\n  RxjsNodeParser,\n  RxjsNodePostProcessor,\n  RxjsNodePreProcessor,\n} from \"../internal/RxjsHierarchyDefinition.js\";\nimport type { ProcessedGroupingHierarchyNode } from \"./IModelHierarchyNode.js\";\n\ninterface SearchHierarchyDefinitionProps {\n  imodelAccess: Pick<ECSchemaProvider, \"classDerivesFrom\">;\n  source: RxjsHierarchyDefinition;\n  sourceName: string;\n  targetPaths: HierarchySearchTree[];\n  nodesParser?: RxjsNodeParser;\n}\n\n/** @internal */\nexport class SearchHierarchyDefinition implements RxjsHierarchyDefinition {\n  private _imodelAccess: Pick<ECSchemaProvider, \"classDerivesFrom\">;\n  private _source: RxjsHierarchyDefinition;\n  private _targetPaths: HierarchySearchTree[];\n  private _nodesParser: RxjsNodeParser;\n  #sourceName: string;\n\n  public constructor(props: SearchHierarchyDefinitionProps) {\n    this._imodelAccess = props.imodelAccess;\n    this._source = props.source;\n    this.#sourceName = props.sourceName;\n    this._targetPaths = props.targetPaths;\n    this._nodesParser = props.nodesParser ?? this._source.parseNode ?? ((row) => of(defaultNodesParser(row)));\n  }\n\n  public get preProcessNode(): RxjsNodePreProcessor {\n    return (props) =>\n      (this._source.preProcessNode ? this._source.preProcessNode(props) : of(props.node)).pipe(\n        filter((processedNode) => {\n          if (\n            processedNode.processingParams?.hideInHierarchy &&\n            processedNode.search?.isSearchTarget &&\n            !processedNode.search.hasSearchTargetAncestor\n          ) {\n            // we want to hide target nodes if they have `hideInHierarchy` param, but only if they're not under another search target\n            return false;\n          }\n          return true;\n        }),\n      );\n  }\n\n  public get postProcessNode(): RxjsNodePostProcessor {\n    return (props) =>\n      (this._source.postProcessNode ? this._source.postProcessNode(props) : of(props.node)).pipe(\n        map((processedNode) => {\n          if (\n            ProcessedHierarchyNode.isGroupingNode(processedNode) &&\n            shouldAutoExpandGroupingNode({ node: processedNode })\n          ) {\n            Object.assign(processedNode, { autoExpand: true });\n          }\n          return processedNode;\n        }),\n      );\n  }\n\n  public get parseNode(): RxjsNodeParser {\n    return (props) =>\n      this._nodesParser(props).pipe(\n        mergeMap((parsedNode) => {\n          const { row, parentNode: parentInstanceNode, imodelKey } = props;\n          if (!row[ECSQL_COLUMN_NAME_SearchECInstanceId] || !row[ECSQL_COLUMN_NAME_SearchClassName]) {\n            return of(parsedNode);\n          }\n          const rowInstanceKey = {\n            className: row[ECSQL_COLUMN_NAME_SearchClassName],\n            id: row[ECSQL_COLUMN_NAME_SearchECInstanceId],\n          };\n          return fromPossiblyPromise(\n            createHierarchySearchHelper(this._targetPaths, parentInstanceNode).createChildNodeProps({\n              nodeKey: parsedNode.key,\n              asyncPathMatcher: (identifier: HierarchyNodeIdentifier): boolean | Promise<boolean> => {\n                if (identifier.id !== rowInstanceKey.id) {\n                  return false;\n                }\n                if (!HierarchyNodeIdentifier.isInstanceNodeIdentifier(identifier)) {\n                  return false;\n                }\n                if (identifier.imodelKey && identifier.imodelKey !== imodelKey) {\n                  return false;\n                }\n                if (identifier.className === rowInstanceKey.className) {\n                  return true;\n                }\n                return firstValueFrom(\n                  merge(\n                    fromPossiblyPromise(\n                      this._imodelAccess.classDerivesFrom(identifier.className, rowInstanceKey.className),\n                    ),\n                    fromPossiblyPromise(\n                      this._imodelAccess.classDerivesFrom(rowInstanceKey.className, identifier.className),\n                    ),\n                  ).pipe(\n                    filter((classDerives) => classDerives),\n                    defaultIfEmpty(false),\n                    take(1),\n                  ),\n                );\n              },\n            }),\n          ).pipe(\n            map((nodeExtraProps) => {\n              if (nodeExtraProps?.search) {\n                parsedNode.search = nodeExtraProps.search;\n              }\n              if (nodeExtraProps?.autoExpand) {\n                parsedNode.autoExpand = nodeExtraProps.autoExpand;\n              }\n              return parsedNode;\n            }),\n          );\n        }),\n      );\n  }\n\n  public defineHierarchyLevel(props: DefineHierarchyLevelProps): Observable<HierarchyLevelDefinition> {\n    const sourceDefinitions = this._source.defineHierarchyLevel(props);\n\n    const searchHelper = createHierarchySearchHelper(this._targetPaths, props.parentNode);\n    const childNodeSearchIdentifiers = searchHelper.getChildNodeSearchIdentifiers();\n    if (!childNodeSearchIdentifiers) {\n      return sourceDefinitions;\n    }\n\n    const [genericNodeDefinitions, instanceNodeDefinitions] = partition(\n      sourceDefinitions.pipe(mergeAll()),\n      HierarchyNodesDefinition.isGenericNode,\n    );\n    return merge(\n      genericNodeDefinitions.pipe(\n        map((definition) => {\n          if (\n            searchHelper.hasSearchTargetAncestor ||\n            childNodeSearchIdentifiers.some(\n              (identifier) =>\n                HierarchyNodeIdentifier.isGenericNodeIdentifier(identifier) &&\n                (!identifier.source || identifier.source === this.#sourceName) &&\n                identifier.id === definition.node.key,\n            )\n          ) {\n            return {\n              ...definition,\n              node: {\n                ...definition.node,\n                ...searchHelper.createChildNodeProps({\n                  nodeKey: { type: \"generic\", id: definition.node.key },\n                  pathMatcher: ({ id }: HierarchyNodeIdentifier) => id === definition.node.key,\n                }),\n              },\n            };\n          }\n          return undefined;\n        }),\n        filter((def): def is GenericHierarchyNodeDefinition => !!def),\n      ),\n\n      instanceNodeDefinitions.pipe(\n        mergeMap((definition) => {\n          if (searchHelper.hasSearchTargetAncestor) {\n            // if we have a search target ancestor, we don't need to search the definitions - we use all of them\n            return of(applyECInstanceIdsSelector(definition));\n          }\n          return defer(async () => {\n            const imodelAccess = this._imodelAccess;\n            const matches = new Map<Id64String, IModelInstanceKey[]>();\n            async function getEntries(x: IModelInstanceKey) {\n              let entries = matches.get(x.id);\n              if (!entries) {\n                entries = [];\n                matches.set(x.id, entries);\n              }\n              // make sure that we don't have path identifiers that only differ by class name, where\n              // class names are in the same class hierarchy, e.g.:\n              // [{ className: \"bis.Element\", id: \"0x1\" }, { className: \"bis.Subject\", id: \"0x1\" }]\n              // are actually the same instance, so we only need to keep one of them, or otherwise the query will\n              // duplicate it\n              for (const entry of entries) {\n                /* v8 ignore else -- @preserve */\n                if (\n                  entry.className === x.className ||\n                  (await imodelAccess.classDerivesFrom(entry.className, x.className)) ||\n                  (await imodelAccess.classDerivesFrom(x.className, entry.className))\n                ) {\n                  return undefined;\n                }\n              }\n              return entries;\n            }\n            for (const id of childNodeSearchIdentifiers) {\n              // take only identifiers that match the definition by type, source and class\n              if (!HierarchyNodeIdentifier.isInstanceNodeIdentifier(id)) {\n                continue;\n              }\n              if (id.imodelKey && id.imodelKey !== props.imodelAccess.imodelKey) {\n                continue;\n              }\n              if (\n                id.className !== definition.fullClassName &&\n                !(await Promise.all([\n                  imodelAccess.classDerivesFrom(id.className, definition.fullClassName),\n                  imodelAccess.classDerivesFrom(definition.fullClassName, id.className),\n                ]).then(([isDerivedFrom, isDerivedTo]) => isDerivedFrom || isDerivedTo))\n              ) {\n                continue;\n              }\n              const entriesTargetForPathIdentifier = await getEntries(id);\n              if (entriesTargetForPathIdentifier) {\n                entriesTargetForPathIdentifier.push(id);\n              }\n            }\n            return Array.from(matches.values()).flat();\n          }).pipe(\n            // only take definitions that have matching path identifiers\n            filter((pathIdentifiers) => pathIdentifiers.length > 0),\n\n            // for each definition that we're going to use, apply query-level search\n            map((pathIdentifiers) => applyECInstanceIdsSearch(definition, pathIdentifiers)),\n          );\n        }),\n      ),\n    ).pipe(toArray());\n  }\n}\n\n/** @internal */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const ECSQL_COLUMN_NAME_SearchECInstanceId = \"SearchECInstanceId\";\n\n/** @internal */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const ECSQL_COLUMN_NAME_SearchClassName = \"SearchClassName\";\n\nfunction getClassECInstanceIds(targetInstanceKeys: InstanceKey[]) {\n  const classNameECInstanceIds = new Map<string, Id64String[]>();\n  for (const key of targetInstanceKeys) {\n    const entry = classNameECInstanceIds.get(key.className);\n    if (entry === undefined) {\n      classNameECInstanceIds.set(key.className, [key.id]);\n      continue;\n    }\n    entry.push(key.id);\n  }\n  return classNameECInstanceIds;\n}\n\n/** @internal */\nexport function applyECInstanceIdsSearch(\n  def: InstanceNodesQueryDefinition,\n  targetInstanceKeys: InstanceKey[],\n): InstanceNodesQueryDefinition {\n  const instanceIdsByClass = getClassECInstanceIds(targetInstanceKeys);\n  return {\n    ...def,\n    query: {\n      ...def.query,\n      ctes: [\n        ...(def.query.ctes ?? []),\n        `SearchInfo(ECInstanceId, SearchClassName) AS (\n          ${Array.from(instanceIdsByClass)\n            .map(\n              ([className, ecInstanceIds]) => `\n                SELECT ECInstanceId, '${className}' AS SearchClassName\n                FROM ${className}\n                WHERE ECInstanceId IN (${ecInstanceIds.join(\", \")})\n              `,\n            )\n            .join(\" UNION ALL \")}\n        )`,\n      ],\n      ecsql: `\n        SELECT\n          [q].*,\n          IdToHex([f].[ECInstanceId]) AS [${ECSQL_COLUMN_NAME_SearchECInstanceId}],\n          [f].[SearchClassName] AS [${ECSQL_COLUMN_NAME_SearchClassName}]\n        FROM (\n          ${def.query.ecsql}\n        ) [q]\n        JOIN SearchInfo [f] ON [f].[ECInstanceId] = [q].[ECInstanceId]\n      `,\n    },\n  };\n}\n\n/** @internal */\nexport function applyECInstanceIdsSelector(def: InstanceNodesQueryDefinition): InstanceNodesQueryDefinition {\n  return {\n    ...def,\n    query: {\n      ...def.query,\n      ecsql: `\n        SELECT\n          [q].*,\n          IdToHex([q].[ECInstanceId]) AS [${ECSQL_COLUMN_NAME_SearchECInstanceId}],\n          [q].[${NodeSelectClauseColumnNames.FullClassName}] AS [${ECSQL_COLUMN_NAME_SearchClassName}]\n        FROM (${def.query.ecsql}) [q]\n      `,\n    },\n  };\n}\n\nfunction shouldAutoExpandGroupingNode({\n  node,\n  nodeGroupingLevel,\n}: {\n  node: ProcessedGroupingHierarchyNode;\n  nodeGroupingLevel?: number;\n}): boolean {\n  if (nodeGroupingLevel === undefined) {\n    nodeGroupingLevel = HierarchyNode.getGroupingNodeLevel(node);\n  }\n  return node.children.some((child) => {\n    if (ProcessedHierarchyNode.isGroupingNode(child)) {\n      return shouldAutoExpandGroupingNode({ node: child, nodeGroupingLevel: nodeGroupingLevel + 1 });\n    }\n\n    if (!child.search) {\n      return false;\n    }\n\n    // check if node has search options with `autoExpand` option\n    if (child.search.options?.autoExpand) {\n      // `autoExpand === true` means we want to expand all its grouping nodes\n      if (child.search.options.autoExpand === true) {\n        return true;\n      }\n\n      // else, check if the grouping level condition is satisfied\n      if (child.search.options.autoExpand.groupingLevel >= nodeGroupingLevel) {\n        return true;\n      }\n    }\n\n    return false;\n  });\n}\n"]}

package/lib/{esm/hierarchies → hierarchies}/imodel/TreeNodesReader.d.ts

@@ -18,7 +18,7 @@ export declare function readNodes(props: ReadNodesProps): Observable<SourceInsta
  * @internal
  */
 export interface RowDef {
-    [NodeSelectClauseColumnNames.FullClassName]: EC.FullClassName;
+    [NodeSelectClauseColumnNames.FullClassName]: EC.FullClassNameDotNotation;
     [NodeSelectClauseColumnNames.ECInstanceId]: Id64String;
     [NodeSelectClauseColumnNames.DisplayLabel]: string;
     [NodeSelectClauseColumnNames.HasChildren]?: boolean;

package/lib/hierarchies/imodel/TreeNodesReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeNodesReader.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/imodel/TreeNodesReader.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAyC,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACnH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAI/E,UAAU,cAAc;IACtB,aAAa,EAAE,0BAA0B,CAAC;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,KAAK,UAAU,CAAC,cAAc,CAAC,CAAC;CACpF;AAED,gBAAgB;AAChB,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAcxF;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,CAAC,2BAA2B,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,wBAAwB,CAAC;IACzE,CAAC,2BAA2B,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACvD,CAAC,2BAA2B,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IACnD,CAAC,2BAA2B,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC;IACpD,CAAC,2BAA2B,CAAC,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC;IACzD,CAAC,2BAA2B,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;IAC5D,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAChD,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;IACpD,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC;IACnD,CAAC,2BAA2B,CAAC,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC;CAC3D;AAED,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,CAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,KACtC,eAAe,CAAC,UAAU,CAAC,cAAc,CAAC,CAiB9C,CAAC"}

package/lib/{esm/hierarchies → hierarchies}/imodel/TreeNodesReader.js

@@ -4,7 +4,7 @@
  *--------------------------------------------------------------------------------------------*/
 import { from, mergeMap, of } from "rxjs";
 import { Guid } from "@itwin/core-bentley";
-import { normalizeFullClassName, parseInstanceLabel } from "@itwin/presentation-shared";
+import { parseInstanceLabel } from "@itwin/presentation-shared";
 import { LOGGING_NAMESPACE_INTERNAL as BASE_LOGGING_NAMESPACE } from "../internal/Common.js";
 import { log } from "../internal/LoggingUtils.js";
 const LOGGING_NAMESPACE = `${BASE_LOGGING_NAMESPACE}.QueryRows`;
@@ -32,10 +32,7 @@ export const defaultNodesParser = ({ row }) => {
     return {
         // don't format the label here - we're going to do that at node pre-processing step to handle both - instance and generic nodes
         label: parseInstanceLabel(typedRow.DisplayLabel),
-        key: {
-            type: "instances",
-            instanceKeys: [{ className: normalizeFullClassName(typedRow.FullClassName), id: typedRow.ECInstanceId }],
-        },
+        key: { type: "instances", instanceKeys: [{ className: typedRow.FullClassName, id: typedRow.ECInstanceId }] },
         ...(typedRow.HasChildren !== undefined ? { children: !!typedRow.HasChildren } : undefined),
         ...(typedRow.AutoExpand ? { autoExpand: true } : undefined),
         ...(typedRow.SupportsFiltering ? { supportsFiltering: true } : undefined),