@itwin/ecschema-rpcinterface-tests 4.3.0-dev.16 → 4.3.0-dev.18

package/lib/dist/bundled-tests.js

@@ -142675,7 +142675,7 @@ class RealityModelTileLoader extends _internal__WEBPACK_IMPORTED_MODULE_8__.Real
     }
     get doDrapeBackgroundMap() { return this.tree.doDrapeBackgroundMap; }
     get wantDeduplicatedVertices() { return this._deduplicateVertices; }
-    get maxDepth() { return 32; } // Can be removed when element tile selector is working.
+    get maxDepth() { return Number.MAX_SAFE_INTEGER; }
     get minDepth() { return 0; }
     get priority() { return _internal__WEBPACK_IMPORTED_MODULE_8__.TileLoadPriority.Context; }
     getBatchIdMap() { return this._batchedIdMap; }
@@ -186094,7 +186094,7 @@ class CurveOps {
     /**
      * Construct a separate xy-offset for each input curve.
      * * For best offset results, the inputs should be parallel to the xy-plane.
-     * @param curves input curve(s), z-coordinates ignored. Only [[ChainTypes]] are handled.
+     * @param curves input curve(s), z-coordinates ignored. Only curves of type [[AnyChain]] are handled.
      * @param offset offset distance (positive to left of curve, negative to right)
      * @param result array to collect offset curves
      * @returns summed length of offset curves
@@ -197713,7 +197713,10 @@ class Joint {
             return numOut++ < maxTest;
         }, maxTest);
     }
-    /** Execute `joint.annotateJointMode()` at all joints on the chain to set some of the joints attributes. */
+    /**
+     * Execute `joint.annotateJointMode()` at all joints on the chain to set some of the joints' attributes,
+     * such as whether to extend both curves to intersection or to fill the gap between curves.
+     */
     static annotateChain(start, options, maxTest = 100) {
         if (start)
             Joint.visitJointsOnChain(start, (joint) => { joint.annotateJointMode(options); return true; }, maxTest);
@@ -197745,6 +197748,7 @@ class Joint {
         if (this.curve0 && this.curve1) {
             const ray0 = this.curve0.fractionToPointAndDerivative(1.0);
             const ray1 = this.curve1.fractionToPointAndDerivative(0.0);
+            ray0.direction.z = ray1.direction.z = 0.0; // xy-offset
             const intersection = _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_6__.Ray3d.closestApproachRay3dRay3d(ray0, ray1); // intersection of the 2 ray lines
             if (intersection.approachType === _CurveLocationDetail__WEBPACK_IMPORTED_MODULE_7__.CurveCurveApproachType.Intersection) {
                 if (intersection.detailA.fraction >= 0.0 && intersection.detailB.fraction <= 0.0) {
@@ -197823,7 +197827,7 @@ class Joint {
             this.fraction0 = 1.0;
         }
         else if (this.curve0 && this.curve1) { // joints at the middle of the chain
-            if (this.curve0.endPoint().isAlmostEqual(this.curve1.startPoint())) { // joint between colinear segments
+            if (this.curve0.endPoint().isAlmostEqualXY(this.curve1.startPoint())) { // joint between colinear xy-segments
                 this.fraction0 = 1.0;
                 this.fraction1 = 0.0;
                 this.flexure = JointMode.Trim;
@@ -197831,8 +197835,9 @@ class Joint {
             else if (this.curve0 instanceof _LineSegment3d__WEBPACK_IMPORTED_MODULE_4__.LineSegment3d && this.curve1 instanceof _LineSegment3d__WEBPACK_IMPORTED_MODULE_4__.LineSegment3d) { // pair of lines
                 const ray0 = this.curve0.fractionToPointAndDerivative(0.0);
                 const ray1 = this.curve1.fractionToPointAndDerivative(0.0);
+                ray0.direction.z = ray1.direction.z = 0.0; // xy-offset
                 const intersection = _geometry3d_Ray3d__WEBPACK_IMPORTED_MODULE_6__.Ray3d.closestApproachRay3dRay3d(ray0, ray1); // intersection of the 2 ray lines
-                if (intersection.approachType === _CurveLocationDetail__WEBPACK_IMPORTED_MODULE_7__.CurveCurveApproachType.Intersection) {
+                if (intersection.approachType === _CurveLocationDetail__WEBPACK_IMPORTED_MODULE_7__.CurveCurveApproachType.Intersection || intersection.approachType === _CurveLocationDetail__WEBPACK_IMPORTED_MODULE_7__.CurveCurveApproachType.PerpendicularChord) {
                     this.fraction0 = intersection.detailA.fraction;
                     this.fraction1 = intersection.detailB.fraction;
                     if (this.fraction0 >= 1.0 && this.fraction1 <= 0.0) { // need to extend
@@ -197953,7 +197958,7 @@ class Joint {
     }
 }
 /**
- * Context for building a wire offset.
+ * Context for building a wire xy-offset.
  * @internal
  */
 class PolygonWireOffsetContext {
@@ -197962,6 +197967,7 @@ class PolygonWireOffsetContext {
     // Construct a single offset from base points
     static createOffsetSegment(basePointA, basePointB, distance) {
         _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Vector3d.createStartEnd(basePointA, basePointB, this._unitAlong);
+        this._unitAlong.z = 0.0; // xy-offset
         if (this._unitAlong.normalizeInPlace()) {
             this._unitAlong.rotate90CCWXY(this._unitPerp);
             const segment = _LineSegment3d__WEBPACK_IMPORTED_MODULE_4__.LineSegment3d.create(basePointA.plusScaled(this._unitPerp, distance, this._offsetA), basePointB.plusScaled(this._unitPerp, distance, this._offsetB));
@@ -197971,8 +197977,8 @@ class PolygonWireOffsetContext {
         return undefined;
     }
     /**
-     * Construct a wire (not area) that is offset from given polyline or polygon (which must be in xy-plane or in
-     *  a plane parallel to xy-plane).
+     * Construct a wire (not area) that is offset from given polyline or polygon.
+     * * For best results, points should be in a horizontal plane because z-coordinates are ignored.
      * * This is a simple wire offset (in the form of a line string), not an area.
      * * If offsetDistance is given as a number, default OffsetOptions are applied.
      * * See [[JointOptions]] class doc for offset construction rules.
@@ -197982,36 +197988,34 @@ class PolygonWireOffsetContext {
      * object.
      */
     constructPolygonWireXYOffset(points, wrap, leftOffsetDistanceOrOptions) {
-        /**
-         * if "wrap = true", then first and last point in the points array must be close; otherwise
-         * generated offset will be invalid.
-         */
-        if (wrap && !points[0].isAlmostEqual(points[points.length - 1])) {
-            wrap = false;
-        }
-        /** create raw offsets as a linked list (joint0) */
+        if (wrap && !points[0].isAlmostEqual(points[points.length - 1]))
+            wrap = false; // no wrap possible for polylines
+        // create raw offset segments as a linked list of Joints, starting with joint0
         const options = _OffsetOptions__WEBPACK_IMPORTED_MODULE_9__.JointOptions.create(leftOffsetDistanceOrOptions);
         const numPoints = points.length;
-        let fragment0 = PolygonWireOffsetContext.createOffsetSegment(points[0], points[1], options.leftOffsetDistance);
-        let joint0 = new Joint(undefined, fragment0, points[0]);
-        let newJoint;
-        let previousJoint = joint0;
-        for (let i = 1; i + 1 < numPoints; i++) {
-            const fragment1 = PolygonWireOffsetContext.createOffsetSegment(points[i], points[i + 1], options.leftOffsetDistance);
-            newJoint = new Joint(fragment0, fragment1, points[i]);
-            Joint.link(previousJoint, newJoint);
-            previousJoint = newJoint;
-            fragment0 = fragment1;
-        }
-        if (wrap)
-            Joint.link(previousJoint, joint0);
-        else {
-            newJoint = new Joint(fragment0, undefined, points[numPoints - 1]);
-            Joint.link(previousJoint, newJoint);
+        let fragment0;
+        let joint0, previousJoint;
+        for (let i = 0; i + 1 < numPoints; ++i) {
+            if (!previousJoint) { // start the linked list at the first nontrivial xy-segment
+                if (fragment0 = PolygonWireOffsetContext.createOffsetSegment(points[i], points[i + 1], options.leftOffsetDistance))
+                    previousJoint = joint0 = new Joint(undefined, fragment0, points[i]);
+            }
+            else {
+                const fragment1 = PolygonWireOffsetContext.createOffsetSegment(points[i], points[i + 1], options.leftOffsetDistance);
+                if (fragment1) { // append the next nontrivial xy-segment
+                    const newJoint = new Joint(fragment0, fragment1, points[i]);
+                    Joint.link(previousJoint, newJoint);
+                    previousJoint = newJoint;
+                    fragment0 = fragment1;
+                }
+            }
         }
-        /** annotateChain sets some of the joints attributes (including how to extend curves or fill the gap between curves) */
+        if (!fragment0 || !previousJoint || !joint0)
+            return undefined; // no edge with positive xy-length
+        const lastJoint = wrap ? joint0 : new Joint(fragment0, undefined, points[numPoints - 1]);
+        Joint.link(previousJoint, lastJoint);
         Joint.annotateChain(joint0, options, numPoints);
-        /** make limited passes through the Joint chain until no self-intersections are removed */
+        // make limited passes through the Joint chain until no self-intersections are removed
         for (let pass = 0; pass++ < 5;) {
             const state = Joint.removeDegeneratePrimitives(joint0, options, numPoints);
             joint0 = state.newStart;
@@ -198024,10 +198028,8 @@ class PolygonWireOffsetContext {
             }
             */
         }
-        // Joint.collectPrimitivesFromChain(joint0, result, numPoints);
-        /** turn the Joint linked list into a CurveCollection (Loop or Path). trimming is done in collectStrokesFromChain */
         const chain = _LineString3d__WEBPACK_IMPORTED_MODULE_5__.LineString3d.create();
-        Joint.collectStrokesFromChain(joint0, chain, numPoints);
+        Joint.collectStrokesFromChain(joint0, chain, numPoints); // compute offset corners (by extension/trim)
         const n = chain.packedPoints.length;
         if (n > 1) {
             if (chain.packedPoints.front().isAlmostEqual(chain.packedPoints.back()))
@@ -198044,7 +198046,7 @@ PolygonWireOffsetContext._offsetA = _geometry3d_Point3dVector3d__WEBPACK_IMPORTE
 PolygonWireOffsetContext._offsetB = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_1__.Point3d.create();
 
 /**
- * Context for building a wire offset from a Path or Loop of CurvePrimitives
+ * Context for building a wire xy-offset from a Path or Loop of CurvePrimitives
  * @internal
  */
 class CurveChainWireOffsetContext {
@@ -213878,6 +213880,16 @@ class Vector3d extends XYZ {
     angleFromPerpendicular(planeNormal) {
         return _Angle__WEBPACK_IMPORTED_MODULE_2__.Angle.createAtan2(this.dotProduct(planeNormal), this.crossProductMagnitude(planeNormal));
     }
+    /**
+     * Return the angle in radians (not as strongly typed Angle) from this vector to the plane perpendicular to planeNormal.
+     * * The returned angle is between -PI/2 and PI/2.
+     * * The returned angle is measured in the plane containing the two vectors.
+     * * The function returns PI/2 - radiansTo(planeNormal).
+     * @param planeNormal a normal vector to the plane.
+     */
+    radiansFromPerpendicular(planeNormal) {
+        return Math.atan2(this.dotProduct(planeNormal), this.crossProductMagnitude(planeNormal));
+    }
     /**
      * Return the (strongly-typed) angle from this vector to vectorB, using only the xy parts.
      * * The returned angle is between -180 and 180 degrees.
@@ -232754,8 +232766,12 @@ class PolyfaceBuilder extends _geometry3d_GeometryHandler__WEBPACK_IMPORTED_MODU
      */
     addTorusPipe(surface, phiStrokeCount, thetaStrokeCount) {
         const thetaFraction = surface.getThetaFraction();
-        const numU = _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.clamp(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.resolveNumber(phiStrokeCount, 8), 4, 64);
-        const numV = _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.clamp(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.resolveNumber(thetaStrokeCount, Math.ceil(16 * thetaFraction)), 2, 64);
+        let numU = _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.clamp(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.resolveNumber(phiStrokeCount, 8), 4, 64);
+        let numV = _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.clamp(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.resolveNumber(thetaStrokeCount, Math.ceil(16 * thetaFraction)), 2, 64);
+        if (this._options) {
+            numU = this._options.applyTolerancesToArc(surface.getMinorRadius());
+            numV = this._options.applyTolerancesToArc(surface.getMajorRadius(), surface.getSweepAngle().radians);
+        }
         this.toggleReversedFacetFlag();
         const sizes = surface.maxIsoParametricDistance();
         this.addUVGridBody(surface, numU, numV, _geometry3d_Segment1d__WEBPACK_IMPORTED_MODULE_14__.Segment1d.create(0, sizes.x), _geometry3d_Segment1d__WEBPACK_IMPORTED_MODULE_14__.Segment1d.create(0, sizes.y));
@@ -233225,6 +233241,12 @@ class PolyfaceBuilder extends _geometry3d_GeometryHandler__WEBPACK_IMPORTED_MODU
     addFacetFromVisitor(visitor) {
         this.addFacetFromGrowableArrays(visitor.point, visitor.normal, visitor.param, visitor.color, visitor.edgeVisible);
     }
+    /** Add all visitor facets to the evolving polyface (in reverse order if indicated by the builder state) */
+    addFacetsFromVisitor(visitor) {
+        visitor.reset();
+        for (; visitor.moveToNextFacet();)
+            this.addFacetFromVisitor(visitor);
+    }
     /**
      * Add the subset of visitor data indexed by the indices.
      * * Ideally, the subset represents a sub-facet of the visited facet.
@@ -234875,7 +234897,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var _curve_CurveCollection__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../curve/CurveCollection */ "../../core/geometry/lib/esm/curve/CurveCollection.js");
 /* harmony import */ var _curve_CurveOps__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(/*! ../curve/CurveOps */ "../../core/geometry/lib/esm/curve/CurveOps.js");
-/* harmony import */ var _curve_internalContexts_MultiChainCollector__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(/*! ../curve/internalContexts/MultiChainCollector */ "../../core/geometry/lib/esm/curve/internalContexts/MultiChainCollector.js");
+/* harmony import */ var _curve_internalContexts_MultiChainCollector__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ../curve/internalContexts/MultiChainCollector */ "../../core/geometry/lib/esm/curve/internalContexts/MultiChainCollector.js");
 /* harmony import */ var _curve_LineSegment3d__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ../curve/LineSegment3d */ "../../core/geometry/lib/esm/curve/LineSegment3d.js");
 /* harmony import */ var _curve_LineString3d__WEBPACK_IMPORTED_MODULE_3__ = __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");
@@ -234891,7 +234913,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _geometry3d_Range__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(/*! ../geometry3d/Range */ "../../core/geometry/lib/esm/geometry3d/Range.js");
 /* harmony import */ var _geometry4d_Matrix4d__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ../geometry4d/Matrix4d */ "../../core/geometry/lib/esm/geometry4d/Matrix4d.js");
 /* harmony import */ var _geometry4d_MomentData__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ../geometry4d/MomentData */ "../../core/geometry/lib/esm/geometry4d/MomentData.js");
-/* harmony import */ var _numerics_UnionFind__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(/*! ../numerics/UnionFind */ "../../core/geometry/lib/esm/numerics/UnionFind.js");
+/* harmony import */ var _numerics_UnionFind__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(/*! ../numerics/UnionFind */ "../../core/geometry/lib/esm/numerics/UnionFind.js");
 /* harmony import */ var _topology_ChainMerge__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(/*! ../topology/ChainMerge */ "../../core/geometry/lib/esm/topology/ChainMerge.js");
 /* harmony import */ var _topology_Graph__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(/*! ../topology/Graph */ "../../core/geometry/lib/esm/topology/Graph.js");
 /* harmony import */ var _topology_HalfEdgeGraphFromIndexedLoopsContext__WEBPACK_IMPORTED_MODULE_30__ = __webpack_require__(/*! ../topology/HalfEdgeGraphFromIndexedLoopsContext */ "../../core/geometry/lib/esm/topology/HalfEdgeGraphFromIndexedLoopsContext.js");
@@ -234901,10 +234923,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _FacetLocationDetail__WEBPACK_IMPORTED_MODULE_35__ = __webpack_require__(/*! ./FacetLocationDetail */ "../../core/geometry/lib/esm/polyface/FacetLocationDetail.js");
 /* harmony import */ var _FacetOrientation__WEBPACK_IMPORTED_MODULE_31__ = __webpack_require__(/*! ./FacetOrientation */ "../../core/geometry/lib/esm/polyface/FacetOrientation.js");
 /* harmony import */ var _IndexedEdgeMatcher__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./IndexedEdgeMatcher */ "../../core/geometry/lib/esm/polyface/IndexedEdgeMatcher.js");
-/* harmony import */ var _IndexedPolyfaceVisitor__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(/*! ./IndexedPolyfaceVisitor */ "../../core/geometry/lib/esm/polyface/IndexedPolyfaceVisitor.js");
+/* harmony import */ var _IndexedPolyfaceVisitor__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(/*! ./IndexedPolyfaceVisitor */ "../../core/geometry/lib/esm/polyface/IndexedPolyfaceVisitor.js");
 /* harmony import */ var _multiclip_BuildAverageNormalsContext__WEBPACK_IMPORTED_MODULE_32__ = __webpack_require__(/*! ./multiclip/BuildAverageNormalsContext */ "../../core/geometry/lib/esm/polyface/multiclip/BuildAverageNormalsContext.js");
 /* harmony import */ var _multiclip_OffsetMeshContext__WEBPACK_IMPORTED_MODULE_33__ = __webpack_require__(/*! ./multiclip/OffsetMeshContext */ "../../core/geometry/lib/esm/polyface/multiclip/OffsetMeshContext.js");
-/* harmony import */ var _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./multiclip/SweepLineStringToFacetContext */ "../../core/geometry/lib/esm/polyface/multiclip/SweepLineStringToFacetContext.js");
+/* harmony import */ var _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(/*! ./multiclip/SweepLineStringToFacetContext */ "../../core/geometry/lib/esm/polyface/multiclip/SweepLineStringToFacetContext.js");
 /* harmony import */ var _multiclip_XYPointBuckets__WEBPACK_IMPORTED_MODULE_29__ = __webpack_require__(/*! ./multiclip/XYPointBuckets */ "../../core/geometry/lib/esm/polyface/multiclip/XYPointBuckets.js");
 /* harmony import */ var _Polyface__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./Polyface */ "../../core/geometry/lib/esm/polyface/Polyface.js");
 /* harmony import */ var _PolyfaceBuilder__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(/*! ./PolyfaceBuilder */ "../../core/geometry/lib/esm/polyface/PolyfaceBuilder.js");
@@ -235328,30 +235350,42 @@ class PolyfaceQuery {
      * construct a CurveCollection containing boundary edges.
      *   * each edge is a LineSegment3d
      * @param source polyface or visitor
-     * @param includeDanglers true to in include typical boundary edges with a single incident facet
+     * @param includeTypical true to in include typical boundary edges with a single incident facet
      * @param includeMismatch true to include edges with more than 2 incident facets
      * @param includeNull true to include edges with identical start and end vertex indices.
-     * @returns
      */
-    static boundaryEdges(source, includeDanglers = true, includeMismatch = true, includeNull = true) {
+    static boundaryEdges(source, includeTypical = true, includeMismatch = true, includeNull = true) {
         const result = new _curve_CurveCollection__WEBPACK_IMPORTED_MODULE_5__.BagOfCurves();
         const announceEdge = (pointA, pointB, _indexA, _indexB, _readIndex) => {
             result.tryAddChild(_curve_LineSegment3d__WEBPACK_IMPORTED_MODULE_11__.LineSegment3d.create(pointA, pointB));
         };
-        PolyfaceQuery.announceBoundaryEdges(source, announceEdge, includeDanglers, includeMismatch, includeNull);
+        PolyfaceQuery.announceBoundaryEdges(source, announceEdge, includeTypical, includeMismatch, includeNull);
         if (result.children.length === 0)
             return undefined;
         return result;
     }
     /**
-  * Test if the facets in `source` occur in perfectly mated pairs, as is required for a closed manifold volume.
-  * If not, extract the boundary edges as lines.
-  * @param source polyface or visitor
-  * @param announceEdge function to be called with each boundary edge. The announcement is start and end points, start and end indices, and facet index.
-  * @param includeTypical true to announce typical boundary edges with a single incident facet
-  * @param includeMismatch true to announce edges with more than 2 incident facets
-  * @param includeNull true to announce edges with identical start and end vertex indices.
-  */
+     * Collect boundary edges.
+     * * Return the edges as the simplest collection of chains of line segments.
+     * @param source facets
+     * @param includeTypical true to in include typical boundary edges with a single incident facet
+     * @param includeMismatch true to include edges with more than 2 incident facets
+     * @param includeNull true to include edges with identical start and end vertex indices.
+     */
+    static collectBoundaryEdges(source, includeTypical = true, includeMismatch = true, includeNull = true) {
+        const collector = new _curve_internalContexts_MultiChainCollector__WEBPACK_IMPORTED_MODULE_12__.MultiChainCollector(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.smallMetricDistance, _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.smallMetricDistance);
+        PolyfaceQuery.announceBoundaryEdges(source, (ptA, ptB) => collector.captureCurve(_curve_LineSegment3d__WEBPACK_IMPORTED_MODULE_11__.LineSegment3d.create(ptA, ptB)), includeTypical, includeMismatch, includeNull);
+        return collector.grabResult(true);
+    }
+    /**
+     * Test if the facets in `source` occur in perfectly mated pairs, as is required for a closed manifold volume.
+     * If not, extract the boundary edges as lines.
+     * @param source polyface or visitor
+     * @param announceEdge function to be called with each boundary edge. The announcement is start and end points, start and end indices, and facet index.
+     * @param includeTypical true to announce typical boundary edges with a single incident facet
+     * @param includeMismatch true to announce edges with more than 2 incident facets
+     * @param includeNull true to announce edges with identical start and end vertex indices.
+     */
     static announceBoundaryEdges(source, announceEdge, includeTypical = true, includeMismatch = true, includeNull = true) {
         if (source === undefined)
             return undefined;
@@ -235379,24 +235413,89 @@ class PolyfaceQuery {
         if (badList.length === 0)
             return undefined;
         const sourcePolyface = visitor.clientPolyface();
+        const pointA = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_0__.Point3d.create();
+        const pointB = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_0__.Point3d.create();
         for (const list of badList) {
             for (const e of list) {
                 const e1 = e instanceof _IndexedEdgeMatcher__WEBPACK_IMPORTED_MODULE_10__.SortableEdge ? e : e[0];
                 const indexA = e1.vertexIndexA;
                 const indexB = e1.vertexIndexB;
-                const pointA = sourcePolyface.data.getPoint(indexA);
-                const pointB = sourcePolyface.data.getPoint(indexB);
-                if (pointA && pointB)
-                    announceEdge(pointA, pointB, indexA, indexB, visitor.currentReadIndex());
+                if (sourcePolyface.data.getPoint(indexA, pointA) && sourcePolyface.data.getPoint(indexB, pointB))
+                    announceEdge(pointA, pointB, indexA, indexB, e1.facetIndex);
+            }
+        }
+    }
+    /**
+     * Invoke the callback on each manifold edge whose adjacent facet normals form vectorToEye dot products with opposite sign.
+     * * The callback is not called on boundary edges.
+     * @param source facets
+     * @param announce callback function invoked on manifold silhouette edges
+     * @param vectorToEye normal of plane in which to compute silhouette edges
+     * @param sideAngle angular tolerance for perpendicularity test
+     */
+    static announceSilhouetteEdges(source, announce, vectorToEye, sideAngle = _geometry3d_Angle__WEBPACK_IMPORTED_MODULE_1__.Angle.createSmallAngle()) {
+        if (source instanceof _Polyface__WEBPACK_IMPORTED_MODULE_6__.Polyface)
+            return this.announceSilhouetteEdges(source.createVisitor(1), announce, vectorToEye, sideAngle);
+        const mesh = source.clientPolyface();
+        if (undefined === mesh)
+            return;
+        source.setNumWrap(1);
+        const allEdges = this.createIndexedEdges(source);
+        const manifoldEdges = [];
+        allEdges.sortAndCollectClusters(manifoldEdges);
+        const sideAngleTol = sideAngle.radians < 0.0 ? -sideAngle.radians : sideAngle.radians;
+        const pointA = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_0__.Point3d.create();
+        const pointB = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_0__.Point3d.create();
+        const normal = _geometry3d_Point3dVector3d__WEBPACK_IMPORTED_MODULE_0__.Vector3d.create();
+        const analyzeFace = (iFacet) => {
+            if (!PolyfaceQuery.computeFacetUnitNormal(source, iFacet, normal))
+                return { isSideFace: false, perpAngle: 0.0 };
+            const perpAngle = normal.radiansFromPerpendicular(vectorToEye);
+            const isSideFace = Math.abs(perpAngle) <= sideAngleTol;
+            return { isSideFace, perpAngle };
+        };
+        for (const pair of manifoldEdges) {
+            if (!Array.isArray(pair) || pair.length !== 2)
+                continue;
+            const indexA = pair[0].vertexIndexA;
+            const indexB = pair[0].vertexIndexB;
+            if (!mesh.data.getPoint(indexA, pointA) || !mesh.data.getPoint(indexB, pointB))
+                continue;
+            const face0 = analyzeFace(pair[0].facetIndex);
+            if (face0.isSideFace) {
+                announce(pointA, pointB, indexA, indexB, pair[0].facetIndex);
+                continue;
+            }
+            const face1 = analyzeFace(pair[1].facetIndex);
+            if (face1.isSideFace) {
+                announce(pointB, pointA, indexB, indexA, pair[1].facetIndex);
+                continue;
+            }
+            if (face0.perpAngle * face1.perpAngle < 0.0) { // normals straddle plane
+                announce(pointA, pointB, indexA, indexB, pair[0].facetIndex);
+                continue;
             }
         }
     }
+    /**
+     * Collect manifold edges whose adjacent facet normals form vectorToEye dot products with opposite sign.
+     * * Does not return boundary edges.
+     * * Return the edges as chains of line segments.
+     * @param source facets
+     * @param vectorToEye normal of plane in which to compute silhouette edges
+     * @param sideAngle angular tolerance for perpendicularity test
+     */
+    static collectSilhouetteEdges(source, vectorToEye, sideAngle = _geometry3d_Angle__WEBPACK_IMPORTED_MODULE_1__.Angle.createSmallAngle()) {
+        const collector = new _curve_internalContexts_MultiChainCollector__WEBPACK_IMPORTED_MODULE_12__.MultiChainCollector(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.smallMetricDistance, _Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.smallMetricDistance);
+        PolyfaceQuery.announceSilhouetteEdges(source, (ptA, ptB) => collector.captureCurve(_curve_LineSegment3d__WEBPACK_IMPORTED_MODULE_11__.LineSegment3d.create(ptA, ptB)), vectorToEye, sideAngle);
+        return collector.grabResult(true);
+    }
     /** Find segments (within the linestring) which project to facets.
      * * Announce each pair of linestring segment and on-facet segment through a callback.
      * * Facets are ASSUMED to be convex and planar, and not overlap in the z direction.
      */
     static announceSweepLinestringToConvexPolyfaceXY(linestringPoints, polyface, announce) {
-        const context = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_12__.SweepLineStringToFacetContext.create(linestringPoints);
+        const context = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_13__.SweepLineStringToFacetContext.create(linestringPoints);
         if (context) {
             const visitor = polyface.createVisitor(0);
             for (visitor.reset(); visitor.moveToNextFacet();) {
@@ -235429,7 +235528,7 @@ class PolyfaceQuery {
      * @internal
      */
     static async asyncAnnounceSweepLinestringToConvexPolyfaceXY(linestringPoints, polyface, announce) {
-        const context = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_12__.SweepLineStringToFacetContext.create(linestringPoints);
+        const context = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_13__.SweepLineStringToFacetContext.create(linestringPoints);
         this.awaitBlockCount = 0;
         let workTotal = 0;
         if (context) {
@@ -235452,7 +235551,7 @@ class PolyfaceQuery {
             return this.partitionFacetIndicesByVertexConnectedComponent(polyface.createVisitor(0));
         }
         // The polyface is really a visitor !!!
-        const context = new _numerics_UnionFind__WEBPACK_IMPORTED_MODULE_13__.UnionFindContext(this.visitorClientPointCount(polyface));
+        const context = new _numerics_UnionFind__WEBPACK_IMPORTED_MODULE_14__.UnionFindContext(this.visitorClientPointCount(polyface));
         for (polyface.reset(); polyface.moveToNextFacet();) {
             const firstVertexIndexOnThisFacet = polyface.pointIndex[0];
             for (const vertexIndex of polyface.pointIndex)
@@ -235528,7 +235627,7 @@ class PolyfaceQuery {
         const partitionedIndices = this.partitionFacetIndicesByVisibilityVector(polyface, vectorToEye, sideAngleTolerance);
         if (partitionedIndices[visibilitySelect].length === 0)
             return undefined;
-        const visitor = _IndexedPolyfaceVisitor__WEBPACK_IMPORTED_MODULE_14__.IndexedPolyfaceSubsetVisitor.createSubsetVisitor(polyface, partitionedIndices[visibilitySelect], 1);
+        const visitor = _IndexedPolyfaceVisitor__WEBPACK_IMPORTED_MODULE_15__.IndexedPolyfaceSubsetVisitor.createSubsetVisitor(polyface, partitionedIndices[visibilitySelect], 1);
         return this.boundaryEdges(visitor, true, false, false);
     }
     /**
@@ -235538,7 +235637,7 @@ class PolyfaceQuery {
      * @param mesh
      */
     static announceBoundaryChainsAsLineString3d(mesh, announceLoop) {
-        const collector = new _curve_internalContexts_MultiChainCollector__WEBPACK_IMPORTED_MODULE_15__.MultiChainCollector(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.smallMetricDistance, 1000);
+        const collector = new _curve_internalContexts_MultiChainCollector__WEBPACK_IMPORTED_MODULE_12__.MultiChainCollector(_Geometry__WEBPACK_IMPORTED_MODULE_2__.Geometry.smallMetricDistance, 1000);
         PolyfaceQuery.announceBoundaryEdges(mesh, (pointA, pointB, _indexA, _indexB) => collector.captureCurve(_curve_LineSegment3d__WEBPACK_IMPORTED_MODULE_11__.LineSegment3d.create(pointA, pointB)), true, false, false);
         collector.announceChainsAsLineString3d(announceLoop);
     }
@@ -235780,7 +235879,7 @@ class PolyfaceQuery {
      * @return collection of facet index arrays, one array per connected component
      */
     static partitionFacetIndicesBySortableEdgeClusters(edgeClusters, numFacets) {
-        const context = new _numerics_UnionFind__WEBPACK_IMPORTED_MODULE_13__.UnionFindContext(numFacets);
+        const context = new _numerics_UnionFind__WEBPACK_IMPORTED_MODULE_14__.UnionFindContext(numFacets);
         for (const cluster of edgeClusters) {
             if (cluster instanceof _IndexedEdgeMatcher__WEBPACK_IMPORTED_MODULE_10__.SortableEdge) {
                 // this edge does not connect anywhere.  Ignore it!!
@@ -235871,7 +235970,7 @@ class PolyfaceQuery {
         let chainContext;
         if (options.assembleChains)
             chainContext = _topology_ChainMerge__WEBPACK_IMPORTED_MODULE_25__.ChainMergeContext.create();
-        const context = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_12__.ClipSweptLineStringContext.create(linestringPoints, options.vectorToEye);
+        const context = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_13__.ClipSweptLineStringContext.create(linestringPoints, options.vectorToEye);
         if (context) {
             let visitor;
             if (polyfaceOrVisitor instanceof _Polyface__WEBPACK_IMPORTED_MODULE_6__.Polyface)
@@ -235929,7 +236028,7 @@ class PolyfaceQuery {
         for (let i = 1; i < lineStringSource.length; i++) {
             const point0 = lineStringSource.getPoint3dAtUncheckedPointIndex(i - 1);
             const point1 = lineStringSource.getPoint3dAtUncheckedPointIndex(i);
-            const edgeClipper = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_12__.EdgeClipData.createPointPointSweep(point0, point1, sweepVector);
+            const edgeClipper = _multiclip_SweepLineStringToFacetContext__WEBPACK_IMPORTED_MODULE_13__.EdgeClipData.createPointPointSweep(point0, point1, sweepVector);
             if (edgeClipper !== undefined) {
                 _geometry3d_Range__WEBPACK_IMPORTED_MODULE_26__.Range3d.createNull(searchRange);
                 searchRange.extendPoint(point0);
@@ -289494,7 +289593,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.3.0-dev.16","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.3.0-dev.16","@itwin/core-bentley":"workspace:^4.3.0-dev.16","@itwin/core-common":"workspace:^4.3.0-dev.16","@itwin/core-geometry":"workspace:^4.3.0-dev.16","@itwin/core-orbitgt":"workspace:^4.3.0-dev.16","@itwin/core-quantity":"workspace:^4.3.0-dev.16"},"//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.3.10","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","typemoq":"^2.1.0","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/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"}}');
+module.exports = JSON.parse('{"name":"@itwin/core-frontend","version":"4.3.0-dev.18","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.3.0-dev.18","@itwin/core-bentley":"workspace:^4.3.0-dev.18","@itwin/core-common":"workspace:^4.3.0-dev.18","@itwin/core-geometry":"workspace:^4.3.0-dev.18","@itwin/core-orbitgt":"workspace:^4.3.0-dev.18","@itwin/core-quantity":"workspace:^4.3.0-dev.18"},"//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.3.10","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","typemoq":"^2.1.0","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/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"}}');
 
 /***/ })