@itwin/core-geometry 4.1.0-dev.8 → 4.1.0-dev.80

package/lib/esm/geometry3d/Range.js

@@ -19,13 +19,21 @@ import { Transform } from "./Transform";
  */
 class RangeBase {
     /** Return 0 if high<= low, otherwise `1/(high-low)` for use in fractionalizing */
-    static npcScaleFactor(low, high) { return (high <= low) ? 0.0 : 1.0 / (high - low); }
+    static npcScaleFactor(low, high) {
+        return (high <= low) ? 0.0 : 1.0 / (high - low);
+    }
     /** Return true if x is outside the range `[_EXTREME_NEGATIVE, _EXTREME_POSITIVE]' */
-    static isExtremeValue(x) { return Math.abs(x) >= RangeBase._EXTREME_POSITIVE; }
+    static isExtremeValue(x) {
+        return Math.abs(x) >= RangeBase._EXTREME_POSITIVE;
+    }
     /** Return true if any x or y or z is outside the range `[_EXTREME_NEGATIVE, _EXTREME_POSITIVE]' */
-    static isExtremePoint3d(xyz) { return RangeBase.isExtremeValue(xyz.x) || RangeBase.isExtremeValue(xyz.y) || RangeBase.isExtremeValue(xyz.z); }
+    static isExtremePoint3d(xyz) {
+        return RangeBase.isExtremeValue(xyz.x) || RangeBase.isExtremeValue(xyz.y) || RangeBase.isExtremeValue(xyz.z);
+    }
     /** Return true if either of x,y is outside the range `[_EXTREME_NEGATIVE, _EXTREME_POSITIVE]' */
-    static isExtremePoint2d(xy) { return RangeBase.isExtremeValue(xy.x) || RangeBase.isExtremeValue(xy.y); }
+    static isExtremePoint2d(xy) {
+        return RangeBase.isExtremeValue(xy.x) || RangeBase.isExtremeValue(xy.y);
+    }
     /**
      * Return the min absolute distance from any point of `[lowA,highA]' to any point of `[lowB,highB]'.
      * * Both low,high pairs have order expectations:  The condition `high < low` means null interval.
@@ -48,7 +56,8 @@ class RangeBase {
             return 0.0;
         return lowB - highA;
     }
-    /** Given a coordinate and pair of range limits, return the smallest distance to the range.
+    /**
+     * Given a coordinate and pair of range limits, return the smallest distance to the range.
      * * This is zero for any point inside the range
      * * This is _EXTREME_POSITIVE if the range limits are inverted
      * * Otherwise (i.e. x is outside a finite range) the distance to the near endpoint.
@@ -63,7 +72,7 @@ class RangeBase {
         return 0.0;
     }
     /**
-     * if a > 0, return (extrapolationFactor * a); otherwise return defaultValue
+     * If a > 0, return (extrapolationFactor * a); otherwise return defaultValue
      * @param q
      * @param factor multiplier for positive q values.
      */
@@ -94,11 +103,19 @@ export class Range3d extends RangeBase {
         this.high.z = RangeBase._EXTREME_NEGATIVE;
     }
     /** Freeze this instance (and its members) so it is read-only */
-    freeze() { this.low.freeze(); this.high.freeze(); return Object.freeze(this); }
+    freeze() {
+        this.low.freeze();
+        this.high.freeze();
+        return Object.freeze(this);
+    }
     /** Flatten the low and high coordinates of any json object with low.x .. high.z into an array of 6 doubles */
-    static toFloat64Array(val) { return Float64Array.of(val.low.x, val.low.y, val.low.z, val.high.x, val.high.y, val.high.z); }
+    static toFloat64Array(val) {
+        return Float64Array.of(val.low.x, val.low.y, val.low.z, val.high.x, val.high.y, val.high.z);
+    }
     /** Flatten the low and high coordinates of this into an array of 6 doubles */
-    toFloat64Array() { return Range3d.toFloat64Array(this); }
+    toFloat64Array() {
+        return Range3d.toFloat64Array(this);
+    }
     /**
      * Construct a Range3d from an array of double-precision values
      * @param f64 the array, which should contain exactly 6 values in this order: lowX, lowY, lowZ, highX, highY, highZ
@@ -110,11 +127,14 @@ export class Range3d extends RangeBase {
         return new this(f64[0], f64[1], f64[2], f64[3], f64[4], f64[5]);
     }
     /**
-     * Construct a Range3d from an un-typed array. This mostly useful when interpreting ECSQL query results of the 'blob' type, where you know that that result is a Range3d.
+     * Construct a Range3d from an un-typed array. This mostly useful when interpreting ECSQL query results of
+     * the 'blob' type, where you know that that result is a Range3d.
      * @param buffer untyped array
      * @return a new Range3d object
      */
-    static fromArrayBuffer(buffer) { return this.fromFloat64Array(new Float64Array(buffer)); }
+    static fromArrayBuffer(buffer) {
+        return this.fromFloat64Array(new Float64Array(buffer));
+    }
     // explicit ctor - no enforcement of value relationships
     constructor(lowX = RangeBase._EXTREME_POSITIVE, lowY = RangeBase._EXTREME_POSITIVE, lowZ = RangeBase._EXTREME_POSITIVE, highX = RangeBase._EXTREME_NEGATIVE, highY = RangeBase._EXTREME_NEGATIVE, highZ = RangeBase._EXTREME_NEGATIVE) {
         super();
@@ -126,8 +146,11 @@ export class Range3d extends RangeBase {
         return (this.low.isAlmostEqual(other.low, tol) && this.high.isAlmostEqual(other.high, tol))
             || (this.isNull && other.isNull);
     }
-    /** copy low and high values from other. */
-    setFrom(other) { this.low.setFrom(other.low); this.high.setFrom(other.high); }
+    /** Copy low and high values from other. */
+    setFrom(other) {
+        this.low.setFrom(other.low);
+        this.high.setFrom(other.high);
+    }
     /** Return a new Range3d copied from a range or derived type */
     static createFrom(other, result) {
         if (result) {
@@ -136,7 +159,8 @@ export class Range3d extends RangeBase {
         }
         return this.createXYZXYZOrCorrectToNull(other.low.x, other.low.y, other.low.z, other.high.x, other.high.y, other.high.z, result);
     }
-    /** set this range (in place) from json such as
+    /**
+     * Set this range (in place) from json such as
      * * key-value pairs: `{low:[1,2,3], high:[4,5,6]}`
      * * array of points: `[[1,2,3],[9,3,4],[-2,1,3] ...]`
      * * Lowest level points can be `[1,2,3]` or `{x:1,y:2,z:3}`
@@ -160,10 +184,13 @@ export class Range3d extends RangeBase {
             this.extendPoint(high);
         }
     }
-    /** Return a JSON object `{low: ... , high: ...}`
+    /**
+     * Return a JSON object `{low: ... , high: ...}`
      * with points formatted by `Point3d.toJSON()`
      */
-    toJSON() { return { low: this.low.toJSON(), high: this.high.toJSON() }; }
+    toJSON() {
+        return { low: this.low.toJSON(), high: this.high.toJSON() };
+    }
     /** Use `setFromJSON` to parse `json` into a new Range3d instance. */
     static fromJSON(json) {
         const result = new this();
@@ -191,7 +218,8 @@ export class Range3d extends RangeBase {
         result.setDirect(this.low.x, this.low.y, this.low.z, this.high.x, this.high.y, this.high.z, false);
         return result;
     }
-    /** Return a copy, translated by adding `shift` components in all directions.
+    /**
+     * Return a copy, translated by adding `shift` components in all directions.
      * * The translate of a null range is also a null range.
      */
     cloneTranslated(shift, result) {
@@ -226,7 +254,7 @@ export class Range3d extends RangeBase {
         VariantPointDataStream.streamXYZ(data, collector);
         return collector.claimResult();
     }
-    /** create a Range3d enclosing the transformed points. */
+    /** Create a Range3d enclosing the transformed points. */
     static createTransformed(transform, ...point) {
         const result = this.createNull();
         let p;
@@ -234,13 +262,13 @@ export class Range3d extends RangeBase {
             result.extendTransformedXYZ(transform, p.x, p.y, p.z);
         return result;
     }
-    /** create a Range3d enclosing the transformed points. */
+    /** Create a Range3d enclosing the transformed points. */
     static createTransformedArray(transform, points) {
         const result = this.createNull();
         result.extendArray(points, transform);
         return result;
     }
-    /** create a Range3d enclosing the points after inverse transform. */
+    /** Create a Range3d enclosing the points after inverse transform. */
     static createInverseTransformedArray(transform, points) {
         const result = this.createNull();
         result.extendInverseTransformedArray(points, transform);
@@ -289,7 +317,7 @@ export class Range3d extends RangeBase {
             result.extendPoint(point);
         return result;
     }
-    /** extend a range around an array of points (optionally transformed) */
+    /** Extend a range around an array of points (optionally transformed) */
     extendArray(points, transform) {
         if (Array.isArray(points))
             if (transform)
@@ -306,7 +334,7 @@ export class Range3d extends RangeBase {
             for (let i = 0; i < points.length; i++)
                 this.extendXYZ(points.getXAtUncheckedPointIndex(i), points.getYAtUncheckedPointIndex(i), points.getZAtUncheckedPointIndex(i));
     }
-    /** extend a range around an array of points (optionally transformed) */
+    /** Extend a range around an array of points (optionally transformed) */
     extendInverseTransformedArray(points, transform) {
         if (Array.isArray(points))
             for (const point of points)
@@ -315,22 +343,19 @@ export class Range3d extends RangeBase {
             for (let i = 0; i < points.length; i++)
                 this.extendInverseTransformedXYZ(transform, points.getXAtUncheckedPointIndex(i), points.getYAtUncheckedPointIndex(i), points.getZAtUncheckedPointIndex(i));
     }
-    /** multiply the point x,y,z by transform and use the coordinate to extend this range.
-     */
+    /** Multiply the point x,y,z by transform and use the coordinate to extend this range. */
     extendTransformedXYZ(transform, x, y, z) {
         const origin = transform.origin;
         const coffs = transform.matrix.coffs;
         this.extendXYZ(origin.x + coffs[0] * x + coffs[1] * y + coffs[2] * z, origin.y + coffs[3] * x + coffs[4] * y + coffs[5] * z, origin.z + coffs[6] * x + coffs[7] * y + coffs[8] * z);
     }
-    /** multiply the point x,y,z,w by transform and use the coordinate to extend this range.
-     */
+    /** Multiply the point x,y,z,w by transform and use the coordinate to extend this range. */
     extendTransformedXYZW(transform, x, y, z, w) {
         const origin = transform.origin;
         const coffs = transform.matrix.coffs;
         this.extendXYZW(origin.x * w + coffs[0] * x + coffs[1] * y + coffs[2] * z, origin.y * w + coffs[3] * x + coffs[4] * y + coffs[5] * z, origin.z * w + coffs[6] * x + coffs[7] * y + coffs[8] * z, w);
     }
-    /** multiply the point x,y,z by transform and use the coordinate to extend this range.
-     */
+    /** Multiply the point x,y,z by the inverse of the transform and use the coordinate to extend this range. */
     extendInverseTransformedXYZ(transform, x, y, z) {
         const origin = transform.origin;
         if (!transform.matrix.computeCachedInverse(true))
@@ -367,36 +392,72 @@ export class Range3d extends RangeBase {
             && this.high.z === this.low.z;
     }
     /** Return the midpoint of the diagonal.  No test for null range. */
-    get center() { return this.low.interpolate(.5, this.high); }
-    /** return the low x coordinate */
-    get xLow() { return this.low.x; }
-    /** return the low y coordinate */
-    get yLow() { return this.low.y; }
-    /** return the low z coordinate */
-    get zLow() { return this.low.z; }
-    /** return the high x coordinate */
-    get xHigh() { return this.high.x; }
-    /** return the high y coordinate */
-    get yHigh() { return this.high.y; }
-    /** return the high z coordinate */
-    get zHigh() { return this.high.z; }
+    get center() {
+        return this.low.interpolate(.5, this.high);
+    }
+    /** Return the low x coordinate */
+    get xLow() {
+        return this.low.x;
+    }
+    /** Return the low y coordinate */
+    get yLow() {
+        return this.low.y;
+    }
+    /** Return the low z coordinate */
+    get zLow() {
+        return this.low.z;
+    }
+    /** Return the high x coordinate */
+    get xHigh() {
+        return this.high.x;
+    }
+    /** Return the high y coordinate */
+    get yHigh() {
+        return this.high.y;
+    }
+    /** Return the high z coordinate */
+    get zHigh() {
+        return this.high.z;
+    }
     /**  Return the length of the box in the x direction */
-    xLength() { const a = this.high.x - this.low.x; return a > 0.0 ? a : 0.0; }
+    xLength() {
+        const a = this.high.x - this.low.x;
+        return a > 0.0 ? a : 0.0;
+    }
     /**  Return the length of the box in the y direction */
-    yLength() { const a = this.high.y - this.low.y; return a > 0.0 ? a : 0.0; }
+    yLength() {
+        const a = this.high.y - this.low.y;
+        return a > 0.0 ? a : 0.0;
+    }
     /**  Return the length of the box in the z direction */
-    zLength() { const a = this.high.z - this.low.z; return a > 0.0 ? a : 0.0; }
+    zLength() {
+        const a = this.high.z - this.low.z;
+        return a > 0.0 ? a : 0.0;
+    }
     /**  Return the largest of the x,y, z lengths of the range. */
-    maxLength() { return Math.max(this.xLength(), this.yLength(), this.zLength()); }
-    /** return the diagonal vector. There is no check for isNull -- if the range isNull(), the vector will have very large negative coordinates. */
-    diagonal(result) { return this.low.vectorTo(this.high, result); }
-    /**  Return the diagonal vector. There is no check for isNull -- if the range isNull(), the vector will have very large negative coordinates. */
-    diagonalFractionToPoint(fraction, result) { return this.low.interpolate(fraction, this.high, result); }
-    /**  Return a point given by fractional positions on the XYZ axes. This is done with no check for isNull !!! */
+    maxLength() {
+        return Math.max(this.xLength(), this.yLength(), this.zLength());
+    }
+    /**
+     * Return the diagonal vector. There is no check for isNull -- if the range isNull(), the vector will have very
+     * large negative coordinates.
+     */
+    diagonal(result) {
+        return this.low.vectorTo(this.high, result);
+    }
+    /**
+     * Return the diagonal vector. There is no check for isNull -- if the range isNull(), the vector will have very
+     * large negative coordinates.
+     */
+    diagonalFractionToPoint(fraction, result) {
+        return this.low.interpolate(fraction, this.high, result);
+    }
+    /** Return a point given by fractional positions on the XYZ axes. This is done with no check for isNull !!! */
     fractionToPoint(fractionX, fractionY, fractionZ = 0, result) {
         return this.low.interpolateXYZ(fractionX, fractionY, fractionZ, this.high, result);
     }
-    /**  Return a point given by fractional positions on the XYZ axes.
+    /**
+     * Return a point given by fractional positions on the XYZ axes.
      *  Returns undefined if the range is null.
      */
     localXYZToWorld(fractionX, fractionY, fractionZ, result) {
@@ -404,13 +465,15 @@ export class Range3d extends RangeBase {
             return undefined;
         return this.low.interpolateXYZ(fractionX, fractionY, fractionZ, this.high, result);
     }
-    /** Return a point given by fractional positions on the XYZ axes.
+    /**
+     * Return a point given by fractional positions on the XYZ axes.
      * * Returns undefined if the range is null.
      */
     localToWorld(xyz, result) {
         return this.localXYZToWorld(xyz.x, xyz.y, xyz.z, result);
     }
-    /** Replace fractional coordinates by world coordinates.
+    /**
+     * Replace fractional coordinates by world coordinates.
      * @returns false if null range.
      */
     localToWorldArrayInPlace(points) {
@@ -420,7 +483,8 @@ export class Range3d extends RangeBase {
             this.low.interpolateXYZ(p.x, p.y, p.z, this.high, p);
         return false;
     }
-    /** Return fractional coordinates of point within the range.
+    /**
+     * Return fractional coordinates of point within the range.
      * * returns undefined if the range is null.
      * * returns undefined if any direction (x,y,z) has zero length
      */
@@ -432,7 +496,8 @@ export class Range3d extends RangeBase {
             return undefined;
         return Point3d.create((point.x - this.low.x) * ax, (point.y - this.low.y) * ay, (point.z - this.low.z) * az, result);
     }
-    /** Return fractional coordinates of point within the range.
+    /**
+     * Return fractional coordinates of point within the range.
      * * returns undefined if the range is null.
      * * returns undefined if any direction (x,y,z) has zero length
      */
@@ -446,7 +511,8 @@ export class Range3d extends RangeBase {
             Point3d.create((p.x - this.low.x) * ax, (p.y - this.low.y) * ay, (p.z - this.low.z) * az, p);
         return true;
     }
-    /** Return an array with the 8 corners on order wth "x varies fastest, then y, then z"
+    /**
+     * Return an array with the 8 corners on order wth "x varies fastest, then y, then z"
      * * points preallocated in `result` are reused if result.length >= 8.
      * * in reuse case, result.length is trimmed to 8
      */
@@ -471,10 +537,11 @@ export class Range3d extends RangeBase {
             Point3d.create(this.low.x, this.low.y, this.high.z),
             Point3d.create(this.high.x, this.low.y, this.high.z),
             Point3d.create(this.low.x, this.high.y, this.high.z),
-            Point3d.create(this.high.x, this.high.y, this.high.z)
+            Point3d.create(this.high.x, this.high.y, this.high.z),
         ];
     }
-    /** Return an array with indices of the corners of a face
+    /**
+     * Return an array with indices of the corners of a face
      * * face 0 has negative x normal
      * * face 1 has positive x normal
      * * face 2 has negative y normal
@@ -525,12 +592,18 @@ export class Range3d extends RangeBase {
             return 0.0;
         return Math.max(this.low.maxAbs(), this.high.maxAbs());
     }
-    /** returns true if the x direction size is nearly zero */
-    get isAlmostZeroX() { return Geometry.isSmallMetricDistance(this.xLength()); }
-    /** returns true if the y direction size is nearly zero */
-    get isAlmostZeroY() { return Geometry.isSmallMetricDistance(this.yLength()); }
-    /** returns true if the z direction size is nearly zero */
-    get isAlmostZeroZ() { return Geometry.isSmallMetricDistance(this.zLength()); }
+    /** Returns true if the x direction size is nearly zero */
+    get isAlmostZeroX() {
+        return Geometry.isSmallMetricDistance(this.xLength());
+    }
+    /** Returns true if the y direction size is nearly zero */
+    get isAlmostZeroY() {
+        return Geometry.isSmallMetricDistance(this.yLength());
+    }
+    /** Returns true if the z direction size is nearly zero */
+    get isAlmostZeroZ() {
+        return Geometry.isSmallMetricDistance(this.zLength());
+    }
     /** Test if a point given as x,y,z is within the range. */
     containsXYZ(x, y, z) {
         return x >= this.low.x
@@ -540,7 +613,7 @@ export class Range3d extends RangeBase {
             && y <= this.high.y
             && z <= this.high.z;
     }
-    /** Test if a point given as x,y is within the range.  (Ignoring z of range) */
+    /** Test if a point given as x,y is within the range (ignoring z of range). */
     containsXY(x, y) {
         return x >= this.low.x
             && y >= this.low.y
@@ -548,7 +621,9 @@ export class Range3d extends RangeBase {
             && y <= this.high.y;
     }
     /** Test if a point is within the range. */
-    containsPoint(point) { return this.containsXYZ(point.x, point.y, point.z); }
+    containsPoint(point) {
+        return this.containsXYZ(point.x, point.y, point.z);
+    }
     /** Test if the x,y coordinates of a point are within the range. */
     containsPointXY(point) {
         return point.x >= this.low.x
@@ -574,7 +649,7 @@ export class Range3d extends RangeBase {
             || other.low.y > this.high.y
             || other.low.z > this.high.z);
     }
-    /** Test if there is any intersection with other range */
+    /** Test if there is any intersection with other range, ignoring z. */
     intersectsRangeXY(other) {
         return !(this.low.x > other.high.x
             || this.low.y > other.high.y
@@ -587,7 +662,7 @@ export class Range3d extends RangeBase {
             return RangeBase._EXTREME_POSITIVE;
         return Math.min(Geometry.hypotenuseXYZ(RangeBase.coordinateToRangeAbsoluteDistance(point.x, this.low.x, this.high.x), RangeBase.coordinateToRangeAbsoluteDistance(point.y, this.low.y, this.high.y), RangeBase.coordinateToRangeAbsoluteDistance(point.z, this.low.z, this.high.z)), RangeBase._EXTREME_POSITIVE);
     }
-    /** returns 0 if the ranges have any overlap, otherwise the shortest absolute distance from one to the other. */
+    /** Returns 0 if the ranges have any overlap, otherwise the shortest absolute distance from one to the other. */
     distanceToRange(other) {
         return Math.min(Geometry.hypotenuseXYZ(RangeBase.rangeToRangeAbsoluteDistance(this.low.x, this.high.x, other.low.x, other.high.x), RangeBase.rangeToRangeAbsoluteDistance(this.low.y, this.high.y, other.low.y, other.high.y), RangeBase.rangeToRangeAbsoluteDistance(this.low.z, this.high.z, other.low.z, other.high.z)), RangeBase._EXTREME_POSITIVE);
     }
@@ -672,7 +747,8 @@ export class Range3d extends RangeBase {
             this.extendXYZ(other.high.x, other.high.y, other.high.z);
         }
     }
-    /** In each direction look at the difference between this range limit and that of interiorRange.
+    /**
+     * In each direction look at the difference between this range limit and that of interiorRange.
      * * If this range is larger, expand it by extrapolationFactor.
      */
     extendWhenLarger(other, extrapolationFactor) {
@@ -701,7 +777,7 @@ export class Range3d extends RangeBase {
         return Range3d.createXYZXYZOrCorrectToNull(Math.min(this.low.x, other.low.x), Math.min(this.low.y, other.low.y), Math.min(this.low.z, other.low.z), Math.max(this.high.x, other.high.x), Math.max(this.high.y, other.high.y), Math.max(this.high.z, other.high.z), result);
     }
     /**
-     * move low and high points by scaleFactor around the center point.
+     * Move low and high points by scaleFactor around the center point.
      * @param scaleFactor scale factor applied to low, high distance from center.
      */
     scaleAboutCenterInPlace(scaleFactor) {
@@ -720,7 +796,7 @@ export class Range3d extends RangeBase {
         }
     }
     /**
-     * move all limits by a fixed amount.
+     * Move all limits by a fixed amount.
      * * positive delta expands the range size
      * * negative delta reduces the range size
      * * if any dimension reduces below zero size, the whole range becomes null
@@ -734,7 +810,8 @@ export class Range3d extends RangeBase {
         return Transform.createOriginAndMatrix(Point3d.create(this.low.x, this.low.y, this.low.z), Matrix3d.createRowValues(this.high.x - this.low.x, 0, 0, 0, this.high.y - this.low.y, 0, 0, 0, this.high.z - this.low.z), result);
     }
     /**
-     * Creates an NPC to world transformation to go from 000...111 to the globally aligned cube with diagonally opposite corners that are the
+     * Creates an NPC to world transformation to go from 000...111 to the globally aligned cube with diagonally
+     * opposite corners that are the
      * min and max of this range. The diagonal component for any degenerate direction is 1.
      */
     getNpcToWorldRangeTransform(result) {
@@ -748,7 +825,9 @@ export class Range3d extends RangeBase {
             matrix.coffs[8] = 1;
         return transform;
     }
-    /** Ensure that the length of each dimension of this AxisAlignedBox3d is at least a minimum size. If not, expand to minimum about the center.
+    /**
+     * Ensure that the length of each dimension of this AxisAlignedBox3d is at least a minimum size. If not, expand
+     * to minimum about the center.
      * @param min The minimum length for each dimension.
      */
     ensureMinLengths(min = .001) {
@@ -777,7 +856,7 @@ export class Range3d extends RangeBase {
  * @public
  */
 export class Range1d extends RangeBase {
-    /** reset the low and high to null range state. */
+    /** Reset the low and high to null range state. */
     setNull() {
         this.low = RangeBase._EXTREME_POSITIVE;
         this.high = RangeBase._EXTREME_NEGATIVE;
@@ -801,10 +880,13 @@ export class Range1d extends RangeBase {
         return (Geometry.isSameCoordinate(this.low, other.low) && Geometry.isSameCoordinate(this.high, other.high))
             || (this.isNull && other.isNull);
     }
-    /** copy contents from other Range1d. */
-    setFrom(other) { this.low = other.low; this.high = other.high; }
-    /** Convert from a JSON object of one of these forms:
-     *
+    /** Copy contents from other Range1d. */
+    setFrom(other) {
+        this.low = other.low;
+        this.high = other.high;
+    }
+    /**
+     * Convert from a JSON object of one of these forms:
      * *  Any array of numbers: `[value,value, value]`
      * *  An object with low and high as properties: `{low:lowValue, high: highValue}`
      */
@@ -829,16 +911,20 @@ export class Range1d extends RangeBase {
             result.setFromJSON(json);
         return result;
     }
-    /** Convert to a JSON object of form
+    /**
+     * Convert to a JSON object of form
      * ```
      *    [lowValue,highValue]
      * ```
      */
-    toJSON() { if (this.isNull)
-        return new Array();
-    else
-        return [this.low, this.high]; }
-    /** return a new Range1d with contents of this.
+    toJSON() {
+        if (this.isNull)
+            return new Array();
+        else
+            return [this.low, this.high];
+    }
+    /**
+     * Return a new Range1d with contents of this.
      * @param result optional result.
      */
     clone(result) {
@@ -846,7 +932,8 @@ export class Range1d extends RangeBase {
         result.setDirect(this.low, this.high);
         return result;
     }
-    /** return a new Range1d with contents of this.
+    /**
+     * Return a new Range1d with contents of this.
      * @param result optional result.
      */
     static createFrom(other, result) {
@@ -854,7 +941,8 @@ export class Range1d extends RangeBase {
         result.setDirect(other.low, other.high);
         return result;
     }
-    /** Create a range with no content.
+    /**
+     * Create a range with no content.
      * @param result optional result.
      */
     static createNull(result) {
@@ -862,7 +950,8 @@ export class Range1d extends RangeBase {
         result.setNull();
         return result;
     }
-    /** create a range with `delta` added to low and high
+    /**
+     * Create a range with `delta` added to low and high
      * * If `this` is a null range, return a null range.
      */
     cloneTranslated(delta, result) {
@@ -877,7 +966,9 @@ export class Range1d extends RangeBase {
      * Set this range to be a single value.
      * @param x value to use as both low and high.
      */
-    setX(x) { this.low = this.high = x; }
+    setX(x) {
+        this.low = this.high = x;
+    }
     /** Create a single point box */
     static createX(x, result) {
         result = result ? result : new this();
@@ -899,10 +990,12 @@ export class Range1d extends RangeBase {
             this.high = x0;
         }
     }
+    /** Check if low is 0 and high is 1 */
     get isExact01() {
         return this.low === 0.0 && this.high === 1.0;
     }
-    /** Create a box from two values. Values are reversed if needed
+    /**
+     * Create a box from two values. Values are reversed if needed
      * @param xA first value
      * @param xB second value
      */
@@ -911,7 +1004,8 @@ export class Range1d extends RangeBase {
         result.setDirect(Math.min(xA, xB), Math.max(xA, xB));
         return result;
     }
-    /** Create a box from two values, but null range if the values are reversed
+    /**
+     * Create a box from two values, but null range if the values are reversed
      * @param xA first value
      * @param xB second value
      */
@@ -922,7 +1016,8 @@ export class Range1d extends RangeBase {
         result.setDirect(Math.min(xA, xB), Math.max(xA, xB));
         return result;
     }
-    /** Create a range containing all the values in an array.
+    /**
+     * Create a range containing all the values in an array.
      * @param values array of points to be contained in the range.
      * @param result optional result.
      */
@@ -933,13 +1028,14 @@ export class Range1d extends RangeBase {
             result.extendX(x);
         return result;
     }
-    /** extend to include an array of values */
+    /** Extend to include an array of values */
     extendArray(values) {
         let x;
         for (x of values)
             this.extendX(x);
     }
-    /** extend to include `values` at indices `beginIndex <= i < endIndex]`
+    /**
+     * Extend to include `values` at indices `beginIndex <= i < endIndex]`
      * @param values array of values
      * @param beginIndex first index to include
      * @param numValue number of values to access
@@ -958,8 +1054,11 @@ export class Range1d extends RangeBase {
         return this.high === this.low;
     }
     /** Return the length of the range in the x direction */
-    length() { const a = this.high - this.low; return a > 0.0 ? a : 0.0; }
-    /** return a point given by fractional positions within the range. This is done with no check for isNull !!! */
+    length() {
+        const a = this.high - this.low;
+        return a > 0.0 ? a : 0.0;
+    }
+    /** Return a point given by fractional positions within the range. This is done with no check for isNull !!! */
     fractionToPoint(fraction) {
         return Geometry.interpolate(this.low, fraction, this.high);
     }
@@ -970,7 +1069,9 @@ export class Range1d extends RangeBase {
         return Math.max(Math.abs(this.low), Math.abs(this.high));
     }
     /** Test if the x direction size is nearly zero */
-    get isAlmostZeroLength() { return Geometry.isSmallMetricDistance(this.length()); }
+    get isAlmostZeroLength() {
+        return Geometry.isSmallMetricDistance(this.length());
+    }
     /** Test if a number is within the range. */
     containsX(x) {
         return x >= this.low
@@ -990,7 +1091,6 @@ export class Range1d extends RangeBase {
      * * For x1 > x0, that range is null, and the intersection is null.
      * * For x0 <= x1, the input is a non-null range.
      * * The intersection range replaces the contents of this.
-     *
      */
     intersectRangeXXInPlace(x0, x1) {
         if (x1 < x0 || x1 < this.low || x0 > this.high) {
@@ -1003,7 +1103,7 @@ export class Range1d extends RangeBase {
                 this.low = x0;
         }
     }
-    /** returns 0 if the ranges have any overlap, otherwise the shortest absolute distance from one to the other. */
+    /** Returns 0 if the ranges have any overlap, otherwise the shortest absolute distance from one to the other. */
     distanceToRange(other) {
         return RangeBase.rangeToRangeAbsoluteDistance(this.low, this.high, other.low, other.high);
     }
@@ -1055,7 +1155,7 @@ export class Range1d extends RangeBase {
         return Range1d.createXX(Math.min(this.low, other.low), Math.max(this.high, other.high), result);
     }
     /**
-     * move low and high points by scaleFactor around the center point.
+     * Move low and high points by scaleFactor around the center point.
      * @param scaleFactor scale factor applied to low, high distance from center.
      */
     scaleAboutCenterInPlace(scaleFactor) {
@@ -1068,7 +1168,7 @@ export class Range1d extends RangeBase {
         }
     }
     /**
-     * move all limits by a fixed amount.
+     * Move all limits by a fixed amount.
      * * positive delta expands the range size
      * * negative delta reduces the range size
      * * if any dimension reduces below zero size, the whole range becomes null
@@ -1078,13 +1178,14 @@ export class Range1d extends RangeBase {
         this.setDirect(this.low - delta, this.high + delta, true);
     }
     /**
-     * clip this range to a linear half space condition
+     * Clip this range to a linear half space condition
      * * if `limitA > limitB` the limit space is empty
      *   * make this range null
      *   * return false;
      * * otherwise (i.e `limitA <= limitB`)
      *   * solve `a + u * f = limitA' and `a + u * f = limitA`
-     *   * if unable to solve (i.e. u near zero), `a` alone determines whether to (a) leave this interval unchanged or (b) reduce to nothing.
+     *   * if unable to solve (i.e. u near zero), `a` alone determines whether to (a) leave this interval unchanged or
+     * (b) reduce to nothing.
      *   * the `f` values are an interval in the space of this `Range1d`
      *   * restrict the range to that interval (i.e intersect existing (low,high) with the fraction interval.
      *   * return true if the range is non-null after the clip.
@@ -1093,7 +1194,6 @@ export class Range1d extends RangeBase {
      * @param limitA crossing value, assumed in range relation with limitB
      * @param limitB crossing value, assumed in range relation with limitB
      * @param limitIsHigh true if the limit is an upper limit on mapped values.
-     *
      */
     clipLinearMapToInterval(a, u, limitA, limitB) {
         // f = (limit - a) / u
@@ -1132,7 +1232,7 @@ export class Range1d extends RangeBase {
  * @public
  */
 export class Range2d extends RangeBase {
-    /** reset the low and high to null range state. */
+    /** Reset the low and high to null range state. */
     setNull() {
         this.low.x = RangeBase._EXTREME_POSITIVE;
         this.low.y = RangeBase._EXTREME_POSITIVE;
@@ -1140,9 +1240,13 @@ export class Range2d extends RangeBase {
         this.high.y = RangeBase._EXTREME_NEGATIVE;
     }
     /** Flatten the low and high coordinates of any json object with low.x .. high.y into an array of 4 doubles */
-    static toFloat64Array(val) { return Float64Array.of(val.low.x, val.low.y, val.high.x, val.high.y); }
+    static toFloat64Array(val) {
+        return Float64Array.of(val.low.x, val.low.y, val.high.x, val.high.y);
+    }
     /** Flatten the low and high coordinates of this instance into an array of 4 doubles */
-    toFloat64Array() { return Range2d.toFloat64Array(this); }
+    toFloat64Array() {
+        return Range2d.toFloat64Array(this);
+    }
     /**
      * Construct a Range2d from an array of double-precision values
      * @param f64 the array, which should contain exactly 4 values in this order: lowX, lowY, highX, highY
@@ -1154,12 +1258,15 @@ export class Range2d extends RangeBase {
         return new this(f64[0], f64[1], f64[2], f64[3]);
     }
     /**
-     * Construct a Range2d from an un-typed array. This mostly useful when interpreting ECSQL query results of the 'blob' type, where you know that that result is a Range3d.
+     * Construct a Range2d from an un-typed array. This mostly useful when interpreting ECSQL query results of
+     * the 'blob' type, where you know that that result is a Range3d.
      * @param buffer untyped array
      * @return a new Range2d object
      */
-    static fromArrayBuffer(buffer) { return this.fromFloat64Array(new Float64Array(buffer)); }
-    // explicit ctor - no enforcement of value relationships
+    static fromArrayBuffer(buffer) {
+        return this.fromFloat64Array(new Float64Array(buffer));
+    }
+    // explicit constructor - no enforcement of value relationships
     constructor(lowX = Range2d._EXTREME_POSITIVE, lowY = Range2d._EXTREME_POSITIVE, highX = Range2d._EXTREME_NEGATIVE, highY = Range2d._EXTREME_NEGATIVE) {
         super();
         this.low = Point2d.create(lowX, lowY);
@@ -1170,12 +1277,12 @@ export class Range2d extends RangeBase {
         return (this.low.isAlmostEqual(other.low) && this.high.isAlmostEqual(other.high))
             || (this.isNull && other.isNull);
     }
-    /** copy all content from any `other` that has low and high xy data. */
+    /** Copy all content from any `other` that has low and high xy data. */
     setFrom(other) {
         this.low.set(other.low.x, other.low.y);
         this.high.set(other.high.x, other.high.y);
     }
-    /** create a new Range2d from any `other` that has low and high xy data. */
+    /** Create a new Range2d from any `other` that has low and high xy data. */
     static createFrom(other, result) {
         if (result) {
             result.setFrom(other);
@@ -1183,7 +1290,7 @@ export class Range2d extends RangeBase {
         }
         return this.createXYXYOrCorrectToNull(other.low.x, other.low.y, other.high.x, other.high.y, result);
     }
-    /** treat any array of numbers as numbers to be inserted !!! */
+    /** Treat any array of numbers as numbers to be inserted !!! */
     setFromJSON(json) {
         this.setNull();
         if (Array.isArray(json)) {
@@ -1202,9 +1309,15 @@ export class Range2d extends RangeBase {
         }
     }
     /** Freeze this instance (and its members) so it is read-only */
-    freeze() { this.low.freeze(); this.high.freeze(); return Object.freeze(this); }
-    /** return json array with two points as produced by `Point2d.toJSON` */
-    toJSON() { return this.isNull ? [] : [this.low.toJSON(), this.high.toJSON()]; }
+    freeze() {
+        this.low.freeze();
+        this.high.freeze();
+        return Object.freeze(this);
+    }
+    /** Return json array with two points as produced by `Point2d.toJSON` */
+    toJSON() {
+        return this.isNull ? [] : [this.low.toJSON(), this.high.toJSON()];
+    }
     /** Use `setFromJSON` to parse `json` into a new Range2d instance. */
     static fromJSON(json) {
         const result = new this();
@@ -1223,13 +1336,13 @@ export class Range2d extends RangeBase {
                 this.setNull();
         }
     }
-    /** return a clone of this range (or copy to optional result) */
+    /** Return a clone of this range (or copy to optional result) */
     clone(result) {
         result = result ? result : new this.constructor();
         result.setDirect(this.low.x, this.low.y, this.high.x, this.high.y, false);
         return result;
     }
-    /** create a range with no content. */
+    /** Create a range with no content. */
     static createNull(result) {
         result = result ? result : new this();
         result.setNull();
@@ -1279,7 +1392,10 @@ export class Range2d extends RangeBase {
         return this.high.x < this.low.x
             || this.high.y < this.low.y;
     }
-    /** Test if the box has high strictly less than low for any of x,y, condition. Note that a range around a single point is NOT null. */
+    /**
+     * Test if the box has high strictly less than low for any of x,y, condition. Note that a range around a
+     * single point is NOT null.
+     */
     static isNull(range) {
         return range.high.x < range.low.x
             || range.high.y < range.low.y;
@@ -1290,28 +1406,55 @@ export class Range2d extends RangeBase {
             && this.high.y === this.low.y;
     }
     /** Return the midpoint of the diagonal.  No test for null range. */
-    get center() { return this.low.interpolate(.5, this.high); }
-    /** return the low x coordinate */
-    get xLow() { return this.low.x; }
-    /** return the low y coordinate */
-    get yLow() { return this.low.y; }
-    /** return the high x coordinate */
-    get xHigh() { return this.high.x; }
-    /** return the high y coordinate */
-    get yHigh() { return this.high.y; }
+    get center() {
+        return this.low.interpolate(.5, this.high);
+    }
+    /** Return the low x coordinate */
+    get xLow() {
+        return this.low.x;
+    }
+    /** Return the low y coordinate */
+    get yLow() {
+        return this.low.y;
+    }
+    /** Return the high x coordinate */
+    get xHigh() {
+        return this.high.x;
+    }
+    /** Return the high y coordinate */
+    get yHigh() {
+        return this.high.y;
+    }
     /** Length of the box in the x direction */
-    xLength() { const a = this.high.x - this.low.x; return a > 0.0 ? a : 0.0; }
+    xLength() {
+        const a = this.high.x - this.low.x;
+        return a > 0.0 ? a : 0.0;
+    }
     /** Length of the box in the y direction */
-    yLength() { const a = this.high.y - this.low.y; return a > 0.0 ? a : 0.0; }
-    /** return the diagonal vector. There is no check for isNull -- if the range isNull(), the vector will have very large negative coordinates. */
-    diagonal(result) { return this.low.vectorTo(this.high, result); }
-    /** return the point at the specified fraction along the diagonal vector. There is no check for isNull -- if the range isNull(), the vector will have very large negative coordinates. */
-    diagonalFractionToPoint(fraction, result) { return this.low.interpolate(fraction, this.high, result); }
-    /** return a point given by fractional positions on the XY axes. This is done with no check for isNull !!! */
+    yLength() {
+        const a = this.high.y - this.low.y;
+        return a > 0.0 ? a : 0.0;
+    }
+    /**
+     * Return the diagonal vector. There is no check for isNull -- if the range isNull(), the vector will have very
+     * large negative coordinates.
+     */
+    diagonal(result) {
+        return this.low.vectorTo(this.high, result);
+    }
+    /**
+     * Return the point at the specified fraction along the diagonal vector. There is no check for isNull -- if the
+     * range isNull(), the vector will have very large negative coordinates.
+     */
+    diagonalFractionToPoint(fraction, result) {
+        return this.low.interpolate(fraction, this.high, result);
+    }
+    /** Return a point given by fractional positions on the XY axes. This is done with no check for isNull !!! */
     fractionToPoint(fractionX, fractionY, result) {
         return this.low.interpolateXY(fractionX, fractionY, this.high, result);
     }
-    /** Return an array with the 4 corners.
+    /**
+     * Return an array with the 4 corners.
      * * if asLoop is false, 4 corners are "x varies fastest, then y"
      * * if asLoop is true, 5 corners are in CCW order WITH CLOSURE
      */
@@ -1322,13 +1465,13 @@ export class Range2d extends RangeBase {
                 Point3d.create(this.high.x, this.low.y, z),
                 Point3d.create(this.high.x, this.high.y, z),
                 Point3d.create(this.low.x, this.high.y, z),
-                Point3d.create(this.low.x, this.low.y, z)
+                Point3d.create(this.low.x, this.low.y, z),
             ];
         return [
             Point3d.create(this.low.x, this.low.y, z),
             Point3d.create(this.high.x, this.low.y, z),
             Point3d.create(this.low.x, this.high.y, z),
-            Point3d.create(this.high.x, this.high.y, z)
+            Point3d.create(this.high.x, this.high.y, z),
         ];
     }
     /** Largest absolute value among any coordinates in the box corners. */
@@ -1338,10 +1481,14 @@ export class Range2d extends RangeBase {
         return Math.max(this.low.maxAbs(), this.high.maxAbs());
     }
     /** Test if the x direction size is nearly zero */
-    get isAlmostZeroX() { return Geometry.isSmallMetricDistance(this.xLength()); }
+    get isAlmostZeroX() {
+        return Geometry.isSmallMetricDistance(this.xLength());
+    }
     /** Test if the y direction size is nearly zero */
-    get isAlmostZeroY() { return Geometry.isSmallMetricDistance(this.yLength()); }
-    /** Test if a point given as x,y is within the range. */
+    get isAlmostZeroY() {
+        return Geometry.isSmallMetricDistance(this.yLength());
+    }
+    /** Test if a point given as x,y is within the range */
     containsXY(x, y) {
         return x >= this.low.x
             && y >= this.low.y
@@ -1349,7 +1496,9 @@ export class Range2d extends RangeBase {
             && y <= this.high.y;
     }
     /** Test if a point is within the range. */
-    containsPoint(point) { return this.containsXY(point.x, point.y); }
+    containsPoint(point) {
+        return this.containsXY(point.x, point.y);
+    }
     /** Test of other range is within this range */
     containsRange(other) {
         return other.low.x >= this.low.x
@@ -1392,7 +1541,9 @@ export class Range2d extends RangeBase {
         this.extendXY(x1, y1);
     }
     /** Expand this range to include a point. */
-    extendPoint(point) { this.extendXY(point.x, point.y); }
+    extendPoint(point) {
+        this.extendXY(point.x, point.y);
+    }
     /** Expand this range to include a range. */
     extendRange(other) {
         if (!Range2d.isNull(other)) {
@@ -1416,7 +1567,7 @@ export class Range2d extends RangeBase {
         return Range2d.createXYXY(Math.min(this.low.x, other.low.x), Math.min(this.low.y, other.low.y), Math.max(this.high.x, other.high.x), Math.max(this.high.y, other.high.y), result);
     }
     /**
-     * move low and high points by scaleFactor around the center point.
+     * Move low and high points by scaleFactor around the center point.
      * @param scaleFactor scale factor applied to low, high distance from center.
      */
     scaleAboutCenterInPlace(scaleFactor) {
@@ -1432,7 +1583,7 @@ export class Range2d extends RangeBase {
         }
     }
     /**
-     * move all limits by a fixed amount.
+     * Move all limits by a fixed amount.
      * * positive delta expands the range size
      * * negative delta reduces the range size
      * * if any dimension reduces below zero size, the whole range becomes null
@@ -1441,7 +1592,8 @@ export class Range2d extends RangeBase {
     expandInPlace(delta) {
         this.setDirect(this.low.x - delta, this.low.y - delta, this.high.x + delta, this.high.y + delta, true);
     }
-    /** Return fractional coordinates of point within the range.
+    /**
+     * Return fractional coordinates of point within the range.
      * * returns undefined if the range is null.
      * * returns undefined if any direction (x,y) has zero length
      */