@itwin/ecschema-rpcinterface-tests 3.5.0-dev.52 → 3.5.0-dev.57

package/lib/dist/bundled-tests.js

@@ -179494,6 +179494,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) {
@@ -179520,20 +179521,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--)
                     ;
             }
         }
@@ -192915,7 +192916,7 @@ class Tool {
     }
     static getLocalizedKey(name) {
         const key = `tools.${this.toolId}.${name}`;
-        const val = _IModelApp__WEBPACK_IMPORTED_MODULE_5__.IModelApp.localization.getLocalizedStringWithNamespace(this.namespace, key);
+        const val = _IModelApp__WEBPACK_IMPORTED_MODULE_5__.IModelApp.localization.getLocalizedString(key, { ns: this.namespace });
         return key === val ? undefined : val; // if translation for key doesn't exist, `translate` returns the key as the result
     }
     /**
@@ -200835,8 +200836,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _geometry4d_Point4d__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../geometry4d/Point4d */ "../../core/geometry/lib/esm/geometry4d/Point4d.js");
 /* harmony import */ var _numerics_BezierPolynomials__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ../numerics/BezierPolynomials */ "../../core/geometry/lib/esm/numerics/BezierPolynomials.js");
 /* harmony import */ var _Bezier1dNd__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./Bezier1dNd */ "../../core/geometry/lib/esm/bspline/Bezier1dNd.js");
-/* harmony import */ var _BezierCurve3d__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(/*! ./BezierCurve3d */ "../../core/geometry/lib/esm/bspline/BezierCurve3d.js");
-/* harmony import */ var _BezierCurve3dH__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./BezierCurve3dH */ "../../core/geometry/lib/esm/bspline/BezierCurve3dH.js");
+/* harmony import */ var _BezierCurve3d__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./BezierCurve3d */ "../../core/geometry/lib/esm/bspline/BezierCurve3d.js");
+/* harmony import */ var _BezierCurve3dH__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(/*! ./BezierCurve3dH */ "../../core/geometry/lib/esm/bspline/BezierCurve3dH.js");
 /* harmony import */ var _BSpline1dNd__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./BSpline1dNd */ "../../core/geometry/lib/esm/bspline/BSpline1dNd.js");
 /* harmony import */ var _BSplineCurveOps__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(/*! ./BSplineCurveOps */ "../../core/geometry/lib/esm/bspline/BSplineCurveOps.js");
 /* harmony import */ var _KnotVector__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./KnotVector */ "../../core/geometry/lib/esm/bspline/KnotVector.js");
@@ -201160,7 +201161,7 @@ class BSplineCurve3d extends BSplineCurve3dBase {
     }
     initializeWorkBezier() {
         if (this._workBezier === undefined)
-            this._workBezier = _BezierCurve3dH__WEBPACK_IMPORTED_MODULE_12__.BezierCurve3dH.createOrder(this.order);
+            this._workBezier = _BezierCurve3d__WEBPACK_IMPORTED_MODULE_12__.BezierCurve3d.createOrder(this.order);
         return this._workBezier;
     }
     /** test of `other` is an instance of BSplineCurve3d */
@@ -201201,7 +201202,7 @@ class BSplineCurve3d extends BSplineCurve3dBase {
     /** Create a bspline with uniform knots. */
     static createUniformKnots(poles, order) {
         const numPoles = poles instanceof Float64Array ? poles.length / 3 : poles.length;
-        if (order < 1 || numPoles < order)
+        if (order < 2 || numPoles < order)
             return undefined;
         const knots = _KnotVector__WEBPACK_IMPORTED_MODULE_3__.KnotVector.createUniformClamped(numPoles, order - 1, 0.0, 1.0);
         const curve = new BSplineCurve3d(numPoles, order, knots);
@@ -201223,11 +201224,32 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         return curve;
     }
     /** Create a smoothly closed B-spline curve with uniform knots.
-     *  Note that the curve does not start at the first pole, and first and last poles should be distinct.
+     *  Note that the curve does not start at the first pole!
     */
     static createPeriodicUniformKnots(poles, order) {
-        const numPoles = poles instanceof Float64Array ? poles.length / 3 : poles.length;
-        if (order < 1 || numPoles < order)
+        if (order < 2)
+            return undefined;
+        let numPoles = poles instanceof Float64Array ? poles.length / 3 : poles.length;
+        const startPoint = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_14__.Point3d.createZero();
+        const endPoint = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_14__.Point3d.createZero();
+        let hasClosurePoint = false;
+        do {
+            if (poles instanceof Float64Array) {
+                startPoint.set(poles[0], poles[1], poles[2]);
+                endPoint.set(poles[3 * numPoles - 3], poles[3 * numPoles - 2], poles[3 * numPoles - 1]);
+            }
+            else if (poles instanceof _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_15__.GrowableXYZArray) {
+                startPoint.set(poles.float64Data()[0], poles.float64Data()[1], poles.float64Data()[2]);
+                endPoint.set(poles.float64Data()[3 * numPoles - 3], poles.float64Data()[3 * numPoles - 2], poles.float64Data()[3 * numPoles - 1]);
+            }
+            else {
+                startPoint.setFromPoint3d(poles[0]);
+                endPoint.setFromPoint3d(poles[numPoles - 1]);
+            }
+            if (hasClosurePoint = startPoint.isAlmostEqual(endPoint))
+                --numPoles; // remove wraparound pole if found
+        } while (hasClosurePoint && numPoles > 1);
+        if (numPoles < order)
             return undefined;
         const degree = order - 1;
         const numIntervals = numPoles;
@@ -201248,10 +201270,10 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         }
         else {
             let i = 0;
-            for (const p of poles) {
-                curve._bcurve.packedData[i++] = p.x;
-                curve._bcurve.packedData[i++] = p.y;
-                curve._bcurve.packedData[i++] = p.z;
+            for (let j = 0; j < numPoles; j++) {
+                curve._bcurve.packedData[i++] = poles[j].x;
+                curve._bcurve.packedData[i++] = poles[j].y;
+                curve._bcurve.packedData[i++] = poles[j].z;
             }
             for (let j = 0; j < degree; j++) {
                 curve._bcurve.packedData[i++] = poles[j].x;
@@ -201292,7 +201314,7 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         const numKnots = knotArray.length;
         // shift knots-of-interest limits for overclamped case ...
         const skipFirstAndLast = (numPoles + order === numKnots);
-        if (order < 1 || numPoles < order)
+        if (order < 2 || numPoles < order)
             return undefined;
         const knots = _KnotVector__WEBPACK_IMPORTED_MODULE_3__.KnotVector.create(knotArray, order - 1, skipFirstAndLast);
         const curve = new BSplineCurve3d(numPoles, order, knots);
@@ -201392,7 +201414,7 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         const numSpan = this.numSpan;
         let numStroke = 0;
         for (let spanIndex = 0; spanIndex < numSpan; spanIndex++) {
-            const bezier = this.getSaturatedBezierSpan3dH(spanIndex, workBezier);
+            const bezier = this.getSaturatedBezierSpan3d(spanIndex, workBezier);
             if (bezier)
                 numStroke += bezier.computeStrokeCountForOptions(options);
         }
@@ -201409,7 +201431,7 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         const numSpan = this.numSpan;
         const myData = _curve_Query_StrokeCountMap__WEBPACK_IMPORTED_MODULE_19__.StrokeCountMap.createWithCurvePrimitiveAndOptionalParent(this, parentStrokeMap, []);
         for (let spanIndex = 0; spanIndex < numSpan; spanIndex++) {
-            const bezier = this.getSaturatedBezierSpan3dH(spanIndex, workBezier);
+            const bezier = this.getSaturatedBezierSpan3d(spanIndex, workBezier);
             if (bezier) {
                 const segmentLength = workBezier.curveLength();
                 const numStrokeOnSegment = workBezier.computeStrokeCountForOptions(options);
@@ -201423,7 +201445,7 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         const workBezier = this.initializeWorkBezier();
         const numSpan = this.numSpan;
         for (let spanIndex = 0; spanIndex < numSpan; spanIndex++) {
-            const bezier = this.getSaturatedBezierSpan3dH(spanIndex, workBezier);
+            const bezier = this.getSaturatedBezierSpan3d(spanIndex, workBezier);
             if (bezier)
                 bezier.emitStrokes(dest, options);
         }
@@ -201462,8 +201484,8 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         if (spanIndex < 0 || spanIndex >= this.numSpan)
             return undefined;
         const order = this.order;
-        if (result === undefined || !(result instanceof _BezierCurve3d__WEBPACK_IMPORTED_MODULE_20__.BezierCurve3d) || result.order !== order)
-            result = _BezierCurve3d__WEBPACK_IMPORTED_MODULE_20__.BezierCurve3d.createOrder(order);
+        if (result === undefined || !(result instanceof _BezierCurve3d__WEBPACK_IMPORTED_MODULE_12__.BezierCurve3d) || result.order !== order)
+            result = _BezierCurve3d__WEBPACK_IMPORTED_MODULE_12__.BezierCurve3d.createOrder(order);
         const bezier = result;
         bezier.loadSpanPoles(this._bcurve.packedData, spanIndex);
         if (bezier.saturateInPlace(this._bcurve.knots, spanIndex))
@@ -201479,8 +201501,8 @@ class BSplineCurve3d extends BSplineCurve3dBase {
         if (spanIndex < 0 || spanIndex >= this.numSpan)
             return undefined;
         const order = this.order;
-        if (result === undefined || !(result instanceof _BezierCurve3dH__WEBPACK_IMPORTED_MODULE_12__.BezierCurve3dH) || result.order !== order)
-            result = _BezierCurve3dH__WEBPACK_IMPORTED_MODULE_12__.BezierCurve3dH.createOrder(order);
+        if (result === undefined || !(result instanceof _BezierCurve3dH__WEBPACK_IMPORTED_MODULE_20__.BezierCurve3dH) || result.order !== order)
+            result = _BezierCurve3dH__WEBPACK_IMPORTED_MODULE_20__.BezierCurve3dH.createOrder(order);
         const bezier = result;
         bezier.loadSpan3dPolesWithWeight(this._bcurve.packedData, spanIndex, 1.0);
         if (bezier.saturateInPlace(this._bcurve.knots, spanIndex))
@@ -205091,7 +205113,10 @@ class InterpolationCurve3d extends _curve_ProxyCurve__WEBPACK_IMPORTED_MODULE_4_
         this._options = properties;
     }
     dispatchToGeometryHandler(handler) {
-        return handler.handleInterpolationCurve3d(this);
+        let result = handler.handleInterpolationCurve3d(this);
+        if (undefined === result) // if handler doesn't specialize on interpolation curves, default to proxy
+            result = this._proxyCurve.dispatchToGeometryHandler(handler);
+        return result;
     }
     /**
      * Create an [[InterpolationCurve3d]] based on points, knots, and other properties in the [[InterpolationCurve3dProps]] or [[InterpolationCurve3dOptions]].
@@ -211886,7 +211911,10 @@ class Arc3d extends _CurvePrimitive__WEBPACK_IMPORTED_MODULE_0__.CurvePrimitive
     getPlaneAltitudeSineCosinePolynomial(plane, result) {
         if (!result)
             result = new _numerics_Polynomials__WEBPACK_IMPORTED_MODULE_5__.SineCosinePolynomial(0, 0, 0);
-        result.set(plane.altitude(this._center), plane.altitudeXYZ(this._matrix.coffs[0], this._matrix.coffs[3], this._matrix.coffs[6]), plane.altitudeXYZ(this._matrix.coffs[1], this._matrix.coffs[4], this._matrix.coffs[7]));
+        // altitude function of angle t, given plane with origin o and unit normal n:
+        //  A(t) = (c + u cos(t) + v sin(t)) . n = (c-o).n + u.n cos(t) + v.n sin(t)
+        // Note the different functions for computing dot product against a point vs. a vector!
+        result.set(plane.altitude(this._center), plane.velocityXYZ(this._matrix.coffs[0], this._matrix.coffs[3], this._matrix.coffs[6]), plane.velocityXYZ(this._matrix.coffs[1], this._matrix.coffs[4], this._matrix.coffs[7]));
         return result;
     }
     /**
@@ -222312,8 +222340,9 @@ class RegionOps {
      * @param distanceTolerance optional absolute distance tolerance
     */
     static computeXYAreaTolerance(range, distanceTolerance = _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.smallMetricDistance) {
-        // if A = bh and e is distance tolerance, then A' := (b+e)(h+e) = A + e(b+h+e), so A'-A = e(b+h+e).
-        return distanceTolerance * (range.xLength() + range.yLength() + distanceTolerance);
+        // if A = bh and e is distance tolerance, then A' := (b+e/2)(h+e/2) = A + e/2(b+h+e/2), so A'-A = e/2(b+h+e/2).
+        const halfDistTol = 0.5 * distanceTolerance;
+        return halfDistTol * (range.xLength() + range.yLength() + halfDistTol);
     }
     /**
      * Return an xy area for a loop, parity region, or union region.
@@ -222917,10 +222946,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _LineSegment3d__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ./LineSegment3d */ "../../core/geometry/lib/esm/curve/LineSegment3d.js");
 /* harmony import */ var _Arc3d__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(/*! ./Arc3d */ "../../core/geometry/lib/esm/curve/Arc3d.js");
 /* harmony import */ var _geometry3d_Range__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../geometry3d/Range */ "../../core/geometry/lib/esm/geometry3d/Range.js");
-/* harmony import */ var _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ../geometry3d/Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
-/* harmony import */ var _internalContexts_PlaneAltitudeRangeContext__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(/*! ./internalContexts/PlaneAltitudeRangeContext */ "../../core/geometry/lib/esm/curve/internalContexts/PlaneAltitudeRangeContext.js");
+/* harmony import */ var _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(/*! ../geometry3d/Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
+/* harmony import */ var _internalContexts_PlaneAltitudeRangeContext__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./internalContexts/PlaneAltitudeRangeContext */ "../../core/geometry/lib/esm/curve/internalContexts/PlaneAltitudeRangeContext.js");
 /* harmony import */ var _GeometryQuery__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./GeometryQuery */ "../../core/geometry/lib/esm/curve/GeometryQuery.js");
-/* harmony import */ var _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(/*! ../geometry3d/Ray3d */ "../../core/geometry/lib/esm/geometry3d/Ray3d.js");
+/* harmony import */ var _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(/*! ../geometry3d/Ray3d */ "../../core/geometry/lib/esm/geometry3d/Ray3d.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -223354,9 +223383,8 @@ class RegionBooleanContext {
         const rangeB = this.groupB.range();
         const rangeAB = rangeA.union(rangeB);
         const areaTol = _RegionOps__WEBPACK_IMPORTED_MODULE_1__.RegionOps.computeXYAreaTolerance(rangeAB);
-        const direction = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_12__.Vector3d.create(1.0, -0.12328974132467);
         let margin = 0.1;
-        this._workSegment = _internalContexts_PlaneAltitudeRangeContext__WEBPACK_IMPORTED_MODULE_13__.PlaneAltitudeRangeContext.findExtremePointsInDirection(rangeAB.corners(), direction, this._workSegment);
+        this._workSegment = _internalContexts_PlaneAltitudeRangeContext__WEBPACK_IMPORTED_MODULE_12__.PlaneAltitudeRangeContext.findExtremePointsInDirection(rangeAB.corners(), RegionBooleanContext._bridgeDirection, this._workSegment);
         if (this._workSegment)
             margin *= this._workSegment.point0Ref.distanceXY(this._workSegment.point1Ref); // how much further to extend each bridge ray
         const maxPoints = [];
@@ -223364,7 +223392,7 @@ class RegionBooleanContext {
             const area = _RegionOps__WEBPACK_IMPORTED_MODULE_1__.RegionOps.computeXYArea(region);
             if (area === undefined || Math.abs(area) < areaTol)
                 return; // avoid bridging trivial faces
-            this._workSegment = _internalContexts_PlaneAltitudeRangeContext__WEBPACK_IMPORTED_MODULE_13__.PlaneAltitudeRangeContext.findExtremePointsInDirection(region, direction, this._workSegment);
+            this._workSegment = _internalContexts_PlaneAltitudeRangeContext__WEBPACK_IMPORTED_MODULE_12__.PlaneAltitudeRangeContext.findExtremePointsInDirection(region, RegionBooleanContext._bridgeDirection, this._workSegment);
             if (this._workSegment)
                 maxPoints.push(this._workSegment.point1Ref);
         };
@@ -223379,8 +223407,7 @@ class RegionBooleanContext {
                 }
             }
         }
-        const ray = _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_14__.Ray3d.createZero();
-        direction.normalizeInPlace();
+        const ray = _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_13__.Ray3d.createZero();
         for (const p of maxPoints) {
             // Make a line from...
             //  1) exactly the max point of the loops to
@@ -223388,8 +223415,8 @@ class RegionBooleanContext {
             // If p came from some inner loop this will...
             //  1) create a bridge from the inner loop through any containing loops (always)
             //  2) avoid crossing any containing loop at a vertex. (with high probability, but not absolutely always)
-            const bridgeLength = margin + _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_14__.Ray3d.create(p, direction, ray).intersectionWithRange3d(rangeAB).high;
-            const outside = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_12__.Point3d.createAdd2Scaled(p, 1.0, direction, bridgeLength);
+            const bridgeLength = margin + _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_13__.Ray3d.create(p, RegionBooleanContext._bridgeDirection, ray).intersectionWithRange3d(rangeAB).high;
+            const outside = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_14__.Point3d.createAdd2Scaled(p, 1.0, RegionBooleanContext._bridgeDirection, bridgeLength);
             const bridgeLine = _LineSegment3d__WEBPACK_IMPORTED_MODULE_11__.LineSegment3d.createXYXY(p.x, p.y, outside.x, outside.y);
             this.extraGeometry.addMember(bridgeLine, true);
         }
@@ -223547,6 +223574,7 @@ class RegionBooleanContext {
         return true;
     }
 }
+RegionBooleanContext._bridgeDirection = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_14__.Vector3d.createNormalized(1.0, -0.12328974132467); // magic unit direction to minimize vertex hits
 /** return xy area between a (part of a) curve and the x axis through a reference point.
  * If detail is undefined or does not have both start and end fractions, just do trapezoid area
  */
@@ -225170,16 +225198,18 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   "PlaneAltitudeRangeContext": () => (/* binding */ PlaneAltitudeRangeContext)
 /* harmony export */ });
-/* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ../../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
+/* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ../../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
+/* harmony import */ var _geometry3d_Angle__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../../geometry3d/Angle */ "../../core/geometry/lib/esm/geometry3d/Angle.js");
 /* harmony import */ var _geometry3d_GeometryHandler__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../../geometry3d/GeometryHandler */ "../../core/geometry/lib/esm/geometry3d/GeometryHandler.js");
-/* harmony import */ var _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ../../geometry3d/GrowableXYZArray */ "../../core/geometry/lib/esm/geometry3d/GrowableXYZArray.js");
-/* harmony import */ var _geometry3d_Plane3dByOriginAndUnitNormal__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../../geometry3d/Plane3dByOriginAndUnitNormal */ "../../core/geometry/lib/esm/geometry3d/Plane3dByOriginAndUnitNormal.js");
-/* harmony import */ var _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../../geometry3d/Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
+/* harmony import */ var _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ../../geometry3d/GrowableXYZArray */ "../../core/geometry/lib/esm/geometry3d/GrowableXYZArray.js");
+/* harmony import */ var _geometry3d_Plane3dByOriginAndUnitNormal__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ../../geometry3d/Plane3dByOriginAndUnitNormal */ "../../core/geometry/lib/esm/geometry3d/Plane3dByOriginAndUnitNormal.js");
+/* harmony import */ var _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ../../geometry3d/Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
 /* harmony import */ var _geometry3d_Range__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../../geometry3d/Range */ "../../core/geometry/lib/esm/geometry3d/Range.js");
-/* harmony import */ var _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../../geometry3d/Ray3d */ "../../core/geometry/lib/esm/geometry3d/Ray3d.js");
-/* harmony import */ var _GeometryQuery__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ../GeometryQuery */ "../../core/geometry/lib/esm/curve/GeometryQuery.js");
-/* harmony import */ var _LineSegment3d__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ../LineSegment3d */ "../../core/geometry/lib/esm/curve/LineSegment3d.js");
-/* harmony import */ var _LineString3d__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../LineString3d */ "../../core/geometry/lib/esm/curve/LineString3d.js");
+/* harmony import */ var _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../../geometry3d/Ray3d */ "../../core/geometry/lib/esm/geometry3d/Ray3d.js");
+/* harmony import */ var _GeometryQuery__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ../GeometryQuery */ "../../core/geometry/lib/esm/curve/GeometryQuery.js");
+/* harmony import */ var _LineSegment3d__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ../LineSegment3d */ "../../core/geometry/lib/esm/curve/LineSegment3d.js");
+/* harmony import */ var _LineString3d__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../LineString3d */ "../../core/geometry/lib/esm/curve/LineString3d.js");
+/* harmony import */ var _StrokeOptions__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../StrokeOptions */ "../../core/geometry/lib/esm/curve/StrokeOptions.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -225194,6 +225224,8 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
+
 /**
  * Accumulator context for searching for extrema of geometry along a plane.
  * @internal
@@ -225235,16 +225267,25 @@ class PlaneAltitudeRangeContext extends _geometry3d_GeometryHandler__WEBPACK_IMP
     handleLineString3d(lineString) {
         this.announcePoints(lineString.packedPoints);
     }
+    initStrokeOptions() {
+        // TODO: compute the exact extrema; until then stroke aggressively
+        if (undefined === this._strokeOptions) {
+            this._strokeOptions = new _StrokeOptions__WEBPACK_IMPORTED_MODULE_2__.StrokeOptions();
+            this._strokeOptions.angleTol = _geometry3d_Angle__WEBPACK_IMPORTED_MODULE_3__.Angle.createDegrees(1);
+        }
+    }
     handleBSplineCurve3d(bcurve) {
         // ugh.   The point MUST be on the curve -- usual excess-range of poles is not ok.
-        const ls = _LineString3d__WEBPACK_IMPORTED_MODULE_2__.LineString3d.create();
-        bcurve.emitStrokes(ls);
+        this.initStrokeOptions();
+        const ls = _LineString3d__WEBPACK_IMPORTED_MODULE_4__.LineString3d.create();
+        bcurve.emitStrokes(ls, this._strokeOptions);
         this.handleLineString3d(ls);
     }
     handleBSplineCurve3dH(bcurve) {
         // ugh.   The point MUST be on the curve -- usual excess-range of poles is not ok.
-        const ls = _LineString3d__WEBPACK_IMPORTED_MODULE_2__.LineString3d.create();
-        bcurve.emitStrokes(ls);
+        this.initStrokeOptions();
+        const ls = _LineString3d__WEBPACK_IMPORTED_MODULE_4__.LineString3d.create();
+        bcurve.emitStrokes(ls, this._strokeOptions);
         this.handleLineString3d(ls);
     }
     handleArc3d(g) {
@@ -225259,15 +225300,15 @@ class PlaneAltitudeRangeContext extends _geometry3d_GeometryHandler__WEBPACK_IMP
         this.announcePoint((this._workPoint = g.endPoint(this._workPoint)));
     }
     static findExtremesInDirection(geometry, direction) {
-        const origin = direction instanceof _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_3__.Ray3d ? direction.origin : _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_4__.Point3d.createZero();
-        const vector = direction instanceof _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_3__.Ray3d ? direction.direction : direction;
-        const plane = _geometry3d_Plane3dByOriginAndUnitNormal__WEBPACK_IMPORTED_MODULE_5__.Plane3dByOriginAndUnitNormal.create(origin, vector); // vector is normalized, so altitudes are distances
+        const origin = direction instanceof _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_5__.Ray3d ? direction.origin : _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_6__.Point3d.createZero();
+        const vector = direction instanceof _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_5__.Ray3d ? direction.direction : direction;
+        const plane = _geometry3d_Plane3dByOriginAndUnitNormal__WEBPACK_IMPORTED_MODULE_7__.Plane3dByOriginAndUnitNormal.create(origin, vector); // vector is normalized, so altitudes are distances
         if (plane) {
             const context = new PlaneAltitudeRangeContext(plane);
-            if (geometry instanceof _GeometryQuery__WEBPACK_IMPORTED_MODULE_6__.GeometryQuery) {
+            if (geometry instanceof _GeometryQuery__WEBPACK_IMPORTED_MODULE_8__.GeometryQuery) {
                 geometry.dispatchToGeometryHandler(context);
             }
-            else if (geometry instanceof _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_7__.GrowableXYZArray) {
+            else if (geometry instanceof _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_9__.GrowableXYZArray) {
                 context.announcePoints(geometry);
             }
             else {
@@ -225287,7 +225328,7 @@ class PlaneAltitudeRangeContext extends _geometry3d_GeometryHandler__WEBPACK_IMP
     static findExtremePointsInDirection(geometry, direction, lowHigh) {
         const context = this.findExtremesInDirection(geometry, direction);
         if (context && context.highPoint && context.lowPoint)
-            return _LineSegment3d__WEBPACK_IMPORTED_MODULE_8__.LineSegment3d.create(context.lowPoint, context.highPoint, lowHigh);
+            return _LineSegment3d__WEBPACK_IMPORTED_MODULE_10__.LineSegment3d.create(context.lowPoint, context.highPoint, lowHigh);
         return undefined;
     }
     /** Compute altitudes for the geometry (via dispatch) over the plane defined by the given direction,
@@ -225310,8 +225351,8 @@ class PlaneAltitudeRangeContext extends _geometry3d_GeometryHandler__WEBPACK_IMP
     static findExtremeFractionsAlongDirection(geometry, direction, lowHigh) {
         const range = this.findExtremeAltitudesInDirection(geometry, direction, lowHigh);
         if (undefined !== range) {
-            const mag = (direction instanceof _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_4__.Vector3d) ? direction.magnitude() : direction.direction.magnitude();
-            const scaleToFraction = _Geometry__WEBPACK_IMPORTED_MODULE_9__.Geometry.conditionalDivideCoordinate(1.0, mag);
+            const mag = (direction instanceof _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_6__.Vector3d) ? direction.magnitude() : direction.direction.magnitude();
+            const scaleToFraction = _Geometry__WEBPACK_IMPORTED_MODULE_11__.Geometry.conditionalDivideCoordinate(1.0, mag);
             if (undefined !== scaleToFraction) {
                 range.low *= scaleToFraction;
                 range.high *= scaleToFraction;
@@ -237438,9 +237479,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.
@@ -237460,6 +237501,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
@@ -237579,11 +237621,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) {
@@ -237596,16 +237647,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);
@@ -237621,39 +237686,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) {
@@ -237665,9 +237767,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
@@ -237682,8 +237788,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)
@@ -237691,19 +237805,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;
@@ -237751,10 +237868,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;
@@ -237762,25 +237882,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) {
@@ -237790,12 +237916,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) {
@@ -237807,8 +237945,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());
@@ -237819,6 +237965,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
@@ -237827,12 +237974,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) {
@@ -237847,12 +237995,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. */
@@ -237865,7 +238023,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;
@@ -237875,7 +238033,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;
@@ -237887,6 +238045,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;
@@ -237901,6 +238060,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();
@@ -237908,18 +238068,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;
     }
@@ -237973,16 +238141,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) {
@@ -237995,13 +238166,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,
@@ -238092,6 +238256,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
@@ -238127,15 +238292,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;
     }
@@ -238203,7 +238377,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) {
@@ -238293,7 +238467,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);
     }
 }
 
@@ -238323,6 +238497,7 @@ __webpack_require__.r(__webpack_exports__);
 /** @packageDocumentation
  * @module CartesianGeometry
  */
+// cspell:word CWXY
 
 
 
@@ -238557,7 +238732,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)
@@ -239181,6 +239356,19 @@ class Vector3d extends XYZ {
         this.z *= a;
         return true;
     }
+    /** Create a normalized vector from the inputs.
+     * @param result optional result
+     * @returns undefined if and only if normalization fails
+    */
+    static createNormalized(x = 0, y = 0, z = 0, result) {
+        if (undefined === result)
+            result = Vector3d.create(x, y, z);
+        else
+            result.set(x, y, z);
+        if (result.normalizeInPlace())
+            return result;
+        return undefined;
+    }
     /**
      * Return fractional projection of target vector onto this
      * * It's returning the signed projection magnitude divided by the target magnitude. In other words,
@@ -239220,6 +239408,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.
@@ -239229,6 +239428,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;
@@ -239289,6 +239489,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);
@@ -310706,7 +310910,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.57","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.57","@itwin/core-bentley":"workspace:^3.5.0-dev.57","@itwin/core-common":"workspace:^3.5.0-dev.57","@itwin/core-geometry":"workspace:^3.5.0-dev.57","@itwin/core-orbitgt":"workspace:^3.5.0-dev.57","@itwin/core-quantity":"workspace:^3.5.0-dev.57","@itwin/webgl-compatibility":"workspace:^3.5.0-dev.57"},"//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"}}]}}');
 
 /***/ })