@itwin/core-geometry 4.1.0-dev.68 → 4.1.0-dev.69

package/lib/cjs/curve/internalContexts/PlaneAltitudeRangeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaneAltitudeRangeContext.js","sourceRoot":"","sources":["../../../../src/curve/internalContexts/PlaneAltitudeRangeContext.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 Curve\r\n */\r\n\r\nimport { BSplineCurve3d } from \"../../bspline/BSplineCurve\";\r\nimport { BSplineCurve3dH } from \"../../bspline/BSplineCurve3dH\";\r\nimport { Geometry, PlaneAltitudeEvaluator } from \"../../Geometry\";\r\nimport { Angle } from \"../../geometry3d/Angle\";\r\nimport { RecurseToCurvesGeometryHandler } from \"../../geometry3d/GeometryHandler\";\r\nimport { GrowableXYZArray } from \"../../geometry3d/GrowableXYZArray\";\r\nimport { Plane3dByOriginAndUnitNormal } from \"../../geometry3d/Plane3dByOriginAndUnitNormal\";\r\nimport { Point3d, Vector3d } from \"../../geometry3d/Point3dVector3d\";\r\nimport { Range1d } from \"../../geometry3d/Range\";\r\nimport { Ray3d } from \"../../geometry3d/Ray3d\";\r\nimport { SineCosinePolynomial } from \"../../numerics/Polynomials\";\r\nimport { Arc3d } from \"../Arc3d\";\r\nimport { GeometryQuery } from \"../GeometryQuery\";\r\nimport { LineSegment3d } from \"../LineSegment3d\";\r\nimport { LineString3d } from \"../LineString3d\";\r\nimport { StrokeOptions } from \"../StrokeOptions\";\r\n\r\n/**\r\n * Accumulator context for searching for extrema of geometry along a plane.\r\n * @internal\r\n */\r\nexport class PlaneAltitudeRangeContext extends RecurseToCurvesGeometryHandler {\r\n  public plane: PlaneAltitudeEvaluator;\r\n  public range: Range1d;\r\n  public lowPoint: Point3d | undefined;\r\n  public highPoint: Point3d | undefined;\r\n  private constructor(plane: PlaneAltitudeEvaluator) {\r\n    super();\r\n    this.plane = plane;\r\n    this.range = Range1d.createNull();\r\n    this.resetRange();\r\n  }\r\n\r\n  public resetRange() {\r\n    this.range.setNull();\r\n  }\r\n\r\n  public announcePoint(point: Point3d) {\r\n    const h = this.plane.altitude(point);\r\n    if (this.range.extendLow(h))\r\n      this.lowPoint = point.clone(this.lowPoint);\r\n    if (this.range.extendHigh(h))\r\n      this.highPoint = point.clone(this.highPoint);\r\n  }\r\n\r\n  public announcePoints(points: GrowableXYZArray) {\r\n    for (let i = 0; i < points.length; i++) {\r\n      const h = points.evaluateUncheckedIndexPlaneAltitude(i, this.plane);\r\n      if (this.range.extendLow(h))\r\n        this.lowPoint = points.getPoint3dAtUncheckedPointIndex(i, this.lowPoint);\r\n      if (this.range.extendHigh(h))\r\n        this.highPoint = points.getPoint3dAtUncheckedPointIndex(i, this.highPoint);\r\n    }\r\n  }\r\n\r\n  public static createCapture(plane: PlaneAltitudeEvaluator): PlaneAltitudeRangeContext {\r\n    const context = new PlaneAltitudeRangeContext(plane);\r\n    return context;\r\n  }\r\n\r\n  public override handleLineSegment3d(segment: LineSegment3d) {\r\n    this.announcePoint(segment.point0Ref);\r\n    this.announcePoint(segment.point1Ref);\r\n  }\r\n\r\n  public override handleLineString3d(lineString: LineString3d) {\r\n    this.announcePoints(lineString.packedPoints);\r\n  }\r\n\r\n  private _strokeOptions?: StrokeOptions;\r\n\r\n  private initStrokeOptions() {\r\n    // TODO: compute the exact extrema; until then stroke aggressively\r\n    if (undefined === this._strokeOptions) {\r\n      this._strokeOptions = new StrokeOptions();\r\n      this._strokeOptions.angleTol = Angle.createDegrees(1);\r\n    }\r\n  }\r\n\r\n  public override handleBSplineCurve3d(bcurve: BSplineCurve3d) {\r\n    // ugh.   The point MUST be on the curve -- usual excess-range of poles is not ok.\r\n    this.initStrokeOptions();\r\n    const ls = LineString3d.create();\r\n    bcurve.emitStrokes(ls, this._strokeOptions);\r\n    this.handleLineString3d(ls);\r\n  }\r\n\r\n  public override handleBSplineCurve3dH(bcurve: BSplineCurve3dH) {\r\n    // ugh.   The point MUST be on the curve -- usual excess-range of poles is not ok.\r\n    this.initStrokeOptions();\r\n    const ls = LineString3d.create();\r\n    bcurve.emitStrokes(ls, this._strokeOptions);\r\n    this.handleLineString3d(ls);\r\n  }\r\n\r\n  private _sineCosinePolynomial?: SineCosinePolynomial;\r\n\r\n  private _workPoint?: Point3d;\r\n\r\n  public override handleArc3d(g: Arc3d) {\r\n    this._sineCosinePolynomial = g.getPlaneAltitudeSineCosinePolynomial(this.plane, this._sineCosinePolynomial);\r\n    let radians = this._sineCosinePolynomial.referenceMinMaxRadians();\r\n    if (g.sweep.isRadiansInSweep(radians))\r\n      this.announcePoint((this._workPoint = g.radiansToPoint(radians, this._workPoint)));\r\n    radians += Math.PI;\r\n    if (g.sweep.isRadiansInSweep(radians))\r\n      this.announcePoint((this._workPoint = g.radiansToPoint(radians, this._workPoint)));\r\n    this.announcePoint((this._workPoint = g.startPoint(this._workPoint)));\r\n    this.announcePoint((this._workPoint = g.endPoint(this._workPoint)));\r\n  }\r\n\r\n  private static findExtremesInDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d\r\n  ): PlaneAltitudeRangeContext | undefined {\r\n    const origin = direction instanceof Ray3d ? direction.origin : Point3d.createZero();\r\n    const vector = direction instanceof Ray3d ? direction.direction : direction;\r\n    const plane = Plane3dByOriginAndUnitNormal.create(origin, vector);  // vector is normalized, so altitudes are distances\r\n    if (plane) {\r\n      const context = new PlaneAltitudeRangeContext(plane);\r\n      if (geometry instanceof GeometryQuery) {\r\n        geometry.dispatchToGeometryHandler(context);\r\n      } else if (geometry instanceof GrowableXYZArray) {\r\n        context.announcePoints(geometry);\r\n      } else {\r\n        for (const pt of geometry)\r\n          context.announcePoint(pt);\r\n      }\r\n      return context;\r\n    }\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Compute altitudes for the geometry (via dispatch) over the plane defined by the given direction, and\r\n   * return points at min and max altitude, packed into a `LineSegment3d`.\r\n   * @param geometry geometry to project\r\n   * @param direction vector or ray on which to project the instance. A `Vector3d` is treated as a `Ray3d` with\r\n   * zero origin.\r\n   * @param lowHigh optional receiver for output\r\n  */\r\n  public static findExtremePointsInDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d, lowHigh?: LineSegment3d\r\n  ): LineSegment3d | undefined {\r\n    const context = this.findExtremesInDirection(geometry, direction);\r\n    if (context && context.highPoint && context.lowPoint)\r\n      return LineSegment3d.create(context.lowPoint, context.highPoint, lowHigh);\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Compute altitudes for the geometry (via dispatch) over the plane defined by the given direction, and return\r\n   * the min and max altitudes, packed into a Range1d.\r\n   * @param geometry geometry to project\r\n   * @param direction vector or ray on which to project the instance. A `Vector3d` is treated as a `Ray3d` with\r\n   * zero origin.\r\n   * @param lowHigh optional receiver for output\r\n  */\r\n  public static findExtremeAltitudesInDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d, lowHigh?: Range1d\r\n  ): Range1d | undefined {\r\n    const context = this.findExtremesInDirection(geometry, direction);\r\n    if (context && !context.range.isNull)\r\n      return Range1d.createFrom(context.range, lowHigh);\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Project geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of projection.\r\n   * @param geometry geometry to project\r\n   * @param direction vector or ray onto which the instance is projected. A `Vector3d` is treated as a `Ray3d` with\r\n   * zero origin.\r\n   * @param lowHigh optional receiver for output\r\n   */\r\n  public static findExtremeFractionsAlongDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d, lowHigh?: Range1d\r\n  ): Range1d | undefined {\r\n    const range = this.findExtremeAltitudesInDirection(geometry, direction, lowHigh);\r\n    if (undefined !== range) {\r\n      const mag = (direction instanceof Vector3d) ? direction.magnitude() : direction.direction.magnitude();\r\n      const scaleToFraction = Geometry.conditionalDivideCoordinate(1.0, mag);\r\n      if (undefined !== scaleToFraction) {\r\n        range.low *= scaleToFraction;\r\n        range.high *= scaleToFraction;\r\n        return range;\r\n      }\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"PlaneAltitudeRangeContext.js","sourceRoot":"","sources":["../../../../src/curve/internalContexts/PlaneAltitudeRangeContext.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAQ/F,6CAAkE;AAClE,kDAA+C;AAC/C,sEAAkF;AAClF,wEAAqE;AACrE,gGAA6F;AAC7F,sEAAqE;AACrE,kDAAiD;AACjD,kDAA+C;AAG/C,oDAAiD;AACjD,oDAAiD;AACjD,kDAA+C;AAC/C,oDAAiD;AAEjD;;;GAGG;AACH,MAAa,yBAA0B,SAAQ,gDAA8B;IAK3E,YAAoB,KAA6B;QAC/C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,eAAO,CAAC,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAEM,aAAa,CAAC,KAAc;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAEM,cAAc,CAAC,MAAwB;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,CAAC,GAAG,MAAM,CAAC,mCAAmC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;gBACzB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3E,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;SAC9E;IACH,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,KAA6B;QACvD,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEe,mBAAmB,CAAC,OAAsB;QACxD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAEe,kBAAkB,CAAC,UAAwB;QACzD,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;IAIO,iBAAiB;QACvB,kEAAkE;QAClE,IAAI,SAAS,KAAK,IAAI,CAAC,cAAc,EAAE;YACrC,IAAI,CAAC,cAAc,GAAG,IAAI,6BAAa,EAAE,CAAC;YAC1C,IAAI,CAAC,cAAc,CAAC,QAAQ,GAAG,aAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACvD;IACH,CAAC;IAEe,oBAAoB,CAAC,MAAsB;QACzD,kFAAkF;QAClF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,2BAAY,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAEe,qBAAqB,CAAC,MAAuB;QAC3D,kFAAkF;QAClF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,2BAAY,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAMe,WAAW,CAAC,CAAQ;QAClC,IAAI,CAAC,qBAAqB,GAAG,CAAC,CAAC,oCAAoC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC5G,IAAI,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,CAAC;QAClE,IAAI,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrF,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAEO,MAAM,CAAC,uBAAuB,CACpC,QAAsD,EAAE,SAA2B;QAEnF,MAAM,MAAM,GAAG,SAAS,YAAY,aAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,yBAAO,CAAC,UAAU,EAAE,CAAC;QACpF,MAAM,MAAM,GAAG,SAAS,YAAY,aAAK,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,MAAM,KAAK,GAAG,2DAA4B,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAE,mDAAmD;QACvH,IAAI,KAAK,EAAE;YACT,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC,KAAK,CAAC,CAAC;YACrD,IAAI,QAAQ,YAAY,6BAAa,EAAE;gBACrC,QAAQ,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;aAC7C;iBAAM,IAAI,QAAQ,YAAY,mCAAgB,EAAE;gBAC/C,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;aAClC;iBAAM;gBACL,KAAK,MAAM,EAAE,IAAI,QAAQ;oBACvB,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;aAC7B;YACD,OAAO,OAAO,CAAC;SAChB;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;;;;;;MAOE;IACK,MAAM,CAAC,4BAA4B,CACxC,QAAsD,EAAE,SAA2B,EAAE,OAAuB;QAE5G,MAAM,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAClE,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ;YAClD,OAAO,6BAAa,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;MAOE;IACK,MAAM,CAAC,+BAA+B,CAC3C,QAAsD,EAAE,SAA2B,EAAE,OAAiB;QAEtG,MAAM,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAClE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM;YAClC,OAAO,eAAO,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,kCAAkC,CAC9C,QAAsD,EAAE,SAA2B,EAAE,OAAiB;QAEtG,MAAM,KAAK,GAAG,IAAI,CAAC,+BAA+B,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACjF,IAAI,SAAS,KAAK,KAAK,EAAE;YACvB,MAAM,GAAG,GAAG,CAAC,SAAS,YAAY,0BAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YACtG,MAAM,eAAe,GAAG,mBAAQ,CAAC,2BAA2B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACvE,IAAI,SAAS,KAAK,eAAe,EAAE;gBACjC,KAAK,CAAC,GAAG,IAAI,eAAe,CAAC;gBAC7B,KAAK,CAAC,IAAI,IAAI,eAAe,CAAC;gBAC9B,OAAO,KAAK,CAAC;aACd;SACF;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAtKD,8DAsKC","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 Curve\r\n */\r\n\r\nimport { BSplineCurve3d } from \"../../bspline/BSplineCurve\";\r\nimport { BSplineCurve3dH } from \"../../bspline/BSplineCurve3dH\";\r\nimport { Geometry, PlaneAltitudeEvaluator } from \"../../Geometry\";\r\nimport { Angle } from \"../../geometry3d/Angle\";\r\nimport { RecurseToCurvesGeometryHandler } from \"../../geometry3d/GeometryHandler\";\r\nimport { GrowableXYZArray } from \"../../geometry3d/GrowableXYZArray\";\r\nimport { Plane3dByOriginAndUnitNormal } from \"../../geometry3d/Plane3dByOriginAndUnitNormal\";\r\nimport { Point3d, Vector3d } from \"../../geometry3d/Point3dVector3d\";\r\nimport { Range1d } from \"../../geometry3d/Range\";\r\nimport { Ray3d } from \"../../geometry3d/Ray3d\";\r\nimport { SineCosinePolynomial } from \"../../numerics/Polynomials\";\r\nimport { Arc3d } from \"../Arc3d\";\r\nimport { GeometryQuery } from \"../GeometryQuery\";\r\nimport { LineSegment3d } from \"../LineSegment3d\";\r\nimport { LineString3d } from \"../LineString3d\";\r\nimport { StrokeOptions } from \"../StrokeOptions\";\r\n\r\n/**\r\n * Accumulator context for searching for extrema of geometry along a plane.\r\n * @internal\r\n */\r\nexport class PlaneAltitudeRangeContext extends RecurseToCurvesGeometryHandler {\r\n  public plane: PlaneAltitudeEvaluator;\r\n  public range: Range1d;\r\n  public lowPoint: Point3d | undefined;\r\n  public highPoint: Point3d | undefined;\r\n  private constructor(plane: PlaneAltitudeEvaluator) {\r\n    super();\r\n    this.plane = plane;\r\n    this.range = Range1d.createNull();\r\n    this.resetRange();\r\n  }\r\n\r\n  public resetRange() {\r\n    this.range.setNull();\r\n  }\r\n\r\n  public announcePoint(point: Point3d) {\r\n    const h = this.plane.altitude(point);\r\n    if (this.range.extendLow(h))\r\n      this.lowPoint = point.clone(this.lowPoint);\r\n    if (this.range.extendHigh(h))\r\n      this.highPoint = point.clone(this.highPoint);\r\n  }\r\n\r\n  public announcePoints(points: GrowableXYZArray) {\r\n    for (let i = 0; i < points.length; i++) {\r\n      const h = points.evaluateUncheckedIndexPlaneAltitude(i, this.plane);\r\n      if (this.range.extendLow(h))\r\n        this.lowPoint = points.getPoint3dAtUncheckedPointIndex(i, this.lowPoint);\r\n      if (this.range.extendHigh(h))\r\n        this.highPoint = points.getPoint3dAtUncheckedPointIndex(i, this.highPoint);\r\n    }\r\n  }\r\n\r\n  public static createCapture(plane: PlaneAltitudeEvaluator): PlaneAltitudeRangeContext {\r\n    const context = new PlaneAltitudeRangeContext(plane);\r\n    return context;\r\n  }\r\n\r\n  public override handleLineSegment3d(segment: LineSegment3d) {\r\n    this.announcePoint(segment.point0Ref);\r\n    this.announcePoint(segment.point1Ref);\r\n  }\r\n\r\n  public override handleLineString3d(lineString: LineString3d) {\r\n    this.announcePoints(lineString.packedPoints);\r\n  }\r\n\r\n  private _strokeOptions?: StrokeOptions;\r\n\r\n  private initStrokeOptions() {\r\n    // TODO: compute the exact extrema; until then stroke aggressively\r\n    if (undefined === this._strokeOptions) {\r\n      this._strokeOptions = new StrokeOptions();\r\n      this._strokeOptions.angleTol = Angle.createDegrees(1);\r\n    }\r\n  }\r\n\r\n  public override handleBSplineCurve3d(bcurve: BSplineCurve3d) {\r\n    // ugh.   The point MUST be on the curve -- usual excess-range of poles is not ok.\r\n    this.initStrokeOptions();\r\n    const ls = LineString3d.create();\r\n    bcurve.emitStrokes(ls, this._strokeOptions);\r\n    this.handleLineString3d(ls);\r\n  }\r\n\r\n  public override handleBSplineCurve3dH(bcurve: BSplineCurve3dH) {\r\n    // ugh.   The point MUST be on the curve -- usual excess-range of poles is not ok.\r\n    this.initStrokeOptions();\r\n    const ls = LineString3d.create();\r\n    bcurve.emitStrokes(ls, this._strokeOptions);\r\n    this.handleLineString3d(ls);\r\n  }\r\n\r\n  private _sineCosinePolynomial?: SineCosinePolynomial;\r\n\r\n  private _workPoint?: Point3d;\r\n\r\n  public override handleArc3d(g: Arc3d) {\r\n    this._sineCosinePolynomial = g.getPlaneAltitudeSineCosinePolynomial(this.plane, this._sineCosinePolynomial);\r\n    let radians = this._sineCosinePolynomial.referenceMinMaxRadians();\r\n    if (g.sweep.isRadiansInSweep(radians))\r\n      this.announcePoint((this._workPoint = g.radiansToPoint(radians, this._workPoint)));\r\n    radians += Math.PI;\r\n    if (g.sweep.isRadiansInSweep(radians))\r\n      this.announcePoint((this._workPoint = g.radiansToPoint(radians, this._workPoint)));\r\n    this.announcePoint((this._workPoint = g.startPoint(this._workPoint)));\r\n    this.announcePoint((this._workPoint = g.endPoint(this._workPoint)));\r\n  }\r\n\r\n  private static findExtremesInDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d,\r\n  ): PlaneAltitudeRangeContext | undefined {\r\n    const origin = direction instanceof Ray3d ? direction.origin : Point3d.createZero();\r\n    const vector = direction instanceof Ray3d ? direction.direction : direction;\r\n    const plane = Plane3dByOriginAndUnitNormal.create(origin, vector);  // vector is normalized, so altitudes are distances\r\n    if (plane) {\r\n      const context = new PlaneAltitudeRangeContext(plane);\r\n      if (geometry instanceof GeometryQuery) {\r\n        geometry.dispatchToGeometryHandler(context);\r\n      } else if (geometry instanceof GrowableXYZArray) {\r\n        context.announcePoints(geometry);\r\n      } else {\r\n        for (const pt of geometry)\r\n          context.announcePoint(pt);\r\n      }\r\n      return context;\r\n    }\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Compute altitudes for the geometry (via dispatch) over the plane defined by the given direction, and\r\n   * return points at min and max altitude, packed into a `LineSegment3d`.\r\n   * @param geometry geometry to project\r\n   * @param direction vector or ray on which to project the instance. A `Vector3d` is treated as a `Ray3d` with\r\n   * zero origin.\r\n   * @param lowHigh optional receiver for output\r\n  */\r\n  public static findExtremePointsInDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d, lowHigh?: LineSegment3d,\r\n  ): LineSegment3d | undefined {\r\n    const context = this.findExtremesInDirection(geometry, direction);\r\n    if (context && context.highPoint && context.lowPoint)\r\n      return LineSegment3d.create(context.lowPoint, context.highPoint, lowHigh);\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Compute altitudes for the geometry (via dispatch) over the plane defined by the given direction, and return\r\n   * the min and max altitudes, packed into a Range1d.\r\n   * @param geometry geometry to project\r\n   * @param direction vector or ray on which to project the instance. A `Vector3d` is treated as a `Ray3d` with\r\n   * zero origin.\r\n   * @param lowHigh optional receiver for output\r\n  */\r\n  public static findExtremeAltitudesInDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d, lowHigh?: Range1d,\r\n  ): Range1d | undefined {\r\n    const context = this.findExtremesInDirection(geometry, direction);\r\n    if (context && !context.range.isNull)\r\n      return Range1d.createFrom(context.range, lowHigh);\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Project geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of projection.\r\n   * @param geometry geometry to project\r\n   * @param direction vector or ray onto which the instance is projected. A `Vector3d` is treated as a `Ray3d` with\r\n   * zero origin.\r\n   * @param lowHigh optional receiver for output\r\n   */\r\n  public static findExtremeFractionsAlongDirection(\r\n    geometry: GeometryQuery | GrowableXYZArray | Point3d[], direction: Vector3d | Ray3d, lowHigh?: Range1d,\r\n  ): Range1d | undefined {\r\n    const range = this.findExtremeAltitudesInDirection(geometry, direction, lowHigh);\r\n    if (undefined !== range) {\r\n      const mag = (direction instanceof Vector3d) ? direction.magnitude() : direction.direction.magnitude();\r\n      const scaleToFraction = Geometry.conditionalDivideCoordinate(1.0, mag);\r\n      if (undefined !== scaleToFraction) {\r\n        range.low *= scaleToFraction;\r\n        range.high *= scaleToFraction;\r\n        return range;\r\n      }\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n"]}

package/lib/cjs/curve/internalContexts/PolygonOffsetContext.d.ts

@@ -1,104 +1,12 @@
 /** @packageDocumentation
  * @module Curve
  */
-import { Angle } from "../../geometry3d/Angle";
 import { Point3d } from "../../geometry3d/Point3dVector3d";
 import { CurveChain, CurveCollection } from "../CurveCollection";
 import { CurvePrimitive } from "../CurvePrimitive";
 import { Loop } from "../Loop";
+import { JointOptions, OffsetOptions } from "../OffsetOptions";
 import { Path } from "../Path";
-import { StrokeOptions } from "../StrokeOptions";
-/**
- * Control parameters for joint construction.
- *   * Define a "joint" as the common point between adjacent segments of the input curve.
- *   * Define the "turn angle" at a joint to be the angle in [0,pi] between the first derivatives (tangents) of
- * the segments at the joint.
- *   * When creating offsets, if an offset needs to do an "outside" turn, the first applicable construction is applied:
- *   * If the turn angle is larger than `options.minArcDegrees`, a circular arc is constructed to offset the joint.
- *   * If the turn angle is less than or equal to `options.maxChamferTurnDegrees`, extend curves along tangent to
- * single intersection point (to create a sharp corner).
- *   * If the turn angle is larger than `options.maxChamferDegrees`, the joint is offset with a line string whose edges:
- *      * lie outside the arc that would have been created by the first construction
- *      * have uniform turn angle less than `options.maxChamferDegrees`
- *      * touch the arc at their midpoint (except first and last edge).
- * @public
- */
-export declare class JointOptions {
-    /**
-     * Smallest arc to construct.
-     * * If this control angle is 180 degrees or more, arcs are never created.
-     */
-    minArcDegrees: number;
-    /** Largest turn angle at which to construct a sharp corner, or largest turn angle in a multi-segment chamfer. */
-    maxChamferTurnDegrees: number;
-    /**
-     * Whether to remove the internal turn angle upper bound for sharp corner construction.
-     * * By default, a sharp corner is not created at a joint when the turn angle is too large, so as to avoid offsets whose
-     *  ranges blow up. Internally, this is implemented by applying an upper bound of 120 degrees to `maxChamferTurnDegrees`.
-     * * When `allowSharpestCorners` is true, this internal upper bound is removed, allowing sharp corners for turn angles
-     * up to `maxChamferTurnDegrees`.
-     * * Thus, if you know your input turn angles are no greater than `maxChamferTurnDegrees`, you can create an offset with
-     * sharp corners at each joint by setting `maxChamferTurnDegrees < minArcDegrees` and `allowSharpestCorners` to true.
-     */
-    allowSharpestCorners: boolean;
-    /** Offset distance, positive to left of base curve. */
-    leftOffsetDistance: number;
-    /** Whether to offset elliptical arcs as elliptical arcs (true) or as B-spline curves (false, default). */
-    preserveEllipticalArcs: boolean;
-    /**
-     * Construct JointOptions.
-     * * leftOffsetDistance is required
-     * * minArcDegrees and maxChamferDegrees are optional.
-     */
-    constructor(leftOffsetDistance: number, minArcDegrees?: number, maxChamferDegrees?: number, preserveEllipticalArcs?: boolean, allowSharpestCorners?: boolean);
-    /** Return a deep clone. */
-    clone(): JointOptions;
-    /** Copy values of input options */
-    setFrom(other: JointOptions): void;
-    /**
-     * Parse a number or JointOptions up to JointOptions:
-     * * If leftOffsetDistanceOptions is a number, create a JointOptions with other options set to default values.
-     * * If leftOffsetDistanceOrOptions is a JointOptions, return it unchanged.
-     * @param leftOffsetDistanceOrOptions
-     */
-    static create(leftOffsetDistanceOrOptions: number | JointOptions): JointOptions;
-    /** Return true if the options indicate this amount of turn should be handled with an arc. */
-    needArc(theta: Angle): boolean;
-    /** Return the number of corners needed to chamfer the given turn angle. */
-    numChamferPoints(theta: Angle): number;
-}
-/**
- * Options for offsetting a curve.
- * @public
- */
-export declare class OffsetOptions {
-    /** Options for offsetting and joining CurvePrimitives */
-    jointOptions: JointOptions;
-    /** Options for generating a B-spline curve offset */
-    strokeOptions: StrokeOptions;
-    /** Options that are provided are captured. */
-    constructor(offsetDistanceOrOptions: number | JointOptions, strokeOptions?: StrokeOptions);
-    get minArcDegrees(): number;
-    set minArcDegrees(value: number);
-    get maxChamferTurnDegrees(): number;
-    set maxChamferTurnDegrees(value: number);
-    get allowSharpestCorners(): boolean;
-    set allowSharpestCorners(value: boolean);
-    get leftOffsetDistance(): number;
-    set leftOffsetDistance(value: number);
-    get preserveEllipticalArcs(): boolean;
-    set preserveEllipticalArcs(value: boolean);
-    /**
-     * Convert variant input into OffsetOptions.
-     * * If a JointOptions is provided, it is captured.
-     * * If an OffsetOptions is provided, a reference to it is returned.
-     */
-    static create(offsetDistanceOrOptions: number | JointOptions | OffsetOptions): OffsetOptions;
-    /** Convert variant input into offset distance */
-    static getOffsetDistance(offsetDistanceOrOptions: number | JointOptions | OffsetOptions): number;
-    /** Return a deep clone. */
-    clone(): OffsetOptions;
-}
 /**
  * Context for building a wire offset.
  * @internal
@@ -140,20 +48,18 @@ export declare class CurveChainWireOffsetContext {
      */
     static applyBasePoints(cp: CurvePrimitive | undefined, startPoint: Point3d | undefined, endPoint: Point3d | undefined): CurvePrimitive | undefined;
     /**
-     * Create the offset of a single primitive as viewed in the xy-plane (ignoring z).
-     * * each primitive may be labeled (as an `any` object) with start or end point of base curve:
+     * Create the offset of a single curve primitive as viewed in the xy-plane (ignoring z).
+     * * Each primitive may be labeled (as an `any` object) with start or end point of base curve:
      *   * `(primitive as any).baseCurveStart: Point3d`
      *   * `(primitive as any).baseCurveEnd: Point3d`
-     * @param g primitive to offset
-     * @param offsetDistanceOrOptions offset distance (positive to left of g), or options object
+     * @param curve primitive to offset
+     * @param offsetDistanceOrOptions offset distance (positive to left of curve, negative to right) or options object
      */
-    static createSingleOffsetPrimitiveXY(g: CurvePrimitive, offsetDistanceOrOptions: number | OffsetOptions): CurvePrimitive | CurvePrimitive[] | undefined;
+    static createSingleOffsetPrimitiveXY(curve: CurvePrimitive, offsetDistanceOrOptions: number | OffsetOptions): CurvePrimitive | CurvePrimitive[] | undefined;
     /**
      * Construct curves that are offset from a Path or Loop as viewed in xy-plane (ignoring z).
      * * The construction will remove "some" local effects of features smaller than the offset distance, but will
      * not detect self intersection among widely separated edges.
-     * * If offsetDistance is given as a number, default OffsetOptions are applied.
-     * * See [[JointOptions]] class doc for offset construction rules.
      * * Visualization can be found at https://www.itwinjs.org/sandbox/SaeedTorabi/Offset
      * @param curves base curves.
      * @param offsetDistanceOrOptions offset distance (positive to left of curve, negative to right) or options object.

package/lib/cjs/curve/internalContexts/PolygonOffsetContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PolygonOffsetContext.d.ts","sourceRoot":"","sources":["../../../../src/curve/internalContexts/PolygonOffsetContext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PolygonOffsetContext.d.ts","sourceRoot":"","sources":["../../../../src/curve/internalContexts/PolygonOffsetContext.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAAE,OAAO,EAAY,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAia/B;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,2BAA2B;;IAE3B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAqB;IAC9C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAC3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAelC;;;;;;;;;;OAUG;IACI,4BAA4B,CACjC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,EAAE,MAAM,GAAG,YAAY,GACnF,UAAU,GAAG,SAAS;CAwD1B;AAED;;;GAGG;AACH,qBAAa,2BAA2B;IACtC,2BAA2B;;IAE3B;;;;;;OAMG;WACW,eAAe,CAC3B,EAAE,EAAE,cAAc,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,GAC7F,cAAc,GAAG,SAAS;IAS7B;;;;;;;OAOG;WACW,6BAA6B,CACzC,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,GAAG,aAAa,GACrE,cAAc,GAAG,cAAc,EAAE,GAAG,SAAS;IAehD;;;;;;;OAOG;WACW,sBAAsB,CAClC,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,uBAAuB,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,GAClF,eAAe,GAAG,SAAS;CA6C/B"}

package/lib/cjs/curve/internalContexts/PolygonOffsetContext.js

@@ -7,7 +7,7 @@
  * @module Curve
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CurveChainWireOffsetContext = exports.PolygonWireOffsetContext = exports.OffsetOptions = exports.JointOptions = void 0;
+exports.CurveChainWireOffsetContext = exports.PolygonWireOffsetContext = void 0;
 const Geometry_1 = require("../../Geometry");
 const AngleSweep_1 = require("../../geometry3d/AngleSweep");
 const Point3dVector3d_1 = require("../../geometry3d/Point3dVector3d");
@@ -19,9 +19,9 @@ const CurvePrimitive_1 = require("../CurvePrimitive");
 const LineSegment3d_1 = require("../LineSegment3d");
 const LineString3d_1 = require("../LineString3d");
 const Loop_1 = require("../Loop");
+const OffsetOptions_1 = require("../OffsetOptions");
 const Path_1 = require("../Path");
 const RegionOps_1 = require("../RegionOps");
-const StrokeOptions_1 = require("../StrokeOptions");
 // cspell:word CCWXY
 /**
  * Classification of how the joint is constructed.
@@ -36,159 +36,6 @@ var JointMode;
     JointMode[JointMode["JustGeometry"] = 3] = "JustGeometry";
     JointMode[JointMode["Gap"] = 4] = "Gap";
 })(JointMode || (JointMode = {}));
-/**
- * Control parameters for joint construction.
- *   * Define a "joint" as the common point between adjacent segments of the input curve.
- *   * Define the "turn angle" at a joint to be the angle in [0,pi] between the first derivatives (tangents) of
- * the segments at the joint.
- *   * When creating offsets, if an offset needs to do an "outside" turn, the first applicable construction is applied:
- *   * If the turn angle is larger than `options.minArcDegrees`, a circular arc is constructed to offset the joint.
- *   * If the turn angle is less than or equal to `options.maxChamferTurnDegrees`, extend curves along tangent to
- * single intersection point (to create a sharp corner).
- *   * If the turn angle is larger than `options.maxChamferDegrees`, the joint is offset with a line string whose edges:
- *      * lie outside the arc that would have been created by the first construction
- *      * have uniform turn angle less than `options.maxChamferDegrees`
- *      * touch the arc at their midpoint (except first and last edge).
- * @public
- */
-class JointOptions {
-    /**
-     * Construct JointOptions.
-     * * leftOffsetDistance is required
-     * * minArcDegrees and maxChamferDegrees are optional.
-     */
-    constructor(leftOffsetDistance, minArcDegrees = 180, maxChamferDegrees = 90, preserveEllipticalArcs = false, allowSharpestCorners = false) {
-        /**
-         * Smallest arc to construct.
-         * * If this control angle is 180 degrees or more, arcs are never created.
-         */
-        this.minArcDegrees = 180.0;
-        /** Largest turn angle at which to construct a sharp corner, or largest turn angle in a multi-segment chamfer. */
-        this.maxChamferTurnDegrees = 90;
-        /**
-         * Whether to remove the internal turn angle upper bound for sharp corner construction.
-         * * By default, a sharp corner is not created at a joint when the turn angle is too large, so as to avoid offsets whose
-         *  ranges blow up. Internally, this is implemented by applying an upper bound of 120 degrees to `maxChamferTurnDegrees`.
-         * * When `allowSharpestCorners` is true, this internal upper bound is removed, allowing sharp corners for turn angles
-         * up to `maxChamferTurnDegrees`.
-         * * Thus, if you know your input turn angles are no greater than `maxChamferTurnDegrees`, you can create an offset with
-         * sharp corners at each joint by setting `maxChamferTurnDegrees < minArcDegrees` and `allowSharpestCorners` to true.
-         */
-        this.allowSharpestCorners = false;
-        /** Offset distance, positive to left of base curve. */
-        this.leftOffsetDistance = 0;
-        /** Whether to offset elliptical arcs as elliptical arcs (true) or as B-spline curves (false, default). */
-        this.preserveEllipticalArcs = false;
-        this.leftOffsetDistance = leftOffsetDistance;
-        this.minArcDegrees = minArcDegrees;
-        this.maxChamferTurnDegrees = maxChamferDegrees;
-        this.preserveEllipticalArcs = preserveEllipticalArcs;
-        this.allowSharpestCorners = allowSharpestCorners;
-    }
-    /** Return a deep clone. */
-    clone() {
-        return new JointOptions(this.leftOffsetDistance, this.minArcDegrees, this.maxChamferTurnDegrees, this.preserveEllipticalArcs, this.allowSharpestCorners);
-    }
-    /** Copy values of input options */
-    setFrom(other) {
-        this.leftOffsetDistance = other.leftOffsetDistance;
-        this.minArcDegrees = other.minArcDegrees;
-        this.maxChamferTurnDegrees = other.maxChamferTurnDegrees;
-        this.preserveEllipticalArcs = other.preserveEllipticalArcs;
-        this.allowSharpestCorners = other.allowSharpestCorners;
-    }
-    /**
-     * Parse a number or JointOptions up to JointOptions:
-     * * If leftOffsetDistanceOptions is a number, create a JointOptions with other options set to default values.
-     * * If leftOffsetDistanceOrOptions is a JointOptions, return it unchanged.
-     * @param leftOffsetDistanceOrOptions
-     */
-    static create(leftOffsetDistanceOrOptions) {
-        if (leftOffsetDistanceOrOptions instanceof JointOptions)
-            return leftOffsetDistanceOrOptions;
-        return new JointOptions(leftOffsetDistanceOrOptions);
-    }
-    /** Return true if the options indicate this amount of turn should be handled with an arc. */
-    needArc(theta) {
-        return Math.abs(theta.degrees) >= this.minArcDegrees;
-    }
-    /** Return the number of corners needed to chamfer the given turn angle. */
-    numChamferPoints(theta) {
-        const degrees = Math.abs(theta.degrees);
-        const minStepDegreesClamp = 10;
-        let maxStepDegreesClamp = 120;
-        if (this.allowSharpestCorners) {
-            maxStepDegreesClamp = this.maxChamferTurnDegrees;
-        }
-        const stepDegrees = Geometry_1.Geometry.clamp(this.maxChamferTurnDegrees, minStepDegreesClamp, maxStepDegreesClamp);
-        if (degrees <= stepDegrees)
-            return 1;
-        return Math.ceil(degrees / stepDegrees);
-    }
-}
-exports.JointOptions = JointOptions;
-/**
- * Options for offsetting a curve.
- * @public
- */
-class OffsetOptions {
-    /** Options that are provided are captured. */
-    constructor(offsetDistanceOrOptions, strokeOptions) {
-        this.jointOptions = JointOptions.create(offsetDistanceOrOptions);
-        this.strokeOptions = (strokeOptions !== undefined) ? strokeOptions : StrokeOptions_1.StrokeOptions.createForCurves();
-    }
-    get minArcDegrees() {
-        return this.jointOptions.minArcDegrees;
-    }
-    set minArcDegrees(value) {
-        this.jointOptions.minArcDegrees = value;
-    }
-    get maxChamferTurnDegrees() {
-        return this.jointOptions.maxChamferTurnDegrees;
-    }
-    set maxChamferTurnDegrees(value) {
-        this.jointOptions.maxChamferTurnDegrees = value;
-    }
-    get allowSharpestCorners() {
-        return this.jointOptions.allowSharpestCorners;
-    }
-    set allowSharpestCorners(value) {
-        this.jointOptions.allowSharpestCorners = value;
-    }
-    get leftOffsetDistance() {
-        return this.jointOptions.leftOffsetDistance;
-    }
-    set leftOffsetDistance(value) {
-        this.jointOptions.leftOffsetDistance = value;
-    }
-    get preserveEllipticalArcs() {
-        return this.jointOptions.preserveEllipticalArcs;
-    }
-    set preserveEllipticalArcs(value) {
-        this.jointOptions.preserveEllipticalArcs = value;
-    }
-    /**
-     * Convert variant input into OffsetOptions.
-     * * If a JointOptions is provided, it is captured.
-     * * If an OffsetOptions is provided, a reference to it is returned.
-     */
-    static create(offsetDistanceOrOptions) {
-        if (offsetDistanceOrOptions instanceof OffsetOptions)
-            return offsetDistanceOrOptions;
-        return new OffsetOptions(offsetDistanceOrOptions);
-    }
-    /** Convert variant input into offset distance */
-    static getOffsetDistance(offsetDistanceOrOptions) {
-        if (typeof offsetDistanceOrOptions === "number")
-            return offsetDistanceOrOptions;
-        return offsetDistanceOrOptions.leftOffsetDistance;
-    }
-    /** Return a deep clone. */
-    clone() {
-        return new OffsetOptions(this.jointOptions.clone(), this.strokeOptions.clone());
-    }
-}
-exports.OffsetOptions = OffsetOptions;
 /**
  * Description of geometry around a joint.
  * @internal
@@ -598,7 +445,7 @@ class PolygonWireOffsetContext {
             wrap = false;
         }
         /** create raw offsets as a linked list (joint0) */
-        const options = JointOptions.create(leftOffsetDistanceOrOptions);
+        const options = OffsetOptions_1.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]);
@@ -675,41 +522,39 @@ class CurveChainWireOffsetContext {
         return cp;
     }
     /**
-     * Create the offset of a single primitive as viewed in the xy-plane (ignoring z).
-     * * each primitive may be labeled (as an `any` object) with start or end point of base curve:
+     * Create the offset of a single curve primitive as viewed in the xy-plane (ignoring z).
+     * * Each primitive may be labeled (as an `any` object) with start or end point of base curve:
      *   * `(primitive as any).baseCurveStart: Point3d`
      *   * `(primitive as any).baseCurveEnd: Point3d`
-     * @param g primitive to offset
-     * @param offsetDistanceOrOptions offset distance (positive to left of g), or options object
+     * @param curve primitive to offset
+     * @param offsetDistanceOrOptions offset distance (positive to left of curve, negative to right) or options object
      */
-    static createSingleOffsetPrimitiveXY(g, offsetDistanceOrOptions) {
-        const offset = g.constructOffsetXY(offsetDistanceOrOptions);
+    static createSingleOffsetPrimitiveXY(curve, offsetDistanceOrOptions) {
+        const offset = curve.constructOffsetXY(offsetDistanceOrOptions);
         if (offset === undefined)
             return undefined;
         // decorate each offset with its base curve's endpoints
         if (Array.isArray(offset)) {
-            const basePrims = g.collectCurvePrimitives(undefined, true, true);
+            const basePrims = curve.collectCurvePrimitives(undefined, true, true);
             if (basePrims.length !== offset.length)
                 return undefined; // unexpected aggregate curve type!
             for (let i = 0; i < basePrims.length; ++i)
                 this.applyBasePoints(offset[i], basePrims[i].startPoint(), basePrims[i].endPoint());
             return offset;
         }
-        return this.applyBasePoints(offset, g.startPoint(), g.endPoint());
+        return this.applyBasePoints(offset, curve.startPoint(), curve.endPoint());
     }
     /**
      * Construct curves that are offset from a Path or Loop as viewed in xy-plane (ignoring z).
      * * The construction will remove "some" local effects of features smaller than the offset distance, but will
      * not detect self intersection among widely separated edges.
-     * * If offsetDistance is given as a number, default OffsetOptions are applied.
-     * * See [[JointOptions]] class doc for offset construction rules.
      * * Visualization can be found at https://www.itwinjs.org/sandbox/SaeedTorabi/Offset
      * @param curves base curves.
      * @param offsetDistanceOrOptions offset distance (positive to left of curve, negative to right) or options object.
      */
     static constructCurveXYOffset(curves, offsetDistanceOrOptions) {
         const wrap = curves instanceof Loop_1.Loop;
-        const offsetOptions = OffsetOptions.create(offsetDistanceOrOptions);
+        const offsetOptions = OffsetOptions_1.OffsetOptions.create(offsetDistanceOrOptions);
         const simpleOffsets = [];
         /** traverse primitives (children of curves) and create simple offsets of each primitive as an array */
         for (const c of curves.children) {