@itwin/ecschema-rpcinterface-tests 4.0.0-dev.51 → 4.0.0-dev.52

package/lib/dist/bundled-tests.js

@@ -37306,7 +37306,9 @@ class ColorDef {
     static create(val) {
         return this.fromTbgr(this.computeTbgr(val));
     }
-    /** @internal */
+    /** Compute the 0xTTBBGGRR value corresponding to the specified representation of a color.
+     * @see [[fromString]] for a description of valid string representations.
+     */
     static computeTbgr(val) {
         switch (typeof val) {
             case "number":
@@ -39439,7 +39441,7 @@ class DisplayStyleSettings {
         else
             this._json.clipStyle = style.toJSON();
     }
-    /** @internal */
+    /** Convert these settings to their JSON representation. */
     toJSON() {
         return this._json;
     }
@@ -39618,11 +39620,11 @@ class DisplayStyle3dSettings extends DisplayStyleSettings {
             }
         }
     }
-    /** @internal */
+    /** Convert these settings to their JSON representation. */
     toJSON() {
         return this._json3d;
     }
-    /** @internal */
+    /** See [[DisplayStyleSettings.toOverrides]]. */
     toOverrides(options) {
         const props = super.toOverrides(options);
         if (options?.includeAll)
@@ -41257,9 +41259,14 @@ class FeatureOverrides {
     get defaultOverrides() { return this._defaultOverrides; }
     /** Whether or not line weights are applied. If false, all lines are drawn with a weight of 1. */
     get lineWeights() { return this._lineWeights; }
-    /** @internal */
+    /** A set of elements that are always invisible.
+     * @note If an element is present in both `alwaysDrawn` and [[neverDrawn]], it will not be displayed - `neverDrawn` takes precedence.
+     */
     get neverDrawn() { return this._neverDrawn; }
-    /** @internal */
+    /** A set of elements that are unconditionally displayed.
+     * @see [[isAlwaysDrawnExclusive]] to specify that *only* elements in this set will be displayed.
+     * @note If an element is present in both `alwaysDrawn` and [[neverDrawn]], it will not be displayed - `neverDrawn` takes precedence.
+     */
     get alwaysDrawn() { return this._alwaysDrawn; }
     /** @internal */
     isNeverDrawn(elemIdLo, elemIdHi, animationNodeId) {
@@ -83622,7 +83629,7 @@ class DisplayStyleState extends _EntityState__WEBPACK_IMPORTED_MODULE_6__.Elemen
      * @see [[overrideSubCategory]]
      */
     getSubCategoryOverride(id) { return this.settings.getSubCategoryOverride(id); }
-    /** @internal */
+    /** Returns true if solar shadow display is enabled by this display style. */
     get wantShadows() {
         return this.is3d() && this.viewFlags.shadows && false !== _IModelApp__WEBPACK_IMPORTED_MODULE_7__.IModelApp.renderSystem.options.displaySolarShadows;
     }
@@ -84070,6 +84077,7 @@ class DrawingViewState extends _ViewState__WEBPACK_IMPORTED_MODULE_14__.ViewStat
           CAST(json_extract(jsonProperties, '$.displaySpatialView') as BOOLEAN) as displaySpatialView
         FROM bis.SectionDrawing
         WHERE ECInstanceId=${this.baseModelId}`;
+            // eslint-disable-next-line deprecation/deprecation
             for await (const row of this.iModel.query(ecsql, undefined, { rowFormat: _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryRowFormat.UseJsPropertyNames })) {
                 spatialView = _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Id64.fromJSON(row.spatialView?.id);
                 displaySpatialView = !!row.displaySpatialView;
@@ -84121,14 +84129,14 @@ class DrawingViewState extends _ViewState__WEBPACK_IMPORTED_MODULE_14__.ViewStat
     }
     /** @internal */
     isDrawingView() { return true; }
-    /** @internal */
+    /** See [[ViewState.getOrigin]]. */
     getOrigin() {
         const origin = super.getOrigin();
         if (this._attachment)
             origin.z = -this._attachment.zDepth;
         return origin;
     }
-    /** @internal */
+    /** See [[ViewState.getExtents]]. */
     getExtents() {
         const extents = super.getExtents();
         if (this._attachment)
@@ -87934,7 +87942,7 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
     /** Allow to execute query and read results along with meta data. The result are streamed.
      * @param params The values to bind to the parameters (if the ECSQL has any).
      * @param config Allow to specify certain flags which control how query is executed.
-     * @returns Returns *ECSqlQueryReader* which help iterate over result set and also give access to meta data.
+     * @returns Returns an [ECSqlReader]($common) which helps iterate over the result set and also give access to metadata.
      * @beta
      * */
     createQueryReader(ecsql, params, config) {
@@ -87968,6 +87976,7 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
      * @returns Returns the query result as an *AsyncIterableIterator<any>*  which lazy load result as needed. The row format is determined by *rowFormat* parameter.
      * See [ECSQL row format]($docs/learning/ECSQLRowFormat) for details about the format of the returned rows.
      * @throws [IModelError]($common) If there was any error while submitting, preparing or stepping into query
+     * @deprecated in 3.7. Use [[createQueryReader]] instead; it accepts the same parameters.
      */
     async *query(ecsql, params, options) {
         const builder = new _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryOptionsBuilder(options);
@@ -87986,8 +87995,10 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
      * See "[iTwin.js Types used in ECSQL Parameter Bindings]($docs/learning/ECSQLParameterTypes)" for details.
      * @returns Return row count.
      * @throws [IModelError]($common) If the statement is invalid
+     * @deprecated in 3.7. Count the number of results using `count(*)` where the original query is a subquery instead. E.g., `SELECT count(*) FROM (<query-whose-rows-to-count>)`.
      */
     async queryRowCount(ecsql, params) {
+        // eslint-disable-next-line deprecation/deprecation
         for await (const row of this.query(`select count(*) from (${ecsql})`, params)) {
             return row[0];
         }
@@ -88009,8 +88020,10 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
      * @returns Returns the query result as an *AsyncIterableIterator<any>*  which lazy load result as needed. The row format is determined by *rowFormat* parameter.
      * See [ECSQL row format]($docs/learning/ECSQLRowFormat) for details about the format of the returned rows.
      * @throws [IModelError]($common) If there was any error while submitting, preparing or stepping into query
+     * @deprecated in 3.7. Use [[createQueryReader]] instead. Pass in the restart token as part of the `config` argument; e.g., `{ restartToken: myToken }` or `new QueryOptionsBuilder().setRestartToken(myToken).getOptions()`.
      */
     async *restartQuery(token, ecsql, params, options) {
+        // eslint-disable-next-line deprecation/deprecation
         for await (const row of this.query(ecsql, params, new _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryOptionsBuilder(options).setRestartToken(token).getOptions())) {
             yield row;
         }
@@ -88553,6 +88566,7 @@ class SnapshotConnection extends IModelConnection {
                     break;
             }
             const placements = new Array();
+            // eslint-disable-next-line deprecation/deprecation
             for await (const row of this._iModel.query(ecsql, undefined, { rowFormat: _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryRowFormat.UseJsPropertyNames })) {
                 const origin = [row.x, row.y, row.z];
                 const bbox = {
@@ -92993,6 +93007,7 @@ class SheetViewState extends _ViewState__WEBPACK_IMPORTED_MODULE_14__.ViewState2
     async queryAttachmentIds() {
         const ecsql = `SELECT ECInstanceId as attachmentId FROM bis.ViewAttachment WHERE model.Id=${this.baseModelId}`;
         const ids = [];
+        // eslint-disable-next-line deprecation/deprecation
         for await (const row of this.iModel.query(ecsql))
             ids.push(row[0]);
         return ids;
@@ -95255,6 +95270,7 @@ class ViewCreator2d {
          */
         this._executeQuery = async (query) => {
             const rows = [];
+            // eslint-disable-next-line deprecation/deprecation
             for await (const row of this._imodel.query(query, undefined, { rowFormat: _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryRowFormat.UseJsPropertyNames }))
                 rows.push(row.id);
             return rows;
@@ -95343,6 +95359,7 @@ class ViewCreator2d {
     async _addSheetViewProps(modelId, props) {
         let width = 0;
         let height = 0;
+        // eslint-disable-next-line deprecation/deprecation
         for await (const row of this._imodel.query(`SELECT Width, Height FROM bis.Sheet WHERE ECInstanceId = ?`, _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryBinder.from([modelId]), { rowFormat: _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryRowFormat.UseJsPropertyNames })) {
             width = row.width;
             height = row.height;
@@ -95470,6 +95487,7 @@ class ViewCreator3d {
          */
         this._executeQuery = async (query) => {
             const rows = [];
+            // eslint-disable-next-line deprecation/deprecation
             for await (const row of this._imodel.query(query, undefined, { rowFormat: _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryRowFormat.UseJsPropertyNames }))
                 rows.push(row.id);
             return rows;
@@ -96128,12 +96146,10 @@ class ViewManager {
         const msg = await hit.iModel.getToolTipMessage(hit.sourceId); // wait for the locate message(s) from the backend
         return _IModelApp__WEBPACK_IMPORTED_MODULE_1__.IModelApp.formatElementToolTip(msg);
     }
-    /** Add a new [[ToolTipProvider]] to customize the locate tooltip.
-     * @internal
+    /** Register a new [[ToolTipProvider]] to customize the locate tooltip.
      * @param provider The new tooltip provider to add.
-     * @throws Error if provider is already active.
+     * @throws Error if `provider` is already registered.
      * @returns a function that may be called to remove this provider (in lieu of calling [[dropToolTipProvider]].)
-     * @see [[dropToolTipProvider]]
      */
     addToolTipProvider(provider) {
         if (this.toolTipProviders.includes(provider))
@@ -96142,8 +96158,7 @@ class ViewManager {
         return () => this.dropToolTipProvider(provider);
     }
     /** Drop (remove) a [[ToolTipProvider]] so it is no longer active.
-     * @internal
-     * @param provider The tooltip to drop.
+     * @param provider The tooltip provider to drop.
      * @note Does nothing if provider is not currently active.
      */
     dropToolTipProvider(provider) {
@@ -96873,7 +96888,6 @@ class ViewState extends _EntityState__WEBPACK_IMPORTED_MODULE_5__.ElementState {
     }
     /** Execute a function against each [[TileTreeReference]] associated with this view.
      * @note This may include tile trees not associated with any [[GeometricModelState]] - e.g., context reality data.
-     * @internal
      */
     forEachTileTreeRef(func) {
         this.forEachModelTreeRef(func);
@@ -97657,7 +97671,7 @@ class ViewState3d extends ViewState {
         val.camera = this.camera;
         return val;
     }
-    /** @internal */
+    /** See [[ViewState.is3d]]. */
     is3d() { return true; }
     /** @internal */
     isDrawingView() { return false; }
@@ -98332,7 +98346,7 @@ class ViewState2d extends ViewState {
         val.baseModelId = this.baseModelId;
         return val;
     }
-    /** @internal */
+    /** See [[ViewState.is3d]]. */
     is3d() { return false; }
     /** @internal */
     isSpatialView() { return false; }
@@ -99200,7 +99214,7 @@ class Viewport {
         this._decorationsValid = false;
         _IModelApp__WEBPACK_IMPORTED_MODULE_10__.IModelApp.requestNextAnimation();
     }
-    /** Mark the viewport's scene as invalid, so that the next call to [[renderFrame]] will recreate it.
+    /** Mark the viewport's scene as having changed, so that the next call to [[renderFrame]] will recreate it.
      * This method is not typically invoked directly - the scene is automatically invalidated in response to events such as moving the viewing frustum,
      * changing the set of viewed models, new tiles being loaded, etc.
      */
@@ -99209,12 +99223,17 @@ class Viewport {
         this._timePointValid = false;
         this.invalidateDecorations();
     }
-    /** @internal */
+    /** Mark the viewport's "render plan" as having changed, so that the next call to [[renderFrame]] will recreate it.
+     * This method is not typically invoked directly - the render plan is automatically invalidated in response to events such as changing aspects
+     * of the viewport's [[displayStyle]].
+     */
     invalidateRenderPlan() {
         this._renderPlanValid = false;
         this.invalidateScene();
     }
-    /** @internal */
+    /** Mark the viewport's [[ViewState]] as having changed, so that the next call to [[renderFrame]] will invoke [[setupFromView]] to synchronize with the view.
+     * This method is not typically invoked directly - the controller is automatically invalidated in response to events such as a call to [[changeView]].
+     */
     invalidateController() {
         this._controllerValid = this._analysisFractionValid = false;
         this.invalidateRenderPlan();
@@ -99912,10 +99931,9 @@ class Viewport {
                 _IModelApp__WEBPACK_IMPORTED_MODULE_10__.IModelApp.requestNextAnimation();
         }
     }
-    /** This gives each Viewport a unique Id, which can be used for comparing and sorting Viewport objects inside collections.
-     * @internal
+    /** A unique integer Id assigned to this Viewport upon construction.
+     * It can be useful for comparing and sorting Viewport objects inside of collections like [SortedArray]($core-bentley).
      */
-    /** A unique integer Id for this viewport that can be used for comparing and sorting Viewport objects inside collections like [SortedArray]($core-bentley)s. */
     get viewportId() {
         return this._viewportId;
     }
@@ -100092,7 +100110,7 @@ class Viewport {
         if (this._mapTiledGraphicsProvider)
             this._mapTiledGraphicsProvider.forEachTileTreeRef(this, (ref) => func(ref));
     }
-    /** @internal */
+    /** Apply a function to every [[TileTreeReference]] displayed by this viewport. */
     forEachTileTreeRef(func) {
         this.view.forEachTileTreeRef(func);
         this.forEachTiledGraphicsProviderTree(func);
@@ -100647,9 +100665,10 @@ class Viewport {
         // producing a flicker to that frustum during the first frame of animation.
         this.animate();
     }
-    /** Used strictly by TwoWayViewportSync to change the reactive viewport's view to a clone of the active viewport's ViewState.
-     * Does *not* trigger "ViewState changed" events.
-     * @internal
+    /** Replace this viewport's [[ViewState]] **without** triggering events like [[onChangeView]].
+     * This is chiefly useful when you are synchronizing the states of two or more viewports, as in [[TwoWayViewportSync]], to avoid triggering unwanted "echo"
+     * events during synchronization.
+     * In all other scenarios, [[changeView]] is the correct method to use.
      */
     applyViewState(val) {
         this.updateChangeFlags(val);
@@ -101100,7 +101119,7 @@ class Viewport {
     queryVisibleFeatures(options, callback) {
         return (0,_render_VisibleFeature__WEBPACK_IMPORTED_MODULE_29__.queryVisibleFeatures)(this, options, callback);
     }
-    /** @internal */
+    /** Record graphics memory consumed by this viewport. */
     collectStatistics(stats) {
         const trees = new _tile_internal__WEBPACK_IMPORTED_MODULE_22__.DisclosedTileTreeSet();
         this.discloseTileTrees(trees);
@@ -101580,7 +101599,7 @@ class ScreenViewport extends Viewport {
     setCursor(cursor = "default") {
         this.canvas.style.cursor = cursor;
     }
-    /** @internal */
+    /** See [[Viewport.synchWithView]]. */
     synchWithView(options) {
         options = options ?? {};
         if (this.view.is3d() && options?.globalAlignment)
@@ -106381,6 +106400,9 @@ __webpack_require__.r(__webpack_exports__);
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utils
+ */
 
 
 
@@ -106398,6 +106420,7 @@ __webpack_require__.r(__webpack_exports__);
  *  (1) If overriding anything in the implementation supplied herein, pass a SystemFactory function to MockRender.App.systemFactory.
  *  (2) Call MockRender.App.startup() instead of IModelApp.startup() before tests begin.
  *  (3) Likewise call MockRender.App.shutdown() when finished. This resets the SystemFactory to its default.
+ * @note The APIs within this namespace are intended *strictly* for use with unit tests.
  * @internal
  */
 var MockRender;
@@ -106450,14 +106473,12 @@ var MockRender;
         }
     }
     MockRender.Builder = Builder;
-    /** @internal */
     class Graphic extends _RenderGraphic__WEBPACK_IMPORTED_MODULE_5__.RenderGraphic {
         constructor() { super(); }
         dispose() { }
         collectStatistics(_stats) { }
     }
     MockRender.Graphic = Graphic;
-    /** @internal */
     class List extends Graphic {
         constructor(graphics) {
             super();
@@ -106470,7 +106491,6 @@ var MockRender;
         }
     }
     MockRender.List = List;
-    /** @internal */
     class Branch extends Graphic {
         constructor(branch, transform, options) {
             super();
@@ -106481,7 +106501,6 @@ var MockRender;
         dispose() { this.branch.dispose(); }
     }
     MockRender.Branch = Branch;
-    /** @internal */
     class Batch extends Graphic {
         constructor(graphic, featureTable, range) {
             super();
@@ -106506,14 +106525,16 @@ var MockRender;
         collectStatistics() { }
     }
     MockRender.AreaPattern = AreaPattern;
-    /** @internal */
     class System extends _RenderSystem__WEBPACK_IMPORTED_MODULE_6__.RenderSystem {
         get isValid() { return true; }
         dispose() { }
         get maxTextureSize() { return 4096; }
         constructor() { super(); }
+        /** @internal */
         doIdleWork() { return false; }
+        /** @internal */
         createTarget(canvas) { return new OnScreenTarget(this, canvas); }
+        /** @internal */
         createOffscreenTarget(rect) { return new OffScreenTarget(this, rect); }
         createGraphic(options) {
             return new Builder(this, options);
@@ -106521,20 +106542,26 @@ var MockRender;
         createGraphicList(primitives) { return new List(primitives); }
         createGraphicBranch(branch, transform, options) { return new Branch(branch, transform, options); }
         createBatch(graphic, features, range) { return new Batch(graphic, features, range); }
+        /** @internal */
         createMesh(_params) { return new Graphic(); }
+        /** @internal */
         createPolyline(_params) { return new Graphic(); }
+        /** @internal */
         createPointString(_params) { return new Graphic(); }
+        /** @internal */
         createPointCloud(_args, _imodel) { return new Graphic(); }
         createRenderGraphic() { return new Graphic(); }
+        /** @internal */
         createMeshGeometry() { return new Geometry(); }
+        /** @internal */
         createPolylineGeometry() { return new Geometry(); }
+        /** @internal */
         createPointStringGeometry() { return new Geometry(); }
+        /** @internal */
         createAreaPattern() { return new AreaPattern(); }
     }
     MockRender.System = System;
-    /** An implementation of IModelApp which uses a MockRender.System by default.
-     * @internal
-     */
+    /** An implementation of IModelApp which uses a MockRender.System by default. */
     class App {
         static async startup(opts) {
             opts = opts ? opts : {};
@@ -107272,8 +107299,9 @@ __webpack_require__.r(__webpack_exports__);
 /** @packageDocumentation
  * @module Rendering
  */
-/** Contains metadata about memory consumed by the render system or aspect thereof.
- * @internal
+/** APIs for querying memory consumed by the [[RenderSystem]].
+ * Use methods like [[Viewport.collectStatistics]] and [[TileTreeReference.collectStatistics]] to query this memory usage.
+ * @public
  */
 var RenderMemory;
 (function (RenderMemory) {
@@ -107359,64 +107387,113 @@ var RenderMemory;
         ConsumerType[ConsumerType["ThematicTextures"] = 9] = "ThematicTextures";
         ConsumerType[ConsumerType["COUNT"] = 10] = "COUNT";
     })(ConsumerType = RenderMemory.ConsumerType || (RenderMemory.ConsumerType = {}));
-    /** @internal */
+    /** Contains statistics about the amount and type of memory consumed by the [[RenderSystem]].
+     * Use methods like [[Viewport.collectStatistics]] and [[TileTreeReference.collectStatistics]] to query this memory usage.
+     * @see [[Statistics.create]] to instantiate an instance of this class.
+     * @public
+     */
     class Statistics {
+        /** @internal */
         constructor() {
             this._totalBytes = 0;
+            /** @internal */
             this.buffers = new Buffers();
             this.consumers = [];
             for (let i = 0; i < ConsumerType.COUNT; i++)
                 this.consumers[i] = new Consumers();
         }
+        /** Create a new, empty statistics object. */
+        static create() {
+            return new Statistics();
+        }
+        /** The total reported memory consumption, in bytes.
+         * @note A web browser provides no direct access to actual memory used by the host device or its graphics hardware. The reported memory usage
+         * is an estimate based on the number of bytes of data requested via WebGL APIs. It is always an *under-estimate* as each WebGL implementation imposes
+         * its own additional overhead.
+         */
         get totalBytes() { return this._totalBytes; }
+        /** @internal */
         get textures() { return this.consumers[ConsumerType.Textures]; }
+        /** @internal */
         get vertexTables() { return this.consumers[ConsumerType.VertexTables]; }
+        /** @internal */
         get edgeTables() { return this.consumers[ConsumerType.EdgeTables]; }
+        /** @internal */
         get featureTables() { return this.consumers[ConsumerType.FeatureTables]; }
+        /** @internal */
         get thematicTextures() { return this.consumers[ConsumerType.ThematicTextures]; }
+        /** @internal */
         get featureOverrides() { return this.consumers[ConsumerType.FeatureOverrides]; }
+        /** @internal */
         get clipVolumes() { return this.consumers[ConsumerType.ClipVolumes]; }
+        /** @internal */
         get planarClassifiers() { return this.consumers[ConsumerType.PlanarClassifiers]; }
+        /** @internal */
         get shadowMaps() { return this.consumers[ConsumerType.ShadowMaps]; }
+        /** @internal */
         get textureAttachments() { return this.consumers[ConsumerType.TextureAttachments]; }
+        /** @internal */
         addBuffer(type, numBytes) {
             this._totalBytes += numBytes;
             this.buffers.addBuffer(type, numBytes);
         }
+        /** @internal */
         addConsumer(type, numBytes) {
             this._totalBytes += numBytes;
             this.consumers[type].addConsumer(numBytes);
         }
+        /** @internal */
         clear() {
             this._totalBytes = 0;
             this.buffers.clear();
             for (const consumer of this.consumers)
                 consumer.clear();
         }
+        /** @internal */
         addTexture(numBytes) { this.addConsumer(ConsumerType.Textures, numBytes); }
+        /** @internal */
         addVertexTable(numBytes) { this.addConsumer(ConsumerType.VertexTables, numBytes); }
+        /** @internal */
         addEdgeTable(numBytes) { this.addConsumer(ConsumerType.EdgeTables, numBytes); }
+        /** @internal */
         addFeatureTable(numBytes) { this.addConsumer(ConsumerType.FeatureTables, numBytes); }
+        /** @internal */
         addThematicTexture(numBytes) { this.addConsumer(ConsumerType.ThematicTextures, numBytes); }
+        /** @internal */
         addFeatureOverrides(numBytes) { this.addConsumer(ConsumerType.FeatureOverrides, numBytes); }
+        /** @internal */
         addClipVolume(numBytes) { this.addConsumer(ConsumerType.ClipVolumes, numBytes); }
+        /** @internal */
         addPlanarClassifier(numBytes) { this.addConsumer(ConsumerType.PlanarClassifiers, numBytes); }
+        /** @internal */
         addShadowMap(numBytes) { this.addConsumer(ConsumerType.ShadowMaps, numBytes); }
+        /** @internal */
         addTextureAttachment(numBytes) { this.addConsumer(ConsumerType.TextureAttachments, numBytes); }
+        /** @internal */
         addSurface(numBytes) { this.addBuffer(BufferType.Surfaces, numBytes); }
+        /** @internal */
         addVisibleEdges(numBytes) { this.addBuffer(BufferType.VisibleEdges, numBytes); }
+        /** @internal */
         addIndexedEdges(numBytes) { this.addBuffer(BufferType.IndexedEdges, numBytes); }
+        /** @internal */
         addSilhouetteEdges(numBytes) { this.addBuffer(BufferType.SilhouetteEdges, numBytes); }
+        /** @internal */
         addPolylineEdges(numBytes) { this.addBuffer(BufferType.PolylineEdges, numBytes); }
+        /** @internal */
         addPolyline(numBytes) { this.addBuffer(BufferType.Polylines, numBytes); }
+        /** @internal */
         addPointString(numBytes) { this.addBuffer(BufferType.PointStrings, numBytes); }
+        /** @internal */
         addPointCloud(numBytes) { this.addBuffer(BufferType.PointClouds, numBytes); }
+        /** @internal */
         addTerrain(numBytes) {
             this.addBuffer(BufferType.Terrain, numBytes);
         }
+        /** @internal */
         addRealityMesh(numBytes) {
             this.addBuffer(BufferType.RealityMesh, numBytes);
         }
+        /** @internal */
         addInstances(numBytes) { this.addBuffer(BufferType.Instances, numBytes); }
     }
     RenderMemory.Statistics = Statistics;
@@ -151348,7 +151425,7 @@ class TileTreeReference /* implements RenderMemory.Consumer */ {
         if (!contentRange.isNull)
             union.extendRange(contentRange);
     }
-    /** @internal */
+    /** Record graphics memory consumed by this tile tree reference. */
     collectStatistics(stats) {
         const tree = this.treeOwner.tileTree;
         if (undefined !== tree)
@@ -162992,6 +163069,7 @@ class ElementSetTool extends _PrimitiveTool__WEBPACK_IMPORTED_MODULE_9__.Primiti
         ids.add(id);
         try {
             const ecsql = `SELECT ECInstanceId as id, Parent.Id as parentId FROM BisCore.GeometricElement WHERE Parent.Id IN (SELECT Parent.Id as parentId FROM BisCore.GeometricElement WHERE parent.Id != 0 AND ECInstanceId IN (${id}))`;
+            // eslint-disable-next-line deprecation/deprecation
             for await (const row of this.iModel.query(ecsql, undefined, { rowFormat: _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.QueryRowFormat.UseJsPropertyNames })) {
                 ids.add(row.parentId);
                 ids.add(row.id);
@@ -210624,22 +210702,25 @@ class Matrix3d {
         return result;
     }
     /**
-     * Multiply `this` Matrix3d (considered as a Transform with 0 translation) times `other` Transform.
+     * Multiply `this` Matrix3d (considered to be a Transform with 0 `origin`) times `other` Transform.
+     * **Note:** If `other = [B   b]`, then we promote `this` matrix to be a Transform [A   0].
+     * Then `this * other` is defined as [A*B   Aa]. That's because we create a 4x4 matrix for each Transform
+     * with the 3x3 `matrix` and `origin` as upper 3x4 part of a 4x4 matrix and 0001 as the final row. Then we
+     * multiply those two 4x4 matrixes:
      * ```
      * equation
      * \begin{matrix}
-     * \text{This matrix }\bold{A}\text{ promoted to block transform} & \blockTransform{A}{0} \\
-     * \text{other transform with matrix part }\bold{B}\text{ and translation }\bold{b} & \blockTransform{B}{b}\\
+     * \text{`this` matrix }\bold{A}\text{ promoted to block Transform} & \blockTransform{A}{0} \\
+     * \text{`other` Transform with `matrix` part }\bold{B}\text{ and `origin` part }\bold{b} & \blockTransform{B}{b}\\
      * \text{product}& \blockTransform{A}{0}\blockTransform{B}{b}=\blockTransform{AB}{Ab}
      * \end{matrix}
      * ```
-     * @param other Right hand Matrix3d for multiplication.
-     * @param result the Transform result (optional)
+     * @param other the `other` Transform to be multiplied to `this` matrix.
+     * @param result optional preallocated result to reuse.
      */
     multiplyMatrixTransform(other, result) {
         if (!result)
             return _Transform__WEBPACK_IMPORTED_MODULE_5__.Transform.createRefs(this.multiplyXYZ(other.origin.x, other.origin.y, other.origin.z), this.multiplyMatrixMatrix(other.matrix));
-        // be sure to do the point multiplication first before aliasing changes the matrix
         this.multiplyXYZtoXYZ(other.origin, result.origin);
         this.multiplyMatrixMatrix(other.matrix, result.matrix);
         return result;
@@ -220462,11 +220543,15 @@ __webpack_require__.r(__webpack_exports__);
  * * The math for a Transform `T` consisting of a Matrix3d `M` and a Point3d `o` on a Vector3d `p` is: `Tp = M*p + o`.
  * In other words, `T` is a combination of two operations on `p`: the action of matrix multiplication, followed by a
  * translation. `Origin` is a traditional term for `o`, because `T` can be interpreted as a change of basis from the
- * global axes centered at the global origin, to a new set of axes centered at `o`.
- * * Beware that for common transformations (e.g. scale about point, rotate around an axis, mirror across a
- * plane) the "fixed point" that is used when describing the transform is NOT the "origin" stored in the
- * transform. Setup methods (e.g createFixedPointAndMatrix, createScaleAboutPoint) take care of determining
- * the appropriate origin coordinates.
+ * global axes centered at the global origin, to a new set of axes specified by matrix M columns centered at `o`.
+ * * Beware that for common transformations (e.g. scale about point, rotate around an axis) the `fixed point` that
+ * is used when describing the transform is NOT the `origin` stored in the transform. Setup methods (e.g
+ * createFixedPointAndMatrix, createScaleAboutPoint) take care of determining the appropriate origin coordinates.
+ * * If `T` is a translation, no point is fixed by `T`.
+ * * If `T` is the identity, all points are fixed by `T`.
+ * * If `T` is a scale about a point, one point is fixed by `T`.
+ * * If `T` is a rotation about an axis, a line is fixed by `T`.
+ * * If `T` is a projection to the plane, a plane is fixed by `T`.
  * @public
  */
 class Transform {
@@ -220759,22 +220844,32 @@ class Transform {
         const origin = _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzMinusMatrixTimesXYZ(fixedPoint, matrix, fixedPoint);
         return Transform.createRefs(origin, matrix, result);
     }
-    /** Transform the input 2d point. Return as a new point or in the pre-allocated result (if result is given). */
+    /**
+     * Transform the input 2d point (using `Tp = M*p + o`).
+     * Return as a new point or in the pre-allocated result (if result is given).
+     */
     multiplyPoint2d(point, result) {
-        // Tx = Mx + o so we return Mx + o
         return _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyPlusMatrixTimesXY(this._origin, this._matrix, point, result);
     }
-    /** Transform the input 3d point. Return as a new point or in the pre-allocated result (if result is given). */
+    /**
+     * Transform the input 3d point (using `Tp = M*p + o`).
+     * Return as a new point or in the pre-allocated result (if result is given).
+     */
     multiplyPoint3d(point, result) {
         // Tx = Mx + o so we return Mx + o
         return _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZ(this._origin, this._matrix, point, result);
     }
-    /** Transform the input 3d point in place (override the input point by the transformed point). */
+    /**
+     * Transform the input 3d point in place (using `Tp = M*p + o`).
+     * Return as a new point or in the pre-allocated result (if result is given).
+     */
     multiplyXYAndZInPlace(point) {
-        // Tx = Mx + o so we override x by Mx + o
         return _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZInPlace(this._origin, this._matrix, point);
     }
-    /** Transform the input point. Return as a new point or in the pre-allocated result (if result is given). */
+    /**
+     * Transform the input 3d point (using `Tp = M*p + o`).
+     * Return as a new point or in the pre-allocated result (if result is given).
+     */
     multiplyXYZ(x, y, z = 0, result) {
         // Tx = Mx + o so we return Mx + o
         return _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesCoordinates(this._origin, this._matrix, x, y, z, result);
@@ -220820,7 +220915,7 @@ class Transform {
         return _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesCoordinatesToFloat64Array(this._origin, this._matrix, x, y, z, result);
     }
     /**
-     * Treat the 3x3 matrix and origin as upper 3x4 part of a 4x4 matrix, with 0001 as the final row. Now multiply
+     * Treat the 3x3 `matrix` and `origin` as upper 3x4 part of a 4x4 matrix, with 0001 as the final row. Now multiply
      * the transposed of this 4x4 matrix by Point4d given as xyzw. Return as a new point4d (`M*p` as first 3 elements
      * and `o*p + w` as last element where `p = (x,y,z)`) or in the pre-allocated result (if result is given).
      */
@@ -220829,13 +220924,13 @@ class Transform {
         const origin = this._origin;
         return _geometry4d_Point4d__WEBPACK_IMPORTED_MODULE_3__.Point4d.create((x * coffs[0]) + (y * coffs[3]) + (z * coffs[6]), (x * coffs[1]) + (y * coffs[4]) + (z * coffs[7]), (x * coffs[2]) + (y * coffs[5]) + (z * coffs[8]), (x * origin.x) + (y * origin.y) + (z * origin.z) + w, result);
     }
-    /** For each point in the array, replace point by the transformed point (by `Tp = M*p + o`) */
+    /** For each point in the array, replace point by the transformed point (using `Tp = M*p + o`) */
     multiplyPoint3dArrayInPlace(points) {
         let point;
         for (point of points)
             _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZ(this._origin, this._matrix, point, point);
     }
-    /** For each point in the 2d array, replace point by the transformed point (by `Tp = M*p + o`) */
+    /** For each point in the 2d array, replace point by the transformed point (using `Tp = M*p + o`) */
     multiplyPoint3dArrayArrayInPlace(chains) {
         for (const chain of chains)
             this.multiplyPoint3dArrayInPlace(chain);
@@ -220872,58 +220967,23 @@ class Transform {
         return this._matrix.multiplyInverseXYZAsPoint3d(x - this._origin.x, y - this._origin.y, z - this._origin.z, result);
     }
     /**
-     * *  for each point:   multiply    transform * point
-     * *  if result is given, resize to match source and replace each corresponding pi
-     * *  if result is not given, return a new array.
-     */
-    multiplyInversePoint3dArray(source, result) {
-        if (!this._matrix.computeCachedInverse(true))
-            return undefined;
-        const originX = this.origin.x;
-        const originY = this.origin.y;
-        const originZ = this.origin.z;
-        if (result) {
-            const n = Transform.matchArrayLengths(source, result, _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.createZero);
-            for (let i = 0; i < n; i++)
-                this._matrix.multiplyInverseXYZAsPoint3d(source[i].x - originX, source[i].y - originY, source[i].z - originZ, result[i]);
-        }
-        result = [];
-        for (const p of source)
-            result.push(this._matrix.multiplyInverseXYZAsPoint3d(p.x - originX, p.y - originY, p.z - originZ));
-        return result;
-    }
-    /**
-     * * For each point in source: multiply transformInverse * point in place in the point.
-     * * Return false if not invertible.
-     */
-    multiplyInversePoint3dArrayInPlace(source) {
-        if (!this._matrix.computeCachedInverse(true))
-            return false;
-        const originX = this.origin.x;
-        const originY = this.origin.y;
-        const originZ = this.origin.z;
-        const n = source.length;
-        for (let i = 0; i < n; i++)
-            this._matrix.multiplyInverseXYZAsPoint3d(source[i].x - originX, source[i].y - originY, source[i].z - originZ, source[i]);
-        return true;
-    }
-    /**
-     * * Compute (if needed) the inverse of the matrix part, thereby ensuring inverse operations can complete.
-     * * Return true if matrix inverse completes.
+     * * Compute (if needed) the inverse of the `matrix` part of the Transform, thereby ensuring inverse
+     * operations can complete.
      * @param useCached If true, accept prior cached inverse if available.
+     * @returns `true` if matrix inverse completes, `false` otherwise.
      */
     computeCachedInverse(useCached = true) {
         return this._matrix.computeCachedInverse(useCached);
     }
     /**
-     * * If destination has more values than source, remove the extras.
-     * * If destination has fewer values, use the constructionFunction to create new ones.
-     * @param source array
-     * @param dest destination array, to  be modified to match source length
-     * @param constructionFunction function to call to create new entries.
+     * Match the length of destination array with the length of source array
+     * * If destination has more elements than source, remove the extra elements.
+     * * If destination has fewer elements than source, use `constructionFunction` to create new elements.
+     * *
+     * @param source the source array
+     * @param dest the destination array
+     * @param constructionFunction function to call to create new elements.
      */
-    // modify destination so it has non-null points for the same length as the source.
-    // (ASSUME existing elements of dest are non-null, and that parameters are given as either Point2d or Point3d arrays)
     static matchArrayLengths(source, dest, constructionFunction) {
         const numSource = source.length;
         const numDest = dest.length;
@@ -220938,72 +220998,125 @@ class Transform {
         return numSource;
     }
     /**
-     * * For each point:   multiply    transform * point
-     * * If result is given, resize to match source and replace each corresponding pi
-     * * If result is not given, return a new array.
+     * If for each point `p` we have `Tp = M*p + o = point` (where `point` is the transformed point), then
+     * `p = MInverse * (point - o)`. This function returns the array of original points `p[]` if `points`
+     * is the array of transformed point (`Tp = point` for each `p` and `point`).
+     * * If `results` is given, resize it to match the input `points` array and update it with original points `p[]`.
+     * * If `results` is not given, return a new array.
+     * * Returns `undefined` if the `matrix` part if this Transform is singular.
+     */
+    multiplyInversePoint3dArray(points, results) {
+        if (!this._matrix.computeCachedInverse(true))
+            return undefined;
+        const originX = this.origin.x;
+        const originY = this.origin.y;
+        const originZ = this.origin.z;
+        if (results) {
+            const n = Transform.matchArrayLengths(points, results, _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.createZero);
+            for (let i = 0; i < n; i++)
+                this._matrix.multiplyInverseXYZAsPoint3d(points[i].x - originX, points[i].y - originY, points[i].z - originZ, results[i]);
+        }
+        results = [];
+        for (const point of points)
+            results.push(this._matrix.multiplyInverseXYZAsPoint3d(point.x - originX, point.y - originY, point.z - originZ));
+        return results;
+    }
+    /**
+     * If for each point `p` we have `Tp = M*p + o = point` (where `point` is the transformed point), then
+     * `p = MInverse * (point - o)`. This function calculates the array of original points `p[]` if `points`
+     * is the array of transformed point (`Tp = point` for each `p` and `point`) and replaces `points`
+     * with the array of original points.
+     * * Returns `true` if the `matrix` part if this Transform is invertible and `false if singular.
+     */
+    multiplyInversePoint3dArrayInPlace(points) {
+        if (!this._matrix.computeCachedInverse(true))
+            return false;
+        for (const point of points)
+            this._matrix.multiplyInverseXYZAsPoint3d(point.x - this.origin.x, point.y - this.origin.y, point.z - this.origin.z, point);
+        return true;
+    }
+    /**
+     * Transform the input 2d point array (using `Tp = M*p + o`).
+     * * If `result` is given, resize it to match the input `points` array and update it with transformed points.
+     * * If `result` is not given, return a new array.
      */
-    multiplyPoint2dArray(source, result) {
+    multiplyPoint2dArray(points, result) {
         if (result) {
-            const n = Transform.matchArrayLengths(source, result, _Point2dVector2d__WEBPACK_IMPORTED_MODULE_4__.Point2d.createZero);
+            const n = Transform.matchArrayLengths(points, result, _Point2dVector2d__WEBPACK_IMPORTED_MODULE_4__.Point2d.createZero);
             for (let i = 0; i < n; i++)
-                _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyPlusMatrixTimesXY(this._origin, this._matrix, source[i], result[i]);
+                _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyPlusMatrixTimesXY(this._origin, this._matrix, points[i], result[i]);
             return result;
         }
         result = [];
-        for (const p of source)
+        for (const p of points)
             result.push(_Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyPlusMatrixTimesXY(this._origin, this._matrix, p));
         return result;
     }
     /**
-     * * For each point:   multiply    transform * point
-     * * If result is given, resize to match source and replace each corresponding pi
-     * * If result is not given, return a new array.
+     * Transform the input 3d point array (using `Tp = M*p + o`).
+     * * If `result` is given, resize it to match the input `points` array and update it with transformed points.
+     * * If `result` is not given, return a new array.
      */
-    multiplyPoint3dArray(source, result) {
+    multiplyPoint3dArray(points, result) {
         if (result) {
-            const n = Transform.matchArrayLengths(source, result, _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.createZero);
+            const n = Transform.matchArrayLengths(points, result, _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.createZero);
             for (let i = 0; i < n; i++)
-                _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZ(this._origin, this._matrix, source[i], result[i]);
+                _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZ(this._origin, this._matrix, points[i], result[i]);
             return result;
         }
         result = [];
-        for (const p of source)
+        for (const p of points)
             result.push(_Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZ(this._origin, this._matrix, p));
         return result;
     }
     /**
-     * Multiply the vector by the Matrix3d part of the transform.
-     * * The transform's origin is not used.
-     * * Return as new or result by usual optional result convention
+     * Multiply the vector by the `matrix` part of the Transform.
+     * * The `origin` part of Transform is not used.
+     * * If `result` is given, update it with the multiplication. Otherwise, create a new Vector3d.
      */
     multiplyVector(vector, result) {
         return this._matrix.multiplyVector(vector, result);
     }
     /**
-     * Multiply the vector in place by the Matrix3d part of the transform.
-     * * The transform's origin is not used.
+     * Multiply the vector by the `matrix` part of the Transform in place.
+     * * The `origin` part of Transform is not used.
      */
     multiplyVectorInPlace(vector) {
         this._matrix.multiplyVectorInPlace(vector);
     }
     /**
-     * Multiply the vector (x,y,z) by the Matrix3d part of the transform.
-     * * The transform's origin is not used.
-     * * Return as new or result by usual optional result convention
+     * Multiply the vector (x,y,z) by the `matrix` part of the Transform.
+     * * The `origin` part of Transform is not used.
+     * * If `result` is given, update it with the multiplication. Otherwise, create a new Vector3d.
      */
     multiplyVectorXYZ(x, y, z, result) {
         return this._matrix.multiplyXYZ(x, y, z, result);
     }
-    /** Multiply this Transform times other Transform.
+    /**
+     * Calculate `transformA * transformB` and store it into the calling instance (`this`).
+     * * **Note:** If `transformA = [A   a]` and `transformB = [B   b]` then `transformA * transformB` is defined as
+     * `[A*B   Ab+a]`. See `multiplyTransformTransform` doc for math details.
+     * @param transformA first operand
+     * @param transformB second operand
+     */
+    setMultiplyTransformTransform(transformA, transformB) {
+        _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZ(transformA._origin, transformA._matrix, transformB._origin, this._origin);
+        transformA._matrix.multiplyMatrixMatrix(transformB._matrix, this._matrix);
+    }
+    /**
+     * Multiply `this` Transform times `other` Transform.
+     * **Note:** If `this = [A   a]` and `other = [B   b]` then `this * other` is defined as [A*B   Ab+a].
+     * That's because we create a 4x4 matrix for each Transform with the 3x3 `matrix` and `origin`
+     * as upper 3x4 part of a 4x4 matrix and 0001 as the final row. Then we multiply those two 4x4 matrixes:
      * ```
      * equation
      * \begin{matrix}
-     *    \text{`this` transform with matrix part }\bold{A}\text{ and translation }\bold{a} & \blockTransform{A}{a}\\
-     *    \text{`other` transform with matrix part }\bold{B}\text{ and translation part }\bold{b}\text{ promoted to block transform} & \blockTransform{B}{b} \\
+     *    \text{`this` Transform with `matrix` part }\bold{A}\text{ and `origin` part }\bold{a} & \blockTransform{A}{a}\\
+     *    \text{`other` Transform with `matrix` part }\bold{B}\text{ and `origin` part }\bold{b} & \blockTransform{B}{b} \\
      * \text{product}& \blockTransform{A}{a}\blockTransform{B}{b}=\blockTransform{AB}{Ab + a}
      * \end{matrix}
      * ```
-     * @param other right hand transform for multiplication.
+     * @param other the 'other` Transform to be multiplied to `this` Transform.
      * @param result optional preallocated result to reuse.
      */
     multiplyTransformTransform(other, result) {
@@ -221013,30 +221126,20 @@ class Transform {
         return result;
     }
     /**
-     * Multiply transformA * transformB, store to calling instance.
-     * @param transformA left operand
-     * @param transformB right operand
-     */
-    setMultiplyTransformTransform(transformA, transformB) {
-        if (Transform._scratchPoint === undefined)
-            Transform._scratchPoint = _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create();
-        _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.xyzPlusMatrixTimesXYZ(transformA._origin, transformA._matrix, transformB._origin, Transform._scratchPoint);
-        this._origin.setFrom(Transform._scratchPoint);
-        transformA._matrix.multiplyMatrixMatrix(transformB._matrix, this._matrix);
-    }
-    //   [Q A][R 0] = [QR A]
-    //   [0 1][0 1]   [0  1]
-    /**
-     * Multiply this Transform times other Matrix3d, with other considered to be a Transform with 0 translation.
+     * Multiply `this` Transform times `other` Matrix3d (considered to be a Transform with 0 `origin`).
+     * **Note:** If `this = [A   a]`, then we promote `other` matrix to be a Transform [B   0].
+     * Then `this * other` is defined as [A*B   a]. That's because we create a 4x4 matrix for each Transform
+     * with the 3x3 `matrix` and `origin` as upper 3x4 part of a 4x4 matrix and 0001 as the final row. Then we
+     * multiply those two 4x4 matrixes:
      * ```
      * equation
      * \begin{matrix}
-     *    \text{`this` transform with matrix part }\bold{A}\text{ and translation }\bold{b} & \blockTransform{B}{b}\\
-     *    \text{`other` matrix }\bold{B}\text{ promoted to block transform} & \blockTransform{B}{0} \\
+     *    \text{`this` Transform with `matrix` part }\bold{A}\text{ and `origin` part }\bold{a} & \blockTransform{A}{a}\\
+     *    \text{`other` matrix }\bold{B}\text{ promoted to block Transform} & \blockTransform{B}{0} \\
      * \text{product}& \blockTransform{A}{a}\blockTransform{B}{0}=\blockTransform{AB}{a}
      * \end{matrix}
      * ```
-     * @param other right hand Matrix3d for multiplication.
+     * @param other the `other` Matrix3d to be multiplied to `this` Transform.
      * @param result optional preallocated result to reuse.
      */
     multiplyTransformMatrix3d(other, result) {
@@ -221047,15 +221150,17 @@ class Transform {
         return result;
     }
     /**
-     * Return the range of the transformed corners.
+     * Return the Range of the transformed corners.
      * * The 8 corners are transformed individually.
-     * * Note that if there is anything other than translation and principal axis scaling in the transform, the volume of the range rotation will increase.
-     * * Hence to get a "tight" range on rotated geometry, a range computation must be made on the rotated geometry itself.
+     * * **Note:** Suppose you have a geometry, a range box around that geometry, and your Transform is a rotation.
+     * If you rotate the range box and recompute a new range box around the rotated range box, then the new range
+     * box will have a larger volume than the original range box. However, if you rotate the geometry itself and
+     * then recompute the range box, it will be a tighter range box around the rotated geometry. `multiplyRange`
+     * function creates the larger range box because it only has access to the range box and the geometry itself.
      */
     multiplyRange(range, result) {
         if (range.isNull)
             return range.clone(result);
-        // snag current values to allow aliasing.
         const lowX = range.low.x;
         const lowY = range.low.y;
         const lowZ = range.low.z;
@@ -221074,9 +221179,9 @@ class Transform {
         return result;
     }
     /**
-     * * Return a Transform which is the inverse of this transform.
-     * @param result optional pre-allocated result
-     * @return the inverse Transform, or undefined if the matrix is singular
+     * Return a Transform which is the inverse of `this` Transform.
+     * * If `transform = [M   o]` then `transformInverse = [MInverse   MInverse*-o]`
+     * * Return `undefined` if this Transform's matrix is singular.
      */
     inverse(result) {
         const matrixInverse = this._matrix.inverse(result ? result._matrix : undefined);
@@ -221090,15 +221195,15 @@ class Transform {
         return Transform.createRefs(matrixInverse.multiplyXYZ(-this._origin.x, -this._origin.y, -this._origin.z), matrixInverse);
     }
     /**
-     * Initialize transforms that map each direction of a box (axis aligned) to `[0,1]`.
-     * * The corner coordinates do _not_ need to be in order in any of the x,y,z directions.
-     * * The npcToGlobalTransform (if supplied) maps 000 to the point named point000.
-     * * The npcToGlobalTransform (if supplied) maps 11 to the point named point000.
-     * * The globalToNpc transform is the inverse.
-     * @param min the "000" corner of the box
-     * @param max the "111" corner of the box
-     * @param npcToGlobal (object created by caller, re-initialized here) transform that carries 01 coordinates into the min,max box.
-     * @param globalToNpc (object created by caller, re-initialized here) transform that carries world coordinates into 01
+     * Initialize 2 Transforms: First Transform maps a box (axis aligned) specified by `min` and `max` to
+     * the unit box specified by 000 and 111 and inverse of it. Second Transform is the reverse of first.
+     * @param min the min corner of the box
+     * @param max the max corner of the box
+     * @param npcToGlobal maps global (the unit box specified by 000 and 111) to NPC (a box specified by `min`
+     * and `max`). Object created by caller, re-initialized here.
+     * @param globalToNpc maps NPC (a box specified by `min` and `max`) to global (the unit box specified by
+     * 000 and 111). Object created by caller, re-initialized here.
+     * * NPC stands for `Normalized Projection Coordinate`
      */
     static initFromRange(min, max, npcToGlobal, globalToNpc) {
         const diag = max.minus(min);
@@ -221109,10 +221214,26 @@ class Transform {
         if (diag.z === 0.0)
             diag.z = 1.0;
         const rMatrix = new _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d();
+        /**
+         *               [diag.x    0       0      min.x]
+         * npcToGlobal = [  0     diag.y    0      min.y]
+         *               [  0       0     diag.y   min.z]
+         *
+         * npcToGlobal * 0 = min
+         * npcToGlobal * 1 = diag + min = max
+         */
         if (npcToGlobal) {
             _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.createScale(diag.x, diag.y, diag.z, rMatrix);
             Transform.createOriginAndMatrix(min, rMatrix, npcToGlobal);
         }
+        /**
+         *               [1/diag.x      0         0      -min.x/diag.x]
+         * globalToNpc = [  0       1/diag.y      0      -min.y/diag.y]
+         *               [  0         0       1/diag.y   -min.z/diag.z]
+         *
+         * globalToNpc * min = min/diag - min/diag = 0
+         * globalToNpc * max = max/diag - min/diag = diag/diag = 1
+         */
         if (globalToNpc) {
             const origin = new _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d(-min.x / diag.x, -min.y / diag.y, -min.z / diag.z);
             _Matrix3d__WEBPACK_IMPORTED_MODULE_2__.Matrix3d.createScale(1.0 / diag.x, 1.0 / diag.y, 1.0 / diag.z, rMatrix);
@@ -288368,7 +288489,7 @@ module.exports = JSON.parse('{"name":"axios","version":"0.21.4","description":"P
 /***/ ((module) => {
 
 "use strict";
-module.exports = JSON.parse('{"name":"@itwin/core-frontend","version":"4.0.0-dev.51","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs","build:ci":"npm run -s build && npm run -s build:esm","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2020 --outDir lib/esm","clean":"rimraf lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","docs":"betools docs --includes=../../generated-docs/extract --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/primitives,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-eslintrc -c \\"./node_modules/@itwin/eslint-plugin/dist/configs/extension-exports-config.js\\" \\"./src/**/*.ts\\" 1>&2","lint":"eslint -f visualstudio \\"./src/**/*.ts\\" 1>&2","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run -s webpackTests && certa -r chrome","cover":"npm -s test","test:debug":"certa -r chrome --debug","webpackTests":"webpack --config ./src/test/utils/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core/tree/master/core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:^4.0.0-dev.51","@itwin/core-bentley":"workspace:^4.0.0-dev.51","@itwin/core-common":"workspace:^4.0.0-dev.51","@itwin/core-geometry":"workspace:^4.0.0-dev.51","@itwin/core-orbitgt":"workspace:^4.0.0-dev.51","@itwin/core-quantity":"workspace:^4.0.0-dev.51"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/certa":"workspace:*","@itwin/eslint-plugin":"nightly","@itwin/webgl-compatibility":"workspace:*","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/deep-assign":"^0.1.0","@types/mocha":"^8.2.2","@types/node":"^18.11.5","@types/qs":"^6.5.0","@types/semver":"7.3.10","@types/superagent":"^4.1.14","@types/sinon":"^9.0.0","babel-loader":"~8.2.5","babel-plugin-istanbul":"~6.1.1","chai":"^4.1.2","chai-as-promised":"^7","cpx2":"^3.0.0","eslint":"^7.11.0","glob":"^7.1.2","mocha":"^10.0.0","nyc":"^15.1.0","rimraf":"^3.0.2","sinon":"^9.0.2","source-map-loader":"^4.0.0","typescript":"~4.4.0","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/object-storage-azure":"^1.5.0","@itwin/cloud-agnostic-core":"^1.5.0","@itwin/object-storage-core":"^1.5.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","deep-assign":"^2.0.0","fuse.js":"^3.3.0","qs":"^6.5.3","semver":"^7.3.5","superagent":"^7.1.5","wms-capabilities":"0.4.0","reflect-metadata":"0.1.13"},"nyc":{"extends":"./node_modules/@itwin/build-tools/.nycrc"},"eslintConfig":{"plugins":["@itwin"],"extends":"plugin:@itwin/itwinjs-recommended","rules":{"@itwin/no-internal-barrel-imports":["error",{"required-barrel-modules":["./src/tile/internal.ts"]}],"@itwin/public-extension-exports":["error",{"releaseTags":["public","preview"],"outputApiFile":false}]},"overrides":[{"files":["*.test.ts","*.test.tsx","**/test/**/*.ts"],"rules":{"@itwin/no-internal-barrel-imports":"off"}}]}}');
+module.exports = JSON.parse('{"name":"@itwin/core-frontend","version":"4.0.0-dev.52","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs","build:ci":"npm run -s build && npm run -s build:esm","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2020 --outDir lib/esm","clean":"rimraf lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","docs":"betools docs --includes=../../generated-docs/extract --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/primitives,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-eslintrc -c \\"./node_modules/@itwin/eslint-plugin/dist/configs/extension-exports-config.js\\" \\"./src/**/*.ts\\" 1>&2","lint":"eslint -f visualstudio \\"./src/**/*.ts\\" 1>&2","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run -s webpackTests && certa -r chrome","cover":"npm -s test","test:debug":"certa -r chrome --debug","webpackTests":"webpack --config ./src/test/utils/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core/tree/master/core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:^4.0.0-dev.52","@itwin/core-bentley":"workspace:^4.0.0-dev.52","@itwin/core-common":"workspace:^4.0.0-dev.52","@itwin/core-geometry":"workspace:^4.0.0-dev.52","@itwin/core-orbitgt":"workspace:^4.0.0-dev.52","@itwin/core-quantity":"workspace:^4.0.0-dev.52"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/certa":"workspace:*","@itwin/eslint-plugin":"nightly","@itwin/webgl-compatibility":"workspace:*","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/deep-assign":"^0.1.0","@types/mocha":"^8.2.2","@types/node":"^18.11.5","@types/qs":"^6.5.0","@types/semver":"7.3.10","@types/superagent":"^4.1.14","@types/sinon":"^9.0.0","babel-loader":"~8.2.5","babel-plugin-istanbul":"~6.1.1","chai":"^4.1.2","chai-as-promised":"^7","cpx2":"^3.0.0","eslint":"^7.11.0","glob":"^7.1.2","mocha":"^10.0.0","nyc":"^15.1.0","rimraf":"^3.0.2","sinon":"^9.0.2","source-map-loader":"^4.0.0","typescript":"~4.4.0","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/object-storage-azure":"^1.5.0","@itwin/cloud-agnostic-core":"^1.5.0","@itwin/object-storage-core":"^1.5.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","deep-assign":"^2.0.0","fuse.js":"^3.3.0","qs":"^6.5.3","semver":"^7.3.5","superagent":"^7.1.5","wms-capabilities":"0.4.0","reflect-metadata":"0.1.13"},"nyc":{"extends":"./node_modules/@itwin/build-tools/.nycrc"},"eslintConfig":{"plugins":["@itwin"],"extends":"plugin:@itwin/itwinjs-recommended","rules":{"@itwin/no-internal-barrel-imports":["error",{"required-barrel-modules":["./src/tile/internal.ts"]}],"@itwin/public-extension-exports":["error",{"releaseTags":["public","preview"],"outputApiFile":false}]},"overrides":[{"files":["*.test.ts","*.test.tsx","**/test/**/*.ts"],"rules":{"@itwin/no-internal-barrel-imports":"off"}}]}}');
 
 /***/ })