@itwin/core-geometry 4.10.0-dev.8 → 5.0.0-dev.0

package/lib/cjs/core-geometry.js

@@ -190,9 +190,9 @@ __exportStar(require("./numerics/ClusterableArray"), exports);
 __exportStar(require("./numerics/Complex"), exports);
 __exportStar(require("./numerics/ConvexPolygon2d"), exports);
 __exportStar(require("./numerics/PascalCoefficients"), exports);
-__exportStar(require("./numerics/Polynomials"), exports);
 __exportStar(require("./numerics/Quadrature"), exports);
 __exportStar(require("./numerics/Range1dArray"), exports);
+__exportStar(require("./numerics/SmallSystem"), exports);
 __exportStar(require("./numerics/TriDiagonalSystem"), exports);
 __exportStar(require("./curve/Arc3d"), exports);
 __exportStar(require("./curve/ConstructCurveBetweenCurves"), exports);

package/lib/cjs/core-geometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"core-geometry.js","sourceRoot":"","sources":["../../src/core-geometry.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Utility\r\n */\r\n\r\n// REMARK:\r\n// The docs-group-description comments are followed by empty classes with names corresponding to the doc-group.\r\n// Normally (in committed code) these are commented out.\r\n// The comments have distinctive strings so that simple search and replace can make the \"real\".\r\n// This is useful when working on the documentation:  When the empty classes are present, VSCode will format the doc comments\r\n// for and display them when the mouse hovers over the class name.\r\n\r\n/**\r\n * @docs-package-description\r\n * The core-geometry package contains classes for working with geometry:  points, vectors, curves, surfaces, and analytic solids\r\n */\r\n/**\r\n * @docs-group-description CartesianGeometry\r\n * Points, Vectors, Planes, and Transformations for x,y,z geometry.\r\n * * Fundamental cartesian geometry objects:\r\n *   * Point2d, Point3d -- points with x,y,z coordinates\r\n *   * Vector2d, Vector3d -- vectors with x,y,z coordinates\r\n *   * Matrix3d -- 3x3 matrix\r\n *   * * commonly used for pure rotations\r\n *   * * scale and skew entries are also allowed.\r\n *   * Transform -- an origin and axes.\r\n *   * Range1d, Range2d, Range3d -- subsets of 1d, 2d, and 3d space bounded by low and high values.\r\n *   * Ray3d -- a ray defined by origin and direction vector\r\n *   * Plane3d -- an abstract base class extended by Plane3dByOriginAndNormal, Plane3dByOriginAndUnitNormal, Point4d, and ClipPlane\r\n *   * Plane3dByOriginAndUnitNormal -- a plane defined by an origin and a single vector which is perpendicular to the plane\r\n *   * plane3dByOriginAndVectors -- a plane defined by an origin and two vectors in the plane.\r\n * * Angles\r\n *   * Angle -- a strongly typed angle object whose method names make it clear whether input and outputs are degrees or radians.\r\n *   * AngleSweep -- an angular interval\r\n *   * LatitudeLongitudeNumber -- carrier for position and altitude on sphere or ellipsoid\r\n *   * YawPitchAndRollAngles -- 3 angles that define a rotated coordinate system.\r\n * * Utility classes\r\n *   * FrameBuilder -- construction of coordinate frames from mixed data sources.\r\n *   * ClipPlane -- a single plane\r\n *   * ConvexClipPlaneSet -- an array of planes bounding a convex volume\r\n *   * ClipPlaneSet -- an array of ConvexClipPlaneSet, defining the union of their volumes\r\n *   * BilinearPatch -- twisted quadrilateral defined by 4 points\r\n *   * BarycentricTriangle -- triangle defined by 3 points.\r\n *   * Constant -- various numeric values exported as readonly constants\r\n */\r\n// doc:export class CartesianGeometryDoc { }\r\n/**\r\n * @docs-group-description ArraysAndInterfaces\r\n * These classes support array operations and inheritance-based algorithms.\r\n * * Arrays\r\n *   * GrowableArray -- A carrier for a Float64Array, with methods that hide reallocation of the underlying array as contents are added.\r\n *   * Point2dArray, Point3dArray, Point4dArray, Vector3dArray -- miscellaneous operations on arrays of 2d and 3d points.\r\n * * Interfaces\r\n *   * GeometryHandler -- a double-dispatch protocol used for efficient implementation of algorithms that work on many geometry types.\r\n *\r\n */\r\n// doc:export class ArraysAndInterfacesDoc { }\r\n\r\n/**\r\n * @docs-group-description Bspline\r\n * A bspline curve or surface is used for curved freeform geometry defined by controls points (sometimes called poles).\r\n * * BSplineCurve --  a curve defined by control points (which are not on the curve)\r\n * * InterpolationCurve -- a curve defined by passthrough points, with \"good\" visual properties\r\n * * BSplineSurfaceXYZ -- a surface with XYZ\r\n * * BsplineSurfaceXYZW -- a surface with weighted (rational) XYZ coordinates\r\n * * KnotVector -- vector of breakpoints in bspline definitions.\r\n */\r\n// doc:export class BsplineDoc { }\r\n\r\n/**\r\n * @docs-group-description Curve\r\n * Curves in the GeometryQuery hierarchy: LineSegment3d, LineString3d, Arc3d, TransitionSpiral3d\r\n * * CurvePrimitive -- base class for parametric curves\r\n *   * LineSegment3d -- a (bounded) portion of an unbounded line\r\n *   * Arc3d -- a circular or elliptic arc\r\n *   * LineString3d -- a sequence of points joined by line segments\r\n *   * TransitionSpiral -- controlled transition between curvatures\r\n * * Support classes\r\n * * PointString3d -- a sequence of isolated points\r\n * * StrokeOptions -- tolerances to describe stroking accuracy\r\n * * RecursiveCurveProcessor, RecursiveCurveProcessorWithStack -- algorithmic support for trees with CurvePrimitives at the leaf level.\r\n */\r\n// doc:export class CurveDoc { }\r\n/**\r\n * @docs-group-description Numerics\r\n * The Numerics classes have geometric and numeric methods used during large algorithms in other classes.\r\n */\r\n// doc:export class NumericsDoc { }\r\n/**\r\n * @docs-group-description Polyface\r\n * A Polyface is a mesh structure with arrays of points that are shared among multiple incident facets.\r\n */\r\n// doc:export class PolyfaceDoc { }\r\n/**\r\n * @docs-group-description Serialization\r\n * These classes are related to serialization of geometry classes.\r\n * * IModelJson.Reader, IModelJson.Writer -- Conversion of in-memory geometry objects to json objects for persistence and transmission.\r\n */\r\n// doc:export class SerializationDoc { }\r\n/**\r\n * @docs-group-description Solid\r\n * Analytic Solids in the GeometryQuery hierarchy: Box, Sphere, Cone, TorusPipe, LinearSweep, RotationalSweep, RuledSweep\r\n * * Box -- a box solid.  This is usually rectangular on all faces, but can in one directly like a view frustum\r\n * * Sphere -- a sphere\r\n * * Cone -- a cone or cylinder\r\n * * TorusPipe -- a pipe elbow\r\n * * LinearSweep -- a linear sweep of a base contour\r\n * * RotationalSweep -- a rotational sweep of a base contour\r\n * * RuledSweep -- two or more similarly structured contours joined by linear rule lines.\r\n */\r\n// doc:export class SolidDOc { }\r\n/**\r\n * @docs-group-description Topology\r\n * The Topology classes provide adjacency structures used in triangulations.\r\n */\r\n// doc:export class TopologyDoc { }\r\n/**\r\n * @docs-group-description RangeSearch\r\n * Support classes for searching collections of ranges.\r\n */\r\nexport * from \"./geometry3d/Angle\";\r\nexport * from \"./geometry3d/AngleSweep\";\r\nexport * from \"./geometry3d/LongitudeLatitudeAltitude\";\r\nexport * from \"./geometry3d/BarycentricTriangle\";\r\nexport * from \"./geometry3d/BilinearPatch\";\r\nexport * from \"./geometry3d/Ellipsoid\";\r\nexport * from \"./geometry3d/FrameBuilder\";\r\nexport * from \"./geometry3d/FrustumAnimation\";\r\nexport * from \"./geometry3d/GeometryHandler\";\r\nexport * from \"./geometry3d/GrowableBlockedArray\";\r\nexport * from \"./geometry3d/GrowableFloat64Array\";\r\nexport * from \"./geometry3d/GrowableXYArray\";\r\nexport * from \"./geometry3d/GrowableXYZArray\";\r\nexport * from \"./geometry3d/IndexedCollectionInterval\";\r\nexport * from \"./geometry3d/IndexedXYCollection\";\r\nexport * from \"./geometry3d/IndexedXYZCollection\";\r\nexport * from \"./geometry3d/Matrix3d\";\r\nexport * from \"./geometry3d/OrderedRotationAngles\";\r\nexport * from \"./geometry3d/Plane3d\";\r\nexport * from \"./geometry3d/Plane3dByOriginAndUnitNormal\";\r\nexport * from \"./geometry3d/Plane3dByOriginAndVectors\";\r\nexport * from \"./geometry3d/Point2dArrayCarrier\";\r\nexport * from \"./geometry3d/Point2dVector2d\";\r\nexport * from \"./geometry3d/Point3dVector3d\";\r\nexport * from \"./geometry3d/PointHelpers\";\r\nexport * from \"./geometry3d/Point3dArrayCarrier\";\r\nexport * from \"./geometry3d/PolylineOps\";\r\nexport * from \"./geometry3d/PolygonOps\";\r\nexport * from \"./geometry3d/Range\";\r\nexport * from \"./geometry3d/Ray2d\";\r\nexport * from \"./geometry3d/Ray3d\";\r\nexport * from \"./geometry3d/Segment1d\";\r\nexport * from \"./geometry3d/Transform\";\r\nexport * from \"./geometry3d/UVSurfaceOps\";\r\nexport * from \"./geometry3d/XYZProps\";\r\nexport * from \"./geometry3d/YawPitchRollAngles\";\r\n\r\nexport * from \"./Geometry\";\r\nexport * from \"./Constant\";\r\nexport * from \"./clipping/BooleanClipFactory\";\r\nexport * from \"./clipping/ClipPlane\";\r\nexport * from \"./clipping/ConvexClipPlaneSet\";\r\nexport * from \"./clipping/UnionOfConvexClipPlaneSets\";\r\nexport * from \"./clipping/ClipPrimitive\";\r\nexport * from \"./clipping/ClipVector\";\r\nexport * from \"./clipping/ClipUtils\";\r\nexport * from \"./numerics/ConvexPolygon2d\";\r\nexport * from \"./geometry4d/PlaneByOriginAndVectors4d\";\r\nexport * from \"./geometry4d/Point4d\";\r\nexport * from \"./geometry4d/Matrix4d\";\r\nexport * from \"./geometry4d/Map4d\";\r\nexport * from \"./geometry4d/MomentData\";\r\nexport * from \"./numerics/BezierPolynomials\";\r\nexport * from \"./numerics/ClusterableArray\";\r\nexport * from \"./numerics/Complex\";\r\nexport * from \"./numerics/ConvexPolygon2d\";\r\nexport * from \"./numerics/PascalCoefficients\";\r\nexport * from \"./numerics/Polynomials\";\r\nexport * from \"./numerics/Quadrature\";\r\nexport * from \"./numerics/Range1dArray\";\r\nexport * from \"./numerics/TriDiagonalSystem\";\r\n\r\nexport * from \"./curve/Arc3d\";\r\nexport * from \"./curve/ConstructCurveBetweenCurves\";\r\nexport * from \"./curve/CoordinateXYZ\";\r\nexport * from \"./curve/CurveTypes\";\r\nexport * from \"./curve/CurveChainWithDistanceIndex\";\r\nexport * from \"./curve/CurveExtendMode\";\r\nexport * from \"./curve/CurveCollection\";\r\nexport * from \"./curve/CurveCurve\";\r\nexport * from \"./curve/CurveLocationDetail\";\r\nexport * from \"./curve/CurveFactory\";\r\nexport * from \"./curve/CurveOps\";\r\nexport * from \"./curve/CurvePrimitive\";\r\nexport * from \"./curve/CurveProcessor\";\r\nexport * from \"./curve/GeometryQuery\";\r\nexport * from \"./curve/LineSegment3d\";\r\nexport * from \"./curve/LineString3d\";\r\nexport * from \"./curve/Loop\";\r\nexport * from \"./curve/OffsetOptions\";\r\nexport * from \"./curve/ParityRegion\";\r\nexport * from \"./curve/Path\";\r\nexport * from \"./curve/RegionMomentsXY\";\r\nexport * from \"./curve/RegionOps\";\r\nexport * from \"./curve/PointString3d\";\r\nexport * from \"./curve/ProxyCurve\";\r\nexport * from \"./curve/StrokeOptions\";\r\nexport * from \"./curve/spiral/TransitionSpiral3d\";\r\nexport * from \"./curve/spiral/IntegratedSpiral3d\";\r\nexport * from \"./curve/spiral/DirectSpiral3d\";\r\nexport * from \"./curve/UnionRegion\";\r\nexport * from \"./curve/Query/StrokeCountMap\";\r\nexport * from \"./solid/Box\";\r\nexport * from \"./solid/Cone\";\r\nexport * from \"./solid/LinearSweep\";\r\nexport * from \"./solid/RotationalSweep\";\r\nexport * from \"./solid/RuledSweep\";\r\nexport * from \"./solid/SolidPrimitive\";\r\nexport * from \"./solid/Sphere\";\r\nexport * from \"./solid/SweepContour\";\r\nexport * from \"./solid/TorusPipe\";\r\nexport * from \"./bspline/AkimaCurve3d\";\r\nexport * from \"./bspline/Bezier1dNd\";\r\nexport * from \"./bspline/BezierCurveBase\";\r\nexport * from \"./bspline/BezierCurve3d\";\r\nexport * from \"./bspline/BezierCurve3dH\";\r\nexport * from \"./bspline/BSplineCurve\";\r\nexport * from \"./bspline/BSplineCurveOps\";\r\nexport * from \"./bspline/BSpline1dNd\";\r\nexport * from \"./bspline/BSplineCurve3dH\";\r\nexport * from \"./bspline/BSplineSurface\";\r\nexport * from \"./bspline/InterpolationCurve3d\";\r\nexport * from \"./bspline/KnotVector\";\r\nexport * from \"./polyface/AuxData\";\r\nexport * from \"./polyface/BoxTopology\";\r\nexport * from \"./polyface/FacetFaceData\";\r\nexport * from \"./polyface/Polyface\";\r\nexport * from \"./polyface/FacetLocationDetail\";\r\nexport * from \"./polyface/IndexedPolyfaceVisitor\";\r\nexport * from \"./polyface/multiclip/GriddedRaggedRange2dSet\";\r\nexport * from \"./polyface/multiclip/GriddedRaggedRange2dSetWithOverflow\";\r\nexport * from \"./polyface/PolyfaceBuilder\";\r\nexport * from \"./polyface/PolyfaceData\";\r\nexport * from \"./polyface/PolyfaceQuery\";\r\nexport * from \"./polyface/PolyfaceClip\";\r\nexport * from \"./polyface/RangeTree/Point3dArrayRangeTreeContext\";\r\nexport * from \"./polyface/RangeTree/LineString3dRangeTreeContext\";\r\nexport * from \"./polyface/RangeTree/PolyfaceRangeTreeContext\";\r\nexport * from \"./polyface/TaggedNumericData\";\r\nexport * from \"./topology/SpaceTriangulation\";\r\nexport * from \"./serialization/IModelJsonSchema\";\r\nexport * from \"./serialization/DeepCompare\";\r\nexport * from \"./serialization/GeometrySamples\";\r\nexport * from \"./serialization/SerializationHelpers\";\r\nexport { BentleyGeometryFlatBuffer } from \"./serialization/BentleyGeometryFlatBuffer\";\r\n"]}
+{"version":3,"file":"core-geometry.js","sourceRoot":"","sources":["../../src/core-geometry.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Utility\r\n */\r\n\r\n// REMARK:\r\n// The docs-group-description comments are followed by empty classes with names corresponding to the doc-group.\r\n// Normally (in committed code) these are commented out.\r\n// The comments have distinctive strings so that simple search and replace can make the \"real\".\r\n// This is useful when working on the documentation:  When the empty classes are present, VSCode will format the doc comments\r\n// for and display them when the mouse hovers over the class name.\r\n\r\n/**\r\n * @docs-package-description\r\n * The core-geometry package contains classes for working with geometry:  points, vectors, curves, surfaces, and analytic solids\r\n */\r\n/**\r\n * @docs-group-description CartesianGeometry\r\n * Points, Vectors, Planes, and Transformations for x,y,z geometry.\r\n * * Fundamental cartesian geometry objects:\r\n *   * Point2d, Point3d -- points with x,y,z coordinates\r\n *   * Vector2d, Vector3d -- vectors with x,y,z coordinates\r\n *   * Matrix3d -- 3x3 matrix\r\n *   * * commonly used for pure rotations\r\n *   * * scale and skew entries are also allowed.\r\n *   * Transform -- an origin and axes.\r\n *   * Range1d, Range2d, Range3d -- subsets of 1d, 2d, and 3d space bounded by low and high values.\r\n *   * Ray3d -- a ray defined by origin and direction vector\r\n *   * Plane3d -- an abstract base class extended by Plane3dByOriginAndNormal, Plane3dByOriginAndUnitNormal, Point4d, and ClipPlane\r\n *   * Plane3dByOriginAndUnitNormal -- a plane defined by an origin and a single vector which is perpendicular to the plane\r\n *   * plane3dByOriginAndVectors -- a plane defined by an origin and two vectors in the plane.\r\n * * Angles\r\n *   * Angle -- a strongly typed angle object whose method names make it clear whether input and outputs are degrees or radians.\r\n *   * AngleSweep -- an angular interval\r\n *   * LatitudeLongitudeNumber -- carrier for position and altitude on sphere or ellipsoid\r\n *   * YawPitchAndRollAngles -- 3 angles that define a rotated coordinate system.\r\n * * Utility classes\r\n *   * FrameBuilder -- construction of coordinate frames from mixed data sources.\r\n *   * ClipPlane -- a single plane\r\n *   * ConvexClipPlaneSet -- an array of planes bounding a convex volume\r\n *   * ClipPlaneSet -- an array of ConvexClipPlaneSet, defining the union of their volumes\r\n *   * BilinearPatch -- twisted quadrilateral defined by 4 points\r\n *   * BarycentricTriangle -- triangle defined by 3 points.\r\n *   * Constant -- various numeric values exported as readonly constants\r\n */\r\n// doc:export class CartesianGeometryDoc { }\r\n/**\r\n * @docs-group-description ArraysAndInterfaces\r\n * These classes support array operations and inheritance-based algorithms.\r\n * * Arrays\r\n *   * GrowableArray -- A carrier for a Float64Array, with methods that hide reallocation of the underlying array as contents are added.\r\n *   * Point2dArray, Point3dArray, Point4dArray, Vector3dArray -- miscellaneous operations on arrays of 2d and 3d points.\r\n * * Interfaces\r\n *   * GeometryHandler -- a double-dispatch protocol used for efficient implementation of algorithms that work on many geometry types.\r\n *\r\n */\r\n// doc:export class ArraysAndInterfacesDoc { }\r\n\r\n/**\r\n * @docs-group-description Bspline\r\n * A bspline curve or surface is used for curved freeform geometry defined by controls points (sometimes called poles).\r\n * * BSplineCurve --  a curve defined by control points (which are not on the curve)\r\n * * InterpolationCurve -- a curve defined by passthrough points, with \"good\" visual properties\r\n * * BSplineSurfaceXYZ -- a surface with XYZ\r\n * * BsplineSurfaceXYZW -- a surface with weighted (rational) XYZ coordinates\r\n * * KnotVector -- vector of breakpoints in bspline definitions.\r\n */\r\n// doc:export class BsplineDoc { }\r\n\r\n/**\r\n * @docs-group-description Curve\r\n * Curves in the GeometryQuery hierarchy: LineSegment3d, LineString3d, Arc3d, TransitionSpiral3d\r\n * * CurvePrimitive -- base class for parametric curves\r\n *   * LineSegment3d -- a (bounded) portion of an unbounded line\r\n *   * Arc3d -- a circular or elliptic arc\r\n *   * LineString3d -- a sequence of points joined by line segments\r\n *   * TransitionSpiral -- controlled transition between curvatures\r\n * * Support classes\r\n * * PointString3d -- a sequence of isolated points\r\n * * StrokeOptions -- tolerances to describe stroking accuracy\r\n * * RecursiveCurveProcessor, RecursiveCurveProcessorWithStack -- algorithmic support for trees with CurvePrimitives at the leaf level.\r\n */\r\n// doc:export class CurveDoc { }\r\n/**\r\n * @docs-group-description Numerics\r\n * The Numerics classes have geometric and numeric methods used during large algorithms in other classes.\r\n */\r\n// doc:export class NumericsDoc { }\r\n/**\r\n * @docs-group-description Polyface\r\n * A Polyface is a mesh structure with arrays of points that are shared among multiple incident facets.\r\n */\r\n// doc:export class PolyfaceDoc { }\r\n/**\r\n * @docs-group-description Serialization\r\n * These classes are related to serialization of geometry classes.\r\n * * IModelJson.Reader, IModelJson.Writer -- Conversion of in-memory geometry objects to json objects for persistence and transmission.\r\n */\r\n// doc:export class SerializationDoc { }\r\n/**\r\n * @docs-group-description Solid\r\n * Analytic Solids in the GeometryQuery hierarchy: Box, Sphere, Cone, TorusPipe, LinearSweep, RotationalSweep, RuledSweep\r\n * * Box -- a box solid.  This is usually rectangular on all faces, but can in one directly like a view frustum\r\n * * Sphere -- a sphere\r\n * * Cone -- a cone or cylinder\r\n * * TorusPipe -- a pipe elbow\r\n * * LinearSweep -- a linear sweep of a base contour\r\n * * RotationalSweep -- a rotational sweep of a base contour\r\n * * RuledSweep -- two or more similarly structured contours joined by linear rule lines.\r\n */\r\n// doc:export class SolidDOc { }\r\n/**\r\n * @docs-group-description Topology\r\n * The Topology classes provide adjacency structures used in triangulations.\r\n */\r\n// doc:export class TopologyDoc { }\r\n/**\r\n * @docs-group-description RangeSearch\r\n * Support classes for searching collections of ranges.\r\n */\r\nexport * from \"./geometry3d/Angle\";\r\nexport * from \"./geometry3d/AngleSweep\";\r\nexport * from \"./geometry3d/LongitudeLatitudeAltitude\";\r\nexport * from \"./geometry3d/BarycentricTriangle\";\r\nexport * from \"./geometry3d/BilinearPatch\";\r\nexport * from \"./geometry3d/Ellipsoid\";\r\nexport * from \"./geometry3d/FrameBuilder\";\r\nexport * from \"./geometry3d/FrustumAnimation\";\r\nexport * from \"./geometry3d/GeometryHandler\";\r\nexport * from \"./geometry3d/GrowableBlockedArray\";\r\nexport * from \"./geometry3d/GrowableFloat64Array\";\r\nexport * from \"./geometry3d/GrowableXYArray\";\r\nexport * from \"./geometry3d/GrowableXYZArray\";\r\nexport * from \"./geometry3d/IndexedCollectionInterval\";\r\nexport * from \"./geometry3d/IndexedXYCollection\";\r\nexport * from \"./geometry3d/IndexedXYZCollection\";\r\nexport * from \"./geometry3d/Matrix3d\";\r\nexport * from \"./geometry3d/OrderedRotationAngles\";\r\nexport * from \"./geometry3d/Plane3d\";\r\nexport * from \"./geometry3d/Plane3dByOriginAndUnitNormal\";\r\nexport * from \"./geometry3d/Plane3dByOriginAndVectors\";\r\nexport * from \"./geometry3d/Point2dArrayCarrier\";\r\nexport * from \"./geometry3d/Point2dVector2d\";\r\nexport * from \"./geometry3d/Point3dVector3d\";\r\nexport * from \"./geometry3d/PointHelpers\";\r\nexport * from \"./geometry3d/Point3dArrayCarrier\";\r\nexport * from \"./geometry3d/PolylineOps\";\r\nexport * from \"./geometry3d/PolygonOps\";\r\nexport * from \"./geometry3d/Range\";\r\nexport * from \"./geometry3d/Ray2d\";\r\nexport * from \"./geometry3d/Ray3d\";\r\nexport * from \"./geometry3d/Segment1d\";\r\nexport * from \"./geometry3d/Transform\";\r\nexport * from \"./geometry3d/UVSurfaceOps\";\r\nexport * from \"./geometry3d/XYZProps\";\r\nexport * from \"./geometry3d/YawPitchRollAngles\";\r\n\r\nexport * from \"./Geometry\";\r\nexport * from \"./Constant\";\r\nexport * from \"./clipping/BooleanClipFactory\";\r\nexport * from \"./clipping/ClipPlane\";\r\nexport * from \"./clipping/ConvexClipPlaneSet\";\r\nexport * from \"./clipping/UnionOfConvexClipPlaneSets\";\r\nexport * from \"./clipping/ClipPrimitive\";\r\nexport * from \"./clipping/ClipVector\";\r\nexport * from \"./clipping/ClipUtils\";\r\nexport * from \"./numerics/ConvexPolygon2d\";\r\nexport * from \"./geometry4d/PlaneByOriginAndVectors4d\";\r\nexport * from \"./geometry4d/Point4d\";\r\nexport * from \"./geometry4d/Matrix4d\";\r\nexport * from \"./geometry4d/Map4d\";\r\nexport * from \"./geometry4d/MomentData\";\r\nexport * from \"./numerics/BezierPolynomials\";\r\nexport * from \"./numerics/ClusterableArray\";\r\nexport * from \"./numerics/Complex\";\r\nexport * from \"./numerics/ConvexPolygon2d\";\r\nexport * from \"./numerics/PascalCoefficients\";\r\nexport * from \"./numerics/Quadrature\";\r\nexport * from \"./numerics/Range1dArray\";\r\nexport * from \"./numerics/SmallSystem\";\r\nexport * from \"./numerics/TriDiagonalSystem\";\r\n\r\nexport * from \"./curve/Arc3d\";\r\nexport * from \"./curve/ConstructCurveBetweenCurves\";\r\nexport * from \"./curve/CoordinateXYZ\";\r\nexport * from \"./curve/CurveTypes\";\r\nexport * from \"./curve/CurveChainWithDistanceIndex\";\r\nexport * from \"./curve/CurveExtendMode\";\r\nexport * from \"./curve/CurveCollection\";\r\nexport * from \"./curve/CurveCurve\";\r\nexport * from \"./curve/CurveLocationDetail\";\r\nexport * from \"./curve/CurveFactory\";\r\nexport * from \"./curve/CurveOps\";\r\nexport * from \"./curve/CurvePrimitive\";\r\nexport * from \"./curve/CurveProcessor\";\r\nexport * from \"./curve/GeometryQuery\";\r\nexport * from \"./curve/LineSegment3d\";\r\nexport * from \"./curve/LineString3d\";\r\nexport * from \"./curve/Loop\";\r\nexport * from \"./curve/OffsetOptions\";\r\nexport * from \"./curve/ParityRegion\";\r\nexport * from \"./curve/Path\";\r\nexport * from \"./curve/RegionMomentsXY\";\r\nexport * from \"./curve/RegionOps\";\r\nexport * from \"./curve/PointString3d\";\r\nexport * from \"./curve/ProxyCurve\";\r\nexport * from \"./curve/StrokeOptions\";\r\nexport * from \"./curve/spiral/TransitionSpiral3d\";\r\nexport * from \"./curve/spiral/IntegratedSpiral3d\";\r\nexport * from \"./curve/spiral/DirectSpiral3d\";\r\nexport * from \"./curve/UnionRegion\";\r\nexport * from \"./curve/Query/StrokeCountMap\";\r\nexport * from \"./solid/Box\";\r\nexport * from \"./solid/Cone\";\r\nexport * from \"./solid/LinearSweep\";\r\nexport * from \"./solid/RotationalSweep\";\r\nexport * from \"./solid/RuledSweep\";\r\nexport * from \"./solid/SolidPrimitive\";\r\nexport * from \"./solid/Sphere\";\r\nexport * from \"./solid/SweepContour\";\r\nexport * from \"./solid/TorusPipe\";\r\nexport * from \"./bspline/AkimaCurve3d\";\r\nexport * from \"./bspline/Bezier1dNd\";\r\nexport * from \"./bspline/BezierCurveBase\";\r\nexport * from \"./bspline/BezierCurve3d\";\r\nexport * from \"./bspline/BezierCurve3dH\";\r\nexport * from \"./bspline/BSplineCurve\";\r\nexport * from \"./bspline/BSplineCurveOps\";\r\nexport * from \"./bspline/BSpline1dNd\";\r\nexport * from \"./bspline/BSplineCurve3dH\";\r\nexport * from \"./bspline/BSplineSurface\";\r\nexport * from \"./bspline/InterpolationCurve3d\";\r\nexport * from \"./bspline/KnotVector\";\r\nexport * from \"./polyface/AuxData\";\r\nexport * from \"./polyface/BoxTopology\";\r\nexport * from \"./polyface/FacetFaceData\";\r\nexport * from \"./polyface/Polyface\";\r\nexport * from \"./polyface/FacetLocationDetail\";\r\nexport * from \"./polyface/IndexedPolyfaceVisitor\";\r\nexport * from \"./polyface/multiclip/GriddedRaggedRange2dSet\";\r\nexport * from \"./polyface/multiclip/GriddedRaggedRange2dSetWithOverflow\";\r\nexport * from \"./polyface/PolyfaceBuilder\";\r\nexport * from \"./polyface/PolyfaceData\";\r\nexport * from \"./polyface/PolyfaceQuery\";\r\nexport * from \"./polyface/PolyfaceClip\";\r\nexport * from \"./polyface/RangeTree/Point3dArrayRangeTreeContext\";\r\nexport * from \"./polyface/RangeTree/LineString3dRangeTreeContext\";\r\nexport * from \"./polyface/RangeTree/PolyfaceRangeTreeContext\";\r\nexport * from \"./polyface/TaggedNumericData\";\r\nexport * from \"./topology/SpaceTriangulation\";\r\nexport * from \"./serialization/IModelJsonSchema\";\r\nexport * from \"./serialization/DeepCompare\";\r\nexport * from \"./serialization/GeometrySamples\";\r\nexport * from \"./serialization/SerializationHelpers\";\r\nexport { BentleyGeometryFlatBuffer } from \"./serialization/BentleyGeometryFlatBuffer\";\r\n"]}

package/lib/cjs/curve/Arc3d.d.ts

@@ -47,13 +47,13 @@ export interface ArcVectors {
  * @public
  */
 export interface ArcBlendData {
-    /** Constructed arc */
+    /** Constructed arc. */
     arc?: Arc3d;
-    /** Fraction "moving backward" on the inbound curve */
+    /** Fraction "moving backward" on the inbound curve. */
     fraction10: number;
-    /** Fraction "moving forward" on the outbound curve */
+    /** Fraction "moving forward" on the outbound curve. */
     fraction12: number;
-    /** Optional reference point */
+    /** Optional reference point. */
     point?: Point3d;
 }
 /**
@@ -154,7 +154,7 @@ export declare class EllipticalArcApproximationOptions {
  * @public
  */
 export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
-    /** String name for schema properties */
+    /** String name for schema properties. */
     readonly curvePrimitiveType = "arc";
     /** Test if this and other are both instances of Arc3d. */
     isSameGeometryClass(other: GeometryQuery): boolean;
@@ -167,118 +167,129 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
     private static _workVectorU;
     private static _workVectorV;
     private static _workVectorW;
-    /** Read property for (clone of) center */
+    /** Read property for (clone of) center. */
     get center(): Point3d;
-    /** Read property for (clone of) vector0 */
+    /** Read property for (clone of) vector0. */
     get vector0(): Vector3d;
-    /** Read property for (clone of) vector90 */
+    /** Read property for (clone of) vector90. */
     get vector90(): Vector3d;
     /** Read property for (clone of) plane normal, with arbitrary length. */
     get perpendicularVector(): Vector3d;
-    /** Read property for (clone of) matrix of vector0, vector90, unit normal */
+    /** Read property for (clone of) matrix of vector0, vector90, unit normal. */
     matrixClone(): Matrix3d;
-    /** Read property for (reference to) matrix of vector0, vector90, unit normal */
+    /** Read property for (reference to) matrix of vector0, vector90, unit normal. */
     get matrixRef(): Matrix3d;
     /** Sweep of the angle. */
     get sweep(): AngleSweep;
     set sweep(value: AngleSweep);
-    /** An Arc3d extends along its complete elliptic arc */
+    /** An Arc3d extends along its complete elliptic arc. */
     get isExtensibleFractionSpace(): boolean;
     private constructor();
     /**
-     * Return a clone of the arc, with transform applied
+     * Return a clone of the arc, with transform applied.
      * @param transform
      */
     cloneTransformed(transform: Transform): Arc3d;
     /**
      * Redefine the arc with (captured references to) given data.
-     * @param center arc center
-     * @param matrix matrix with columns vector0, vector 90, and their unit cross product
-     * @param sweep angle sweep
+     * @param center arc center.
+     * @param matrix matrix with columns vector0, vector 90, and their unit cross product.
+     * @param sweep angle sweep.
      */
     setRefs(center: Point3d, matrix: Matrix3d, sweep: AngleSweep): void;
     /**
      * Redefine the arc with (clones of) given data.
-     * @param center arc center
-     * @param matrix matrix with columns vector0, vector 90, and their unit cross product
-     * @param sweep angle sweep
+     * @param center arc center.
+     * @param matrix matrix with columns vector0, vector 90, and their unit cross product.
+     * @param sweep angle sweep.
      */
     set(center: Point3d, matrix: Matrix3d, sweep: AngleSweep | undefined): void;
-    /** Copy center, matrix, and sweep from other Arc3d */
+    /** Copy center, matrix, and sweep from other Arc3d. */
     setFrom(other: Arc3d): void;
     /** Return a clone of this arc. */
     clone(): Arc3d;
     /**
      * Create an arc, capturing references to center, matrix and sweep.
-     * @param center center point
-     * @param matrix matrix with columns vector0, vector90, and unit cross product
-     * @param sweep sweep limits
+     * @param center center point.
+     * @param matrix matrix with columns vector0, vector90, and unit cross product.
+     * @param sweep sweep limits.
      * @param result optional preallocated result.
      */
     static createRefs(center: Point3d, matrix: Matrix3d, sweep: AngleSweep, result?: Arc3d): Arc3d;
     /**
      * Create an arc from center, x column to be scaled, and y column to be scaled.
-     * @param center center of ellipse
-     * @param matrix matrix whose x and y columns are unit vectors to be scaled by radius0 and radius90
+     * @param center center of ellipse.
+     * @param matrix matrix whose x and y columns are scaled by radius0 and radius90.
      * @param radius0 radius in x direction.
      * @param radius90 radius in y direction.
-     * @param sweep sweep limits
+     * @param sweep sweep limits.
      * @param result optional preallocated result.
      */
     static createScaledXYColumns(center: Point3d | undefined, matrix: Matrix3d, radius0: number, radius90: number, sweep?: AngleSweep, result?: Arc3d): Arc3d;
     /**
-     * Create a (full circular) arc from center, normal and radius
-     * @param center center of ellipse.  If undefined, center at 000
-     * @param normal normal vector
+     * Create a (full circular) arc from center, normal and radius.
+     * @param center center of ellipse. If undefined, center at 000.
+     * @param normal normal vector.
      * @param radius radius in x direction.
      * @param result optional preallocated result.
      */
     static createCenterNormalRadius(center: Point3d | undefined, normal: Vector3d, radius: number, result?: Arc3d): Arc3d;
     /**
      * Create an arc by center with vectors to points at 0 and 90 degrees in parameter space.
-     * @param center arc center
-     * @param vector0 vector to 0 degrees (commonly major axis)
-     * @param vector90 vector to 90 degree point (commonly minor axis)
-     * @param sweep sweep limits (default full sweep)
-     * @param result optional preallocated result
+     * @param center arc center.
+     * @param vector0 vector to 0 degrees (commonly major axis).
+     * @param vector90 vector to 90 degree point (commonly minor axis).
+     * @param sweep sweep limits; defaults to full sweep.
+     * @param result optional preallocated result.
      */
     static create(center: Point3d | undefined, vector0: Vector3d, vector90: Vector3d, sweep?: AngleSweep, result?: Arc3d): Arc3d;
     /**
      * Create an elliptical arc from three points on the ellipse: two points on an axis and one in between.
-     * @param point0 start of arc, on an axis
-     * @param point1 point on arc somewhere between `point0` and `point2`
-     * @param point2 point on arc directly opposite `point0`
-     * @param sweep angular sweep, measured from `point0` in the direction of `point1`.
-     *  For a half-ellipse from `point0` to `point2` passing through `point1`, pass `AngleSweep.createStartEndDegrees(0,180)`.
+     * @param start start of arc, on an axis.
+     * @param middle point on arc somewhere between `start` and `end`.
+     * @param end point on arc directly opposite `start`.
+     * @param sweep angular sweep, measured from `start` in the direction of `middle`.
+     *  For a half-ellipse from `start` to `end` passing through `middle`, pass `AngleSweep.createStartEndDegrees(0,180)`.
      *  Default value is full sweep to create the entire ellipse.
-     * @param result optional preallocated result
+     * @param result optional preallocated result.
      * @returns elliptical arc, or undefined if construction impossible.
      */
-    static createStartMiddleEnd(point0: XYAndZ, point1: XYAndZ, point2: XYAndZ, sweep?: AngleSweep, result?: Arc3d): Arc3d | undefined;
+    static createStartMiddleEnd(start: XYAndZ, middle: XYAndZ, end: XYAndZ, sweep?: AngleSweep, result?: Arc3d): Arc3d | undefined;
     /**
      * Create a circular arc defined by start point, tangent at start point, and end point.
-     * If tangent is parallel to line segment from start to end, return the line segment.
+     * * The circular arc is swept from `start` to `end` in the direction of `tangentAtStart`.
+     * * If `tangentAtStart` is parallel to the line segment from `start` to `end`, return the line segment.
      */
     static createCircularStartTangentEnd(start: Point3d, tangentAtStart: Vector3d, end: Point3d, result?: Arc3d): Arc3d | LineSegment3d;
+    /**
+     * Create a circular arc from start point, tangent at start, radius, optional plane normal, arc sweep.
+     * * The vector from start point to center is in the direction of upVector crossed with tangentA.
+     * @param start start point.
+     * @param tangentAtStart vector in tangent direction at the start.
+     * @param radius signed radius.
+     * @param upVector optional out-of-plane vector. Defaults to positive Z.
+     * @param sweep angular range. If single `Angle` is given, start angle is at 0 degrees (the start point).
+     */
+    static createCircularStartTangentRadius(start: Point3d, tangentAtStart: Vector3d, radius: number, upVector?: Vector3d, sweep?: Angle | AngleSweep): Arc3d | undefined;
     /**
      * Create a circular arc defined by start and end points and radius.
-     * @param start start point of the arc
-     * @param end end point of the arc
-     * @param helper a third point near the arc in its plane, or a vector in the direction of the arc normal
-     * @returns the constructed arc, or undefined if desired arc cannot be constructed
+     * @param start start point of the arc.
+     * @param end end point of the arc.
+     * @param helper a third point near the arc in its plane, or a vector in the direction of the arc normal.
+     * @returns the constructed arc, or undefined if desired arc cannot be constructed.
      */
     static createCircularStartEndRadius(start: Point3d, end: Point3d, radius: number, helper: Point3d | Vector3d): Arc3d | undefined;
     /**
      * Return a clone of this arc, projected to given z value.
      * * If `z` is omitted, the clone is at the z of the center.
      * * This function projects the arc into a plane parallel to xy-plane.
-     * * Note that projection to fixed z can change circle into ellipse (and (rarely) ellipse to circle)
+     * * Note that projection to fixed z can change circle into ellipse (and (rarely) ellipse to circle).
      */
     cloneAtZ(z?: number): Arc3d;
     /**
      * Create an arc by center (cx,cy,xz) with vectors (ux,uy,uz) and (vx,vy,vz) to points at 0 and 90 degrees in
      * parameter space.
-     * @param result optional preallocated result
+     * @param result optional preallocated result.
      */
     static createXYZXYZXYZ(cx: number, cy: number, cz: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number, sweep?: AngleSweep, result?: Arc3d): Arc3d;
     /**
@@ -296,66 +307,66 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
     /** The arc has simple proportional arc length if and only if it is a circular arc. */
     getFractionToDistanceScale(): number | undefined;
     /**
-     * Convert a fractional position to xyz coordinates
-     * @param fraction fractional position on arc
-     * @param result optional preallocated result
+     * Convert a fractional position to xyz coordinates.
+     * @param fraction fractional position on arc.
+     * @param result optional preallocated result.
      */
     fractionToPoint(fraction: number, result?: Point3d): Point3d;
     /**
-     * Convert fractional arc and radial positions to xyz coordinates
-     * @param fraction fractional position on arc
-     * @param result optional preallocated result
+     * Convert fractional arc and radial positions to xyz coordinates.
+     * @param fraction fractional position on arc.
+     * @param result optional preallocated result.
      */
     fractionAndRadialFractionToPoint(arcFraction: number, radialFraction: number, result?: Point3d): Point3d;
     /**
      * Convert a fractional position to xyz coordinates and derivative with respect to fraction.
-     * @param fraction fractional position on arc
-     * @param result optional preallocated result
+     * @param fraction fractional position on arc.
+     * @param result optional preallocated result.
      */
     fractionToPointAndDerivative(fraction: number, result?: Ray3d): Ray3d;
     /**
      * Construct a plane with
-     * * origin at the fractional position along the arc
-     * * x axis is the first derivative, i.e. tangent along the arc
+     * * origin at the fractional position along the arc.
+     * * x axis is the first derivative, i.e. tangent along the arc.
      * * y axis is the second derivative, i.e. in the plane and on the center side of the tangent.
-     * If the arc is circular, the second derivative is directly towards the center
+     * If the arc is circular, the second derivative is directly towards the center.
      */
     fractionToPointAnd2Derivatives(fraction: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
     /**
-     * Evaluate the point and derivative with respect to the angle (in radians)
-     * @param radians angular position
+     * Evaluate the point and derivative with respect to the angle (in radians).
+     * @param radians angular position.
      * @param result optional preallocated ray.
      */
     radiansToPointAndDerivative(radians: number, result?: Ray3d): Ray3d;
     /**
-     * Evaluate the point with respect to the angle (in radians)
-     * @param radians angular position
+     * Evaluate the point with respect to the angle (in radians).
+     * @param radians angular position.
      * @param result optional preallocated ray.
      */
     radiansToPoint(radians: number, result?: Point3d): Point3d;
     /**
      * Return a parametric plane with
-     * * origin at arc center
-     * * vectorU from center to arc at angle (in radians)
+     * * origin at arc center.
+     * * vectorU from center to arc at angle (in radians).
      * * vectorV from center to arc at 90 degrees past the angle.
-     * @param radians angular position
-     * @param result optional preallocated plane
+     * @param radians angular position.
+     * @param result optional preallocated plane.
      */
     radiansToRotatedBasis(radians: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
     /**
-     * Evaluate the point and derivative with respect to the angle (in radians)
-     * @param theta angular position
+     * Evaluate the point and derivative with respect to the angle (in radians).
+     * @param theta angular position.
      * @param result optional preallocated ray.
      */
     angleToPointAndDerivative(theta: Angle, result?: Ray3d): Ray3d;
     /**
      * Return the start point of the arc.
-     * @param result optional preallocated result
+     * @param result optional preallocated result.
      */
     startPoint(result?: Point3d): Point3d;
     /**
      * Return the end point of the arc.
-     * @param result optional preallocated result
+     * @param result optional preallocated result.
      */
     endPoint(result?: Point3d): Point3d;
     /** * If this is a circular arc, return the simple length derived from radius and sweep.
@@ -363,9 +374,9 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
      *     Uses quadrature.
      */
     curveLength(): number;
-    /** Gauss point quadrature count for evaluating curve length. (The number of intervals is adjusted to the arc sweep) */
+    /** Gauss point quadrature count for evaluating curve length. (The number of intervals is adjusted to the arc sweep). */
     static readonly quadratureGuassCount = 5;
-    /** In quadrature for arc length, use this interval (divided by quickEccentricity) */
+    /** In quadrature for arc length, use this interval (divided by quickEccentricity). */
     static readonly quadratureIntervalAngleDegrees = 10;
     /**
      * * If this is a circular arc, return the simple length derived from radius and sweep.
@@ -383,14 +394,14 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
      */
     quickLength(): number;
     /**
-     * * See extended comments on `CurvePrimitive.moveSignedDistanceFromFraction`
-     * * A zero length line generates `CurveSearchStatus.error`
-     * * Nonzero length line generates `CurveSearchStatus.success` or `CurveSearchStatus.stoppedAtBoundary`
+     * * See extended comments on `CurvePrimitive.moveSignedDistanceFromFraction`.
+     * * A zero length line generates `CurveSearchStatus.error`.
+     * * Nonzero length line generates `CurveSearchStatus.success` or `CurveSearchStatus.stoppedAtBoundary`.
      */
     moveSignedDistanceFromFraction(startFraction: number, signedDistance: number, allowExtension: false, result?: CurveLocationDetail): CurveLocationDetail;
     /**
      * Return all radian angles where the ellipse tangent is perpendicular to the vector to a spacePoint.
-     * @param spacePoint point of origin of vectors to the ellipse
+     * @param spacePoint point of origin of vectors to the ellipse.
      * @param _extend always true. Sweep is ignored: perpendiculars for the full ellipse are returned.
      * @param endpoints if true, force the end radians into the result.
      */
@@ -408,25 +419,22 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
     /**
      * Apply a transform to the arc basis vectors.
      * * nonuniform (i.e. skewing) transforms are allowed.
-     * * The transformed vector0 and vector90 are NOT squared up as major minor axes.  (This is a good feature!!)
+     * * The transformed vector0 and vector90 are NOT squared up as major minor axes (this is a good feature).
      */
     tryTransformInPlace(transform: Transform): boolean;
-    /**
-     * Return true if the ellipse center and basis vectors are in the plane
-     * @param plane
-     */
+    /** Return true if the ellipse center and basis vectors are in the plane. */
     isInPlane(plane: Plane3dByOriginAndUnitNormal): boolean;
     /** Return true if the vector0 and vector90 are of equal length and perpendicular. */
     get isCircular(): boolean;
     /** Return radius if the vector0 and vector90 are of equal length and perpendicular. */
     circularRadiusXY(): number | undefined;
-    /** If the arc is circular, return its radius. Otherwise return undefined */
+    /** If the arc is circular, return its radius. Otherwise return undefined. */
     circularRadius(): number | undefined;
-    /** Return the larger of the two defining vectors. */
+    /** Return the larger length of the two defining vectors. */
     maxVectorLength(): number;
     /**
      * Compute intersections with a plane.
-     * @param plane plane to intersect
+     * @param plane plane to intersect.
      * @param result array of locations on the curve.
      */
     appendPlaneIntersectionPoints(plane: PlaneAltitudeEvaluator, result: CurveLocationDetail[]): number;
@@ -443,13 +451,13 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
      */
     extendRangeInSweep(range: Range3d, sweep: AngleSweep, transform?: Transform): void;
     /**
-     * Returns a (high accuracy) range of the curve between fractional positions
-     * * Default implementation returns teh range of the curve from clonePartialCurve
+     * Returns a (high accuracy) range of the curve between fractional positions.
+     * * Default implementation returns teh range of the curve from clonePartialCurve.
      */
     rangeBetweenFractions(fraction0: number, fraction1: number, transform?: Transform): Range3d;
     /**
      * Set up a SineCosinePolynomial as the function c+u*cos(theta)+v*sin(theta) where
-     *  c,u,v are coefficients obtained by evaluating altitude and velocity relative to the plane.
+     * c,u,v are coefficients obtained by evaluating altitude and velocity relative to the plane.
      * @param plane plane for altitude calculation.
      * @param result optional result.
      * @internal
@@ -459,26 +467,26 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
     static createUnitCircle(): Arc3d;
     /**
      * Create a new arc which is parallel to the xy plane, with given center and radius and optional angle sweep.
-     * @param center center of arc
-     * @param radius radius of arc
-     * @param sweep sweep limits.  defaults to full circle.
+     * @param center center of arc.
+     * @param radius radius of arc.
+     * @param sweep sweep limits; defaults to full circle.
      */
     static createXY(center: Point3d, radius: number, sweep?: AngleSweep): Arc3d;
     /**
      * Create a new arc which is parallel to the xy plane, with given center and x,y radii, and optional angle sweep
-     * @param center center of ellipse
-     * @param radiusA x axis radius
-     * @param radiusB y axis radius
-     * @param sweep angle sweep
+     * @param center center of ellipse.
+     * @param radiusA x axis radius.
+     * @param radiusB y axis radius.
+     * @param sweep angle sweep.
      */
     static createXYEllipse(center: Point3d, radiusA: number, radiusB: number, sweep?: AngleSweep): Arc3d;
     /**
      * Replace the arc's 0 and 90 degree vectors.
-     * @param vector0 vector from center to ellipse point at 0 degrees in parameter space
-     * @param vector90 vector from center to ellipse point at 90 degrees in parameter space
+     * @param vector0 vector from center to ellipse point at 0 degrees in parameter space.
+     * @param vector90 vector from center to ellipse point at 90 degrees in parameter space.
      */
     setVector0Vector90(vector0: Vector3d, vector90: Vector3d): void;
-    /** Return the arc definition with rigid matrix form with axis radii */
+    /** Return the arc definition with rigid matrix form with axis radii. */
     toScaledMatrix3d(): {
         center: Point3d;
         axes: Matrix3d;
@@ -486,7 +494,7 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
         r90: number;
         sweep: AngleSweep;
     };
-    /** Return the arc definition with center, two vectors, and angle sweep; */
+    /** Return the arc definition with center, two vectors, and angle sweep. */
     toVectors(): ArcVectors;
     /** Return the arc definition with center, two vectors, and angle sweep, optionally transformed. */
     toTransformedVectors(transform?: Transform): {
@@ -504,9 +512,9 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
     };
     /**
      * Set this arc from a json object with these values:
-     * * center center point
-     * * vector0 vector from center to 0 degree point in parameter space (commonly but not always the major axis vector)
-     * * vector90 vector from center to 90 degree point in parameter space (commonly but not always the minor axis vector)
+     * * center center point.
+     * * vector0 vector from center to 0 degree point in parameter space (commonly but not always the major axis vector).
+     * * vector90 vector from center to 90 degree point in parameter space (commonly but not always the minor axis vector).
      * @param json
      */
     setFromJSON(json?: any): void;
@@ -515,39 +523,39 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
      * @return {*} [center:  [], vector0:[], vector90:[], sweep []}
      */
     toJSON(): any;
-    /** Test if this arc is almost equal to another GeometryQuery object */
-    isAlmostEqual(otherGeometry: GeometryQuery): boolean;
-    /** Emit strokes to caller-supplied linestring */
+    /** Test if this arc is almost equal to another GeometryQuery object. */
+    isAlmostEqual(otherGeometry: GeometryQuery, distanceTol?: number, radianTol?: number): boolean;
+    /** Emit strokes to caller-supplied linestring. */
     emitStrokes(dest: LineString3d, options?: StrokeOptions): void;
-    /** Emit strokes to caller-supplied handler */
+    /** Emit strokes to caller-supplied handler. */
     emitStrokableParts(handler: IStrokeHandler, options?: StrokeOptions): void;
     /**
      * Return the stroke count required for given options.
-     * @param options StrokeOptions that determine count
+     * @param options StrokeOptions that determine count.
      */
     computeStrokeCountForOptions(options?: StrokeOptions): number;
-    /** Second step of double dispatch:  call `handler.handleArc3d(this)` */
+    /** Second step of double dispatch: call `handler.handleArc3d(this)` */
     dispatchToGeometryHandler(handler: GeometryHandler): any;
     /**
      * Return (if possible) an arc which is a portion of this curve.
-     * @param fractionA [in] start fraction
-     * @param fractionB [in] end fraction
+     * @param fractionA start fraction.
+     * @param fractionB end fraction.
      */
     clonePartialCurve(fractionA: number, fractionB: number): Arc3d;
     /**
      * Return an arc whose basis vectors are rotated by given angle within the current basis space.
-     * * the result arc will have its zero-degree point (new `vector0`) at the current
-     * `vector0 * cos(theta) + vector90 * sin(theta)`
+     * * the result arc will have its zero-degree point (new `vector0`) at the current.
+     * `vector0 * cos(theta) + vector90 * sin(theta)`.
      * * the result sweep is adjusted so all fractional coordinates (e.g. start and end) evaluate to the same xyz.
      *   * Specifically, theta is subtracted from the original start and end angles.
      * @param theta the angle (in the input arc space) which is to become the 0-degree point in the new arc.
      */
     cloneInRotatedBasis(theta: Angle): Arc3d;
     /**
-     * Find intervals of this CurvePrimitive that are interior to a clipper
-     * @param clipper clip structure (e.g.clip planes)
-     * @param announce(optional) function to be called announcing fractional intervals"
-     * ` announce(fraction0, fraction1, curvePrimitive)`
+     * Find intervals of this CurvePrimitive that are interior to a clipper.
+     * @param clipper clip structure (e.g.clip planes).
+     * @param announce (optional) function to be called announcing fractional intervals
+     * `announce(fraction0, fraction1, curvePrimitive)`.
      * @returns true if any "in" segments are announced.
      */
     announceClipIntervals(clipper: Clipper, announce?: AnnounceNumberNumberCurvePrimitive): boolean;
@@ -557,42 +565,42 @@ export declare class Arc3d extends CurvePrimitive implements BeJSONFunctions {
      * Determine an arc "at a point of inflection" of a point sequence.
      * * Return the arc along with the fractional positions of the tangency points.
      * * In the returned object:
-     *   * `arc` is the (bounded) arc
+     *   * `arc` is the (bounded) arc.
      *   * `fraction10` is the tangency point's position as an interpolating fraction of the line segment from
-     * `point1` (backwards) to `point0`
+     * `point1` (backwards) to `point0`.
      *   * `fraction12` is the tangency point's position as an interpolating fraction of the line segment from
-     * `point1` (forward) to `point2`
+     * `point1` (forward) to `point2`.
      *   * `point` is the `point1` input.
      * * If unable to construct the arc:
      *   * `point` is the `point1` input.
-     *   * both fractions are zero
+     *   * both fractions are zero.
      *   * `arc` is undefined.
-     * @param point0 first point of path. (the point before the point of inflection)
-     * @param point1 second point of path (the point of inflection)
-     * @param point2 third point of path (the point after the point of inflection)
-     * @param radius arc radius
+     * @param point0 first point of path (the point before the point of inflection).
+     * @param point1 second point of path (the point of inflection).
+     * @param point2 third point of path (the point after the point of inflection).
+     * @param radius arc radius.
      *
      */
     static createFilletArc(point0: Point3d, point1: Point3d, point2: Point3d, radius: number): ArcBlendData;
-    /** Scale the vector0 and vector90 vectors by `scaleFactor` */
+    /** Scale the vector0 and vector90 vectors by `scaleFactor`. */
     scaleAboutCenterInPlace(scaleFactor: number): void;
-    /** Return the (signed!) area between (a fractional portion of) the arc and the chord between those points */
+    /** Return the (signed!) area between (a fractional portion of) the arc and the chord between those points. */
     areaToChordXY(fraction0: number, fraction1: number): number;
     /**
      * Construct an offset of the instance curve as viewed in the xy-plane (ignoring z).
-     * @param offsetDistanceOrOptions offset distance (positive to left of the instance curve), or options object
+     * @param offsetDistanceOrOptions offset distance (positive to left of the instance curve), or options object.
      */
     constructOffsetXY(offsetDistanceOrOptions: number | OffsetOptions): CurvePrimitive | CurvePrimitive[] | undefined;
     /**
      * Project instance geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of projection.
      * @param ray ray onto which the instance is projected. A `Vector3d` is treated as a `Ray3d` with zero origin.
-     * @param lowHigh optional receiver for output
+     * @param lowHigh optional receiver for output.
      * @returns range of fractional projection parameters onto the ray, where 0.0 is start of the ray and 1.0 is the end of the ray.
      */
     projectedParameterRange(ray: Vector3d | Ray3d, lowHigh?: Range1d): Range1d | undefined;
     /**
      * Construct a circular arc chain approximation to the instance elliptical arc.
-     * @param options bundle of options for sampling an elliptical arc (use default options if undefined)
+     * @param options bundle of options for sampling an elliptical arc (use default options if undefined).
      * @returns the approximating curve chain, the circular instance, or undefined if construction fails.
      */
     constructCircularArcChainApproximation(options?: EllipticalArcApproximationOptions): CurveChain | Arc3d | undefined;