@itwin/core-frontend 3.3.0-dev.8 → 3.3.0-dev.80

package/lib/esm/RealityDataSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"RealityDataSource.js","sourceRoot":"","sources":["../../src/RealityDataSource.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 Tiles\r\n */\r\nimport { BentleyError, GuidString, Logger, LoggingMetaData, RealityDataStatus } from \"@itwin/core-bentley\";\r\nimport { Cartographic, EcefLocation, OrbitGtBlobProps, RealityData, RealityDataFormat, RealityDataProvider, RealityDataSourceKey } from \"@itwin/core-common\";\r\nimport { FrontendLoggerCategory } from \"./FrontendLoggerCategory\";\r\nimport { CesiumIonAssetProvider, ContextShareProvider, getCesiumAssetUrl } from \"./tile/internal\";\r\nimport { RealityDataSourceTilesetUrlImpl } from \"./RealityDataSourceTilesetUrlImpl\";\r\nimport { RealityDataSourceContextShareImpl } from \"./RealityDataSourceContextShareImpl\";\r\nimport { RealityDataSourceCesiumIonAssetImpl } from \"./RealityDataSourceCesiumIonAssetImpl\";\r\nimport { Range3d } from \"@itwin/core-geometry\";\r\n\r\nconst loggerCategory: string = FrontendLoggerCategory.RealityData;\r\n\r\n/**\r\n * Reality Data Operation error\r\n * @alpha\r\n */\r\nexport class RealityDataError extends BentleyError {\r\n  public constructor(errorNumber: RealityDataStatus, message: string, getMetaData?: LoggingMetaData) {\r\n    super(errorNumber, message, getMetaData);\r\n  }\r\n}\r\n\r\n/** This interface provide spatial location and volume of interest, in meters, centered around `spatial location`\r\n * @alpha\r\n */\r\nexport interface SpatialLocationAndExtents {\r\n  /** location of the point at the center of the reaity data */\r\n  location: Cartographic | EcefLocation;\r\n  /** extents of the volume around location */\r\n  worldRange: Range3d;\r\n  /** true if this reality data is geolocated\r\n   * A reality data is geolocated when we can compute a valid position relative to the earth surface.\r\n   * Note that some reality data contains custom coordinate system without any information on the relative position on earth.\r\n   * These reality data will have a location and worldRange but will be identified by the isGeoLocated set to false.\r\n   */\r\n  isGeolocated: boolean;\r\n}\r\n\r\n/** This interface provides information to identify the product and engine that create this reality data\r\n * @alpha\r\n */\r\nexport interface PublisherProductInfo {\r\n  /** product that create this reality data */\r\n  product: string;\r\n  /** engine that create this reality data */\r\n  engine: string;\r\n  /** the version of the engine that create this reality data */\r\n  version: string;\r\n}\r\n\r\n/** This interface provide methods used to access a reality data from a reality data provider\r\n * @beta\r\n */\r\nexport interface RealityDataSource {\r\n  readonly key: RealityDataSourceKey;\r\n  readonly isContextShare: boolean;\r\n  readonly realityDataId: string | undefined;\r\n  /** Metatdata on the reality data source */\r\n  readonly realityData: RealityData | undefined;\r\n  /** The reality data type (e.g.: \"RealityMesh3DTiles\", OPC, Terrain3DTiles, Cesium3DTiles, ... )*/\r\n  readonly realityDataType: string | undefined;\r\n  /** This method returns the URL to obtain the Reality Data properties.\r\n   * @param iTwinId id of associated iTwin project\r\n   * @returns string containing the URL to reality data.\r\n   */\r\n  getServiceUrl(iTwinId: GuidString | undefined): Promise<string | undefined>;\r\n\r\n  /** Gets a reality data root document json\r\n   * @returns tile data json\r\n   * @internal\r\n   */\r\n  getRootDocument(iTwinId: GuidString | undefined): Promise<any>;\r\n  /** Gets tile content\r\n   * @param name name or path of tile\r\n   * @returns array buffer of tile content\r\n   * @internal\r\n   */\r\n  getTileContent(name: string): Promise<any>;\r\n  /** Gets a tileset's app data json\r\n   * @param name name or path of tile\r\n   * @returns app data json object\r\n   * @internal\r\n   */\r\n  getTileJson(name: string): Promise<any>;\r\n  /** Gets spatial location and extents of this reality data source.\r\n   * Will return undefined if cannot be resolved or is unbounded (cover entire earth eg: Open Street Map Building from Ion Asset)\r\n   * @returns spatial location and extents\r\n   * @throws [[RealityDataError]] if source is invalid or cannot be read\r\n   * @alpha\r\n   */\r\n  getSpatialLocationAndExtents(): Promise<SpatialLocationAndExtents | undefined>;\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  getPublisherProductInfo(): Promise<PublisherProductInfo | undefined>;\r\n}\r\n/** Utility functions for RealityDataSource\r\n * @beta\r\n */\r\nexport namespace RealityDataSource {\r\n  /** Create a RealityDataSourceKey from a tilesetUrl.\r\n   * @param tilesetUrl the reality data attachment url\r\n   * @param inputProvider identify the RealityDataProvider if known, otherwise function will try to extract it from the tilesetUrl\r\n   * @param inputFormat identify the RealityDataFormat if known, otherwise function will try to extract it from the tilesetUrl\r\n   * @returns the RealityDataSourceKey that uniquely identify a reality data for a provider\r\n   */\r\n  export function createKeyFromUrl(tilesetUrl: string, inputProvider?: RealityDataProvider, inputFormat?: RealityDataFormat): RealityDataSourceKey {\r\n    let format = inputFormat ? inputFormat : RealityDataFormat.fromUrl(tilesetUrl);\r\n    if (CesiumIonAssetProvider.isProviderUrl(tilesetUrl)) {\r\n      const provider = RealityDataProvider.CesiumIonAsset;\r\n      // Keep url hidden and use a dummy id\r\n      const cesiumIonAssetKey: RealityDataSourceKey = { provider, format, id: CesiumIonAssetProvider.osmBuildingId };\r\n      return cesiumIonAssetKey;\r\n    }\r\n\r\n    // Try to extract realityDataId from URL and if not possible, use the url as the key\r\n    if (ContextShareProvider.isProviderUrl(tilesetUrl)) {\r\n      const info = ContextShareProvider.getInfoFromUrl(tilesetUrl);\r\n      const provider = inputProvider ? inputProvider : info.provider;\r\n      format = inputFormat ? inputFormat : info.format;\r\n      const contextShareKey: RealityDataSourceKey = { provider, format, id: info.id, iTwinId: info.iTwinId };\r\n      return contextShareKey;\r\n    }\r\n\r\n    // default to tileSetUrl\r\n    const provider2 = inputProvider ? inputProvider : RealityDataProvider.TilesetUrl;\r\n    const urlKey: RealityDataSourceKey = { provider: provider2, format, id: tilesetUrl };\r\n    return urlKey;\r\n  }\r\n  /** @alpha - was used for a very specific case of point cloud (opc) attachment that should not be made public */\r\n  export function createKeyFromBlobUrl(blobUrl: string, inputProvider?: RealityDataProvider, inputFormat?: RealityDataFormat): RealityDataSourceKey {\r\n    const info = ContextShareProvider.getInfoFromBlobUrl(blobUrl);\r\n    const format = inputFormat ? inputFormat : info.format;\r\n    const provider = inputProvider ? inputProvider : info.provider;\r\n    const contextShareKey: RealityDataSourceKey = { provider, format, id: info.id };\r\n    return contextShareKey;\r\n  }\r\n  /** @alpha - OrbitGtBlobProps is alpha */\r\n  export function createKeyFromOrbitGtBlobProps(orbitGtBlob: OrbitGtBlobProps, inputProvider?: RealityDataProvider, inputFormat?: RealityDataFormat): RealityDataSourceKey {\r\n    const format = inputFormat ? inputFormat : RealityDataFormat.OPC;\r\n    if (orbitGtBlob.blobFileName && orbitGtBlob.blobFileName.toLowerCase().startsWith(\"http\")) {\r\n      return RealityDataSource.createKeyFromBlobUrl(orbitGtBlob.blobFileName, inputProvider, format);\r\n    } else if (orbitGtBlob.rdsUrl) {\r\n      return RealityDataSource.createKeyFromUrl(orbitGtBlob.rdsUrl, inputProvider, format);\r\n    }\r\n    const provider = inputProvider ? inputProvider : RealityDataProvider.OrbitGtBlob;\r\n    const id = `${orbitGtBlob.accountName}:${orbitGtBlob.containerName}:${orbitGtBlob.blobFileName}:?${orbitGtBlob.sasToken}`;\r\n    return { provider, format, id };\r\n  }\r\n  /** @alpha - OrbitGtBlobProps is alpha */\r\n  export function createOrbitGtBlobPropsFromKey(rdSourceKey: RealityDataSourceKey): OrbitGtBlobProps | undefined {\r\n    if (rdSourceKey.provider !== RealityDataProvider.OrbitGtBlob)\r\n      return undefined;\r\n    const splitIds = rdSourceKey.id.split(\":\");\r\n    const sasTokenIndex = rdSourceKey.id.indexOf(\":?\");\r\n    const sasToken = rdSourceKey.id.substr(sasTokenIndex + 2);\r\n    const orbitGtBlob: OrbitGtBlobProps = {\r\n      accountName: splitIds[0],\r\n      containerName: splitIds[1],\r\n      blobFileName: splitIds[2],\r\n      sasToken,\r\n    };\r\n    return orbitGtBlob;\r\n  }\r\n  /** @internal - Is used by \"fdt attach cesium asset\" keyin*/\r\n  export function createCesiumIonAssetKey(osmAssetId: number, requestKey: string): RealityDataSourceKey {\r\n    const id = getCesiumAssetUrl(osmAssetId,requestKey);\r\n    return {provider: RealityDataProvider.CesiumIonAsset, format: RealityDataFormat.ThreeDTile, id};\r\n  }\r\n  /** Return an instance of a RealityDataSource from a source key.\r\n   * There will aways be only one reality data RealityDataSource for a corresponding reality data source key.\r\n   * @alpha\r\n   */\r\n  export async function fromKey(rdSourceKey: RealityDataSourceKey, iTwinId: GuidString | undefined): Promise<RealityDataSource | undefined> {\r\n    switch(rdSourceKey.provider) {\r\n      case RealityDataProvider.CesiumIonAsset:\r\n        return RealityDataSourceCesiumIonAssetImpl.createFromKey(rdSourceKey, iTwinId);\r\n      case RealityDataProvider.TilesetUrl:\r\n        return RealityDataSourceTilesetUrlImpl.createFromKey(rdSourceKey, iTwinId);\r\n      case RealityDataProvider.ContextShare:\r\n        return RealityDataSourceContextShareImpl.createFromKey(rdSourceKey, iTwinId);\r\n      case RealityDataProvider.OrbitGtBlob:\r\n        return RealityDataSourceTilesetUrlImpl.createFromKey(rdSourceKey, iTwinId);\r\n      default:\r\n        Logger.logError(loggerCategory, `Error realityModelFromJson - region undefined`);\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n\r\n"]}
+{"version":3,"file":"RealityDataSource.js","sourceRoot":"","sources":["../../src/RealityDataSource.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 Tiles\r\n */\r\nimport { BentleyError, GuidString, Logger, LoggingMetaData, RealityDataStatus } from \"@itwin/core-bentley\";\r\nimport { Cartographic, EcefLocation, OrbitGtBlobProps, RealityData, RealityDataFormat, RealityDataProvider, RealityDataSourceKey } from \"@itwin/core-common\";\r\nimport { FrontendLoggerCategory } from \"./FrontendLoggerCategory\";\r\nimport { CesiumIonAssetProvider, ContextShareProvider, getCesiumAssetUrl } from \"./tile/internal\";\r\nimport { RealityDataSourceTilesetUrlImpl } from \"./RealityDataSourceTilesetUrlImpl\";\r\nimport { RealityDataSourceContextShareImpl } from \"./RealityDataSourceContextShareImpl\";\r\nimport { RealityDataSourceCesiumIonAssetImpl } from \"./RealityDataSourceCesiumIonAssetImpl\";\r\nimport { Range3d } from \"@itwin/core-geometry\";\r\n\r\nconst loggerCategory: string = FrontendLoggerCategory.RealityData;\r\n\r\n/**\r\n * Reality Data Operation error\r\n * @alpha\r\n */\r\nexport class RealityDataError extends BentleyError {\r\n  public constructor(errorNumber: RealityDataStatus, message: string, getMetaData?: LoggingMetaData) {\r\n    super(errorNumber, message, getMetaData);\r\n  }\r\n}\r\n\r\n/** This interface provide spatial location and volume of interest, in meters, centered around `spatial location`\r\n * @alpha\r\n */\r\nexport interface SpatialLocationAndExtents {\r\n  /** location of the point at the center of the reaity data */\r\n  location: Cartographic | EcefLocation;\r\n  /** extents of the volume around location */\r\n  worldRange: Range3d;\r\n  /** true if this reality data is geolocated\r\n   * A reality data is geolocated when we can compute a valid position relative to the earth surface.\r\n   * Note that some reality data contains custom coordinate system without any information on the relative position on earth.\r\n   * These reality data will have a location and worldRange but will be identified by the isGeoLocated set to false.\r\n   */\r\n  isGeolocated: boolean;\r\n}\r\n\r\n/** This interface provides information to identify the product and engine that create this reality data\r\n * @alpha\r\n */\r\nexport interface PublisherProductInfo {\r\n  /** product that create this reality data */\r\n  product: string;\r\n  /** engine that create this reality data */\r\n  engine: string;\r\n  /** the version of the engine that create this reality data */\r\n  version: string;\r\n}\r\n\r\n/** This interface provide methods used to access a reality data from a reality data provider\r\n * @beta\r\n */\r\nexport interface RealityDataSource {\r\n  readonly key: RealityDataSourceKey;\r\n  readonly isContextShare: boolean;\r\n  readonly realityDataId: string | undefined;\r\n  /** Metatdata on the reality data source */\r\n  readonly realityData: RealityData | undefined;\r\n  /** The reality data type (e.g.: \"RealityMesh3DTiles\", OPC, Terrain3DTiles, Cesium3DTiles, ... )*/\r\n  readonly realityDataType: string | undefined;\r\n  /** This method returns the URL to obtain the Reality Data properties.\r\n   * @param iTwinId id of associated iTwin project\r\n   * @returns string containing the URL to reality data.\r\n   */\r\n  getServiceUrl(iTwinId: GuidString | undefined): Promise<string | undefined>;\r\n\r\n  /** Gets a reality data root document json\r\n   * @returns tile data json\r\n   * @internal\r\n   */\r\n  getRootDocument(iTwinId: GuidString | undefined): Promise<any>;\r\n  /** Gets tile content\r\n   * @param name name or path of tile\r\n   * @returns array buffer of tile content\r\n   * @internal\r\n   */\r\n  getTileContent(name: string): Promise<any>;\r\n  /** Gets a tileset's app data json\r\n   * @param name name or path of tile\r\n   * @returns app data json object\r\n   * @internal\r\n   */\r\n  getTileJson(name: string): Promise<any>;\r\n  /** Gets spatial location and extents of this reality data source.\r\n   * Will return undefined if cannot be resolved or is unbounded (cover entire earth eg: Open Street Map Building from Ion Asset)\r\n   * @returns spatial location and extents\r\n   * @throws [[RealityDataError]] if source is invalid or cannot be read\r\n   * @alpha\r\n   */\r\n  getSpatialLocationAndExtents(): Promise<SpatialLocationAndExtents | undefined>;\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  getPublisherProductInfo(): Promise<PublisherProductInfo | undefined>;\r\n}\r\n/** Utility functions for RealityDataSource\r\n * @beta\r\n */\r\nexport namespace RealityDataSource {\r\n  /** Create a RealityDataSourceKey from a tilesetUrl.\r\n   * @param tilesetUrl the reality data attachment url\r\n   * @param inputProvider identify the RealityDataProvider if known, otherwise function will try to extract it from the tilesetUrl\r\n   * @param inputFormat identify the RealityDataFormat if known, otherwise function will try to extract it from the tilesetUrl\r\n   * @returns the RealityDataSourceKey that uniquely identify a reality data for a provider\r\n   */\r\n  export function createKeyFromUrl(tilesetUrl: string, inputProvider?: RealityDataProvider, inputFormat?: RealityDataFormat): RealityDataSourceKey {\r\n    let format = inputFormat ? inputFormat : RealityDataFormat.fromUrl(tilesetUrl);\r\n    if (CesiumIonAssetProvider.isProviderUrl(tilesetUrl)) {\r\n      const provider = RealityDataProvider.CesiumIonAsset;\r\n      let cesiumIonAssetKey: RealityDataSourceKey = { provider, format, id:  CesiumIonAssetProvider.osmBuildingId }; // default OSM building\r\n      // Parse URL to extract possible asset id and key if provided\r\n      const cesiumAsset = CesiumIonAssetProvider.parseCesiumUrl(tilesetUrl);\r\n      if (cesiumAsset) {\r\n        cesiumIonAssetKey = RealityDataSource.createCesiumIonAssetKey(cesiumAsset.id, cesiumAsset.key);\r\n      }\r\n      return cesiumIonAssetKey;\r\n    }\r\n\r\n    // Try to extract realityDataId from URL and if not possible, use the url as the key\r\n    if (ContextShareProvider.isProviderUrl(tilesetUrl)) {\r\n      const info = ContextShareProvider.getInfoFromUrl(tilesetUrl);\r\n      const provider = inputProvider ? inputProvider : info.provider;\r\n      format = inputFormat ? inputFormat : info.format;\r\n      const contextShareKey: RealityDataSourceKey = { provider, format, id: info.id, iTwinId: info.iTwinId };\r\n      return contextShareKey;\r\n    }\r\n\r\n    // default to tileSetUrl\r\n    const provider2 = inputProvider ? inputProvider : RealityDataProvider.TilesetUrl;\r\n    const urlKey: RealityDataSourceKey = { provider: provider2, format, id: tilesetUrl };\r\n    return urlKey;\r\n  }\r\n  /** @alpha - was used for a very specific case of point cloud (opc) attachment that should not be made public */\r\n  export function createKeyFromBlobUrl(blobUrl: string, inputProvider?: RealityDataProvider, inputFormat?: RealityDataFormat): RealityDataSourceKey {\r\n    const info = ContextShareProvider.getInfoFromBlobUrl(blobUrl);\r\n    const format = inputFormat ? inputFormat : info.format;\r\n    const provider = inputProvider ? inputProvider : info.provider;\r\n    const contextShareKey: RealityDataSourceKey = { provider, format, id: info.id };\r\n    return contextShareKey;\r\n  }\r\n  /** @alpha - OrbitGtBlobProps is alpha */\r\n  export function createKeyFromOrbitGtBlobProps(orbitGtBlob: OrbitGtBlobProps, inputProvider?: RealityDataProvider, inputFormat?: RealityDataFormat): RealityDataSourceKey {\r\n    const format = inputFormat ? inputFormat : RealityDataFormat.OPC;\r\n    if (orbitGtBlob.blobFileName && orbitGtBlob.blobFileName.toLowerCase().startsWith(\"http\")) {\r\n      return RealityDataSource.createKeyFromBlobUrl(orbitGtBlob.blobFileName, inputProvider, format);\r\n    } else if (orbitGtBlob.rdsUrl) {\r\n      return RealityDataSource.createKeyFromUrl(orbitGtBlob.rdsUrl, inputProvider, format);\r\n    }\r\n    const provider = inputProvider ? inputProvider : RealityDataProvider.OrbitGtBlob;\r\n    const id = `${orbitGtBlob.accountName}:${orbitGtBlob.containerName}:${orbitGtBlob.blobFileName}:?${orbitGtBlob.sasToken}`;\r\n    return { provider, format, id };\r\n  }\r\n  /** @alpha - OrbitGtBlobProps is alpha */\r\n  export function createOrbitGtBlobPropsFromKey(rdSourceKey: RealityDataSourceKey): OrbitGtBlobProps | undefined {\r\n    if (rdSourceKey.provider !== RealityDataProvider.OrbitGtBlob)\r\n      return undefined;\r\n    const splitIds = rdSourceKey.id.split(\":\");\r\n    const sasTokenIndex = rdSourceKey.id.indexOf(\":?\");\r\n    const sasToken = rdSourceKey.id.substr(sasTokenIndex + 2);\r\n    const orbitGtBlob: OrbitGtBlobProps = {\r\n      accountName: splitIds[0],\r\n      containerName: splitIds[1],\r\n      blobFileName: splitIds[2],\r\n      sasToken,\r\n    };\r\n    return orbitGtBlob;\r\n  }\r\n  /** @internal - Is used by \"fdt attach cesium asset\" keyin*/\r\n  export function createCesiumIonAssetKey(osmAssetId: number, requestKey: string): RealityDataSourceKey {\r\n    const id = getCesiumAssetUrl(osmAssetId,requestKey);\r\n    return {provider: RealityDataProvider.CesiumIonAsset, format: RealityDataFormat.ThreeDTile, id};\r\n  }\r\n  /** Return an instance of a RealityDataSource from a source key.\r\n   * There will aways be only one reality data RealityDataSource for a corresponding reality data source key.\r\n   * @alpha\r\n   */\r\n  export async function fromKey(rdSourceKey: RealityDataSourceKey, iTwinId: GuidString | undefined): Promise<RealityDataSource | undefined> {\r\n    switch(rdSourceKey.provider) {\r\n      case RealityDataProvider.CesiumIonAsset:\r\n        return RealityDataSourceCesiumIonAssetImpl.createFromKey(rdSourceKey, iTwinId);\r\n      case RealityDataProvider.TilesetUrl:\r\n        return RealityDataSourceTilesetUrlImpl.createFromKey(rdSourceKey, iTwinId);\r\n      case RealityDataProvider.ContextShare:\r\n        return RealityDataSourceContextShareImpl.createFromKey(rdSourceKey, iTwinId);\r\n      case RealityDataProvider.OrbitGtBlob:\r\n        return RealityDataSourceTilesetUrlImpl.createFromKey(rdSourceKey, iTwinId);\r\n      default:\r\n        Logger.logError(loggerCategory, `Error realityModelFromJson - region undefined`);\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n\r\n"]}

package/lib/esm/SelectionSet.d.ts

@@ -68,13 +68,27 @@ export interface SelectReplaceEvent {
  * @extensions
  */
 export declare type SelectionSetEvent = SelectAddEvent | SelectRemoveEvent | SelectReplaceEvent;
+/** Describes how the sets of hilited models and subcategories in a [[HiliteSet]] interact.
+ *  - "union" indicates a [Feature]($common) will be hilited if either its model **or** its subcategory is present in the HiliteSet.
+ *  - "intersection" indicates a [Feature]($common) will be hilited only if both its model **and** its subcategory are present in the HiliteSet.
+ *
+ * @see [[HiliteSet.modelSubCategoryMode]] to change the mode for a HiliteSet.
+ * @public
+ */
+export declare type ModelSubCategoryHiliteMode = "union" | "intersection";
 /** A set of *hilited* elements for an [[IModelConnection]], by element id.
  * Hilited elements are displayed with a customizable hilite effect within a [[Viewport]].
- * The set exposes 3 types of elements in 3 separate collections: geometric elements, subcategories, and geometric models.
+ * The set exposes 3 types of elements in 3 separate collections: [GeometricElement]($backend), [GeometricModel]($backend), and [SubCategory]($backend).
+ * The [[models]] and [[subcategories]] can be hilited independently or as an intersection of the two sets, as specified by [[modelSubCategoryMode]].
+ *
+ * Technically, the hilite effect is applied to [Feature]($common)s, not [Element]($backend)s. An element's geometry stream can contain multiple
+ * features belonging to different subcategories.
+ *
+ * Because Javascript lacks efficient support for 64-bit integers, the Ids are stored as pairs of 32-bit integers via [Id64.Uint32Set]($bentley).
+ *
  * @note Typically, elements are hilited by virtue of their presence in the IModelConnection's [[SelectionSet]]. The HiliteSet allows additional
  * elements to be displayed with the hilite effect without adding them to the [[SelectionSet]]. If you add elements to the HiliteSet directly, you
  * are also responsible for removing them as appropriate.
- * @note Support for subcategories and geometric models in the HiliteSet is currently `beta`.
  * @see [[IModelConnection.hilited]] for the HiliteSet associated with an iModel.
  * @see [Hilite.Settings]($common) for customization of the hilite effect.
  * @public
@@ -83,16 +97,28 @@ export declare type SelectionSetEvent = SelectAddEvent | SelectRemoveEvent | Sel
 export declare class HiliteSet {
     iModel: IModelConnection;
     private readonly _elements;
+    private _mode;
     /** The set of hilited subcategories.
-     * @beta
+     * @see [[modelSubCategoryMode]] to control how this set interacts with the set of hilited [[models]].
+     * @see [[IModelConnection.Categories]] to obtain the set of subcategories associated with one or more [Category]($backend)'s.
      */
     readonly subcategories: Id64.Uint32Set;
     /** The set of hilited [[GeometricModelState]]s.
-     * @beta
+     * @see [[modelSubCategoryMode]] to control how this set interacts with the set of hilited [[subcategories]].
      */
     readonly models: Id64.Uint32Set;
     /** The set of hilited elements. */
     get elements(): Id64.Uint32Set;
+    /** Controls how the sets of hilited [[models]] and [[subcategories]] interact with one another.
+     * By default they are treated as a union: a [Feature]($common) is hilited if either its model **or** its subcategory is hilited.
+     * This can be changed to an intersection such that a [Feature]($common) is hilited only if both its model **and** subcategory are hilited.
+     * @note The sets of hilited models and subcategories are independent of the set of hilited [[elements]] - an element whose Id is present in
+     * [[elements]] is always hilited regardless of its model or subcategories.
+     */
+    get modelSubCategoryMode(): ModelSubCategoryHiliteMode;
+    set modelSubCategoryMode(mode: ModelSubCategoryHiliteMode);
+    /** Event raised just before changing the value of [[modelSubCategoryMode]]. */
+    readonly onModelSubCategoryModeChanged: BeEvent<(newMode: ModelSubCategoryHiliteMode) => void>;
     /** Construct a HiliteSet
      * @param iModel The iModel containing the entities to be hilited.
      * @param syncWithSelectionSet If true, the contents of the `elements` set will be synchronized with those in the `iModel`'s [[SelectionSet]].

package/lib/esm/SelectionSet.d.ts.map

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

package/lib/esm/SelectionSet.js

@@ -96,11 +96,17 @@ class HilitedElementIds extends HilitedIds {
 }
 /** A set of *hilited* elements for an [[IModelConnection]], by element id.
  * Hilited elements are displayed with a customizable hilite effect within a [[Viewport]].
- * The set exposes 3 types of elements in 3 separate collections: geometric elements, subcategories, and geometric models.
+ * The set exposes 3 types of elements in 3 separate collections: [GeometricElement]($backend), [GeometricModel]($backend), and [SubCategory]($backend).
+ * The [[models]] and [[subcategories]] can be hilited independently or as an intersection of the two sets, as specified by [[modelSubCategoryMode]].
+ *
+ * Technically, the hilite effect is applied to [Feature]($common)s, not [Element]($backend)s. An element's geometry stream can contain multiple
+ * features belonging to different subcategories.
+ *
+ * Because Javascript lacks efficient support for 64-bit integers, the Ids are stored as pairs of 32-bit integers via [Id64.Uint32Set]($bentley).
+ *
  * @note Typically, elements are hilited by virtue of their presence in the IModelConnection's [[SelectionSet]]. The HiliteSet allows additional
  * elements to be displayed with the hilite effect without adding them to the [[SelectionSet]]. If you add elements to the HiliteSet directly, you
  * are also responsible for removing them as appropriate.
- * @note Support for subcategories and geometric models in the HiliteSet is currently `beta`.
  * @see [[IModelConnection.hilited]] for the HiliteSet associated with an iModel.
  * @see [Hilite.Settings]($common) for customization of the hilite effect.
  * @public
@@ -114,12 +120,30 @@ export class HiliteSet {
      */
     constructor(iModel, syncWithSelectionSet = true) {
         this.iModel = iModel;
+        this._mode = "union";
+        /** Event raised just before changing the value of [[modelSubCategoryMode]]. */
+        this.onModelSubCategoryModeChanged = new BeEvent();
         this._elements = new HilitedElementIds(iModel, syncWithSelectionSet);
         this.subcategories = new HilitedIds(iModel);
         this.models = new HilitedIds(iModel);
     }
     /** The set of hilited elements. */
     get elements() { return this._elements; }
+    /** Controls how the sets of hilited [[models]] and [[subcategories]] interact with one another.
+     * By default they are treated as a union: a [Feature]($common) is hilited if either its model **or** its subcategory is hilited.
+     * This can be changed to an intersection such that a [Feature]($common) is hilited only if both its model **and** subcategory are hilited.
+     * @note The sets of hilited models and subcategories are independent of the set of hilited [[elements]] - an element whose Id is present in
+     * [[elements]] is always hilited regardless of its model or subcategories.
+     */
+    get modelSubCategoryMode() {
+        return this._mode;
+    }
+    set modelSubCategoryMode(mode) {
+        if (mode === this._mode)
+            return;
+        this.onModelSubCategoryModeChanged.raiseEvent(mode);
+        this._mode = mode;
+    }
     /** Control whether the hilited elements will be synchronized with the contents of the [[SelectionSet]].
      * By default they are synchronized. Applications that override this take responsibility for managing the set of hilited entities.
      * When turning synchronization off, the contents of the HiliteSet will remain unchanged.

package/lib/esm/SelectionSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionSet.js","sourceRoot":"","sources":["../../src/SelectionSet.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 SelectionSet\r\n */\r\nimport { BeEvent, Id64, Id64Arg, Id64String } from \"@itwin/core-bentley\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\n\r\n/** Identifies the type of changes made to the [[SelectionSet]] to produce a [[SelectionSetEvent]].\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SelectionSetEventType {\r\n  /** Elements have been added to the set. */\r\n  Add,\r\n  /** Elements have been removed from the set. */\r\n  Remove,\r\n  /** Some elements have been added to the set and others have been removed. */\r\n  Replace,\r\n  /** All elements are about to be removed from the set. */\r\n  Clear,\r\n}\r\n\r\n/** Passed to [[SelectionSet.onChanged]] event listeners when elements are added to the selection set.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SelectAddEvent {\r\n  type: SelectionSetEventType.Add;\r\n  /** The Ids of the elements added to the set. */\r\n  added: Id64Arg;\r\n  /** The affected SelectionSet. */\r\n  set: SelectionSet;\r\n}\r\n\r\n/** Passed to [[SelectionSet.onChanged]] event listeners when elements are removed from the selection set.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SelectRemoveEvent {\r\n  /** The type of operation that produced this event. */\r\n  type: SelectionSetEventType.Remove | SelectionSetEventType.Clear;\r\n  /** The element Ids removed from the set. */\r\n  removed: Id64Arg;\r\n  /** The affected SelectionSet. */\r\n  set: SelectionSet;\r\n}\r\n\r\n/** Passed to [[SelectionSet.onChanged]] event listeners when elements are simultaneously added to and removed from the selection set.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SelectReplaceEvent {\r\n  type: SelectionSetEventType.Replace;\r\n  /** The element Ids added to the set. */\r\n  added: Id64Arg;\r\n  /** The element Ids removed from the set. */\r\n  removed: Id64Arg;\r\n  /** The affected SelectionSet. */\r\n  set: SelectionSet;\r\n}\r\n\r\n/** Payload sent to [[SelectionSet.onChanged]] event listeners to describe how the contents of the set have changed.\r\n * The `type` property of the event serves as a type assertion. For example, the following code will output the added and/or removed Ids:\r\n *  ```ts\r\n *  processSelectionSetEvent(ev: SelectionSetEvent): void {\r\n *    if (SelectionSetEventType.Add === ev.type || SelectionSetEventType.Replace === ev.type)\r\n *      console.log(\"Added \" + ev.added.size + \" elements\");\r\n *\r\n *    if (SelectionSetEventType.Add !== ev.type)\r\n *      console.log(\"Removed \" + ev.removed.size + \" elements\");\r\n *  }\r\n *  ```\r\n * @public\r\n * @extensions\r\n */\r\nexport type SelectionSetEvent = SelectAddEvent | SelectRemoveEvent | SelectReplaceEvent;\r\n\r\n/** Tracks a set of hilited entities. When the set changes, notifies ViewManager so that symbology overrides can be updated in active Viewports.\r\n * @internal\r\n */\r\nclass HilitedIds extends Id64.Uint32Set {\r\n  protected _iModel: IModelConnection;\r\n  protected _changing = false;\r\n\r\n  public constructor(iModel: IModelConnection) {\r\n    super();\r\n    this._iModel = iModel;\r\n  }\r\n\r\n  public override add(low: number, high: number) {\r\n    super.add(low, high);\r\n    this.onChanged();\r\n  }\r\n\r\n  public override delete(low: number, high: number) {\r\n    super.delete(low, high);\r\n    this.onChanged();\r\n  }\r\n\r\n  public override clear() {\r\n    super.clear();\r\n    this.onChanged();\r\n  }\r\n\r\n  public override addIds(ids: Id64Arg) {\r\n    this.change(() => super.addIds(ids));\r\n  }\r\n\r\n  public override deleteIds(ids: Id64Arg) {\r\n    this.change(() => super.deleteIds(ids));\r\n  }\r\n\r\n  protected onChanged() {\r\n    if (!this._changing)\r\n      IModelApp.viewManager.onSelectionSetChanged(this._iModel);\r\n  }\r\n\r\n  protected change(func: () => void) {\r\n    const changing = this._changing;\r\n    this._changing = false;\r\n    func();\r\n    this._changing = changing;\r\n    this.onChanged();\r\n  }\r\n}\r\n\r\n/** Keeps the set of hilited elements in sync with the selection set.\r\n * @internal\r\n */\r\nclass HilitedElementIds extends HilitedIds {\r\n  private _removeListener?: () => void;\r\n\r\n  public constructor(iModel: IModelConnection, syncWithSelectionSet = true) {\r\n    super(iModel);\r\n    this.wantSyncWithSelectionSet = syncWithSelectionSet;\r\n  }\r\n\r\n  public get wantSyncWithSelectionSet(): boolean { return undefined !== this._removeListener; }\r\n  public set wantSyncWithSelectionSet(want: boolean) {\r\n    if (want === this.wantSyncWithSelectionSet)\r\n      return;\r\n\r\n    if (want) {\r\n      const set = this._iModel.selectionSet;\r\n      this._removeListener = set.onChanged.addListener((ev) => this.change(() => this.processSelectionSetEvent(ev)));\r\n      this.processSelectionSetEvent({\r\n        set,\r\n        type: SelectionSetEventType.Add,\r\n        added: set.elements,\r\n      });\r\n    } else {\r\n      this._removeListener!();\r\n      this._removeListener = undefined;\r\n    }\r\n  }\r\n\r\n  private processSelectionSetEvent(ev: SelectionSetEvent): void {\r\n    if (SelectionSetEventType.Add !== ev.type)\r\n      this.deleteIds(ev.removed);\r\n\r\n    if (ev.type === SelectionSetEventType.Add || ev.type === SelectionSetEventType.Replace)\r\n      this.addIds(ev.added);\r\n  }\r\n}\r\n\r\n/** A set of *hilited* elements for an [[IModelConnection]], by element id.\r\n * Hilited elements are displayed with a customizable hilite effect within a [[Viewport]].\r\n * The set exposes 3 types of elements in 3 separate collections: geometric elements, subcategories, and geometric models.\r\n * @note Typically, elements are hilited by virtue of their presence in the IModelConnection's [[SelectionSet]]. The HiliteSet allows additional\r\n * elements to be displayed with the hilite effect without adding them to the [[SelectionSet]]. If you add elements to the HiliteSet directly, you\r\n * are also responsible for removing them as appropriate.\r\n * @note Support for subcategories and geometric models in the HiliteSet is currently `beta`.\r\n * @see [[IModelConnection.hilited]] for the HiliteSet associated with an iModel.\r\n * @see [Hilite.Settings]($common) for customization of the hilite effect.\r\n * @public\r\n * @extensions\r\n */\r\nexport class HiliteSet {\r\n  private readonly _elements: HilitedElementIds;\r\n\r\n  /** The set of hilited subcategories.\r\n   * @beta\r\n   */\r\n  public readonly subcategories: Id64.Uint32Set;\r\n  /** The set of hilited [[GeometricModelState]]s.\r\n   * @beta\r\n   */\r\n  public readonly models: Id64.Uint32Set;\r\n  /** The set of hilited elements. */\r\n  public get elements(): Id64.Uint32Set { return this._elements; }\r\n\r\n  /** Construct a HiliteSet\r\n   * @param iModel The iModel containing the entities to be hilited.\r\n   * @param syncWithSelectionSet If true, the contents of the `elements` set will be synchronized with those in the `iModel`'s [[SelectionSet]].\r\n   * @internal\r\n   */\r\n  public constructor(public iModel: IModelConnection, syncWithSelectionSet = true) {\r\n    this._elements = new HilitedElementIds(iModel, syncWithSelectionSet);\r\n    this.subcategories = new HilitedIds(iModel);\r\n    this.models = new HilitedIds(iModel);\r\n  }\r\n\r\n  /** Control whether the hilited elements will be synchronized with the contents of the [[SelectionSet]].\r\n   * By default they are synchronized. Applications that override this take responsibility for managing the set of hilited entities.\r\n   * When turning synchronization off, the contents of the HiliteSet will remain unchanged.\r\n   * When turning synchronization on, the current contents of the HiliteSet will be preserved, and the contents of the selection set will be added to them.\r\n   */\r\n  public get wantSyncWithSelectionSet(): boolean { return this._elements.wantSyncWithSelectionSet; }\r\n  public set wantSyncWithSelectionSet(want: boolean) { this._elements.wantSyncWithSelectionSet = want; }\r\n\r\n  /** Remove all elements from the hilited set. */\r\n  public clear() {\r\n    this.elements.clear();\r\n    this.subcategories.clear();\r\n    this.models.clear();\r\n  }\r\n\r\n  /** Returns true if nothing is hilited. */\r\n  public get isEmpty(): boolean { return this.elements.isEmpty && this.subcategories.isEmpty && this.models.isEmpty; }\r\n\r\n  /** Toggle the hilited state of one or more elements.\r\n   * @param arg the ID(s) of the elements whose state is to be toggled.\r\n   * @param onOff True to add the elements to the hilited set, false to remove them.\r\n   */\r\n  public setHilite(arg: Id64Arg, onOff: boolean): void {\r\n    for (const id of Id64.iterable(arg)) {\r\n      if (onOff)\r\n        this.elements.addId(id);\r\n      else\r\n        this.elements.deleteId(id);\r\n    }\r\n\r\n    IModelApp.viewManager.onSelectionSetChanged(this.iModel);\r\n  }\r\n}\r\n\r\n/** A set of *currently selected* elements for an IModelConnection.\r\n * Selected elements are displayed with a customizable hilite effect within a [[Viewport]].\r\n * @see [Hilite.Settings]($common) for customization of the hilite effect.\r\n * @public\r\n * @extensions\r\n */\r\nexport class SelectionSet {\r\n  private _elements = new Set<string>();\r\n\r\n  /** The IDs of the selected elements.\r\n   * @note Do not modify this set directly. Instead, use methods like [[SelectionSet.add]].\r\n   */\r\n  public get elements(): Set<string> { return this._elements; }\r\n\r\n  /** Called whenever elements are added or removed from this SelectionSet */\r\n  public readonly onChanged = new BeEvent<(ev: SelectionSetEvent) => void>();\r\n\r\n  public constructor(public iModel: IModelConnection) { }\r\n\r\n  private sendChangedEvent(ev: SelectionSetEvent) {\r\n    IModelApp.viewManager.onSelectionSetChanged(this.iModel);\r\n    this.onChanged.raiseEvent(ev);\r\n  }\r\n\r\n  /** Get the number of entries in this selection set. */\r\n  public get size() { return this.elements.size; }\r\n\r\n  /** Check whether there are any selected elements. */\r\n  public get isActive() { return this.size !== 0; }\r\n\r\n  /** Return true if elemId is in this SelectionSet.\r\n   * @see [[isSelected]]\r\n   */\r\n  public has(elemId?: string) { return !!elemId && this.elements.has(elemId); }\r\n\r\n  /** Query whether an Id is in the selection set.\r\n   * @see [[has]]\r\n   */\r\n  public isSelected(elemId?: Id64String): boolean { return !!elemId && this.elements.has(elemId); }\r\n\r\n  /** Clear current selection set.\r\n   * @note raises the [[onChanged]] event with [[SelectionSetEventType.Clear]].\r\n   */\r\n  public emptyAll(): void {\r\n    if (!this.isActive)\r\n      return;\r\n\r\n    const removed = this._elements;\r\n    this._elements = new Set<string>();\r\n    this.sendChangedEvent({ set: this, type: SelectionSetEventType.Clear, removed });\r\n  }\r\n\r\n  /**\r\n   * Add one or more Ids to the current selection set.\r\n   * @param elem The set of Ids to add.\r\n   * @returns true if any elements were added.\r\n   */\r\n  public add(elem: Id64Arg): boolean {\r\n    return this._add(elem);\r\n  }\r\n\r\n  private _add(elem: Id64Arg, sendEvent = true): boolean {\r\n    const oldSize = this.elements.size;\r\n    for (const id of Id64.iterable(elem))\r\n      this.elements.add(id);\r\n\r\n    const changed = oldSize !== this.elements.size;\r\n    if (sendEvent && changed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Add, set: this, added: elem });\r\n\r\n    return changed;\r\n  }\r\n\r\n  /**\r\n   * Remove one or more Ids from the current selection set.\r\n   * @param elem The set of Ids to remove.\r\n   * @returns true if any elements were removed.\r\n   */\r\n  public remove(elem: Id64Arg): boolean {\r\n    return this._remove(elem);\r\n  }\r\n\r\n  private _remove(elem: Id64Arg, sendEvent = true): boolean {\r\n    const oldSize = this.elements.size;\r\n    for (const id of Id64.iterable(elem))\r\n      this.elements.delete(id);\r\n\r\n    const changed = oldSize !== this.elements.size;\r\n    if (sendEvent && changed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Remove, set: this, removed: elem });\r\n\r\n    return changed;\r\n  }\r\n\r\n  /**\r\n   * Add one set of Ids, and remove another set of Ids. Any Ids that are in both sets are removed.\r\n   * @returns True if any Ids were either added or removed.\r\n   */\r\n  public addAndRemove(adds: Id64Arg, removes: Id64Arg): boolean {\r\n    const added = this._add(adds, false);\r\n    const removed = this._remove(removes, false);\r\n\r\n    if (added && removed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Replace, set: this, added: adds, removed: removes });\r\n    else if (added)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Add, set: this, added: adds });\r\n    else if (removed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Remove, set: this, removed: removes });\r\n\r\n    return (added || removed);\r\n  }\r\n\r\n  /** Invert the state of a set of Ids in the SelectionSet */\r\n  public invert(elem: Id64Arg): boolean {\r\n    const elementsToAdd = new Set<string>();\r\n    const elementsToRemove = new Set<string>();\r\n    for (const id of Id64.iterable(elem)) {\r\n      if (this.elements.has(id))\r\n        elementsToRemove.add(id);\r\n      else\r\n        elementsToAdd.add(id);\r\n    }\r\n\r\n    return this.addAndRemove(elementsToAdd, elementsToRemove);\r\n  }\r\n\r\n  /** Change selection set to be the supplied set of Ids. */\r\n  public replace(elem: Id64Arg): void {\r\n    if (areEqual(this.elements, elem))\r\n      return;\r\n\r\n    const removed = this._elements;\r\n    this._elements = new Set<string>();\r\n    this._add(elem, false);\r\n\r\n    if (0 < removed.size) {\r\n      for (const id of Id64.iterable(elem)) {\r\n        if (removed.has(id))\r\n          removed.delete(id);\r\n      }\r\n    }\r\n\r\n    this.sendChangedEvent({ type: SelectionSetEventType.Replace, set: this, added: elem, removed });\r\n  }\r\n}\r\n\r\nfunction areEqual(lhs: Set<string>, rhs: Id64Arg): boolean {\r\n  // Size is unreliable if input can contain duplicates...\r\n  if (Array.isArray(rhs))\r\n    rhs = Id64.toIdSet(rhs);\r\n\r\n  if (lhs.size !== Id64.sizeOf(rhs))\r\n    return false;\r\n\r\n  for (const id of Id64.iterable(rhs))\r\n    if (!lhs.has(id))\r\n      return false;\r\n\r\n  return true;\r\n}\r\n"]}
+{"version":3,"file":"SelectionSet.js","sourceRoot":"","sources":["../../src/SelectionSet.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 SelectionSet\r\n */\r\nimport { BeEvent, Id64, Id64Arg, Id64String } from \"@itwin/core-bentley\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\n\r\n/** Identifies the type of changes made to the [[SelectionSet]] to produce a [[SelectionSetEvent]].\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SelectionSetEventType {\r\n  /** Elements have been added to the set. */\r\n  Add,\r\n  /** Elements have been removed from the set. */\r\n  Remove,\r\n  /** Some elements have been added to the set and others have been removed. */\r\n  Replace,\r\n  /** All elements are about to be removed from the set. */\r\n  Clear,\r\n}\r\n\r\n/** Passed to [[SelectionSet.onChanged]] event listeners when elements are added to the selection set.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SelectAddEvent {\r\n  type: SelectionSetEventType.Add;\r\n  /** The Ids of the elements added to the set. */\r\n  added: Id64Arg;\r\n  /** The affected SelectionSet. */\r\n  set: SelectionSet;\r\n}\r\n\r\n/** Passed to [[SelectionSet.onChanged]] event listeners when elements are removed from the selection set.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SelectRemoveEvent {\r\n  /** The type of operation that produced this event. */\r\n  type: SelectionSetEventType.Remove | SelectionSetEventType.Clear;\r\n  /** The element Ids removed from the set. */\r\n  removed: Id64Arg;\r\n  /** The affected SelectionSet. */\r\n  set: SelectionSet;\r\n}\r\n\r\n/** Passed to [[SelectionSet.onChanged]] event listeners when elements are simultaneously added to and removed from the selection set.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SelectReplaceEvent {\r\n  type: SelectionSetEventType.Replace;\r\n  /** The element Ids added to the set. */\r\n  added: Id64Arg;\r\n  /** The element Ids removed from the set. */\r\n  removed: Id64Arg;\r\n  /** The affected SelectionSet. */\r\n  set: SelectionSet;\r\n}\r\n\r\n/** Payload sent to [[SelectionSet.onChanged]] event listeners to describe how the contents of the set have changed.\r\n * The `type` property of the event serves as a type assertion. For example, the following code will output the added and/or removed Ids:\r\n *  ```ts\r\n *  processSelectionSetEvent(ev: SelectionSetEvent): void {\r\n *    if (SelectionSetEventType.Add === ev.type || SelectionSetEventType.Replace === ev.type)\r\n *      console.log(\"Added \" + ev.added.size + \" elements\");\r\n *\r\n *    if (SelectionSetEventType.Add !== ev.type)\r\n *      console.log(\"Removed \" + ev.removed.size + \" elements\");\r\n *  }\r\n *  ```\r\n * @public\r\n * @extensions\r\n */\r\nexport type SelectionSetEvent = SelectAddEvent | SelectRemoveEvent | SelectReplaceEvent;\r\n\r\n/** Tracks a set of hilited entities. When the set changes, notifies ViewManager so that symbology overrides can be updated in active Viewports.\r\n * @internal\r\n */\r\nclass HilitedIds extends Id64.Uint32Set {\r\n  protected _iModel: IModelConnection;\r\n  protected _changing = false;\r\n\r\n  public constructor(iModel: IModelConnection) {\r\n    super();\r\n    this._iModel = iModel;\r\n  }\r\n\r\n  public override add(low: number, high: number) {\r\n    super.add(low, high);\r\n    this.onChanged();\r\n  }\r\n\r\n  public override delete(low: number, high: number) {\r\n    super.delete(low, high);\r\n    this.onChanged();\r\n  }\r\n\r\n  public override clear() {\r\n    super.clear();\r\n    this.onChanged();\r\n  }\r\n\r\n  public override addIds(ids: Id64Arg) {\r\n    this.change(() => super.addIds(ids));\r\n  }\r\n\r\n  public override deleteIds(ids: Id64Arg) {\r\n    this.change(() => super.deleteIds(ids));\r\n  }\r\n\r\n  protected onChanged() {\r\n    if (!this._changing)\r\n      IModelApp.viewManager.onSelectionSetChanged(this._iModel);\r\n  }\r\n\r\n  protected change(func: () => void) {\r\n    const changing = this._changing;\r\n    this._changing = false;\r\n    func();\r\n    this._changing = changing;\r\n    this.onChanged();\r\n  }\r\n}\r\n\r\n/** Keeps the set of hilited elements in sync with the selection set.\r\n * @internal\r\n */\r\nclass HilitedElementIds extends HilitedIds {\r\n  private _removeListener?: () => void;\r\n\r\n  public constructor(iModel: IModelConnection, syncWithSelectionSet = true) {\r\n    super(iModel);\r\n    this.wantSyncWithSelectionSet = syncWithSelectionSet;\r\n  }\r\n\r\n  public get wantSyncWithSelectionSet(): boolean { return undefined !== this._removeListener; }\r\n  public set wantSyncWithSelectionSet(want: boolean) {\r\n    if (want === this.wantSyncWithSelectionSet)\r\n      return;\r\n\r\n    if (want) {\r\n      const set = this._iModel.selectionSet;\r\n      this._removeListener = set.onChanged.addListener((ev) => this.change(() => this.processSelectionSetEvent(ev)));\r\n      this.processSelectionSetEvent({\r\n        set,\r\n        type: SelectionSetEventType.Add,\r\n        added: set.elements,\r\n      });\r\n    } else {\r\n      this._removeListener!();\r\n      this._removeListener = undefined;\r\n    }\r\n  }\r\n\r\n  private processSelectionSetEvent(ev: SelectionSetEvent): void {\r\n    if (SelectionSetEventType.Add !== ev.type)\r\n      this.deleteIds(ev.removed);\r\n\r\n    if (ev.type === SelectionSetEventType.Add || ev.type === SelectionSetEventType.Replace)\r\n      this.addIds(ev.added);\r\n  }\r\n}\r\n\r\n/** Describes how the sets of hilited models and subcategories in a [[HiliteSet]] interact.\r\n *  - \"union\" indicates a [Feature]($common) will be hilited if either its model **or** its subcategory is present in the HiliteSet.\r\n *  - \"intersection\" indicates a [Feature]($common) will be hilited only if both its model **and** its subcategory are present in the HiliteSet.\r\n *\r\n * @see [[HiliteSet.modelSubCategoryMode]] to change the mode for a HiliteSet.\r\n * @public\r\n */\r\nexport type ModelSubCategoryHiliteMode = \"union\" | \"intersection\";\r\n\r\n/** A set of *hilited* elements for an [[IModelConnection]], by element id.\r\n * Hilited elements are displayed with a customizable hilite effect within a [[Viewport]].\r\n * The set exposes 3 types of elements in 3 separate collections: [GeometricElement]($backend), [GeometricModel]($backend), and [SubCategory]($backend).\r\n * The [[models]] and [[subcategories]] can be hilited independently or as an intersection of the two sets, as specified by [[modelSubCategoryMode]].\r\n *\r\n * Technically, the hilite effect is applied to [Feature]($common)s, not [Element]($backend)s. An element's geometry stream can contain multiple\r\n * features belonging to different subcategories.\r\n *\r\n * Because Javascript lacks efficient support for 64-bit integers, the Ids are stored as pairs of 32-bit integers via [Id64.Uint32Set]($bentley).\r\n *\r\n * @note Typically, elements are hilited by virtue of their presence in the IModelConnection's [[SelectionSet]]. The HiliteSet allows additional\r\n * elements to be displayed with the hilite effect without adding them to the [[SelectionSet]]. If you add elements to the HiliteSet directly, you\r\n * are also responsible for removing them as appropriate.\r\n * @see [[IModelConnection.hilited]] for the HiliteSet associated with an iModel.\r\n * @see [Hilite.Settings]($common) for customization of the hilite effect.\r\n * @public\r\n * @extensions\r\n */\r\nexport class HiliteSet {\r\n  private readonly _elements: HilitedElementIds;\r\n  private _mode: ModelSubCategoryHiliteMode = \"union\";\r\n\r\n  /** The set of hilited subcategories.\r\n   * @see [[modelSubCategoryMode]] to control how this set interacts with the set of hilited [[models]].\r\n   * @see [[IModelConnection.Categories]] to obtain the set of subcategories associated with one or more [Category]($backend)'s.\r\n   */\r\n  public readonly subcategories: Id64.Uint32Set;\r\n\r\n  /** The set of hilited [[GeometricModelState]]s.\r\n   * @see [[modelSubCategoryMode]] to control how this set interacts with the set of hilited [[subcategories]].\r\n   */\r\n  public readonly models: Id64.Uint32Set;\r\n\r\n  /** The set of hilited elements. */\r\n  public get elements(): Id64.Uint32Set { return this._elements; }\r\n\r\n  /** Controls how the sets of hilited [[models]] and [[subcategories]] interact with one another.\r\n   * By default they are treated as a union: a [Feature]($common) is hilited if either its model **or** its subcategory is hilited.\r\n   * This can be changed to an intersection such that a [Feature]($common) is hilited only if both its model **and** subcategory are hilited.\r\n   * @note The sets of hilited models and subcategories are independent of the set of hilited [[elements]] - an element whose Id is present in\r\n   * [[elements]] is always hilited regardless of its model or subcategories.\r\n   */\r\n  public get modelSubCategoryMode(): ModelSubCategoryHiliteMode {\r\n    return this._mode;\r\n  }\r\n  public set modelSubCategoryMode(mode: ModelSubCategoryHiliteMode) {\r\n    if (mode === this._mode)\r\n      return;\r\n\r\n    this.onModelSubCategoryModeChanged.raiseEvent(mode);\r\n    this._mode = mode;\r\n  }\r\n\r\n  /** Event raised just before changing the value of [[modelSubCategoryMode]]. */\r\n  public readonly onModelSubCategoryModeChanged = new BeEvent<(newMode: ModelSubCategoryHiliteMode) => void>();\r\n\r\n  /** Construct a HiliteSet\r\n   * @param iModel The iModel containing the entities to be hilited.\r\n   * @param syncWithSelectionSet If true, the contents of the `elements` set will be synchronized with those in the `iModel`'s [[SelectionSet]].\r\n   * @internal\r\n   */\r\n  public constructor(public iModel: IModelConnection, syncWithSelectionSet = true) {\r\n    this._elements = new HilitedElementIds(iModel, syncWithSelectionSet);\r\n    this.subcategories = new HilitedIds(iModel);\r\n    this.models = new HilitedIds(iModel);\r\n  }\r\n\r\n  /** Control whether the hilited elements will be synchronized with the contents of the [[SelectionSet]].\r\n   * By default they are synchronized. Applications that override this take responsibility for managing the set of hilited entities.\r\n   * When turning synchronization off, the contents of the HiliteSet will remain unchanged.\r\n   * When turning synchronization on, the current contents of the HiliteSet will be preserved, and the contents of the selection set will be added to them.\r\n   */\r\n  public get wantSyncWithSelectionSet(): boolean { return this._elements.wantSyncWithSelectionSet; }\r\n  public set wantSyncWithSelectionSet(want: boolean) { this._elements.wantSyncWithSelectionSet = want; }\r\n\r\n  /** Remove all elements from the hilited set. */\r\n  public clear() {\r\n    this.elements.clear();\r\n    this.subcategories.clear();\r\n    this.models.clear();\r\n  }\r\n\r\n  /** Returns true if nothing is hilited. */\r\n  public get isEmpty(): boolean { return this.elements.isEmpty && this.subcategories.isEmpty && this.models.isEmpty; }\r\n\r\n  /** Toggle the hilited state of one or more elements.\r\n   * @param arg the ID(s) of the elements whose state is to be toggled.\r\n   * @param onOff True to add the elements to the hilited set, false to remove them.\r\n   */\r\n  public setHilite(arg: Id64Arg, onOff: boolean): void {\r\n    for (const id of Id64.iterable(arg)) {\r\n      if (onOff)\r\n        this.elements.addId(id);\r\n      else\r\n        this.elements.deleteId(id);\r\n    }\r\n\r\n    IModelApp.viewManager.onSelectionSetChanged(this.iModel);\r\n  }\r\n}\r\n\r\n/** A set of *currently selected* elements for an IModelConnection.\r\n * Selected elements are displayed with a customizable hilite effect within a [[Viewport]].\r\n * @see [Hilite.Settings]($common) for customization of the hilite effect.\r\n * @public\r\n * @extensions\r\n */\r\nexport class SelectionSet {\r\n  private _elements = new Set<string>();\r\n\r\n  /** The IDs of the selected elements.\r\n   * @note Do not modify this set directly. Instead, use methods like [[SelectionSet.add]].\r\n   */\r\n  public get elements(): Set<string> { return this._elements; }\r\n\r\n  /** Called whenever elements are added or removed from this SelectionSet */\r\n  public readonly onChanged = new BeEvent<(ev: SelectionSetEvent) => void>();\r\n\r\n  public constructor(public iModel: IModelConnection) { }\r\n\r\n  private sendChangedEvent(ev: SelectionSetEvent) {\r\n    IModelApp.viewManager.onSelectionSetChanged(this.iModel);\r\n    this.onChanged.raiseEvent(ev);\r\n  }\r\n\r\n  /** Get the number of entries in this selection set. */\r\n  public get size() { return this.elements.size; }\r\n\r\n  /** Check whether there are any selected elements. */\r\n  public get isActive() { return this.size !== 0; }\r\n\r\n  /** Return true if elemId is in this SelectionSet.\r\n   * @see [[isSelected]]\r\n   */\r\n  public has(elemId?: string) { return !!elemId && this.elements.has(elemId); }\r\n\r\n  /** Query whether an Id is in the selection set.\r\n   * @see [[has]]\r\n   */\r\n  public isSelected(elemId?: Id64String): boolean { return !!elemId && this.elements.has(elemId); }\r\n\r\n  /** Clear current selection set.\r\n   * @note raises the [[onChanged]] event with [[SelectionSetEventType.Clear]].\r\n   */\r\n  public emptyAll(): void {\r\n    if (!this.isActive)\r\n      return;\r\n\r\n    const removed = this._elements;\r\n    this._elements = new Set<string>();\r\n    this.sendChangedEvent({ set: this, type: SelectionSetEventType.Clear, removed });\r\n  }\r\n\r\n  /**\r\n   * Add one or more Ids to the current selection set.\r\n   * @param elem The set of Ids to add.\r\n   * @returns true if any elements were added.\r\n   */\r\n  public add(elem: Id64Arg): boolean {\r\n    return this._add(elem);\r\n  }\r\n\r\n  private _add(elem: Id64Arg, sendEvent = true): boolean {\r\n    const oldSize = this.elements.size;\r\n    for (const id of Id64.iterable(elem))\r\n      this.elements.add(id);\r\n\r\n    const changed = oldSize !== this.elements.size;\r\n    if (sendEvent && changed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Add, set: this, added: elem });\r\n\r\n    return changed;\r\n  }\r\n\r\n  /**\r\n   * Remove one or more Ids from the current selection set.\r\n   * @param elem The set of Ids to remove.\r\n   * @returns true if any elements were removed.\r\n   */\r\n  public remove(elem: Id64Arg): boolean {\r\n    return this._remove(elem);\r\n  }\r\n\r\n  private _remove(elem: Id64Arg, sendEvent = true): boolean {\r\n    const oldSize = this.elements.size;\r\n    for (const id of Id64.iterable(elem))\r\n      this.elements.delete(id);\r\n\r\n    const changed = oldSize !== this.elements.size;\r\n    if (sendEvent && changed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Remove, set: this, removed: elem });\r\n\r\n    return changed;\r\n  }\r\n\r\n  /**\r\n   * Add one set of Ids, and remove another set of Ids. Any Ids that are in both sets are removed.\r\n   * @returns True if any Ids were either added or removed.\r\n   */\r\n  public addAndRemove(adds: Id64Arg, removes: Id64Arg): boolean {\r\n    const added = this._add(adds, false);\r\n    const removed = this._remove(removes, false);\r\n\r\n    if (added && removed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Replace, set: this, added: adds, removed: removes });\r\n    else if (added)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Add, set: this, added: adds });\r\n    else if (removed)\r\n      this.sendChangedEvent({ type: SelectionSetEventType.Remove, set: this, removed: removes });\r\n\r\n    return (added || removed);\r\n  }\r\n\r\n  /** Invert the state of a set of Ids in the SelectionSet */\r\n  public invert(elem: Id64Arg): boolean {\r\n    const elementsToAdd = new Set<string>();\r\n    const elementsToRemove = new Set<string>();\r\n    for (const id of Id64.iterable(elem)) {\r\n      if (this.elements.has(id))\r\n        elementsToRemove.add(id);\r\n      else\r\n        elementsToAdd.add(id);\r\n    }\r\n\r\n    return this.addAndRemove(elementsToAdd, elementsToRemove);\r\n  }\r\n\r\n  /** Change selection set to be the supplied set of Ids. */\r\n  public replace(elem: Id64Arg): void {\r\n    if (areEqual(this.elements, elem))\r\n      return;\r\n\r\n    const removed = this._elements;\r\n    this._elements = new Set<string>();\r\n    this._add(elem, false);\r\n\r\n    if (0 < removed.size) {\r\n      for (const id of Id64.iterable(elem)) {\r\n        if (removed.has(id))\r\n          removed.delete(id);\r\n      }\r\n    }\r\n\r\n    this.sendChangedEvent({ type: SelectionSetEventType.Replace, set: this, added: elem, removed });\r\n  }\r\n}\r\n\r\nfunction areEqual(lhs: Set<string>, rhs: Id64Arg): boolean {\r\n  // Size is unreliable if input can contain duplicates...\r\n  if (Array.isArray(rhs))\r\n    rhs = Id64.toIdSet(rhs);\r\n\r\n  if (lhs.size !== Id64.sizeOf(rhs))\r\n    return false;\r\n\r\n  for (const id of Id64.iterable(rhs))\r\n    if (!lhs.has(id))\r\n      return false;\r\n\r\n  return true;\r\n}\r\n"]}

package/lib/esm/SheetViewState.js

@@ -130,7 +130,7 @@ class ViewAttachmentsInfo {
         options.sheetViewAttachmentIds = CompressedId64Set.sortAndCompress(this._ids);
         options.viewStateLoadProps = {
             displayStyle: {
-                omitScheduleScriptElementIds: true,
+                omitScheduleScriptElementIds: !IModelApp.tileAdmin.enableFrontendScheduleScripts,
                 compressExcludedElementIds: true,
             },
         };