@thi.ng/geom 6.0.6 → 6.0.8

package/api/quadratic.js

@@ -1,29 +1,32 @@
 import { __copyShape } from "../internal/copy.js";
 import { __ensureNumVerts } from "../internal/pclike.js";
 import { APC } from "./apc.js";
-export class Quadratic extends APC {
-    constructor(points, attribs) {
-        super(points, attribs);
-        __ensureNumVerts(this.points.length, 3);
-    }
-    get type() {
-        return "quadratic";
-    }
-    copy() {
-        return __copyShape(Quadratic, this);
-    }
-    withAttribs(attribs) {
-        return new Quadratic(this.points, attribs);
-    }
-    toHiccup() {
-        return [
-            "path",
-            this.attribs,
-            [["M", this.points[0]], ...this.toHiccupPathSegments()],
-        ];
-    }
-    toHiccupPathSegments() {
-        const pts = this.points;
-        return [["Q", pts[1], pts[2]]];
-    }
+class Quadratic extends APC {
+  constructor(points, attribs) {
+    super(points, attribs);
+    __ensureNumVerts(this.points.length, 3);
+  }
+  get type() {
+    return "quadratic";
+  }
+  copy() {
+    return __copyShape(Quadratic, this);
+  }
+  withAttribs(attribs) {
+    return new Quadratic(this.points, attribs);
+  }
+  toHiccup() {
+    return [
+      "path",
+      this.attribs,
+      [["M", this.points[0]], ...this.toHiccupPathSegments()]
+    ];
+  }
+  toHiccupPathSegments() {
+    const pts = this.points;
+    return [["Q", pts[1], pts[2]]];
+  }
 }
+export {
+  Quadratic
+};

package/api/ray.js

@@ -1,30 +1,34 @@
 import { maddN2 } from "@thi.ng/vectors/maddn";
 import { set } from "@thi.ng/vectors/set";
 import { __copyAttribs } from "../internal/copy.js";
-export class Ray {
-    pos;
-    dir;
-    attribs;
-    constructor(pos, dir, attribs) {
-        this.pos = pos;
-        this.dir = dir;
-        this.attribs = attribs;
-    }
-    get type() {
-        return "ray";
-    }
-    copy() {
-        return new Ray(set([], this.pos), set([], this.dir), __copyAttribs(this));
-    }
-    withAttribs(attribs) {
-        return new Ray(this.pos, this.dir, attribs);
-    }
-    toHiccup() {
-        return [
-            "line",
-            this.attribs,
-            this.pos,
-            maddN2([], this.dir, 1e6, this.pos),
-        ];
-    }
+class Ray {
+  constructor(pos, dir, attribs) {
+    this.pos = pos;
+    this.dir = dir;
+    this.attribs = attribs;
+  }
+  get type() {
+    return "ray";
+  }
+  copy() {
+    return new Ray(
+      set([], this.pos),
+      set([], this.dir),
+      __copyAttribs(this)
+    );
+  }
+  withAttribs(attribs) {
+    return new Ray(this.pos, this.dir, attribs);
+  }
+  toHiccup() {
+    return [
+      "line",
+      this.attribs,
+      this.pos,
+      maddN2([], this.dir, 1e6, this.pos)
+    ];
+  }
 }
+export {
+  Ray
+};

package/api/rect.js

@@ -6,33 +6,38 @@ import { set2 } from "@thi.ng/vectors/set";
 import { subN2 } from "@thi.ng/vectors/subn";
 import { __asVec } from "../internal/args.js";
 import { __copyAttribs } from "../internal/copy.js";
-export class Rect {
-    pos;
-    attribs;
-    size;
-    constructor(pos = [0, 0], size = 1, attribs) {
-        this.pos = pos;
-        this.attribs = attribs;
-        this.size = __asVec(size);
-    }
-    get type() {
-        return "rect";
-    }
-    copy() {
-        return new Rect(set2([], this.pos), set2([], this.size), __copyAttribs(this));
-    }
-    withAttribs(attribs) {
-        return new Rect(this.pos, this.size, attribs);
-    }
-    max() {
-        return add2([], this.pos, this.size);
-    }
-    offset(offset) {
-        subN2(null, this.pos, offset);
-        max2(null, addN2(null, this.size, offset * 2), ZERO2);
-        return this;
-    }
-    toHiccup() {
-        return ["rect", this.attribs, this.pos, this.size[0], this.size[1]];
-    }
+class Rect {
+  constructor(pos = [0, 0], size = 1, attribs) {
+    this.pos = pos;
+    this.attribs = attribs;
+    this.size = __asVec(size);
+  }
+  size;
+  get type() {
+    return "rect";
+  }
+  copy() {
+    return new Rect(
+      set2([], this.pos),
+      set2([], this.size),
+      __copyAttribs(this)
+    );
+  }
+  withAttribs(attribs) {
+    return new Rect(this.pos, this.size, attribs);
+  }
+  max() {
+    return add2([], this.pos, this.size);
+  }
+  offset(offset) {
+    subN2(null, this.pos, offset);
+    max2(null, addN2(null, this.size, offset * 2), ZERO2);
+    return this;
+  }
+  toHiccup() {
+    return ["rect", this.attribs, this.pos, this.size[0], this.size[1]];
+  }
 }
+export {
+  Rect
+};

package/api/sphere.js

@@ -1,24 +1,24 @@
 import { set3 } from "@thi.ng/vectors/set";
 import { __copyAttribs } from "../internal/copy.js";
-export class Sphere {
-    pos;
-    r;
-    attribs;
-    constructor(pos = [0, 0, 0], r = 1, attribs) {
-        this.pos = pos;
-        this.r = r;
-        this.attribs = attribs;
-    }
-    get type() {
-        return "sphere";
-    }
-    copy() {
-        return new Sphere(set3([], this.pos), this.r, __copyAttribs(this));
-    }
-    withAttribs(attribs) {
-        return new Sphere(this.pos, this.r, attribs);
-    }
-    toHiccup() {
-        return ["sphere", this.attribs, this.pos, this.r];
-    }
+class Sphere {
+  constructor(pos = [0, 0, 0], r = 1, attribs) {
+    this.pos = pos;
+    this.r = r;
+    this.attribs = attribs;
+  }
+  get type() {
+    return "sphere";
+  }
+  copy() {
+    return new Sphere(set3([], this.pos), this.r, __copyAttribs(this));
+  }
+  withAttribs(attribs) {
+    return new Sphere(this.pos, this.r, attribs);
+  }
+  toHiccup() {
+    return ["sphere", this.attribs, this.pos, this.r];
+  }
 }
+export {
+  Sphere
+};

package/api/text.js

@@ -1,31 +1,24 @@
 import { set } from "@thi.ng/vectors/set";
 import { __copyAttribs } from "../internal/copy.js";
-/**
- * Basic stub for text elements. Currently, only a minimal set of geometry
- * operations are implemented for this type, however this type implements
- * [`IToHiccup`](https://docs.thi.ng/umbrella/api/interfaces/IToHiccup.html) and
- * so is useful as wrapper for inclusion of text elements in {@link Group}s with
- * other shape types.
- */
-export class Text {
-    pos;
-    body;
-    attribs;
-    constructor(pos, body, attribs) {
-        this.pos = pos;
-        this.body = body;
-        this.attribs = attribs;
-    }
-    get type() {
-        return "text";
-    }
-    copy() {
-        return new Text(set([], this.pos), this.body, __copyAttribs(this));
-    }
-    withAttribs(attribs) {
-        return new Text(this.pos, this.body, attribs);
-    }
-    toHiccup() {
-        return ["text", this.attribs, this.pos, this.body];
-    }
+class Text {
+  constructor(pos, body, attribs) {
+    this.pos = pos;
+    this.body = body;
+    this.attribs = attribs;
+  }
+  get type() {
+    return "text";
+  }
+  copy() {
+    return new Text(set([], this.pos), this.body, __copyAttribs(this));
+  }
+  withAttribs(attribs) {
+    return new Text(this.pos, this.body, attribs);
+  }
+  toHiccup() {
+    return ["text", this.attribs, this.pos, this.body];
+  }
 }
+export {
+  Text
+};

package/api/triangle.js

@@ -1,21 +1,24 @@
 import { __copyShape } from "../internal/copy.js";
 import { __ensureNumVerts } from "../internal/pclike.js";
 import { APC } from "./apc.js";
-export class Triangle extends APC {
-    constructor(points, attribs) {
-        super(points, attribs);
-        __ensureNumVerts(this.points.length, 3);
-    }
-    get type() {
-        return "tri";
-    }
-    copy() {
-        return __copyShape(Triangle, this);
-    }
-    withAttribs(attribs) {
-        return new Triangle(this.points, attribs);
-    }
-    toHiccup() {
-        return ["polygon", this.attribs, this.points];
-    }
+class Triangle extends APC {
+  constructor(points, attribs) {
+    super(points, attribs);
+    __ensureNumVerts(this.points.length, 3);
+  }
+  get type() {
+    return "tri";
+  }
+  copy() {
+    return __copyShape(Triangle, this);
+  }
+  withAttribs(attribs) {
+    return new Triangle(this.points, attribs);
+  }
+  toHiccup() {
+    return ["polygon", this.attribs, this.points];
+  }
 }
+export {
+  Triangle
+};

package/apply-transforms.js

@@ -6,55 +6,35 @@ import { scale } from "./scale.js";
 import { transform } from "./transform.js";
 import { translate } from "./translate.js";
 const TX_ATTRIBS = ["transform", "translate", "rotate", "scale"];
-/** @internal */
 const __apply = ($) => {
-    let attribs = $.attribs;
-    if (!attribs)
-        return $;
-    const { transform: tx, translate: t, rotate: r, scale: s } = attribs;
-    if (tx)
-        return transform($.withAttribs(withoutKeysObj(attribs, TX_ATTRIBS)), tx);
-    if (!(t || r || s))
-        return $;
-    $ = $.withAttribs(withoutKeysObj(attribs, TX_ATTRIBS));
-    if (r)
-        $ = rotate($, r);
-    if (s)
-        $ = scale($, s);
-    if (t)
-        $ = translate($, t);
+  let attribs = $.attribs;
+  if (!attribs)
     return $;
+  const { transform: tx, translate: t, rotate: r, scale: s } = attribs;
+  if (tx)
+    return transform(
+      $.withAttribs(withoutKeysObj(attribs, TX_ATTRIBS)),
+      tx
+    );
+  if (!(t || r || s))
+    return $;
+  $ = $.withAttribs(withoutKeysObj(attribs, TX_ATTRIBS));
+  if (r)
+    $ = rotate($, r);
+  if (s)
+    $ = scale($, s);
+  if (t)
+    $ = translate($, t);
+  return $;
 };
-/**
- * Applies any spatial transformation attributes defined (if any) for the given
- * shape. If no such attributes exist, the original shape is returned as is.
- *
- * @remarks
- * The following attributes are considered:
- *
- * - transform: A 2x3 (for 2D) or 4x4 (for 3D) transformation matrix
- * - translate: Translation/offset vector
- * - scale: A scale factor (scalar or vector)
- * - rotate: Rotation angle (in radians)
- *
- * If the `transform` attrib is given, the others will be ignored. If any of the
- * other 3 attribs is provided, the order of application is: rotate, scale,
- * translate. Any of these relevant attributes will be removed from the
- * transformed shapes to ensure idempotent behavior.
- *
- * For (@link group} shapes, the children are processed in depth-first order
- * with any transformations to the group itself applied last.
- *
- * Note: Where possible, this function delegates to {@link rotate},
- * {@link scale}, {@link translate} to realize individual/partial transformation
- * aspects to increase the likelihodd of retaining original shape types. E.g.
- * uniformly scaling a circle with a scalar factor retains a circle, but scaling
- * non-uniformly will convert it to an ellipse... Similarly, rotating a rect
- * will convert it to a quad etc.
- *
- * @param shape
- */
-export const applyTransforms = defmulti(__dispatch, {}, {
+const applyTransforms = defmulti(
+  __dispatch,
+  {},
+  {
     [DEFAULT]: __apply,
-    group: ($) => __apply($.copyTransformed((x) => applyTransforms(x))),
-});
+    group: ($) => __apply($.copyTransformed((x) => applyTransforms(x)))
+  }
+);
+export {
+  applyTransforms
+};

package/arc-length.js

@@ -3,40 +3,27 @@ import { perimeter } from "@thi.ng/geom-poly-utils/perimeter";
 import { PI, TAU } from "@thi.ng/math/api";
 import { dist } from "@thi.ng/vectors/dist";
 import { __dispatch } from "./internal/dispatch.js";
-/**
- * Returns the arc length / perimeter / circumference of the given
- * shape. For groups calls {@link arcLength} for each child and returns the
- * sum of results.
- *
- * Implemented for:
- *
- * - {@link Circle}
- * - {@link Ellipse}
- * - {@link Group} (total sum of child circumferences)
- * - {@link Line}
- * - {@link Polygon}
- * - {@link Polyline}
- * - {@link Quad}
- * - {@link Rect}
- * - {@link Triangle}
- *
- * @param shape
- */
-export const arcLength = defmulti(__dispatch, {
+const arcLength = defmulti(
+  __dispatch,
+  {
     quad: "poly",
-    tri: "poly",
-}, {
+    tri: "poly"
+  },
+  {
     circle: ($) => TAU * $.r,
-    ellipse: ({ r: [a, b] }) => 
-    // Ramanujan approximation
-    // https://www.mathsisfun.com/geometry/ellipse-perimeter.html
-    PI * (3 * (a + b) - Math.sqrt((3 * a + b) * (3 * b + a))),
+    ellipse: ({ r: [a, b] }) => (
+      // Ramanujan approximation
+      // https://www.mathsisfun.com/geometry/ellipse-perimeter.html
+      PI * (3 * (a + b) - Math.sqrt((3 * a + b) * (3 * b + a)))
+    ),
     group: ({ children }) => children.reduce((sum, $) => sum + arcLength($), 0),
     line: ({ points }) => dist(points[0], points[1]),
     poly: ({ points }) => perimeter(points, points.length, true),
     polyline: ({ points }) => perimeter(points, points.length),
     rect: ({ size: [w, h] }) => 2 * (w + h),
-    tri: ({ points }) => dist(points[0], points[1]) +
-        dist(points[1], points[2]) +
-        dist(points[2], points[0]),
-});
+    tri: ({ points }) => dist(points[0], points[1]) + dist(points[1], points[2]) + dist(points[2], points[0])
+  }
+);
+export {
+  arcLength
+};

package/arc.js

@@ -1,10 +1,21 @@
 import { isNumber } from "@thi.ng/checks/is-number";
 import { fromEndPoints } from "@thi.ng/geom-arc/from-endpoints";
 import { Arc } from "./api/arc.js";
-export const arc = (pos, r, axis, start, end, xl = false, clockwise = false) => new Arc(pos, isNumber(r) ? [r, r] : r, axis, start, end, xl, clockwise);
-export const arcFrom2Points = (a, b, radii, axis = 0, xl = false, cw = false, attribs) => {
-    const res = fromEndPoints(a, b, radii, axis, xl, cw);
-    return res
-        ? new Arc(res.center, res.r, res.axis, res.start, res.end, res.xl, res.cw, attribs)
-        : undefined;
+const arc = (pos, r, axis, start, end, xl = false, clockwise = false) => new Arc(pos, isNumber(r) ? [r, r] : r, axis, start, end, xl, clockwise);
+const arcFrom2Points = (a, b, radii, axis = 0, xl = false, cw = false, attribs) => {
+  const res = fromEndPoints(a, b, radii, axis, xl, cw);
+  return res ? new Arc(
+    res.center,
+    res.r,
+    res.axis,
+    res.start,
+    res.end,
+    res.xl,
+    res.cw,
+    attribs
+  ) : void 0;
+};
+export {
+  arc,
+  arcFrom2Points
 };

package/area.js

@@ -4,59 +4,33 @@ import { PI } from "@thi.ng/math/api";
 import { signedArea2 } from "@thi.ng/vectors/signed-area";
 import { asPolygon } from "./as-polygon.js";
 import { __dispatch } from "./internal/dispatch.js";
-/**
- * Computes the possibly signed (unsigned by default) surface area of given
- * `shape`. For groups calls itself for each child and returns sum of unsigned
- * areas.
- *
- * @remarks
- * In general, for polygons and triangles, the sign of the result can be used as
- * indication of the shapes orientation (clockwise / counterclockwise).
- *
- * For curves, lines, point clouds and rays the function returns 0.
- *
- * Currently implemented for:
- *
- * - {@link AABB}
- * - {@link Circle}
- * - {@link Cubic}
- * - {@link Ellipse}
- * - {@link Group}
- * - {@link Line}
- * - {@link Path} (closed only & via poly conversion)
- * - {@link Plane}
- * - {@link Points}
- * - {@link Polygon}
- * - {@link Polyline}
- * - {@link Quad}
- * - {@link Quadratic}
- * - {@link Ray}
- * - {@link Rect}
- * - {@link Sphere}
- * - {@link Triangle}
- *
- * @param shape - shape to operate on
- * @param signed - true, if signed area
- */
-export const area = defmulti(__dispatch, { quad: "poly" }, {
+const area = defmulti(
+  __dispatch,
+  { quad: "poly" },
+  {
     aabb: ({ size: [w, h, d] }) => 2 * (w * h + w * d + h * d),
-    arc: 
-    // http://cut-the-knot.org/Generalization/Cavalieri2.shtml
-    ($) => 0.5 * Math.abs($.start - $.end) * $.r[0] * $.r[1],
+    arc: (
+      // http://cut-the-knot.org/Generalization/Cavalieri2.shtml
+      ($) => 0.5 * Math.abs($.start - $.end) * $.r[0] * $.r[1]
+    ),
     circle: ($) => PI * $.r ** 2,
     ellipse: ($) => PI * $.r[0] * $.r[1],
     group: ({ children }) => children.reduce((sum, $) => sum + area($, false), 0),
-    path: ($) => ($.closed ? area(asPolygon($)) : 0),
+    path: ($) => $.closed ? area(asPolygon($)) : 0,
     plane: () => Infinity,
     poly: ($, signed) => {
-        const area = polyArea2($.points);
-        return signed ? area : Math.abs(area);
+      const area2 = polyArea2($.points);
+      return signed ? area2 : Math.abs(area2);
     },
     rect: ($) => $.size[0] * $.size[1],
     sphere: ($) => 4 * PI * $.r ** 2,
     tri: ($, signed) => {
-        const area = 0.5 * signedArea2(...$.points);
-        return signed ? area : Math.abs(area);
+      const area2 = 0.5 * signedArea2(...$.points);
+      return signed ? area2 : Math.abs(area2);
     },
-    [DEFAULT]: () => 0,
-});
+    [DEFAULT]: () => 0
+  }
+);
+export {
+  area
+};