@itwin/core-frontend 4.8.0-dev.3 → 4.8.0-dev.32

package/lib/cjs/RealityDataSourceTilesetUrlImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"RealityDataSourceTilesetUrlImpl.js","sourceRoot":"","sources":["../../src/RealityDataSourceTilesetUrlImpl.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F;;GAEG;AACH,sDAAwE;AACxE,oDAAoJ;AAEpJ,+CAA4C;AAE5C,8CAA8D;AAE9D;;;;;;EAME;AACF,MAAa,+BAA+B;IAO1C;;OAEG;IACH,YAAsB,KAA6B;QANnD,sIAAsI;QAC9H,aAAQ,GAAW,EAAE,CAAC;QAM5B,IAAA,qBAAM,EAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,KAAK,iCAAmB,CAAC,UAAU,IAAI,KAAK,CAAC,SAAS,CAAC,QAAQ,KAAK,iCAAmB,CAAC,WAAW,CAAC,CAAC;QACpI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,SAA+B,EAAE,QAAgC;QACjG,IAAI,SAAS,CAAC,QAAQ,KAAK,iCAAmB,CAAC,UAAU;YACvD,OAAO,SAAS,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,+BAA+B,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QACpE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAW,cAAc;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;MAEE;IACF,IAAW,WAAW;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAW,aAAa;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;OAEG;IACH,IAAW,eAAe;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,oEAAoE;IACpE,sHAAsH;IACtH,qDAAqD;IACrD,oFAAoF;IACpF,kFAAkF;IAC1E,UAAU,CAAC,GAAW;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YACvB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;;YAEnB,IAAI,CAAC,QAAQ,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,aAAa,CAAC,QAAgC;QACzD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,OAA+B;QAC1D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG;YACN,MAAM,IAAI,yBAAW,CAAC,4BAAa,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;QAE1E,+EAA+E;QAC/E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrB,OAAO,IAAA,iBAAO,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc,CAAC,IAAY;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErC,OAAO,IAAA,iBAAO,EAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW,CAAC,IAAY;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErC,OAAO,IAAA,iBAAO,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAEM,kBAAkB,CAAC,GAAW;QACnC,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACzG,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,4BAA4B;QACvC,IAAI,eAAsD,CAAC;QAC3D,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,+BAAiB,CAAC,UAAU,EAAE,CAAC;YACrD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC3D,eAAe,GAAG,sCAA2B,CAAC,4BAA4B,CAAC,YAAY,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IACD;;;;;OAKG;IACI,KAAK,CAAC,uBAAuB;QAClC,IAAI,aAA+C,CAAC;QACpD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF;AA1HD,0EA0HC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Tiles\r\n */\r\nimport { assert, BentleyStatus, GuidString } from \"@itwin/core-bentley\";\r\nimport { IModelError, RealityData, RealityDataFormat, RealityDataProvider, RealityDataSourceKey, RealityDataSourceProps } from \"@itwin/core-common\";\r\n\r\nimport { request } from \"./request/Request\";\r\nimport { PublisherProductInfo, RealityDataSource, SpatialLocationAndExtents } from \"./RealityDataSource\";\r\nimport { ThreeDTileFormatInterpreter } from \"./tile/internal\";\r\n\r\n/** This class provides access to the reality data provider services.\r\n * It encapsulates access to a reality data weiter it be from local access, http or ProjectWise Context Share.\r\n * The key provided at the creation determines if this is ProjectWise Context Share reference.\r\n * If not then it is considered local (ex: C:\\temp\\TileRoot.json) or plain http access (http://someserver.com/data/TileRoot.json)\r\n * There is a one to one relationship between a reality data and the instances of present class.\r\n* @internal\r\n*/\r\nexport class RealityDataSourceTilesetUrlImpl implements RealityDataSource {\r\n  public readonly key: RealityDataSourceKey;\r\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\r\n  private _tilesetUrl: string | undefined;\r\n  /** For use by all Reality Data. For RD stored on PW Context Share, represents the portion from the root of the Azure Blob Container*/\r\n  private _baseUrl: string = \"\";\r\n\r\n  /** Construct a new reality data source.\r\n   * @param props JSON representation of the reality data source\r\n   */\r\n  protected constructor(props: RealityDataSourceProps) {\r\n    assert(props.sourceKey.provider === RealityDataProvider.TilesetUrl || props.sourceKey.provider === RealityDataProvider.OrbitGtBlob);\r\n    this.key = props.sourceKey;\r\n    this._tilesetUrl = this.key.id;\r\n  }\r\n\r\n  /**\r\n   * Create an instance of this class from a source key and iTwin context/\r\n   */\r\n  public static async createFromKey(sourceKey: RealityDataSourceKey, _iTwinId: GuidString | undefined): Promise<RealityDataSource | undefined> {\r\n    if (sourceKey.provider !== RealityDataProvider.TilesetUrl)\r\n      return undefined;\r\n    const rdSource = new RealityDataSourceTilesetUrlImpl({ sourceKey });\r\n    return rdSource;\r\n  }\r\n\r\n  public get isContextShare(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Returns Reality Data if available\r\n  */\r\n  public get realityData(): RealityData | undefined {\r\n    return undefined;\r\n  }\r\n  public get realityDataId(): string | undefined {\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Returns Reality Data type if available\r\n   */\r\n  public get realityDataType(): string | undefined {\r\n    return undefined;\r\n  }\r\n\r\n  // This is to set the root url from the provided root document path.\r\n  // If the root document is stored on PW Context Share then the root document property of the Reality Data is provided,\r\n  // otherwise the full path to root document is given.\r\n  // The base URL contains the base URL from which tile relative path are constructed.\r\n  // The tile's path root will need to be reinserted for child tiles to return a 200\r\n  private setBaseUrl(url: string): void {\r\n    const urlParts = url.split(\"/\");\r\n    urlParts.pop();\r\n    if (urlParts.length === 0)\r\n      this._baseUrl = \"\";\r\n    else\r\n      this._baseUrl = `${urlParts.join(\"/\")}/`;\r\n  }\r\n\r\n  /**\r\n   * This method returns the URL to access the actual 3d tiles from the service provider.\r\n   * @returns string containing the URL to reality data.\r\n   */\r\n  public async getServiceUrl(_iTwinId: GuidString | undefined): Promise<string | undefined> {\r\n    return this._tilesetUrl;\r\n  }\r\n\r\n  public async getRootDocument(iTwinId: GuidString | undefined): Promise<any> {\r\n    const url = await this.getServiceUrl(iTwinId);\r\n    if (!url)\r\n      throw new IModelError(BentleyStatus.ERROR, \"Unable to get service url\");\r\n\r\n    // The following is only if the reality data is not stored on PW Context Share.\r\n    this.setBaseUrl(url);\r\n    return request(url, \"json\");\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileContent(name: string): Promise<ArrayBuffer> {\r\n    const tileUrl = this._baseUrl + name;\r\n\r\n    return request(tileUrl, \"arraybuffer\");\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content in json format. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileJson(name: string): Promise<any> {\r\n    const tileUrl = this._baseUrl + name;\r\n\r\n    return request(tileUrl, \"json\");\r\n  }\r\n\r\n  public getTileContentType(url: string): \"tile\" | \"tileset\" {\r\n    return new URL(url, \"https://localhost/\").pathname.toLowerCase().endsWith(\"json\") ? \"tileset\" : \"tile\";\r\n  }\r\n\r\n  /**\r\n   * Gets spatial location and extents of this reality data source\r\n   * @returns spatial location and extents\r\n   * @internal\r\n   */\r\n  public async getSpatialLocationAndExtents(): Promise<SpatialLocationAndExtents | undefined> {\r\n    let spatialLocation: SpatialLocationAndExtents | undefined;\r\n    if (this.key.format === RealityDataFormat.ThreeDTile) {\r\n      const rootDocument = await this.getRootDocument(undefined);\r\n      spatialLocation = ThreeDTileFormatInterpreter.getSpatialLocationAndExtents(rootDocument);\r\n    }\r\n    return spatialLocation;\r\n  }\r\n  /**\r\n   * Gets information to identify the product and engine that create this reality data\r\n   * Will return undefined if cannot be resolved\r\n   * @returns information to identify the product and engine that create this reality data\r\n   * @alpha\r\n   */\r\n  public async getPublisherProductInfo(): Promise<PublisherProductInfo | undefined> {\r\n    let publisherInfo: PublisherProductInfo | undefined;\r\n    return publisherInfo;\r\n  }\r\n}\r\n\r\n"]}
+{"version":3,"file":"RealityDataSourceTilesetUrlImpl.js","sourceRoot":"","sources":["../../src/RealityDataSourceTilesetUrlImpl.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F;;GAEG;AACH,sDAAwE;AACxE,oDAAoJ;AAEpJ,+CAA4C;AAE5C,8CAA8D;AAE9D;;;;;;EAME;AACF,MAAa,+BAA+B;IAO1C;;OAEG;IACH,YAAsB,KAA6B;QANnD,sIAAsI;QAC9H,aAAQ,GAAW,EAAE,CAAC;QAM5B,IAAA,qBAAM,EAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,KAAK,iCAAmB,CAAC,UAAU,IAAI,KAAK,CAAC,SAAS,CAAC,QAAQ,KAAK,iCAAmB,CAAC,WAAW,CAAC,CAAC;QACpI,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,SAA+B,EAAE,QAAgC;QACjG,IAAI,SAAS,CAAC,QAAQ,KAAK,iCAAmB,CAAC,UAAU;YACvD,OAAO,SAAS,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,+BAA+B,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QACpE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAW,cAAc;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;MAEE;IACF,IAAW,WAAW;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAW,aAAa;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;OAEG;IACH,IAAW,eAAe;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,oEAAoE;IACpE,sHAAsH;IACtH,qDAAqD;IACrD,oFAAoF;IACpF,kFAAkF;IAC1E,UAAU,CAAC,GAAW;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YACvB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;;YAEnB,IAAI,CAAC,QAAQ,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,aAAa,CAAC,QAAgC;QACzD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,OAA+B;QAC1D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG;YACN,MAAM,IAAI,yBAAW,CAAC,4BAAa,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;QAE1E,+EAA+E;QAC/E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrB,OAAO,IAAA,iBAAO,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yIAAyI;IACjI,UAAU,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACzE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc,CAAC,IAAY;QACtC,OAAO,IAAA,iBAAO,EAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW,CAAC,IAAY;QACnC,OAAO,IAAA,iBAAO,EAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAEM,kBAAkB,CAAC,GAAW;QACnC,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACzG,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,4BAA4B;QACvC,IAAI,eAAsD,CAAC;QAC3D,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,+BAAiB,CAAC,UAAU,EAAE,CAAC;YACrD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC3D,eAAe,GAAG,sCAA2B,CAAC,4BAA4B,CAAC,YAAY,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IACD;;;;;OAKG;IACI,KAAK,CAAC,uBAAuB;QAClC,IAAI,aAA+C,CAAC;QACpD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF;AApID,0EAoIC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Tiles\r\n */\r\nimport { assert, BentleyStatus, GuidString } from \"@itwin/core-bentley\";\r\nimport { IModelError, RealityData, RealityDataFormat, RealityDataProvider, RealityDataSourceKey, RealityDataSourceProps } from \"@itwin/core-common\";\r\n\r\nimport { request } from \"./request/Request\";\r\nimport { PublisherProductInfo, RealityDataSource, SpatialLocationAndExtents } from \"./RealityDataSource\";\r\nimport { ThreeDTileFormatInterpreter } from \"./tile/internal\";\r\n\r\n/** This class provides access to the reality data provider services.\r\n * It encapsulates access to a reality data weiter it be from local access, http or ProjectWise Context Share.\r\n * The key provided at the creation determines if this is ProjectWise Context Share reference.\r\n * If not then it is considered local (ex: C:\\temp\\TileRoot.json) or plain http access (http://someserver.com/data/TileRoot.json)\r\n * There is a one to one relationship between a reality data and the instances of present class.\r\n* @internal\r\n*/\r\nexport class RealityDataSourceTilesetUrlImpl implements RealityDataSource {\r\n  public readonly key: RealityDataSourceKey;\r\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\r\n  private _tilesetUrl: string | undefined;\r\n  /** For use by all Reality Data. For RD stored on PW Context Share, represents the portion from the root of the Azure Blob Container*/\r\n  private _baseUrl: string = \"\";\r\n\r\n  /** Construct a new reality data source.\r\n   * @param props JSON representation of the reality data source\r\n   */\r\n  protected constructor(props: RealityDataSourceProps) {\r\n    assert(props.sourceKey.provider === RealityDataProvider.TilesetUrl || props.sourceKey.provider === RealityDataProvider.OrbitGtBlob);\r\n    this.key = props.sourceKey;\r\n    this._tilesetUrl = this.key.id;\r\n  }\r\n\r\n  /**\r\n   * Create an instance of this class from a source key and iTwin context/\r\n   */\r\n  public static async createFromKey(sourceKey: RealityDataSourceKey, _iTwinId: GuidString | undefined): Promise<RealityDataSource | undefined> {\r\n    if (sourceKey.provider !== RealityDataProvider.TilesetUrl)\r\n      return undefined;\r\n    const rdSource = new RealityDataSourceTilesetUrlImpl({ sourceKey });\r\n    return rdSource;\r\n  }\r\n\r\n  public get isContextShare(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Returns Reality Data if available\r\n  */\r\n  public get realityData(): RealityData | undefined {\r\n    return undefined;\r\n  }\r\n  public get realityDataId(): string | undefined {\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Returns Reality Data type if available\r\n   */\r\n  public get realityDataType(): string | undefined {\r\n    return undefined;\r\n  }\r\n\r\n  // This is to set the root url from the provided root document path.\r\n  // If the root document is stored on PW Context Share then the root document property of the Reality Data is provided,\r\n  // otherwise the full path to root document is given.\r\n  // The base URL contains the base URL from which tile relative path are constructed.\r\n  // The tile's path root will need to be reinserted for child tiles to return a 200\r\n  private setBaseUrl(url: string): void {\r\n    const urlParts = url.split(\"/\");\r\n    urlParts.pop();\r\n    if (urlParts.length === 0)\r\n      this._baseUrl = \"\";\r\n    else\r\n      this._baseUrl = `${urlParts.join(\"/\")}/`;\r\n  }\r\n\r\n  /**\r\n   * This method returns the URL to access the actual 3d tiles from the service provider.\r\n   * @returns string containing the URL to reality data.\r\n   */\r\n  public async getServiceUrl(_iTwinId: GuidString | undefined): Promise<string | undefined> {\r\n    return this._tilesetUrl;\r\n  }\r\n\r\n  public async getRootDocument(iTwinId: GuidString | undefined): Promise<any> {\r\n    const url = await this.getServiceUrl(iTwinId);\r\n    if (!url)\r\n      throw new IModelError(BentleyStatus.ERROR, \"Unable to get service url\");\r\n\r\n    // The following is only if the reality data is not stored on PW Context Share.\r\n    this.setBaseUrl(url);\r\n    return request(url, \"json\");\r\n  }\r\n\r\n  private isValidURL(url: string){\r\n    try {\r\n      new URL(url);\r\n    } catch (_) {\r\n      return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Returns the tile URL. If the tile path is a full URL, it is returned as is. Otherwise, the base URL is prepended to the tile path. */\r\n  private getTileUrl(tilePath: string){\r\n    return this.isValidURL(tilePath) ? tilePath : this._baseUrl + tilePath;\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileContent(name: string): Promise<ArrayBuffer> {\r\n    return request(this.getTileUrl(name), \"arraybuffer\");\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content in json format. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileJson(name: string): Promise<any> {\r\n    return request(this.getTileUrl(name), \"json\");\r\n  }\r\n\r\n  public getTileContentType(url: string): \"tile\" | \"tileset\" {\r\n    return new URL(url, \"https://localhost/\").pathname.toLowerCase().endsWith(\"json\") ? \"tileset\" : \"tile\";\r\n  }\r\n\r\n  /**\r\n   * Gets spatial location and extents of this reality data source\r\n   * @returns spatial location and extents\r\n   * @internal\r\n   */\r\n  public async getSpatialLocationAndExtents(): Promise<SpatialLocationAndExtents | undefined> {\r\n    let spatialLocation: SpatialLocationAndExtents | undefined;\r\n    if (this.key.format === RealityDataFormat.ThreeDTile) {\r\n      const rootDocument = await this.getRootDocument(undefined);\r\n      spatialLocation = ThreeDTileFormatInterpreter.getSpatialLocationAndExtents(rootDocument);\r\n    }\r\n    return spatialLocation;\r\n  }\r\n  /**\r\n   * Gets information to identify the product and engine that create this reality data\r\n   * Will return undefined if cannot be resolved\r\n   * @returns information to identify the product and engine that create this reality data\r\n   * @alpha\r\n   */\r\n  public async getPublisherProductInfo(): Promise<PublisherProductInfo | undefined> {\r\n    let publisherInfo: PublisherProductInfo | undefined;\r\n    return publisherInfo;\r\n  }\r\n}\r\n\r\n"]}

package/lib/cjs/SpatialViewState.d.ts

@@ -1,7 +1,7 @@
 /** @packageDocumentation
  * @module Views
  */
-import { BeEvent, Id64String } from "@itwin/core-bentley";
+import { BeEvent, Id64String, OrderedId64Iterable } from "@itwin/core-bentley";
 import { Matrix3d, Range3d, XYAndZ } from "@itwin/core-geometry";
 import { AxisAlignedBox3d, HydrateViewStateRequestProps, HydrateViewStateResponseProps, SpatialViewDefinitionProps, ViewStateProps } from "@itwin/core-common";
 import { AuxCoordSystemState } from "./AuxCoordSys";
@@ -101,6 +101,19 @@ export declare class SpatialViewState extends ViewState3d {
      * @internal
      */
     setTileTreeReferencesDeactivated(modelIds: Id64String | Id64String[] | undefined, deactivated: boolean | undefined, which: "all" | "animated" | "primary" | "section" | number[]): void;
+    /** For getting the [TileTreeReference]s that are in the modelIds, for planar classification.
+     * @param modelIds modelIds for which to get the TileTreeReferences
+     * @param maskTreeRefs where to store the TileTreeReferences
+     * @param maskRange range to extend for the maskRefs
+     * @internal
+     */
+    collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void;
+    /** For getting a list of modelIds which do not participate in masking for planar classification.
+     * @param maskModels models which DO participate in planar clip masking
+     * @param useVisible when true, use visible models to set flag
+     * @internal
+     */
+    getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined;
     private registerModelSelectorListeners;
     private unregisterModelSelectorListeners;
 }

package/lib/cjs/SpatialViewState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpatialViewState.d.ts","sourceRoot":"","sources":["../../src/SpatialViewState.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SpatialViewState.d.ts","sourceRoot":"","sources":["../../src/SpatialViewState.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAqB,UAAU,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAY,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC/J,OAAO,EAA8B,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAyB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAA6B,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,2FAA2F;IAC3F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,WAA2B,SAAS,WAAsC;IAE1E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,iCAAiC,CAAsB;IAExE;;OAEG;IACH,SAAgB,qBAAqB,gBAAqB,IAAI,EAAI;IAElE,IAAW,aAAa,IAAI,kBAAkB,CAE7C;IAED,IAAW,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAepD;IAED;;;;;;;;OAQG;WACW,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,gBAAgB;WAapG,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,GAAG,gBAAgB;IAOzF,OAAO,IAAI,cAAc;gBAM7B,KAAK,EAAE,0BAA0B,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,kBAAkB;IAS1K,gBAAgB;IACA,aAAa,IAAI,IAAI,IAAI,gBAAgB;IAEzC,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAE5B,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB;IAC1E,IAAW,mBAAmB;;;MAAiF;IAE/G,gBAAgB;IACT,wBAAwB,IAAI,IAAI;IAIvC;;OAEG;IACH,SAAS,CAAC,mBAAmB,IAAI,gBAAgB;IAQjD,OAAO,CAAC,kBAAkB;IAY1B;;;;;;;;OAQG;IACI,eAAe,CAAC,OAAO,CAAC,EAAE,iCAAiC,GAAG,gBAAgB;IAiB9E,gBAAgB,IAAI,gBAAgB;IAU3B,MAAM,IAAI,0BAA0B;IAMpD,gBAAgB;cACG,OAAO,CAAC,cAAc,EAAE,4BAA4B,GAAG,IAAI;IAQ9E,gBAAgB;cACS,QAAQ,CAAC,eAAe,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzF,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IACxC,iBAAiB;IACjB,cAAc,CAAC,EAAE,EAAE,UAAU;IAC7B,iBAAiB,CAAC,EAAE,EAAE,UAAU;IAEhC,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI;IAQ9D,gBAAgB;IACA,mBAAmB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI;IAKrF,gBAAgB;IACA,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAMxD,0CAA0C;IAC1B,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAMlE,4CAA4C;IAC5B,kBAAkB,IAAI,IAAI;IAM1C;;;;;;OAMG;IACI,gCAAgC,CAAC,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI;IAI9L;;;;;OAKG;IACI,eAAe,CAAC,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAIlH;;;;OAIG;IACI,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,UAAU,EAAE,GAAG,SAAS;IAIrH,OAAO,CAAC,8BAA8B;IAYtC,OAAO,CAAC,gCAAgC;CAIzC;AACD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,WAA2B,SAAS,WAA2C;gBAEnE,KAAK,EAAE,0BAA0B,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,kBAAkB;IAEhK,cAAc,IAAI,OAAO;CAC1C"}

package/lib/cjs/SpatialViewState.js

@@ -203,6 +203,23 @@ class SpatialViewState extends ViewState_1.ViewState3d {
     setTileTreeReferencesDeactivated(modelIds, deactivated, which) {
         this._treeRefs.setDeactivated(modelIds, deactivated, which);
     }
+    /** For getting the [TileTreeReference]s that are in the modelIds, for planar classification.
+     * @param modelIds modelIds for which to get the TileTreeReferences
+     * @param maskTreeRefs where to store the TileTreeReferences
+     * @param maskRange range to extend for the maskRefs
+     * @internal
+     */
+    collectMaskRefs(modelIds, maskTreeRefs, maskRange) {
+        this._treeRefs.collectMaskRefs(modelIds, maskTreeRefs, maskRange);
+    }
+    /** For getting a list of modelIds which do not participate in masking for planar classification.
+     * @param maskModels models which DO participate in planar clip masking
+     * @param useVisible when true, use visible models to set flag
+     * @internal
+     */
+    getModelsNotInMask(maskModels, useVisible) {
+        return this._treeRefs.getModelsNotInMask(maskModels, useVisible);
+    }
     registerModelSelectorListeners() {
         const models = this.modelSelector.observableModels;
         const func = () => {

package/lib/cjs/SpatialViewState.js.map

@@ -1 +1 @@
-{"version":3,"file":"SpatialViewState.js","sourceRoot":"","sources":["../../src/SpatialViewState.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { BeEvent, CompressedId64Set, Id64String } from \"@itwin/core-bentley\";\r\nimport { Constant, Matrix3d, Range3d, XYAndZ } from \"@itwin/core-geometry\";\r\nimport { AxisAlignedBox3d, HydrateViewStateRequestProps, HydrateViewStateResponseProps, SpatialViewDefinitionProps, ViewStateProps } from \"@itwin/core-common\";\r\nimport { AuxCoordSystemSpatialState, AuxCoordSystemState } from \"./AuxCoordSys\";\r\nimport { ModelSelectorState } from \"./ModelSelectorState\";\r\nimport { CategorySelectorState } from \"./CategorySelectorState\";\r\nimport { DisplayStyle3dState } from \"./DisplayStyleState\";\r\nimport { GeometricModel3dState, GeometricModelState } from \"./ModelState\";\r\nimport { SceneContext } from \"./ViewContext\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\nimport { AttachToViewportArgs, ViewState3d } from \"./ViewState\";\r\nimport { SpatialTileTreeReferences, TileTreeReference } from \"./tile/internal\";\r\n\r\n/** Options supplied to [[SpatialViewState.computeFitRange]].\r\n * @public\r\n */\r\nexport interface ComputeSpatialViewFitRangeOptions {\r\n  /** The minimal extents. The computed range will be unioned with this range if supplied. */\r\n  baseExtents?: Range3d;\r\n}\r\n\r\n/** Defines a view of one or more SpatialModels.\r\n * The list of viewed models is stored in the ModelSelector.\r\n * @public\r\n * @extensions\r\n */\r\nexport class SpatialViewState extends ViewState3d {\r\n  public static override get className() { return \"SpatialViewDefinition\"; }\r\n\r\n  private readonly _treeRefs: SpatialTileTreeReferences;\r\n  private _modelSelector: ModelSelectorState;\r\n  private readonly _unregisterModelSelectorListeners: VoidFunction[] = [];\r\n\r\n  /** An event raised when the set of models viewed by this view changes, *only* if the view is attached to a [[Viewport]].\r\n   * @public\r\n   */\r\n  public readonly onViewedModelsChanged = new BeEvent<() => void>();\r\n\r\n  public get modelSelector(): ModelSelectorState {\r\n    return this._modelSelector;\r\n  }\r\n\r\n  public set modelSelector(selector: ModelSelectorState) {\r\n    if (selector === this.modelSelector)\r\n      return;\r\n\r\n    const isAttached = this.isAttachedToViewport;\r\n    this.unregisterModelSelectorListeners();\r\n\r\n    this._modelSelector = selector;\r\n\r\n    if (isAttached) {\r\n      this.registerModelSelectorListeners();\r\n      this.onViewedModelsChanged.raiseEvent();\r\n    }\r\n\r\n    this.markModelSelectorChanged();\r\n  }\r\n\r\n  /** Create a new *blank* SpatialViewState. The returned SpatialViewState will nave non-persistent empty [[CategorySelectorState]] and [[ModelSelectorState]],\r\n   * and a non-persistent [[DisplayStyle3dState]] with default values for all of its components. Generally after creating a blank SpatialViewState,\r\n   * callers will modify the state to suit specific needs.\r\n   * @param iModel The IModelConnection for the new SpatialViewState\r\n   * @param origin The origin for the new SpatialViewState\r\n   * @param extents The extents for the new SpatialViewState\r\n   * @param rotation The rotation of the new SpatialViewState. If undefined, use top view.\r\n   * @public\r\n   */\r\n  public static createBlank(iModel: IModelConnection, origin: XYAndZ, extents: XYAndZ, rotation?: Matrix3d): SpatialViewState {\r\n    const blank = {} as any;\r\n    const cat = new CategorySelectorState(blank, iModel);\r\n    const modelSelectorState = new ModelSelectorState(blank, iModel);\r\n    const displayStyleState = new DisplayStyle3dState(blank, iModel);\r\n    const view = new this(blank, iModel, cat, displayStyleState, modelSelectorState);\r\n    view.setOrigin(origin);\r\n    view.setExtents(extents);\r\n    if (undefined !== rotation)\r\n      view.setRotation(rotation);\r\n    return view;\r\n  }\r\n\r\n  public static override createFromProps(props: ViewStateProps, iModel: IModelConnection): SpatialViewState {\r\n    const cat = new CategorySelectorState(props.categorySelectorProps, iModel);\r\n    const displayStyleState = new DisplayStyle3dState(props.displayStyleProps, iModel);\r\n    const modelSelectorState = new ModelSelectorState(props.modelSelectorProps!, iModel);\r\n    return new this(props.viewDefinitionProps as SpatialViewDefinitionProps, iModel, cat, displayStyleState, modelSelectorState);\r\n  }\r\n\r\n  public override toProps(): ViewStateProps {\r\n    const props = super.toProps();\r\n    props.modelSelectorProps = this.modelSelector.toJSON();\r\n    return props;\r\n  }\r\n\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelConnection, arg3: CategorySelectorState, displayStyle: DisplayStyle3dState, modelSelector: ModelSelectorState) {\r\n    super(props, iModel, arg3, displayStyle);\r\n    this._modelSelector = modelSelector;\r\n    if (arg3 instanceof SpatialViewState) // from clone\r\n      this._modelSelector = arg3.modelSelector.clone();\r\n\r\n    this._treeRefs = SpatialTileTreeReferences.create(this);\r\n  }\r\n\r\n  /** @internal */\r\n  public override isSpatialView(): this is SpatialViewState { return true; }\r\n\r\n  public override equals(other: this): boolean { return super.equals(other) && this.modelSelector.equals(other.modelSelector); }\r\n\r\n  public override createAuxCoordSystem(acsName: string): AuxCoordSystemState { return AuxCoordSystemSpatialState.createNew(acsName, this.iModel); }\r\n  public get defaultExtentLimits() { return { min: Constant.oneMillimeter, max: 3 * Constant.diameterOfEarth }; } // Increased max by 3X to support globe mode.\r\n\r\n  /** @internal */\r\n  public markModelSelectorChanged(): void {\r\n    this._treeRefs.update();\r\n  }\r\n\r\n  /** Get world-space viewed extents based on the iModel's project extents.\r\n   * @deprecated in 3.6. These extents are based on [[IModelConnection.displayedExtents]], which is deprecated. Consider using [[computeFitRange]] or [[getViewedExtents]] instead.\r\n   */\r\n  protected getDisplayedExtents(): AxisAlignedBox3d {\r\n    /* eslint-disable-next-line deprecation/deprecation */\r\n    const extents = Range3d.fromJSON<AxisAlignedBox3d>(this.iModel.displayedExtents);\r\n    extents.scaleAboutCenterInPlace(1.0001); // projectExtents. lying smack up against the extents is not excluded by frustum...\r\n    extents.extendRange(this.getGroundExtents());\r\n    return extents;\r\n  }\r\n\r\n  private computeBaseExtents(): AxisAlignedBox3d {\r\n    const extents = Range3d.fromJSON<AxisAlignedBox3d>(this.iModel.projectExtents);\r\n\r\n    // Ensure geometry coincident with planes of the project extents is not clipped.\r\n    extents.scaleAboutCenterInPlace(1.0001);\r\n\r\n    // Ensure ground plane is not clipped, if it's being drawn.\r\n    extents.extendRange(this.getGroundExtents());\r\n\r\n    return extents;\r\n  }\r\n\r\n  /** Compute a volume in world coordinates tightly encompassing the contents of the view. The volume is computed from the union of the volumes of the\r\n   * view's viewed models, including [GeometricModel]($backend)s and reality models.\r\n   * Those volumes are obtained from the [[TileTree]]s used to render those models, so any tile tree that has not yet been loaded will not contribute to the computation.\r\n   * If `options.baseExtents` is defined, it will be unioned with the computed volume.\r\n   * If the computed volume is null (empty), a default volume will be computed from [IModel.projectExtents]($common), which may be a looser approximation of the\r\n   * models' volumes.\r\n   * @param options Options used to customize how the volume is computed.\r\n   * @returns A non-null volume in world coordinates encompassing the contents of the view.\r\n   */\r\n  public computeFitRange(options?: ComputeSpatialViewFitRangeOptions): AxisAlignedBox3d {\r\n    // Fit to the union of the ranges of all loaded tile trees.\r\n    const range = options?.baseExtents?.clone() ?? new Range3d();\r\n    this.forEachTileTreeRef((ref) => {\r\n      ref.unionFitRange(range);\r\n    });\r\n\r\n    // Fall back to the project extents if necessary.\r\n    if (range.isNull)\r\n      range.setFrom(this.computeBaseExtents());\r\n\r\n    // Avoid ridiculously small extents.\r\n    range.ensureMinLengths(1.0);\r\n\r\n    return range;\r\n  }\r\n\r\n  public getViewedExtents(): AxisAlignedBox3d {\r\n    // Encompass the project extents and ground plane.\r\n    const extents = this.computeBaseExtents();\r\n\r\n    // Include any tile trees that extend outside the project extents.\r\n    extents.extendRange(this.computeFitRange());\r\n\r\n    return extents;\r\n  }\r\n\r\n  public override toJSON(): SpatialViewDefinitionProps {\r\n    const val = super.toJSON() as SpatialViewDefinitionProps;\r\n    val.modelSelectorId = this.modelSelector.id;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override preload(hydrateRequest: HydrateViewStateRequestProps): void {\r\n    super.preload(hydrateRequest);\r\n    const notLoaded = this.iModel.models.filterLoaded(this.modelSelector.models);\r\n    if (undefined === notLoaded)\r\n      return; // all requested models are already loaded\r\n    hydrateRequest.notLoadedModelSelectorStateModels = CompressedId64Set.sortAndCompress(notLoaded);\r\n  }\r\n\r\n  /** @internal */\r\n  protected override async postload(hydrateResponse: HydrateViewStateResponseProps): Promise<void> {\r\n    const promises = [];\r\n    promises.push(super.postload(hydrateResponse));\r\n    if (hydrateResponse.modelSelectorStateModels !== undefined)\r\n      promises.push(this.iModel.models.updateLoadedWithModelProps(hydrateResponse.modelSelectorStateModels));\r\n    await Promise.all(promises);\r\n  }\r\n\r\n  public viewsModel(modelId: Id64String): boolean { return this.modelSelector.containsModel(modelId); }\r\n  public clearViewedModels() { this.modelSelector.models.clear(); }\r\n  public addViewedModel(id: Id64String) { this.modelSelector.addModels(id); }\r\n  public removeViewedModel(id: Id64String) { this.modelSelector.dropModels(id); }\r\n\r\n  public forEachModel(func: (model: GeometricModelState) => void) {\r\n    for (const modelId of this.modelSelector.models) {\r\n      const model = this.iModel.models.getLoaded(modelId);\r\n      if (undefined !== model && undefined !== model.asGeometricModel3d)\r\n        func(model as GeometricModel3dState);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public override forEachModelTreeRef(func: (treeRef: TileTreeReference) => void): void {\r\n    for (const ref of this._treeRefs)\r\n      func(ref);\r\n  }\r\n\r\n  /** @internal */\r\n  public override createScene(context: SceneContext): void {\r\n    super.createScene(context);\r\n    context.textureDrapes.forEach((drape) => drape.collectGraphics(context));\r\n    context.viewport.target.updateSolarShadows(this.getDisplayStyle3d().wantShadows ? context : undefined);\r\n  }\r\n\r\n  /** See [[ViewState.attachToViewport]]. */\r\n  public override attachToViewport(args: AttachToViewportArgs): void {\r\n    super.attachToViewport(args);\r\n    this.registerModelSelectorListeners();\r\n    this._treeRefs.attachToViewport(args);\r\n  }\r\n\r\n  /** See [[ViewState.detachFromViewport]]. */\r\n  public override detachFromViewport(): void {\r\n    super.detachFromViewport();\r\n    this._treeRefs.detachFromViewport();\r\n    this.unregisterModelSelectorListeners();\r\n  }\r\n\r\n  /** Chiefly for debugging: change the \"deactivated\" state of one or more tile tree references. Deactivated references are\r\n   * omitted when iterating the references, so e.g. their graphics are omitted from the scene.\r\n   * @param modelIds The Ids of one or more models whose tile tree references are to be affected. If omitted, all models are affected.\r\n   * @param deactivated True to deactivate the specified references, false to reactivate them, undefined to invert each one's current state.\r\n   * @param which The references to be affected as either a broad category or one or more indices of animated references.\r\n   * @internal\r\n   */\r\n  public setTileTreeReferencesDeactivated(modelIds: Id64String | Id64String[] | undefined, deactivated: boolean | undefined, which: \"all\" | \"animated\" | \"primary\" | \"section\" | number[]): void {\r\n    this._treeRefs.setDeactivated(modelIds, deactivated, which);\r\n  }\r\n\r\n  private registerModelSelectorListeners(): void {\r\n    const models = this.modelSelector.observableModels;\r\n    const func = () => {\r\n      this.markModelSelectorChanged();\r\n      this.onViewedModelsChanged.raiseEvent();\r\n    };\r\n\r\n    this._unregisterModelSelectorListeners.push(models.onAdded.addListener(func));\r\n    this._unregisterModelSelectorListeners.push(models.onDeleted.addListener(func));\r\n    this._unregisterModelSelectorListeners.push(models.onCleared.addListener(func));\r\n  }\r\n\r\n  private unregisterModelSelectorListeners(): void {\r\n    this._unregisterModelSelectorListeners.forEach((f) => f());\r\n    this._unregisterModelSelectorListeners.length = 0;\r\n  }\r\n}\r\n/** Defines a spatial view that displays geometry on the image plane using a parallel orthographic projection.\r\n * @public\r\n * @extensions\r\n */\r\nexport class OrthographicViewState extends SpatialViewState {\r\n  public static override get className() { return \"OrthographicViewDefinition\"; }\r\n\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelConnection, categories: CategorySelectorState, displayStyle: DisplayStyle3dState, modelSelector: ModelSelectorState) { super(props, iModel, categories, displayStyle, modelSelector); }\r\n\r\n  public override supportsCamera(): boolean { return false; }\r\n}\r\n"]}
+{"version":3,"file":"SpatialViewState.js","sourceRoot":"","sources":["../../src/SpatialViewState.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { BeEvent, CompressedId64Set, Id64String, OrderedId64Iterable } from \"@itwin/core-bentley\";\r\nimport { Constant, Matrix3d, Range3d, XYAndZ } from \"@itwin/core-geometry\";\r\nimport { AxisAlignedBox3d, HydrateViewStateRequestProps, HydrateViewStateResponseProps, SpatialViewDefinitionProps, ViewStateProps } from \"@itwin/core-common\";\r\nimport { AuxCoordSystemSpatialState, AuxCoordSystemState } from \"./AuxCoordSys\";\r\nimport { ModelSelectorState } from \"./ModelSelectorState\";\r\nimport { CategorySelectorState } from \"./CategorySelectorState\";\r\nimport { DisplayStyle3dState } from \"./DisplayStyleState\";\r\nimport { GeometricModel3dState, GeometricModelState } from \"./ModelState\";\r\nimport { SceneContext } from \"./ViewContext\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\nimport { AttachToViewportArgs, ViewState3d } from \"./ViewState\";\r\nimport { SpatialTileTreeReferences, TileTreeReference } from \"./tile/internal\";\r\n\r\n/** Options supplied to [[SpatialViewState.computeFitRange]].\r\n * @public\r\n */\r\nexport interface ComputeSpatialViewFitRangeOptions {\r\n  /** The minimal extents. The computed range will be unioned with this range if supplied. */\r\n  baseExtents?: Range3d;\r\n}\r\n\r\n/** Defines a view of one or more SpatialModels.\r\n * The list of viewed models is stored in the ModelSelector.\r\n * @public\r\n * @extensions\r\n */\r\nexport class SpatialViewState extends ViewState3d {\r\n  public static override get className() { return \"SpatialViewDefinition\"; }\r\n\r\n  private readonly _treeRefs: SpatialTileTreeReferences;\r\n  private _modelSelector: ModelSelectorState;\r\n  private readonly _unregisterModelSelectorListeners: VoidFunction[] = [];\r\n\r\n  /** An event raised when the set of models viewed by this view changes, *only* if the view is attached to a [[Viewport]].\r\n   * @public\r\n   */\r\n  public readonly onViewedModelsChanged = new BeEvent<() => void>();\r\n\r\n  public get modelSelector(): ModelSelectorState {\r\n    return this._modelSelector;\r\n  }\r\n\r\n  public set modelSelector(selector: ModelSelectorState) {\r\n    if (selector === this.modelSelector)\r\n      return;\r\n\r\n    const isAttached = this.isAttachedToViewport;\r\n    this.unregisterModelSelectorListeners();\r\n\r\n    this._modelSelector = selector;\r\n\r\n    if (isAttached) {\r\n      this.registerModelSelectorListeners();\r\n      this.onViewedModelsChanged.raiseEvent();\r\n    }\r\n\r\n    this.markModelSelectorChanged();\r\n  }\r\n\r\n  /** Create a new *blank* SpatialViewState. The returned SpatialViewState will nave non-persistent empty [[CategorySelectorState]] and [[ModelSelectorState]],\r\n   * and a non-persistent [[DisplayStyle3dState]] with default values for all of its components. Generally after creating a blank SpatialViewState,\r\n   * callers will modify the state to suit specific needs.\r\n   * @param iModel The IModelConnection for the new SpatialViewState\r\n   * @param origin The origin for the new SpatialViewState\r\n   * @param extents The extents for the new SpatialViewState\r\n   * @param rotation The rotation of the new SpatialViewState. If undefined, use top view.\r\n   * @public\r\n   */\r\n  public static createBlank(iModel: IModelConnection, origin: XYAndZ, extents: XYAndZ, rotation?: Matrix3d): SpatialViewState {\r\n    const blank = {} as any;\r\n    const cat = new CategorySelectorState(blank, iModel);\r\n    const modelSelectorState = new ModelSelectorState(blank, iModel);\r\n    const displayStyleState = new DisplayStyle3dState(blank, iModel);\r\n    const view = new this(blank, iModel, cat, displayStyleState, modelSelectorState);\r\n    view.setOrigin(origin);\r\n    view.setExtents(extents);\r\n    if (undefined !== rotation)\r\n      view.setRotation(rotation);\r\n    return view;\r\n  }\r\n\r\n  public static override createFromProps(props: ViewStateProps, iModel: IModelConnection): SpatialViewState {\r\n    const cat = new CategorySelectorState(props.categorySelectorProps, iModel);\r\n    const displayStyleState = new DisplayStyle3dState(props.displayStyleProps, iModel);\r\n    const modelSelectorState = new ModelSelectorState(props.modelSelectorProps!, iModel);\r\n    return new this(props.viewDefinitionProps as SpatialViewDefinitionProps, iModel, cat, displayStyleState, modelSelectorState);\r\n  }\r\n\r\n  public override toProps(): ViewStateProps {\r\n    const props = super.toProps();\r\n    props.modelSelectorProps = this.modelSelector.toJSON();\r\n    return props;\r\n  }\r\n\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelConnection, arg3: CategorySelectorState, displayStyle: DisplayStyle3dState, modelSelector: ModelSelectorState) {\r\n    super(props, iModel, arg3, displayStyle);\r\n    this._modelSelector = modelSelector;\r\n    if (arg3 instanceof SpatialViewState) // from clone\r\n      this._modelSelector = arg3.modelSelector.clone();\r\n\r\n    this._treeRefs = SpatialTileTreeReferences.create(this);\r\n  }\r\n\r\n  /** @internal */\r\n  public override isSpatialView(): this is SpatialViewState { return true; }\r\n\r\n  public override equals(other: this): boolean { return super.equals(other) && this.modelSelector.equals(other.modelSelector); }\r\n\r\n  public override createAuxCoordSystem(acsName: string): AuxCoordSystemState { return AuxCoordSystemSpatialState.createNew(acsName, this.iModel); }\r\n  public get defaultExtentLimits() { return { min: Constant.oneMillimeter, max: 3 * Constant.diameterOfEarth }; } // Increased max by 3X to support globe mode.\r\n\r\n  /** @internal */\r\n  public markModelSelectorChanged(): void {\r\n    this._treeRefs.update();\r\n  }\r\n\r\n  /** Get world-space viewed extents based on the iModel's project extents.\r\n   * @deprecated in 3.6. These extents are based on [[IModelConnection.displayedExtents]], which is deprecated. Consider using [[computeFitRange]] or [[getViewedExtents]] instead.\r\n   */\r\n  protected getDisplayedExtents(): AxisAlignedBox3d {\r\n    /* eslint-disable-next-line deprecation/deprecation */\r\n    const extents = Range3d.fromJSON<AxisAlignedBox3d>(this.iModel.displayedExtents);\r\n    extents.scaleAboutCenterInPlace(1.0001); // projectExtents. lying smack up against the extents is not excluded by frustum...\r\n    extents.extendRange(this.getGroundExtents());\r\n    return extents;\r\n  }\r\n\r\n  private computeBaseExtents(): AxisAlignedBox3d {\r\n    const extents = Range3d.fromJSON<AxisAlignedBox3d>(this.iModel.projectExtents);\r\n\r\n    // Ensure geometry coincident with planes of the project extents is not clipped.\r\n    extents.scaleAboutCenterInPlace(1.0001);\r\n\r\n    // Ensure ground plane is not clipped, if it's being drawn.\r\n    extents.extendRange(this.getGroundExtents());\r\n\r\n    return extents;\r\n  }\r\n\r\n  /** Compute a volume in world coordinates tightly encompassing the contents of the view. The volume is computed from the union of the volumes of the\r\n   * view's viewed models, including [GeometricModel]($backend)s and reality models.\r\n   * Those volumes are obtained from the [[TileTree]]s used to render those models, so any tile tree that has not yet been loaded will not contribute to the computation.\r\n   * If `options.baseExtents` is defined, it will be unioned with the computed volume.\r\n   * If the computed volume is null (empty), a default volume will be computed from [IModel.projectExtents]($common), which may be a looser approximation of the\r\n   * models' volumes.\r\n   * @param options Options used to customize how the volume is computed.\r\n   * @returns A non-null volume in world coordinates encompassing the contents of the view.\r\n   */\r\n  public computeFitRange(options?: ComputeSpatialViewFitRangeOptions): AxisAlignedBox3d {\r\n    // Fit to the union of the ranges of all loaded tile trees.\r\n    const range = options?.baseExtents?.clone() ?? new Range3d();\r\n    this.forEachTileTreeRef((ref) => {\r\n      ref.unionFitRange(range);\r\n    });\r\n\r\n    // Fall back to the project extents if necessary.\r\n    if (range.isNull)\r\n      range.setFrom(this.computeBaseExtents());\r\n\r\n    // Avoid ridiculously small extents.\r\n    range.ensureMinLengths(1.0);\r\n\r\n    return range;\r\n  }\r\n\r\n  public getViewedExtents(): AxisAlignedBox3d {\r\n    // Encompass the project extents and ground plane.\r\n    const extents = this.computeBaseExtents();\r\n\r\n    // Include any tile trees that extend outside the project extents.\r\n    extents.extendRange(this.computeFitRange());\r\n\r\n    return extents;\r\n  }\r\n\r\n  public override toJSON(): SpatialViewDefinitionProps {\r\n    const val = super.toJSON() as SpatialViewDefinitionProps;\r\n    val.modelSelectorId = this.modelSelector.id;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override preload(hydrateRequest: HydrateViewStateRequestProps): void {\r\n    super.preload(hydrateRequest);\r\n    const notLoaded = this.iModel.models.filterLoaded(this.modelSelector.models);\r\n    if (undefined === notLoaded)\r\n      return; // all requested models are already loaded\r\n    hydrateRequest.notLoadedModelSelectorStateModels = CompressedId64Set.sortAndCompress(notLoaded);\r\n  }\r\n\r\n  /** @internal */\r\n  protected override async postload(hydrateResponse: HydrateViewStateResponseProps): Promise<void> {\r\n    const promises = [];\r\n    promises.push(super.postload(hydrateResponse));\r\n    if (hydrateResponse.modelSelectorStateModels !== undefined)\r\n      promises.push(this.iModel.models.updateLoadedWithModelProps(hydrateResponse.modelSelectorStateModels));\r\n    await Promise.all(promises);\r\n  }\r\n\r\n  public viewsModel(modelId: Id64String): boolean { return this.modelSelector.containsModel(modelId); }\r\n  public clearViewedModels() { this.modelSelector.models.clear(); }\r\n  public addViewedModel(id: Id64String) { this.modelSelector.addModels(id); }\r\n  public removeViewedModel(id: Id64String) { this.modelSelector.dropModels(id); }\r\n\r\n  public forEachModel(func: (model: GeometricModelState) => void) {\r\n    for (const modelId of this.modelSelector.models) {\r\n      const model = this.iModel.models.getLoaded(modelId);\r\n      if (undefined !== model && undefined !== model.asGeometricModel3d)\r\n        func(model as GeometricModel3dState);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public override forEachModelTreeRef(func: (treeRef: TileTreeReference) => void): void {\r\n    for (const ref of this._treeRefs)\r\n      func(ref);\r\n  }\r\n\r\n  /** @internal */\r\n  public override createScene(context: SceneContext): void {\r\n    super.createScene(context);\r\n    context.textureDrapes.forEach((drape) => drape.collectGraphics(context));\r\n    context.viewport.target.updateSolarShadows(this.getDisplayStyle3d().wantShadows ? context : undefined);\r\n  }\r\n\r\n  /** See [[ViewState.attachToViewport]]. */\r\n  public override attachToViewport(args: AttachToViewportArgs): void {\r\n    super.attachToViewport(args);\r\n    this.registerModelSelectorListeners();\r\n    this._treeRefs.attachToViewport(args);\r\n  }\r\n\r\n  /** See [[ViewState.detachFromViewport]]. */\r\n  public override detachFromViewport(): void {\r\n    super.detachFromViewport();\r\n    this._treeRefs.detachFromViewport();\r\n    this.unregisterModelSelectorListeners();\r\n  }\r\n\r\n  /** Chiefly for debugging: change the \"deactivated\" state of one or more tile tree references. Deactivated references are\r\n   * omitted when iterating the references, so e.g. their graphics are omitted from the scene.\r\n   * @param modelIds The Ids of one or more models whose tile tree references are to be affected. If omitted, all models are affected.\r\n   * @param deactivated True to deactivate the specified references, false to reactivate them, undefined to invert each one's current state.\r\n   * @param which The references to be affected as either a broad category or one or more indices of animated references.\r\n   * @internal\r\n   */\r\n  public setTileTreeReferencesDeactivated(modelIds: Id64String | Id64String[] | undefined, deactivated: boolean | undefined, which: \"all\" | \"animated\" | \"primary\" | \"section\" | number[]): void {\r\n    this._treeRefs.setDeactivated(modelIds, deactivated, which);\r\n  }\r\n\r\n  /** For getting the [TileTreeReference]s that are in the modelIds, for planar classification.\r\n   * @param modelIds modelIds for which to get the TileTreeReferences\r\n   * @param maskTreeRefs where to store the TileTreeReferences\r\n   * @param maskRange range to extend for the maskRefs\r\n   * @internal\r\n   */\r\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\r\n    this._treeRefs.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\r\n  }\r\n\r\n  /** For getting a list of modelIds which do not participate in masking for planar classification.\r\n   * @param maskModels models which DO participate in planar clip masking\r\n   * @param useVisible when true, use visible models to set flag\r\n   * @internal\r\n   */\r\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\r\n    return this._treeRefs.getModelsNotInMask(maskModels, useVisible);\r\n  }\r\n\r\n  private registerModelSelectorListeners(): void {\r\n    const models = this.modelSelector.observableModels;\r\n    const func = () => {\r\n      this.markModelSelectorChanged();\r\n      this.onViewedModelsChanged.raiseEvent();\r\n    };\r\n\r\n    this._unregisterModelSelectorListeners.push(models.onAdded.addListener(func));\r\n    this._unregisterModelSelectorListeners.push(models.onDeleted.addListener(func));\r\n    this._unregisterModelSelectorListeners.push(models.onCleared.addListener(func));\r\n  }\r\n\r\n  private unregisterModelSelectorListeners(): void {\r\n    this._unregisterModelSelectorListeners.forEach((f) => f());\r\n    this._unregisterModelSelectorListeners.length = 0;\r\n  }\r\n}\r\n/** Defines a spatial view that displays geometry on the image plane using a parallel orthographic projection.\r\n * @public\r\n * @extensions\r\n */\r\nexport class OrthographicViewState extends SpatialViewState {\r\n  public static override get className() { return \"OrthographicViewDefinition\"; }\r\n\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelConnection, categories: CategorySelectorState, displayStyle: DisplayStyle3dState, modelSelector: ModelSelectorState) { super(props, iModel, categories, displayStyle, modelSelector); }\r\n\r\n  public override supportsCamera(): boolean { return false; }\r\n}\r\n"]}

package/lib/cjs/SubCategoriesCache.d.ts

@@ -34,6 +34,8 @@ export declare class SubCategoriesCache {
      * containing the corresponding promise and the set of categories still to be loaded.
      */
     load(categoryIds: Id64Arg): SubCategoriesRequest | undefined;
+    /** Load all subcategories that come from used spatial categories of the iModel into the cache. */
+    loadAllUsedSpatialSubCategories(): Promise<void>;
     /** Given categoryIds, return which of these are not cached. */
     private getMissing;
     clear(): void;
@@ -43,7 +45,7 @@ export declare class SubCategoriesCache {
     /** Exposed strictly for tests.
      * @internal
      */
-    add(categoryId: string, subCategoryId: string, appearance: SubCategoryAppearance): void;
+    add(categoryId: string, subCategoryId: string, appearance: SubCategoryAppearance, override: boolean): void;
     getCategoryInfo(inputCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.CategoryInfo>>;
     getSubCategoryInfo(categoryId: Id64String, inputSubCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.SubCategoryInfo>>;
     private mapSubCategoryInfos;

package/lib/cjs/SubCategoriesCache.d.ts.map

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

package/lib/cjs/SubCategoriesCache.js

@@ -42,6 +42,18 @@ class SubCategoriesCache {
             cancel: () => request.cancel(),
         };
     }
+    /** Load all subcategories that come from used spatial categories of the iModel into the cache. */
+    async loadAllUsedSpatialSubCategories() {
+        try {
+            const results = await this._imodel.queryAllUsedSpatialSubCategories();
+            if (undefined !== results) {
+                this.processResults(results, new Set(), false);
+            }
+        }
+        catch (e) {
+            // In case of a truncated response, gracefully handle the error and exit.
+        }
+    }
     /** Given categoryIds, return which of these are not cached. */
     getMissing(categoryIds) {
         let missing;
@@ -67,9 +79,10 @@ class SubCategoriesCache {
             props = JSON.parse(json);
         return new core_common_1.SubCategoryAppearance(props);
     }
-    processResults(result, missing) {
-        for (const row of result)
-            this.add(row.parentId, row.id, SubCategoriesCache.createSubCategoryAppearance(row.appearance));
+    processResults(result, missing, override = true) {
+        for (const row of result) {
+            this.add(row.parentId, row.id, SubCategoriesCache.createSubCategoryAppearance(row.appearance), override);
+        }
         // Ensure that any category Ids which returned no results (e.g., non-existent category, invalid Id, etc) are still recorded so they are not repeatedly re-requested
         for (const id of missing)
             if (undefined === this._byCategoryId.get(id))
@@ -78,12 +91,13 @@ class SubCategoriesCache {
     /** Exposed strictly for tests.
      * @internal
      */
-    add(categoryId, subCategoryId, appearance) {
+    add(categoryId, subCategoryId, appearance, override) {
         let set = this._byCategoryId.get(categoryId);
         if (undefined === set)
             this._byCategoryId.set(categoryId, set = new Set());
         set.add(subCategoryId);
-        this._appearances.set(subCategoryId, appearance);
+        if (override)
+            this._appearances.set(subCategoryId, appearance);
     }
     async getCategoryInfo(inputCategoryIds) {
         // Eliminate duplicates...

package/lib/cjs/SubCategoriesCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubCategoriesCache.js","sourceRoot":"","sources":["../../src/SubCategoriesCache.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { assert, CompressedId64Set, Id64, Id64Arg, Id64Set, Id64String, OrderedId64Iterable } from \"@itwin/core-bentley\";\r\nimport { SubCategoryAppearance, SubCategoryResultRow } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\n\r\n/** A cancelable paginated request for subcategory information.\r\n * @see SubCategoriesCache\r\n * @internal\r\n */\r\nexport interface SubCategoriesRequest {\r\n  /** The Ids of any categories which were requested but were not yet loaded. */\r\n  readonly missingCategoryIds: Id64Set;\r\n  /** A promise which resolves to true when all of the requested categories have been loaded, or to false if not all categories were loaded.\r\n   * Categories may fail to load if the request is explicitly canceled or if the IModelConnection is closed before all categories are loaded.\r\n   */\r\n  readonly promise: Promise<boolean>;\r\n  /** Cancels the request. */\r\n  cancel(): void;\r\n}\r\n\r\nconst invalidCategoryIdEntry = new Set<string>();\r\n\r\n/** A cache of information about the subcategories contained within an [[IModelConnection]]. It is populated on demand.\r\n * @internal\r\n */\r\nexport class SubCategoriesCache {\r\n  private readonly _byCategoryId = new Map<string, Id64Set>();\r\n  private readonly _appearances = new Map<string, SubCategoryAppearance>();\r\n  private readonly _imodel: IModelConnection;\r\n  private _missingAtTimeOfPreload: Id64Set | undefined;\r\n\r\n  public constructor(imodel: IModelConnection) { this._imodel = imodel; }\r\n\r\n  /** Get the Ids of all subcategories belonging to the category with the specified Id, or undefined if no such information is present. */\r\n  public getSubCategories(categoryId: string): Id64Set | undefined { return this._byCategoryId.get(categoryId); }\r\n\r\n  /** Get the base appearance of the subcategory with the specified Id, or undefined if no such information is present. */\r\n  public getSubCategoryAppearance(subCategoryId: Id64String): SubCategoryAppearance | undefined { return this._appearances.get(subCategoryId.toString()); }\r\n\r\n  /** Request that the subcategory information for all of the specified categories is loaded.\r\n   * If all such information has already been loaded, returns undefined.\r\n   * Otherwise, dispatches an asynchronous request to load those categories which are not already loaded and returns a cancellable request object\r\n   * containing the corresponding promise and the set of categories still to be loaded.\r\n   */\r\n  public load(categoryIds: Id64Arg): SubCategoriesRequest | undefined {\r\n    const missing = this.getMissing(categoryIds);\r\n    if (undefined === missing)\r\n      return undefined;\r\n\r\n    const request = new SubCategoriesCache.Request(missing, this._imodel);\r\n    const promise = request.dispatch().then((result?: SubCategoriesCache.Result) => {\r\n      if (undefined !== result)\r\n        this.processResults(result, missing);\r\n\r\n      return !request.wasCanceled;\r\n    });\r\n\r\n    return {\r\n      missingCategoryIds: missing,\r\n      promise,\r\n      cancel: () => request.cancel(),\r\n    };\r\n  }\r\n\r\n  /** Given categoryIds, return which of these are not cached. */\r\n  private getMissing(categoryIds: Id64Arg): Id64Set | undefined {\r\n    let missing: Id64Set | undefined;\r\n    for (const catId of Id64.iterable(categoryIds)) {\r\n      if (undefined === this._byCategoryId.get(catId)) {\r\n        if (undefined === missing)\r\n          missing = new Set<string>();\r\n\r\n        missing.add(catId);\r\n      }\r\n    }\r\n\r\n    return missing;\r\n  }\r\n\r\n  public clear(): void {\r\n    this._byCategoryId.clear();\r\n    this._appearances.clear();\r\n  }\r\n\r\n  public onIModelConnectionClose(): void {\r\n    this.clear();\r\n  }\r\n\r\n  private static createSubCategoryAppearance(json?: any) {\r\n    let props: SubCategoryAppearance.Props | undefined;\r\n    if (\"string\" === typeof json && 0 < json.length)\r\n      props = JSON.parse(json);\r\n\r\n    return new SubCategoryAppearance(props);\r\n  }\r\n\r\n  private processResults(result: SubCategoriesCache.Result, missing: Id64Set): void {\r\n    for (const row of result)\r\n      this.add(row.parentId, row.id, SubCategoriesCache.createSubCategoryAppearance(row.appearance));\r\n\r\n    // Ensure that any category Ids which returned no results (e.g., non-existent category, invalid Id, etc) are still recorded so they are not repeatedly re-requested\r\n    for (const id of missing)\r\n      if (undefined === this._byCategoryId.get(id))\r\n        this._byCategoryId.set(id, invalidCategoryIdEntry);\r\n  }\r\n\r\n  /** Exposed strictly for tests.\r\n   * @internal\r\n   */\r\n  public add(categoryId: string, subCategoryId: string, appearance: SubCategoryAppearance) {\r\n    let set = this._byCategoryId.get(categoryId);\r\n    if (undefined === set)\r\n      this._byCategoryId.set(categoryId, set = new Set<string>());\r\n\r\n    set.add(subCategoryId);\r\n    this._appearances.set(subCategoryId, appearance);\r\n  }\r\n\r\n  public async getCategoryInfo(inputCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.CategoryInfo>> {\r\n    // Eliminate duplicates...\r\n    const categoryIds = new Set<string>(typeof inputCategoryIds === \"string\" ? [inputCategoryIds] : inputCategoryIds);\r\n    const req = this.load(categoryIds);\r\n    if (req)\r\n      await req.promise;\r\n\r\n    const map = new Map<Id64String, IModelConnection.Categories.CategoryInfo>();\r\n    for (const categoryId of categoryIds) {\r\n      const subCategoryIds = this._byCategoryId.get(categoryId);\r\n      if (!subCategoryIds)\r\n        continue;\r\n\r\n      const subCategories = this.mapSubCategoryInfos(categoryId, subCategoryIds);\r\n      map.set(categoryId, { id: categoryId, subCategories });\r\n    }\r\n\r\n    return map;\r\n  }\r\n\r\n  public async getSubCategoryInfo(categoryId: Id64String, inputSubCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.SubCategoryInfo>> {\r\n    // Eliminate duplicates...\r\n    const subCategoryIds = new Set<string>(typeof inputSubCategoryIds === \"string\" ? [inputSubCategoryIds] : inputSubCategoryIds);\r\n    const req = this.load(categoryId);\r\n    if (req)\r\n      await req.promise;\r\n\r\n    return this.mapSubCategoryInfos(categoryId, subCategoryIds);\r\n  }\r\n\r\n  private mapSubCategoryInfos(categoryId: Id64String, subCategoryIds: Set<Id64String>): Map<Id64String, IModelConnection.Categories.SubCategoryInfo> {\r\n    const map = new Map<Id64String, IModelConnection.Categories.SubCategoryInfo>();\r\n    for (const id of subCategoryIds) {\r\n      const appearance = this._appearances.get(id);\r\n      if (appearance)\r\n        map.set(id, { id, categoryId, appearance });\r\n    }\r\n\r\n    return map;\r\n  }\r\n}\r\n\r\n/** This namespace and the types within it are exported strictly for use in tests.\r\n * @internal\r\n */\r\nexport namespace SubCategoriesCache { // eslint-disable-line no-redeclare\r\n  export type Result = SubCategoryResultRow[];\r\n\r\n  export class Request {\r\n    private readonly _imodel: IModelConnection;\r\n    private readonly _categoryIds: CompressedId64Set[] = [];\r\n    private readonly _result: Result = [];\r\n    private _canceled = false;\r\n    private _curCategoryIdsIndex = 0;\r\n\r\n    public get wasCanceled() { return this._canceled || this._imodel.isClosed; }\r\n\r\n    public constructor(categoryIds: Set<string>, imodel: IModelConnection, maxCategoriesPerQuery = 2500) {\r\n      this._imodel = imodel;\r\n\r\n      const catIds = [...categoryIds];\r\n      OrderedId64Iterable.sortArray(catIds); // sort categories, so that given the same set of categoryIds we will always create the same batches.\r\n      while (catIds.length !== 0) {\r\n        const end = (catIds.length > maxCategoriesPerQuery) ? maxCategoriesPerQuery : catIds.length;\r\n        const compressedIds = CompressedId64Set.compressArray(catIds.splice(0, end));\r\n        this._categoryIds.push(compressedIds);\r\n      }\r\n    }\r\n\r\n    public cancel() { this._canceled = true; }\r\n\r\n    public async dispatch(): Promise<Result | undefined> {\r\n      if (this.wasCanceled || this._curCategoryIdsIndex >= this._categoryIds.length) // handle case of empty category Id set...\r\n        return undefined;\r\n\r\n      try {\r\n        const catIds = this._categoryIds[this._curCategoryIdsIndex];\r\n        const result = await this._imodel.querySubCategories(catIds);\r\n        this._result.push(...result);\r\n        if (this.wasCanceled)\r\n          return undefined;\r\n      } catch {\r\n        // ###TODO: detect cases in which retry is warranted\r\n        // Note that currently, if we succeed in obtaining some pages of results and fail to retrieve another page, we will end up processing the\r\n        // incomplete results. Since we're not retrying, that's the best we can do.\r\n      }\r\n\r\n      // Finished with current batch of categoryIds. Dispatch the next batch if one exists.\r\n      if (++this._curCategoryIdsIndex < this._categoryIds.length) {\r\n        if (this.wasCanceled)\r\n          return undefined;\r\n        else\r\n          return this.dispatch();\r\n      }\r\n\r\n      // Even if we were canceled, we've retrieved all the rows. Might as well process them to prevent another request for some of the same rows from being enqueued.\r\n      return this._result;\r\n    }\r\n  }\r\n\r\n  export type QueueFunc = () => void;\r\n\r\n  export class QueueEntry {\r\n    public readonly categoryIds: Id64Set;\r\n    public readonly funcs: QueueFunc[];\r\n\r\n    public constructor(categoryIds: Id64Set, func: QueueFunc) {\r\n      this.categoryIds = categoryIds;\r\n      this.funcs = [func];\r\n    }\r\n  }\r\n\r\n  /** A \"queue\" of SubCategoriesRequests, which consists of between 0 and 2 entries. Each entry specifies the set of category IDs to be loaded and a list of functions to be executed\r\n   * when loading is completed. This is used to enforce ordering of operations upon subcategories despite the need to asynchronously load them. It incidentally also provides an\r\n   * opportunity to reduce the number of backend requests by batching consecutive requests.\r\n   * Chiefly used by [[Viewport]].\r\n   * @internal\r\n   */\r\n  export class Queue {\r\n    /* NB: Members marked protected for use in tests only. */\r\n    protected _current?: QueueEntry;\r\n    protected _next?: QueueEntry;\r\n    protected _request?: SubCategoriesRequest;\r\n    protected _disposed = false;\r\n\r\n    /** Push a request onto the queue. The requested categories will be loaded if necessary, and then\r\n     * the supplied function will be invoked. Any previously-pushed requests are guaranteed to be processed before this one.\r\n     */\r\n    public push(cache: SubCategoriesCache, categoryIds: Id64Arg, func: QueueFunc): void {\r\n      if (this._disposed)\r\n        return;\r\n      else if (undefined === this._current)\r\n        this.pushCurrent(cache, categoryIds, func);\r\n      else\r\n        this.pushNext(categoryIds, func);\r\n    }\r\n\r\n    /** Cancel all requests and empty the queue. */\r\n    public dispose(): void {\r\n      if (undefined !== this._request) {\r\n        assert(undefined !== this._current);\r\n        this._request.cancel();\r\n        this._request = undefined;\r\n      }\r\n\r\n      this._current = this._next = undefined;\r\n      this._disposed = true;\r\n    }\r\n\r\n    public get isEmpty(): boolean {\r\n      return undefined === this._current && undefined === this._next;\r\n    }\r\n\r\n    private pushCurrent(cache: SubCategoriesCache, categoryIds: Id64Arg, func: QueueFunc): void {\r\n      assert(undefined === this._next);\r\n      assert(undefined === this._current);\r\n      assert(undefined === this._request);\r\n\r\n      this._request = cache.load(categoryIds);\r\n      if (undefined === this._request) {\r\n        // All requested categories are already loaded.\r\n        func();\r\n        return;\r\n      } else {\r\n        // We need to load the requested categories before invoking the function.\r\n        this.processCurrent(cache, new QueueEntry(Id64.toIdSet(categoryIds, true), func));\r\n      }\r\n    }\r\n\r\n    private processCurrent(cache: SubCategoriesCache, entry: QueueEntry): void {\r\n      assert(undefined !== this._request);\r\n      assert(undefined === this._current);\r\n      assert(undefined === this._next);\r\n\r\n      this._current = entry;\r\n      this._request.promise.then((completed: boolean) => { // eslint-disable-line @typescript-eslint/no-floating-promises\r\n        if (this._disposed)\r\n          return;\r\n\r\n        // Invoke all the functions which were awaiting this set of IModelConnection.Categories.\r\n        assert(undefined !== this._current);\r\n        if (completed)\r\n          for (const func of this._current.funcs)\r\n            func();\r\n\r\n        this._request = undefined;\r\n        this._current = undefined;\r\n\r\n        // If we have more requests, process them.\r\n        const next = this._next;\r\n        this._next = undefined;\r\n        if (undefined !== next) {\r\n          this._request = cache.load(next.categoryIds);\r\n          if (undefined === this._request) {\r\n            // All categories loaded.\r\n            for (const func of next.funcs)\r\n              func();\r\n          } else {\r\n            // We need to load the requested categories before invoking the pending functions.\r\n            this.processCurrent(cache, next);\r\n          }\r\n        }\r\n      });\r\n    }\r\n\r\n    private pushNext(categoryIds: Id64Arg, func: QueueFunc): void {\r\n      assert(undefined !== this._current);\r\n      assert(undefined !== this._request);\r\n\r\n      if (undefined === this._next) {\r\n        // We have a request currently in process and none pending.\r\n        // We could potentially determine that this request doesn't require any categories that are not already loaded or being loaded by the current request.\r\n        // But we will find that out (synchronously) when current request completes, unless more requests come in. Probably not worth it.\r\n        this._next = new QueueEntry(Id64.toIdSet(categoryIds, true), func);\r\n      } else {\r\n        // We have a request currently in process, and one or more pending. Append this one to the pending.\r\n        this._next.funcs.push(func);\r\n        for (const categoryId of Id64.iterable(categoryIds))\r\n          this._next.categoryIds.add(categoryId);\r\n      }\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SubCategoriesCache.js","sourceRoot":"","sources":["../../src/SubCategoriesCache.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { assert, CompressedId64Set, Id64, Id64Arg, Id64Set, Id64String, OrderedId64Iterable } from \"@itwin/core-bentley\";\r\nimport { SubCategoryAppearance, SubCategoryResultRow } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\n\r\n/** A cancelable paginated request for subcategory information.\r\n * @see SubCategoriesCache\r\n * @internal\r\n */\r\nexport interface SubCategoriesRequest {\r\n  /** The Ids of any categories which were requested but were not yet loaded. */\r\n  readonly missingCategoryIds: Id64Set;\r\n  /** A promise which resolves to true when all of the requested categories have been loaded, or to false if not all categories were loaded.\r\n   * Categories may fail to load if the request is explicitly canceled or if the IModelConnection is closed before all categories are loaded.\r\n   */\r\n  readonly promise: Promise<boolean>;\r\n  /** Cancels the request. */\r\n  cancel(): void;\r\n}\r\n\r\nconst invalidCategoryIdEntry = new Set<string>();\r\n\r\n/** A cache of information about the subcategories contained within an [[IModelConnection]]. It is populated on demand.\r\n * @internal\r\n */\r\nexport class SubCategoriesCache {\r\n  private readonly _byCategoryId = new Map<string, Id64Set>();\r\n  private readonly _appearances = new Map<string, SubCategoryAppearance>();\r\n  private readonly _imodel: IModelConnection;\r\n  private _missingAtTimeOfPreload: Id64Set | undefined;\r\n\r\n  public constructor(imodel: IModelConnection) { this._imodel = imodel; }\r\n\r\n  /** Get the Ids of all subcategories belonging to the category with the specified Id, or undefined if no such information is present. */\r\n  public getSubCategories(categoryId: string): Id64Set | undefined { return this._byCategoryId.get(categoryId); }\r\n\r\n  /** Get the base appearance of the subcategory with the specified Id, or undefined if no such information is present. */\r\n  public getSubCategoryAppearance(subCategoryId: Id64String): SubCategoryAppearance | undefined { return this._appearances.get(subCategoryId.toString()); }\r\n\r\n  /** Request that the subcategory information for all of the specified categories is loaded.\r\n   * If all such information has already been loaded, returns undefined.\r\n   * Otherwise, dispatches an asynchronous request to load those categories which are not already loaded and returns a cancellable request object\r\n   * containing the corresponding promise and the set of categories still to be loaded.\r\n   */\r\n  public load(categoryIds: Id64Arg): SubCategoriesRequest | undefined {\r\n    const missing = this.getMissing(categoryIds);\r\n    if (undefined === missing)\r\n      return undefined;\r\n\r\n    const request = new SubCategoriesCache.Request(missing, this._imodel);\r\n    const promise = request.dispatch().then((result?: SubCategoriesCache.Result) => {\r\n      if (undefined !== result)\r\n        this.processResults(result, missing);\r\n\r\n      return !request.wasCanceled;\r\n    });\r\n    return {\r\n      missingCategoryIds: missing,\r\n      promise,\r\n      cancel: () => request.cancel(),\r\n    };\r\n  }\r\n\r\n  /** Load all subcategories that come from used spatial categories of the iModel into the cache. */\r\n  public async loadAllUsedSpatialSubCategories(): Promise<void> {\r\n    try {\r\n      const results = await this._imodel.queryAllUsedSpatialSubCategories();\r\n      if (undefined !== results){\r\n        this.processResults(results, new Set<string>(), false);\r\n      }\r\n    } catch (e) {\r\n      // In case of a truncated response, gracefully handle the error and exit.\r\n    }\r\n\r\n  }\r\n  /** Given categoryIds, return which of these are not cached. */\r\n  private getMissing(categoryIds: Id64Arg): Id64Set | undefined {\r\n    let missing: Id64Set | undefined;\r\n    for (const catId of Id64.iterable(categoryIds)) {\r\n      if (undefined === this._byCategoryId.get(catId)) {\r\n        if (undefined === missing)\r\n          missing = new Set<string>();\r\n\r\n        missing.add(catId);\r\n      }\r\n    }\r\n\r\n    return missing;\r\n  }\r\n\r\n  public clear(): void {\r\n    this._byCategoryId.clear();\r\n    this._appearances.clear();\r\n  }\r\n\r\n  public onIModelConnectionClose(): void {\r\n    this.clear();\r\n  }\r\n\r\n  private static createSubCategoryAppearance(json?: any) {\r\n    let props: SubCategoryAppearance.Props | undefined;\r\n    if (\"string\" === typeof json && 0 < json.length)\r\n      props = JSON.parse(json);\r\n\r\n    return new SubCategoryAppearance(props);\r\n  }\r\n\r\n  private processResults(result: SubCategoriesCache.Result, missing: Id64Set, override: boolean = true): void {\r\n    for (const row of result){\r\n      this.add(row.parentId, row.id, SubCategoriesCache.createSubCategoryAppearance(row.appearance), override);\r\n    }\r\n\r\n    // Ensure that any category Ids which returned no results (e.g., non-existent category, invalid Id, etc) are still recorded so they are not repeatedly re-requested\r\n    for (const id of missing)\r\n      if (undefined === this._byCategoryId.get(id))\r\n        this._byCategoryId.set(id, invalidCategoryIdEntry);\r\n  }\r\n\r\n  /** Exposed strictly for tests.\r\n   * @internal\r\n   */\r\n  public add(categoryId: string, subCategoryId: string, appearance: SubCategoryAppearance, override: boolean) {\r\n    let set = this._byCategoryId.get(categoryId);\r\n    if (undefined === set)\r\n      this._byCategoryId.set(categoryId, set = new Set<string>());\r\n\r\n    set.add(subCategoryId);\r\n    if (override)\r\n      this._appearances.set(subCategoryId, appearance);\r\n  }\r\n\r\n  public async getCategoryInfo(inputCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.CategoryInfo>> {\r\n    // Eliminate duplicates...\r\n    const categoryIds = new Set<string>(typeof inputCategoryIds === \"string\" ? [inputCategoryIds] : inputCategoryIds);\r\n    const req = this.load(categoryIds);\r\n    if (req)\r\n      await req.promise;\r\n\r\n    const map = new Map<Id64String, IModelConnection.Categories.CategoryInfo>();\r\n    for (const categoryId of categoryIds) {\r\n      const subCategoryIds = this._byCategoryId.get(categoryId);\r\n      if (!subCategoryIds)\r\n        continue;\r\n\r\n      const subCategories = this.mapSubCategoryInfos(categoryId, subCategoryIds);\r\n      map.set(categoryId, { id: categoryId, subCategories });\r\n    }\r\n\r\n    return map;\r\n  }\r\n\r\n  public async getSubCategoryInfo(categoryId: Id64String, inputSubCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.SubCategoryInfo>> {\r\n    // Eliminate duplicates...\r\n    const subCategoryIds = new Set<string>(typeof inputSubCategoryIds === \"string\" ? [inputSubCategoryIds] : inputSubCategoryIds);\r\n    const req = this.load(categoryId);\r\n    if (req)\r\n      await req.promise;\r\n\r\n    return this.mapSubCategoryInfos(categoryId, subCategoryIds);\r\n  }\r\n\r\n  private mapSubCategoryInfos(categoryId: Id64String, subCategoryIds: Set<Id64String>): Map<Id64String, IModelConnection.Categories.SubCategoryInfo> {\r\n    const map = new Map<Id64String, IModelConnection.Categories.SubCategoryInfo>();\r\n    for (const id of subCategoryIds) {\r\n      const appearance = this._appearances.get(id);\r\n      if (appearance)\r\n        map.set(id, { id, categoryId, appearance });\r\n    }\r\n\r\n    return map;\r\n  }\r\n}\r\n\r\n/** This namespace and the types within it are exported strictly for use in tests.\r\n * @internal\r\n */\r\nexport namespace SubCategoriesCache { // eslint-disable-line no-redeclare\r\n  export type Result = SubCategoryResultRow[];\r\n\r\n  export class Request {\r\n    private readonly _imodel: IModelConnection;\r\n    private readonly _categoryIds: CompressedId64Set[] = [];\r\n    private readonly _result: Result = [];\r\n    private _canceled = false;\r\n    private _curCategoryIdsIndex = 0;\r\n\r\n    public get wasCanceled() { return this._canceled || this._imodel.isClosed; }\r\n\r\n    public constructor(categoryIds: Set<string>, imodel: IModelConnection, maxCategoriesPerQuery = 2500) {\r\n      this._imodel = imodel;\r\n\r\n      const catIds = [...categoryIds];\r\n      OrderedId64Iterable.sortArray(catIds); // sort categories, so that given the same set of categoryIds we will always create the same batches.\r\n      while (catIds.length !== 0) {\r\n        const end = (catIds.length > maxCategoriesPerQuery) ? maxCategoriesPerQuery : catIds.length;\r\n        const compressedIds = CompressedId64Set.compressArray(catIds.splice(0, end));\r\n        this._categoryIds.push(compressedIds);\r\n      }\r\n    }\r\n\r\n    public cancel() { this._canceled = true; }\r\n\r\n    public async dispatch(): Promise<Result | undefined> {\r\n      if (this.wasCanceled || this._curCategoryIdsIndex >= this._categoryIds.length) // handle case of empty category Id set...\r\n        return undefined;\r\n\r\n      try {\r\n        const catIds = this._categoryIds[this._curCategoryIdsIndex];\r\n        const result = await this._imodel.querySubCategories(catIds);\r\n        this._result.push(...result);\r\n        if (this.wasCanceled)\r\n          return undefined;\r\n      } catch {\r\n        // ###TODO: detect cases in which retry is warranted\r\n        // Note that currently, if we succeed in obtaining some pages of results and fail to retrieve another page, we will end up processing the\r\n        // incomplete results. Since we're not retrying, that's the best we can do.\r\n      }\r\n\r\n      // Finished with current batch of categoryIds. Dispatch the next batch if one exists.\r\n      if (++this._curCategoryIdsIndex < this._categoryIds.length) {\r\n        if (this.wasCanceled)\r\n          return undefined;\r\n        else\r\n          return this.dispatch();\r\n      }\r\n\r\n      // Even if we were canceled, we've retrieved all the rows. Might as well process them to prevent another request for some of the same rows from being enqueued.\r\n      return this._result;\r\n    }\r\n  }\r\n\r\n  export type QueueFunc = () => void;\r\n\r\n  export class QueueEntry {\r\n    public readonly categoryIds: Id64Set;\r\n    public readonly funcs: QueueFunc[];\r\n\r\n    public constructor(categoryIds: Id64Set, func: QueueFunc) {\r\n      this.categoryIds = categoryIds;\r\n      this.funcs = [func];\r\n    }\r\n  }\r\n\r\n  /** A \"queue\" of SubCategoriesRequests, which consists of between 0 and 2 entries. Each entry specifies the set of category IDs to be loaded and a list of functions to be executed\r\n   * when loading is completed. This is used to enforce ordering of operations upon subcategories despite the need to asynchronously load them. It incidentally also provides an\r\n   * opportunity to reduce the number of backend requests by batching consecutive requests.\r\n   * Chiefly used by [[Viewport]].\r\n   * @internal\r\n   */\r\n  export class Queue {\r\n    /* NB: Members marked protected for use in tests only. */\r\n    protected _current?: QueueEntry;\r\n    protected _next?: QueueEntry;\r\n    protected _request?: SubCategoriesRequest;\r\n    protected _disposed = false;\r\n\r\n    /** Push a request onto the queue. The requested categories will be loaded if necessary, and then\r\n     * the supplied function will be invoked. Any previously-pushed requests are guaranteed to be processed before this one.\r\n     */\r\n    public push(cache: SubCategoriesCache, categoryIds: Id64Arg, func: QueueFunc): void {\r\n      if (this._disposed)\r\n        return;\r\n      else if (undefined === this._current)\r\n        this.pushCurrent(cache, categoryIds, func);\r\n      else\r\n        this.pushNext(categoryIds, func);\r\n    }\r\n\r\n    /** Cancel all requests and empty the queue. */\r\n    public dispose(): void {\r\n      if (undefined !== this._request) {\r\n        assert(undefined !== this._current);\r\n        this._request.cancel();\r\n        this._request = undefined;\r\n      }\r\n\r\n      this._current = this._next = undefined;\r\n      this._disposed = true;\r\n    }\r\n\r\n    public get isEmpty(): boolean {\r\n      return undefined === this._current && undefined === this._next;\r\n    }\r\n\r\n    private pushCurrent(cache: SubCategoriesCache, categoryIds: Id64Arg, func: QueueFunc): void {\r\n      assert(undefined === this._next);\r\n      assert(undefined === this._current);\r\n      assert(undefined === this._request);\r\n\r\n      this._request = cache.load(categoryIds);\r\n      if (undefined === this._request) {\r\n        // All requested categories are already loaded.\r\n        func();\r\n        return;\r\n      } else {\r\n        // We need to load the requested categories before invoking the function.\r\n        this.processCurrent(cache, new QueueEntry(Id64.toIdSet(categoryIds, true), func));\r\n      }\r\n    }\r\n\r\n    private processCurrent(cache: SubCategoriesCache, entry: QueueEntry): void {\r\n      assert(undefined !== this._request);\r\n      assert(undefined === this._current);\r\n      assert(undefined === this._next);\r\n\r\n      this._current = entry;\r\n      this._request.promise.then((completed: boolean) => { // eslint-disable-line @typescript-eslint/no-floating-promises\r\n        if (this._disposed)\r\n          return;\r\n\r\n        // Invoke all the functions which were awaiting this set of IModelConnection.Categories.\r\n        assert(undefined !== this._current);\r\n        if (completed)\r\n          for (const func of this._current.funcs)\r\n            func();\r\n\r\n        this._request = undefined;\r\n        this._current = undefined;\r\n\r\n        // If we have more requests, process them.\r\n        const next = this._next;\r\n        this._next = undefined;\r\n        if (undefined !== next) {\r\n          this._request = cache.load(next.categoryIds);\r\n          if (undefined === this._request) {\r\n            // All categories loaded.\r\n            for (const func of next.funcs)\r\n              func();\r\n          } else {\r\n            // We need to load the requested categories before invoking the pending functions.\r\n            this.processCurrent(cache, next);\r\n          }\r\n        }\r\n      });\r\n    }\r\n\r\n    private pushNext(categoryIds: Id64Arg, func: QueueFunc): void {\r\n      assert(undefined !== this._current);\r\n      assert(undefined !== this._request);\r\n\r\n      if (undefined === this._next) {\r\n        // We have a request currently in process and none pending.\r\n        // We could potentially determine that this request doesn't require any categories that are not already loaded or being loaded by the current request.\r\n        // But we will find that out (synchronously) when current request completes, unless more requests come in. Probably not worth it.\r\n        this._next = new QueueEntry(Id64.toIdSet(categoryIds, true), func);\r\n      } else {\r\n        // We have a request currently in process, and one or more pending. Append this one to the pending.\r\n        this._next.funcs.push(func);\r\n        for (const categoryId of Id64.iterable(categoryIds))\r\n          this._next.categoryIds.add(categoryId);\r\n      }\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/ViewCreator3d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewCreator3d.d.ts","sourceRoot":"","sources":["../../src/ViewCreator3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAsC,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,kIAAkI;AAElI;;;EAGE;AACF,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,OAAO;IAJ3B;;;OAGG;gBACiB,OAAO,EAAE,gBAAgB;IAE7C;;;;;OAKG;IACU,iBAAiB,CAAC,OAAO,CAAC,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IA+B3G;;;;OAIG;YACW,qBAAqB;IAkGnC;;;OAGG;YACW,cAAc;IAwB5B;;OAEG;YACW,iBAAiB;CAUhC"}
+{"version":3,"file":"ViewCreator3d.d.ts","sourceRoot":"","sources":["../../src/ViewCreator3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAsC,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,kIAAkI;AAElI;;;EAGE;AACF,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,OAAO;IAJ3B;;;OAGG;gBACiB,OAAO,EAAE,gBAAgB;IAE7C;;;;;OAKG;IACU,iBAAiB,CAAC,OAAO,CAAC,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAgC3G;;;;OAIG;YACW,qBAAqB;IAkGnC;;;OAGG;YACW,cAAc;IAwB5B;;OAEG;YACW,iBAAiB;CAUhC"}

package/lib/cjs/ViewCreator3d.js

@@ -44,6 +44,7 @@ class ViewCreator3d {
         const props = await this._createViewStateProps(core_bentley_1.CompressedId64Set.decompressArray(serializedProps.modelIds), core_bentley_1.CompressedId64Set.decompressArray(serializedProps.categoryIds), baseExtents, options);
         const viewState = SpatialViewState_1.SpatialViewState.createFromProps(props, this._imodel);
         try {
+            await viewState.iModel.subcategories.loadAllUsedSpatialSubCategories();
             await viewState.load();
         }
         catch {

package/lib/cjs/ViewCreator3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewCreator3d.js","sourceRoot":"","sources":["../../src/ViewCreator3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { CompressedId64Set, Id64, Id64Array, Id64String } from \"@itwin/core-bentley\";\r\nimport {\r\n  Camera, CategorySelectorProps, Code, CustomViewState3dCreatorOptions, DisplayStyle3dProps, Environment, IModel, IModelReadRpcInterface,\r\n  ModelSelectorProps, RenderMode, ViewDefinition3dProps, ViewStateProps,\r\n} from \"@itwin/core-common\";\r\nimport { Range3d } from \"@itwin/core-geometry\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\nimport { SpatialViewState } from \"./SpatialViewState\";\r\nimport { StandardViewId } from \"./StandardView\";\r\nimport { ViewState } from \"./ViewState\";\r\n\r\n/** Api for creating a 3d default view for an iModel. Either takes in a list of modelIds, or displays all 3d models by default. */\r\n\r\n/** Options for creating a [[ViewState3d]] via [[ViewCreator3d]].\r\n *  @public\r\n * @extensions\r\n*/\r\nexport interface ViewCreator3dOptions {\r\n  /** Turn the [[Camera]] on to produce a perspective view.\r\n   * Default: true\r\n   */\r\n  cameraOn?: boolean;\r\n  /** Enables display of a [[SkyBox]] in the view. */\r\n  skyboxOn?: boolean;\r\n  /** Orients the view to one of the standard view rotations. */\r\n  standardViewId?: StandardViewId;\r\n  /** Merge in props from a persistent \"seed\" view obtained from the iModel.\r\n   * @note The selection of the seed view is somewhat arbitrary, and the contents and styling of that view are unpredictable, so this option is not recommended.\r\n   */\r\n  useSeedView?: boolean;\r\n  /** The desired aspect ratio of the [[Viewport]] in which the view is to be displayed.\r\n   * This is used to adjust the view's frustum so that the viewed models are better centered within the viewport.\r\n   */\r\n  vpAspect?: number;\r\n  /** Indicates that geometry belonging to every [SubCategory]($backend) should be visible within the view.\r\n   * Each subcategory has a [SubCategoryAppearance]($common) that specifies how its geometry is displayed. This includes a [SubCategoryAppearance.invisible]($common) property that,\r\n   * when set to `true`, indicates the geometry should not be displayed at all. A view can override the appearances of any subcategories using a [SubCategoryOverride]($common).\r\n   * If `allSubCategoriesVisible` is `true`, [[ViewCreator3d]] will apply such an override to every viewed subcategory to change [SubCategoryOverride.invisible]($common) to `false`, making\r\n   * every subcategory visible.\r\n   * @note Subcategories are typically set to invisible by default for a reason.\r\n   * Forcing them all to be visible may produce undesirable results, such as z-fighting between geometry on different subcategories that are not intended to be viewed together.\r\n   */\r\n  allSubCategoriesVisible?: boolean;\r\n}\r\n\r\n/**\r\n * API for creating a 3D default [[ViewState3d]] for an iModel. @see [[ViewCreator2d]] to create a view for a 2d model.\r\n * Example usage:\r\n * ```ts\r\n * const viewCreator = new ViewCreator3d(imodel);\r\n * const defaultView = await viewCreator.createDefaultView({skyboxOn: true});\r\n * ```\r\n * @public\r\n * @extensions\r\n */\r\nexport class ViewCreator3d {\r\n  /**\r\n   * Constructs a ViewCreator3d using an [[IModelConnection]].\r\n   * @param _imodel [[IModelConnection]] to query for categories and/or models.\r\n   */\r\n  constructor(private _imodel: IModelConnection) { }\r\n\r\n  /**\r\n   * Creates a default [[ViewState3d]] based on the model ids passed in. If no model ids are passed in, all 3D models in the iModel are used.\r\n   * @param [options] Options for creating the view.\r\n   * @param [modelIds] Ids of models to display in the view.\r\n   * @throws [IModelError]($common) If no 3d models are found in the iModel.\r\n   */\r\n  public async createDefaultView(options?: ViewCreator3dOptions, modelIds?: Id64String[]): Promise<ViewState> {\r\n    const rpcOptions: CustomViewState3dCreatorOptions = modelIds ? { modelIds: CompressedId64Set.sortAndCompress(modelIds) } : {};\r\n    const rpc = IModelReadRpcInterface.getClientForRouting(this._imodel.routingContext.token);\r\n    const serializedProps = await rpc.getCustomViewState3dData(this._imodel.getRpcProps(), rpcOptions);\r\n\r\n    const baseExtents = Range3d.fromJSON(serializedProps.modelExtents);\r\n    const props = await this._createViewStateProps(\r\n      CompressedId64Set.decompressArray(serializedProps.modelIds),\r\n      CompressedId64Set.decompressArray(serializedProps.categoryIds),\r\n      baseExtents,\r\n      options,\r\n    );\r\n\r\n    const viewState = SpatialViewState.createFromProps(props, this._imodel);\r\n    try {\r\n      await viewState.load();\r\n    } catch {\r\n    }\r\n\r\n    if (options?.standardViewId)\r\n      viewState.setStandardRotation(options.standardViewId);\r\n\r\n    if (options?.allSubCategoriesVisible)\r\n      viewState.displayStyle.enableAllLoadedSubCategories(viewState.categorySelector.categories);\r\n\r\n    const range = viewState.computeFitRange({ baseExtents });\r\n    viewState.lookAtVolume(range, options?.vpAspect);\r\n\r\n    return viewState;\r\n  }\r\n\r\n  /**\r\n   * Generates a view state props object for creating a view. Merges display styles with a seed view if the options.useSeedView is true\r\n   * @param models Models to put in view props\r\n   * @param options view creation options like camera On and skybox On\r\n   */\r\n  private async _createViewStateProps(models: Id64Array, categories: Id64Array, modelExtents: Range3d, options?: ViewCreator3dOptions): Promise<ViewStateProps> {\r\n    // Use dictionary model in all props\r\n    const dictionaryId = IModel.dictionaryId;\r\n\r\n    if (modelExtents.isNull)\r\n      modelExtents.setFrom(this._imodel.projectExtents);\r\n\r\n    let originX = modelExtents.low.x;\r\n    let originY = modelExtents.low.y;\r\n    const originZ = modelExtents.low.z;\r\n    let deltaX = modelExtents.xLength();\r\n    let deltaY = modelExtents.yLength();\r\n    const deltaZ = modelExtents.zLength();\r\n\r\n    // if vp aspect given, update model extents to fit view\r\n    if (options?.vpAspect) {\r\n      const modelAspect = deltaY / deltaX;\r\n\r\n      if (modelAspect > options.vpAspect) {\r\n        const xFix = deltaY / options.vpAspect;\r\n        originX = originX - xFix / 2;\r\n        deltaX = deltaX + xFix;\r\n      } else if (modelAspect < options.vpAspect) {\r\n        const yFix = deltaX * options.vpAspect;\r\n        originY = originY - yFix / 2;\r\n        deltaY = deltaY + yFix;\r\n      }\r\n    }\r\n\r\n    const categorySelectorProps: CategorySelectorProps = {\r\n      categories,\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      classFullName: \"BisCore:CategorySelector\",\r\n    };\r\n\r\n    const modelSelectorProps: ModelSelectorProps = {\r\n      models,\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      classFullName: \"BisCore:ModelSelector\",\r\n    };\r\n\r\n    const cameraData = new Camera();\r\n    const cameraOn = options?.cameraOn !== false;\r\n    const viewDefinitionProps: ViewDefinition3dProps = {\r\n      categorySelectorId: \"\",\r\n      displayStyleId: \"\",\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      origin: { x: originX, y: originY, z: originZ },\r\n      extents: { x: deltaX, y: deltaY, z: deltaZ },\r\n      classFullName: \"BisCore:SpatialViewDefinition\",\r\n      cameraOn,\r\n      camera: {\r\n        lens: cameraData.lens.toJSON(),\r\n        focusDist: cameraData.focusDist,\r\n        eye: cameraData.eye.toJSON(),\r\n      },\r\n    };\r\n\r\n    const displayStyleProps: DisplayStyle3dProps = {\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      classFullName: \"BisCore:DisplayStyle3d\",\r\n      jsonProperties: {\r\n        styles: {\r\n          viewflags: {\r\n            renderMode: RenderMode.SmoothShade,\r\n            noSourceLights: false,\r\n            noCameraLights: false,\r\n            noSolarLight: false,\r\n            noConstruct: true,\r\n            noTransp: false,\r\n            visEdges: false,\r\n            backgroundMap: this._imodel.isGeoLocated,\r\n          },\r\n          environment:\r\n            options !== undefined &&\r\n              options.skyboxOn !== undefined &&\r\n              options.skyboxOn\r\n              ? Environment.defaults.withDisplay({ sky: true }).toJSON()\r\n              : undefined,\r\n        },\r\n      },\r\n    };\r\n\r\n    const viewStateProps: ViewStateProps = {\r\n      displayStyleProps,\r\n      categorySelectorProps,\r\n      modelSelectorProps,\r\n      viewDefinitionProps,\r\n    };\r\n\r\n    // merge seed view props if needed\r\n    return options?.useSeedView ? this._mergeSeedView(viewStateProps) : viewStateProps;\r\n  }\r\n\r\n  /**\r\n   * Merges a seed view in the iModel with the passed view state props. It will be a no-op if there are no default 3D views in the iModel\r\n   * @param viewStateProps Input view props to be merged\r\n   */\r\n  private async _mergeSeedView(viewStateProps: ViewStateProps): Promise<ViewStateProps> {\r\n    const viewId = await this._getDefaultViewId();\r\n    // Handle iModels without any default view id\r\n    if (viewId === undefined)\r\n      return viewStateProps;\r\n\r\n    const seedViewState = (await this._imodel.views.load(viewId) as SpatialViewState);\r\n    const seedViewStateProps = {\r\n      categorySelectorProps: seedViewState.categorySelector.toJSON(),\r\n      modelSelectorProps: seedViewState.modelSelector.toJSON(),\r\n      viewDefinitionProps: seedViewState.toJSON(),\r\n      displayStyleProps: seedViewState.displayStyle.toJSON(),\r\n    };\r\n    const mergedDisplayProps = seedViewStateProps.displayStyleProps;\r\n    if (mergedDisplayProps.jsonProperties !== undefined) {\r\n      mergedDisplayProps.jsonProperties.styles = {\r\n        ...mergedDisplayProps.jsonProperties.styles,\r\n        ...viewStateProps.displayStyleProps.jsonProperties!.styles,\r\n      };\r\n    }\r\n\r\n    return { ...seedViewStateProps, ...viewStateProps, displayStyleProps: mergedDisplayProps };\r\n  }\r\n\r\n  /**\r\n   * Get the Id of the default view.\r\n   */\r\n  private async _getDefaultViewId(): Promise<Id64String | undefined> {\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    const viewId = await this._imodel.views.queryDefaultViewId();\r\n    if (viewId !== Id64.invalid)\r\n      return viewId;\r\n\r\n    // Return the first spatial view\r\n    const viewList = await this._imodel.views.getViewList({ wantPrivate: false, limit: 1, from: SpatialViewState.classFullName });\r\n    return viewList.length === 0 ? undefined : viewList[0].id;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ViewCreator3d.js","sourceRoot":"","sources":["../../src/ViewCreator3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { CompressedId64Set, Id64, Id64Array, Id64String } from \"@itwin/core-bentley\";\r\nimport {\r\n  Camera, CategorySelectorProps, Code, CustomViewState3dCreatorOptions, DisplayStyle3dProps, Environment, IModel, IModelReadRpcInterface,\r\n  ModelSelectorProps, RenderMode, ViewDefinition3dProps, ViewStateProps,\r\n} from \"@itwin/core-common\";\r\nimport { Range3d } from \"@itwin/core-geometry\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\nimport { SpatialViewState } from \"./SpatialViewState\";\r\nimport { StandardViewId } from \"./StandardView\";\r\nimport { ViewState } from \"./ViewState\";\r\n\r\n/** Api for creating a 3d default view for an iModel. Either takes in a list of modelIds, or displays all 3d models by default. */\r\n\r\n/** Options for creating a [[ViewState3d]] via [[ViewCreator3d]].\r\n *  @public\r\n * @extensions\r\n*/\r\nexport interface ViewCreator3dOptions {\r\n  /** Turn the [[Camera]] on to produce a perspective view.\r\n   * Default: true\r\n   */\r\n  cameraOn?: boolean;\r\n  /** Enables display of a [[SkyBox]] in the view. */\r\n  skyboxOn?: boolean;\r\n  /** Orients the view to one of the standard view rotations. */\r\n  standardViewId?: StandardViewId;\r\n  /** Merge in props from a persistent \"seed\" view obtained from the iModel.\r\n   * @note The selection of the seed view is somewhat arbitrary, and the contents and styling of that view are unpredictable, so this option is not recommended.\r\n   */\r\n  useSeedView?: boolean;\r\n  /** The desired aspect ratio of the [[Viewport]] in which the view is to be displayed.\r\n   * This is used to adjust the view's frustum so that the viewed models are better centered within the viewport.\r\n   */\r\n  vpAspect?: number;\r\n  /** Indicates that geometry belonging to every [SubCategory]($backend) should be visible within the view.\r\n   * Each subcategory has a [SubCategoryAppearance]($common) that specifies how its geometry is displayed. This includes a [SubCategoryAppearance.invisible]($common) property that,\r\n   * when set to `true`, indicates the geometry should not be displayed at all. A view can override the appearances of any subcategories using a [SubCategoryOverride]($common).\r\n   * If `allSubCategoriesVisible` is `true`, [[ViewCreator3d]] will apply such an override to every viewed subcategory to change [SubCategoryOverride.invisible]($common) to `false`, making\r\n   * every subcategory visible.\r\n   * @note Subcategories are typically set to invisible by default for a reason.\r\n   * Forcing them all to be visible may produce undesirable results, such as z-fighting between geometry on different subcategories that are not intended to be viewed together.\r\n   */\r\n  allSubCategoriesVisible?: boolean;\r\n}\r\n\r\n/**\r\n * API for creating a 3D default [[ViewState3d]] for an iModel. @see [[ViewCreator2d]] to create a view for a 2d model.\r\n * Example usage:\r\n * ```ts\r\n * const viewCreator = new ViewCreator3d(imodel);\r\n * const defaultView = await viewCreator.createDefaultView({skyboxOn: true});\r\n * ```\r\n * @public\r\n * @extensions\r\n */\r\nexport class ViewCreator3d {\r\n  /**\r\n   * Constructs a ViewCreator3d using an [[IModelConnection]].\r\n   * @param _imodel [[IModelConnection]] to query for categories and/or models.\r\n   */\r\n  constructor(private _imodel: IModelConnection) { }\r\n\r\n  /**\r\n   * Creates a default [[ViewState3d]] based on the model ids passed in. If no model ids are passed in, all 3D models in the iModel are used.\r\n   * @param [options] Options for creating the view.\r\n   * @param [modelIds] Ids of models to display in the view.\r\n   * @throws [IModelError]($common) If no 3d models are found in the iModel.\r\n   */\r\n  public async createDefaultView(options?: ViewCreator3dOptions, modelIds?: Id64String[]): Promise<ViewState> {\r\n    const rpcOptions: CustomViewState3dCreatorOptions = modelIds ? { modelIds: CompressedId64Set.sortAndCompress(modelIds) } : {};\r\n    const rpc = IModelReadRpcInterface.getClientForRouting(this._imodel.routingContext.token);\r\n    const serializedProps = await rpc.getCustomViewState3dData(this._imodel.getRpcProps(), rpcOptions);\r\n\r\n    const baseExtents = Range3d.fromJSON(serializedProps.modelExtents);\r\n    const props = await this._createViewStateProps(\r\n      CompressedId64Set.decompressArray(serializedProps.modelIds),\r\n      CompressedId64Set.decompressArray(serializedProps.categoryIds),\r\n      baseExtents,\r\n      options,\r\n    );\r\n\r\n    const viewState = SpatialViewState.createFromProps(props, this._imodel);\r\n    try {\r\n      await viewState.iModel.subcategories.loadAllUsedSpatialSubCategories();\r\n      await viewState.load();\r\n    } catch {\r\n    }\r\n\r\n    if (options?.standardViewId)\r\n      viewState.setStandardRotation(options.standardViewId);\r\n\r\n    if (options?.allSubCategoriesVisible)\r\n      viewState.displayStyle.enableAllLoadedSubCategories(viewState.categorySelector.categories);\r\n\r\n    const range = viewState.computeFitRange({ baseExtents });\r\n    viewState.lookAtVolume(range, options?.vpAspect);\r\n\r\n    return viewState;\r\n  }\r\n\r\n  /**\r\n   * Generates a view state props object for creating a view. Merges display styles with a seed view if the options.useSeedView is true\r\n   * @param models Models to put in view props\r\n   * @param options view creation options like camera On and skybox On\r\n   */\r\n  private async _createViewStateProps(models: Id64Array, categories: Id64Array, modelExtents: Range3d, options?: ViewCreator3dOptions): Promise<ViewStateProps> {\r\n    // Use dictionary model in all props\r\n    const dictionaryId = IModel.dictionaryId;\r\n\r\n    if (modelExtents.isNull)\r\n      modelExtents.setFrom(this._imodel.projectExtents);\r\n\r\n    let originX = modelExtents.low.x;\r\n    let originY = modelExtents.low.y;\r\n    const originZ = modelExtents.low.z;\r\n    let deltaX = modelExtents.xLength();\r\n    let deltaY = modelExtents.yLength();\r\n    const deltaZ = modelExtents.zLength();\r\n\r\n    // if vp aspect given, update model extents to fit view\r\n    if (options?.vpAspect) {\r\n      const modelAspect = deltaY / deltaX;\r\n\r\n      if (modelAspect > options.vpAspect) {\r\n        const xFix = deltaY / options.vpAspect;\r\n        originX = originX - xFix / 2;\r\n        deltaX = deltaX + xFix;\r\n      } else if (modelAspect < options.vpAspect) {\r\n        const yFix = deltaX * options.vpAspect;\r\n        originY = originY - yFix / 2;\r\n        deltaY = deltaY + yFix;\r\n      }\r\n    }\r\n\r\n    const categorySelectorProps: CategorySelectorProps = {\r\n      categories,\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      classFullName: \"BisCore:CategorySelector\",\r\n    };\r\n\r\n    const modelSelectorProps: ModelSelectorProps = {\r\n      models,\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      classFullName: \"BisCore:ModelSelector\",\r\n    };\r\n\r\n    const cameraData = new Camera();\r\n    const cameraOn = options?.cameraOn !== false;\r\n    const viewDefinitionProps: ViewDefinition3dProps = {\r\n      categorySelectorId: \"\",\r\n      displayStyleId: \"\",\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      origin: { x: originX, y: originY, z: originZ },\r\n      extents: { x: deltaX, y: deltaY, z: deltaZ },\r\n      classFullName: \"BisCore:SpatialViewDefinition\",\r\n      cameraOn,\r\n      camera: {\r\n        lens: cameraData.lens.toJSON(),\r\n        focusDist: cameraData.focusDist,\r\n        eye: cameraData.eye.toJSON(),\r\n      },\r\n    };\r\n\r\n    const displayStyleProps: DisplayStyle3dProps = {\r\n      code: Code.createEmpty(),\r\n      model: dictionaryId,\r\n      classFullName: \"BisCore:DisplayStyle3d\",\r\n      jsonProperties: {\r\n        styles: {\r\n          viewflags: {\r\n            renderMode: RenderMode.SmoothShade,\r\n            noSourceLights: false,\r\n            noCameraLights: false,\r\n            noSolarLight: false,\r\n            noConstruct: true,\r\n            noTransp: false,\r\n            visEdges: false,\r\n            backgroundMap: this._imodel.isGeoLocated,\r\n          },\r\n          environment:\r\n            options !== undefined &&\r\n              options.skyboxOn !== undefined &&\r\n              options.skyboxOn\r\n              ? Environment.defaults.withDisplay({ sky: true }).toJSON()\r\n              : undefined,\r\n        },\r\n      },\r\n    };\r\n\r\n    const viewStateProps: ViewStateProps = {\r\n      displayStyleProps,\r\n      categorySelectorProps,\r\n      modelSelectorProps,\r\n      viewDefinitionProps,\r\n    };\r\n\r\n    // merge seed view props if needed\r\n    return options?.useSeedView ? this._mergeSeedView(viewStateProps) : viewStateProps;\r\n  }\r\n\r\n  /**\r\n   * Merges a seed view in the iModel with the passed view state props. It will be a no-op if there are no default 3D views in the iModel\r\n   * @param viewStateProps Input view props to be merged\r\n   */\r\n  private async _mergeSeedView(viewStateProps: ViewStateProps): Promise<ViewStateProps> {\r\n    const viewId = await this._getDefaultViewId();\r\n    // Handle iModels without any default view id\r\n    if (viewId === undefined)\r\n      return viewStateProps;\r\n\r\n    const seedViewState = (await this._imodel.views.load(viewId) as SpatialViewState);\r\n    const seedViewStateProps = {\r\n      categorySelectorProps: seedViewState.categorySelector.toJSON(),\r\n      modelSelectorProps: seedViewState.modelSelector.toJSON(),\r\n      viewDefinitionProps: seedViewState.toJSON(),\r\n      displayStyleProps: seedViewState.displayStyle.toJSON(),\r\n    };\r\n    const mergedDisplayProps = seedViewStateProps.displayStyleProps;\r\n    if (mergedDisplayProps.jsonProperties !== undefined) {\r\n      mergedDisplayProps.jsonProperties.styles = {\r\n        ...mergedDisplayProps.jsonProperties.styles,\r\n        ...viewStateProps.displayStyleProps.jsonProperties!.styles,\r\n      };\r\n    }\r\n\r\n    return { ...seedViewStateProps, ...viewStateProps, displayStyleProps: mergedDisplayProps };\r\n  }\r\n\r\n  /**\r\n   * Get the Id of the default view.\r\n   */\r\n  private async _getDefaultViewId(): Promise<Id64String | undefined> {\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    const viewId = await this._imodel.views.queryDefaultViewId();\r\n    if (viewId !== Id64.invalid)\r\n      return viewId;\r\n\r\n    // Return the first spatial view\r\n    const viewList = await this._imodel.views.getViewList({ wantPrivate: false, limit: 1, from: SpatialViewState.classFullName });\r\n    return viewList.length === 0 ? undefined : viewList[0].id;\r\n  }\r\n}\r\n"]}

package/lib/cjs/ViewManager.d.ts

@@ -163,10 +163,8 @@ export declare class ViewManager implements Iterable<ScreenViewport> {
     dropViewport(vp: ScreenViewport, disposeOfViewport?: boolean): BentleyStatus;
     /** Iterate over the viewports registered with the view manager. */
     [Symbol.iterator](): Iterator<ScreenViewport>;
-    /** Force each registered [[Viewport]] to regenerate all of its cached [[Decorations]] on the next frame. If the decorator parameter is specified, only
-     * the specified decorator will have its cached decorations invalidated for all viewports.
-     * @see [[Viewport.invalidateCachedDecorations]] to manually remove a decorator's cached decorations from a viewport, forcing them to be regenerated.
-     * @beta
+    /** Instruct each registered [[Viewport]] that the cached [[Decorations]] for the specified `decorator` should be discarded and recreated on the next frame.
+     * @see [[Viewport.invalidateCachedDecorations]] to invalidate the cached decorations for a single viewport.
      */
     invalidateCachedDecorationsAllViews(decorator: ViewportDecorator): void;
     /** Force each registered [[Viewport]] to regenerate its [[Decorations]] on the next frame. */
@@ -196,9 +194,8 @@ export declare class ViewManager implements Iterable<ScreenViewport> {
      * @internal
      */
     purgeTileTrees(olderThan: BeTimePoint): void;
-    /** Get the tooltip for a persistent element.
-     * Calls the backend method [Element.getToolTipMessage]($backend), and replaces all instances of `${localizeTag}` with localized string from IModelApp.i18n.
-     * @beta
+    /** Compute the tooltip for a persistent element.
+     * This method calls the backend method [Element.getToolTipMessage]($backend), and replaces all instances of `${localizeTag}` with localized string from IModelApp.i18n.
      */
     getElementToolTip(hit: HitDetail): Promise<HTMLElement | string>;
     /** Register a new [[ToolTipProvider]] to customize the locate tooltip.

package/lib/cjs/ViewManager.d.ts.map

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