@itwin/ecschema-rpcinterface-tests 4.2.0-dev.0 → 4.2.0-dev.10

package/lib/dist/bundled-tests.js

@@ -31848,7 +31848,7 @@ __webpack_require__.r(__webpack_exports__);
  */
 
 
-/** @beta */
+/** @public */
 class PropertyMetaDataMap {
     constructor(properties) {
         this.properties = properties;
@@ -31910,8 +31910,7 @@ class PropertyMetaDataMap {
  *
  * @note When iterating over the results, the current row will be a [[QueryRowProxy]] object. To get the row as a basic
  *       JavaScript object, call [[QueryRowProxy.toRow]] on it.
- *
- * @beta
+ * @public
  */
 class ECSqlReader {
     /**
@@ -32059,7 +32058,7 @@ class ECSqlReader {
         return this._done;
     }
     /**
-     *
+     * @internal
      */
     getRowInternal() {
         if (this._localRows.length <= this._localOffset)
@@ -32139,7 +32138,7 @@ class ECSqlReader {
         return resp;
     }
     /**
-     *
+     * @internal
      */
     formatCurrentRow(onlyReturnObject = false) {
         if (!onlyReturnObject && this._options.rowFormat === _ConcurrentQuery__WEBPACK_IMPORTED_MODULE_1__.QueryRowFormat.UseECSqlPropertyIndexes) {
@@ -65746,6 +65745,9 @@ class Property {
             this._customAttributes = new Map();
         this._customAttributes.set(customAttribute.className, customAttribute);
     }
+    setName(name) {
+        this._name = name;
+    }
     /**
      * Retrieve all custom attributes in the current property and its base
      * This is the async version of getCustomAttributesSync()
@@ -74467,6 +74469,7 @@ class ModelChangeMonitor {
             this.processBuffered();
         };
         this._removals.push(briefcase.txns.onCommitted.addListener(maybeProcess));
+        this._removals.push(briefcase.txns.onReplayedExternalTxns.addListener(maybeProcess));
         this._removals.push(briefcase.txns.onAfterUndoRedo.addListener(maybeProcess));
         this._removals.push(briefcase.txns.onChangesPulled.addListener(maybeProcess));
     }
@@ -74798,6 +74801,14 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
          * @see [[onCommit]] for the event raised before the operation.
          */
         this.onCommitted = new _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.BeEvent();
+        /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.
+         * @see [[onReplayedExternalTxns]] for the event raised after all such changes have been applied.
+         */
+        this.onReplayExternalTxns = new _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.BeEvent();
+        /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.
+         * @see [[onReplayExternalTxns]] for the event raised before the changes are applied.
+         */
+        this.onReplayedExternalTxns = new _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.BeEvent();
         /** Event raised after a changeset has been applied to the briefcase.
          * Changesets may be applied as a result of [[BriefcaseConnection.pullChanges]], or by undo/redo operations.
          */
@@ -74933,6 +74944,14 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
         this.onCommitted.raiseEvent(hasPendingTxns, time);
     }
     /** @internal */
+    notifyReplayExternalTxns() {
+        this.onReplayExternalTxns.raiseEvent();
+    }
+    /** @internal */
+    notifyReplayedExternalTxns() {
+        this.onReplayedExternalTxns.raiseEvent();
+    }
+    /** @internal */
     notifyChangesApplied() {
         this.onChangesApplied.raiseEvent();
     }
@@ -80698,7 +80717,7 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
      * @param params The values to bind to the parameters (if the ECSQL has any).
      * @param config Allow to specify certain flags which control how query is executed.
      * @returns Returns an [ECSqlReader]($common) which helps iterate over the result set and also give access to metadata.
-     * @beta
+     * @public
      * */
     createQueryReader(ecsql, params, config) {
         const executor = {
@@ -176954,6 +176973,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _geometry3d_GrowableFloat64Array__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ../geometry3d/GrowableFloat64Array */ "../../core/geometry/lib/esm/geometry3d/GrowableFloat64Array.js");
 /* harmony import */ var _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ../geometry3d/GrowableXYZArray */ "../../core/geometry/lib/esm/geometry3d/GrowableXYZArray.js");
 /* harmony import */ var _geometry3d_Matrix3d__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ../geometry3d/Matrix3d */ "../../core/geometry/lib/esm/geometry3d/Matrix3d.js");
+/* harmony import */ var _geometry3d_Plane3d__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../geometry3d/Plane3d */ "../../core/geometry/lib/esm/geometry3d/Plane3d.js");
 /* harmony import */ var _geometry3d_Plane3dByOriginAndUnitNormal__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../geometry3d/Plane3dByOriginAndUnitNormal */ "../../core/geometry/lib/esm/geometry3d/Plane3dByOriginAndUnitNormal.js");
 /* harmony import */ var _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../geometry3d/Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
 /* harmony import */ var _geometry3d_PolygonOps__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ../geometry3d/PolygonOps */ "../../core/geometry/lib/esm/geometry3d/PolygonOps.js");
@@ -176962,7 +176982,6 @@ __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_Polynomials__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../numerics/Polynomials */ "../../core/geometry/lib/esm/numerics/Polynomials.js");
 /* harmony import */ var _ClipUtils__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./ClipUtils */ "../../core/geometry/lib/esm/clipping/ClipUtils.js");
-/* harmony import */ var _geometry3d_Plane3d__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../geometry3d/Plane3d */ "../../core/geometry/lib/esm/geometry3d/Plane3d.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -176984,6 +177003,7 @@ __webpack_require__.r(__webpack_exports__);
  * A ClipPlane is a single plane represented as
  * * An inward unit normal (u,v,w)
  * * A signedDistance
+ * More details can be found at docs/learning/geometry/Clipping.md
  *
  * Hence
  * * The halfspace function evaluation for "point" (x,y,z) is `(x,y,z) DOT (u,v,w) - signedDistance`.
@@ -177496,8 +177516,9 @@ class ClipPlane extends _geometry3d_Plane3d__WEBPACK_IMPORTED_MODULE_0__.Plane3d
             xyzOut.pushWrap(1);
         return xyzOut;
     }
-    /** Implement appendPolygonClip, as defined in interface PolygonClipper.
-     * @param xyz input polygon.  This is not changed.
+    /**
+     * Implement appendPolygonClip, as defined in interface PolygonClipper.
+     * @param xyz convex polygon. This is not changed.
      * @param insideFragments Array to receive "inside" fragments. Each fragment is a GrowableXYZArray grabbed
      * from the cache. This is NOT cleared.
      * @param outsideFragments Array to receive "outside" fragments. Each fragment is a GrowableXYZArray grabbed
@@ -178275,22 +178296,28 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   ClipStepAction: () => (/* binding */ ClipStepAction),
 /* harmony export */   ClipUtilities: () => (/* binding */ ClipUtilities)
 /* harmony export */ });
-/* harmony import */ var _curve_CurveFactory__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(/*! ../curve/CurveFactory */ "../../core/geometry/lib/esm/curve/CurveFactory.js");
-/* harmony import */ var _curve_LineString3d__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../curve/LineString3d */ "../../core/geometry/lib/esm/curve/LineString3d.js");
-/* harmony import */ var _curve_Loop__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ../curve/Loop */ "../../core/geometry/lib/esm/curve/Loop.js");
+/* harmony import */ var _curve_CurveCollection__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ../curve/CurveCollection */ "../../core/geometry/lib/esm/curve/CurveCollection.js");
+/* harmony import */ var _curve_CurveFactory__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(/*! ../curve/CurveFactory */ "../../core/geometry/lib/esm/curve/CurveFactory.js");
+/* harmony import */ var _curve_CurvePrimitive__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ../curve/CurvePrimitive */ "../../core/geometry/lib/esm/curve/CurvePrimitive.js");
+/* harmony import */ var _curve_LineString3d__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../curve/LineString3d */ "../../core/geometry/lib/esm/curve/LineString3d.js");
+/* harmony import */ var _curve_Loop__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../curve/Loop */ "../../core/geometry/lib/esm/curve/Loop.js");
+/* harmony import */ var _curve_Path__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ../curve/Path */ "../../core/geometry/lib/esm/curve/Path.js");
+/* harmony import */ var _curve_RegionOps__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../curve/RegionOps */ "../../core/geometry/lib/esm/curve/RegionOps.js");
+/* harmony import */ var _curve_UnionRegion__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ../curve/UnionRegion */ "../../core/geometry/lib/esm/curve/UnionRegion.js");
 /* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
-/* harmony import */ var _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../geometry3d/GrowableXYZArray */ "../../core/geometry/lib/esm/geometry3d/GrowableXYZArray.js");
-/* harmony import */ var _geometry3d_Point3dArrayCarrier__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(/*! ../geometry3d/Point3dArrayCarrier */ "../../core/geometry/lib/esm/geometry3d/Point3dArrayCarrier.js");
-/* harmony import */ var _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../geometry3d/Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
-/* harmony import */ var _geometry3d_Range__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../geometry3d/Range */ "../../core/geometry/lib/esm/geometry3d/Range.js");
-/* harmony import */ var _geometry3d_ReusableObjectCache__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(/*! ../geometry3d/ReusableObjectCache */ "../../core/geometry/lib/esm/geometry3d/ReusableObjectCache.js");
-/* harmony import */ var _polyface_PolyfaceBuilder__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ../polyface/PolyfaceBuilder */ "../../core/geometry/lib/esm/polyface/PolyfaceBuilder.js");
-/* harmony import */ var _ClipPlane__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./ClipPlane */ "../../core/geometry/lib/esm/clipping/ClipPlane.js");
-/* harmony import */ var _ClipPrimitive__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./ClipPrimitive */ "../../core/geometry/lib/esm/clipping/ClipPrimitive.js");
-/* harmony import */ var _ClipVector__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./ClipVector */ "../../core/geometry/lib/esm/clipping/ClipVector.js");
-/* harmony import */ var _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./ConvexClipPlaneSet */ "../../core/geometry/lib/esm/clipping/ConvexClipPlaneSet.js");
-/* harmony import */ var _internalContexts_LineStringOffsetClipperContext__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./internalContexts/LineStringOffsetClipperContext */ "../../core/geometry/lib/esm/clipping/internalContexts/LineStringOffsetClipperContext.js");
-/* harmony import */ var _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./UnionOfConvexClipPlaneSets */ "../../core/geometry/lib/esm/clipping/UnionOfConvexClipPlaneSets.js");
+/* harmony import */ var _geometry3d_FrameBuilder__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../geometry3d/FrameBuilder */ "../../core/geometry/lib/esm/geometry3d/FrameBuilder.js");
+/* harmony import */ var _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ../geometry3d/GrowableXYZArray */ "../../core/geometry/lib/esm/geometry3d/GrowableXYZArray.js");
+/* harmony import */ var _geometry3d_Point3dArrayCarrier__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(/*! ../geometry3d/Point3dArrayCarrier */ "../../core/geometry/lib/esm/geometry3d/Point3dArrayCarrier.js");
+/* harmony import */ var _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ../geometry3d/Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
+/* harmony import */ var _geometry3d_Range__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(/*! ../geometry3d/Range */ "../../core/geometry/lib/esm/geometry3d/Range.js");
+/* harmony import */ var _geometry3d_ReusableObjectCache__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../geometry3d/ReusableObjectCache */ "../../core/geometry/lib/esm/geometry3d/ReusableObjectCache.js");
+/* harmony import */ var _polyface_PolyfaceBuilder__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(/*! ../polyface/PolyfaceBuilder */ "../../core/geometry/lib/esm/polyface/PolyfaceBuilder.js");
+/* harmony import */ var _ClipPlane__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(/*! ./ClipPlane */ "../../core/geometry/lib/esm/clipping/ClipPlane.js");
+/* harmony import */ var _ClipPrimitive__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(/*! ./ClipPrimitive */ "../../core/geometry/lib/esm/clipping/ClipPrimitive.js");
+/* harmony import */ var _ClipVector__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(/*! ./ClipVector */ "../../core/geometry/lib/esm/clipping/ClipVector.js");
+/* harmony import */ var _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./ConvexClipPlaneSet */ "../../core/geometry/lib/esm/clipping/ConvexClipPlaneSet.js");
+/* harmony import */ var _internalContexts_LineStringOffsetClipperContext__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(/*! ./internalContexts/LineStringOffsetClipperContext */ "../../core/geometry/lib/esm/clipping/internalContexts/LineStringOffsetClipperContext.js");
+/* harmony import */ var _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(/*! ./UnionOfConvexClipPlaneSets */ "../../core/geometry/lib/esm/clipping/UnionOfConvexClipPlaneSets.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -178312,6 +178339,12 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
+
+
+
+
+
 
 
 /**
@@ -178359,7 +178392,7 @@ var ClipStatus;
  */
 class ClipUtilities {
     /**
-     * * Augment the unsortedFractionsArray with 0 and 1
+     * Augment the unsortedFractionsArray with 0 and 1
      * * sort
      * * test the midpoint of each interval with `clipper.isPointOnOrInside`
      * * pass accepted intervals to `announce(f0,f1,curve)`
@@ -178406,7 +178439,7 @@ class ClipUtilities {
         return intervals.length > 0;
     }
     /**
-     * Find portions of the curve that are within the clipper.
+     * Find portions of the curve primitive that are within the clipper.
      * Collect them into an array of curve primitives.
      */
     static collectClippedCurves(curve, clipper) {
@@ -178420,6 +178453,75 @@ class ClipUtilities {
         });
         return result;
     }
+    /**
+     * Find portions of the planar region that are within the clipper.
+     * Collect them into a single region to return.
+     */
+    static clipAnyRegion(region, clipper) {
+        let result;
+        // Create "local region" which is the result of rotating region to make
+        // it parallel to the xy-plane and then translating it to the xy-plane.
+        const localToWorld = _geometry3d_FrameBuilder__WEBPACK_IMPORTED_MODULE_1__.FrameBuilder.createRightHandedFrame(undefined, region);
+        if (!localToWorld)
+            return result;
+        const worldToLocal = localToWorld?.inverse();
+        if (!worldToLocal)
+            return result;
+        const localRegion = region.cloneTransformed(worldToLocal);
+        if (!localRegion)
+            return result;
+        // We can only clip convex polygons with our clipper machinery, but the input region doesn't have to be
+        // convex or even a polygon. We get around this limitation by using a Boolean operation, which admits
+        // *any* planar regions, albeit in local coordinates. First, we clip a rectangle that covers the input region
+        // (in world coordinates), then we intersect the resulting fragments with the input region in local coordinates.
+        // Finally, we assemble the results into a UnionRegion back in world coordinates.
+        const localRegionRange = ClipUtilities._workRange = localRegion.range();
+        const xLength = localRegionRange.xLength();
+        const yLength = localRegionRange.yLength();
+        const rectangle = _curve_LineString3d__WEBPACK_IMPORTED_MODULE_2__.LineString3d.createRectangleXY(localRegionRange.low, xLength, yLength, true);
+        rectangle.tryTransformInPlace(localToWorld);
+        // Clip the rectangle to produce fragment(s) which we can Boolean intersect with the input region.
+        const insideFragments = [];
+        const outsideFragments = [];
+        const cache = new _geometry3d_ReusableObjectCache__WEBPACK_IMPORTED_MODULE_3__.GrowableXYZArrayCache();
+        clipper.appendPolygonClip?.(rectangle.packedPoints, insideFragments, outsideFragments, cache);
+        if (insideFragments.length === 0)
+            return result;
+        // Create the "clipped region".
+        for (const fragment of insideFragments) {
+            const loop = _curve_Loop__WEBPACK_IMPORTED_MODULE_4__.Loop.createPolygon(fragment);
+            loop.tryTransformInPlace(worldToLocal);
+            const clippedLocalRegion = _curve_RegionOps__WEBPACK_IMPORTED_MODULE_5__.RegionOps.regionBooleanXY(localRegion, loop, _curve_RegionOps__WEBPACK_IMPORTED_MODULE_5__.RegionBinaryOpType.Intersection);
+            if (clippedLocalRegion) {
+                clippedLocalRegion.tryTransformInPlace(localToWorld);
+                if (!result)
+                    result = (clippedLocalRegion instanceof _curve_UnionRegion__WEBPACK_IMPORTED_MODULE_6__.UnionRegion) ? clippedLocalRegion : _curve_UnionRegion__WEBPACK_IMPORTED_MODULE_6__.UnionRegion.create(clippedLocalRegion);
+                else if (!result.tryAddChild(clippedLocalRegion))
+                    result.children.push(...clippedLocalRegion.children);
+            }
+        }
+        return result;
+    }
+    /**
+     * Find portions of any curve that are within the clipper.
+     * Collect them into an array of any curves.
+     */
+    static clipAnyCurve(curve, clipper) {
+        if (curve instanceof _curve_CurvePrimitive__WEBPACK_IMPORTED_MODULE_7__.CurvePrimitive)
+            return ClipUtilities.collectClippedCurves(curve, clipper);
+        if (curve.isAnyRegionType) {
+            const ret = ClipUtilities.clipAnyRegion(curve, clipper);
+            return ret ? [ret] : [];
+        }
+        const result = [];
+        if (curve instanceof _curve_Path__WEBPACK_IMPORTED_MODULE_8__.Path || curve instanceof _curve_CurveCollection__WEBPACK_IMPORTED_MODULE_9__.BagOfCurves) {
+            for (const child of curve.children) {
+                const partialClip = ClipUtilities.clipAnyCurve(child, clipper);
+                result.push(...partialClip);
+            }
+        }
+        return result;
+    }
     /**
      * Clip a polygon down to regions defined by each shape of a ClipShape.
      * @return An multidimensional array of points, where each array is the boundary of part of the remaining polygon.
@@ -178458,8 +178560,8 @@ class ClipUtilities {
             for (const plane of convexSet.planes) {
                 let numInside = 0, numOutside = 0;
                 const planeDistance = plane.distance - tolerance;
-                const currPt = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create();
-                const currVec = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Vector3d.create();
+                const currPt = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_10__.Point3d.create();
+                const currVec = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_10__.Vector3d.create();
                 for (let i = 0; i < points.length; i++) {
                     points.getPoint3dAtUncheckedPointIndex(i, currPt);
                     currVec.setFrom(currPt);
@@ -178487,15 +178589,15 @@ class ClipUtilities {
      * @param ignoreInvisiblePlanes if true, do NOT compute a facet for convex set faces marked invisible.
      */
     static announceLoopsOfConvexClipPlaneSetIntersectRange(convexSet, range, loopFunction, includeConvexSetFaces = true, includeRangeFaces = true, ignoreInvisiblePlanes = false) {
-        const work = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_2__.GrowableXYZArray();
+        const work = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__.GrowableXYZArray();
         if (includeConvexSetFaces) {
             // Clip convexSet planes to the range and to the rest of the convexSet . .
-            if (convexSet instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__.ConvexClipPlaneSet) {
+            if (convexSet instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__.ConvexClipPlaneSet) {
                 for (const plane of convexSet.planes) {
                     if (ignoreInvisiblePlanes && plane.invisible)
                         continue;
                     const pointsClippedToRange = plane.intersectRange(range, true);
-                    const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_2__.GrowableXYZArray();
+                    const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__.GrowableXYZArray();
                     if (pointsClippedToRange) {
                         convexSet.polygonClip(pointsClippedToRange, finalPoints, work, plane);
                         if (finalPoints.length > 0)
@@ -178518,10 +178620,10 @@ class ClipUtilities {
             // clip range faces to the convex set . . .
             const corners = range.corners();
             for (let i = 0; i < 6; i++) {
-                const indices = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_4__.Range3d.faceCornerIndices(i);
-                const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_2__.GrowableXYZArray();
-                const lineString = _curve_LineString3d__WEBPACK_IMPORTED_MODULE_5__.LineString3d.createIndexedPoints(corners, indices);
-                if (convexSet instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__.ConvexClipPlaneSet) {
+                const indices = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_13__.Range3d.faceCornerIndices(i);
+                const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__.GrowableXYZArray();
+                const lineString = _curve_LineString3d__WEBPACK_IMPORTED_MODULE_2__.LineString3d.createIndexedPoints(corners, indices);
+                if (convexSet instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__.ConvexClipPlaneSet) {
                     convexSet.polygonClip(lineString.packedPoints, finalPoints, work);
                     if (finalPoints.length > 0)
                         loopFunction(finalPoints);
@@ -178546,18 +178648,18 @@ class ClipUtilities {
      */
     static loopsOfConvexClipPlaneIntersectionWithRange(allClippers, range, includeConvexSetFaces = true, includeRangeFaces = true, ignoreInvisiblePlanes = false) {
         const result = [];
-        if (allClippers instanceof _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_6__.UnionOfConvexClipPlaneSets) {
+        if (allClippers instanceof _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_14__.UnionOfConvexClipPlaneSets) {
             for (const clipper of allClippers.convexSets) {
                 this.announceLoopsOfConvexClipPlaneSetIntersectRange(clipper, range, (points) => {
                     if (points.length > 0)
-                        result.push(_curve_Loop__WEBPACK_IMPORTED_MODULE_7__.Loop.createPolygon(points));
+                        result.push(_curve_Loop__WEBPACK_IMPORTED_MODULE_4__.Loop.createPolygon(points));
                 }, includeConvexSetFaces, includeRangeFaces, ignoreInvisiblePlanes);
             }
         }
-        else if (allClippers instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__.ConvexClipPlaneSet || allClippers instanceof _ClipPlane__WEBPACK_IMPORTED_MODULE_8__.ClipPlane) {
+        else if (allClippers instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__.ConvexClipPlaneSet || allClippers instanceof _ClipPlane__WEBPACK_IMPORTED_MODULE_15__.ClipPlane) {
             this.announceLoopsOfConvexClipPlaneSetIntersectRange(allClippers, range, (points) => {
                 if (points.length > 0)
-                    result.push(_curve_Loop__WEBPACK_IMPORTED_MODULE_7__.Loop.createPolygon(points));
+                    result.push(_curve_Loop__WEBPACK_IMPORTED_MODULE_4__.Loop.createPolygon(points));
             }, includeConvexSetFaces, includeRangeFaces, ignoreInvisiblePlanes);
         }
         return result;
@@ -178569,7 +178671,7 @@ class ClipUtilities {
      * @param range range to intersect
      */
     static rangeOfConvexClipPlaneSetIntersectionWithRange(convexSet, range) {
-        const result = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_4__.Range3d.createNull();
+        const result = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_13__.Range3d.createNull();
         this.announceLoopsOfConvexClipPlaneSetIntersectRange(convexSet, range, (points) => {
             if (points.length > 0)
                 result.extendArray(points);
@@ -178592,22 +178694,22 @@ class ClipUtilities {
     static rangeOfClipperIntersectionWithRange(clipper, range, observeInvisibleFlag = true) {
         if (clipper === undefined)
             return range.clone();
-        if (clipper instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__.ConvexClipPlaneSet)
+        if (clipper instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__.ConvexClipPlaneSet)
             return this.rangeOfConvexClipPlaneSetIntersectionWithRange(clipper, range);
-        if (clipper instanceof _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_6__.UnionOfConvexClipPlaneSets) {
-            const rangeUnion = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_4__.Range3d.createNull();
+        if (clipper instanceof _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_14__.UnionOfConvexClipPlaneSets) {
+            const rangeUnion = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_13__.Range3d.createNull();
             for (const c of clipper.convexSets) {
                 const rangeC = this.rangeOfConvexClipPlaneSetIntersectionWithRange(c, range);
                 rangeUnion.extendRange(rangeC);
             }
             return rangeUnion;
         }
-        if (clipper instanceof _ClipPrimitive__WEBPACK_IMPORTED_MODULE_9__.ClipPrimitive) {
+        if (clipper instanceof _ClipPrimitive__WEBPACK_IMPORTED_MODULE_16__.ClipPrimitive) {
             if (observeInvisibleFlag && clipper.invisible)
                 return range.clone();
             return this.rangeOfClipperIntersectionWithRange(clipper.fetchClipPlanesRef(), range);
         }
-        if (clipper instanceof _ClipVector__WEBPACK_IMPORTED_MODULE_10__.ClipVector) {
+        if (clipper instanceof _ClipVector__WEBPACK_IMPORTED_MODULE_17__.ClipVector) {
             const rangeIntersection = range.clone();
             for (const c of clipper.clips) {
                 if (observeInvisibleFlag && c.invisible) {
@@ -178639,21 +178741,21 @@ class ClipUtilities {
     static doesClipperIntersectRange(clipper, range, observeInvisibleFlag = true) {
         if (clipper === undefined)
             return true;
-        if (clipper instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__.ConvexClipPlaneSet)
+        if (clipper instanceof _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__.ConvexClipPlaneSet)
             return this.doesConvexClipPlaneSetIntersectRange(clipper, range);
-        if (clipper instanceof _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_6__.UnionOfConvexClipPlaneSets) {
+        if (clipper instanceof _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_14__.UnionOfConvexClipPlaneSets) {
             for (const c of clipper.convexSets) {
                 if (this.doesConvexClipPlaneSetIntersectRange(c, range))
                     return true;
             }
             return false;
         }
-        if (clipper instanceof _ClipPrimitive__WEBPACK_IMPORTED_MODULE_9__.ClipPrimitive) {
+        if (clipper instanceof _ClipPrimitive__WEBPACK_IMPORTED_MODULE_16__.ClipPrimitive) {
             if (observeInvisibleFlag && clipper.invisible) // um is there an easy way to detect range-completely-inside?
                 return true;
             return this.doesClipperIntersectRange(clipper.fetchClipPlanesRef(), range);
         }
-        if (clipper instanceof _ClipVector__WEBPACK_IMPORTED_MODULE_10__.ClipVector) {
+        if (clipper instanceof _ClipVector__WEBPACK_IMPORTED_MODULE_17__.ClipVector) {
             const rangeIntersection = range.clone();
             for (const c of clipper.clips) {
                 if (observeInvisibleFlag && c.invisible) {
@@ -178678,7 +178780,7 @@ class ClipUtilities {
      * @param ignoreInvisiblePlanes if true, do NOT compute a facet for convex set faces marked invisible.
      */
     static doesConvexClipPlaneSetIntersectRange(convexSet, range, includeConvexSetFaces = true, includeRangeFaces = true, ignoreInvisiblePlanes = false) {
-        const work = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_2__.GrowableXYZArray();
+        const work = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__.GrowableXYZArray();
         if (includeConvexSetFaces) {
             // Clip convexSet planes to the range and to the rest of the convexSet . .
             for (const plane of convexSet.planes) {
@@ -178686,7 +178788,7 @@ class ClipUtilities {
                     continue;
                 const pointsClippedToRange = plane.intersectRange(range, true);
                 if (pointsClippedToRange) {
-                    const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_2__.GrowableXYZArray();
+                    const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__.GrowableXYZArray();
                     convexSet.polygonClip(pointsClippedToRange, finalPoints, work, plane);
                     if (finalPoints.length > 0)
                         return true;
@@ -178697,9 +178799,9 @@ class ClipUtilities {
             // clip range faces to the convex set . . .
             const corners = range.corners();
             for (let i = 0; i < 6; i++) {
-                const indices = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_4__.Range3d.faceCornerIndices(i);
-                const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_2__.GrowableXYZArray();
-                const lineString = _curve_LineString3d__WEBPACK_IMPORTED_MODULE_5__.LineString3d.createIndexedPoints(corners, indices);
+                const indices = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_13__.Range3d.faceCornerIndices(i);
+                const finalPoints = new _geometry3d_GrowableXYZArray__WEBPACK_IMPORTED_MODULE_11__.GrowableXYZArray();
+                const lineString = _curve_LineString3d__WEBPACK_IMPORTED_MODULE_2__.LineString3d.createIndexedPoints(corners, indices);
                 convexSet.polygonClip(lineString.packedPoints, finalPoints, work);
                 if (finalPoints.length > 0)
                     return true;
@@ -178728,10 +178830,10 @@ class ClipUtilities {
         }
         // convert range0 into a clipper in local1 coordinates, then intersect with range1
         const local0ToLocal1 = worldToLocal1.multiplyTransformTransform(local0ToWorld, worldToLocal1);
-        const builder = _polyface_PolyfaceBuilder__WEBPACK_IMPORTED_MODULE_11__.PolyfaceBuilder.create();
+        const builder = _polyface_PolyfaceBuilder__WEBPACK_IMPORTED_MODULE_18__.PolyfaceBuilder.create();
         builder.addTransformedRangeMesh(local0ToLocal1, range0);
         const mesh0 = builder.claimPolyface();
-        const clipper = ClipUtilities._workClipper = _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__.ConvexClipPlaneSet.createConvexPolyface(mesh0, ClipUtilities._workClipper).clipper;
+        const clipper = ClipUtilities._workClipper = _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__.ConvexClipPlaneSet.createConvexPolyface(mesh0, ClipUtilities._workClipper).clipper;
         return ClipUtilities.doesClipperIntersectRange(clipper, myRange1);
     }
     /**
@@ -178783,9 +178885,9 @@ class ClipUtilities {
      */
     static createXYOffsetClipFromLineString(points, leftOffset, rightOffset, z0, z1) {
         if (Array.isArray(points)) {
-            return _internalContexts_LineStringOffsetClipperContext__WEBPACK_IMPORTED_MODULE_12__.LineStringOffsetClipperContext.createClipBetweenOffsets(new _geometry3d_Point3dArrayCarrier__WEBPACK_IMPORTED_MODULE_13__.Point3dArrayCarrier(points), leftOffset, rightOffset, z0, z1);
+            return _internalContexts_LineStringOffsetClipperContext__WEBPACK_IMPORTED_MODULE_19__.LineStringOffsetClipperContext.createClipBetweenOffsets(new _geometry3d_Point3dArrayCarrier__WEBPACK_IMPORTED_MODULE_20__.Point3dArrayCarrier(points), leftOffset, rightOffset, z0, z1);
         }
-        return _internalContexts_LineStringOffsetClipperContext__WEBPACK_IMPORTED_MODULE_12__.LineStringOffsetClipperContext.createClipBetweenOffsets(points, leftOffset, rightOffset, z0, z1);
+        return _internalContexts_LineStringOffsetClipperContext__WEBPACK_IMPORTED_MODULE_19__.LineStringOffsetClipperContext.createClipBetweenOffsets(points, leftOffset, rightOffset, z0, z1);
     }
     /** If data.length >= minLength threshold, push it to destination; if smaller drop it back to the cache. */
     static captureOrDrop(data, minLength, destination, cache) {
@@ -178975,7 +179077,7 @@ class ClipUtilities {
      */
     static doPolygonClipSequence(xyz, clippers, acceptedIn, acceptedOut, finalCandidates, inAction, outAction, finalFragmentAction, arrayCache) {
         if (arrayCache === undefined)
-            arrayCache = new _geometry3d_ReusableObjectCache__WEBPACK_IMPORTED_MODULE_14__.GrowableXYZArrayCache();
+            arrayCache = new _geometry3d_ReusableObjectCache__WEBPACK_IMPORTED_MODULE_3__.GrowableXYZArrayCache();
         let candidates = [arrayCache.grabAndFill(xyz)];
         let nextCandidates = [];
         const intermediateIn = [];
@@ -179012,7 +179114,7 @@ class ClipUtilities {
     /** Pass polygon `xyz` through a sequence of PolygonClip steps with "parity" rules */
     static doPolygonClipParitySequence(xyz, clippers, acceptedIn, acceptedOut, arrayCache) {
         if (arrayCache === undefined)
-            arrayCache = new _geometry3d_ReusableObjectCache__WEBPACK_IMPORTED_MODULE_14__.GrowableXYZArrayCache();
+            arrayCache = new _geometry3d_ReusableObjectCache__WEBPACK_IMPORTED_MODULE_3__.GrowableXYZArrayCache();
         let candidatesOut = [arrayCache.grabAndFill(xyz)];
         let candidatesIn = [];
         let nextCandidatesIn = [];
@@ -179064,22 +179166,22 @@ class ClipUtilities {
      */
     static createComplementaryClips(clipper) {
         const planes = clipper.planes;
-        const interval = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_4__.Range1d.createNull();
+        const interval = _geometry3d_Range__WEBPACK_IMPORTED_MODULE_13__.Range1d.createNull();
         const n = planes.length;
         const newClippers = [];
         for (const p of planes) {
-            const outerSet = _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_3__.ConvexClipPlaneSet.createEmpty();
+            const outerSet = _ConvexClipPlaneSet__WEBPACK_IMPORTED_MODULE_12__.ConvexClipPlaneSet.createEmpty();
             outerSet.addPlaneToConvexSet(p.cloneNegated());
             newClippers.push(outerSet);
         }
         for (let i = 0; i < n; i++) {
             for (let j = i + 1; j < n; j++) {
-                const ray = _curve_CurveFactory__WEBPACK_IMPORTED_MODULE_15__.CurveFactory.planePlaneIntersectionRay(planes[i], planes[j]);
+                const ray = _curve_CurveFactory__WEBPACK_IMPORTED_MODULE_21__.CurveFactory.planePlaneIntersectionRay(planes[i], planes[j]);
                 if (ray) {
                     if (clipper.hasIntersectionWithRay(ray, interval)) {
                         // the normal-to-normal vector is bisector (or close to bisector?)
                         const newNormal = planes[j].inwardNormalRef.minus(planes[i].inwardNormalRef);
-                        const plane1 = _ClipPlane__WEBPACK_IMPORTED_MODULE_8__.ClipPlane.createNormalAndPoint(newNormal, ray.origin);
+                        const plane1 = _ClipPlane__WEBPACK_IMPORTED_MODULE_15__.ClipPlane.createNormalAndPoint(newNormal, ray.origin);
                         if (plane1) {
                             const plane2 = plane1.cloneNegated();
                             newClippers[i].addPlaneToConvexSet(plane1);
@@ -179089,10 +179191,10 @@ class ClipUtilities {
                 }
             }
         }
-        return _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_6__.UnionOfConvexClipPlaneSets.createConvexSets(newClippers);
+        return _UnionOfConvexClipPlaneSets__WEBPACK_IMPORTED_MODULE_14__.UnionOfConvexClipPlaneSets.createConvexSets(newClippers);
     }
 }
-ClipUtilities._selectIntervals01TestPoint = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create();
+ClipUtilities._selectIntervals01TestPoint = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_10__.Point3d.create();
 
 function moveFragments(fragments, destination, arrayCache) {
     if (destination === undefined)
@@ -179752,6 +179854,7 @@ class ConvexClipPlaneSet {
      * Create a convex clip plane set that clips to `x0 <= x <= x1` and `y0 <= y <= y1`.
      * * Note that there is no test for the usual ordering `x0 <= x1` or `y0 <= y1`.
      * * if the usual ordering is violated, the convex set is an empty set.
+     * * More details can be found at docs/learning/geometry/Clipping.md
      */
     static createXYBox(x0, y0, x1, y1, result) {
         result = result ? result : new ConvexClipPlaneSet();
@@ -180197,7 +180300,7 @@ class ConvexClipPlaneSet {
      * valid clip in a parity sense.
      * * The containingPlane parameter allows callers within ConvexClipPlane set to bypass planes known to contain
      * the polygon.
-     * @param input input polygon, usually convex.
+     * @param input polygon, usually convex.
      * @param output output polygon
      * @param work work array.
      * @param containingPlane if this plane is found in the convex set, it is NOT applied.
@@ -180330,7 +180433,7 @@ class ConvexClipPlaneSet {
     }
     /**
      * Implement appendPolygonClip, as defined in interface PolygonClipper.
-     * @param xyz input polygon.  This is not changed.
+     * @param xyz convex polygon.  This is not changed.
      * @param insideFragments Array to receive "inside" fragments. Each fragment is a GrowableXYZArray grabbed from
      * the cache. This is NOT cleared.
      * @param outsideFragments Array to receive "outside" fragments. Each fragment is a GrowableXYZArray grabbed from
@@ -180707,8 +180810,8 @@ class UnionOfConvexClipPlaneSets {
         }
     }
     /**
-     *
-     * @param xyz input polygon.  This is not changed.
+     * Implement appendPolygonClip, as defined in interface PolygonClipper.
+     * @param xyz convex polygon. This is not changed.
      * @param insideFragments Array to receive "inside" fragments. Each fragment is a GrowableXYZArray grabbed from
      * the cache. This is NOT cleared.
      * @param outsideFragments Array to receive "outside" fragments. Each fragment is a GrowableXYZArray grabbed from
@@ -182740,7 +182843,8 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-/** A Coordinate is a Point3d with supporting methods from the GeometryQuery abstraction.
+/**
+ * A Coordinate is a Point3d with supporting methods from the GeometryQuery abstraction.
  * @public
  */
 class CoordinateXYZ extends _GeometryQuery__WEBPACK_IMPORTED_MODULE_0__.GeometryQuery {
@@ -182763,9 +182867,9 @@ class CoordinateXYZ extends _GeometryQuery__WEBPACK_IMPORTED_MODULE_0__.Geometry
     static createXYZ(x = 0, y = 0, z = 0) {
         return new CoordinateXYZ(_geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create(x, y, z));
     }
-    /** return the range of the point */
+    /** Return the range of the point */
     range() { return _geometry3d_Range__WEBPACK_IMPORTED_MODULE_2__.Range3d.create(this._xyz); }
-    /** extend `rangeToExtend` to include this point (optionally transformed) */
+    /** Extend `rangeToExtend` to include this point (optionally transformed) */
     extendRange(rangeToExtend, transform) {
         if (transform)
             rangeToExtend.extendTransformedXYZ(transform, this._xyz.x, this._xyz.y, this._xyz.z);
@@ -182777,31 +182881,30 @@ class CoordinateXYZ extends _GeometryQuery__WEBPACK_IMPORTED_MODULE_0__.Geometry
         transform.multiplyPoint3d(this._xyz, this._xyz);
         return true;
     }
-    /** return a transformed clone.
-     */
+    /** Return a transformed clone */
     cloneTransformed(transform) {
         const result = new CoordinateXYZ(this._xyz.clone());
         result.tryTransformInPlace(transform);
         return result;
     }
-    /** return a clone */
+    /** Return a clone */
     clone() {
         return new CoordinateXYZ(this._xyz.clone());
     }
-    /** return GeometryQuery children for recursive queries.
-     *
-     * * leaf classes do not need to implement.
+    /**
+     * Return GeometryQuery children for recursive queries.
+     * * Leaf classes do not need to implement.
      */
-    /** test if (other instanceof Coordinate).  */
+    /** Test if (other instanceof Coordinate).  */
     isSameGeometryClass(other) {
         return other instanceof CoordinateXYZ;
     }
-    /** test for exact structure and nearly identical geometry.
-     *
+    /**
+     * Test for exact structure and nearly identical geometry.
      * *  Leaf classes must implement !!!
-     * *  base class implementation recurses through children.
-     * *  base implementation is complete for classes with children and no properties.
-     * *  classes with both children and properties must implement for properties, call super for children.
+     * *  Base class implementation recurses through children.
+     * *  Base implementation is complete for classes with children and no properties.
+     * *  Classes with both children and properties must implement for properties, call super for children.
      */
     isAlmostEqual(other) {
         return (other instanceof CoordinateXYZ) && this._xyz.isAlmostEqual(other._xyz);
@@ -183869,7 +183972,7 @@ class CurveChain extends CurveCollection {
     /**
      * Return the index where target is found in the array of children.
      * @param alsoSearchProxies whether to also check proxy curves of the children
-    */
+     */
     childIndex(target, alsoSearchProxies) {
         for (let i = 0; i < this._curves.length; i++) {
             if (this._curves[i] === target)
@@ -184211,7 +184314,7 @@ class CurveCurveCloseApproachXY extends _geometry3d_GeometryHandler__WEBPACK_IMP
     resetGeometry(geometryB) {
         this.setGeometryB(geometryB);
     }
-    /** @returns whether the `fraction` is in [0,1] within tolerance */
+    /** returns true if `fraction` is in [0,1] within tolerance */
     acceptFraction(fraction, fractionTol = 1.0e-12) {
         if (fraction < -fractionTol)
             return false;
@@ -184253,8 +184356,9 @@ class CurveCurveCloseApproachXY extends _geometry3d_GeometryHandler__WEBPACK_IMP
     cpB, fractionB0, fractionB1, reversed, intervalDetails) {
         let globalFractionA, globalFractionB;
         let globalFractionA1, globalFractionB1;
-        const isInterval = (intervalDetails !== undefined) &&
-            intervalDetails.detailA.hasFraction1 && intervalDetails.detailB.hasFraction1;
+        const isInterval = intervalDetails !== undefined &&
+            intervalDetails.detailA.hasFraction1 &&
+            intervalDetails.detailB.hasFraction1;
         if (isInterval) {
             globalFractionA = _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.interpolate(fractionA0, intervalDetails.detailA.fraction, fractionA1);
             globalFractionB = _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.interpolate(fractionB0, intervalDetails.detailB.fraction, fractionB1);
@@ -184388,8 +184492,8 @@ class CurveCurveCloseApproachXY extends _geometry3d_GeometryHandler__WEBPACK_IMP
      * @param a1  end point of line a
      * @param b0  start point of line b
      * @param b1 end point of line b
-     * @param result point to receive fractional coordinates of intersection. result.x is fraction on line a.
-     * result.y is fraction on line b.
+     * @param result point to receive fractional coordinates of intersection. result.x is fraction on line a. result.y
+     * is fraction on line b.
      */
     static segmentSegmentBoundedApproach(a0, a1, b0, b1, minDistanceSquared) {
         const ux = a1.x - a0.x;
@@ -184427,6 +184531,17 @@ class CurveCurveCloseApproachXY extends _geometry3d_GeometryHandler__WEBPACK_IMP
             closestApproach = this.updatePointToSegmentDistance(1, a1, b0, b1, -_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.dotProductXYXY(vx, vy, e10x, e10y) / vv, minDistanceSquared, closestApproach);
         return closestApproach;
     }
+    /**
+     * Return fractions of close approach within minDistance between two line segments( a0,a1) and (b0, b1)
+     * * minDistance is assumed positive
+     * Return the fractional (not xy) coordinates in result.x, result.y
+     * @param a0 start point of line a
+     * @param a1 end point of line a
+     * @param b0 start point of line b
+     * @param b1 end point of line b
+     * @param result point to receive fractional coordinates of intersection. result.x is fraction on line a. result.y
+     * is fraction on line b.
+     */
     testAndRecordFractionalPairApproach(cpA, fA0, fA1, testProjectionOnA, cpB, fB0, fB1, testProjectionOnB, reversed) {
         const pointA0 = cpA.fractionToPoint(fA0);
         const pointA1 = cpA.fractionToPoint(fA1);
@@ -185015,7 +185130,8 @@ class CurveCurveIntersectXY extends _geometry3d_GeometryHandler__WEBPACK_IMPORTE
         let globalFractionA, globalFractionB;
         let globalFractionA1, globalFractionB1;
         const isInterval = intervalDetails !== undefined &&
-            intervalDetails.detailA.hasFraction1 && intervalDetails.detailB.hasFraction1;
+            intervalDetails.detailA.hasFraction1 &&
+            intervalDetails.detailB.hasFraction1;
         if (isInterval) {
             globalFractionA = _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.interpolate(fractionA0, intervalDetails.detailA.fraction, fractionA1);
             globalFractionB = _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.interpolate(fractionB0, intervalDetails.detailB.fraction, fractionB1);
@@ -185089,8 +185205,8 @@ class CurveCurveIntersectXY extends _geometry3d_GeometryHandler__WEBPACK_IMPORTE
             this.recordPointWithLocalFractions(overlap.detailA.fraction, cpA, fractionA0, fractionA1, overlap.detailB.fraction, cpB, fractionB0, fractionB1, reversed, overlap);
         }
         else if (_numerics_Polynomials__WEBPACK_IMPORTED_MODULE_6__.SmallSystem.lineSegment3dXYTransverseIntersectionUnbounded(pointA0, pointA1, pointB0, pointB1, uv)) {
-            if (this.acceptFractionOnLine(extendA0, uv.x, extendA1, pointA0, pointA1, this._coincidentGeometryContext.tolerance)
-                && this.acceptFractionOnLine(extendB0, uv.y, extendB1, pointB0, pointB1, this._coincidentGeometryContext.tolerance)) {
+            if (this.acceptFractionOnLine(extendA0, uv.x, extendA1, pointA0, pointA1, this._coincidentGeometryContext.tolerance) &&
+                this.acceptFractionOnLine(extendB0, uv.y, extendB1, pointB0, pointB1, this._coincidentGeometryContext.tolerance)) {
                 this.recordPointWithLocalFractions(uv.x, cpA, fractionA0, fractionA1, uv.y, cpB, fractionB0, fractionB1, reversed);
             }
         }
@@ -185133,8 +185249,8 @@ class CurveCurveIntersectXY extends _geometry3d_GeometryHandler__WEBPACK_IMPORTE
         }
     }
     // Caller accesses data from a linestring or segment and passes it here.
-    // (The line segment in question might be (a) a full line segment or (b) a fragment within a linestring.  The fraction and extend parameters
-    // allow all combinations to be passed in)
+    // (The line segment in question might be (a) a full line segment or (b) a fragment within a linestring.
+    // The fraction and extend parameters allow all combinations to be passed in)
     dispatchSegmentArc(cpA, extendA0, pointA0, fractionA0, pointA1, fractionA1, extendA1, arc, extendB0, extendB1, reversed) {
         // Arc: X = C + cU + sV
         // Line:  contains points A0,A1
@@ -185159,7 +185275,8 @@ class CurveCurveIntersectXY extends _geometry3d_GeometryHandler__WEBPACK_IMPORTE
                 const arcPoint = data.center.plus2Scaled(data.vector0, cosines.atUncheckedIndex(i), data.vector90, sines.atUncheckedIndex(i));
                 const arcFraction = data.sweep.radiansToSignedPeriodicFraction(radians.atUncheckedIndex(i));
                 const lineFraction = _numerics_Polynomials__WEBPACK_IMPORTED_MODULE_6__.SmallSystem.lineSegment3dHXYClosestPointUnbounded(pointA0H, pointA1H, arcPoint);
-                if (lineFraction !== undefined && this.acceptFraction(extendA0, lineFraction, extendA1) &&
+                if (lineFraction !== undefined &&
+                    this.acceptFraction(extendA0, lineFraction, extendA1) &&
                     this.acceptFraction(extendB0, arcFraction, extendB1)) {
                     this.recordPointWithLocalFractions(lineFraction, cpA, fractionA0, fractionA1, arcFraction, arc, 0, 1, reversed);
                 }
@@ -185186,8 +185303,9 @@ class CurveCurveIntersectXY extends _geometry3d_GeometryHandler__WEBPACK_IMPORTE
                 const arcPoint = data.center.plus2Scaled(data.vector0, cosines.atUncheckedIndex(i), data.vector90, sines.atUncheckedIndex(i));
                 const arcFraction = data.sweep.radiansToSignedPeriodicFraction(radians.atUncheckedIndex(i));
                 const lineFraction = _numerics_Polynomials__WEBPACK_IMPORTED_MODULE_6__.SmallSystem.lineSegment3dXYClosestPointUnbounded(pointA0Local, pointA1Local, arcPoint);
-                if (lineFraction !== undefined && this.acceptFraction(extendA0, lineFraction, extendA1, lineFractionTol)
-                    && this.acceptFraction(extendB0, arcFraction, extendB1, arcFractionTol)) {
+                if (lineFraction !== undefined &&
+                    this.acceptFraction(extendA0, lineFraction, extendA1, lineFractionTol) &&
+                    this.acceptFraction(extendB0, arcFraction, extendB1, arcFractionTol)) {
                     this.recordPointWithLocalFractions(lineFraction, cpA, fractionA0, fractionA1, arcFraction, arc, 0, 1, reversed);
                 }
             }
@@ -185512,8 +185630,7 @@ class CurveCurveIntersectXY extends _geometry3d_GeometryHandler__WEBPACK_IMPORTE
             const curvePoint = detail.point;
             const curvePointH = this.projectPoint(curvePoint);
             const lineFraction = _numerics_Polynomials__WEBPACK_IMPORTED_MODULE_6__.SmallSystem.lineSegment3dHXYClosestPointUnbounded(pointA0H, pointA1H, curvePointH);
-            if (lineFraction !== undefined &&
-                this.acceptFraction(extendA0, lineFraction, extendA1) &&
+            if (lineFraction !== undefined && this.acceptFraction(extendA0, lineFraction, extendA1) &&
                 this.acceptFraction(extendB, fractionB, extendB)) {
                 this.recordPointWithLocalFractions(lineFraction, cpA, fractionA0, fractionA1, fractionB, bcurve, 0, 1, reversed);
             }
@@ -191116,7 +191233,7 @@ class Path extends _CurveCollection__WEBPACK_IMPORTED_MODULE_0__.CurveChain {
             curve.emitStrokes(strokes, options);
         return Path.create(strokes);
     }
-    /** Return the boundary type (1) of a corresponding  MicroStation CurveVector */
+    /** Return the boundary type (1) of a corresponding MicroStation CurveVector */
     dgnBoundaryType() {
         return 1;
     }
@@ -194810,7 +194927,7 @@ class UnionRegion extends _CurveCollection__WEBPACK_IMPORTED_MODULE_0__.CurveCol
      * * Returns false if the `AnyCurve` child is not a region type.
      */
     tryAddChild(child) {
-        if (child && child instanceof _ParityRegion__WEBPACK_IMPORTED_MODULE_1__.ParityRegion || child instanceof _Loop__WEBPACK_IMPORTED_MODULE_2__.Loop) {
+        if (child && (child instanceof _ParityRegion__WEBPACK_IMPORTED_MODULE_1__.ParityRegion || child instanceof _Loop__WEBPACK_IMPORTED_MODULE_2__.Loop)) {
             this._children.push(child);
             return true;
         }
@@ -202842,7 +202959,6 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-/* eslint-disable @typescript-eslint/naming-convention, no-empty */
 
 
 
@@ -202850,6 +202966,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+/* eslint-disable @typescript-eslint/naming-convention, no-empty */
 /**
  * Helper class to accumulate points and vectors until there is enough data to define a coordinate system.
  *
@@ -202857,10 +202974,10 @@ __webpack_require__.r(__webpack_exports__);
  *   * create the FrameBuilder and make calls to announcePoint and announceVector.
  *   * the frame will be fully determined by an origin and two vectors.
  *   * the first call to announcePoint will set the origin.
- *   *  additional calls to announcePoint will produce announceVector call with the vector from the origin.
- *   * After each announcement, call getValidatedFrame(false)
+ *   * additional calls to announcePoint will produce announceVector call with the vector from the origin.
+ *   * after each announcement, call getValidatedFrame(false)
  *   * getValidatedFrame will succeed when it has two independent vectors.
- * *  to build a left handed frame,
+ * *  To build a left handed frame,
  *   *  an origin and 3 independent vectors are required.
  *   *  announce as above, but query with getValidatedFrame (true).
  *   *  this will use the third vector to select right or left handed frame.
@@ -202875,11 +202992,18 @@ class FrameBuilder {
         }
         return false;
     }
-    /** clear all accumulated point and vector data */
-    clear() { this._origin = undefined; this._vector0 = undefined; this._vector1 = undefined; this._vector2 = undefined; }
-    constructor() { this.clear(); }
-    /** Try to assemble the data into a non-singular transform.
-     *
+    /** Clear all accumulated point and vector data */
+    clear() {
+        this._origin = undefined;
+        this._vector0 = undefined;
+        this._vector1 = undefined;
+        this._vector2 = undefined;
+    }
+    constructor() {
+        this.clear();
+    }
+    /**
+     * Try to assemble the data into a non-singular transform.
      * * If allowLeftHanded is false, vector0 and vector1 determine a right handed coordinate system.
      * * if allowLeftHanded is true, the z vector of the right handed system can be flipped to agree with vector2 direction.
      */
@@ -202914,8 +203038,11 @@ class FrameBuilder {
         }
     }
     /** Ask if there is a defined origin for the evolving frame */
-    get hasOrigin() { return this._origin !== undefined; }
-    /** Return the number of vectors saved.   Because the save process checks numerics, this should be the rank of the system.
+    get hasOrigin() {
+        return this._origin !== undefined;
+    }
+    /**
+     * Return the number of vectors saved. Because the save process checks numerics, this should be the rank of the system.
      */
     savedVectorCount() {
         if (!this._vector0)
@@ -202926,7 +203053,9 @@ class FrameBuilder {
             return 2;
         return 3;
     }
-    /** announce a new point.  If this point is different from the origin, also compute and announce the vector from the origin.*/
+    /**
+     * Announce a new point. If this point is different from the origin, also compute and announce the vector from the origin.
+     */
     announcePoint(point) {
         if (!this._origin) {
             this._origin = point.clone();
@@ -202937,7 +203066,7 @@ class FrameBuilder {
             return this.savedVectorCount();
         return this.announceVector(this._origin.vectorTo(point));
     }
-    /** announce a new vector. */
+    /** Announce a new vector. */
     announceVector(vector) {
         if (vector.isAlmostZero)
             return this.savedVectorCount();
@@ -202964,8 +203093,9 @@ class FrameBuilder {
         // fall through if prior vectors are all there -- no need for the new one.
         return 3;
     }
-    /** Inspect the content of the data.  Announce points and vectors.   Return when savedVectorCount becomes
-     * sufficient for a coordinate system.
+    /**
+     * Inspect the content of the data.  Announce points and vectors. Return when savedVectorCount becomes sufficient
+     * for a coordinate system.
      */
     announce(data) {
         if (this.savedVectorCount() > 1)
@@ -203046,11 +203176,11 @@ class FrameBuilder {
             }
         }
     }
-    /** create a localToWorld frame for the given data.
-     *
-     * *  origin is at first point
-     * *  x axis in direction of first nonzero vector present or implied by the input.
-     * *  y axis is perpendicular to x and contains (in positive side) the next vector present or implied by the input.
+    /**
+     * Create a localToWorld frame for the given data.
+     * * origin is at first point.
+     * * x axis in direction of first nonzero vector present or implied by the input.
+     * * y axis is perpendicular to x and contains (in positive side) the next vector present or implied by the input.
      */
     static createRightHandedFrame(defaultUpVector, ...params) {
         const builder = new FrameBuilder();
@@ -203085,10 +203215,11 @@ class FrameBuilder {
         }
         return undefined;
     }
-    /** create a transform containing points or vectors in the given data.
+    /**
+     * Create a transform containing points or vectors in the given data.
      * * The xy columns of the transform contain the first points or vectors of the data.
      * * The z column is perpendicular to that xy plane.
-     * * The calculation favors the first points found.  It does not try to get a "best" plane.
+     * * The calculation favors the first points found. It does not try to get a "best" plane.
      */
     static createRightHandedLocalToWorld(...params) {
         const builder = new FrameBuilder();
@@ -203101,10 +203232,9 @@ class FrameBuilder {
         return undefined;
     }
     /**
-     * try to create a frame whose xy plane is through points.
-     *
-     * *  if 3 or more distinct points are present, the x axis is from the first point to the most distance, and y direction is toward the
-     * point most distant from that line.
+     * Try to create a frame whose xy plane is through points.
+     * * If 3 or more distinct points are present, the x axis is from the first point to the most distant, and y
+     * direction is toward the point most distant from that line.
      * @param points array of points
      */
     static createFrameToDistantPoints(points) {
@@ -203121,10 +203251,10 @@ class FrameBuilder {
         return undefined;
     }
     /**
-     * try to create a frame whose xy plane is through points, with the points appearing CCW in the local frame.
+     * Try to create a frame whose xy plane is through points, with the points appearing CCW in the local frame.
      *
-     * *  if 3 or more distinct points are present, the x axis is from the first point to the most distance, and y direction is toward the
-     * point most distant from that line.
+     * * If 3 or more distinct points are present, the x axis is from the first point to the most distant, and y
+     * direction is toward the point most distant from that line.
      * @param points array of points
      */
     static createFrameWithCCWPolygon(points) {
@@ -204125,12 +204255,11 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   GrowableXYArray: () => (/* binding */ GrowableXYArray)
 /* harmony export */ });
-/* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
+/* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
 /* harmony import */ var _GrowableXYZArray__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./GrowableXYZArray */ "../../core/geometry/lib/esm/geometry3d/GrowableXYZArray.js");
 /* harmony import */ var _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./IndexedXYCollection */ "../../core/geometry/lib/esm/geometry3d/IndexedXYCollection.js");
 /* harmony import */ var _Point2dVector2d__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./Point2dVector2d */ "../../core/geometry/lib/esm/geometry3d/Point2dVector2d.js");
-/* harmony import */ var _Point3dVector3d__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
-/* harmony import */ var _PointStreaming__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./PointStreaming */ "../../core/geometry/lib/esm/geometry3d/PointStreaming.js");
+/* harmony import */ var _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -204143,7 +204272,6 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-
 /** `GrowableXYArray` manages a (possibly growing) Float64Array to pack xy coordinates.
  * @public
  */
@@ -204238,26 +204366,33 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
         return newPoints;
     }
     /** Create an array populated from
-     * * An array of Point2d
-     * * An array of Point3d (hidden as XAndY)
-     * * An array of objects with keyed values, et `{x:1, y:1}`
-     * * A `GrowableXYZArray`
+     * Valid inputs are:
+     * * Point2d
+     * * Point3d
+     * * An array of 2 doubles
+     * * An array of 3 doubles
+     * * A GrowableXYZArray
+     * * A GrowableXYArray
+     * * Any json object satisfying Point3d.isXAndY
+     * * A Float64Array of doubles, interpreted as xyxy
+     * * An array of any of the above
      */
-    static create(data) {
-        const newPoints = new GrowableXYArray(data.length);
-        if (data instanceof _GrowableXYZArray__WEBPACK_IMPORTED_MODULE_1__.GrowableXYZArray) {
-            newPoints.pushAllXYAndZ(data);
+    static create(data, result) {
+        if (result) {
+            result.clear();
         }
         else {
-            newPoints.pushAll(data);
+            const pointCount = typeof data[0] === "number" ? data.length / 2 : data.length;
+            result = new GrowableXYArray(pointCount);
         }
-        return newPoints;
+        result.pushFrom(data);
+        return result;
     }
-    /** Restructure MultiLineStringDataVariant as array of GrowableXYZArray */
+    /** Restructure MultiLineStringDataVariant as array of GrowableXYZArray
+     * @deprecated in 4.x. Moved to GrowableXYZArray class.
+     */
     static createArrayOfGrowableXYZArray(data) {
-        const collector = new _PointStreaming__WEBPACK_IMPORTED_MODULE_2__.PointStreamGrowableXYZArrayCollector();
-        _PointStreaming__WEBPACK_IMPORTED_MODULE_2__.VariantPointDataStream.streamXYZ(data, collector);
-        return collector.claimArrayOfGrowableXYZArray();
+        return _GrowableXYZArray__WEBPACK_IMPORTED_MODULE_1__.GrowableXYZArray.createArrayOfGrowableXYZArray(data);
     }
     /** push a point to the end of the array */
     push(toPush) {
@@ -204283,6 +204418,51 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
                 this.pushXY(p.x, p.y);
         }
     }
+    /** Push points from variant sources.
+     * Valid inputs are:
+     * * Point2d
+     * * Point3d
+     * * An array of 2 doubles
+     * * A GrowableXYArray
+     * * A GrowableXYZArray
+     * * Any json object satisfying Point3d.isXAndY
+     * * A Float64Array of doubles, interpreted as xyxy
+     * * An array of any of the above
+     */
+    pushFrom(p) {
+        if (p instanceof _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d) {
+            this.pushXY(p.x, p.y);
+        }
+        else if (p instanceof _GrowableXYZArray__WEBPACK_IMPORTED_MODULE_1__.GrowableXYZArray) {
+            this.pushAllXYAndZ(p);
+        }
+        else if (p instanceof _Point2dVector2d__WEBPACK_IMPORTED_MODULE_3__.Point2d) {
+            this.pushXY(p.x, p.y);
+        }
+        else if (_Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.isNumberArray(p, 3) || p instanceof Float64Array) {
+            const xyToAdd = Math.trunc(p.length / 2);
+            this.ensureCapacity(this._xyInUse + xyToAdd, false);
+            this.copyData(p, xyToAdd, this._xyInUse);
+            this._xyInUse += xyToAdd;
+        }
+        else if (_Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.isNumberArray(p, 2)) {
+            this.pushXY(p[0], p[1]);
+        }
+        else if (Array.isArray(p)) {
+            // direct recursion re-wraps p and goes infinite. Unroll here.
+            for (const q of p)
+                this.pushFrom(q);
+        }
+        else if (_Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.isXAndY(p)) {
+            this.pushXY(p.x, p.y);
+        }
+        else if (p instanceof _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.IndexedXYCollection) {
+            const n = p.length;
+            this.ensureCapacity(this._xyInUse + n, false);
+            for (let i = 0; i < n; i++)
+                this.pushXY(p.getXAtUncheckedPointIndex(i), p.getYAtUncheckedPointIndex(i));
+        }
+    }
     /**
      * Replicate numWrap xy values from the front of the array as new values at the end.
      * @param numWrap number of xy values to replicate
@@ -204518,7 +204698,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
         const result = [];
         const data = this._data;
         for (let i = 0; i < n; i += 2)
-            result.push(_Point3dVector3d__WEBPACK_IMPORTED_MODULE_4__.Point3d.create(data[i], data[i + 1], z));
+            result.push(_Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.create(data[i], data[i + 1], z));
         return result;
     }
     /** reverse the order of points. */
@@ -204612,7 +204792,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
         const n = 2 * (this._xyInUse - 1); // Length already takes into account what specifically is in use
         const data = this._data;
         for (let i = 0; i < n; i += 2)
-            sum += _Geometry__WEBPACK_IMPORTED_MODULE_5__.Geometry.hypotenuseXY(data[i + 2] - data[i], data[i + 3] - data[i + 1]);
+            sum += _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXY(data[i + 2] - data[i], data[i + 3] - data[i + 1]);
         return sum;
     }
     /**
@@ -204651,7 +204831,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
             for (let i = 2; i < n; i += 2, dx1 = dx2, dy1 = dy2) {
                 dx2 = this._data[i] - x0;
                 dy2 = this._data[i + 1] - y0;
-                area += _Geometry__WEBPACK_IMPORTED_MODULE_5__.Geometry.crossProductXYXY(dx1, dy1, dx2, dy2);
+                area += _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.crossProductXYXY(dx1, dy1, dx2, dy2);
             }
         }
         return 0.5 * area;
@@ -204681,7 +204861,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
             const j = targetAIndex * 2;
             const k = targetBIndex * 2;
             const data = this._data;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_5__.Geometry.crossProductXYXY(data[j] - data[i], data[j + 1] - data[i + 1], data[k] - data[i], data[k + 1] - data[i + 1]);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.crossProductXYXY(data[j] - data[i], data[j + 1] - data[i + 1], data[k] - data[i], data[k + 1] - data[i + 1]);
         }
         return undefined;
     }
@@ -204691,7 +204871,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
             const j = targetAIndex * 2;
             const k = targetBIndex * 2;
             const data = this._data;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_5__.Geometry.crossProductXYXY(data[j] - origin.x, data[j + 1] - origin.y, data[k] - origin.x, data[k + 1] - origin.y);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.crossProductXYXY(data[j] - origin.x, data[j + 1] - origin.y, data[k] - origin.x, data[k + 1] - origin.y);
         }
         return undefined;
     }
@@ -204700,7 +204880,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
         if (this.isIndexValid(i) && this.isIndexValid(j)) {
             const i0 = 2 * i;
             const j0 = 2 * j;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_5__.Geometry.hypotenuseXY(this._data[j0] - this._data[i0], this._data[j0 + 1] - this._data[i0 + 1]);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXY(this._data[j0] - this._data[i0], this._data[j0 + 1] - this._data[i0 + 1]);
         }
         return undefined;
     }
@@ -204708,7 +204888,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
     distanceIndexToPoint(i, spacePoint) {
         if (this.isIndexValid(i)) {
             const i0 = 2 * i;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_5__.Geometry.hypotenuseXY(spacePoint.x - this._data[i0], spacePoint.y - this._data[i0 + 1]);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXY(spacePoint.x - this._data[i0], spacePoint.y - this._data[i0 + 1]);
         }
         return undefined;
     }
@@ -204758,7 +204938,7 @@ class GrowableXYArray extends _IndexedXYCollection__WEBPACK_IMPORTED_MODULE_0__.
         return this._data[2 * pointIndex + componentIndex];
     }
     /** Toleranced equality test */
-    isAlmostEqual(other, tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_5__.Geometry.smallMetricDistance) {
+    isAlmostEqual(other, tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.smallMetricDistance) {
         const numXY = this._xyInUse;
         if (other._xyInUse !== numXY)
             return false;
@@ -204786,12 +204966,13 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   GrowableXYZArray: () => (/* binding */ GrowableXYZArray)
 /* harmony export */ });
-/* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
+/* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
 /* harmony import */ var _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./IndexedXYZCollection */ "../../core/geometry/lib/esm/geometry3d/IndexedXYZCollection.js");
-/* harmony import */ var _Point2dVector2d__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./Point2dVector2d */ "../../core/geometry/lib/esm/geometry3d/Point2dVector2d.js");
-/* harmony import */ var _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
-/* harmony import */ var _Range__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./Range */ "../../core/geometry/lib/esm/geometry3d/Range.js");
-/* harmony import */ var _Transform__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./Transform */ "../../core/geometry/lib/esm/geometry3d/Transform.js");
+/* harmony import */ var _Point2dVector2d__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./Point2dVector2d */ "../../core/geometry/lib/esm/geometry3d/Point2dVector2d.js");
+/* harmony import */ var _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./Point3dVector3d */ "../../core/geometry/lib/esm/geometry3d/Point3dVector3d.js");
+/* harmony import */ var _PointStreaming__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./PointStreaming */ "../../core/geometry/lib/esm/geometry3d/PointStreaming.js");
+/* harmony import */ var _Range__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./Range */ "../../core/geometry/lib/esm/geometry3d/Range.js");
+/* harmony import */ var _Transform__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./Transform */ "../../core/geometry/lib/esm/geometry3d/Transform.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -204805,6 +204986,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
 /** `GrowableXYArray` manages a (possibly growing) Float64Array to pack xy coordinates.
  * @public
  */
@@ -204907,7 +205089,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
     /** Create an array from various point data formats.
      * Valid inputs are:
      * * Point2d
-     * * point3d
+     * * Point3d
      * * An array of 2 doubles
      * * An array of 3 doubles
      * * A GrowableXYZArray
@@ -204929,6 +205111,12 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         result.pushFrom(data);
         return result;
     }
+    /** Restructure MultiLineStringDataVariant as array of GrowableXYZArray */
+    static createArrayOfGrowableXYZArray(data) {
+        const collector = new _PointStreaming__WEBPACK_IMPORTED_MODULE_1__.PointStreamGrowableXYZArrayCollector();
+        _PointStreaming__WEBPACK_IMPORTED_MODULE_1__.VariantPointDataStream.streamXYZ(data, collector);
+        return collector.claimArrayOfGrowableXYZArray();
+    }
     /** push a point to the end of the array */
     push(toPush) {
         this.pushXYZ(toPush.x, toPush.y, toPush.z);
@@ -204942,7 +205130,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
     /** Push points from variant sources.
      * Valid inputs are:
      * * Point2d
-     * * point3d
+     * * Point3d
      * * An array of 2 doubles
      * * An array of 3 doubles
      * * A GrowableXYZArray
@@ -204952,30 +205140,30 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
      * * An array of any of the above
      */
     pushFrom(p) {
-        if (p instanceof _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d)
+        if (p instanceof _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d)
             this.pushXYZ(p.x, p.y, p.z);
         else if (p instanceof GrowableXYZArray)
             this.pushFromGrowableXYZArray(p);
-        else if (p instanceof _Point2dVector2d__WEBPACK_IMPORTED_MODULE_2__.Point2d)
+        else if (p instanceof _Point2dVector2d__WEBPACK_IMPORTED_MODULE_3__.Point2d)
             this.pushXYZ(p.x, p.y, 0.0);
-        else if (_Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.isNumberArray(p, 4) || p instanceof Float64Array) {
+        else if (_Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.isNumberArray(p, 4) || p instanceof Float64Array) {
             const xyzToAdd = Math.trunc(p.length / 3);
             this.ensureCapacity(this._xyzInUse + xyzToAdd, false);
             this.copyData(p, xyzToAdd, this._xyzInUse);
             this._xyzInUse += xyzToAdd;
         }
-        else if (_Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.isNumberArray(p, 3))
+        else if (_Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.isNumberArray(p, 3))
             this.pushXYZ(p[0], p[1], p[2]);
-        else if (_Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.isNumberArray(p, 2))
+        else if (_Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.isNumberArray(p, 2))
             this.pushXYZ(p[0], p[1], 0.0);
         else if (Array.isArray(p)) {
-            // direct recursion re-wraps p and goes infinite.  unroll here .
+            // direct recursion re-wraps p and goes infinite. Unroll here.
             for (const q of p)
                 this.pushFrom(q);
         }
-        else if (_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.isXYAndZ(p))
+        else if (_Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.isXYAndZ(p))
             this.pushXYZ(p.x, p.y, p.z);
-        else if (_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.isXAndY(p))
+        else if (_Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.isXAndY(p))
             this.pushXYZ(p.x, p.y, 0.0);
         else if (p instanceof _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0__.IndexedXYZCollection) {
             const n = p.length;
@@ -205076,7 +205264,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
      */
     getPoint3dAtUncheckedPointIndex(pointIndex, result) {
         const index = 3 * pointIndex;
-        return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create(this._data[index], this._data[index + 1], this._data[index + 2], result);
+        return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.create(this._data[index], this._data[index + 1], this._data[index + 2], result);
     }
     /**
      * Get a point by index, strongly typed as a Point2d.  This is unchecked.  Use getPoint2dAtCheckedPointIndex to have validity test.
@@ -205085,13 +205273,13 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
      */
     getPoint2dAtUncheckedPointIndex(pointIndex, result) {
         const index = 3 * pointIndex;
-        return _Point2dVector2d__WEBPACK_IMPORTED_MODULE_2__.Point2d.create(this._data[index], this._data[index + 1], result);
+        return _Point2dVector2d__WEBPACK_IMPORTED_MODULE_3__.Point2d.create(this._data[index], this._data[index + 1], result);
     }
     /** copy xyz into strongly typed Point3d */
     getPoint3dAtCheckedPointIndex(pointIndex, result) {
         if (this.isIndexValid(pointIndex)) {
             const index = 3 * pointIndex;
-            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create(this._data[index], this._data[index + 1], this._data[index + 2], result);
+            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.create(this._data[index], this._data[index + 1], this._data[index + 2], result);
         }
         return undefined;
     }
@@ -205114,7 +205302,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
     getPoint2dAtCheckedPointIndex(pointIndex, result) {
         if (this.isIndexValid(pointIndex)) {
             const index = 3 * pointIndex;
-            return _Point2dVector2d__WEBPACK_IMPORTED_MODULE_2__.Point2d.create(this._data[index], this._data[index + 1], result);
+            return _Point2dVector2d__WEBPACK_IMPORTED_MODULE_3__.Point2d.create(this._data[index], this._data[index + 1], result);
         }
         return undefined;
     }
@@ -205122,7 +205310,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
     getVector3dAtCheckedVectorIndex(vectorIndex, result) {
         if (this.isIndexValid(vectorIndex)) {
             const index = 3 * vectorIndex;
-            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Vector3d.create(this._data[index], this._data[index + 1], this._data[index + 2], result);
+            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Vector3d.create(this._data[index], this._data[index + 1], this._data[index + 2], result);
         }
         return undefined;
     }
@@ -205221,7 +205409,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         const result = [];
         const data = this._data;
         for (let i = 0; i < n; i += 3)
-            result.push(_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create(data[i], data[i + 1], data[i + 2]));
+            result.push(_Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.create(data[i], data[i + 1], data[i + 2]));
         return result;
     }
     /** multiply each point by the transform, replace values. */
@@ -205307,7 +205495,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         if (!matrix.computeCachedInverse(true))
             return false;
         const coffs = matrix.inverseCoffs;
-        const tol = _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.smallFloatingPoint;
+        const tol = _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.smallFloatingPoint;
         let x = 0;
         let y = 0;
         let z = 0;
@@ -205350,7 +205538,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
     multiplyMatrix4dAndQuietRenormalizeMatrix4d(matrix) {
         const data = this._data;
         const nDouble = this.float64Length;
-        const xyz1 = _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create();
+        const xyz1 = _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.create();
         for (let i = 0; i + 2 <= nDouble; i += 3) {
             matrix.multiplyXYZWQuietRenormalize(data[i], data[i + 1], data[i + 2], 1.0, xyz1);
             data[i] = xyz1.x;
@@ -205399,7 +205587,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
     }
     /** get range of points. */
     getRange(transform) {
-        const range = _Range__WEBPACK_IMPORTED_MODULE_4__.Range3d.createNull();
+        const range = _Range__WEBPACK_IMPORTED_MODULE_5__.Range3d.createNull();
         this.extendRange(range, transform);
         return range;
     }
@@ -205414,7 +205602,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         const n = 3 * (this._xyzInUse - 1); // Length already takes into account what specifically is in use
         const data = this._data;
         for (let i = 0; i < n; i += 3)
-            sum += _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.hypotenuseXYZ(data[i + 3] - data[i], data[i + 4] - data[i + 1], data[i + 5] - data[i + 2]);
+            sum += _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXYZ(data[i + 3] - data[i], data[i + 4] - data[i + 1], data[i + 5] - data[i + 2]);
         return sum;
     }
     /**
@@ -205429,7 +205617,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         }
     }
     /** test if all points are within tolerance of a plane. */
-    isCloseToPlane(plane, tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.smallMetricDistance) {
+    isCloseToPlane(plane, tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.smallMetricDistance) {
         const numCoordinate = 3 * this._xyzInUse;
         const data = this._data;
         for (let i = 0; i < numCoordinate; i += 3)
@@ -205442,7 +205630,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
      * * If already closed within tolerance, force exact copy
      * * otherwise leave unchanged.
      */
-    forceClosure(tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.smallMetricDistance) {
+    forceClosure(tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.smallMetricDistance) {
         const d = this.distanceIndexIndex(0, this.length - 1);
         // leave the empty array alone.
         // Note that singleton will generate 0 distance and do nothing.
@@ -205464,7 +205652,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
             const data = this._data;
             i = 3 * i;
             j = 3 * j;
-            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create(fraction0 * data[i] + fraction * data[j], fraction0 * data[i + 1] + fraction * data[j + 1], fraction0 * data[i + 2] + fraction * data[j + 2], result);
+            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Point3d.create(fraction0 * data[i] + fraction * data[j], fraction0 * data[i + 1] + fraction * data[j + 1], fraction0 * data[i + 2] + fraction * data[j + 2], result);
         }
         return undefined;
     }
@@ -205495,7 +205683,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
             for (let i = 3; i < n; i += 3, dx1 = dx2, dy1 = dy2) {
                 dx2 = this._data[i] - x0;
                 dy2 = this._data[i + 1] - y0;
-                area += _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.crossProductXYXY(dx1, dy1, dx2, dy2);
+                area += _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.crossProductXYXY(dx1, dy1, dx2, dy2);
             }
         }
         return 0.5 * area;
@@ -205507,14 +205695,14 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         const data = this._data;
         i = 3 * i;
         j = 3 * j;
-        return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Vector3d.create(data[j] - data[i], data[j + 1] - data[i + 1], data[j + 2] - data[i + 2], result);
+        return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Vector3d.create(data[j] - data[i], data[j + 1] - data[i + 1], data[j + 2] - data[i + 2], result);
     }
     /** Compute a vector from origin to indexed target j */
     vectorXYAndZIndex(origin, j, result) {
         if (this.isIndexValid(j)) {
             const data = this._data;
             j = 3 * j;
-            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Vector3d.create(data[j] - origin.x, data[j + 1] - origin.y, data[j + 2] - origin.z, result);
+            return _Point3dVector3d__WEBPACK_IMPORTED_MODULE_2__.Vector3d.create(data[j] - origin.x, data[j + 1] - origin.y, data[j + 2] - origin.z, result);
         }
         return undefined;
     }
@@ -205525,7 +205713,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
             const j = targetAIndex * 3;
             const k = targetBIndex * 3;
             const data = this._data;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.crossProductXYZXYZ(data[j] - data[i], data[j + 1] - data[i + 1], data[j + 2] - data[i + 2], data[k] - data[i], data[k + 1] - data[i + 1], data[k + 2] - data[i + 2], result);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.crossProductXYZXYZ(data[j] - data[i], data[j + 1] - data[i + 1], data[j + 2] - data[i + 2], data[k] - data[i], data[k + 1] - data[i + 1], data[k + 2] - data[i + 2], result);
         }
         return undefined;
     }
@@ -205573,7 +205761,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
             const j = targetAIndex * 3;
             const k = targetBIndex * 3;
             const data = this._data;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.crossProductXYZXYZ(data[j] - origin.x, data[j + 1] - origin.y, data[j + 2] - origin.z, data[k] - origin.x, data[k + 1] - origin.y, data[k + 2] - origin.z, result);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.crossProductXYZXYZ(data[j] - origin.x, data[j + 1] - origin.y, data[j + 2] - origin.z, data[k] - origin.x, data[k + 1] - origin.y, data[k + 2] - origin.z, result);
         }
         return undefined;
     }
@@ -205581,7 +205769,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
     distanceIndexToPoint(i, spacePoint) {
         if (this.isIndexValid(i)) {
             const i0 = 3 * i;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.hypotenuseXYZ(spacePoint.x - this._data[i0], spacePoint.y - this._data[i0 + 1], spacePoint.z - this._data[i0 + 2]);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXYZ(spacePoint.x - this._data[i0], spacePoint.y - this._data[i0 + 1], spacePoint.z - this._data[i0 + 2]);
         }
         return undefined;
     }
@@ -205594,7 +205782,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         if (this.isIndexValid(i) && this.isIndexValid(j)) {
             const i0 = 3 * i;
             const j0 = 3 * j;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.hypotenuseSquaredXYZ(this._data[j0] - this._data[i0], this._data[j0 + 1] - this._data[i0 + 1], this._data[j0 + 2] - this._data[i0 + 2]);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseSquaredXYZ(this._data[j0] - this._data[i0], this._data[j0 + 1] - this._data[i0 + 1], this._data[j0 + 2] - this._data[i0 + 2]);
         }
         return undefined;
     }
@@ -205607,7 +205795,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         if (this.isIndexValid(i) && this.isIndexValid(j)) {
             const i0 = 3 * i;
             const j0 = 3 * j;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.hypotenuseXYZ(this._data[j0] - this._data[i0], this._data[j0 + 1] - this._data[i0 + 1], this._data[j0 + 2] - this._data[i0 + 2]);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXYZ(this._data[j0] - this._data[i0], this._data[j0 + 1] - this._data[i0 + 1], this._data[j0 + 2] - this._data[i0 + 2]);
         }
         return undefined;
     }
@@ -205616,7 +205804,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         if (arrayA.isIndexValid(i) && arrayB.isIndexValid(j)) {
             const i0 = 3 * i;
             const j0 = 3 * j;
-            return _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.hypotenuseXYZ(arrayB._data[j0] - arrayA._data[i0], arrayB._data[j0 + 1] - arrayA._data[i0 + 1], arrayB._data[j0 + 2] - arrayA._data[i0 + 2]);
+            return _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXYZ(arrayB._data[j0] - arrayA._data[i0], arrayB._data[j0 + 1] - arrayA._data[i0 + 1], arrayB._data[j0 + 2] - arrayA._data[i0 + 2]);
         }
         return undefined;
     }
@@ -205695,10 +205883,10 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
         const n = Math.min(arrayA.length, arrayB.length);
         let i = 0;
         let k0;
-        const range = _Range__WEBPACK_IMPORTED_MODULE_4__.Range1d.createNull();
+        const range = _Range__WEBPACK_IMPORTED_MODULE_5__.Range1d.createNull();
         while (i < n) {
             k0 = 3 * i;
-            range.extendX(_Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.hypotenuseXYZ(dataA[k0] - dataB[k0], dataA[k0 + 1] - dataB[k0 + 1], dataA[k0 + 2] - dataB[k0 + 2]));
+            range.extendX(_Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.hypotenuseXYZ(dataA[k0] - dataB[k0], dataA[k0 + 1] - dataB[k0 + 1], dataA[k0 + 2] - dataB[k0 + 2]));
             i++;
         }
         return range;
@@ -205708,7 +205896,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
      * @param points
      * @param tolerance
      */
-    static removeClosure(points, tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_3__.Geometry.smallMetricDistance) {
+    static removeClosure(points, tolerance = _Geometry__WEBPACK_IMPORTED_MODULE_4__.Geometry.smallMetricDistance) {
         while (points.length > 1 && points.distanceIndexIndex(0, points.length - 1) < tolerance)
             points.pop();
     }
@@ -205734,7 +205922,7 @@ class GrowableXYZArray extends _IndexedXYZCollection__WEBPACK_IMPORTED_MODULE_0_
             const vx = data[i0++] - ax;
             const vy = data[i0++] - ay;
             const vz = data[i0++] - az;
-            result = _Transform__WEBPACK_IMPORTED_MODULE_5__.Transform.createRowValues(ux, vx, 0, ax, uy, vy, 0, ay, uz, vz, 1, az, result);
+            result = _Transform__WEBPACK_IMPORTED_MODULE_6__.Transform.createRowValues(ux, vx, 0, ax, uy, vy, 0, ay, uz, vz, 1, az, result);
             return result.computeCachedInverse() ? result : undefined;
         }
         return undefined;
@@ -231623,11 +231811,15 @@ class PolyfaceBuilder extends _geometry3d_GeometryHandler__WEBPACK_IMPORTED_MODU
         }
     }
     /** Add a polygon to the evolving facets.
-     *
-     * * Add points to the polyface
-     * * indices are added (in reverse order if indicated by the builder state)
-     * @param normals array of points.  This may contain extra points not to be used in the polygon
-     * @param numPointsToUse number of points to use.
+     * * add points to the polyface
+     * * compute each point index as the point is added
+     * * all data arrays are parallel to the point array
+     * * point indices are added in reverse order if indicated by the builder state
+     * @param points array of vertices in order around the facet
+     * @param normals optional array of normals, one per vertex
+     * @param params optional array of uv-parameters, one per vertex
+     * @param colors optional array of colors, one per vertex
+     * @param edgeVisible optional array of flags, one per vertex, true iff edge starting at corresponding vertex is visible
      */
     addFacetFromGrowableArrays(points, normals, params, colors, edgeVisible) {
         // don't use trailing points that match start point.
@@ -287295,7 +287487,7 @@ module.exports = JSON.parse('{"name":"axios","version":"0.21.4","description":"P
 /***/ ((module) => {
 
 "use strict";
-module.exports = JSON.parse('{"name":"@itwin/core-frontend","version":"4.2.0-dev.0","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 && npm run -s build:esm && npm run -s webpackWorkers && npm run -s copy:workers","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","copy:workers":"cpx \\"./lib/workers/webpack/parse-imdl-worker.js\\" ./lib/public/scripts","docs":"betools docs --includes=../../generated-docs/extract --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/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 -c extraction.eslint.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 && npm run -s webpackTestWorker","webpackTestWorker":"webpack --config ./src/test/worker/webpack.config.js 1>&2 && cpx \\"./lib/test/test-worker.js\\" ./lib/test","webpackWorkers":"webpack --config ./src/workers/ImdlParser/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:^4.2.0-dev.0","@itwin/core-bentley":"workspace:^4.2.0-dev.0","@itwin/core-common":"workspace:^4.2.0-dev.0","@itwin/core-geometry":"workspace:^4.2.0-dev.0","@itwin/core-orbitgt":"workspace:^4.2.0-dev.0","@itwin/core-quantity":"workspace:^4.2.0-dev.0"},"//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":"4.0.0-dev.44","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/mocha":"^8.2.2","@types/node":"18.16.1","@types/sinon":"^10.0.15","babel-loader":"~8.2.5","babel-plugin-istanbul":"~6.1.1","chai":"^4.1.2","chai-as-promised":"^7","cpx2":"^3.0.0","eslint":"^8.44.0","glob":"^7.1.2","mocha":"^10.0.0","nyc":"^15.1.0","rimraf":"^3.0.2","sinon":"^15.0.4","source-map-loader":"^4.0.0","typescript":"~5.0.2","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/cloud-agnostic-core":"^2.0.0","@itwin/object-storage-core":"^2.0.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","fuse.js":"^3.3.0","wms-capabilities":"0.4.0"},"nyc":{"extends":"./node_modules/@itwin/build-tools/.nycrc"}}');
+module.exports = JSON.parse('{"name":"@itwin/core-frontend","version":"4.2.0-dev.10","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 && npm run -s build:esm && npm run -s webpackWorkers && npm run -s copy:workers","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","copy:workers":"cpx \\"./lib/workers/webpack/parse-imdl-worker.js\\" ./lib/public/scripts","docs":"betools docs --includes=../../generated-docs/extract --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/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 -c extraction.eslint.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 && npm run -s webpackTestWorker","webpackTestWorker":"webpack --config ./src/test/worker/webpack.config.js 1>&2 && cpx \\"./lib/test/test-worker.js\\" ./lib/test","webpackWorkers":"webpack --config ./src/workers/ImdlParser/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:^4.2.0-dev.10","@itwin/core-bentley":"workspace:^4.2.0-dev.10","@itwin/core-common":"workspace:^4.2.0-dev.10","@itwin/core-geometry":"workspace:^4.2.0-dev.10","@itwin/core-orbitgt":"workspace:^4.2.0-dev.10","@itwin/core-quantity":"workspace:^4.2.0-dev.10"},"//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":"4.0.0-dev.44","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/mocha":"^8.2.2","@types/node":"18.16.1","@types/sinon":"^10.0.15","babel-loader":"~8.2.5","babel-plugin-istanbul":"~6.1.1","chai":"^4.1.2","chai-as-promised":"^7","cpx2":"^3.0.0","eslint":"^8.44.0","glob":"^7.1.2","mocha":"^10.0.0","nyc":"^15.1.0","rimraf":"^3.0.2","sinon":"^15.0.4","source-map-loader":"^4.0.0","typescript":"~5.0.2","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/cloud-agnostic-core":"^2.1.0","@itwin/object-storage-core":"^2.1.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","fuse.js":"^3.3.0","wms-capabilities":"0.4.0"},"nyc":{"extends":"./node_modules/@itwin/build-tools/.nycrc"}}');
 
 /***/ })