@itwin/core-geometry 4.5.0-dev.4 → 4.5.0-dev.7

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

@@ -11,44 +11,41 @@ import { GeometryQuery } from "./GeometryQuery";
  * @public
  */
 export declare class CoordinateXYZ extends GeometryQuery {
-    /** String name for interface properties */
+    /** String name for interface properties. */
     readonly geometryCategory = "point";
     private _xyz;
     /** Return a (REFERENCE TO) the coordinate data. */
     get point(): Point3d;
     /**
+     * Constructor
      * @param xyz point to be CAPTURED.
      */
     private constructor();
-    /** Create a new CoordinateXYZ containing a CLONE of point */
+    /** Create a new CoordinateXYZ containing a CLONE of point. */
     static create(point: Point3d): CoordinateXYZ;
-    /** Create a new CoordinateXYZ */
+    /** Create a new CoordinateXYZ. */
     static createXYZ(x?: number, y?: number, z?: number): CoordinateXYZ;
-    /** Return the range of the point */
+    /** Return the range of the point. */
     range(): Range3d;
-    /** Extend `rangeToExtend` to include this point (optionally transformed) */
+    /** Extend `rangeToExtend` to include this point (optionally transformed). */
     extendRange(rangeToExtend: Range3d, transform?: Transform): void;
     /** Apply transform to the Coordinate's point. */
     tryTransformInPlace(transform: Transform): boolean;
-    /** Return a transformed clone */
+    /** Return a transformed clone. */
     cloneTransformed(transform: Transform): GeometryQuery | undefined;
-    /** Return a clone */
+    /** Return a clone. */
     clone(): GeometryQuery | undefined;
-    /**
-     * Return GeometryQuery children for recursive queries.
-     * * Leaf classes do not need to implement.
-     */
     /** Test if (other instanceof Coordinate).  */
     isSameGeometryClass(other: GeometryQuery): boolean;
     /**
      * Test for exact structure and nearly identical geometry.
-     * *  Leaf classes must implement !!!
+     * *  Leaf classes must implement.
      * *  Base class implementation recurses through children.
      * *  Base implementation is complete for classes with children and no properties.
      * *  Classes with both children and properties must implement for properties, call super for children.
      */
     isAlmostEqual(other: GeometryQuery): boolean;
-    /** Second step of double dispatch:  call `handler.handleCoordinateXYZ(this)` */
+    /** Second step of double dispatch: call `handler.handleCoordinateXYZ(this)` */
     dispatchToGeometryHandler(handler: GeometryHandler): any;
 }
 //# sourceMappingURL=CoordinateXYZ.d.ts.map

package/lib/cjs/curve/CoordinateXYZ.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoordinateXYZ.d.ts","sourceRoot":"","sources":["../../../src/curve/CoordinateXYZ.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,2CAA2C;IAC3C,SAAgB,gBAAgB,WAAW;IAE3C,OAAO,CAAC,IAAI,CAAU;IACtB,mDAAmD;IACnD,IAAW,KAAK,YAAwB;IACxC;;OAEG;IACH,OAAO;IAIP,6DAA6D;WAC/C,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAGnD,iCAAiC;WACnB,SAAS,CAAC,CAAC,GAAE,MAAU,EAAE,CAAC,GAAE,MAAU,EAAE,CAAC,GAAE,MAAU,GAAG,aAAa;IAInF,oCAAoC;IACpB,KAAK,IAAI,OAAO;IAEhC,4EAA4E;IACrE,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAMvE,iDAAiD;IAC1C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIzD,iCAAiC;IAC1B,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IAKxE,qBAAqB;IACd,KAAK,IAAI,aAAa,GAAG,SAAS;IAGzC;;;OAGG;IAEH,8CAA8C;IACvC,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAGzD;;;;;;OAMG;IACa,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAG5D,gFAAgF;IACzE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CAGhE"}
+{"version":3,"file":"CoordinateXYZ.d.ts","sourceRoot":"","sources":["../../../src/curve/CoordinateXYZ.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,4CAA4C;IAC5C,SAAgB,gBAAgB,WAAW;IAC3C,OAAO,CAAC,IAAI,CAAU;IACtB,mDAAmD;IACnD,IAAW,KAAK,YAEf;IACD;;;OAGG;IACH,OAAO;IAIP,8DAA8D;WAChD,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAGnD,kCAAkC;WACpB,SAAS,CAAC,CAAC,GAAE,MAAU,EAAE,CAAC,GAAE,MAAU,EAAE,CAAC,GAAE,MAAU,GAAG,aAAa;IAGnF,qCAAqC;IACrB,KAAK,IAAI,OAAO;IAGhC,6EAA6E;IACtE,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAMvE,iDAAiD;IAC1C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIzD,kCAAkC;IAC3B,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IAKxE,sBAAsB;IACf,KAAK,IAAI,aAAa,GAAG,SAAS;IAGzC,8CAA8C;IACvC,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAGzD;;;;;;OAMG;IACa,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAG5D,+EAA+E;IACxE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CAGhE"}

package/lib/cjs/curve/CoordinateXYZ.js

@@ -10,27 +10,32 @@ const GeometryQuery_1 = require("./GeometryQuery");
  */
 class CoordinateXYZ extends GeometryQuery_1.GeometryQuery {
     /** Return a (REFERENCE TO) the coordinate data. */
-    get point() { return this._xyz; }
+    get point() {
+        return this._xyz;
+    }
     /**
+     * Constructor
      * @param xyz point to be CAPTURED.
      */
     constructor(xyz) {
         super();
-        /** String name for interface properties */
+        /** String name for interface properties. */
         this.geometryCategory = "point";
         this._xyz = xyz;
     }
-    /** Create a new CoordinateXYZ containing a CLONE of point */
+    /** Create a new CoordinateXYZ containing a CLONE of point. */
     static create(point) {
         return new CoordinateXYZ(point.clone());
     }
-    /** Create a new CoordinateXYZ */
+    /** Create a new CoordinateXYZ. */
     static createXYZ(x = 0, y = 0, z = 0) {
         return new CoordinateXYZ(Point3dVector3d_1.Point3d.create(x, y, z));
     }
-    /** Return the range of the point */
-    range() { return Range_1.Range3d.create(this._xyz); }
-    /** Extend `rangeToExtend` to include this point (optionally transformed) */
+    /** Return the range of the point. */
+    range() {
+        return Range_1.Range3d.create(this._xyz);
+    }
+    /** Extend `rangeToExtend` to include this point (optionally transformed). */
     extendRange(rangeToExtend, transform) {
         if (transform)
             rangeToExtend.extendTransformedXYZ(transform, this._xyz.x, this._xyz.y, this._xyz.z);
@@ -42,27 +47,23 @@ class CoordinateXYZ extends GeometryQuery_1.GeometryQuery {
         transform.multiplyPoint3d(this._xyz, this._xyz);
         return true;
     }
-    /** Return a transformed clone */
+    /** Return a transformed clone. */
     cloneTransformed(transform) {
         const result = new CoordinateXYZ(this._xyz.clone());
         result.tryTransformInPlace(transform);
         return result;
     }
-    /** Return a clone */
+    /** Return a clone. */
     clone() {
         return new CoordinateXYZ(this._xyz.clone());
     }
-    /**
-     * Return GeometryQuery children for recursive queries.
-     * * Leaf classes do not need to implement.
-     */
     /** Test if (other instanceof Coordinate).  */
     isSameGeometryClass(other) {
         return other instanceof CoordinateXYZ;
     }
     /**
      * Test for exact structure and nearly identical geometry.
-     * *  Leaf classes must implement !!!
+     * *  Leaf classes must implement.
      * *  Base class implementation recurses through children.
      * *  Base implementation is complete for classes with children and no properties.
      * *  Classes with both children and properties must implement for properties, call super for children.
@@ -70,7 +71,7 @@ class CoordinateXYZ extends GeometryQuery_1.GeometryQuery {
     isAlmostEqual(other) {
         return (other instanceof CoordinateXYZ) && this._xyz.isAlmostEqual(other._xyz);
     }
-    /** Second step of double dispatch:  call `handler.handleCoordinateXYZ(this)` */
+    /** Second step of double dispatch: call `handler.handleCoordinateXYZ(this)` */
     dispatchToGeometryHandler(handler) {
         return handler.handleCoordinateXYZ(this);
     }

package/lib/cjs/curve/CoordinateXYZ.js.map

@@ -1 +1 @@
-{"version":3,"file":"CoordinateXYZ.js","sourceRoot":"","sources":["../../../src/curve/CoordinateXYZ.ts"],"names":[],"mappings":";;;AAQA,mEAAwD;AACxD,+CAA8C;AAE9C,mDAAgD;AAEhD;;;GAGG;AACH,MAAa,aAAc,SAAQ,6BAAa;IAK9C,mDAAmD;IACnD,IAAW,KAAK,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC;;OAEG;IACH,YAAoB,GAAY;QAC9B,KAAK,EAAE,CAAC;QAVV,2CAA2C;QAC3B,qBAAgB,GAAG,OAAO,CAAC;QAUzC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IACD,6DAA6D;IACtD,MAAM,CAAC,MAAM,CAAC,KAAc;QACjC,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,iCAAiC;IAC1B,MAAM,CAAC,SAAS,CAAC,IAAY,CAAC,EAAE,IAAY,CAAC,EAAE,IAAY,CAAC;QACjE,OAAO,IAAI,aAAa,CAAC,yBAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,oCAAoC;IACpB,KAAK,KAAc,OAAO,eAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEtE,4EAA4E;IACrE,WAAW,CAAC,aAAsB,EAAE,SAAqB;QAC9D,IAAI,SAAS;YACX,aAAa,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YAErF,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,iDAAiD;IAC1C,mBAAmB,CAAC,SAAoB;QAC7C,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,iCAAiC;IAC1B,gBAAgB,CAAC,SAAoB;QAC1C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,qBAAqB;IACd,KAAK;QACV,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD;;;OAGG;IAEH,8CAA8C;IACvC,mBAAmB,CAAC,KAAoB;QAC7C,OAAO,KAAK,YAAY,aAAa,CAAC;IACxC,CAAC;IACD;;;;;;OAMG;IACa,aAAa,CAAC,KAAoB;QAChD,OAAO,CAAC,KAAK,YAAY,aAAa,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC;IACD,gFAAgF;IACzE,yBAAyB,CAAC,OAAwB;QACvD,OAAO,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF;AAvED,sCAuEC","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/** @packageDocumentation\r\n * @module Curve\r\n */\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Point3d } from \"../geometry3d/Point3dVector3d\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { GeometryQuery } from \"./GeometryQuery\";\r\n\r\n/**\r\n * A Coordinate is a Point3d with supporting methods from the GeometryQuery abstraction.\r\n * @public\r\n */\r\nexport class CoordinateXYZ extends GeometryQuery {\r\n  /** String name for interface properties */\r\n  public readonly geometryCategory = \"point\";\r\n\r\n  private _xyz: Point3d;\r\n  /** Return a (REFERENCE TO) the coordinate data. */\r\n  public get point() { return this._xyz; }\r\n  /**\r\n   * @param xyz point to be CAPTURED.\r\n   */\r\n  private constructor(xyz: Point3d) {\r\n    super();\r\n    this._xyz = xyz;\r\n  }\r\n  /** Create a new CoordinateXYZ containing a CLONE of point */\r\n  public static create(point: Point3d): CoordinateXYZ {\r\n    return new CoordinateXYZ(point.clone());\r\n  }\r\n  /** Create a new CoordinateXYZ */\r\n  public static createXYZ(x: number = 0, y: number = 0, z: number = 0): CoordinateXYZ {\r\n    return new CoordinateXYZ(Point3d.create(x, y, z));\r\n  }\r\n\r\n  /** Return the range of the point */\r\n  public override range(): Range3d { return Range3d.create(this._xyz); }\r\n\r\n  /** Extend `rangeToExtend` to include this point (optionally transformed) */\r\n  public extendRange(rangeToExtend: Range3d, transform?: Transform): void {\r\n    if (transform)\r\n      rangeToExtend.extendTransformedXYZ(transform, this._xyz.x, this._xyz.y, this._xyz.z);\r\n    else\r\n      rangeToExtend.extend(this._xyz);\r\n  }\r\n  /** Apply transform to the Coordinate's point. */\r\n  public tryTransformInPlace(transform: Transform): boolean {\r\n    transform.multiplyPoint3d(this._xyz, this._xyz);\r\n    return true;\r\n  }\r\n  /** Return a transformed clone */\r\n  public cloneTransformed(transform: Transform): GeometryQuery | undefined {\r\n    const result = new CoordinateXYZ(this._xyz.clone());\r\n    result.tryTransformInPlace(transform);\r\n    return result;\r\n  }\r\n  /** Return a clone */\r\n  public clone(): GeometryQuery | undefined {\r\n    return new CoordinateXYZ(this._xyz.clone());\r\n  }\r\n  /**\r\n   * Return GeometryQuery children for recursive queries.\r\n   * * Leaf classes do not need to implement.\r\n   */\r\n\r\n  /** Test if (other instanceof Coordinate).  */\r\n  public isSameGeometryClass(other: GeometryQuery): boolean {\r\n    return other instanceof CoordinateXYZ;\r\n  }\r\n  /**\r\n   * Test for exact structure and nearly identical geometry.\r\n   * *  Leaf classes must implement !!!\r\n   * *  Base class implementation recurses through children.\r\n   * *  Base implementation is complete for classes with children and no properties.\r\n   * *  Classes with both children and properties must implement for properties, call super for children.\r\n   */\r\n  public override isAlmostEqual(other: GeometryQuery): boolean {\r\n    return (other instanceof CoordinateXYZ) && this._xyz.isAlmostEqual(other._xyz);\r\n  }\r\n  /** Second step of double dispatch:  call `handler.handleCoordinateXYZ(this)` */\r\n  public dispatchToGeometryHandler(handler: GeometryHandler): any {\r\n    return handler.handleCoordinateXYZ(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"CoordinateXYZ.js","sourceRoot":"","sources":["../../../src/curve/CoordinateXYZ.ts"],"names":[],"mappings":";;;AAQA,mEAAwD;AACxD,+CAA8C;AAE9C,mDAAgD;AAEhD;;;GAGG;AACH,MAAa,aAAc,SAAQ,6BAAa;IAI9C,mDAAmD;IACnD,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD;;;OAGG;IACH,YAAoB,GAAY;QAC9B,KAAK,EAAE,CAAC;QAZV,4CAA4C;QAC5B,qBAAgB,GAAG,OAAO,CAAC;QAYzC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IACD,8DAA8D;IACvD,MAAM,CAAC,MAAM,CAAC,KAAc;QACjC,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,kCAAkC;IAC3B,MAAM,CAAC,SAAS,CAAC,IAAY,CAAC,EAAE,IAAY,CAAC,EAAE,IAAY,CAAC;QACjE,OAAO,IAAI,aAAa,CAAC,yBAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,qCAAqC;IACrB,KAAK;QACnB,OAAO,eAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,6EAA6E;IACtE,WAAW,CAAC,aAAsB,EAAE,SAAqB;QAC9D,IAAI,SAAS;YACX,aAAa,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YAErF,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,iDAAiD;IAC1C,mBAAmB,CAAC,SAAoB;QAC7C,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,kCAAkC;IAC3B,gBAAgB,CAAC,SAAoB;QAC1C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,sBAAsB;IACf,KAAK;QACV,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,8CAA8C;IACvC,mBAAmB,CAAC,KAAoB;QAC7C,OAAO,KAAK,YAAY,aAAa,CAAC;IACxC,CAAC;IACD;;;;;;OAMG;IACa,aAAa,CAAC,KAAoB;QAChD,OAAO,CAAC,KAAK,YAAY,aAAa,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC;IACD,+EAA+E;IACxE,yBAAyB,CAAC,OAAwB;QACvD,OAAO,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF;AApED,sCAoEC","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/** @packageDocumentation\r\n * @module Curve\r\n */\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Point3d } from \"../geometry3d/Point3dVector3d\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { GeometryQuery } from \"./GeometryQuery\";\r\n\r\n/**\r\n * A Coordinate is a Point3d with supporting methods from the GeometryQuery abstraction.\r\n * @public\r\n */\r\nexport class CoordinateXYZ extends GeometryQuery {\r\n  /** String name for interface properties. */\r\n  public readonly geometryCategory = \"point\";\r\n  private _xyz: Point3d;\r\n  /** Return a (REFERENCE TO) the coordinate data. */\r\n  public get point() {\r\n    return this._xyz;\r\n  }\r\n  /**\r\n   * Constructor\r\n   * @param xyz point to be CAPTURED.\r\n   */\r\n  private constructor(xyz: Point3d) {\r\n    super();\r\n    this._xyz = xyz;\r\n  }\r\n  /** Create a new CoordinateXYZ containing a CLONE of point. */\r\n  public static create(point: Point3d): CoordinateXYZ {\r\n    return new CoordinateXYZ(point.clone());\r\n  }\r\n  /** Create a new CoordinateXYZ. */\r\n  public static createXYZ(x: number = 0, y: number = 0, z: number = 0): CoordinateXYZ {\r\n    return new CoordinateXYZ(Point3d.create(x, y, z));\r\n  }\r\n  /** Return the range of the point. */\r\n  public override range(): Range3d {\r\n    return Range3d.create(this._xyz);\r\n  }\r\n  /** Extend `rangeToExtend` to include this point (optionally transformed). */\r\n  public extendRange(rangeToExtend: Range3d, transform?: Transform): void {\r\n    if (transform)\r\n      rangeToExtend.extendTransformedXYZ(transform, this._xyz.x, this._xyz.y, this._xyz.z);\r\n    else\r\n      rangeToExtend.extend(this._xyz);\r\n  }\r\n  /** Apply transform to the Coordinate's point. */\r\n  public tryTransformInPlace(transform: Transform): boolean {\r\n    transform.multiplyPoint3d(this._xyz, this._xyz);\r\n    return true;\r\n  }\r\n  /** Return a transformed clone. */\r\n  public cloneTransformed(transform: Transform): GeometryQuery | undefined {\r\n    const result = new CoordinateXYZ(this._xyz.clone());\r\n    result.tryTransformInPlace(transform);\r\n    return result;\r\n  }\r\n  /** Return a clone. */\r\n  public clone(): GeometryQuery | undefined {\r\n    return new CoordinateXYZ(this._xyz.clone());\r\n  }\r\n  /** Test if (other instanceof Coordinate).  */\r\n  public isSameGeometryClass(other: GeometryQuery): boolean {\r\n    return other instanceof CoordinateXYZ;\r\n  }\r\n  /**\r\n   * Test for exact structure and nearly identical geometry.\r\n   * *  Leaf classes must implement.\r\n   * *  Base class implementation recurses through children.\r\n   * *  Base implementation is complete for classes with children and no properties.\r\n   * *  Classes with both children and properties must implement for properties, call super for children.\r\n   */\r\n  public override isAlmostEqual(other: GeometryQuery): boolean {\r\n    return (other instanceof CoordinateXYZ) && this._xyz.isAlmostEqual(other._xyz);\r\n  }\r\n  /** Second step of double dispatch: call `handler.handleCoordinateXYZ(this)` */\r\n  public dispatchToGeometryHandler(handler: GeometryHandler): any {\r\n    return handler.handleCoordinateXYZ(this);\r\n  }\r\n}\r\n"]}

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

@@ -16,7 +16,7 @@ import { PointString3d } from "./PointString3d";
  * ```ts
  *   function processGeometryQuery(q: GeometryQuery): void {
  *     if ("solid" === q.geometryCategory)
- *       alert("Solid type = " + q.solidPrimitiveType; // compiler knows q is an instance of SolidPrimitive
+ *       alert("Solid type = " + q.solidPrimitiveType); // compiler knows q is an instance of SolidPrimitive
  *    // ...etc...
  * ```
  *
@@ -27,7 +27,7 @@ import { PointString3d } from "./PointString3d";
  *  - "solid" => [[SolidPrimitive]]
  *  - "point" => [[CoordinateXYZ]]
  *  - "pointCollection" => [[PointString3d]]
- *  - "bsurf" => [[BSpline2dNd]]  (which is an intermediate class shared by [[BSplineSurface3d]] and [[BSplineSurface3dH]])
+ *  - "bsurf" => [[BSpline2dNd]] (which is an intermediate class shared by [[BSplineSurface3d]] and [[BSplineSurface3dH]])
  *
  *  @see [[AnyGeometryQuery]]
  * @public
@@ -40,17 +40,17 @@ export type GeometryQueryCategory = "polyface" | "curvePrimitive" | "curveCollec
  */
 export type AnyGeometryQuery = Polyface | CurvePrimitive | CurveCollection | SolidPrimitive | CoordinateXYZ | PointString3d | BSpline2dNd;
 /**
- * Queries to be supported by Curve, Surface, and Solid objects
+ * Queries to be supported by Curve, Surface, and Solid objects.
  * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh,
- * and bspline surfaces
+ * and bspline surfaces.
  * @public
  */
 export declare abstract class GeometryQuery {
     /** Type discriminator. */
     abstract readonly geometryCategory: GeometryQueryCategory;
-    /** Return the range of the entire GeometryQuery tree */
+    /** Return the range of the entire GeometryQuery tree. */
     range(transform?: Transform, result?: Range3d): Range3d;
-    /** Extend rangeToExtend by the range of this geometry multiplied by the transform */
+    /** Extend `rangeToExtend` by the range of this geometry multiplied by the `transform`. */
     abstract extendRange(rangeToExtend: Range3d, transform?: Transform): void;
     /**
      * Attempt to transform in place.
@@ -58,7 +58,7 @@ export declare abstract class GeometryQuery {
      * * Some geometry types may fail if scaling is non-uniform.
      */
     abstract tryTransformInPlace(transform: Transform): boolean;
-    /** Try to move the geometry by dx,dy,dz */
+    /** Try to move the geometry by dx,dy,dz. */
     tryTranslateInPlace(dx: number, dy?: number, dz?: number): boolean;
     /** Return a transformed clone. */
     abstract cloneTransformed(transform: Transform): GeometryQuery | undefined;
@@ -69,28 +69,28 @@ export declare abstract class GeometryQuery {
      * * leaf classes do not need to implement.
      */
     get children(): GeometryQuery[] | undefined;
-    /** Test if (other instanceof this.Type).  REQUIRED IN ALL CONCRETE CLASSES */
+    /** Test `if (other instanceof this.Type)`. REQUIRED IN ALL CONCRETE CLASSES. */
     abstract isSameGeometryClass(other: GeometryQuery): boolean;
     /**
      * Test for exact structure and nearly identical geometry.
-     * *  Leaf classes must implement !!!
-     * *  base class implementation recurses through children.
-     * *  base implementation is complete for classes with children and no properties.
-     * *  classes with both children and properties must implement for properties, call super for children.
+     * *  Leaf classes must implement.
+     * *  Base class implementation recurses through children.
+     * *  Base implementation is complete for classes with children and no properties.
+     * *  Classes with both children and properties must implement for properties, call super for children.
      */
     isAlmostEqual(other: GeometryQuery): boolean;
     /**
      * Apply instance method [[isAlmostEqual]] if both are defined.
-     * * both undefined returns true
-     * * single defined returns false
+     * * Both undefined returns true.
+     * * Single defined returns false.
      */
     static areAlmostEqual(a: GeometryQuery | undefined, b: GeometryQuery | undefined): boolean;
     /**
-     * * "double dispatch" call pattern.
-     * * User code implements a `GeometryHandler` with specialized methods to handle `LineSegment3d`, `Arc3d` etc as
+     * Double Dispatch call pattern.
+     * * User code implements a `GeometryHandler` with specialized methods to handle `LineSegment3d`, `Arc3d`, etc as
      * relevant to its use case.
      * * Each such `GeometryQuery` class implements this method as a one-line method containing the appropriate call
-     * such as `handler.handleLineSegment3d ()`
+     * such as `handler.handleLineSegment3d())`
      * * This allows each type-specific method to be called without a switch or `instanceof` test.
      * @param handler handler to be called by the particular geometry class
      */

package/lib/cjs/curve/GeometryQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeometryQuery.d.ts","sourceRoot":"","sources":["../../../src/curve/GeometryQuery.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAExI;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;AAE1I;;;;;GAKG;AACH,8BAAsB,aAAa;IACjC,0BAA0B;IAC1B,kBAAyB,gBAAgB,EAAE,qBAAqB,CAAC;IACjE,wDAAwD;IACjD,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAM9D,qFAAqF;aACrE,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAChF;;;;OAIG;aACa,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAClE,2CAA2C;IACpC,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAE,MAAY,EAAE,EAAE,GAAE,MAAY,GAAG,OAAO;IAGnF,kCAAkC;aAClB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IACjF,qBAAqB;aACL,KAAK,IAAI,aAAa,GAAG,SAAS;IAClD;;;OAGG;IACH,IAAW,QAAQ,IAAI,aAAa,EAAE,GAAG,SAAS,CAAsB;IACxE,8EAA8E;aAC9D,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAClE;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAoBnD;;;;OAIG;WACW,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO;IAOjG;;;;;;;;OAQG;aACa,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CACzE"}
+{"version":3,"file":"GeometryQuery.d.ts","sourceRoot":"","sources":["../../../src/curve/GeometryQuery.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAExI;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;AAE1I;;;;;GAKG;AACH,8BAAsB,aAAa;IACjC,0BAA0B;IAC1B,kBAAyB,gBAAgB,EAAE,qBAAqB,CAAC;IACjE,yDAAyD;IAClD,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAO9D,0FAA0F;aAC1E,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAChF;;;;OAIG;aACa,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAClE,4CAA4C;IACrC,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAE,MAAY,EAAE,EAAE,GAAE,MAAY,GAAG,OAAO;IAGnF,kCAAkC;aAClB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IACjF,qBAAqB;aACL,KAAK,IAAI,aAAa,GAAG,SAAS;IAClD;;;OAGG;IACH,IAAW,QAAQ,IAAI,aAAa,EAAE,GAAG,SAAS,CAEjD;IACD,gFAAgF;aAChE,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAClE;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAoBnD;;;;OAIG;WACW,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO;IAOjG;;;;;;;;OAQG;aACa,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CACzE"}

package/lib/cjs/curve/GeometryQuery.js

@@ -4,13 +4,13 @@ exports.GeometryQuery = void 0;
 const Range_1 = require("../geometry3d/Range");
 const Transform_1 = require("../geometry3d/Transform");
 /**
- * Queries to be supported by Curve, Surface, and Solid objects
+ * Queries to be supported by Curve, Surface, and Solid objects.
  * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh,
- * and bspline surfaces
+ * and bspline surfaces.
  * @public
  */
 class GeometryQuery {
-    /** Return the range of the entire GeometryQuery tree */
+    /** Return the range of the entire GeometryQuery tree. */
     range(transform, result) {
         if (result)
             result.setNull();
@@ -18,7 +18,7 @@ class GeometryQuery {
         this.extendRange(range, transform);
         return range;
     }
-    /** Try to move the geometry by dx,dy,dz */
+    /** Try to move the geometry by dx,dy,dz. */
     tryTranslateInPlace(dx, dy = 0.0, dz = 0.0) {
         return this.tryTransformInPlace(Transform_1.Transform.createTranslationXYZ(dx, dy, dz));
     }
@@ -26,13 +26,15 @@ class GeometryQuery {
      * Return GeometryQuery children for recursive queries.
      * * leaf classes do not need to implement.
      */
-    get children() { return undefined; }
+    get children() {
+        return undefined;
+    }
     /**
      * Test for exact structure and nearly identical geometry.
-     * *  Leaf classes must implement !!!
-     * *  base class implementation recurses through children.
-     * *  base implementation is complete for classes with children and no properties.
-     * *  classes with both children and properties must implement for properties, call super for children.
+     * *  Leaf classes must implement.
+     * *  Base class implementation recurses through children.
+     * *  Base implementation is complete for classes with children and no properties.
+     * *  Classes with both children and properties must implement for properties, call super for children.
      */
     isAlmostEqual(other) {
         if (this.isSameGeometryClass(other)) {
@@ -47,20 +49,19 @@ class GeometryQuery {
                 }
                 return true;
             }
-            else if (childrenA || childrenB) { // CurveCollections start with empty arrays for children.  So these null pointer cases are never reached.
-                return false; // plainly different .
+            else if (childrenA || childrenB) { // CurveCollections start with empty arrays for children so these null pointer cases are never reached.
+                return false; // plainly different
             }
             else {
-                // both children null. call it equal?   This class should probably have implemented.
-                return true;
+                return true; // both children null; call it equal
             }
         }
         return false;
     }
     /**
      * Apply instance method [[isAlmostEqual]] if both are defined.
-     * * both undefined returns true
-     * * single defined returns false
+     * * Both undefined returns true.
+     * * Single defined returns false.
      */
     static areAlmostEqual(a, b) {
         if (a instanceof GeometryQuery && b instanceof GeometryQuery)

package/lib/cjs/curve/GeometryQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeometryQuery.js","sourceRoot":"","sources":["../../../src/curve/GeometryQuery.ts"],"names":[],"mappings":";;;AASA,+CAA8C;AAC9C,uDAAoD;AAsCpD;;;;;GAKG;AACH,MAAsB,aAAa;IAGjC,wDAAwD;IACjD,KAAK,CAAC,SAAqB,EAAE,MAAgB;QAClD,IAAI,MAAM;YAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAO,CAAC,UAAU,EAAE,CAAC;QACrD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IASD,2CAA2C;IACpC,mBAAmB,CAAC,EAAU,EAAE,KAAa,GAAG,EAAE,KAAa,GAAG;QACvE,OAAO,IAAI,CAAC,mBAAmB,CAAC,qBAAS,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAKD;;;OAGG;IACH,IAAW,QAAQ,KAAkC,OAAO,SAAS,CAAC,CAAC,CAAC;IAGxE;;;;;;OAMG;IACI,aAAa,CAAC,KAAoB;QACvC,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;YAChC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;YACjC,IAAI,SAAS,IAAI,SAAS,EAAE;gBAC1B,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;oBACvC,OAAO,KAAK,CAAC;gBACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBACzC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;wBAAE,OAAO,KAAK,CAAC;iBAC7D;gBACD,OAAO,IAAI,CAAC;aACb;iBAAM,IAAI,SAAS,IAAI,SAAS,EAAE,EAAG,yGAAyG;gBAC7I,OAAO,KAAK,CAAC,CAAG,sBAAsB;aACvC;iBAAM;gBACL,oFAAoF;gBACpF,OAAO,IAAI,CAAC;aACb;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,CAA4B,EAAE,CAA4B;QACrF,IAAI,CAAC,YAAY,aAAa,IAAI,CAAC,YAAY,aAAa;YAC1D,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;CAWF;AAlFD,sCAkFC","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/** @packageDocumentation\r\n * @module Curve\r\n */\r\nimport { BSpline2dNd } from \"../bspline/BSplineSurface\";\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { Polyface } from \"../polyface/Polyface\";\r\nimport { SolidPrimitive } from \"../solid/SolidPrimitive\";\r\nimport { CoordinateXYZ } from \"./CoordinateXYZ\";\r\nimport { CurveCollection } from \"./CurveCollection\";\r\nimport { CurvePrimitive } from \"./CurvePrimitive\";\r\nimport { PointString3d } from \"./PointString3d\";\r\n\r\n/**\r\n * Describes the category of a [[GeometryQuery]], enabling type-switching like:\r\n * ```ts\r\n *   function processGeometryQuery(q: GeometryQuery): void {\r\n *     if (\"solid\" === q.geometryCategory)\r\n *       alert(\"Solid type = \" + q.solidPrimitiveType; // compiler knows q is an instance of SolidPrimitive\r\n *    // ...etc...\r\n * ```\r\n *\r\n * Each string maps to a particular subclass of [[GeometryQuery]]:\r\n *  - \"polyface\" => [[Polyface]]\r\n *  - \"curvePrimitive\" => [[CurvePrimitive]]\r\n *  - \"curveCollection\" => [[CurveCollection]]\r\n *  - \"solid\" => [[SolidPrimitive]]\r\n *  - \"point\" => [[CoordinateXYZ]]\r\n *  - \"pointCollection\" => [[PointString3d]]\r\n *  - \"bsurf\" => [[BSpline2dNd]]  (which is an intermediate class shared by [[BSplineSurface3d]] and [[BSplineSurface3dH]])\r\n *\r\n *  @see [[AnyGeometryQuery]]\r\n * @public\r\n */\r\nexport type GeometryQueryCategory = \"polyface\" | \"curvePrimitive\" | \"curveCollection\" | \"solid\" | \"point\" | \"pointCollection\" | \"bsurf\";\r\n\r\n/**\r\n * Union type for subclasses of [[GeometryQuery]]. Specific subclasses can be discriminated at compile- or run-time\r\n * using [[GeometryQuery.geometryCategory]].\r\n * @public\r\n */\r\nexport type AnyGeometryQuery = Polyface | CurvePrimitive | CurveCollection | SolidPrimitive | CoordinateXYZ | PointString3d | BSpline2dNd;\r\n\r\n/**\r\n * Queries to be supported by Curve, Surface, and Solid objects\r\n * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh,\r\n * and bspline surfaces\r\n * @public\r\n */\r\nexport abstract class GeometryQuery {\r\n  /** Type discriminator. */\r\n  public abstract readonly geometryCategory: GeometryQueryCategory;\r\n  /** Return the range of the entire GeometryQuery tree */\r\n  public range(transform?: Transform, result?: Range3d): Range3d {\r\n    if (result) result.setNull();\r\n    const range = result ? result : Range3d.createNull();\r\n    this.extendRange(range, transform);\r\n    return range;\r\n  }\r\n  /** Extend rangeToExtend by the range of this geometry multiplied by the transform */\r\n  public abstract extendRange(rangeToExtend: Range3d, transform?: Transform): void;\r\n  /**\r\n   * Attempt to transform in place.\r\n   * * LineSegment3d, Arc3d, LineString3d, BsplineCurve3d always succeed.\r\n   * * Some geometry types may fail if scaling is non-uniform.\r\n   */\r\n  public abstract tryTransformInPlace(transform: Transform): boolean;\r\n  /** Try to move the geometry by dx,dy,dz */\r\n  public tryTranslateInPlace(dx: number, dy: number = 0.0, dz: number = 0.0): boolean {\r\n    return this.tryTransformInPlace(Transform.createTranslationXYZ(dx, dy, dz));\r\n  }\r\n  /** Return a transformed clone. */\r\n  public abstract cloneTransformed(transform: Transform): GeometryQuery | undefined;\r\n  /** Return a clone */\r\n  public abstract clone(): GeometryQuery | undefined;\r\n  /**\r\n   * Return GeometryQuery children for recursive queries.\r\n   * * leaf classes do not need to implement.\r\n   */\r\n  public get children(): GeometryQuery[] | undefined { return undefined; }\r\n  /** Test if (other instanceof this.Type).  REQUIRED IN ALL CONCRETE CLASSES */\r\n  public abstract isSameGeometryClass(other: GeometryQuery): boolean;\r\n  /**\r\n   * Test for exact structure and nearly identical geometry.\r\n   * *  Leaf classes must implement !!!\r\n   * *  base class implementation recurses through children.\r\n   * *  base implementation is complete for classes with children and no properties.\r\n   * *  classes with both children and properties must implement for properties, call super for children.\r\n   */\r\n  public isAlmostEqual(other: GeometryQuery): boolean {\r\n    if (this.isSameGeometryClass(other)) {\r\n      const childrenA = this.children;\r\n      const childrenB = other.children;\r\n      if (childrenA && childrenB) {\r\n        if (childrenA.length !== childrenB.length)\r\n          return false;\r\n        for (let i = 0; i < childrenA.length; i++) {\r\n          if (!childrenA[i].isAlmostEqual(childrenB[i])) return false;\r\n        }\r\n        return true;\r\n      } else if (childrenA || childrenB) {  // CurveCollections start with empty arrays for children.  So these null pointer cases are never reached.\r\n        return false;   // plainly different .\r\n      } else {\r\n        // both children null. call it equal?   This class should probably have implemented.\r\n        return true;\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n  /**\r\n   * Apply instance method [[isAlmostEqual]] if both are defined.\r\n   * * both undefined returns true\r\n   * * single defined returns false\r\n   */\r\n  public static areAlmostEqual(a: GeometryQuery | undefined, b: GeometryQuery | undefined): boolean {\r\n    if (a instanceof GeometryQuery && b instanceof GeometryQuery)\r\n      return a.isAlmostEqual(b);\r\n    if ((a === undefined) && (b === undefined))\r\n      return true;\r\n    return false;\r\n  }\r\n  /**\r\n   * * \"double dispatch\" call pattern.\r\n   * * User code implements a `GeometryHandler` with specialized methods to handle `LineSegment3d`, `Arc3d` etc as\r\n   * relevant to its use case.\r\n   * * Each such `GeometryQuery` class implements this method as a one-line method containing the appropriate call\r\n   * such as `handler.handleLineSegment3d ()`\r\n   * * This allows each type-specific method to be called without a switch or `instanceof` test.\r\n   * @param handler handler to be called by the particular geometry class\r\n   */\r\n  public abstract dispatchToGeometryHandler(handler: GeometryHandler): any;\r\n}\r\n"]}
+{"version":3,"file":"GeometryQuery.js","sourceRoot":"","sources":["../../../src/curve/GeometryQuery.ts"],"names":[],"mappings":";;;AASA,+CAA8C;AAC9C,uDAAoD;AAsCpD;;;;;GAKG;AACH,MAAsB,aAAa;IAGjC,yDAAyD;IAClD,KAAK,CAAC,SAAqB,EAAE,MAAgB;QAClD,IAAI,MAAM;YACR,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAO,CAAC,UAAU,EAAE,CAAC;QACrD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IASD,4CAA4C;IACrC,mBAAmB,CAAC,EAAU,EAAE,KAAa,GAAG,EAAE,KAAa,GAAG;QACvE,OAAO,IAAI,CAAC,mBAAmB,CAAC,qBAAS,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAKD;;;OAGG;IACH,IAAW,QAAQ;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD;;;;;;OAMG;IACI,aAAa,CAAC,KAAoB;QACvC,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;YAChC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;YACjC,IAAI,SAAS,IAAI,SAAS,EAAE;gBAC1B,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;oBACvC,OAAO,KAAK,CAAC;gBACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBACzC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;wBAC3C,OAAO,KAAK,CAAC;iBAChB;gBACD,OAAO,IAAI,CAAC;aACb;iBAAM,IAAI,SAAS,IAAI,SAAS,EAAE,EAAE,uGAAuG;gBAC1I,OAAO,KAAK,CAAC,CAAC,oBAAoB;aACnC;iBAAM;gBACL,OAAO,IAAI,CAAC,CAAC,oCAAoC;aAClD;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,CAA4B,EAAE,CAA4B;QACrF,IAAI,CAAC,YAAY,aAAa,IAAI,CAAC,YAAY,aAAa;YAC1D,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;CAWF;AArFD,sCAqFC","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/** @packageDocumentation\r\n * @module Curve\r\n */\r\nimport { BSpline2dNd } from \"../bspline/BSplineSurface\";\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { Polyface } from \"../polyface/Polyface\";\r\nimport { SolidPrimitive } from \"../solid/SolidPrimitive\";\r\nimport { CoordinateXYZ } from \"./CoordinateXYZ\";\r\nimport { CurveCollection } from \"./CurveCollection\";\r\nimport { CurvePrimitive } from \"./CurvePrimitive\";\r\nimport { PointString3d } from \"./PointString3d\";\r\n\r\n/**\r\n * Describes the category of a [[GeometryQuery]], enabling type-switching like:\r\n * ```ts\r\n *   function processGeometryQuery(q: GeometryQuery): void {\r\n *     if (\"solid\" === q.geometryCategory)\r\n *       alert(\"Solid type = \" + q.solidPrimitiveType); // compiler knows q is an instance of SolidPrimitive\r\n *    // ...etc...\r\n * ```\r\n *\r\n * Each string maps to a particular subclass of [[GeometryQuery]]:\r\n *  - \"polyface\" => [[Polyface]]\r\n *  - \"curvePrimitive\" => [[CurvePrimitive]]\r\n *  - \"curveCollection\" => [[CurveCollection]]\r\n *  - \"solid\" => [[SolidPrimitive]]\r\n *  - \"point\" => [[CoordinateXYZ]]\r\n *  - \"pointCollection\" => [[PointString3d]]\r\n *  - \"bsurf\" => [[BSpline2dNd]] (which is an intermediate class shared by [[BSplineSurface3d]] and [[BSplineSurface3dH]])\r\n *\r\n *  @see [[AnyGeometryQuery]]\r\n * @public\r\n */\r\nexport type GeometryQueryCategory = \"polyface\" | \"curvePrimitive\" | \"curveCollection\" | \"solid\" | \"point\" | \"pointCollection\" | \"bsurf\";\r\n\r\n/**\r\n * Union type for subclasses of [[GeometryQuery]]. Specific subclasses can be discriminated at compile- or run-time\r\n * using [[GeometryQuery.geometryCategory]].\r\n * @public\r\n */\r\nexport type AnyGeometryQuery = Polyface | CurvePrimitive | CurveCollection | SolidPrimitive | CoordinateXYZ | PointString3d | BSpline2dNd;\r\n\r\n/**\r\n * Queries to be supported by Curve, Surface, and Solid objects.\r\n * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh,\r\n * and bspline surfaces.\r\n * @public\r\n */\r\nexport abstract class GeometryQuery {\r\n  /** Type discriminator. */\r\n  public abstract readonly geometryCategory: GeometryQueryCategory;\r\n  /** Return the range of the entire GeometryQuery tree. */\r\n  public range(transform?: Transform, result?: Range3d): Range3d {\r\n    if (result)\r\n      result.setNull();\r\n    const range = result ? result : Range3d.createNull();\r\n    this.extendRange(range, transform);\r\n    return range;\r\n  }\r\n  /** Extend `rangeToExtend` by the range of this geometry multiplied by the `transform`. */\r\n  public abstract extendRange(rangeToExtend: Range3d, transform?: Transform): void;\r\n  /**\r\n   * Attempt to transform in place.\r\n   * * LineSegment3d, Arc3d, LineString3d, BsplineCurve3d always succeed.\r\n   * * Some geometry types may fail if scaling is non-uniform.\r\n   */\r\n  public abstract tryTransformInPlace(transform: Transform): boolean;\r\n  /** Try to move the geometry by dx,dy,dz. */\r\n  public tryTranslateInPlace(dx: number, dy: number = 0.0, dz: number = 0.0): boolean {\r\n    return this.tryTransformInPlace(Transform.createTranslationXYZ(dx, dy, dz));\r\n  }\r\n  /** Return a transformed clone. */\r\n  public abstract cloneTransformed(transform: Transform): GeometryQuery | undefined;\r\n  /** Return a clone */\r\n  public abstract clone(): GeometryQuery | undefined;\r\n  /**\r\n   * Return GeometryQuery children for recursive queries.\r\n   * * leaf classes do not need to implement.\r\n   */\r\n  public get children(): GeometryQuery[] | undefined {\r\n    return undefined;\r\n  }\r\n  /** Test `if (other instanceof this.Type)`. REQUIRED IN ALL CONCRETE CLASSES. */\r\n  public abstract isSameGeometryClass(other: GeometryQuery): boolean;\r\n  /**\r\n   * Test for exact structure and nearly identical geometry.\r\n   * *  Leaf classes must implement.\r\n   * *  Base class implementation recurses through children.\r\n   * *  Base implementation is complete for classes with children and no properties.\r\n   * *  Classes with both children and properties must implement for properties, call super for children.\r\n   */\r\n  public isAlmostEqual(other: GeometryQuery): boolean {\r\n    if (this.isSameGeometryClass(other)) {\r\n      const childrenA = this.children;\r\n      const childrenB = other.children;\r\n      if (childrenA && childrenB) {\r\n        if (childrenA.length !== childrenB.length)\r\n          return false;\r\n        for (let i = 0; i < childrenA.length; i++) {\r\n          if (!childrenA[i].isAlmostEqual(childrenB[i]))\r\n            return false;\r\n        }\r\n        return true;\r\n      } else if (childrenA || childrenB) { // CurveCollections start with empty arrays for children so these null pointer cases are never reached.\r\n        return false; // plainly different\r\n      } else {\r\n        return true; // both children null; call it equal\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n  /**\r\n   * Apply instance method [[isAlmostEqual]] if both are defined.\r\n   * * Both undefined returns true.\r\n   * * Single defined returns false.\r\n   */\r\n  public static areAlmostEqual(a: GeometryQuery | undefined, b: GeometryQuery | undefined): boolean {\r\n    if (a instanceof GeometryQuery && b instanceof GeometryQuery)\r\n      return a.isAlmostEqual(b);\r\n    if ((a === undefined) && (b === undefined))\r\n      return true;\r\n    return false;\r\n  }\r\n  /**\r\n   * Double Dispatch call pattern.\r\n   * * User code implements a `GeometryHandler` with specialized methods to handle `LineSegment3d`, `Arc3d`, etc as\r\n   * relevant to its use case.\r\n   * * Each such `GeometryQuery` class implements this method as a one-line method containing the appropriate call\r\n   * such as `handler.handleLineSegment3d())`\r\n   * * This allows each type-specific method to be called without a switch or `instanceof` test.\r\n   * @param handler handler to be called by the particular geometry class\r\n   */\r\n  public abstract dispatchToGeometryHandler(handler: GeometryHandler): any;\r\n}\r\n"]}

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

@@ -21,36 +21,40 @@ export declare class PointString3d extends GeometryQuery implements BeJSONFuncti
     /** Test if `other` is a PointString3d */
     isSameGeometryClass(other: GeometryQuery): boolean;
     private _points;
-    /** return a clone of the points array. */
+    /** Return a clone of the points array. */
     get points(): Point3d[];
     private constructor();
     /** Clone and apply a transform. */
     cloneTransformed(transform: Transform): PointString3d;
+    /**
+     * Turn any array (possibly nested) into a "flat" array of objects that are not arrays. This allows processing
+     * the objects without recursion into nested arrays.
+     */
     private static flattenArray;
     /** Create a PointString3d from points. */
     static create(...points: any[]): PointString3d;
-    /** Add multiple points to the PointString3d */
+    /** Add multiple points to the PointString3d. */
     addPoints(...points: any[]): void;
-    /** Add a single point to the PointString3d */
+    /** Add a single point to the PointString3d. */
     addPoint(point: Point3d): void;
-    /** Remove the last point added to the PointString3d */
+    /** Remove the last point added to the PointString3d. */
     popPoint(): void;
-    /** Replace this PointString3d's point array by a clone of the array in `other` */
+    /** Replace this PointString3d's point array by a clone of the array in `other`. */
     setFrom(other: PointString3d): void;
-    /** Create from an array of Point3d */
+    /** Create from an array of Point3d. */
     static createPoints(points: Point3d[]): PointString3d;
-    /** Create a PointString3d from xyz coordinates packed in a Float64Array */
+    /** Create a PointString3d from xyz coordinates packed in a Float64Array. */
     static createFloat64Array(xyzData: Float64Array): PointString3d;
     /** Return a deep clone. */
     clone(): PointString3d;
-    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     setFromJSON(json?: any): void;
     /**
      * Convert an PointString3d to a JSON object.
-     * @return {*} [[x,y,z],...[x,y,z]]
+     * @return {*} e.g., `[[1,2,3], [4,5,6]]`.
      */
     toJSON(): XYZProps[];
-    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     static fromJSON(json?: any): PointString3d;
     /** Access a single point by index. */
     pointAt(i: number, result?: Point3d): Point3d | undefined;
@@ -58,7 +62,7 @@ export declare class PointString3d extends GeometryQuery implements BeJSONFuncti
     numPoints(): number;
     /** Reverse the point order */
     reverseInPlace(): void;
-    /** Return the number of points. */
+    /** Apply transform on points in place. */
     tryTransformInPlace(transform: Transform): boolean;
     /** Return the index and coordinates of the closest point to spacePoint. */
     closestPoint(spacePoint: Point3d): {
@@ -67,13 +71,13 @@ export declare class PointString3d extends GeometryQuery implements BeJSONFuncti
     };
     /** Return true if all points are in the given plane. */
     isInPlane(plane: Plane3dByOriginAndUnitNormal): boolean;
-    /** Extend a range to include the points in this PointString3d. */
+    /** Extend a range to include the points in this PointString3d (optionally transformed). */
     extendRange(rangeToExtend: Range3d, transform?: Transform): void;
     /** Return true if corresponding points are almost equal. */
     isAlmostEqual(other: GeometryQuery): boolean;
     /** Reduce to empty set of points. */
     clear(): void;
-    /** Second step of double dispatch:  call `handler.handlePointString(this)` */
+    /** Second step of double dispatch: call `handler.handlePointString(this)` */
     dispatchToGeometryHandler(handler: GeometryHandler): any;
 }
 //# sourceMappingURL=PointString3d.d.ts.map

package/lib/cjs/curve/PointString3d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PointString3d.d.ts","sourceRoot":"","sources":["../../../src/curve/PointString3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,aAAc,YAAW,eAAe;IACzE,wCAAwC;IACxC,SAAgB,gBAAgB,qBAAqB;IAErD,yCAAyC;IAClC,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IACzD,OAAO,CAAC,OAAO,CAAY;IAC3B,0CAA0C;IAC1C,IAAW,MAAM,IAAI,OAAO,EAAE,CAAyB;IACvD,OAAO;IAIP,mCAAmC;IAC5B,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa;IAK5D,OAAO,CAAC,MAAM,CAAC,YAAY;IAK3B,0CAA0C;WAC5B,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,aAAa;IAMrD,+CAA+C;IACxC,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE;IAOjC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAG9B,uDAAuD;IAChD,QAAQ;IAIf,kFAAkF;IAC3E,OAAO,CAAC,KAAK,EAAE,aAAa;IAGnC,sCAAsC;WACxB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa;IAK5D,2EAA2E;WAC7D,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAMtE,2BAA2B;IACpB,KAAK,IAAI,aAAa;IAK7B,2FAA2F;IACpF,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG;IAQ7B;;;OAGG;IACI,MAAM,IAAI,QAAQ,EAAE;IAK3B,0EAA0E;WAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,aAAa;IAGjD,sCAAsC;IAC/B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAOhE,mCAAmC;IAC5B,SAAS,IAAI,MAAM;IAE1B,8BAA8B;IACvB,cAAc,IAAI,IAAI;IAa7B,mCAAmC;IAC5B,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIzD,2EAA2E;IACpE,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE;IASzE,wDAAwD;IACjD,SAAS,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO;IAG9D,kEAAkE;IAC3D,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAGvE,4DAA4D;IAC5C,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAK5D,qCAAqC;IAC9B,KAAK;IACZ,8EAA8E;IACvE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CAIhE"}
+{"version":3,"file":"PointString3d.d.ts","sourceRoot":"","sources":["../../../src/curve/PointString3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,aAAc,YAAW,eAAe;IACzE,wCAAwC;IACxC,SAAgB,gBAAgB,qBAAqB;IACrD,yCAAyC;IAClC,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAGzD,OAAO,CAAC,OAAO,CAAY;IAC3B,0CAA0C;IAC1C,IAAW,MAAM,IAAI,OAAO,EAAE,CAE7B;IACD,OAAO;IAIP,mCAAmC;IAC5B,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa;IAK5D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAU3B,0CAA0C;WAC5B,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,aAAa;IAKrD,gDAAgD;IACzC,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE;IAOjC,+CAA+C;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAG9B,wDAAwD;IACjD,QAAQ;IAGf,mFAAmF;IAC5E,OAAO,CAAC,KAAK,EAAE,aAAa;IAGnC,uCAAuC;WACzB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa;IAK5D,4EAA4E;WAC9D,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAMtE,2BAA2B;IACpB,KAAK,IAAI,aAAa;IAK7B,4FAA4F;IACrF,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG;IAQ7B;;;OAGG;IACI,MAAM,IAAI,QAAQ,EAAE;IAM3B,2EAA2E;WAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,aAAa;IAKjD,sCAAsC;IAC/B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAUhE,mCAAmC;IAC5B,SAAS,IAAI,MAAM;IAG1B,8BAA8B;IACvB,cAAc,IAAI,IAAI;IAa7B,0CAA0C;IACnC,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIzD,2EAA2E;IACpE,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE;IASzE,wDAAwD;IACjD,SAAS,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO;IAG9D,2FAA2F;IACpF,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAGvE,4DAA4D;IAC5C,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAK5D,qCAAqC;IAC9B,KAAK;IAGZ,6EAA6E;IACtE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CAGhE"}

package/lib/cjs/curve/PointString3d.js

@@ -21,9 +21,13 @@ const GeometryQuery_1 = require("./GeometryQuery");
  */
 class PointString3d extends GeometryQuery_1.GeometryQuery {
     /** Test if `other` is a PointString3d */
-    isSameGeometryClass(other) { return other instanceof PointString3d; }
-    /** return a clone of the points array. */
-    get points() { return this._points; }
+    isSameGeometryClass(other) {
+        return other instanceof PointString3d;
+    }
+    /** Return a clone of the points array. */
+    get points() {
+        return this._points;
+    }
     constructor() {
         super();
         /** String name for schema properties */
@@ -33,11 +37,18 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
     /** Clone and apply a transform. */
     cloneTransformed(transform) {
         const c = this.clone();
-        c.tryTransformInPlace(transform);
+        c.tryTransformInPlace(transform); // we know tryTransformInPlace succeeds
         return c;
     }
+    /**
+     * Turn any array (possibly nested) into a "flat" array of objects that are not arrays. This allows processing
+     * the objects without recursion into nested arrays.
+     */
     static flattenArray(arr) {
-        return arr.reduce((flat, toFlatten) => {
+        return arr.reduce(
+        // a callback function to execute for each element in the array. Its return value becomes
+        // the value of the "flat" parameter on the next invocation of the callback function.
+        (flat, toFlatten) => {
             return flat.concat(Array.isArray(toFlatten) ? PointString3d.flattenArray(toFlatten) : toFlatten);
         }, []);
     }
@@ -47,7 +58,7 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
         result.addPoints(points);
         return result;
     }
-    /** Add multiple points to the PointString3d */
+    /** Add multiple points to the PointString3d. */
     addPoints(...points) {
         const toAdd = PointString3d.flattenArray(points);
         for (const p of toAdd) {
@@ -55,25 +66,25 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
                 this._points.push(p);
         }
     }
-    /** Add a single point to the PointString3d */
+    /** Add a single point to the PointString3d. */
     addPoint(point) {
         this._points.push(point);
     }
-    /** Remove the last point added to the PointString3d */
+    /** Remove the last point added to the PointString3d. */
     popPoint() {
         this._points.pop();
     }
-    /** Replace this PointString3d's point array by a clone of the array in `other` */
+    /** Replace this PointString3d's point array by a clone of the array in `other`. */
     setFrom(other) {
         this._points = PointHelpers_1.Point3dArray.clonePoint3dArray(other._points);
     }
-    /** Create from an array of Point3d */
+    /** Create from an array of Point3d. */
     static createPoints(points) {
         const ps = new PointString3d();
         ps._points = PointHelpers_1.Point3dArray.clonePoint3dArray(points);
         return ps;
     }
-    /** Create a PointString3d from xyz coordinates packed in a Float64Array */
+    /** Create a PointString3d from xyz coordinates packed in a Float64Array. */
     static createFloat64Array(xyzData) {
         const ps = new PointString3d();
         for (let i = 0; i + 3 <= xyzData.length; i += 3)
@@ -86,7 +97,7 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
         retVal.setFrom(this);
         return retVal;
     }
-    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     setFromJSON(json) {
         this._points.length = 0;
         if (Array.isArray(json)) {
@@ -97,7 +108,7 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
     }
     /**
      * Convert an PointString3d to a JSON object.
-     * @return {*} [[x,y,z],...[x,y,z]]
+     * @return {*} e.g., `[[1,2,3], [4,5,6]]`.
      */
     toJSON() {
         const value = [];
@@ -105,7 +116,7 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
             value.push(p.toJSON());
         return value;
     }
-    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     static fromJSON(json) {
         const ps = new PointString3d();
         ps.setFromJSON(json);
@@ -123,14 +134,16 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
         return undefined;
     }
     /** Return the number of points. */
-    numPoints() { return this._points.length; }
+    numPoints() {
+        return this._points.length;
+    }
     /** Reverse the point order */
     reverseInPlace() {
         if (this._points.length >= 2) {
             let i0 = 0;
             let i1 = this._points.length - 1;
             while (i0 < i1) {
-                const a = this._points[i0];
+                const a = this._points[i1];
                 this._points[i1] = this._points[i0];
                 this._points[i0] = a;
                 i0++;
@@ -138,7 +151,7 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
             }
         }
     }
-    /** Return the number of points. */
+    /** Apply transform on points in place. */
     tryTransformInPlace(transform) {
         transform.multiplyPoint3dArrayInPlace(this._points);
         return true;
@@ -157,7 +170,7 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
     isInPlane(plane) {
         return PointHelpers_1.Point3dArray.isCloseToPlane(this._points, plane, Geometry_1.Geometry.smallMetricDistance);
     }
-    /** Extend a range to include the points in this PointString3d. */
+    /** Extend a range to include the points in this PointString3d (optionally transformed). */
     extendRange(rangeToExtend, transform) {
         rangeToExtend.extendArray(this._points, transform);
     }
@@ -168,8 +181,10 @@ class PointString3d extends GeometryQuery_1.GeometryQuery {
         return PointHelpers_1.Point3dArray.isAlmostEqual(this._points, other._points);
     }
     /** Reduce to empty set of points. */
-    clear() { this._points.length = 0; }
-    /** Second step of double dispatch:  call `handler.handlePointString(this)` */
+    clear() {
+        this._points.length = 0;
+    }
+    /** Second step of double dispatch: call `handler.handlePointString(this)` */
     dispatchToGeometryHandler(handler) {
         return handler.handlePointString3d(this);
     }