@itwin/rpcinterface-full-stack-tests 3.5.0-dev.52 → 3.5.0-dev.53

package/lib/dist/bundled-tests.js

@@ -170147,6 +170147,7 @@ class ArcGisUtilities {
      * @param latitude Latitude in degrees to use to compute scales (i.e 0 for Equator)
      * @param tileSize Size of a tile in pixels (i.e 256)
      * @param screenDpi Monitor resolution in dots per inch (i.e. typically 96dpi is used by Google Maps)
+     *
     * @returns An array containing resolution and scale values for each requested zoom level
      */
     static computeZoomLevelsScales(startZoom = 0, endZoom = 20, latitude = 0, tileSize = 256, screenDpi = 96) {
@@ -170173,20 +170174,20 @@ class ArcGisUtilities {
      * @param maxScale Maximum  scale value that needs to be matched to a LOD level
     * @returns minLod: LOD value matching minScale,  maxLod: LOD value matching maxScale
      */
-    static getZoomLevelsScales(defaultMaxLod, tileSize, minScale, maxScale) {
+    static getZoomLevelsScales(defaultMaxLod, tileSize, minScale, maxScale, tolerance = 0) {
         let minLod, maxLod;
         const zoomScales = ArcGisUtilities.computeZoomLevelsScales(0, defaultMaxLod, 0 /* latitude 0 = Equator*/, tileSize);
         if (zoomScales.length > 0) {
             if (minScale) {
                 minLod = 0;
                 // We are looking for the largest scale value with a scale value smaller than minScale
-                for (; minLod < zoomScales.length && zoomScales[minLod].scale > minScale; minLod++)
+                for (; minLod < zoomScales.length && (zoomScales[minLod].scale > minScale && Math.abs(zoomScales[minLod].scale - minScale) > tolerance); minLod++)
                     ;
             }
             if (maxScale) {
                 maxLod = defaultMaxLod;
                 // We are looking for the smallest scale value with a value greater than maxScale
-                for (; maxLod >= 0 && zoomScales[maxLod].scale < maxScale; maxLod--)
+                for (; maxLod >= 0 && zoomScales[maxLod].scale < maxScale && Math.abs(zoomScales[maxLod].scale - maxScale) > tolerance; maxLod--)
                     ;
             }
         }
@@ -228091,9 +228092,9 @@ __webpack_require__.r(__webpack_exports__);
 /** @packageDocumentation
  * @module CartesianGeometry
  */
-
 /* eslint-disable @typescript-eslint/naming-convention, no-empty */
 
+
 /**
  * Helper object to access members of a Point2d[] in geometric calculations.
  * * The collection holds only a reference to the actual array.
@@ -228113,6 +228114,7 @@ class Point2dArrayCarrier extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_
     }
     /**
      * Access by index, returning strongly typed Point2d
+     * * This returns the xy value but NOT reference to the point in the "carried" array.
      * @param index index of point within the array
      * @param result caller-allocated destination
      * @returns undefined if the index is out of bounds
@@ -228232,11 +228234,20 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 class XY {
-    constructor(x = 0, y = 0) { this.x = x; this.y = y; }
+    constructor(x = 0, y = 0) {
+        this.x = x;
+        this.y = y;
+    }
     /** Set both x and y. */
-    set(x = 0, y = 0) { this.x = x; this.y = y; }
+    set(x = 0, y = 0) {
+        this.x = x;
+        this.y = y;
+    }
     /** Set both x and y to zero */
-    setZero() { this.x = 0; this.y = 0; }
+    setZero() {
+        this.x = 0;
+        this.y = 0;
+    }
     /** Set both x and y from other. */
     setFrom(other) {
         if (other) {
@@ -228249,16 +228260,30 @@ class XY {
         }
     }
     /** Freeze this instance so it is read-only */
-    freeze() { return Object.freeze(this); }
+    freeze() {
+        return Object.freeze(this);
+    }
     /** Returns true if this and other have equal x,y parts within Geometry.smallMetricDistance. */
-    isAlmostEqual(other, tol) { return _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.x, other.x, tol) && _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.y, other.y, tol); }
+    isAlmostEqual(other, tol) {
+        return _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.x, other.x, tol) && _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.y, other.y, tol);
+    }
     /** Returns true if this and other have equal x,y parts within Geometry.smallMetricDistance. */
-    isAlmostEqualXY(x, y, tol) { return _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.x, x, tol) && _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.y, y, tol); }
+    isAlmostEqualXY(x, y, tol) {
+        return _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.x, x, tol) && _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSameCoordinate(this.y, y, tol);
+    }
     /** return a json array  `[x,y]`   */
-    toJSON() { return [this.x, this.y]; }
+    toJSON() {
+        return [this.x, this.y];
+    }
     /** return a json object `{x: 1, y:2}`  */
-    toJSONXY() { return { x: this.x, y: this.y }; }
-    /** Set x and y from a JSON source such as `[1,2]` or `{x:1, y:2}` */
+    toJSONXY() {
+        return { x: this.x, y: this.y };
+    }
+    /**
+     * Set x and y from a JSON input such as `[1,2]` or `{x:1, y:2}`
+     * * If no JSON input is provided, 0 would be used as default values for x and y.
+     * @param json the JSON input
+     * */
     setFromJSON(json) {
         if (Array.isArray(json)) {
             this.set(json[0] || 0, json[1] || 0);
@@ -228274,39 +228299,76 @@ class XY {
     distance(other) {
         const xDist = other.x - this.x;
         const yDist = other.y - this.y;
-        return (Math.sqrt(xDist * xDist + yDist * yDist));
+        return Math.sqrt(xDist * xDist + yDist * yDist);
     }
     /** Return squared distance from this point to other */
     distanceSquared(other) {
         const xDist = other.x - this.x;
         const yDist = other.y - this.y;
-        return (xDist * xDist + yDist * yDist);
+        return xDist * xDist + yDist * yDist;
     }
     /** Return the largest absolute distance between corresponding components */
     maxDiff(other) {
         return Math.max(Math.abs(this.x - other.x), Math.abs(this.y - other.y));
     }
+    /**
+     * Return the x,y component corresponding to 0,1.
+     */
+    at(index) {
+        if (index < 0.5)
+            return this.x;
+        return this.y;
+    }
+    /**
+     * Set value at index 0 or 1.
+     */
+    setAt(index, value) {
+        if (index < 0.5)
+            this.x = value;
+        else
+            this.y = value;
+    }
+    /** Return the index (0,1) of the x,y component with largest absolute value */
+    indexOfMaxAbs() {
+        let index = 0;
+        const a = Math.abs(this.x);
+        const b = Math.abs(this.y);
+        if (b > a) {
+            index = 1;
+        }
+        return index;
+    }
     /** returns true if the x,y components are both small by metric metric tolerance */
     get isAlmostZero() {
         return _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSmallMetricDistance(this.x) && _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isSmallMetricDistance(this.y);
     }
     /** Return the largest absolute value of any component */
-    maxAbs() { return Math.max(Math.abs(this.x), Math.abs(this.y)); }
+    maxAbs() {
+        return Math.max(Math.abs(this.x), Math.abs(this.y));
+    }
     /** Return the magnitude of the vector */
-    magnitude() { return Math.sqrt(this.x * this.x + this.y * this.y); }
+    magnitude() {
+        return Math.sqrt(this.x * this.x + this.y * this.y);
+    }
     /** Return the squared magnitude of the vector.  */
-    magnitudeSquared() { return this.x * this.x + this.y * this.y; }
+    magnitudeSquared() {
+        return this.x * this.x + this.y * this.y;
+    }
     /** returns true if the x,y components are exactly equal. */
-    isExactEqual(other) { return this.x === other.x && this.y === other.y; }
+    isExactEqual(other) {
+        return this.x === other.x && this.y === other.y;
+    }
     /** returns true if x,y match `other` within metric tolerance */
-    isAlmostEqualMetric(other) { return this.maxDiff(other) <= _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.smallMetricDistance; }
+    isAlmostEqualMetric(other, distanceTol = _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.smallMetricDistance) {
+        return this.maxDiff(other) <= distanceTol;
+    }
     /** Return a (full length) vector from this point to other */
     vectorTo(other, result) {
         return Vector2d.create(other.x - this.x, other.y - this.y, result);
     }
     /** Return a unit vector from this point to other */
-    unitVectorTo(target, result) {
-        return this.vectorTo(target, result).normalize(result);
+    unitVectorTo(other, result) {
+        return this.vectorTo(other, result).normalize(result);
     }
     /** cross product of vectors from origin to targets */
     static crossProductToPoints(origin, targetA, targetB) {
@@ -228318,9 +228380,13 @@ class XY {
  */
 class Point2d extends XY {
     /** Constructor for Point2d */
-    constructor(x = 0, y = 0) { super(x, y); }
+    constructor(x = 0, y = 0) {
+        super(x, y);
+    }
     /** return a new Point2d with x,y coordinates from this. */
-    clone(result) { return Point2d.create(this.x, this.y, result); }
+    clone(result) {
+        return Point2d.create(this.x, this.y, result);
+    }
     /**
      * Return a point (newly created unless result provided) with given x,y coordinates
      * @param x x coordinate
@@ -228335,8 +228401,16 @@ class Point2d extends XY {
         }
         return new Point2d(x, y);
     }
-    /** Convert JSON `[1,2]` or `{x:1, y:2}` to a Point2d instance */
-    static fromJSON(json) { const val = new Point2d(); val.setFromJSON(json); return val; }
+    /**
+     * Set x and y from a JSON input such as `[1,2]` or `{x:1, y:2}`
+     * * If no JSON input is provided, 0 would be used as default values for x and y.
+     * @param json the JSON input
+     * */
+    static fromJSON(json) {
+        const val = new Point2d();
+        val.setFromJSON(json);
+        return val;
+    }
     /** Create (or optionally reuse) a Point2d from another object with fields x and y */
     static createFrom(xy, result) {
         if (xy)
@@ -228344,19 +228418,22 @@ class Point2d extends XY {
         return Point2d.create(0, 0, result);
     }
     /** Create a Point2d with both coordinates zero. */
-    static createZero(result) { return Point2d.create(0, 0, result); }
-    /** Starting at this point, move along vector by tangentFraction of the vector length, and to the left by leftFraction of
-     * the perpendicular vector length.
+    static createZero(result) {
+        return Point2d.create(0, 0, result);
+    }
+    /** Starting at this point, move along vector by tangentFraction of the vector length, and then
+     * to the left by leftFraction of the perpendicular vector length.
      * @param tangentFraction distance to move along the vector, as a fraction of vector
      * @param leftFraction distance to move perpendicular to the vector, as a fraction of the rotated vector
+     * @param vector the other vector
      */
     addForwardLeft(tangentFraction, leftFraction, vector) {
         const dx = vector.x;
         const dy = vector.y;
         return Point2d.create(this.x + tangentFraction * dx - leftFraction * dy, this.y + tangentFraction * dy + leftFraction * dx);
     }
-    /** Interpolate at tangentFraction between this instance and point.   Move by leftFraction along the xy perpendicular
-     * of the vector between the points.
+    /** Interpolate at tangentFraction between this instance and point, and then Move by leftFraction
+     * along the xy perpendicular of the vector between the points.
      */
     forwardLeftInterpolate(tangentFraction, leftFraction, point) {
         const dx = point.x - this.x;
@@ -228404,10 +228481,13 @@ class Point2d extends XY {
      * @param targetB target of second vector
      */
     dotVectorsToTargets(targetA, targetB) {
-        return (targetA.x - this.x) * (targetB.x - this.x) +
-            (targetA.y - this.y) * (targetB.y - this.y);
+        return (targetA.x - this.x) * (targetB.x - this.x) + (targetA.y - this.y) * (targetB.y - this.y);
     }
-    /** Returns the (scalar) cross product of two points/vectors, computed from origin to target1 and target2 */
+    /**
+     * Returns the (scalar) cross product of vector from this to targetA and vector from this to targetB
+     * @param target1 target of first vector
+     * @param target2 target of second vector
+     */
     crossProductToPoints(target1, target2) {
         const x1 = target1.x - this.x;
         const y1 = target1.y - this.y;
@@ -228415,25 +228495,31 @@ class Point2d extends XY {
         const y2 = target2.y - this.y;
         return x1 * y2 - y1 * x2;
     }
-    /** Return the fractional coordinate of the projection of this instance x,y onto the line from startPoint to endPoint.
+    /** Return the fractional coordinate of the projection of this instance x,y onto the
+     * line from startPoint to endPoint.
      * @param startPoint start point of line
      * @param endPoint end point of line
      * @param defaultFraction fraction to return if startPoint and endPoint are equal.
      */
-    fractionOfProjectionToLine(startPoint, endPoint, defaultFraction) {
+    fractionOfProjectionToLine(startPoint, endPoint, defaultFraction = 0) {
         const denominator = startPoint.distanceSquared(endPoint);
         if (denominator < _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.smallMetricDistanceSquared)
-            return defaultFraction ? defaultFraction : 0;
-        return startPoint.dotVectorsToTargets(endPoint, this) / denominator;
+            return defaultFraction;
+        const numerator = startPoint.dotVectorsToTargets(endPoint, this);
+        return numerator / denominator;
     }
 }
 /** 2D vector with `x`,`y` as properties
  * @public
  */
 class Vector2d extends XY {
-    constructor(x = 0, y = 0) { super(x, y); }
+    constructor(x = 0, y = 0) {
+        super(x, y);
+    }
     /** Return a new Vector2d with the same x,y */
-    clone(result) { return Vector2d.create(this.x, this.y, result); }
+    clone(result) {
+        return Vector2d.create(this.x, this.y, result);
+    }
     /** Return a new Vector2d with given x and y */
     static create(x = 0, y = 0, result) {
         if (result) {
@@ -228443,12 +228529,24 @@ class Vector2d extends XY {
         }
         return new Vector2d(x, y);
     }
-    /** Return a (new) Vector2d with components 1,0 */
-    static unitX(scale = 1) { return new Vector2d(scale, 0); }
-    /** Return a (new) Vector2d with components 0,1 */
-    static unitY(scale = 1) { return new Vector2d(0, scale); }
+    /**
+     * Return a (new) Vector2d with components scale,0
+     * If scale is not given default value 1 is used.
+     */
+    static unitX(scale = 1) {
+        return new Vector2d(scale, 0);
+    }
+    /**
+     * Return a (new) Vector2d with components 0,scale
+     * If scale is not given default value 1 is used.
+     */
+    static unitY(scale = 1) {
+        return new Vector2d(0, scale);
+    }
     /** Return a Vector2d with components 0,0 */
-    static createZero(result) { return Vector2d.create(0, 0, result); }
+    static createZero(result) {
+        return Vector2d.create(0, 0, result);
+    }
     /** copy contents from another Point3d, Point2d, Vector2d, or Vector3d, or leading entries of Float64Array */
     static createFrom(data, result) {
         if (data instanceof Float64Array) {
@@ -228460,8 +228558,16 @@ class Vector2d extends XY {
         }
         return Vector2d.create(data.x, data.y, result);
     }
-    /** Return a new Vector2d from json structured as `[1,2]` or `{x:1,y:2}` */
-    static fromJSON(json) { const val = new Vector2d(); val.setFromJSON(json); return val; }
+    /**
+     * Set x and y from a JSON input such as `[1,2]` or `{x:1, y:2}`
+     * * If no JSON input is provided, 0 would be used as default values for x and y.
+     * @param json the JSON input
+     * */
+    static fromJSON(json) {
+        const val = new Vector2d();
+        val.setFromJSON(json);
+        return val;
+    }
     /** Return a new Vector2d from polar coordinates for radius and Angle from x axis */
     static createPolar(r, theta) {
         return Vector2d.create(r * theta.cos(), r * theta.sin());
@@ -228472,6 +228578,7 @@ class Vector2d extends XY {
     }
     /**
      * Return a vector that bisects the angle between two normals and extends to the intersection of two offset lines
+     * * returns `undefined` if `unitPerpA = -unitPerpB` (i.e., are opposite)
      * @param unitPerpA unit perpendicular to incoming direction
      * @param unitPerpB  unit perpendicular to outgoing direction
      * @param offset offset distance
@@ -228480,12 +228587,13 @@ class Vector2d extends XY {
         let bisector = unitPerpA.plus(unitPerpB);
         bisector = bisector.normalize();
         if (bisector) {
-            const c = offset * bisector.dotProduct(unitPerpA);
+            const c = bisector.dotProduct(unitPerpA);
+            bisector.scale(offset, bisector);
             return bisector.safeDivideOrNull(c);
         }
         return undefined;
     }
-    /** Return a (new or optionally reused) vector which is `this` divided by denominator
+    /** Return a (new or optionally reused) vector which is `this` divided by `denominator`
      * * return undefined if denominator is zero.
      */
     safeDivideOrNull(denominator, result) {
@@ -228500,12 +228608,22 @@ class Vector2d extends XY {
         result = result ? result : new Vector2d();
         return this.safeDivideOrNull(mag, result);
     }
-    /** return the fractional projection of spaceVector onto this */
+    /**
+     * Return fractional projection of target vector onto this
+     * * It's returning the signed projection magnitude divided by the target magnitude. In other words,
+     * it's returning the length of the projection as a fraction of the target magnitude.
+     * @param target the target vector
+     * @param defaultFraction the returned value in case magnitude square of target vector is very small
+     * */
     fractionOfProjectionToVector(target, defaultFraction) {
-        const numerator = this.dotProduct(target);
+        /*
+         * projection length is (this.target)/||target||
+         * but here we return (this.target)/||target||^2
+         */
         const denominator = target.magnitudeSquared();
         if (denominator < _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.smallMetricDistanceSquared)
             return defaultFraction ? defaultFraction : 0;
+        const numerator = this.dotProduct(target);
         return numerator / denominator;
     }
     /** Return a new vector with components negated from this instance. */
@@ -228518,7 +228636,7 @@ class Vector2d extends XY {
     /** Return a vector same length as this but rotated 90 degrees counter clockwise */
     rotate90CCWXY(result) {
         result = result ? result : new Vector2d();
-        // save x,y to allow aliasing ..
+        // save x,y to allow aliasing ("this" can be passed to the function as "result")
         const xx = this.x;
         const yy = this.y;
         result.x = -yy;
@@ -228528,7 +228646,7 @@ class Vector2d extends XY {
     /** Return a vector same length as this but rotated 90 degrees clockwise */
     rotate90CWXY(result) {
         result = result ? result : new Vector2d();
-        // save x,y to allow aliasing ..
+        // save x,y to allow aliasing ("this" can be passed to the function as "result")
         const xx = this.x;
         const yy = this.y;
         result.x = yy;
@@ -228540,6 +228658,7 @@ class Vector2d extends XY {
         result = result ? result : new Vector2d();
         const xx = this.x;
         const yy = this.y;
+        // save x,y to allow aliasing ("this" can be passed to the function as "result")
         result.x = -yy;
         result.y = xx;
         const d2 = xx * xx + yy * yy;
@@ -228554,6 +228673,7 @@ class Vector2d extends XY {
     rotateXY(angle, result) {
         const s = angle.sin();
         const c = angle.cos();
+        // save x,y to allow aliasing ("this" can be passed to the function as "result")
         const xx = this.x;
         const yy = this.y;
         result = result ? result : new Vector2d();
@@ -228561,18 +228681,26 @@ class Vector2d extends XY {
         result.y = xx * s + yy * c;
         return result;
     }
-    /** return the interpolation {this + fraction * (right - this)} */
-    interpolate(fraction, right, result) {
+    /** Return a vector computed at fractional position between this vector and vectorB
+    * @param fraction fractional position.  0 is at `this`.  1 is at `vectorB`.
+    *                 True fractions are "between", negatives are "before this", beyond 1 is "beyond vectorB".
+    * @param vectorB second vector
+    * @param result optional preallocated result.
+    */
+    interpolate(fraction, vectorB, result) {
         result = result ? result : new Vector2d();
-        /* For best last-bit behavior, if fraction is below 0.5, use this as base point.   If above 0.5, use right as base point.   */
+        /*
+         * For best last-bit behavior, if fraction is below 0.5, use this as base point.
+         * If above 0.5, use vectorB as base point.
+         */
         if (fraction <= 0.5) {
-            result.x = this.x + fraction * (right.x - this.x);
-            result.y = this.y + fraction * (right.y - this.y);
+            result.x = this.x + fraction * (vectorB.x - this.x);
+            result.y = this.y + fraction * (vectorB.y - this.y);
         }
         else {
             const t = fraction - 1.0;
-            result.x = right.x + t * (right.x - this.x);
-            result.y = right.y + t * (right.y - this.y);
+            result.x = vectorB.x + t * (vectorB.x - this.x);
+            result.y = vectorB.y + t * (vectorB.y - this.y);
         }
         return result;
     }
@@ -228626,16 +228754,19 @@ class Vector2d extends XY {
         return this.scale(length / mag, result);
     }
     /** return the dot product of this with vectorB */
-    dotProduct(vectorB) { return this.x * vectorB.x + this.y * vectorB.y; }
+    dotProduct(vectorB) {
+        return this.x * vectorB.x + this.y * vectorB.y;
+    }
     /** dot product with vector from pointA to pointB */
     dotProductStartEnd(pointA, pointB) {
-        return this.x * (pointB.x - pointA.x)
-            + this.y * (pointB.y - pointA.y);
+        return this.x * (pointB.x - pointA.x) + this.y * (pointB.y - pointA.y);
     }
     /** vector cross product {this CROSS vectorB} */
-    crossProduct(vectorB) { return this.x * vectorB.y - this.y * vectorB.x; }
+    crossProduct(vectorB) {
+        return this.x * vectorB.y - this.y * vectorB.x;
+    }
     /**
-     * return the (radians as a simple number, not strongly typed Angle) signed angle from this to vectorB.
+     * return the radians (as a simple number, not strongly typed Angle) signed angle from this to vectorB.
      * This is positive if the shortest turn is counterclockwise, negative if clockwise.
      */
     radiansTo(vectorB) {
@@ -228648,13 +228779,6 @@ class Vector2d extends XY {
     angleTo(vectorB) {
         return _Angle__WEBPACK_IMPORTED_MODULE_1__.Angle.createRadians(this.radiansTo(vectorB));
     }
-    /*  smallerUnorientedAngleTo(vectorB: Vector2d): Angle { }
-      signedAngleTo(vectorB: Vector2d, upVector: Vector2d): Angle { }
-      planarAngleTo(vectorB: Vector2d, planeNormal: Vector2d): Angle { }
-      // sectors
-      isInSmallerSector(vectorA: Vector2d, vectorB: Vector2d): boolean { }
-      isInCCWSector(vectorA: Vector2d, vectorB: Vector2d, upVector: Vector2d): boolean { }
-      */
     /**
      * Test if this vector is parallel to other.
      * * The input tolerances in `options`, if given, are considered to be squared for efficiency's sake,
@@ -228745,6 +228869,7 @@ class Point3dArrayCarrier extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE
     }
     /**
      * Access by index, returning strongly typed Point3d
+     * * This returns the xyz value but NOT reference to the point in the "carried" array.
      * @param index index of point within the array
      * @param result caller-allocated destination
      * @returns undefined if the index is out of bounds
@@ -228780,15 +228905,24 @@ class Point3dArrayCarrier extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE
         }
         return undefined;
     }
-    /** access x of indexed point */
+    /**
+     * access x of indexed point
+     * * WARNING: make sure `pointIndex` is a valid index, otherwise, you get random results
+     * */
     getXAtUncheckedPointIndex(pointIndex) {
         return this.data[pointIndex].x;
     }
-    /** access y of indexed point */
+    /**
+     * access y of indexed point
+     * * WARNING: make sure `pointIndex` is a valid index, otherwise, you get random results
+     * */
     getYAtUncheckedPointIndex(pointIndex) {
         return this.data[pointIndex].y;
     }
-    /** access z of indexed point */
+    /**
+     * access z of indexed point
+     * * WARNING: make sure `pointIndex` is a valid index, otherwise, you get random results
+     * */
     getZAtUncheckedPointIndex(pointIndex) {
         return this.data[pointIndex].z;
     }
@@ -228856,7 +228990,7 @@ class Point3dArrayCarrier extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE
             result.addCrossProductToTargetsInPlace(data[originIndex].x, data[originIndex].y, data[originIndex].z, data[indexA].x, data[indexA].y, data[indexA].z, data[indexB].x, data[indexB].y, data[indexB].z);
     }
     /**
-     * Accumulate scale times the x,y,z values at index.
+     * Accumulate scale times the x,y,z values at index to the sum.
      * No action if index is out of bounds.
      */
     accumulateScaledXYZ(index, scale, sum) {
@@ -228946,7 +229080,7 @@ class Point3dArrayCarrier extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE
     }
     /** Adjust index into range by modulo with the length. */
     cyclicIndex(i) {
-        return (i % this.length);
+        return (i % this.data.length);
     }
 }
 
@@ -228976,6 +229110,7 @@ __webpack_require__.r(__webpack_exports__);
 /** @packageDocumentation
  * @module CartesianGeometry
  */
+// cspell:word CWXY
 
 
 
@@ -229210,7 +229345,7 @@ class XYZ {
         return this.y;
     }
     /**
-     * Return the x,y, z component corresponding to 0,1,2.
+     * Set value at index 0 or 1 or 2.
      */
     setAt(index, value) {
         if (index < 0.5)
@@ -229873,6 +230008,17 @@ class Vector3d extends XYZ {
         result.z = this.z;
         return result;
     }
+    /** Return a vector same length as this but rotated 90 degrees clockwise */
+    rotate90CWXY(result) {
+        result = result ? result : new Vector3d();
+        // save x,y to allow aliasing ("this" can be passed to the function as "result")
+        const xx = this.x;
+        const yy = this.y;
+        result.x = yy;
+        result.y = -xx;
+        result.z = this.z;
+        return result;
+    }
     /**
      * Return a vector which is in the xy plane, perpendicular ot the xy part of this vector, and of unit length.
      * * If the xy part is 00, the return is the rotated (but not normalized) xy parts of this vector.
@@ -229882,6 +230028,7 @@ class Vector3d extends XYZ {
         result = result ? result : new Vector3d();
         const xx = this.x;
         const yy = this.y;
+        // save x,y to allow aliasing ("this" can be passed to the function as "result")
         result.x = -yy;
         result.y = xx;
         result.z = 0.0;
@@ -229942,6 +230089,10 @@ class Vector3d extends XYZ {
      */
     interpolate(fraction, vectorB, result) {
         result = result ? result : new Vector3d();
+        /*
+         * For best last-bit behavior, if fraction is below 0.5, use this as base point.
+         * If above 0.5, use vectorB as base point.
+         */
         if (fraction <= 0.5) {
             result.x = this.x + fraction * (vectorB.x - this.x);
             result.y = this.y + fraction * (vectorB.y - this.y);
@@ -291959,7 +292110,7 @@ class TestContext {
         this.initializeRpcInterfaces({ title: this.settings.Backend.name, version: this.settings.Backend.version });
         const iModelClient = new imodels_client_management_1.IModelsClient({ api: { baseUrl: `https://${(_a = process.env.IMJS_URL_PREFIX) !== null && _a !== void 0 ? _a : ""}api.bentley.com/imodels` } });
         await core_frontend_1.NoRenderApp.startup({
-            applicationVersion: "3.5.0-dev.52",
+            applicationVersion: "3.5.0-dev.53",
             applicationId: this.settings.gprid,
             authorizationClient: new frontend_1.TestFrontendAuthorizationClient(this.adminUserAccessToken),
             hubAccess: new imodels_access_frontend_1.FrontendIModelsAccess(iModelClient),
@@ -311028,7 +311179,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":"3.5.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 \\"../../tools/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:^3.5.0-dev.52","@itwin/core-bentley":"workspace:^3.5.0-dev.52","@itwin/core-common":"workspace:^3.5.0-dev.52","@itwin/core-geometry":"workspace:^3.5.0-dev.52","@itwin/core-orbitgt":"workspace:^3.5.0-dev.52","@itwin/core-quantity":"workspace:^3.5.0-dev.52","@itwin/webgl-compatibility":"workspace:^3.5.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":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/deep-assign":"^0.1.0","@types/lodash":"^4.14.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.64.4"},"//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.4.0","@itwin/cloud-agnostic-core":"~1.4.0","@itwin/object-storage-core":"~1.4.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","deep-assign":"^2.0.0","fuse.js":"^3.3.0","lodash":"^4.17.10","qs":"^6.5.1","semver":"^7.3.5","superagent":"7.1.3","wms-capabilities":"0.4.0","xml-js":"~1.6.11","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":"3.5.0-dev.53","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 \\"../../tools/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:^3.5.0-dev.53","@itwin/core-bentley":"workspace:^3.5.0-dev.53","@itwin/core-common":"workspace:^3.5.0-dev.53","@itwin/core-geometry":"workspace:^3.5.0-dev.53","@itwin/core-orbitgt":"workspace:^3.5.0-dev.53","@itwin/core-quantity":"workspace:^3.5.0-dev.53","@itwin/webgl-compatibility":"workspace:^3.5.0-dev.53"},"//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":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/deep-assign":"^0.1.0","@types/lodash":"^4.14.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.64.4"},"//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.4.0","@itwin/cloud-agnostic-core":"~1.4.0","@itwin/object-storage-core":"~1.4.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","deep-assign":"^2.0.0","fuse.js":"^3.3.0","lodash":"^4.17.10","qs":"^6.5.1","semver":"^7.3.5","superagent":"7.1.3","wms-capabilities":"0.4.0","xml-js":"~1.6.11","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"}}]}}');
 
 /***/ }),