@itwin/presentation-testing 4.0.0-dev.18 → 4.0.0-dev.19

package/lib/cjs/presentation-testing/ContentBuilder.d.ts

@@ -63,7 +63,7 @@ export declare class ContentBuilder {
     private doCreateContent;
     /**
      * Create a list of property records using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param instanceKeys Keys of instances that should be queried.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
@@ -74,7 +74,7 @@ export declare class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes all of the class instances.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.
@@ -83,7 +83,7 @@ export declare class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes at most one class instance.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.

package/lib/cjs/presentation-testing/ContentBuilder.js

@@ -58,7 +58,7 @@ class ContentBuilder {
     }
     /**
      * Create a list of property records using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param instanceKeys Keys of instances that should be queried.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
@@ -106,7 +106,7 @@ class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes all of the class instances.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.
@@ -117,7 +117,7 @@ class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes at most one class instance.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.

package/lib/cjs/presentation-testing/ContentBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContentBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/ContentBuilder.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/** @packageDocumentation\n * @module Content\n */\n\nimport { PropertyRecord } from \"@itwin/appui-abstract\";\nimport { using } from \"@itwin/core-bentley\";\nimport { QueryRowFormat } from \"@itwin/core-common\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport {\n  Content, DefaultContentDisplayTypes, InstanceKey, KeySet, PageOptions, ProcessPrimitiveValueProps, RegisteredRuleset, Ruleset, traverseContent,\n  Value, ValuesMap,\n} from \"@itwin/presentation-common\";\nimport { ContentDataProvider, FieldHierarchyRecord, PropertyRecordsBuilder } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Interface for a data provider, which is used by ContentBuilder.\n * @public\n */\nexport interface IContentBuilderDataProvider {\n  /** Keys the data provider is creating content for */\n  keys: Readonly<KeySet>;\n  /** Get the size of content result set */\n  getContentSetSize: () => Promise<number>;\n  /** Get the content */\n  getContent: (options?: PageOptions) => Promise<Readonly<Content> | undefined>;\n}\n\n/**\n * Property records grouped under a single className\n * @public\n */\nexport interface ContentBuilderResult {\n  /** Full name of ECClass whose records are contained in this data structure */\n  className: string;\n  /** Property records for the ECClass instance */\n  records: PropertyRecord[];\n}\n\n/**\n * Properties for creating a `ContentBuilder` instance.\n * @public\n */\nexport interface ContentBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n\n  /** Custom data provider that allows mocking data ContentBuilder receives */\n  dataProvider?: IContentBuilderDataProvider;\n\n  /**\n   * Decimal precision or numeric types.\n   *\n   * Raw numeric values with high precision may slightly differ from platform to platform due to\n   * rounding differences on different platforms. This may be a problem when used with snapshot testing,\n   * in which case this attribute may be set to supply the maximum precision of raw numeric values.\n   *\n   * By default no rounding is applied.\n   */\n  decimalPrecision?: number;\n}\n\n/**\n * A class that constructs content from specified imodel and ruleset.\n * @public\n */\nexport class ContentBuilder {\n  private readonly _iModel: IModelConnection;\n  private _dataProvider: IContentBuilderDataProvider | undefined;\n  private _decimalPrecision?: number;\n\n  /**\n   * Constructor\n   * @param iModel\n   * @param dataProvider\n   */\n  constructor(props: ContentBuilderProps) {\n    this._iModel = props.imodel;\n    this._dataProvider = props.dataProvider;\n    this._decimalPrecision = props.decimalPrecision;\n  }\n\n  private async doCreateContent(rulesetId: string, instanceKeys: InstanceKey[], displayType: string): Promise<PropertyRecord[]> {\n    const dataProvider = this._dataProvider ? this._dataProvider : new ContentDataProvider({ imodel: this._iModel, ruleset: rulesetId, displayType });\n    dataProvider.keys = new KeySet(instanceKeys);\n\n    const content = await dataProvider.getContent();\n    if (!content)\n      return [];\n\n    const accumulator = new PropertyRecordsAccumulator(this._decimalPrecision);\n    traverseContent(accumulator, content);\n    return accumulator.records;\n  }\n\n  /**\n   * Create a list of property records using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   * @param instanceKeys Keys of instances that should be queried.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   */\n  public async createContent(rulesetOrId: Ruleset | string, instanceKeys: InstanceKey[], displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateContent(rulesetOrId, instanceKeys, displayType);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateContent(ruleset.id, instanceKeys, displayType);\n    });\n  }\n\n  private async getECClassNames(): Promise<Array<{ schemaName: string, className: string }>> {\n    const rows = [];\n    for await (const row of this._iModel.query(`\n      SELECT s.Name schemaName, c.Name className FROM meta.ECClassDef c\n      INNER JOIN meta.ECSchemaDef s ON c.Schema.id = s.ECInstanceId\n      WHERE c.Modifier <> 1 AND c.Type = 0\n      ORDER BY s.Name, c.Name\n    `, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames })) {\n      rows.push(row);\n    }\n    return rows;\n  }\n\n  private async createContentForClasses(rulesetOrId: Ruleset | string, limitInstances: boolean, displayType: string) {\n    const classNameEntries = await this.getECClassNames();\n\n    const contents: ContentBuilderResult[] = [];\n\n    for (const nameEntry of classNameEntries) {\n      // try {\n      const instanceIds = [];\n      for await (const row of this._iModel.query(`\n      SELECT ECInstanceId FROM ONLY \"${nameEntry.schemaName}\".\"${nameEntry.className}\"\n      ORDER BY ECInstanceId`, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames, limit: { count: limitInstances ? 1 : 4000 } })) {\n        instanceIds.push(row.id);\n      }\n\n      if (!instanceIds.length)\n        continue;\n\n      const instanceKeys = instanceIds.map((idEntry) => ({ className: `${nameEntry.schemaName}:${nameEntry.className}`, id: idEntry } as InstanceKey));\n\n      contents.push({\n        className: `${nameEntry.schemaName}:${nameEntry.className}`,\n        records: await this.createContent(rulesetOrId, instanceKeys, displayType),\n      });\n    }\n\n    return contents;\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes all of the class instances.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForAllInstances(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, false, displayType);\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes at most one class instance.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForInstancePerClass(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, true, displayType);\n  }\n}\n\nclass PropertyRecordsAccumulator extends PropertyRecordsBuilder {\n  private _records: PropertyRecord[] = [];\n  private _decimalPrecision?: number;\n\n  public constructor(decimalPrecision?: number) {\n    super();\n    this._decimalPrecision = decimalPrecision;\n  }\n\n  public get records(): PropertyRecord[] {\n    return this._records;\n  }\n\n  protected createRootPropertiesAppender() {\n    return {\n      append: (record: FieldHierarchyRecord) => {\n        this._records.push(record.record);\n      },\n    };\n  }\n\n  private processRawValue(value: Value): Value {\n    if (this._decimalPrecision === undefined)\n      return value;\n\n    if (typeof value === \"number\") {\n      return +(Number(value)).toFixed(this._decimalPrecision);\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((item) => this.processRawValue(item));\n    }\n\n    if (value instanceof Object) {\n      const res: ValuesMap = {};\n      Object.entries(value).forEach(([key, memberValue]) => {\n        res[key] = this.processRawValue(memberValue);\n      });\n      return res;\n    }\n\n    return value;\n  }\n\n  public override processPrimitiveValue(props: ProcessPrimitiveValueProps) {\n    super.processPrimitiveValue({ ...props, rawValue: this.processRawValue(props.rawValue) });\n  }\n}\n"]}
+{"version":3,"file":"ContentBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/ContentBuilder.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/** @packageDocumentation\n * @module Content\n */\n\nimport { PropertyRecord } from \"@itwin/appui-abstract\";\nimport { using } from \"@itwin/core-bentley\";\nimport { QueryRowFormat } from \"@itwin/core-common\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport {\n  Content, DefaultContentDisplayTypes, InstanceKey, KeySet, PageOptions, ProcessPrimitiveValueProps, RegisteredRuleset, Ruleset, traverseContent,\n  Value, ValuesMap,\n} from \"@itwin/presentation-common\";\nimport { ContentDataProvider, FieldHierarchyRecord, PropertyRecordsBuilder } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Interface for a data provider, which is used by ContentBuilder.\n * @public\n */\nexport interface IContentBuilderDataProvider {\n  /** Keys the data provider is creating content for */\n  keys: Readonly<KeySet>;\n  /** Get the size of content result set */\n  getContentSetSize: () => Promise<number>;\n  /** Get the content */\n  getContent: (options?: PageOptions) => Promise<Readonly<Content> | undefined>;\n}\n\n/**\n * Property records grouped under a single className\n * @public\n */\nexport interface ContentBuilderResult {\n  /** Full name of ECClass whose records are contained in this data structure */\n  className: string;\n  /** Property records for the ECClass instance */\n  records: PropertyRecord[];\n}\n\n/**\n * Properties for creating a `ContentBuilder` instance.\n * @public\n */\nexport interface ContentBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n\n  /** Custom data provider that allows mocking data ContentBuilder receives */\n  dataProvider?: IContentBuilderDataProvider;\n\n  /**\n   * Decimal precision or numeric types.\n   *\n   * Raw numeric values with high precision may slightly differ from platform to platform due to\n   * rounding differences on different platforms. This may be a problem when used with snapshot testing,\n   * in which case this attribute may be set to supply the maximum precision of raw numeric values.\n   *\n   * By default no rounding is applied.\n   */\n  decimalPrecision?: number;\n}\n\n/**\n * A class that constructs content from specified imodel and ruleset.\n * @public\n */\nexport class ContentBuilder {\n  private readonly _iModel: IModelConnection;\n  private _dataProvider: IContentBuilderDataProvider | undefined;\n  private _decimalPrecision?: number;\n\n  /**\n   * Constructor\n   * @param iModel\n   * @param dataProvider\n   */\n  constructor(props: ContentBuilderProps) {\n    this._iModel = props.imodel;\n    this._dataProvider = props.dataProvider;\n    this._decimalPrecision = props.decimalPrecision;\n  }\n\n  private async doCreateContent(rulesetId: string, instanceKeys: InstanceKey[], displayType: string): Promise<PropertyRecord[]> {\n    const dataProvider = this._dataProvider ? this._dataProvider : new ContentDataProvider({ imodel: this._iModel, ruleset: rulesetId, displayType });\n    dataProvider.keys = new KeySet(instanceKeys);\n\n    const content = await dataProvider.getContent();\n    if (!content)\n      return [];\n\n    const accumulator = new PropertyRecordsAccumulator(this._decimalPrecision);\n    traverseContent(accumulator, content);\n    return accumulator.records;\n  }\n\n  /**\n   * Create a list of property records using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   * @param instanceKeys Keys of instances that should be queried.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   */\n  public async createContent(rulesetOrId: Ruleset | string, instanceKeys: InstanceKey[], displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateContent(rulesetOrId, instanceKeys, displayType);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateContent(ruleset.id, instanceKeys, displayType);\n    });\n  }\n\n  private async getECClassNames(): Promise<Array<{ schemaName: string, className: string }>> {\n    const rows = [];\n    for await (const row of this._iModel.query(`\n      SELECT s.Name schemaName, c.Name className FROM meta.ECClassDef c\n      INNER JOIN meta.ECSchemaDef s ON c.Schema.id = s.ECInstanceId\n      WHERE c.Modifier <> 1 AND c.Type = 0\n      ORDER BY s.Name, c.Name\n    `, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames })) {\n      rows.push(row);\n    }\n    return rows;\n  }\n\n  private async createContentForClasses(rulesetOrId: Ruleset | string, limitInstances: boolean, displayType: string) {\n    const classNameEntries = await this.getECClassNames();\n\n    const contents: ContentBuilderResult[] = [];\n\n    for (const nameEntry of classNameEntries) {\n      // try {\n      const instanceIds = [];\n      for await (const row of this._iModel.query(`\n      SELECT ECInstanceId FROM ONLY \"${nameEntry.schemaName}\".\"${nameEntry.className}\"\n      ORDER BY ECInstanceId`, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames, limit: { count: limitInstances ? 1 : 4000 } })) {\n        instanceIds.push(row.id);\n      }\n\n      if (!instanceIds.length)\n        continue;\n\n      const instanceKeys = instanceIds.map((idEntry) => ({ className: `${nameEntry.schemaName}:${nameEntry.className}`, id: idEntry } as InstanceKey));\n\n      contents.push({\n        className: `${nameEntry.schemaName}:${nameEntry.className}`,\n        records: await this.createContent(rulesetOrId, instanceKeys, displayType),\n      });\n    }\n\n    return contents;\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes all of the class instances.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForAllInstances(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, false, displayType);\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes at most one class instance.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForInstancePerClass(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, true, displayType);\n  }\n}\n\nclass PropertyRecordsAccumulator extends PropertyRecordsBuilder {\n  private _records: PropertyRecord[] = [];\n  private _decimalPrecision?: number;\n\n  public constructor(decimalPrecision?: number) {\n    super();\n    this._decimalPrecision = decimalPrecision;\n  }\n\n  public get records(): PropertyRecord[] {\n    return this._records;\n  }\n\n  protected createRootPropertiesAppender() {\n    return {\n      append: (record: FieldHierarchyRecord) => {\n        this._records.push(record.record);\n      },\n    };\n  }\n\n  private processRawValue(value: Value): Value {\n    if (this._decimalPrecision === undefined)\n      return value;\n\n    if (typeof value === \"number\") {\n      return +(Number(value)).toFixed(this._decimalPrecision);\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((item) => this.processRawValue(item));\n    }\n\n    if (value instanceof Object) {\n      const res: ValuesMap = {};\n      Object.entries(value).forEach(([key, memberValue]) => {\n        res[key] = this.processRawValue(memberValue);\n      });\n      return res;\n    }\n\n    return value;\n  }\n\n  public override processPrimitiveValue(props: ProcessPrimitiveValueProps) {\n    super.processPrimitiveValue({ ...props, rawValue: this.processRawValue(props.rawValue) });\n  }\n}\n"]}

package/lib/cjs/presentation-testing/HierarchyBuilder.d.ts

@@ -63,7 +63,7 @@ export declare class HierarchyBuilder {
     private doCreateHierarchy;
     /**
      * Create a hierarchy using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      */
     createHierarchy(rulesetOrId: Ruleset | string): Promise<HierarchyNode[]>;
 }

package/lib/cjs/presentation-testing/HierarchyBuilder.js

@@ -65,7 +65,7 @@ class HierarchyBuilder {
     }
     /**
      * Create a hierarchy using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      */
     async createHierarchy(rulesetOrId) {
         if (typeof rulesetOrId === "string")

package/lib/cjs/presentation-testing/HierarchyBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/HierarchyBuilder.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAA4C;AAG5C,4EAAwG;AACxG,wEAA4D;AA8B5D;;;GAGG;AACI,MAAM,sBAAsB,GAAoB,CAAC,IAAkB,EAAE,EAAE;IAC5E,mEAAmE;IACnE,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,wDAAwD;IACtG,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AANW,QAAA,sBAAsB,0BAMjC;AAiBF;;;;;GAKG;AACH,MAAa,gBAAgB;IAI3B,kBAAkB;IAClB,YAAY,KAA4B;QAJxC;;;;;WAA2C;QAC3C;;;;;WAAmD;QAIjD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,eAAe,IAAI,8BAAsB,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,KAAqB,EAAE,YAA0C;QAChG,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACxB,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,GAAI,IAAiC,CAAC;YACvE,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC;YACvE,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;SAC3F;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC/C,MAAM,YAAY,GAAG,IAAI,sDAA4B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACpG,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,eAAe,CAAC,WAA6B;QACxD,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAE7C,OAAO,IAAA,oBAAK,EAAC,MAAM,oCAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE;YAC7G,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAxCD,4CAwCC","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/** @packageDocumentation\n * @module Hierarchies\n */\n\nimport { TreeNodeItem } from \"@itwin/components-react\";\nimport { using } from \"@itwin/core-bentley\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport { Omit, RegisteredRuleset, Ruleset } from \"@itwin/presentation-common\";\nimport { PresentationTreeDataProvider, PresentationTreeNodeItem } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Structure that describes a Node with any indexed properties\n * except `children`.\n *\n * @public\n */\nexport interface MappedNode {\n  /** Indexer for all properties in this data structure */\n  [index: string]: any;\n  /** Prohibited property */\n  children?: never;\n}\n\n/**\n * Node in a hierarchy.\n * @public\n */\nexport interface HierarchyNode extends Omit<MappedNode, \"children\"> {\n  /** Children of this node */\n  children?: HierarchyNode[];\n}\n\n/**\n * A function that converts `TreeNodeItem` into a new custom object.\n * @public\n */\nexport type NodeMappingFunc = (node: TreeNodeItem) => MappedNode;\n\n/**\n * Default [[NodeMappingFunc]] implementation that outputs the whole `TreeNodeItem` object.\n * @public\n */\nexport const defaultNodeMappingFunc: NodeMappingFunc = (node: TreeNodeItem) => {\n  // Skip properties 'id', 'parentId' as they contain  internal stuff\n  // that callers are most likely not interested in. Otherwise they can supply\n  // a custom `NodeMappingFunc` that does return those properties as well.\n  const { id, parentId, ...resultNode } = node; // eslint-disable-line @typescript-eslint/no-unused-vars\n  return resultNode;\n};\n\n/**\n * Properties for creating a `HierarchyBuilder` instance.\n * @public\n */\nexport interface HierarchyBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n  /**\n   * A function that maps node to something that the user of\n   * this API is interested in. E.g. custom implementation may skip some unimportant\n   * node properties to make resulting object smaller and easier to read.\n   */\n  nodeMappingFunc?: NodeMappingFunc;\n}\n\n/**\n * A class that constructs simple node hierarchy from specified\n * imodel and ruleset.\n *\n * @public\n */\nexport class HierarchyBuilder {\n  private readonly _iModel: IModelConnection;\n  private readonly _nodeMappingFunc: NodeMappingFunc;\n\n  /** Constructor */\n  constructor(props: HierarchyBuilderProps) {\n    this._iModel = props.imodel;\n    this._nodeMappingFunc = props.nodeMappingFunc ?? defaultNodeMappingFunc;\n  }\n\n  private async createSubHierarchy(nodes: TreeNodeItem[], dataProvider: PresentationTreeDataProvider) {\n    const hierarchy: HierarchyNode[] = [];\n    for (const node of nodes) {\n      const { key: _key, ...nodeNoKey } = (node as PresentationTreeNodeItem);\n      const nodeIndex = hierarchy.push(this._nodeMappingFunc(nodeNoKey)) - 1;\n      const childNodes = await dataProvider.getNodes(node);\n      if (childNodes.length > 0)\n        hierarchy[nodeIndex].children = await this.createSubHierarchy(childNodes, dataProvider);\n    }\n    return hierarchy;\n  }\n\n  private async doCreateHierarchy(rulesetId: string): Promise<HierarchyNode[]> {\n    const dataProvider = new PresentationTreeDataProvider({ imodel: this._iModel, ruleset: rulesetId });\n    const rootNodes = await dataProvider.getNodes();\n    return this.createSubHierarchy(rootNodes, dataProvider);\n  }\n\n  /**\n   * Create a hierarchy using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   */\n  public async createHierarchy(rulesetOrId: Ruleset | string): Promise<HierarchyNode[]> {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateHierarchy(rulesetOrId);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateHierarchy(ruleset.id);\n    });\n  }\n}\n"]}
+{"version":3,"file":"HierarchyBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/HierarchyBuilder.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAA4C;AAG5C,4EAAwG;AACxG,wEAA4D;AA8B5D;;;GAGG;AACI,MAAM,sBAAsB,GAAoB,CAAC,IAAkB,EAAE,EAAE;IAC5E,mEAAmE;IACnE,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,wDAAwD;IACtG,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AANW,QAAA,sBAAsB,0BAMjC;AAiBF;;;;;GAKG;AACH,MAAa,gBAAgB;IAI3B,kBAAkB;IAClB,YAAY,KAA4B;QAJxC;;;;;WAA2C;QAC3C;;;;;WAAmD;QAIjD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,eAAe,IAAI,8BAAsB,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,KAAqB,EAAE,YAA0C;QAChG,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACxB,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,GAAI,IAAiC,CAAC;YACvE,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC;YACvE,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;SAC3F;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC/C,MAAM,YAAY,GAAG,IAAI,sDAA4B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACpG,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,eAAe,CAAC,WAA6B;QACxD,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAE7C,OAAO,IAAA,oBAAK,EAAC,MAAM,oCAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE;YAC7G,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAxCD,4CAwCC","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/** @packageDocumentation\n * @module Hierarchies\n */\n\nimport { TreeNodeItem } from \"@itwin/components-react\";\nimport { using } from \"@itwin/core-bentley\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport { Omit, RegisteredRuleset, Ruleset } from \"@itwin/presentation-common\";\nimport { PresentationTreeDataProvider, PresentationTreeNodeItem } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Structure that describes a Node with any indexed properties\n * except `children`.\n *\n * @public\n */\nexport interface MappedNode {\n  /** Indexer for all properties in this data structure */\n  [index: string]: any;\n  /** Prohibited property */\n  children?: never;\n}\n\n/**\n * Node in a hierarchy.\n * @public\n */\nexport interface HierarchyNode extends Omit<MappedNode, \"children\"> {\n  /** Children of this node */\n  children?: HierarchyNode[];\n}\n\n/**\n * A function that converts `TreeNodeItem` into a new custom object.\n * @public\n */\nexport type NodeMappingFunc = (node: TreeNodeItem) => MappedNode;\n\n/**\n * Default [[NodeMappingFunc]] implementation that outputs the whole `TreeNodeItem` object.\n * @public\n */\nexport const defaultNodeMappingFunc: NodeMappingFunc = (node: TreeNodeItem) => {\n  // Skip properties 'id', 'parentId' as they contain  internal stuff\n  // that callers are most likely not interested in. Otherwise they can supply\n  // a custom `NodeMappingFunc` that does return those properties as well.\n  const { id, parentId, ...resultNode } = node; // eslint-disable-line @typescript-eslint/no-unused-vars\n  return resultNode;\n};\n\n/**\n * Properties for creating a `HierarchyBuilder` instance.\n * @public\n */\nexport interface HierarchyBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n  /**\n   * A function that maps node to something that the user of\n   * this API is interested in. E.g. custom implementation may skip some unimportant\n   * node properties to make resulting object smaller and easier to read.\n   */\n  nodeMappingFunc?: NodeMappingFunc;\n}\n\n/**\n * A class that constructs simple node hierarchy from specified\n * imodel and ruleset.\n *\n * @public\n */\nexport class HierarchyBuilder {\n  private readonly _iModel: IModelConnection;\n  private readonly _nodeMappingFunc: NodeMappingFunc;\n\n  /** Constructor */\n  constructor(props: HierarchyBuilderProps) {\n    this._iModel = props.imodel;\n    this._nodeMappingFunc = props.nodeMappingFunc ?? defaultNodeMappingFunc;\n  }\n\n  private async createSubHierarchy(nodes: TreeNodeItem[], dataProvider: PresentationTreeDataProvider) {\n    const hierarchy: HierarchyNode[] = [];\n    for (const node of nodes) {\n      const { key: _key, ...nodeNoKey } = (node as PresentationTreeNodeItem);\n      const nodeIndex = hierarchy.push(this._nodeMappingFunc(nodeNoKey)) - 1;\n      const childNodes = await dataProvider.getNodes(node);\n      if (childNodes.length > 0)\n        hierarchy[nodeIndex].children = await this.createSubHierarchy(childNodes, dataProvider);\n    }\n    return hierarchy;\n  }\n\n  private async doCreateHierarchy(rulesetId: string): Promise<HierarchyNode[]> {\n    const dataProvider = new PresentationTreeDataProvider({ imodel: this._iModel, ruleset: rulesetId });\n    const rootNodes = await dataProvider.getNodes();\n    return this.createSubHierarchy(rootNodes, dataProvider);\n  }\n\n  /**\n   * Create a hierarchy using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   */\n  public async createHierarchy(rulesetOrId: Ruleset | string): Promise<HierarchyNode[]> {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateHierarchy(rulesetOrId);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateHierarchy(ruleset.id);\n    });\n  }\n}\n"]}

package/lib/esm/presentation-testing/ContentBuilder.d.ts

@@ -63,7 +63,7 @@ export declare class ContentBuilder {
     private doCreateContent;
     /**
      * Create a list of property records using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param instanceKeys Keys of instances that should be queried.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
@@ -74,7 +74,7 @@ export declare class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes all of the class instances.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.
@@ -83,7 +83,7 @@ export declare class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes at most one class instance.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.

package/lib/esm/presentation-testing/ContentBuilder.js

@@ -55,7 +55,7 @@ export class ContentBuilder {
     }
     /**
      * Create a list of property records using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param instanceKeys Keys of instances that should be queried.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
@@ -103,7 +103,7 @@ export class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes all of the class instances.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.
@@ -114,7 +114,7 @@ export class ContentBuilder {
     /**
      * Create a list of grouped property records using the supplied presentation ruleset.
      * Each group includes at most one class instance.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      * @param displayType Type of content container display. For example:
      * "PropertyPane", "Grid", "List" etc.
      * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.

package/lib/esm/presentation-testing/ContentBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContentBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/ContentBuilder.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/** @packageDocumentation\n * @module Content\n */\n\nimport { PropertyRecord } from \"@itwin/appui-abstract\";\nimport { using } from \"@itwin/core-bentley\";\nimport { QueryRowFormat } from \"@itwin/core-common\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport {\n  Content, DefaultContentDisplayTypes, InstanceKey, KeySet, PageOptions, ProcessPrimitiveValueProps, RegisteredRuleset, Ruleset, traverseContent,\n  Value, ValuesMap,\n} from \"@itwin/presentation-common\";\nimport { ContentDataProvider, FieldHierarchyRecord, PropertyRecordsBuilder } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Interface for a data provider, which is used by ContentBuilder.\n * @public\n */\nexport interface IContentBuilderDataProvider {\n  /** Keys the data provider is creating content for */\n  keys: Readonly<KeySet>;\n  /** Get the size of content result set */\n  getContentSetSize: () => Promise<number>;\n  /** Get the content */\n  getContent: (options?: PageOptions) => Promise<Readonly<Content> | undefined>;\n}\n\n/**\n * Property records grouped under a single className\n * @public\n */\nexport interface ContentBuilderResult {\n  /** Full name of ECClass whose records are contained in this data structure */\n  className: string;\n  /** Property records for the ECClass instance */\n  records: PropertyRecord[];\n}\n\n/**\n * Properties for creating a `ContentBuilder` instance.\n * @public\n */\nexport interface ContentBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n\n  /** Custom data provider that allows mocking data ContentBuilder receives */\n  dataProvider?: IContentBuilderDataProvider;\n\n  /**\n   * Decimal precision or numeric types.\n   *\n   * Raw numeric values with high precision may slightly differ from platform to platform due to\n   * rounding differences on different platforms. This may be a problem when used with snapshot testing,\n   * in which case this attribute may be set to supply the maximum precision of raw numeric values.\n   *\n   * By default no rounding is applied.\n   */\n  decimalPrecision?: number;\n}\n\n/**\n * A class that constructs content from specified imodel and ruleset.\n * @public\n */\nexport class ContentBuilder {\n  private readonly _iModel: IModelConnection;\n  private _dataProvider: IContentBuilderDataProvider | undefined;\n  private _decimalPrecision?: number;\n\n  /**\n   * Constructor\n   * @param iModel\n   * @param dataProvider\n   */\n  constructor(props: ContentBuilderProps) {\n    this._iModel = props.imodel;\n    this._dataProvider = props.dataProvider;\n    this._decimalPrecision = props.decimalPrecision;\n  }\n\n  private async doCreateContent(rulesetId: string, instanceKeys: InstanceKey[], displayType: string): Promise<PropertyRecord[]> {\n    const dataProvider = this._dataProvider ? this._dataProvider : new ContentDataProvider({ imodel: this._iModel, ruleset: rulesetId, displayType });\n    dataProvider.keys = new KeySet(instanceKeys);\n\n    const content = await dataProvider.getContent();\n    if (!content)\n      return [];\n\n    const accumulator = new PropertyRecordsAccumulator(this._decimalPrecision);\n    traverseContent(accumulator, content);\n    return accumulator.records;\n  }\n\n  /**\n   * Create a list of property records using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   * @param instanceKeys Keys of instances that should be queried.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   */\n  public async createContent(rulesetOrId: Ruleset | string, instanceKeys: InstanceKey[], displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateContent(rulesetOrId, instanceKeys, displayType);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateContent(ruleset.id, instanceKeys, displayType);\n    });\n  }\n\n  private async getECClassNames(): Promise<Array<{ schemaName: string, className: string }>> {\n    const rows = [];\n    for await (const row of this._iModel.query(`\n      SELECT s.Name schemaName, c.Name className FROM meta.ECClassDef c\n      INNER JOIN meta.ECSchemaDef s ON c.Schema.id = s.ECInstanceId\n      WHERE c.Modifier <> 1 AND c.Type = 0\n      ORDER BY s.Name, c.Name\n    `, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames })) {\n      rows.push(row);\n    }\n    return rows;\n  }\n\n  private async createContentForClasses(rulesetOrId: Ruleset | string, limitInstances: boolean, displayType: string) {\n    const classNameEntries = await this.getECClassNames();\n\n    const contents: ContentBuilderResult[] = [];\n\n    for (const nameEntry of classNameEntries) {\n      // try {\n      const instanceIds = [];\n      for await (const row of this._iModel.query(`\n      SELECT ECInstanceId FROM ONLY \"${nameEntry.schemaName}\".\"${nameEntry.className}\"\n      ORDER BY ECInstanceId`, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames, limit: { count: limitInstances ? 1 : 4000 } })) {\n        instanceIds.push(row.id);\n      }\n\n      if (!instanceIds.length)\n        continue;\n\n      const instanceKeys = instanceIds.map((idEntry) => ({ className: `${nameEntry.schemaName}:${nameEntry.className}`, id: idEntry } as InstanceKey));\n\n      contents.push({\n        className: `${nameEntry.schemaName}:${nameEntry.className}`,\n        records: await this.createContent(rulesetOrId, instanceKeys, displayType),\n      });\n    }\n\n    return contents;\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes all of the class instances.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForAllInstances(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, false, displayType);\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes at most one class instance.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForInstancePerClass(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, true, displayType);\n  }\n}\n\nclass PropertyRecordsAccumulator extends PropertyRecordsBuilder {\n  private _records: PropertyRecord[] = [];\n  private _decimalPrecision?: number;\n\n  public constructor(decimalPrecision?: number) {\n    super();\n    this._decimalPrecision = decimalPrecision;\n  }\n\n  public get records(): PropertyRecord[] {\n    return this._records;\n  }\n\n  protected createRootPropertiesAppender() {\n    return {\n      append: (record: FieldHierarchyRecord) => {\n        this._records.push(record.record);\n      },\n    };\n  }\n\n  private processRawValue(value: Value): Value {\n    if (this._decimalPrecision === undefined)\n      return value;\n\n    if (typeof value === \"number\") {\n      return +(Number(value)).toFixed(this._decimalPrecision);\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((item) => this.processRawValue(item));\n    }\n\n    if (value instanceof Object) {\n      const res: ValuesMap = {};\n      Object.entries(value).forEach(([key, memberValue]) => {\n        res[key] = this.processRawValue(memberValue);\n      });\n      return res;\n    }\n\n    return value;\n  }\n\n  public override processPrimitiveValue(props: ProcessPrimitiveValueProps) {\n    super.processPrimitiveValue({ ...props, rawValue: this.processRawValue(props.rawValue) });\n  }\n}\n"]}
+{"version":3,"file":"ContentBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/ContentBuilder.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACI,0BAA0B,EAAe,MAAM,EAAuE,eAAe,GAE/I,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAwB,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAiD5D;;;GAGG;AACH,MAAM,OAAO,cAAc;IAKzB;;;;OAIG;IACH,YAAY,KAA0B;QATtC;;;;;WAA2C;QAC3C;;;;;WAA+D;QAC/D;;;;;WAAmC;QAQjC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,SAAiB,EAAE,YAA2B,EAAE,WAAmB;QAC/F,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAClJ,YAAY,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QAE7C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QAChD,IAAI,CAAC,OAAO;YACV,OAAO,EAAE,CAAC;QAEZ,MAAM,WAAW,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC3E,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,aAAa,CAAC,WAA6B,EAAE,YAA2B,EAAE,cAAsB,0BAA0B,CAAC,YAAY;QAClJ,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,OAAO,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAEtE,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE;YAC7G,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,IAAI,GAAG,EAAE,CAAC;QAChB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;;;;;KAK1C,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,kBAAkB,EAAE,CAAC,EAAE;YAC/D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAChB;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,uBAAuB,CAAC,WAA6B,EAAE,cAAuB,EAAE,WAAmB;QAC/G,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAEtD,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAE5C,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE;YACxC,QAAQ;YACR,MAAM,WAAW,GAAG,EAAE,CAAC;YACvB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;uCACV,SAAS,CAAC,UAAU,MAAM,SAAS,CAAC,SAAS;4BACxD,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,kBAAkB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;gBACjI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aAC1B;YAED,IAAI,CAAC,WAAW,CAAC,MAAM;gBACrB,SAAS;YAEX,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,EAAkB,CAAA,CAAC,CAAC;YAEjJ,QAAQ,CAAC,IAAI,CAAC;gBACZ,SAAS,EAAE,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,SAAS,EAAE;gBAC3D,OAAO,EAAE,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC;aAC1E,CAAC,CAAC;SACJ;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,4BAA4B,CAAC,WAA6B,EAAE,cAAsB,0BAA0B,CAAC,YAAY;QACpI,OAAO,IAAI,CAAC,uBAAuB,CAAC,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,gCAAgC,CAAC,WAA6B,EAAE,cAAsB,0BAA0B,CAAC,YAAY;QACxI,OAAO,IAAI,CAAC,uBAAuB,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,0BAA2B,SAAQ,sBAAsB;IAI7D,YAAmB,gBAAyB;QAC1C,KAAK,EAAE,CAAC;QAJV;;;;mBAAqC,EAAE;WAAC;QACxC;;;;;WAAmC;QAIjC,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAC5C,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAES,4BAA4B;QACpC,OAAO;YACL,MAAM,EAAE,CAAC,MAA4B,EAAE,EAAE;gBACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,KAAY;QAClC,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACtC,OAAO,KAAK,CAAC;QAEf,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC7B,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;SACzD;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACxB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;SACxD;QAED,IAAI,KAAK,YAAY,MAAM,EAAE;YAC3B,MAAM,GAAG,GAAc,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE;gBACnD,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;SACZ;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEe,qBAAqB,CAAC,KAAiC;QACrE,KAAK,CAAC,qBAAqB,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Content\n */\n\nimport { PropertyRecord } from \"@itwin/appui-abstract\";\nimport { using } from \"@itwin/core-bentley\";\nimport { QueryRowFormat } from \"@itwin/core-common\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport {\n  Content, DefaultContentDisplayTypes, InstanceKey, KeySet, PageOptions, ProcessPrimitiveValueProps, RegisteredRuleset, Ruleset, traverseContent,\n  Value, ValuesMap,\n} from \"@itwin/presentation-common\";\nimport { ContentDataProvider, FieldHierarchyRecord, PropertyRecordsBuilder } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Interface for a data provider, which is used by ContentBuilder.\n * @public\n */\nexport interface IContentBuilderDataProvider {\n  /** Keys the data provider is creating content for */\n  keys: Readonly<KeySet>;\n  /** Get the size of content result set */\n  getContentSetSize: () => Promise<number>;\n  /** Get the content */\n  getContent: (options?: PageOptions) => Promise<Readonly<Content> | undefined>;\n}\n\n/**\n * Property records grouped under a single className\n * @public\n */\nexport interface ContentBuilderResult {\n  /** Full name of ECClass whose records are contained in this data structure */\n  className: string;\n  /** Property records for the ECClass instance */\n  records: PropertyRecord[];\n}\n\n/**\n * Properties for creating a `ContentBuilder` instance.\n * @public\n */\nexport interface ContentBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n\n  /** Custom data provider that allows mocking data ContentBuilder receives */\n  dataProvider?: IContentBuilderDataProvider;\n\n  /**\n   * Decimal precision or numeric types.\n   *\n   * Raw numeric values with high precision may slightly differ from platform to platform due to\n   * rounding differences on different platforms. This may be a problem when used with snapshot testing,\n   * in which case this attribute may be set to supply the maximum precision of raw numeric values.\n   *\n   * By default no rounding is applied.\n   */\n  decimalPrecision?: number;\n}\n\n/**\n * A class that constructs content from specified imodel and ruleset.\n * @public\n */\nexport class ContentBuilder {\n  private readonly _iModel: IModelConnection;\n  private _dataProvider: IContentBuilderDataProvider | undefined;\n  private _decimalPrecision?: number;\n\n  /**\n   * Constructor\n   * @param iModel\n   * @param dataProvider\n   */\n  constructor(props: ContentBuilderProps) {\n    this._iModel = props.imodel;\n    this._dataProvider = props.dataProvider;\n    this._decimalPrecision = props.decimalPrecision;\n  }\n\n  private async doCreateContent(rulesetId: string, instanceKeys: InstanceKey[], displayType: string): Promise<PropertyRecord[]> {\n    const dataProvider = this._dataProvider ? this._dataProvider : new ContentDataProvider({ imodel: this._iModel, ruleset: rulesetId, displayType });\n    dataProvider.keys = new KeySet(instanceKeys);\n\n    const content = await dataProvider.getContent();\n    if (!content)\n      return [];\n\n    const accumulator = new PropertyRecordsAccumulator(this._decimalPrecision);\n    traverseContent(accumulator, content);\n    return accumulator.records;\n  }\n\n  /**\n   * Create a list of property records using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   * @param instanceKeys Keys of instances that should be queried.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   */\n  public async createContent(rulesetOrId: Ruleset | string, instanceKeys: InstanceKey[], displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateContent(rulesetOrId, instanceKeys, displayType);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateContent(ruleset.id, instanceKeys, displayType);\n    });\n  }\n\n  private async getECClassNames(): Promise<Array<{ schemaName: string, className: string }>> {\n    const rows = [];\n    for await (const row of this._iModel.query(`\n      SELECT s.Name schemaName, c.Name className FROM meta.ECClassDef c\n      INNER JOIN meta.ECSchemaDef s ON c.Schema.id = s.ECInstanceId\n      WHERE c.Modifier <> 1 AND c.Type = 0\n      ORDER BY s.Name, c.Name\n    `, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames })) {\n      rows.push(row);\n    }\n    return rows;\n  }\n\n  private async createContentForClasses(rulesetOrId: Ruleset | string, limitInstances: boolean, displayType: string) {\n    const classNameEntries = await this.getECClassNames();\n\n    const contents: ContentBuilderResult[] = [];\n\n    for (const nameEntry of classNameEntries) {\n      // try {\n      const instanceIds = [];\n      for await (const row of this._iModel.query(`\n      SELECT ECInstanceId FROM ONLY \"${nameEntry.schemaName}\".\"${nameEntry.className}\"\n      ORDER BY ECInstanceId`, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames, limit: { count: limitInstances ? 1 : 4000 } })) {\n        instanceIds.push(row.id);\n      }\n\n      if (!instanceIds.length)\n        continue;\n\n      const instanceKeys = instanceIds.map((idEntry) => ({ className: `${nameEntry.schemaName}:${nameEntry.className}`, id: idEntry } as InstanceKey));\n\n      contents.push({\n        className: `${nameEntry.schemaName}:${nameEntry.className}`,\n        records: await this.createContent(rulesetOrId, instanceKeys, displayType),\n      });\n    }\n\n    return contents;\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes all of the class instances.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForAllInstances(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, false, displayType);\n  }\n\n  /**\n   * Create a list of grouped property records using the supplied presentation ruleset.\n   * Each group includes at most one class instance.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   * @param displayType Type of content container display. For example:\n   * \"PropertyPane\", \"Grid\", \"List\" etc.\n   * @deprecated in 3.x. This method turned out to be useless as it creates content for too many instances. Should use [[createContent]] instead.\n   */\n  public async createContentForInstancePerClass(rulesetOrId: Ruleset | string, displayType: string = DefaultContentDisplayTypes.PropertyPane) {\n    return this.createContentForClasses(rulesetOrId, true, displayType);\n  }\n}\n\nclass PropertyRecordsAccumulator extends PropertyRecordsBuilder {\n  private _records: PropertyRecord[] = [];\n  private _decimalPrecision?: number;\n\n  public constructor(decimalPrecision?: number) {\n    super();\n    this._decimalPrecision = decimalPrecision;\n  }\n\n  public get records(): PropertyRecord[] {\n    return this._records;\n  }\n\n  protected createRootPropertiesAppender() {\n    return {\n      append: (record: FieldHierarchyRecord) => {\n        this._records.push(record.record);\n      },\n    };\n  }\n\n  private processRawValue(value: Value): Value {\n    if (this._decimalPrecision === undefined)\n      return value;\n\n    if (typeof value === \"number\") {\n      return +(Number(value)).toFixed(this._decimalPrecision);\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((item) => this.processRawValue(item));\n    }\n\n    if (value instanceof Object) {\n      const res: ValuesMap = {};\n      Object.entries(value).forEach(([key, memberValue]) => {\n        res[key] = this.processRawValue(memberValue);\n      });\n      return res;\n    }\n\n    return value;\n  }\n\n  public override processPrimitiveValue(props: ProcessPrimitiveValueProps) {\n    super.processPrimitiveValue({ ...props, rawValue: this.processRawValue(props.rawValue) });\n  }\n}\n"]}

package/lib/esm/presentation-testing/HierarchyBuilder.d.ts

@@ -63,7 +63,7 @@ export declare class HierarchyBuilder {
     private doCreateHierarchy;
     /**
      * Create a hierarchy using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      */
     createHierarchy(rulesetOrId: Ruleset | string): Promise<HierarchyNode[]>;
 }

package/lib/esm/presentation-testing/HierarchyBuilder.js

@@ -61,7 +61,7 @@ export class HierarchyBuilder {
     }
     /**
      * Create a hierarchy using the supplied presentation ruleset.
-     * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.
+     * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.
      */
     async createHierarchy(rulesetOrId) {
         if (typeof rulesetOrId === "string")

package/lib/esm/presentation-testing/HierarchyBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/HierarchyBuilder.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EAAE,4BAA4B,EAA4B,MAAM,gCAAgC,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA8B5D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAoB,CAAC,IAAkB,EAAE,EAAE;IAC5E,mEAAmE;IACnE,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,wDAAwD;IACtG,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAiBF;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAI3B,kBAAkB;IAClB,YAAY,KAA4B;QAJxC;;;;;WAA2C;QAC3C;;;;;WAAmD;QAIjD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,eAAe,IAAI,sBAAsB,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,KAAqB,EAAE,YAA0C;QAChG,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACxB,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,GAAI,IAAiC,CAAC;YACvE,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC;YACvE,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;SAC3F;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC/C,MAAM,YAAY,GAAG,IAAI,4BAA4B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACpG,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,eAAe,CAAC,WAA6B;QACxD,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAE7C,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE;YAC7G,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Hierarchies\n */\n\nimport { TreeNodeItem } from \"@itwin/components-react\";\nimport { using } from \"@itwin/core-bentley\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport { Omit, RegisteredRuleset, Ruleset } from \"@itwin/presentation-common\";\nimport { PresentationTreeDataProvider, PresentationTreeNodeItem } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Structure that describes a Node with any indexed properties\n * except `children`.\n *\n * @public\n */\nexport interface MappedNode {\n  /** Indexer for all properties in this data structure */\n  [index: string]: any;\n  /** Prohibited property */\n  children?: never;\n}\n\n/**\n * Node in a hierarchy.\n * @public\n */\nexport interface HierarchyNode extends Omit<MappedNode, \"children\"> {\n  /** Children of this node */\n  children?: HierarchyNode[];\n}\n\n/**\n * A function that converts `TreeNodeItem` into a new custom object.\n * @public\n */\nexport type NodeMappingFunc = (node: TreeNodeItem) => MappedNode;\n\n/**\n * Default [[NodeMappingFunc]] implementation that outputs the whole `TreeNodeItem` object.\n * @public\n */\nexport const defaultNodeMappingFunc: NodeMappingFunc = (node: TreeNodeItem) => {\n  // Skip properties 'id', 'parentId' as they contain  internal stuff\n  // that callers are most likely not interested in. Otherwise they can supply\n  // a custom `NodeMappingFunc` that does return those properties as well.\n  const { id, parentId, ...resultNode } = node; // eslint-disable-line @typescript-eslint/no-unused-vars\n  return resultNode;\n};\n\n/**\n * Properties for creating a `HierarchyBuilder` instance.\n * @public\n */\nexport interface HierarchyBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n  /**\n   * A function that maps node to something that the user of\n   * this API is interested in. E.g. custom implementation may skip some unimportant\n   * node properties to make resulting object smaller and easier to read.\n   */\n  nodeMappingFunc?: NodeMappingFunc;\n}\n\n/**\n * A class that constructs simple node hierarchy from specified\n * imodel and ruleset.\n *\n * @public\n */\nexport class HierarchyBuilder {\n  private readonly _iModel: IModelConnection;\n  private readonly _nodeMappingFunc: NodeMappingFunc;\n\n  /** Constructor */\n  constructor(props: HierarchyBuilderProps) {\n    this._iModel = props.imodel;\n    this._nodeMappingFunc = props.nodeMappingFunc ?? defaultNodeMappingFunc;\n  }\n\n  private async createSubHierarchy(nodes: TreeNodeItem[], dataProvider: PresentationTreeDataProvider) {\n    const hierarchy: HierarchyNode[] = [];\n    for (const node of nodes) {\n      const { key: _key, ...nodeNoKey } = (node as PresentationTreeNodeItem);\n      const nodeIndex = hierarchy.push(this._nodeMappingFunc(nodeNoKey)) - 1;\n      const childNodes = await dataProvider.getNodes(node);\n      if (childNodes.length > 0)\n        hierarchy[nodeIndex].children = await this.createSubHierarchy(childNodes, dataProvider);\n    }\n    return hierarchy;\n  }\n\n  private async doCreateHierarchy(rulesetId: string): Promise<HierarchyNode[]> {\n    const dataProvider = new PresentationTreeDataProvider({ imodel: this._iModel, ruleset: rulesetId });\n    const rootNodes = await dataProvider.getNodes();\n    return this.createSubHierarchy(rootNodes, dataProvider);\n  }\n\n  /**\n   * Create a hierarchy using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [[Ruleset]] object or a ruleset id.\n   */\n  public async createHierarchy(rulesetOrId: Ruleset | string): Promise<HierarchyNode[]> {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateHierarchy(rulesetOrId);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateHierarchy(ruleset.id);\n    });\n  }\n}\n"]}
+{"version":3,"file":"HierarchyBuilder.js","sourceRoot":"","sources":["../../../src/presentation-testing/HierarchyBuilder.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EAAE,4BAA4B,EAA4B,MAAM,gCAAgC,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA8B5D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAoB,CAAC,IAAkB,EAAE,EAAE;IAC5E,mEAAmE;IACnE,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,wDAAwD;IACtG,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAiBF;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAI3B,kBAAkB;IAClB,YAAY,KAA4B;QAJxC;;;;;WAA2C;QAC3C;;;;;WAAmD;QAIjD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,eAAe,IAAI,sBAAsB,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,KAAqB,EAAE,YAA0C;QAChG,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACxB,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,GAAI,IAAiC,CAAC;YACvE,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC;YACvE,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;SAC3F;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC/C,MAAM,YAAY,GAAG,IAAI,4BAA4B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACpG,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,eAAe,CAAC,WAA6B;QACxD,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAE7C,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE;YAC7G,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Hierarchies\n */\n\nimport { TreeNodeItem } from \"@itwin/components-react\";\nimport { using } from \"@itwin/core-bentley\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport { Omit, RegisteredRuleset, Ruleset } from \"@itwin/presentation-common\";\nimport { PresentationTreeDataProvider, PresentationTreeNodeItem } from \"@itwin/presentation-components\";\nimport { Presentation } from \"@itwin/presentation-frontend\";\n\n/**\n * Structure that describes a Node with any indexed properties\n * except `children`.\n *\n * @public\n */\nexport interface MappedNode {\n  /** Indexer for all properties in this data structure */\n  [index: string]: any;\n  /** Prohibited property */\n  children?: never;\n}\n\n/**\n * Node in a hierarchy.\n * @public\n */\nexport interface HierarchyNode extends Omit<MappedNode, \"children\"> {\n  /** Children of this node */\n  children?: HierarchyNode[];\n}\n\n/**\n * A function that converts `TreeNodeItem` into a new custom object.\n * @public\n */\nexport type NodeMappingFunc = (node: TreeNodeItem) => MappedNode;\n\n/**\n * Default [[NodeMappingFunc]] implementation that outputs the whole `TreeNodeItem` object.\n * @public\n */\nexport const defaultNodeMappingFunc: NodeMappingFunc = (node: TreeNodeItem) => {\n  // Skip properties 'id', 'parentId' as they contain  internal stuff\n  // that callers are most likely not interested in. Otherwise they can supply\n  // a custom `NodeMappingFunc` that does return those properties as well.\n  const { id, parentId, ...resultNode } = node; // eslint-disable-line @typescript-eslint/no-unused-vars\n  return resultNode;\n};\n\n/**\n * Properties for creating a `HierarchyBuilder` instance.\n * @public\n */\nexport interface HierarchyBuilderProps {\n  /** The iModel to pull data from */\n  imodel: IModelConnection;\n  /**\n   * A function that maps node to something that the user of\n   * this API is interested in. E.g. custom implementation may skip some unimportant\n   * node properties to make resulting object smaller and easier to read.\n   */\n  nodeMappingFunc?: NodeMappingFunc;\n}\n\n/**\n * A class that constructs simple node hierarchy from specified\n * imodel and ruleset.\n *\n * @public\n */\nexport class HierarchyBuilder {\n  private readonly _iModel: IModelConnection;\n  private readonly _nodeMappingFunc: NodeMappingFunc;\n\n  /** Constructor */\n  constructor(props: HierarchyBuilderProps) {\n    this._iModel = props.imodel;\n    this._nodeMappingFunc = props.nodeMappingFunc ?? defaultNodeMappingFunc;\n  }\n\n  private async createSubHierarchy(nodes: TreeNodeItem[], dataProvider: PresentationTreeDataProvider) {\n    const hierarchy: HierarchyNode[] = [];\n    for (const node of nodes) {\n      const { key: _key, ...nodeNoKey } = (node as PresentationTreeNodeItem);\n      const nodeIndex = hierarchy.push(this._nodeMappingFunc(nodeNoKey)) - 1;\n      const childNodes = await dataProvider.getNodes(node);\n      if (childNodes.length > 0)\n        hierarchy[nodeIndex].children = await this.createSubHierarchy(childNodes, dataProvider);\n    }\n    return hierarchy;\n  }\n\n  private async doCreateHierarchy(rulesetId: string): Promise<HierarchyNode[]> {\n    const dataProvider = new PresentationTreeDataProvider({ imodel: this._iModel, ruleset: rulesetId });\n    const rootNodes = await dataProvider.getNodes();\n    return this.createSubHierarchy(rootNodes, dataProvider);\n  }\n\n  /**\n   * Create a hierarchy using the supplied presentation ruleset.\n   * @param rulesetOrId Either a [Ruleset]($presentation-common) object or a ruleset id.\n   */\n  public async createHierarchy(rulesetOrId: Ruleset | string): Promise<HierarchyNode[]> {\n    if (typeof rulesetOrId === \"string\")\n      return this.doCreateHierarchy(rulesetOrId);\n\n    return using(await Presentation.presentation.rulesets().add(rulesetOrId), async (ruleset: RegisteredRuleset) => {\n      return this.doCreateHierarchy(ruleset.id);\n    });\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/presentation-testing",
-  "version": "4.0.0-dev.18",
+  "version": "4.0.0-dev.19",
   "description": "Testing utilities for iTwin.js Presentation library",
   "license": "MIT",
   "repository": {
@@ -46,7 +46,7 @@
     "@itwin/presentation-backend": "^3.6.0 || ^4.0.0-dev.7",
     "@itwin/presentation-common": "^3.6.0 || ^4.0.0-dev.7",
     "@itwin/presentation-frontend": "^3.6.0 || ^4.0.0-dev.7",
-    "@itwin/presentation-components": "^4.0.0-dev.18"
+    "@itwin/presentation-components": "^4.0.0-dev.19"
   },
   "devDependencies": {
     "@itwin/appui-abstract": "4.0.0-dev.3",
@@ -64,7 +64,7 @@
     "@itwin/presentation-backend": "^4.0.0-dev.18",
     "@itwin/presentation-common": "^4.0.0-dev.18",
     "@itwin/presentation-frontend": "^4.0.0-dev.18",
-    "@itwin/presentation-components": "^4.0.0-dev.18",
+    "@itwin/presentation-components": "^4.0.0-dev.19",
     "@itwin/webgl-compatibility": "^4.0.0-dev.18",
     "@types/chai": "4.3.1",
     "@types/chai-as-promised": "^7",