@itwin/core-frontend 3.2.0-dev.8 → 3.3.0-dev.1

package/lib/cjs/Sprites.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sprites.js","sourceRoot":"","sources":["../../src/Sprites.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAA6C;AAC7C,wDAAgE;AAEhE,qEAAkE;AAClE,2CAA+E;AAK/E;;;;;;;;;;;;;GAaG;AACH,MAAa,MAAM;IAYjB;;OAEG;IACH,YAAY,GAAyB;QAZrC,uEAAuE;QACvD,SAAI,GAAG,IAAI,uBAAO,EAAE,CAAC;QAYnC,IAAI,CAAC,WAAW,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAA,+BAAmB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,uCAA2B,EAAC,GAAG,CAAC,CAAC;QAC3G,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,iCAAiC;YACnD,qBAAM,CAAC,QAAQ,CAAC,GAAG,+CAAsB,CAAC,OAAO,UAAU,EAAE,GAAG,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC;IAlBD,uFAAuF;IACvF,IAAW,MAAM,KAAc,OAAO,IAAI,uBAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9G,sDAAsD;IACtD,IAAW,QAAQ,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;CAgBpE;AA1BD,wBA0BC;AAED;;;GAGG;AACH,MAAa,WAAW;IAGtB;;OAEG;IACI,MAAM,CAAC,gBAAgB,CAAC,SAAiB;QAC9C,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;SACtC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uDAAuD;IAChD,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;;AAhBrD,kCAiBC;AAhByB,oBAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAkB/D;;;;;GAKG;AACH,MAAa,cAAc;IAA3B;QAIE;;WAEG;QACa,aAAQ,GAAG,IAAI,uBAAO,EAAE,CAAC;IAiD3C,CAAC;IAhDC,IAAW,QAAQ,KAAc,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC;IAEvE;;;;;;;OAOG;IACI,QAAQ,CAAC,MAAc,EAAE,QAAwB,EAAE,aAAqB,EAAE,KAAc;QAC7F,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,QAAQ,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE;YAC3B,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,8CAA8C;gBAC7E,QAAQ,CAAC,qBAAqB,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,iCAAiC;IAC/E,CAAC;IAED,8DAA8D;IACvD,UAAU;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ;YAChB,OAAO;QACT,IAAI,CAAC,SAAU,CAAC,qBAAqB,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,cAAc,CAAC,GAA6B;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAQ,CAAC;QAC7B,IAAI,SAAS,KAAK,MAAM,CAAC,KAAK;YAC5B,OAAO;QAET,IAAI,SAAS,KAAK,IAAI,CAAC,MAAM;YAC3B,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAEhC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,4HAA4H;IACrH,QAAQ,CAAC,OAAwB;QACtC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS;YACrC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;CACF;AAxDD,wCAwDC","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 { Logger } from \"@itwin/core-bentley\";\r\nimport { Point2d, Point3d, XYAndZ } from \"@itwin/core-geometry\";\r\nimport { ImageSource } from \"@itwin/core-common\";\r\nimport { FrontendLoggerCategory } from \"./FrontendLoggerCategory\";\r\nimport { imageElementFromImageSource, imageElementFromUrl } from \"./ImageUtil\";\r\nimport { CanvasDecoration } from \"./render/CanvasDecoration\";\r\nimport { DecorateContext } from \"./ViewContext\";\r\nimport { ScreenViewport } from \"./Viewport\";\r\n\r\n/** Sprites are small raster images that are drawn *on top* of Viewports by a ViewDecoration.\r\n * Their purpose is to draw the user's attention to something of importance.\r\n *\r\n * There are two classes in the Sprites subsystem: Sprite (a Sprite image) and SpriteLocation.\r\n * Sprite are the images that define the way a type of sprite looks and are generally\r\n * loaded one time and saved for the rest of a session. A SpriteLocation defines the current\r\n * position of a single Sprite in a Viewport.\r\n *\r\n * A SpriteLocation can be either active or inactive. It becomes active by specifying a location\r\n * (an x,y point) and a Sprite to draw at that point. A Sprite\r\n * can be used many times by many SpriteLocations and a single SpriteLocation can\r\n * change both position and which Sprite is shown at that position over time.\r\n * @public\r\n */\r\nexport class Sprite {\r\n  /** The image for this Sprite. If undefined, the Spite is not valid. */\r\n  public image?: HTMLImageElement;\r\n  /** The size of this Sprite. If not loaded, value is not meaningful. */\r\n  public readonly size = new Point2d();\r\n  /** Promise fulfilled when this sprite is loaded. */\r\n  public loadPromise: Promise<HTMLImageElement>;\r\n  /** The offset to the middle of this Sprite. If not loaded, value is not meaningful. */\r\n  public get offset(): Point2d { return new Point2d(Math.round(this.size.x) / 2, Math.round(this.size.y / 2)); }\r\n  /** Whether this sprite has be successfully loaded. */\r\n  public get isLoaded(): boolean { return undefined !== this.image; }\r\n\r\n  /** construct a Sprite from an ImageSource or a Url\r\n   * @param src The ImageSource holding an image to create the texture for this Sprite, or the url of the image\r\n   */\r\n  constructor(src: ImageSource | string) {\r\n    this.loadPromise = (typeof src === \"string\") ? imageElementFromUrl(src) : imageElementFromImageSource(src);\r\n    this.loadPromise.then((image) => {\r\n      this.image = image;\r\n      this.size.set(image.naturalWidth, image.naturalHeight);\r\n    }).catch((err) => {\r\n      const str = err.toString();\r\n      console.log(str); // eslint-disable-line no-console\r\n      Logger.logError(`${FrontendLoggerCategory.Package}.sprites`, str);\r\n    });\r\n  }\r\n}\r\n\r\n/** Icon sprites are loaded from .png files in the assets directory of imodeljs-native.\r\n * They are cached by name, and the cache is cleared when the ToolAdmin is shut down.\r\n * @public\r\n */\r\nexport class IconSprites {\r\n  private static readonly _sprites = new Map<string, Sprite>();\r\n\r\n  /** Look up an IconSprite by url. If not loaded, create and load it.\r\n   * @param spriteUrl The url of an image to load for this Sprite.\r\n   */\r\n  public static getSpriteFromUrl(spriteUrl: string): Sprite {\r\n    let sprite = this._sprites.get(spriteUrl);\r\n    if (!sprite) {\r\n      sprite = new Sprite(spriteUrl);\r\n      this._sprites.set(spriteUrl, sprite);\r\n    }\r\n    return sprite;\r\n  }\r\n\r\n  /** Empty the cache, disposing all existing Sprites. */\r\n  public static emptyAll() { this._sprites.clear(); }\r\n}\r\n\r\n/** A Sprite location. Sprites generally move around on the screen and this object holds the current location\r\n * and current Sprite within a ScreenViewport. SpriteLocations can be either inactive (not visible) or active.\r\n *\r\n * A SpriteLocation can also specify that a Sprite should be drawn partially transparent.\r\n * @public\r\n */\r\nexport class SpriteLocation implements CanvasDecoration {\r\n  private _viewport?: ScreenViewport;\r\n  private _sprite?: Sprite;\r\n  private _alpha?: number;\r\n  /** The current position of this sprite in view coordinates.\r\n   * @see [[CanvasDecoration.position]]\r\n   */\r\n  public readonly position = new Point3d();\r\n  public get isActive(): boolean { return this._viewport !== undefined; }\r\n\r\n  /** Activate this SpriteLocation to show a Sprite at a location in a single ScreenViewport.\r\n   * This call does not display the Sprite. Rather, subsequent calls to [[decorate]] from  will show the Sprite.\r\n   * This SpriteLocation remains active until [[deactivate]] is called.\r\n   * @param sprite The Sprite to draw at this SpriteLocation\r\n   * @param viewport The Viewport onto which the Sprite is drawn\r\n   * @param locationWorld The position, in world coordinates\r\n   * @param alpha Optional alpha for the Sprite. Must be a number between 0 (fully transparent) and 1 (fully opaque).\r\n   */\r\n  public activate(sprite: Sprite, viewport: ScreenViewport, locationWorld: XYAndZ, alpha?: number): void {\r\n    this._sprite = sprite;\r\n    this._alpha = alpha;\r\n    this._viewport = viewport;\r\n    viewport.worldToView(locationWorld, this.position);\r\n    sprite.loadPromise.then(() => {\r\n      if (this._viewport === viewport) // was this deactivated while we were loading?\r\n        viewport.invalidateDecorations();\r\n    }).catch(() => this._viewport = undefined); // sprite was not loaded properly\r\n  }\r\n\r\n  /** Turn this SpriteLocation off so it will no longer show. */\r\n  public deactivate() {\r\n    if (!this.isActive)\r\n      return;\r\n    this._viewport!.invalidateDecorations();\r\n    this._viewport = undefined;\r\n  }\r\n\r\n  /** Draw this sprite onto the supplied canvas.\r\n   * @see [[CanvasDecoration.drawDecoration]]\r\n   */\r\n  public drawDecoration(ctx: CanvasRenderingContext2D): void {\r\n    const sprite = this._sprite!;\r\n    if (undefined === sprite.image)\r\n      return;\r\n\r\n    if (undefined !== this._alpha)\r\n      ctx.globalAlpha = this._alpha;\r\n\r\n    ctx.drawImage(sprite.image, -sprite.offset.x, -sprite.offset.y);\r\n  }\r\n\r\n  /** If this SpriteLocation is active and the supplied DecorateContext is for its Viewport, add the Sprite to decorations. */\r\n  public decorate(context: DecorateContext) {\r\n    if (context.viewport === this._viewport)\r\n      context.addCanvasDecoration(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Sprites.js","sourceRoot":"","sources":["../../src/Sprites.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 { Logger } from \"@itwin/core-bentley\";\r\nimport { Point2d, Point3d, XYAndZ } from \"@itwin/core-geometry\";\r\nimport { ImageSource } from \"@itwin/core-common\";\r\nimport { FrontendLoggerCategory } from \"./FrontendLoggerCategory\";\r\nimport { imageElementFromImageSource, imageElementFromUrl } from \"./ImageUtil\";\r\nimport { CanvasDecoration } from \"./render/CanvasDecoration\";\r\nimport { DecorateContext } from \"./ViewContext\";\r\nimport { ScreenViewport } from \"./Viewport\";\r\n\r\n/** Sprites are small raster images that are drawn *on top* of Viewports by a ViewDecoration.\r\n * Their purpose is to draw the user's attention to something of importance.\r\n *\r\n * There are two classes in the Sprites subsystem: Sprite (a Sprite image) and SpriteLocation.\r\n * Sprite are the images that define the way a type of sprite looks and are generally\r\n * loaded one time and saved for the rest of a session. A SpriteLocation defines the current\r\n * position of a single Sprite in a Viewport.\r\n *\r\n * A SpriteLocation can be either active or inactive. It becomes active by specifying a location\r\n * (an x,y point) and a Sprite to draw at that point. A Sprite\r\n * can be used many times by many SpriteLocations and a single SpriteLocation can\r\n * change both position and which Sprite is shown at that position over time.\r\n * @public\r\n * @extensions\r\n */\r\nexport class Sprite {\r\n  /** The image for this Sprite. If undefined, the Spite is not valid. */\r\n  public image?: HTMLImageElement;\r\n  /** The size of this Sprite. If not loaded, value is not meaningful. */\r\n  public readonly size = new Point2d();\r\n  /** Promise fulfilled when this sprite is loaded. */\r\n  public loadPromise: Promise<HTMLImageElement>;\r\n  /** The offset to the middle of this Sprite. If not loaded, value is not meaningful. */\r\n  public get offset(): Point2d { return new Point2d(Math.round(this.size.x) / 2, Math.round(this.size.y / 2)); }\r\n  /** Whether this sprite has be successfully loaded. */\r\n  public get isLoaded(): boolean { return undefined !== this.image; }\r\n\r\n  /** construct a Sprite from an ImageSource or a Url\r\n   * @param src The ImageSource holding an image to create the texture for this Sprite, or the url of the image\r\n   */\r\n  constructor(src: ImageSource | string) {\r\n    this.loadPromise = (typeof src === \"string\") ? imageElementFromUrl(src) : imageElementFromImageSource(src);\r\n    this.loadPromise.then((image) => {\r\n      this.image = image;\r\n      this.size.set(image.naturalWidth, image.naturalHeight);\r\n    }).catch((err) => {\r\n      const str = err.toString();\r\n      console.log(str); // eslint-disable-line no-console\r\n      Logger.logError(`${FrontendLoggerCategory.Package}.sprites`, str);\r\n    });\r\n  }\r\n}\r\n\r\n/** Icon sprites are loaded from .png files in the assets directory of imodeljs-native.\r\n * They are cached by name, and the cache is cleared when the ToolAdmin is shut down.\r\n * @public\r\n * @extensions\r\n */\r\nexport class IconSprites {\r\n  private static readonly _sprites = new Map<string, Sprite>();\r\n\r\n  /** Look up an IconSprite by url. If not loaded, create and load it.\r\n   * @param spriteUrl The url of an image to load for this Sprite.\r\n   */\r\n  public static getSpriteFromUrl(spriteUrl: string): Sprite {\r\n    let sprite = this._sprites.get(spriteUrl);\r\n    if (!sprite) {\r\n      sprite = new Sprite(spriteUrl);\r\n      this._sprites.set(spriteUrl, sprite);\r\n    }\r\n    return sprite;\r\n  }\r\n\r\n  /** Empty the cache, disposing all existing Sprites. */\r\n  public static emptyAll() { this._sprites.clear(); }\r\n}\r\n\r\n/** A Sprite location. Sprites generally move around on the screen and this object holds the current location\r\n * and current Sprite within a ScreenViewport. SpriteLocations can be either inactive (not visible) or active.\r\n *\r\n * A SpriteLocation can also specify that a Sprite should be drawn partially transparent.\r\n * @public\r\n * @extensions\r\n */\r\nexport class SpriteLocation implements CanvasDecoration {\r\n  private _viewport?: ScreenViewport;\r\n  private _sprite?: Sprite;\r\n  private _alpha?: number;\r\n  /** The current position of this sprite in view coordinates.\r\n   * @see [[CanvasDecoration.position]]\r\n   */\r\n  public readonly position = new Point3d();\r\n  public get isActive(): boolean { return this._viewport !== undefined; }\r\n\r\n  /** Activate this SpriteLocation to show a Sprite at a location in a single ScreenViewport.\r\n   * This call does not display the Sprite. Rather, subsequent calls to [[decorate]] from  will show the Sprite.\r\n   * This SpriteLocation remains active until [[deactivate]] is called.\r\n   * @param sprite The Sprite to draw at this SpriteLocation\r\n   * @param viewport The Viewport onto which the Sprite is drawn\r\n   * @param locationWorld The position, in world coordinates\r\n   * @param alpha Optional alpha for the Sprite. Must be a number between 0 (fully transparent) and 1 (fully opaque).\r\n   */\r\n  public activate(sprite: Sprite, viewport: ScreenViewport, locationWorld: XYAndZ, alpha?: number): void {\r\n    this._sprite = sprite;\r\n    this._alpha = alpha;\r\n    this._viewport = viewport;\r\n    viewport.worldToView(locationWorld, this.position);\r\n    sprite.loadPromise.then(() => {\r\n      if (this._viewport === viewport) // was this deactivated while we were loading?\r\n        viewport.invalidateDecorations();\r\n    }).catch(() => this._viewport = undefined); // sprite was not loaded properly\r\n  }\r\n\r\n  /** Turn this SpriteLocation off so it will no longer show. */\r\n  public deactivate() {\r\n    if (!this.isActive)\r\n      return;\r\n    this._viewport!.invalidateDecorations();\r\n    this._viewport = undefined;\r\n  }\r\n\r\n  /** Draw this sprite onto the supplied canvas.\r\n   * @see [[CanvasDecoration.drawDecoration]]\r\n   */\r\n  public drawDecoration(ctx: CanvasRenderingContext2D): void {\r\n    const sprite = this._sprite!;\r\n    if (undefined === sprite.image)\r\n      return;\r\n\r\n    if (undefined !== this._alpha)\r\n      ctx.globalAlpha = this._alpha;\r\n\r\n    ctx.drawImage(sprite.image, -sprite.offset.x, -sprite.offset.y);\r\n  }\r\n\r\n  /** If this SpriteLocation is active and the supplied DecorateContext is for its Viewport, add the Sprite to decorations. */\r\n  public decorate(context: DecorateContext) {\r\n    if (context.viewport === this._viewport)\r\n      context.addCanvasDecoration(this);\r\n  }\r\n}\r\n"]}

package/lib/cjs/StandardView.d.ts

@@ -4,6 +4,7 @@
 import { Matrix3d } from "@itwin/core-geometry";
 /** Describes a set of commonly-used view rotations.
  * @public
+ * @extensions
  */
 export declare enum StandardViewId {
     /** Any rotation which does not match one of the standard rotations.

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

@@ -1 +1 @@
-{"version":3,"file":"StandardView.d.ts","sourceRoot":"","sources":["../../src/StandardView.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;GAEG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,WAAW,KAAK;IAChB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;IACT,IAAI,IAAI;IACR,GAAG,IAAI;IACP,QAAQ,IAAI;CACb;AA6BD;;GAEG;AACH,qBAAa,YAAY;IACvB,WAAkB,GAAG,IAAI,QAAQ,CAAyD;IAC1F,WAAkB,MAAM,IAAI,QAAQ,CAA4D;IAChG,WAAkB,IAAI,IAAI,QAAQ,CAA0D;IAC5F,WAAkB,KAAK,IAAI,QAAQ,CAA2D;IAC9F,WAAkB,KAAK,IAAI,QAAQ,CAA2D;IAC9F,WAAkB,IAAI,IAAI,QAAQ,CAA0D;IAC5F,WAAkB,GAAG,IAAI,QAAQ,CAAyD;IAC1F,WAAkB,QAAQ,IAAI,QAAQ,CAA8D;IAEpG;;;OAGG;WACW,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,QAAQ;IAO/D;;;;OAIG;WACW,wBAAwB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;CAS/D"}
+{"version":3,"file":"StandardView.d.ts","sourceRoot":"","sources":["../../src/StandardView.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;;GAGG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,WAAW,KAAK;IAChB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;IACT,IAAI,IAAI;IACR,GAAG,IAAI;IACP,QAAQ,IAAI;CACb;AA6BD;;GAEG;AACH,qBAAa,YAAY;IACvB,WAAkB,GAAG,IAAI,QAAQ,CAAyD;IAC1F,WAAkB,MAAM,IAAI,QAAQ,CAA4D;IAChG,WAAkB,IAAI,IAAI,QAAQ,CAA0D;IAC5F,WAAkB,KAAK,IAAI,QAAQ,CAA2D;IAC9F,WAAkB,KAAK,IAAI,QAAQ,CAA2D;IAC9F,WAAkB,IAAI,IAAI,QAAQ,CAA0D;IAC5F,WAAkB,GAAG,IAAI,QAAQ,CAAyD;IAC1F,WAAkB,QAAQ,IAAI,QAAQ,CAA8D;IAEpG;;;OAGG;WACW,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,QAAQ;IAO/D;;;;OAIG;WACW,wBAAwB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;CAS/D"}

package/lib/cjs/StandardView.js

@@ -11,6 +11,7 @@ exports.StandardView = exports.StandardViewId = void 0;
 const core_geometry_1 = require("@itwin/core-geometry");
 /** Describes a set of commonly-used view rotations.
  * @public
+ * @extensions
  */
 var StandardViewId;
 (function (StandardViewId) {

package/lib/cjs/StandardView.js.map

@@ -1 +1 @@
-{"version":3,"file":"StandardView.js","sourceRoot":"","sources":["../../src/StandardView.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\nimport { Matrix3d } from \"@itwin/core-geometry\";\r\n\r\n/** Describes a set of commonly-used view rotations.\r\n * @public\r\n */\r\nexport enum StandardViewId {\r\n  /** Any rotation which does not match one of the standard rotations.\r\n   * Invalid as an argument to StandardView.getStandardRotation() - used as a return value only.\r\n   */\r\n  NotStandard = -1,\r\n  Top = 0,\r\n  Bottom = 1,\r\n  Left = 2,\r\n  Right = 3,\r\n  Front = 4,\r\n  Back = 5,\r\n  Iso = 6,\r\n  RightIso = 7,\r\n}\r\n\r\nlet standardViewMatrices: Matrix3d[] | undefined;\r\n\r\nfunction getMatrices(): Matrix3d[] {\r\n  if (undefined !== standardViewMatrices)\r\n    return standardViewMatrices;\r\n\r\n  standardViewMatrices = [];\r\n\r\n  standardViewMatrices[StandardViewId.Top] = Matrix3d.identity;\r\n  standardViewMatrices[StandardViewId.Bottom] = Matrix3d.createRowValues(1, 0, 0, 0, -1, 0, 0, 0, -1);\r\n  standardViewMatrices[StandardViewId.Left] = Matrix3d.createRowValues(0, -1, 0, 0, 0, 1, -1, 0, 0);\r\n  standardViewMatrices[StandardViewId.Right] = Matrix3d.createRowValues(0, 1, 0, 0, 0, 1, 1, 0, 0);\r\n  standardViewMatrices[StandardViewId.Front] = Matrix3d.createRowValues(1, 0, 0, 0, 0, 1, 0, -1, 0);\r\n  standardViewMatrices[StandardViewId.Back] = Matrix3d.createRowValues(-1, 0, 0, 0, 0, 1, 0, 1, 0);\r\n  standardViewMatrices[StandardViewId.Iso] = Matrix3d.createRowValues(\r\n    0.707106781186548, -0.70710678118654757, 0.00000000000000000,\r\n    0.408248290463863, 0.40824829046386302, 0.81649658092772603,\r\n    -0.577350269189626, -0.57735026918962573, 0.57735026918962573);\r\n  standardViewMatrices[StandardViewId.RightIso] = Matrix3d.createRowValues(\r\n    0.707106781186548, 0.70710678118654757, 0.00000000000000000,\r\n    -0.408248290463863, 0.40824829046386302, 0.81649658092772603,\r\n    0.577350269189626, -0.57735026918962573, 0.57735026918962573);\r\n\r\n  standardViewMatrices.forEach((mat) => Object.freeze(mat));\r\n  return standardViewMatrices;\r\n}\r\n\r\n/** Supplies access to a set of commonly-used view rotations.\r\n * @public\r\n */\r\nexport class StandardView {\r\n  public static get top(): Matrix3d { return this.getStandardRotation(StandardViewId.Top); }\r\n  public static get bottom(): Matrix3d { return this.getStandardRotation(StandardViewId.Bottom); }\r\n  public static get left(): Matrix3d { return this.getStandardRotation(StandardViewId.Left); }\r\n  public static get right(): Matrix3d { return this.getStandardRotation(StandardViewId.Right); }\r\n  public static get front(): Matrix3d { return this.getStandardRotation(StandardViewId.Front); }\r\n  public static get back(): Matrix3d { return this.getStandardRotation(StandardViewId.Back); }\r\n  public static get iso(): Matrix3d { return this.getStandardRotation(StandardViewId.Iso); }\r\n  public static get rightIso(): Matrix3d { return this.getStandardRotation(StandardViewId.RightIso); }\r\n\r\n  /** Obtain a [[Matrix3d]] corresponding to the specified [[StandardViewId]].\r\n   * @param id The ID of the desired rotation.\r\n   * @return A rotation matrix corresponding to the requested standard view ID, or a \"top\" view rotation if the input does not correspond to a standard rotation.\r\n   */\r\n  public static getStandardRotation(id: StandardViewId): Matrix3d {\r\n    if (id < StandardViewId.Top || id > StandardViewId.RightIso)\r\n      id = StandardViewId.Top;\r\n\r\n    return getMatrices()[id];\r\n  }\r\n\r\n  /** Attempts to adjust the supplied rotation matrix to match the standard view rotation it most closely matches.\r\n   * If a matching standard rotation exists, the input matrix will be modified in-place to precisely match it.\r\n   * Otherwise, the input matrix will be unmodified.\r\n   * @param matrix The rotation matrix to adjust.\r\n   */\r\n  public static adjustToStandardRotation(matrix: Matrix3d): void {\r\n    getMatrices().some((test) => {\r\n      if (test.maxDiff(matrix) > 1.0e-7)\r\n        return false;\r\n\r\n      matrix.setFrom(test);\r\n      return true;\r\n    });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"StandardView.js","sourceRoot":"","sources":["../../src/StandardView.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\nimport { Matrix3d } from \"@itwin/core-geometry\";\r\n\r\n/** Describes a set of commonly-used view rotations.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum StandardViewId {\r\n  /** Any rotation which does not match one of the standard rotations.\r\n   * Invalid as an argument to StandardView.getStandardRotation() - used as a return value only.\r\n   */\r\n  NotStandard = -1,\r\n  Top = 0,\r\n  Bottom = 1,\r\n  Left = 2,\r\n  Right = 3,\r\n  Front = 4,\r\n  Back = 5,\r\n  Iso = 6,\r\n  RightIso = 7,\r\n}\r\n\r\nlet standardViewMatrices: Matrix3d[] | undefined;\r\n\r\nfunction getMatrices(): Matrix3d[] {\r\n  if (undefined !== standardViewMatrices)\r\n    return standardViewMatrices;\r\n\r\n  standardViewMatrices = [];\r\n\r\n  standardViewMatrices[StandardViewId.Top] = Matrix3d.identity;\r\n  standardViewMatrices[StandardViewId.Bottom] = Matrix3d.createRowValues(1, 0, 0, 0, -1, 0, 0, 0, -1);\r\n  standardViewMatrices[StandardViewId.Left] = Matrix3d.createRowValues(0, -1, 0, 0, 0, 1, -1, 0, 0);\r\n  standardViewMatrices[StandardViewId.Right] = Matrix3d.createRowValues(0, 1, 0, 0, 0, 1, 1, 0, 0);\r\n  standardViewMatrices[StandardViewId.Front] = Matrix3d.createRowValues(1, 0, 0, 0, 0, 1, 0, -1, 0);\r\n  standardViewMatrices[StandardViewId.Back] = Matrix3d.createRowValues(-1, 0, 0, 0, 0, 1, 0, 1, 0);\r\n  standardViewMatrices[StandardViewId.Iso] = Matrix3d.createRowValues(\r\n    0.707106781186548, -0.70710678118654757, 0.00000000000000000,\r\n    0.408248290463863, 0.40824829046386302, 0.81649658092772603,\r\n    -0.577350269189626, -0.57735026918962573, 0.57735026918962573);\r\n  standardViewMatrices[StandardViewId.RightIso] = Matrix3d.createRowValues(\r\n    0.707106781186548, 0.70710678118654757, 0.00000000000000000,\r\n    -0.408248290463863, 0.40824829046386302, 0.81649658092772603,\r\n    0.577350269189626, -0.57735026918962573, 0.57735026918962573);\r\n\r\n  standardViewMatrices.forEach((mat) => Object.freeze(mat));\r\n  return standardViewMatrices;\r\n}\r\n\r\n/** Supplies access to a set of commonly-used view rotations.\r\n * @public\r\n */\r\nexport class StandardView {\r\n  public static get top(): Matrix3d { return this.getStandardRotation(StandardViewId.Top); }\r\n  public static get bottom(): Matrix3d { return this.getStandardRotation(StandardViewId.Bottom); }\r\n  public static get left(): Matrix3d { return this.getStandardRotation(StandardViewId.Left); }\r\n  public static get right(): Matrix3d { return this.getStandardRotation(StandardViewId.Right); }\r\n  public static get front(): Matrix3d { return this.getStandardRotation(StandardViewId.Front); }\r\n  public static get back(): Matrix3d { return this.getStandardRotation(StandardViewId.Back); }\r\n  public static get iso(): Matrix3d { return this.getStandardRotation(StandardViewId.Iso); }\r\n  public static get rightIso(): Matrix3d { return this.getStandardRotation(StandardViewId.RightIso); }\r\n\r\n  /** Obtain a [[Matrix3d]] corresponding to the specified [[StandardViewId]].\r\n   * @param id The ID of the desired rotation.\r\n   * @return A rotation matrix corresponding to the requested standard view ID, or a \"top\" view rotation if the input does not correspond to a standard rotation.\r\n   */\r\n  public static getStandardRotation(id: StandardViewId): Matrix3d {\r\n    if (id < StandardViewId.Top || id > StandardViewId.RightIso)\r\n      id = StandardViewId.Top;\r\n\r\n    return getMatrices()[id];\r\n  }\r\n\r\n  /** Attempts to adjust the supplied rotation matrix to match the standard view rotation it most closely matches.\r\n   * If a matching standard rotation exists, the input matrix will be modified in-place to precisely match it.\r\n   * Otherwise, the input matrix will be unmodified.\r\n   * @param matrix The rotation matrix to adjust.\r\n   */\r\n  public static adjustToStandardRotation(matrix: Matrix3d): void {\r\n    getMatrices().some((test) => {\r\n      if (test.maxDiff(matrix) > 1.0e-7)\r\n        return false;\r\n\r\n      matrix.setFrom(test);\r\n      return true;\r\n    });\r\n  }\r\n}\r\n"]}

package/lib/cjs/SubCategoriesCache.d.ts

@@ -1,5 +1,5 @@
 import { Id64Arg, Id64Set, Id64String } from "@itwin/core-bentley";
-import { SubCategoryAppearance } from "@itwin/core-common";
+import { HydrateViewStateRequestProps, HydrateViewStateResponseProps, SubCategoryAppearance, SubCategoryResultRow } from "@itwin/core-common";
 import { IModelConnection } from "./IModelConnection";
 /** A cancelable paginated request for subcategory information.
  * @see SubCategoriesCache
@@ -22,6 +22,7 @@ export declare class SubCategoriesCache {
     private readonly _byCategoryId;
     private readonly _appearances;
     private readonly _imodel;
+    private _missingAtTimeOfPreload;
     constructor(imodel: IModelConnection);
     /** Get the Ids of all subcategories belonging to the category with the specified Id, or undefined if no such information is present. */
     getSubCategories(categoryId: string): Id64Set | undefined;
@@ -33,6 +34,17 @@ export declare class SubCategoriesCache {
      * containing the corresponding promise and the set of categories still to be loaded.
      */
     load(categoryIds: Id64Arg): SubCategoriesRequest | undefined;
+    /**
+     * Populates the notLoadedCategoryIds property of the HydrateViewStateRequestProps.
+     * notLoadedCategoryIds is a subset of categoryIds, filtering out any ids which already have an entry in the cache.
+     */
+    preload(options: HydrateViewStateRequestProps, categoryIds: Id64Arg): void;
+    /**
+     * Populates the SubCategoriesCache using the categoryIdsResult of the HydrateViewStateResponseProps
+     */
+    postload(options: HydrateViewStateResponseProps): void;
+    /** Given categoryIds, return which of these are not cached. */
+    private getMissing;
     clear(): void;
     onIModelConnectionClose(): void;
     private static createSubCategoryAppearance;
@@ -43,12 +55,7 @@ export declare class SubCategoriesCache {
  * @internal
  */
 export declare namespace SubCategoriesCache {
-    interface ResultRow {
-        parentId: Id64String;
-        id: Id64String;
-        appearance: SubCategoryAppearance.Props;
-    }
-    type Result = ResultRow[];
+    type Result = SubCategoryResultRow[];
     class Request {
         private readonly _imodel;
         private readonly _ecsql;

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

@@ -1 +1 @@
-{"version":3,"file":"SubCategoriesCache.d.ts","sourceRoot":"","sources":["../../src/SubCategoriesCache.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAkB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,2BAA2B;IAC3B,MAAM,IAAI,IAAI,CAAC;CAChB;AAID;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;gBAExB,MAAM,EAAE,gBAAgB;IAE3C,wIAAwI;IACjI,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAEhE,wHAAwH;IACjH,wBAAwB,CAAC,aAAa,EAAE,UAAU,GAAG,qBAAqB,GAAG,SAAS;IAE7F;;;;OAIG;IACI,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS;IA6B5D,KAAK,IAAI,IAAI;IAKb,uBAAuB,IAAI,IAAI;IAItC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAQ1C,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,GAAG;CAQZ;AAED;;GAEG;AACH,yBAAiB,kBAAkB,CAAC;IAClC,UAAiB,SAAS;QACxB,QAAQ,EAAE,UAAU,CAAC;QACrB,EAAE,EAAE,UAAU,CAAC;QACf,UAAU,EAAE,qBAAqB,CAAC,KAAK,CAAC;KACzC;IAED,KAAY,MAAM,GAAG,SAAS,EAAE,CAAC;IAEjC,MAAa,OAAO;QAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;QAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;QACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;QACtC,OAAO,CAAC,SAAS,CAAS;QAC1B,OAAO,CAAC,cAAc,CAAK;QAE3B,IAAW,WAAW,YAAsD;oBAEzD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,qBAAqB,SAAM;QAW3F,MAAM;QAEA,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;KA4BrD;IAED,KAAY,SAAS,GAAG,MAAM,IAAI,CAAC;IAEnC,MAAa,UAAU;QACrB,SAAgB,WAAW,EAAE,OAAO,CAAC;QACrC,SAAgB,KAAK,EAAE,SAAS,EAAE,CAAC;oBAEhB,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;KAIzD;IAED;;;;;OAKG;IACH,MAAa,KAAK;QAEhB,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;QAChC,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;QAC7B,SAAS,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;QAC1C,SAAS,CAAC,SAAS,UAAS;QAE5B;;WAEG;QACI,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;QASnF,+CAA+C;QACxC,OAAO,IAAI,IAAI;QAWtB,IAAW,OAAO,IAAI,OAAO,CAE5B;QAED,OAAO,CAAC,WAAW;QAgBnB,OAAO,CAAC,cAAc;QAoCtB,OAAO,CAAC,QAAQ;KAgBjB;CACF"}
+{"version":3,"file":"SubCategoriesCache.d.ts","sourceRoot":"","sources":["../../src/SubCategoriesCache.ts"],"names":[],"mappings":"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"}

package/lib/cjs/SubCategoriesCache.js

@@ -27,14 +27,7 @@ class SubCategoriesCache {
      * containing the corresponding promise and the set of categories still to be loaded.
      */
     load(categoryIds) {
-        let missing;
-        for (const catId of core_bentley_1.Id64.iterable(categoryIds)) {
-            if (undefined === this._byCategoryId.get(catId)) {
-                if (undefined === missing)
-                    missing = new Set();
-                missing.add(catId);
-            }
-        }
+        const missing = this.getMissing(categoryIds);
         if (undefined === missing)
             return undefined;
         const request = new SubCategoriesCache.Request(missing, this._imodel);
@@ -49,6 +42,41 @@ class SubCategoriesCache {
             cancel: () => request.cancel(),
         };
     }
+    /**
+     * Populates the notLoadedCategoryIds property of the HydrateViewStateRequestProps.
+     * notLoadedCategoryIds is a subset of categoryIds, filtering out any ids which already have an entry in the cache.
+     */
+    preload(options, categoryIds) {
+        const missing = this.getMissing(categoryIds);
+        if (undefined === missing)
+            return;
+        this._missingAtTimeOfPreload = missing;
+        options.notLoadedCategoryIds = core_bentley_1.CompressedId64Set.sortAndCompress(missing);
+    }
+    /**
+     * Populates the SubCategoriesCache using the categoryIdsResult of the HydrateViewStateResponseProps
+     */
+    postload(options) {
+        if (options.categoryIdsResult === undefined)
+            return;
+        // missingAtTimeOfPreload shouldn't be undefined if options.categoryIdsResult is defined... but just to be safe we'll check
+        const missing = this._missingAtTimeOfPreload === undefined ? new Set() : this._missingAtTimeOfPreload;
+        this.processResults(options.categoryIdsResult, missing);
+        // clear missing
+        this._missingAtTimeOfPreload = undefined;
+    }
+    /** Given categoryIds, return which of these are not cached. */
+    getMissing(categoryIds) {
+        let missing;
+        for (const catId of core_bentley_1.Id64.iterable(categoryIds)) {
+            if (undefined === this._byCategoryId.get(catId)) {
+                if (undefined === missing)
+                    missing = new Set();
+                missing.add(catId);
+            }
+        }
+        return missing;
+    }
     clear() {
         this._byCategoryId.clear();
         this._appearances.clear();

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, Id64, Id64Arg, Id64Set, Id64String } from \"@itwin/core-bentley\";\r\nimport { QueryRowFormat, SubCategoryAppearance } 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\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    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    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  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  private 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\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 interface ResultRow {\r\n    parentId: Id64String;\r\n    id: Id64String;\r\n    appearance: SubCategoryAppearance.Props;\r\n  }\r\n\r\n  export type Result = ResultRow[];\r\n\r\n  export class Request {\r\n    private readonly _imodel: IModelConnection;\r\n    private readonly _ecsql: string[] = [];\r\n    private readonly _result: Result = [];\r\n    private _canceled = false;\r\n    private _curECSqlIndex = 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 = 200) {\r\n      this._imodel = imodel;\r\n\r\n      const catIds = [...categoryIds];\r\n      while (catIds.length !== 0) {\r\n        const end = (catIds.length > maxCategoriesPerQuery) ? maxCategoriesPerQuery : catIds.length;\r\n        const where = catIds.splice(0, end).join(\",\");\r\n        this._ecsql.push(`SELECT ECInstanceId as id, Parent.Id as parentId, Properties as appearance FROM BisCore.SubCategory WHERE Parent.Id IN (${where})`);\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._curECSqlIndex >= this._ecsql.length) // handle case of empty category Id set...\r\n        return undefined;\r\n\r\n      try {\r\n        const ecsql = this._ecsql[this._curECSqlIndex];\r\n        for await (const row of this._imodel.query(ecsql, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames })) {\r\n          this._result.push(row as ResultRow);\r\n          if (this.wasCanceled)\r\n            return undefined;\r\n        }\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 ECSql query. Dispatch the next if one exists.\r\n      if (++this._curECSqlIndex < this._ecsql.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 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 } from \"@itwin/core-bentley\";\r\nimport { HydrateViewStateRequestProps, HydrateViewStateResponseProps, QueryRowFormat, 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  /**\r\n   * Populates the notLoadedCategoryIds property of the HydrateViewStateRequestProps.\r\n   * notLoadedCategoryIds is a subset of categoryIds, filtering out any ids which already have an entry in the cache.\r\n   */\r\n  public preload(options: HydrateViewStateRequestProps, categoryIds: Id64Arg): void {\r\n    const missing = this.getMissing(categoryIds);\r\n\r\n    if (undefined === missing)\r\n      return;\r\n    this._missingAtTimeOfPreload = missing;\r\n    options.notLoadedCategoryIds = CompressedId64Set.sortAndCompress(missing);\r\n  }\r\n\r\n  /**\r\n   * Populates the SubCategoriesCache using the categoryIdsResult of the HydrateViewStateResponseProps\r\n   */\r\n  public postload(options: HydrateViewStateResponseProps): void {\r\n    if (options.categoryIdsResult === undefined)\r\n      return;\r\n    // missingAtTimeOfPreload shouldn't be undefined if options.categoryIdsResult is defined... but just to be safe we'll check\r\n    const missing = this._missingAtTimeOfPreload === undefined ? new Set<string>() : this._missingAtTimeOfPreload;\r\n    this.processResults(options.categoryIdsResult, missing);\r\n    // clear missing\r\n    this._missingAtTimeOfPreload = undefined;\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    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  private 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\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\r\n  export type Result = SubCategoryResultRow[];\r\n\r\n  export class Request {\r\n    private readonly _imodel: IModelConnection;\r\n    private readonly _ecsql: string[] = [];\r\n    private readonly _result: Result = [];\r\n    private _canceled = false;\r\n    private _curECSqlIndex = 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 = 200) {\r\n      this._imodel = imodel;\r\n\r\n      const catIds = [...categoryIds];\r\n      while (catIds.length !== 0) {\r\n        const end = (catIds.length > maxCategoriesPerQuery) ? maxCategoriesPerQuery : catIds.length;\r\n        const where = catIds.splice(0, end).join(\",\");\r\n        this._ecsql.push(`SELECT ECInstanceId as id, Parent.Id as parentId, Properties as appearance FROM BisCore.SubCategory WHERE Parent.Id IN (${where})`);\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._curECSqlIndex >= this._ecsql.length) // handle case of empty category Id set...\r\n        return undefined;\r\n\r\n      try {\r\n        const ecsql = this._ecsql[this._curECSqlIndex];\r\n        for await (const row of this._imodel.query(ecsql, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames })) {\r\n          this._result.push(row as SubCategoryResultRow);\r\n          if (this.wasCanceled)\r\n            return undefined;\r\n        }\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 ECSql query. Dispatch the next if one exists.\r\n      if (++this._curECSqlIndex < this._ecsql.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 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/TentativePoint.d.ts

@@ -7,7 +7,10 @@ import { HitDetail, HitList, SnapDetail } from "./HitDetail";
 import { BeButtonEvent } from "./tools/Tool";
 import { DecorateContext } from "./ViewContext";
 import { ScreenViewport } from "./Viewport";
-/** @public */
+/**
+ * @public
+ * @extensions
+ */
 export declare class TentativePoint {
     isActive: boolean;
     currSnap?: SnapDetail;

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

@@ -1 +1 @@
-{"version":3,"file":"TentativePoint.d.ts","sourceRoot":"","sources":["../../src/TentativePoint.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,OAAO,EAA0B,UAAU,EAAsB,MAAM,aAAa,CAAC;AAEzG,OAAO,EAAY,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,cAAc;AACd,qBAAa,cAAc;IAClB,QAAQ,UAAS;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,KAAK,kBAAkB,GAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,iBAAiB,CAAC,CAAkC;IACrD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B,aAAa;IACb,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAE3C,yFAAyF;IACzF,IAAW,SAAS,IAAI,OAAO,CAAwC;IAEvE,gFAAgF;IACzE,WAAW,IAAI,UAAU,GAAG,SAAS;IAErC,QAAQ,IAAI,OAAO;IAKnB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAM9B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAW7B,eAAe,IAAI,IAAI;IAYvB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAMvC,aAAa,IAAI,IAAI;IAUrB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS;IAS5D,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAoBtC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;YAiCjC,OAAO;IA0CrB,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAE5B,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;CAiExC"}
+{"version":3,"file":"TentativePoint.d.ts","sourceRoot":"","sources":["../../src/TentativePoint.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,OAAO,EAA0B,UAAU,EAAsB,MAAM,aAAa,CAAC;AAEzG,OAAO,EAAY,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,qBAAa,cAAc;IAClB,QAAQ,UAAS;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,KAAK,kBAAkB,GAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,iBAAiB,CAAC,CAAkC;IACrD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B,aAAa;IACb,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAE3C,yFAAyF;IACzF,IAAW,SAAS,IAAI,OAAO,CAAwC;IAEvE,gFAAgF;IACzE,WAAW,IAAI,UAAU,GAAG,SAAS;IAErC,QAAQ,IAAI,OAAO;IAKnB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAM9B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAW7B,eAAe,IAAI,IAAI;IAYvB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAMvC,aAAa,IAAI,IAAI;IAUrB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS;IAS5D,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAoBtC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;YAiCjC,OAAO;IA0CrB,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAE5B,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;CAiExC"}

package/lib/cjs/TentativePoint.js

@@ -14,7 +14,10 @@ const HitDetail_1 = require("./HitDetail");
 const IModelApp_1 = require("./IModelApp");
 const Tool_1 = require("./tools/Tool");
 const ViewTool_1 = require("./tools/ViewTool");
-/** @public */
+/**
+ * @public
+ * @extensions
+ */
 class TentativePoint {
     constructor() {
         this.isActive = false;

package/lib/cjs/TentativePoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"TentativePoint.js","sourceRoot":"","sources":["../../src/TentativePoint.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 LocatingElements\r\n */\r\n\r\nimport { Point3d } from \"@itwin/core-geometry\";\r\nimport { AccuSnap } from \"./AccuSnap\";\r\nimport { HitListHolder } from \"./ElementLocateManager\";\r\nimport { HitDetail, HitList, HitPriority, HitSource, SnapDetail, SnapHeat, SnapMode } from \"./HitDetail\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { BeButton, BeButtonEvent } from \"./tools/Tool\";\r\nimport { ViewHandleType, ViewManip } from \"./tools/ViewTool\";\r\nimport { DecorateContext } from \"./ViewContext\";\r\nimport { ScreenViewport } from \"./Viewport\";\r\n\r\n/** @public */\r\nexport class TentativePoint {\r\n  public isActive = false;\r\n  public currSnap?: SnapDetail;\r\n  public tpHits?: HitList<HitDetail>;\r\n  private get _hotDistanceInches(): number { return 0.21; }\r\n  private readonly _point: Point3d = new Point3d();\r\n  private readonly _rawPoint: Point3d = new Point3d();\r\n  private readonly _viewPoint: Point3d = new Point3d();\r\n  private _tentativePromise?: Promise<SnapDetail | undefined>;\r\n  public viewport?: ScreenViewport;\r\n\r\n  public onInitialized() { }\r\n  public setHitList(list?: HitList<HitDetail>) { this.tpHits = list; }\r\n\r\n  /** @return true if the tentative point is currently active and snapped to an element. */\r\n  public get isSnapped(): boolean { return undefined !== this.currSnap; }\r\n\r\n  /** @return The current snap path when TentativePoint.isSnapped or undefined. */\r\n  public getCurrSnap(): SnapDetail | undefined { return this.currSnap; }\r\n\r\n  public getPoint(): Point3d {\r\n    const snap = this.currSnap;\r\n    return !snap ? this._point : snap.adjustedPoint;\r\n  }\r\n\r\n  public setPoint(point: Point3d): void {\r\n    this.setCurrSnap(undefined);\r\n    this.tpHits = undefined;\r\n    this._point.setFrom(point);\r\n  }\r\n\r\n  public clear(doErase: boolean): void {\r\n    if (doErase) {\r\n      this.removeTentative();\r\n      IModelApp.accuSnap.synchSnapMode();\r\n    }\r\n    IModelApp.accuSnap.destroy();\r\n    this.isActive = false;\r\n    this.setCurrSnap(undefined);\r\n    this.tpHits = undefined;\r\n  }\r\n\r\n  public removeTentative(): void {\r\n    this._tentativePromise = undefined;\r\n    if (!this.isActive)\r\n      return;\r\n    IModelApp.accuSnap.erase();\r\n    if (this.getCurrSnap())\r\n      IModelApp.viewManager.invalidateDecorationsAllViews();\r\n    else\r\n      this.viewport!.invalidateDecorations();\r\n    this.isActive = false;\r\n  }\r\n\r\n  public setCurrSnap(newSnap?: SnapDetail): void {\r\n    if (newSnap)\r\n      newSnap.setSnapPoint(newSnap.snapPoint, SnapHeat.InRange); // Reset adjustedPoint from pre-located snap and set SnapHeat...\r\n    this.currSnap = newSnap;\r\n  }\r\n\r\n  public showTentative(): void {\r\n    if (this.isSnapped) {\r\n      IModelApp.viewManager.invalidateDecorationsAllViews();\r\n      IModelApp.accuSnap.displayToolTip(this._viewPoint, this.viewport!, undefined); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n    } else {\r\n      this.viewport!.invalidateDecorations();\r\n    }\r\n    this.isActive = true;\r\n  }\r\n\r\n  public getHitAndList(holder: HitListHolder): SnapDetail | undefined {\r\n    const hit = this.currSnap;\r\n    if (hit) {\r\n      holder.setHitList(this.tpHits);\r\n      this.tpHits = undefined;\r\n    }\r\n    return hit;\r\n  }\r\n\r\n  public onButtonEvent(ev: BeButtonEvent): void {\r\n    switch (ev.button) {\r\n      case BeButton.Data:\r\n        if (!ev.isDown)\r\n          return; // cleared on down...\r\n        break;\r\n      case BeButton.Reset:\r\n        if (ev.isDown)\r\n          return; // cleared on up...\r\n        break;\r\n      case BeButton.Middle:\r\n        return;\r\n    }\r\n\r\n    this.removeTentative();\r\n    IModelApp.accuSnap.synchSnapMode();\r\n    this.setCurrSnap(undefined);\r\n    this.tpHits = undefined;\r\n  }\r\n\r\n  public decorate(context: DecorateContext): void {\r\n    const viewport = context.viewport;\r\n    if (!this.isActive || !viewport)\r\n      return;\r\n\r\n    const tpSize = Math.floor(viewport.pixelsPerInch * 0.4) + 0.5;\r\n    const toSizeOutline = tpSize + 1;\r\n    const position = context.viewport.worldToView(this._point); position.x = Math.floor(position.x) + 0.5; position.y = Math.floor(position.y) + 0.5;\r\n    const drawDecoration = (ctx: CanvasRenderingContext2D) => {\r\n      ctx.beginPath();\r\n      ctx.strokeStyle = \"rgba(0,0,0,.5)\";\r\n      ctx.lineWidth = 3;\r\n      ctx.moveTo(-toSizeOutline, 0);\r\n      ctx.lineTo(toSizeOutline, 0);\r\n      ctx.moveTo(0, -toSizeOutline);\r\n      ctx.lineTo(0, toSizeOutline);\r\n      ctx.stroke();\r\n\r\n      ctx.beginPath();\r\n      ctx.strokeStyle = \"white\";\r\n      ctx.lineWidth = 1;\r\n      if (!this.isSnapped) ctx.setLineDash([4, 1]);\r\n      ctx.shadowColor = \"black\";\r\n      ctx.shadowBlur = 5;\r\n      ctx.moveTo(-tpSize, 0);\r\n      ctx.lineTo(tpSize, 0);\r\n      ctx.moveTo(0, -tpSize);\r\n      ctx.lineTo(0, tpSize);\r\n      ctx.stroke();\r\n    };\r\n    context.addCanvasDecoration({ position, drawDecoration });\r\n  }\r\n\r\n  private async getSnap(newSearch: boolean): Promise<SnapDetail | undefined> {\r\n    // Use next hit from previous search when using tentative to cycle through hits...\r\n    let thisHit = (!newSearch && undefined !== this.tpHits ? this.tpHits.getNextHit() : undefined);\r\n\r\n    // Use existing AccuSnap hit list if one exists...\r\n    if (undefined === thisHit) {\r\n      this.tpHits = undefined;\r\n      thisHit = IModelApp.accuSnap.getHitAndList(this);\r\n    }\r\n\r\n    if (undefined === thisHit) {\r\n      // search for elements around the current raw point (search should not be affected by locks!)\r\n      const aperture = (2.0 * this.viewport!.pixelsFromInches(IModelApp.locateManager.apertureInches) / 2.0) + 1.5;\r\n      const options = IModelApp.locateManager.options.clone(); // Copy to avoid changing out from under active Tool...\r\n      const picker = IModelApp.locateManager.picker;\r\n\r\n      options.hitSource = HitSource.TentativeSnap;\r\n      if (0 === picker.doPick(this.viewport!, this._rawPoint, aperture, options))\r\n        return undefined;\r\n\r\n      this.tpHits = picker.getHitList(true);\r\n      thisHit = (undefined !== this.tpHits ? this.tpHits.getNextHit() : undefined);\r\n    } else if (thisHit instanceof SnapDetail) {\r\n      // Make the current AccuSnap the TentativePoint snap...\r\n      return thisHit;\r\n    }\r\n\r\n    if (undefined === thisHit)\r\n      return undefined;\r\n\r\n    const snapModes = IModelApp.accuSnap.getActiveSnapModes(); // Get the list of point snap modes to consider\r\n    if (1 === snapModes.length && SnapMode.Intersection === snapModes[0])\r\n      snapModes.push(SnapMode.Nearest); // Add nearest when doing intersection by itself to support finding extended intersections...\r\n\r\n    const thisSnap = await AccuSnap.requestSnap(thisHit, snapModes, this._hotDistanceInches, IModelApp.accuSnap.keypointDivisor, this.tpHits);\r\n\r\n    if (undefined !== thisSnap)\r\n      IModelApp.accuDraw.onSnap(thisSnap); // AccuDraw can adjust nearest snap to intersection of circle (polar distance lock) or line (axis lock) with snapped to curve...\r\n\r\n    return thisSnap;\r\n  }\r\n\r\n  private static arePointsCloseEnough(pt1: Point3d, pt2: Point3d, pixelDistance: number): boolean { return pt1.distance(pt2) < (pixelDistance + 1.5); }\r\n\r\n  public process(ev: BeButtonEvent): void {\r\n    if (undefined !== this._tentativePromise)\r\n      return;\r\n\r\n    const currTool = IModelApp.toolAdmin.viewTool;\r\n    if (currTool && currTool.inDynamicUpdate)\r\n      return; // trying to tentative snap while view is changing isn't useful...\r\n\r\n    const wasActive = this.isActive;\r\n    this.removeTentative(); // remove the TP cross if it is already on the screen\r\n    const lastPtView = this._viewPoint.clone();\r\n\r\n    this.viewport = ev.viewport!;\r\n    this._point.setFrom(ev.point);\r\n    this._rawPoint.setFrom(ev.rawPoint);\r\n    this._viewPoint.setFrom(ev.viewPoint);\r\n\r\n    const newSearch = (!this.isSnapped || !TentativePoint.arePointsCloseEnough(lastPtView, this._viewPoint, this.viewport.pixelsFromInches(IModelApp.locateManager.apertureInches)));\r\n    const promise = this.getSnap(newSearch);\r\n    this._tentativePromise = promise;\r\n\r\n    promise.then((newSnap) => { // eslint-disable-line @typescript-eslint/no-floating-promises\r\n      // Ignore response if we're no longer interested in this tentative.\r\n      if (this._tentativePromise === promise) {\r\n        this._tentativePromise = undefined;\r\n        this.setCurrSnap(newSnap); // Adopt the snap as current\r\n        IModelApp.accuSnap.clear(); // make sure there's no AccuSnap active after a tentative point (otherwise we continually snap to it).\r\n        if (this.isSnapped)\r\n          this._point.setFrom(this.currSnap!.snapPoint);\r\n        else if (wasActive && newSearch)\r\n          this._point.setFrom(ev.rawPoint);\r\n        this.showTentative(); // show the TP cross\r\n\r\n        if (this.isSnapped) {\r\n          IModelApp.toolAdmin.adjustSnapPoint();\r\n        } else if (IModelApp.accuDraw.isActive) {\r\n          const point = this.getPoint().clone();\r\n          const vp = ev.viewport!;\r\n          if (vp.isSnapAdjustmentRequired) {\r\n            IModelApp.toolAdmin.adjustPointToACS(point, vp, false);\r\n            const hit = new HitDetail(point, vp, HitSource.TentativeSnap, point, \"\", HitPriority.Unknown, 0, 0);\r\n            const snap = new SnapDetail(hit);\r\n            this.setCurrSnap(snap);\r\n            IModelApp.toolAdmin.adjustSnapPoint();\r\n            this.setPoint(this.getPoint());\r\n          } else {\r\n            IModelApp.accuDraw.adjustPoint(point, vp, false);\r\n            const savePoint = point.clone();\r\n            IModelApp.toolAdmin.adjustPointToGrid(point, vp);\r\n            if (!point.isExactEqual(savePoint))\r\n              IModelApp.accuDraw.adjustPoint(point, vp, false);\r\n            this.setPoint(point);\r\n          }\r\n        } else {\r\n          IModelApp.toolAdmin.adjustPoint(this.getPoint(), ev.viewport!);\r\n        }\r\n\r\n        IModelApp.accuDraw.onTentative();\r\n        if (currTool && currTool instanceof ViewManip && currTool.viewHandles.hasHandle(ViewHandleType.TargetCenter))\r\n          currTool.updateTargetCenter(); // Change target center to tentative location...\r\n        else\r\n          IModelApp.toolAdmin.updateDynamics(); // Don't wait for motion to update tool dynamics...\r\n      }\r\n    });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"TentativePoint.js","sourceRoot":"","sources":["../../src/TentativePoint.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,wDAA+C;AAC/C,yCAAsC;AAEtC,2CAAyG;AACzG,2CAAwC;AACxC,uCAAuD;AACvD,+CAA6D;AAI7D;;;GAGG;AACH,MAAa,cAAc;IAA3B;QACS,aAAQ,GAAG,KAAK,CAAC;QAIP,WAAM,GAAY,IAAI,uBAAO,EAAE,CAAC;QAChC,cAAS,GAAY,IAAI,uBAAO,EAAE,CAAC;QACnC,eAAU,GAAY,IAAI,uBAAO,EAAE,CAAC;IA0OvD,CAAC;IA7OC,IAAY,kBAAkB,KAAa,OAAO,IAAI,CAAC,CAAC,CAAC;IAOlD,aAAa,KAAK,CAAC;IACnB,UAAU,CAAC,IAAyB,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAEpE,yFAAyF;IACzF,IAAW,SAAS,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEvE,gFAAgF;IACzE,WAAW,KAA6B,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE/D,QAAQ;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IAClD,CAAC;IAEM,QAAQ,CAAC,KAAc;QAC5B,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAEM,KAAK,CAAC,OAAgB;QAC3B,IAAI,OAAO,EAAE;YACX,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,qBAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;SACpC;QACD,qBAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAEM,eAAe;QACpB,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAChB,OAAO;QACT,qBAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB,qBAAS,CAAC,WAAW,CAAC,6BAA6B,EAAE,CAAC;;YAEtD,IAAI,CAAC,QAAS,CAAC,qBAAqB,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAEM,WAAW,CAAC,OAAoB;QACrC,IAAI,OAAO;YACT,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,gEAAgE;QAC7H,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAEM,aAAa;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,qBAAS,CAAC,WAAW,CAAC,6BAA6B,EAAE,CAAC;YACtD,qBAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAS,EAAE,SAAS,CAAC,CAAC,CAAC,8DAA8D;SAC9I;aAAM;YACL,IAAI,CAAC,QAAS,CAAC,qBAAqB,EAAE,CAAC;SACxC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAEM,aAAa,CAAC,MAAqB;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC1B,IAAI,GAAG,EAAE;YACP,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;SACzB;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEM,aAAa,CAAC,EAAiB;QACpC,QAAQ,EAAE,CAAC,MAAM,EAAE;YACjB,KAAK,eAAQ,CAAC,IAAI;gBAChB,IAAI,CAAC,EAAE,CAAC,MAAM;oBACZ,OAAO,CAAC,qBAAqB;gBAC/B,MAAM;YACR,KAAK,eAAQ,CAAC,KAAK;gBACjB,IAAI,EAAE,CAAC,MAAM;oBACX,OAAO,CAAC,mBAAmB;gBAC7B,MAAM;YACR,KAAK,eAAQ,CAAC,MAAM;gBAClB,OAAO;SACV;QAED,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,qBAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAEM,QAAQ,CAAC,OAAwB;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;YAC7B,OAAO;QAET,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACjJ,MAAM,cAAc,GAAG,CAAC,GAA6B,EAAE,EAAE;YACvD,GAAG,CAAC,SAAS,EAAE,CAAC;YAChB,GAAG,CAAC,WAAW,GAAG,gBAAgB,CAAC;YACnC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;YAClB,GAAG,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YAC9B,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YAC7B,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;YAC9B,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;YAC7B,GAAG,CAAC,MAAM,EAAE,CAAC;YAEb,GAAG,CAAC,SAAS,EAAE,CAAC;YAChB,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;YAC1B,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;YAC1B,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvB,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtB,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACvB,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACtB,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,CAAC,CAAC;QACF,OAAO,CAAC,mBAAmB,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,SAAkB;QACtC,kFAAkF;QAClF,IAAI,OAAO,GAAG,CAAC,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE/F,kDAAkD;QAClD,IAAI,SAAS,KAAK,OAAO,EAAE;YACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,OAAO,GAAG,qBAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;SAClD;QAED,IAAI,SAAS,KAAK,OAAO,EAAE;YACzB,6FAA6F;YAC7F,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,QAAS,CAAC,gBAAgB,CAAC,qBAAS,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YAC7G,MAAM,OAAO,GAAG,qBAAS,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,uDAAuD;YAChH,MAAM,MAAM,GAAG,qBAAS,CAAC,aAAa,CAAC,MAAM,CAAC;YAE9C,OAAO,CAAC,SAAS,GAAG,qBAAS,CAAC,aAAa,CAAC;YAC5C,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;gBACxE,OAAO,SAAS,CAAC;YAEnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SAC9E;aAAM,IAAI,OAAO,YAAY,sBAAU,EAAE;YACxC,uDAAuD;YACvD,OAAO,OAAO,CAAC;SAChB;QAED,IAAI,SAAS,KAAK,OAAO;YACvB,OAAO,SAAS,CAAC;QAEnB,MAAM,SAAS,GAAG,qBAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC,+CAA+C;QAC1G,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,IAAI,oBAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC;YAClE,SAAS,CAAC,IAAI,CAAC,oBAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,6FAA6F;QAEjI,MAAM,QAAQ,GAAG,MAAM,mBAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,kBAAkB,EAAE,qBAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1I,IAAI,SAAS,KAAK,QAAQ;YACxB,qBAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,gIAAgI;QAEvK,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,oBAAoB,CAAC,GAAY,EAAE,GAAY,EAAE,aAAqB,IAAa,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAE9I,OAAO,CAAC,EAAiB;QAC9B,IAAI,SAAS,KAAK,IAAI,CAAC,iBAAiB;YACtC,OAAO;QAET,MAAM,QAAQ,GAAG,qBAAS,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC9C,IAAI,QAAQ,IAAI,QAAQ,CAAC,eAAe;YACtC,OAAO,CAAC,kEAAkE;QAE5E,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,qDAAqD;QAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAE3C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,QAAS,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,qBAAS,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACjL,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;QAEjC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACvB,mEAAmE;YACnE,IAAI,IAAI,CAAC,iBAAiB,KAAK,OAAO,EAAE;gBACtC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;gBACnC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B;gBACvD,qBAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,sGAAsG;gBAClI,IAAI,IAAI,CAAC,SAAS;oBAChB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAS,CAAC,SAAS,CAAC,CAAC;qBAC3C,IAAI,SAAS,IAAI,SAAS;oBAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,oBAAoB;gBAE1C,IAAI,IAAI,CAAC,SAAS,EAAE;oBAClB,qBAAS,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;iBACvC;qBAAM,IAAI,qBAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE;oBACtC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC;oBACtC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAS,CAAC;oBACxB,IAAI,EAAE,CAAC,wBAAwB,EAAE;wBAC/B,qBAAS,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;wBACvD,MAAM,GAAG,GAAG,IAAI,qBAAS,CAAC,KAAK,EAAE,EAAE,EAAE,qBAAS,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,uBAAW,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;wBACpG,MAAM,IAAI,GAAG,IAAI,sBAAU,CAAC,GAAG,CAAC,CAAC;wBACjC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;wBACvB,qBAAS,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;wBACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;qBAChC;yBAAM;wBACL,qBAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;wBACjD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;wBAChC,qBAAS,CAAC,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACjD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC;4BAChC,qBAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;wBACnD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;qBACtB;iBACF;qBAAM;oBACL,qBAAS,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAS,CAAC,CAAC;iBAChE;gBAED,qBAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,QAAQ,IAAI,QAAQ,YAAY,oBAAS,IAAI,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,yBAAc,CAAC,YAAY,CAAC;oBAC1G,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC,gDAAgD;;oBAE/E,qBAAS,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,mDAAmD;aAC5F;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAjPD,wCAiPC","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 LocatingElements\r\n */\r\n\r\nimport { Point3d } from \"@itwin/core-geometry\";\r\nimport { AccuSnap } from \"./AccuSnap\";\r\nimport { HitListHolder } from \"./ElementLocateManager\";\r\nimport { HitDetail, HitList, HitPriority, HitSource, SnapDetail, SnapHeat, SnapMode } from \"./HitDetail\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { BeButton, BeButtonEvent } from \"./tools/Tool\";\r\nimport { ViewHandleType, ViewManip } from \"./tools/ViewTool\";\r\nimport { DecorateContext } from \"./ViewContext\";\r\nimport { ScreenViewport } from \"./Viewport\";\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport class TentativePoint {\r\n  public isActive = false;\r\n  public currSnap?: SnapDetail;\r\n  public tpHits?: HitList<HitDetail>;\r\n  private get _hotDistanceInches(): number { return 0.21; }\r\n  private readonly _point: Point3d = new Point3d();\r\n  private readonly _rawPoint: Point3d = new Point3d();\r\n  private readonly _viewPoint: Point3d = new Point3d();\r\n  private _tentativePromise?: Promise<SnapDetail | undefined>;\r\n  public viewport?: ScreenViewport;\r\n\r\n  public onInitialized() { }\r\n  public setHitList(list?: HitList<HitDetail>) { this.tpHits = list; }\r\n\r\n  /** @return true if the tentative point is currently active and snapped to an element. */\r\n  public get isSnapped(): boolean { return undefined !== this.currSnap; }\r\n\r\n  /** @return The current snap path when TentativePoint.isSnapped or undefined. */\r\n  public getCurrSnap(): SnapDetail | undefined { return this.currSnap; }\r\n\r\n  public getPoint(): Point3d {\r\n    const snap = this.currSnap;\r\n    return !snap ? this._point : snap.adjustedPoint;\r\n  }\r\n\r\n  public setPoint(point: Point3d): void {\r\n    this.setCurrSnap(undefined);\r\n    this.tpHits = undefined;\r\n    this._point.setFrom(point);\r\n  }\r\n\r\n  public clear(doErase: boolean): void {\r\n    if (doErase) {\r\n      this.removeTentative();\r\n      IModelApp.accuSnap.synchSnapMode();\r\n    }\r\n    IModelApp.accuSnap.destroy();\r\n    this.isActive = false;\r\n    this.setCurrSnap(undefined);\r\n    this.tpHits = undefined;\r\n  }\r\n\r\n  public removeTentative(): void {\r\n    this._tentativePromise = undefined;\r\n    if (!this.isActive)\r\n      return;\r\n    IModelApp.accuSnap.erase();\r\n    if (this.getCurrSnap())\r\n      IModelApp.viewManager.invalidateDecorationsAllViews();\r\n    else\r\n      this.viewport!.invalidateDecorations();\r\n    this.isActive = false;\r\n  }\r\n\r\n  public setCurrSnap(newSnap?: SnapDetail): void {\r\n    if (newSnap)\r\n      newSnap.setSnapPoint(newSnap.snapPoint, SnapHeat.InRange); // Reset adjustedPoint from pre-located snap and set SnapHeat...\r\n    this.currSnap = newSnap;\r\n  }\r\n\r\n  public showTentative(): void {\r\n    if (this.isSnapped) {\r\n      IModelApp.viewManager.invalidateDecorationsAllViews();\r\n      IModelApp.accuSnap.displayToolTip(this._viewPoint, this.viewport!, undefined); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n    } else {\r\n      this.viewport!.invalidateDecorations();\r\n    }\r\n    this.isActive = true;\r\n  }\r\n\r\n  public getHitAndList(holder: HitListHolder): SnapDetail | undefined {\r\n    const hit = this.currSnap;\r\n    if (hit) {\r\n      holder.setHitList(this.tpHits);\r\n      this.tpHits = undefined;\r\n    }\r\n    return hit;\r\n  }\r\n\r\n  public onButtonEvent(ev: BeButtonEvent): void {\r\n    switch (ev.button) {\r\n      case BeButton.Data:\r\n        if (!ev.isDown)\r\n          return; // cleared on down...\r\n        break;\r\n      case BeButton.Reset:\r\n        if (ev.isDown)\r\n          return; // cleared on up...\r\n        break;\r\n      case BeButton.Middle:\r\n        return;\r\n    }\r\n\r\n    this.removeTentative();\r\n    IModelApp.accuSnap.synchSnapMode();\r\n    this.setCurrSnap(undefined);\r\n    this.tpHits = undefined;\r\n  }\r\n\r\n  public decorate(context: DecorateContext): void {\r\n    const viewport = context.viewport;\r\n    if (!this.isActive || !viewport)\r\n      return;\r\n\r\n    const tpSize = Math.floor(viewport.pixelsPerInch * 0.4) + 0.5;\r\n    const toSizeOutline = tpSize + 1;\r\n    const position = context.viewport.worldToView(this._point); position.x = Math.floor(position.x) + 0.5; position.y = Math.floor(position.y) + 0.5;\r\n    const drawDecoration = (ctx: CanvasRenderingContext2D) => {\r\n      ctx.beginPath();\r\n      ctx.strokeStyle = \"rgba(0,0,0,.5)\";\r\n      ctx.lineWidth = 3;\r\n      ctx.moveTo(-toSizeOutline, 0);\r\n      ctx.lineTo(toSizeOutline, 0);\r\n      ctx.moveTo(0, -toSizeOutline);\r\n      ctx.lineTo(0, toSizeOutline);\r\n      ctx.stroke();\r\n\r\n      ctx.beginPath();\r\n      ctx.strokeStyle = \"white\";\r\n      ctx.lineWidth = 1;\r\n      if (!this.isSnapped) ctx.setLineDash([4, 1]);\r\n      ctx.shadowColor = \"black\";\r\n      ctx.shadowBlur = 5;\r\n      ctx.moveTo(-tpSize, 0);\r\n      ctx.lineTo(tpSize, 0);\r\n      ctx.moveTo(0, -tpSize);\r\n      ctx.lineTo(0, tpSize);\r\n      ctx.stroke();\r\n    };\r\n    context.addCanvasDecoration({ position, drawDecoration });\r\n  }\r\n\r\n  private async getSnap(newSearch: boolean): Promise<SnapDetail | undefined> {\r\n    // Use next hit from previous search when using tentative to cycle through hits...\r\n    let thisHit = (!newSearch && undefined !== this.tpHits ? this.tpHits.getNextHit() : undefined);\r\n\r\n    // Use existing AccuSnap hit list if one exists...\r\n    if (undefined === thisHit) {\r\n      this.tpHits = undefined;\r\n      thisHit = IModelApp.accuSnap.getHitAndList(this);\r\n    }\r\n\r\n    if (undefined === thisHit) {\r\n      // search for elements around the current raw point (search should not be affected by locks!)\r\n      const aperture = (2.0 * this.viewport!.pixelsFromInches(IModelApp.locateManager.apertureInches) / 2.0) + 1.5;\r\n      const options = IModelApp.locateManager.options.clone(); // Copy to avoid changing out from under active Tool...\r\n      const picker = IModelApp.locateManager.picker;\r\n\r\n      options.hitSource = HitSource.TentativeSnap;\r\n      if (0 === picker.doPick(this.viewport!, this._rawPoint, aperture, options))\r\n        return undefined;\r\n\r\n      this.tpHits = picker.getHitList(true);\r\n      thisHit = (undefined !== this.tpHits ? this.tpHits.getNextHit() : undefined);\r\n    } else if (thisHit instanceof SnapDetail) {\r\n      // Make the current AccuSnap the TentativePoint snap...\r\n      return thisHit;\r\n    }\r\n\r\n    if (undefined === thisHit)\r\n      return undefined;\r\n\r\n    const snapModes = IModelApp.accuSnap.getActiveSnapModes(); // Get the list of point snap modes to consider\r\n    if (1 === snapModes.length && SnapMode.Intersection === snapModes[0])\r\n      snapModes.push(SnapMode.Nearest); // Add nearest when doing intersection by itself to support finding extended intersections...\r\n\r\n    const thisSnap = await AccuSnap.requestSnap(thisHit, snapModes, this._hotDistanceInches, IModelApp.accuSnap.keypointDivisor, this.tpHits);\r\n\r\n    if (undefined !== thisSnap)\r\n      IModelApp.accuDraw.onSnap(thisSnap); // AccuDraw can adjust nearest snap to intersection of circle (polar distance lock) or line (axis lock) with snapped to curve...\r\n\r\n    return thisSnap;\r\n  }\r\n\r\n  private static arePointsCloseEnough(pt1: Point3d, pt2: Point3d, pixelDistance: number): boolean { return pt1.distance(pt2) < (pixelDistance + 1.5); }\r\n\r\n  public process(ev: BeButtonEvent): void {\r\n    if (undefined !== this._tentativePromise)\r\n      return;\r\n\r\n    const currTool = IModelApp.toolAdmin.viewTool;\r\n    if (currTool && currTool.inDynamicUpdate)\r\n      return; // trying to tentative snap while view is changing isn't useful...\r\n\r\n    const wasActive = this.isActive;\r\n    this.removeTentative(); // remove the TP cross if it is already on the screen\r\n    const lastPtView = this._viewPoint.clone();\r\n\r\n    this.viewport = ev.viewport!;\r\n    this._point.setFrom(ev.point);\r\n    this._rawPoint.setFrom(ev.rawPoint);\r\n    this._viewPoint.setFrom(ev.viewPoint);\r\n\r\n    const newSearch = (!this.isSnapped || !TentativePoint.arePointsCloseEnough(lastPtView, this._viewPoint, this.viewport.pixelsFromInches(IModelApp.locateManager.apertureInches)));\r\n    const promise = this.getSnap(newSearch);\r\n    this._tentativePromise = promise;\r\n\r\n    promise.then((newSnap) => { // eslint-disable-line @typescript-eslint/no-floating-promises\r\n      // Ignore response if we're no longer interested in this tentative.\r\n      if (this._tentativePromise === promise) {\r\n        this._tentativePromise = undefined;\r\n        this.setCurrSnap(newSnap); // Adopt the snap as current\r\n        IModelApp.accuSnap.clear(); // make sure there's no AccuSnap active after a tentative point (otherwise we continually snap to it).\r\n        if (this.isSnapped)\r\n          this._point.setFrom(this.currSnap!.snapPoint);\r\n        else if (wasActive && newSearch)\r\n          this._point.setFrom(ev.rawPoint);\r\n        this.showTentative(); // show the TP cross\r\n\r\n        if (this.isSnapped) {\r\n          IModelApp.toolAdmin.adjustSnapPoint();\r\n        } else if (IModelApp.accuDraw.isActive) {\r\n          const point = this.getPoint().clone();\r\n          const vp = ev.viewport!;\r\n          if (vp.isSnapAdjustmentRequired) {\r\n            IModelApp.toolAdmin.adjustPointToACS(point, vp, false);\r\n            const hit = new HitDetail(point, vp, HitSource.TentativeSnap, point, \"\", HitPriority.Unknown, 0, 0);\r\n            const snap = new SnapDetail(hit);\r\n            this.setCurrSnap(snap);\r\n            IModelApp.toolAdmin.adjustSnapPoint();\r\n            this.setPoint(this.getPoint());\r\n          } else {\r\n            IModelApp.accuDraw.adjustPoint(point, vp, false);\r\n            const savePoint = point.clone();\r\n            IModelApp.toolAdmin.adjustPointToGrid(point, vp);\r\n            if (!point.isExactEqual(savePoint))\r\n              IModelApp.accuDraw.adjustPoint(point, vp, false);\r\n            this.setPoint(point);\r\n          }\r\n        } else {\r\n          IModelApp.toolAdmin.adjustPoint(this.getPoint(), ev.viewport!);\r\n        }\r\n\r\n        IModelApp.accuDraw.onTentative();\r\n        if (currTool && currTool instanceof ViewManip && currTool.viewHandles.hasHandle(ViewHandleType.TargetCenter))\r\n          currTool.updateTargetCenter(); // Change target center to tentative location...\r\n        else\r\n          IModelApp.toolAdmin.updateDynamics(); // Don't wait for motion to update tool dynamics...\r\n      }\r\n    });\r\n  }\r\n}\r\n"]}

package/lib/cjs/Tiles.d.ts

@@ -10,6 +10,7 @@ import { TileTree, TileTreeOwner, TileTreeSupplier } from "./tile/internal";
  * change.
  * @see [[IModelConnection.tiles]].
  * @public
+ * @extensions
  */
 export declare class Tiles implements Iterable<{
     supplier: TileTreeSupplier;

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

@@ -1 +1 @@
-{"version":3,"file":"Tiles.d.ts","sourceRoot":"","sources":["../../src/Tiles.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAuB,SAAS,EAAE,UAAU,EAAgB,MAAM,qBAAqB,CAAC;AAE5G,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAsB,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAyDhG;;;;;;GAMG;AACH,qBAAa,KAAM,YAAW,QAAQ,CAAC;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;IACnG,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2D;IAC5F,OAAO,CAAC,SAAS,CAAS;IAE1B,gBAAgB;IAChB,IAAW,UAAU,YAA6B;IAElD,gBAAgB;gBACJ,MAAM,EAAE,gBAAgB;IAiBpC,gBAAgB;IACT,OAAO,IAAI,IAAI;IAKtB;;OAEG;IACI,KAAK,IAAI,IAAI;IAOpB,gBAAgB;IACH,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,OAAO,CAAC,iCAAiC;IASzC;;;;;;OAMG;IACU,uBAAuB,CAAC,qBAAqB,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAIxE,eAAe;IAS7B,OAAO,CAAC,gBAAgB;IASxB;;;OAGG;IACI,gBAAgB,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,GAAG,aAAa;IAgB3E,8HAA8H;IACvH,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IASrD,uDAAuD;IAChD,gBAAgB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAKnE,8CAA8C;IACrC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,EAAE,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IAOrG,oEAAoE;IAC7D,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,CAAC;QAAE,EAAE,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IAYxG;;OAEG;IACI,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI;CAYpE"}
+{"version":3,"file":"Tiles.d.ts","sourceRoot":"","sources":["../../src/Tiles.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAuB,SAAS,EAAE,UAAU,EAAgB,MAAM,qBAAqB,CAAC;AAE5G,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAsB,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAyDhG;;;;;;;GAOG;AACH,qBAAa,KAAM,YAAW,QAAQ,CAAC;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;IACnG,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2D;IAC5F,OAAO,CAAC,SAAS,CAAS;IAE1B,gBAAgB;IAChB,IAAW,UAAU,YAA6B;IAElD,gBAAgB;gBACJ,MAAM,EAAE,gBAAgB;IAiBpC,gBAAgB;IACT,OAAO,IAAI,IAAI;IAKtB;;OAEG;IACI,KAAK,IAAI,IAAI;IAOpB,gBAAgB;IACH,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,OAAO,CAAC,iCAAiC;IASzC;;;;;;OAMG;IACU,uBAAuB,CAAC,qBAAqB,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAIxE,eAAe;IAS7B,OAAO,CAAC,gBAAgB;IASxB;;;OAGG;IACI,gBAAgB,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,GAAG,aAAa;IAgB3E,8HAA8H;IACvH,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IASrD,uDAAuD;IAChD,gBAAgB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAKnE,8CAA8C;IACrC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,EAAE,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IAOrG,oEAAoE;IAC7D,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,CAAC;QAAE,EAAE,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IAYxG;;OAEG;IACI,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI;CAYpE"}

package/lib/cjs/Tiles.js

@@ -59,6 +59,7 @@ class TreeOwner {
  * change.
  * @see [[IModelConnection.tiles]].
  * @public
+ * @extensions
  */
 class Tiles {
     /** @internal */

package/lib/cjs/Tiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tiles.js","sourceRoot":"","sources":["../../src/Tiles.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 IModelConnection\r\n */\r\n\r\nimport { BeTimePoint, Dictionary, dispose, Id64Array, Id64String, IModelStatus } from \"@itwin/core-bentley\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\nimport { TileTree, TileTreeLoadStatus, TileTreeOwner, TileTreeSupplier } from \"./tile/internal\";\r\n\r\nclass TreeOwner implements TileTreeOwner {\r\n  private _tileTree?: TileTree;\r\n  private _loadStatus: TileTreeLoadStatus = TileTreeLoadStatus.NotLoaded;\r\n  private readonly _supplier: TileTreeSupplier;\r\n  private readonly _iModel: IModelConnection;\r\n\r\n  public readonly id: any;\r\n\r\n  public get tileTree(): TileTree | undefined { return this._tileTree; }\r\n  public get loadStatus(): TileTreeLoadStatus { return this._loadStatus; }\r\n  public get iModel(): IModelConnection { return this._iModel; }\r\n\r\n  public constructor(id: any, supplier: TileTreeSupplier, iModel: IModelConnection) {\r\n    this.id = id;\r\n    this._supplier = supplier;\r\n    this._iModel = iModel;\r\n  }\r\n\r\n  public load(): TileTree | undefined {\r\n    this._load(); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n    return this.tileTree;\r\n  }\r\n\r\n  public async loadTree(): Promise<TileTree | undefined> {\r\n    await this._load();\r\n    return this.tileTree;\r\n  }\r\n\r\n  public dispose(): void {\r\n    this._tileTree = dispose(this._tileTree);\r\n    this._loadStatus = TileTreeLoadStatus.NotLoaded;\r\n  }\r\n\r\n  private async _load(): Promise<void> {\r\n    if (TileTreeLoadStatus.NotLoaded !== this.loadStatus)\r\n      return;\r\n\r\n    this._loadStatus = TileTreeLoadStatus.Loading;\r\n    let tree: TileTree | undefined;\r\n    let newStatus: TileTreeLoadStatus;\r\n    try {\r\n      tree = await this._supplier.createTileTree(this.id, this._iModel);\r\n      newStatus = undefined !== tree && !tree.rootTile.contentRange.isNull ? TileTreeLoadStatus.Loaded : TileTreeLoadStatus.NotFound;\r\n    } catch (err: any) {\r\n      newStatus = (err.errorNumber && err.errorNumber === IModelStatus.ServerTimeout) ? TileTreeLoadStatus.NotLoaded : TileTreeLoadStatus.NotFound;\r\n    }\r\n\r\n    if (TileTreeLoadStatus.Loading === this._loadStatus) {\r\n      this._tileTree = tree;\r\n      this._loadStatus = newStatus;\r\n      IModelApp.tileAdmin.onTileTreeLoad.raiseEvent(this);\r\n    }\r\n  }\r\n}\r\n\r\n/** Provides access to [[TileTree]]s associated with an [[IModelConnection]].\r\n * The tile trees are accessed indirectly via their corresponding [[TileTreeOwner]]s.\r\n * Loaded tile trees will be discarded after the iModel is closed, after a period of disuse, or when the contents of a [[GeometricModelState]] they represent\r\n * change.\r\n * @see [[IModelConnection.tiles]].\r\n * @public\r\n */\r\nexport class Tiles implements Iterable<{ supplier: TileTreeSupplier, id: any, owner: TileTreeOwner }> {\r\n  private _iModel: IModelConnection;\r\n  private readonly _treesBySupplier = new Map<TileTreeSupplier, Dictionary<any, TreeOwner>>();\r\n  private _disposed = false;\r\n\r\n  /** @internal */\r\n  public get isDisposed() { return this._disposed; }\r\n\r\n  /** @internal */\r\n  constructor(iModel: IModelConnection) {\r\n    this._iModel = iModel;\r\n\r\n    iModel.onEcefLocationChanged.addListener(() => {\r\n      for (const supplier of this._treesBySupplier.keys()) {\r\n        if (supplier.isEcefDependent)\r\n          this.dropSupplier(supplier);\r\n      }\r\n    });\r\n\r\n    // When project extents change, purge tile trees for spatial models.\r\n    iModel.onProjectExtentsChanged.addListener(async () => {\r\n      if (!iModel.isBriefcaseConnection() || !iModel.editingScope)\r\n        await this.purgeModelTrees(this.getSpatialModels());\r\n    });\r\n  }\r\n\r\n  /** @internal */\r\n  public dispose(): void {\r\n    this.reset();\r\n    this._disposed = true;\r\n  }\r\n\r\n  /** Intended strictly for tests.\r\n   * @internal\r\n   */\r\n  public reset(): void {\r\n    for (const supplier of this._treesBySupplier)\r\n      supplier[1].forEach((_key, value) => value.dispose());\r\n\r\n    this._treesBySupplier.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  public async purgeTileTrees(modelIds: Id64Array | undefined): Promise<void> {\r\n    return IModelApp.tileAdmin.purgeTileTrees(this._iModel, modelIds);\r\n  }\r\n\r\n  private getModelsAnimatedByScheduleScript(scriptSourceElementId: Id64String): Set<Id64String> {\r\n    const modelIds = new Set<Id64String>();\r\n    for (const supplier of this._treesBySupplier.keys())\r\n      if (supplier.addModelsAnimatedByScript)\r\n        supplier.addModelsAnimatedByScript(modelIds, scriptSourceElementId, this.getTreeOwnersForSupplier(supplier));\r\n\r\n    return modelIds;\r\n  }\r\n\r\n  /** Update the [[Tile]]s for any [[TileTree]]s that use the [RenderSchedule.Script]($common) hosted by the specified\r\n   * [RenderTimeline]($backend) or [DisplayStyle]($backend) element. This method should be invoked after\r\n   * the host element is updated in the database with a new script, so that any [[Viewport]]s displaying tiles produced\r\n   * based on the previous version of the script are updated to use the new version of the script.\r\n   * @param scriptSourceElementId The Id of the RenderTimeline or DisplayStyle element that hosts the script.\r\n   * @public\r\n   */\r\n  public async updateForScheduleScript(scriptSourceElementId: Id64String): Promise<void> {\r\n    return this.purgeModelTrees(this.getModelsAnimatedByScheduleScript(scriptSourceElementId));\r\n  }\r\n\r\n  private async purgeModelTrees(modelIds: Set<Id64String>): Promise<void> {\r\n    if (0 === modelIds.size)\r\n      return;\r\n\r\n    const ids = Array.from(modelIds);\r\n    await this.purgeTileTrees(ids);\r\n    IModelApp.viewManager.refreshForModifiedModels(ids);\r\n  }\r\n\r\n  private getSpatialModels(): Set<Id64String> {\r\n    const modelIds = new Set<Id64String>();\r\n    for (const supplier of this._treesBySupplier.keys())\r\n      if (supplier.addSpatialModels)\r\n        supplier.addSpatialModels(modelIds, this.getTreeOwnersForSupplier(supplier));\r\n\r\n    return modelIds;\r\n  }\r\n\r\n  /** Obtain the owner of a TileTree.\r\n   * The `id` is unique within all tile trees associated with `supplier`; its specific structure is an implementation detail known only to the supplier.\r\n   * A [[TileTreeReference]] uses this method to obtain the tile tree to which it refers.\r\n   */\r\n  public getTileTreeOwner(id: any, supplier: TileTreeSupplier): TileTreeOwner {\r\n    let trees = this._treesBySupplier.get(supplier);\r\n    if (undefined === trees) {\r\n      trees = new Dictionary<any, TreeOwner>((lhs, rhs) => supplier.compareTileTreeIds(lhs, rhs));\r\n      this._treesBySupplier.set(supplier, trees);\r\n    }\r\n\r\n    let tree = trees.get(id);\r\n    if (undefined === tree) {\r\n      tree = new TreeOwner(id, supplier, this._iModel);\r\n      trees.set(id, tree);\r\n    }\r\n\r\n    return tree;\r\n  }\r\n\r\n  /** Disposes of all [[TileTree]]s belonging to `supplier` and removes `supplier` from the set of known tile tree suppliers. */\r\n  public dropSupplier(supplier: TileTreeSupplier): void {\r\n    const trees = this._treesBySupplier.get(supplier);\r\n    if (undefined === trees)\r\n      return;\r\n\r\n    trees.forEach((_key, value) => value.dispose());\r\n    this._treesBySupplier.delete(supplier);\r\n  }\r\n\r\n  /** Invokes a function on each extant TileTreeOwner. */\r\n  public forEachTreeOwner(func: (owner: TileTreeOwner) => void): void {\r\n    for (const dict of this._treesBySupplier.values())\r\n      dict.forEach((_key, value) => func(value));\r\n  }\r\n\r\n  /** Iterate over all of the TileTreeOwners. */\r\n  public * [Symbol.iterator](): Iterator<{ supplier: TileTreeSupplier, id: any, owner: TileTreeOwner }> {\r\n    for (const [supplier, dict] of this._treesBySupplier) {\r\n      for (const entry of dict)\r\n        yield { supplier, id: entry.key, owner: entry.value };\r\n    }\r\n  }\r\n\r\n  /** Obtain the TileTreeOwners supplied by the specified supplier. */\r\n  public getTreeOwnersForSupplier(supplier: TileTreeSupplier): Iterable<{ id: any, owner: TileTreeOwner }> {\r\n    function* iterator(trees: Dictionary<any, TreeOwner> | undefined) {\r\n      if (trees)\r\n        for (const entry of trees)\r\n          yield { id: entry.key, owner: entry.value };\r\n    }\r\n\r\n    return {\r\n      [Symbol.iterator]: () => iterator(this._treesBySupplier.get(supplier)),\r\n    };\r\n  }\r\n\r\n  /** Unload any tile trees which have not been drawn since at least the specified time, excluding any of the specified TileTrees.\r\n   * @internal\r\n   */\r\n  public purge(olderThan: BeTimePoint, exclude?: Set<TileTree>): void {\r\n    // NB: It would be nice to be able to detect completely useless leftover Owners or Suppliers, but we can't know if any TileTreeReferences exist pointing to a given Owner.\r\n    for (const entry of this._treesBySupplier) {\r\n      const dict = entry[1];\r\n      dict.forEach((_treeId, owner) => {\r\n        const tree = owner.tileTree;\r\n        if (undefined !== tree && tree.lastSelectedTime.milliseconds < olderThan.milliseconds)\r\n          if (undefined === exclude || !exclude.has(tree))\r\n            owner.dispose();\r\n      });\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Tiles.js","sourceRoot":"","sources":["../../src/Tiles.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 IModelConnection\r\n */\r\n\r\nimport { BeTimePoint, Dictionary, dispose, Id64Array, Id64String, IModelStatus } from \"@itwin/core-bentley\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\nimport { TileTree, TileTreeLoadStatus, TileTreeOwner, TileTreeSupplier } from \"./tile/internal\";\r\n\r\nclass TreeOwner implements TileTreeOwner {\r\n  private _tileTree?: TileTree;\r\n  private _loadStatus: TileTreeLoadStatus = TileTreeLoadStatus.NotLoaded;\r\n  private readonly _supplier: TileTreeSupplier;\r\n  private readonly _iModel: IModelConnection;\r\n\r\n  public readonly id: any;\r\n\r\n  public get tileTree(): TileTree | undefined { return this._tileTree; }\r\n  public get loadStatus(): TileTreeLoadStatus { return this._loadStatus; }\r\n  public get iModel(): IModelConnection { return this._iModel; }\r\n\r\n  public constructor(id: any, supplier: TileTreeSupplier, iModel: IModelConnection) {\r\n    this.id = id;\r\n    this._supplier = supplier;\r\n    this._iModel = iModel;\r\n  }\r\n\r\n  public load(): TileTree | undefined {\r\n    this._load(); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n    return this.tileTree;\r\n  }\r\n\r\n  public async loadTree(): Promise<TileTree | undefined> {\r\n    await this._load();\r\n    return this.tileTree;\r\n  }\r\n\r\n  public dispose(): void {\r\n    this._tileTree = dispose(this._tileTree);\r\n    this._loadStatus = TileTreeLoadStatus.NotLoaded;\r\n  }\r\n\r\n  private async _load(): Promise<void> {\r\n    if (TileTreeLoadStatus.NotLoaded !== this.loadStatus)\r\n      return;\r\n\r\n    this._loadStatus = TileTreeLoadStatus.Loading;\r\n    let tree: TileTree | undefined;\r\n    let newStatus: TileTreeLoadStatus;\r\n    try {\r\n      tree = await this._supplier.createTileTree(this.id, this._iModel);\r\n      newStatus = undefined !== tree && !tree.rootTile.contentRange.isNull ? TileTreeLoadStatus.Loaded : TileTreeLoadStatus.NotFound;\r\n    } catch (err: any) {\r\n      newStatus = (err.errorNumber && err.errorNumber === IModelStatus.ServerTimeout) ? TileTreeLoadStatus.NotLoaded : TileTreeLoadStatus.NotFound;\r\n    }\r\n\r\n    if (TileTreeLoadStatus.Loading === this._loadStatus) {\r\n      this._tileTree = tree;\r\n      this._loadStatus = newStatus;\r\n      IModelApp.tileAdmin.onTileTreeLoad.raiseEvent(this);\r\n    }\r\n  }\r\n}\r\n\r\n/** Provides access to [[TileTree]]s associated with an [[IModelConnection]].\r\n * The tile trees are accessed indirectly via their corresponding [[TileTreeOwner]]s.\r\n * Loaded tile trees will be discarded after the iModel is closed, after a period of disuse, or when the contents of a [[GeometricModelState]] they represent\r\n * change.\r\n * @see [[IModelConnection.tiles]].\r\n * @public\r\n * @extensions\r\n */\r\nexport class Tiles implements Iterable<{ supplier: TileTreeSupplier, id: any, owner: TileTreeOwner }> {\r\n  private _iModel: IModelConnection;\r\n  private readonly _treesBySupplier = new Map<TileTreeSupplier, Dictionary<any, TreeOwner>>();\r\n  private _disposed = false;\r\n\r\n  /** @internal */\r\n  public get isDisposed() { return this._disposed; }\r\n\r\n  /** @internal */\r\n  constructor(iModel: IModelConnection) {\r\n    this._iModel = iModel;\r\n\r\n    iModel.onEcefLocationChanged.addListener(() => {\r\n      for (const supplier of this._treesBySupplier.keys()) {\r\n        if (supplier.isEcefDependent)\r\n          this.dropSupplier(supplier);\r\n      }\r\n    });\r\n\r\n    // When project extents change, purge tile trees for spatial models.\r\n    iModel.onProjectExtentsChanged.addListener(async () => {\r\n      if (!iModel.isBriefcaseConnection() || !iModel.editingScope)\r\n        await this.purgeModelTrees(this.getSpatialModels());\r\n    });\r\n  }\r\n\r\n  /** @internal */\r\n  public dispose(): void {\r\n    this.reset();\r\n    this._disposed = true;\r\n  }\r\n\r\n  /** Intended strictly for tests.\r\n   * @internal\r\n   */\r\n  public reset(): void {\r\n    for (const supplier of this._treesBySupplier)\r\n      supplier[1].forEach((_key, value) => value.dispose());\r\n\r\n    this._treesBySupplier.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  public async purgeTileTrees(modelIds: Id64Array | undefined): Promise<void> {\r\n    return IModelApp.tileAdmin.purgeTileTrees(this._iModel, modelIds);\r\n  }\r\n\r\n  private getModelsAnimatedByScheduleScript(scriptSourceElementId: Id64String): Set<Id64String> {\r\n    const modelIds = new Set<Id64String>();\r\n    for (const supplier of this._treesBySupplier.keys())\r\n      if (supplier.addModelsAnimatedByScript)\r\n        supplier.addModelsAnimatedByScript(modelIds, scriptSourceElementId, this.getTreeOwnersForSupplier(supplier));\r\n\r\n    return modelIds;\r\n  }\r\n\r\n  /** Update the [[Tile]]s for any [[TileTree]]s that use the [RenderSchedule.Script]($common) hosted by the specified\r\n   * [RenderTimeline]($backend) or [DisplayStyle]($backend) element. This method should be invoked after\r\n   * the host element is updated in the database with a new script, so that any [[Viewport]]s displaying tiles produced\r\n   * based on the previous version of the script are updated to use the new version of the script.\r\n   * @param scriptSourceElementId The Id of the RenderTimeline or DisplayStyle element that hosts the script.\r\n   * @public\r\n   */\r\n  public async updateForScheduleScript(scriptSourceElementId: Id64String): Promise<void> {\r\n    return this.purgeModelTrees(this.getModelsAnimatedByScheduleScript(scriptSourceElementId));\r\n  }\r\n\r\n  private async purgeModelTrees(modelIds: Set<Id64String>): Promise<void> {\r\n    if (0 === modelIds.size)\r\n      return;\r\n\r\n    const ids = Array.from(modelIds);\r\n    await this.purgeTileTrees(ids);\r\n    IModelApp.viewManager.refreshForModifiedModels(ids);\r\n  }\r\n\r\n  private getSpatialModels(): Set<Id64String> {\r\n    const modelIds = new Set<Id64String>();\r\n    for (const supplier of this._treesBySupplier.keys())\r\n      if (supplier.addSpatialModels)\r\n        supplier.addSpatialModels(modelIds, this.getTreeOwnersForSupplier(supplier));\r\n\r\n    return modelIds;\r\n  }\r\n\r\n  /** Obtain the owner of a TileTree.\r\n   * The `id` is unique within all tile trees associated with `supplier`; its specific structure is an implementation detail known only to the supplier.\r\n   * A [[TileTreeReference]] uses this method to obtain the tile tree to which it refers.\r\n   */\r\n  public getTileTreeOwner(id: any, supplier: TileTreeSupplier): TileTreeOwner {\r\n    let trees = this._treesBySupplier.get(supplier);\r\n    if (undefined === trees) {\r\n      trees = new Dictionary<any, TreeOwner>((lhs, rhs) => supplier.compareTileTreeIds(lhs, rhs));\r\n      this._treesBySupplier.set(supplier, trees);\r\n    }\r\n\r\n    let tree = trees.get(id);\r\n    if (undefined === tree) {\r\n      tree = new TreeOwner(id, supplier, this._iModel);\r\n      trees.set(id, tree);\r\n    }\r\n\r\n    return tree;\r\n  }\r\n\r\n  /** Disposes of all [[TileTree]]s belonging to `supplier` and removes `supplier` from the set of known tile tree suppliers. */\r\n  public dropSupplier(supplier: TileTreeSupplier): void {\r\n    const trees = this._treesBySupplier.get(supplier);\r\n    if (undefined === trees)\r\n      return;\r\n\r\n    trees.forEach((_key, value) => value.dispose());\r\n    this._treesBySupplier.delete(supplier);\r\n  }\r\n\r\n  /** Invokes a function on each extant TileTreeOwner. */\r\n  public forEachTreeOwner(func: (owner: TileTreeOwner) => void): void {\r\n    for (const dict of this._treesBySupplier.values())\r\n      dict.forEach((_key, value) => func(value));\r\n  }\r\n\r\n  /** Iterate over all of the TileTreeOwners. */\r\n  public * [Symbol.iterator](): Iterator<{ supplier: TileTreeSupplier, id: any, owner: TileTreeOwner }> {\r\n    for (const [supplier, dict] of this._treesBySupplier) {\r\n      for (const entry of dict)\r\n        yield { supplier, id: entry.key, owner: entry.value };\r\n    }\r\n  }\r\n\r\n  /** Obtain the TileTreeOwners supplied by the specified supplier. */\r\n  public getTreeOwnersForSupplier(supplier: TileTreeSupplier): Iterable<{ id: any, owner: TileTreeOwner }> {\r\n    function* iterator(trees: Dictionary<any, TreeOwner> | undefined) {\r\n      if (trees)\r\n        for (const entry of trees)\r\n          yield { id: entry.key, owner: entry.value };\r\n    }\r\n\r\n    return {\r\n      [Symbol.iterator]: () => iterator(this._treesBySupplier.get(supplier)),\r\n    };\r\n  }\r\n\r\n  /** Unload any tile trees which have not been drawn since at least the specified time, excluding any of the specified TileTrees.\r\n   * @internal\r\n   */\r\n  public purge(olderThan: BeTimePoint, exclude?: Set<TileTree>): void {\r\n    // NB: It would be nice to be able to detect completely useless leftover Owners or Suppliers, but we can't know if any TileTreeReferences exist pointing to a given Owner.\r\n    for (const entry of this._treesBySupplier) {\r\n      const dict = entry[1];\r\n      dict.forEach((_treeId, owner) => {\r\n        const tree = owner.tileTree;\r\n        if (undefined !== tree && tree.lastSelectedTime.milliseconds < olderThan.milliseconds)\r\n          if (undefined === exclude || !exclude.has(tree))\r\n            owner.dispose();\r\n      });\r\n    }\r\n  }\r\n}\r\n"]}