@thi.ng/geom 6.0.6 → 6.0.8

package/transform.js

@@ -14,64 +14,37 @@ import { Triangle } from "./api/triangle.js";
 import { asPath } from "./as-path.js";
 import { __copyAttribs } from "./internal/copy.js";
 import { __dispatch } from "./internal/dispatch.js";
-import { __transformedShape as tx, __transformedShape3 as tx3, } from "./internal/transform.js";
+import {
+  __transformedShape as tx,
+  __transformedShape3 as tx3
+} from "./internal/transform.js";
 import { vertices } from "./vertices.js";
-/**
- * Transforms given shape with provided matrix.
- *
- * @remarks
- * A 2x3 transform matrix is assumed for 2D shapes and 4x4 matrix for 3D shapes.
- * Some shape types will be automatically converted to other types prior to
- * transformation because they cannot be reliably represented in their original
- * type anymore, this includes:
- *
- * - {@link Arc} => {@link Path} (cubics)
- * - {@link Circle} => {@link Path} (cubics)
- * - {@link Ellipse} => {@link Path} (cubics)
- * - {@link Rect} => {@link Quad}
- *
- * Currently implemented for:
- *
- * - {@link Arc}
- * - {@link Circle}
- * - {@link Cubic}
- * - {@link Ellipse}
- * - {@link Group}
- * - {@link Line}
- * - {@link Path}
- * - {@link Points}
- * - {@link Points3}
- * - {@link Polygon}
- * - {@link Polyline}
- * - {@link Quad}
- * - {@link Quadratic}
- * - {@link Ray}
- * - {@link Rect}
- * - {@link Text}
- * - {@link Triangle}
- *
- * @param shape
- * @param mat
- */
-export const transform = defmulti(__dispatch, {
+const transform = defmulti(
+  __dispatch,
+  {
     circle: "arc",
-    ellipse: "circle",
-}, {
+    ellipse: "circle"
+  },
+  {
     arc: ($, mat) => transform(asPath($), mat),
     cubic: tx(Cubic),
     group: ($, mat) => $.copyTransformed((x) => transform(x, mat)),
     line: tx(Line),
-    path: ($, mat) => new Path([
-        ...map((s) => s.type === "m"
-            ? {
-                type: s.type,
-                point: mulV([], mat, s.point),
-            }
-            : {
-                type: s.type,
-                geo: transform(s.geo, mat),
-            }, $.segments),
-    ], __copyAttribs($)),
+    path: ($, mat) => new Path(
+      [
+        ...map(
+          (s) => s.type === "m" ? {
+            type: s.type,
+            point: mulV([], mat, s.point)
+          } : {
+            type: s.type,
+            geo: transform(s.geo, mat)
+          },
+          $.segments
+        )
+      ],
+      __copyAttribs($)
+    ),
     points: tx(Points),
     points3: tx3(Points3),
     poly: tx(Polygon),
@@ -80,5 +53,9 @@ export const transform = defmulti(__dispatch, {
     quadratic: tx(Quadratic),
     rect: ($, mat) => transform(new Quad(vertices($), __copyAttribs($)), mat),
     text: ($, mat) => new Text(mulV([], mat, $.pos), $.body, __copyAttribs($)),
-    tri: tx(Triangle),
-});
+    tri: tx(Triangle)
+  }
+);
+export {
+  transform
+};

package/translate.js

@@ -20,56 +20,41 @@ import { Triangle } from "./api/triangle.js";
 import { __copyAttribs } from "./internal/copy.js";
 import { __dispatch } from "./internal/dispatch.js";
 import { __translatedShape as tx } from "./internal/translate.js";
-/**
- * Translates given shape by given `offset` vector.
- *
- * @remarks
- * Currently implemented for:
- *
- * - {@link AABB}
- * - {@link Arc}
- * - {@link Circle}
- * - {@link Cubic}
- * - {@link Ellipse}
- * - {@link Group}
- * - {@link Line}
- * - {@link Path}
- * - {@link Points}
- * - {@link Points3}
- * - {@link Polygon}
- * - {@link Polyline}
- * - {@link Quad}
- * - {@link Quadratic}
- * - {@link Ray}
- * - {@link Rect}
- * - {@link Sphere}
- * - {@link Text}
- * - {@link Triangle}
- *
- * @param shape
- * @param offset
- */
-export const translate = defmulti(__dispatch, {}, {
-    aabb: ($, delta) => new AABB(add3([], $.pos, delta), set3([], $.size), __copyAttribs($)),
+const translate = defmulti(
+  __dispatch,
+  {},
+  {
+    aabb: ($, delta) => new AABB(
+      add3([], $.pos, delta),
+      set3([], $.size),
+      __copyAttribs($)
+    ),
     arc: ($, delta) => {
-        const a = $.copy();
-        add2(null, a.pos, delta);
-        return a;
+      const a = $.copy();
+      add2(null, a.pos, delta);
+      return a;
     },
     circle: ($, delta) => new Circle(add2([], $.pos, delta), $.r, __copyAttribs($)),
     cubic: tx(Cubic),
-    ellipse: ($, delta) => new Ellipse(add2([], $.pos, delta), set2([], $.r), __copyAttribs($)),
+    ellipse: ($, delta) => new Ellipse(
+      add2([], $.pos, delta),
+      set2([], $.r),
+      __copyAttribs($)
+    ),
     group: ($, delta) => $.copyTransformed((x) => translate(x, delta)),
     line: tx(Line),
-    path: ($, delta) => new Path($.segments.map((s) => s.geo
-        ? {
-            type: s.type,
-            geo: translate(s.geo, delta),
+    path: ($, delta) => new Path(
+      $.segments.map(
+        (s) => s.geo ? {
+          type: s.type,
+          geo: translate(s.geo, delta)
+        } : {
+          type: s.type,
+          point: add2([], s.point, delta)
         }
-        : {
-            type: s.type,
-            point: add2([], s.point, delta),
-        }), __copyAttribs($)),
+      ),
+      __copyAttribs($)
+    ),
     points: tx(Points),
     points3: tx(Points3),
     poly: tx(Polygon),
@@ -77,8 +62,16 @@ export const translate = defmulti(__dispatch, {}, {
     quad: tx(Quad),
     quadratic: tx(Quadratic),
     ray: ($, delta) => new Ray(add2([], $.pos, delta), $.dir, __copyAttribs($)),
-    rect: ($, delta) => new Rect(add2([], $.pos, delta), set2([], $.size), __copyAttribs($)),
+    rect: ($, delta) => new Rect(
+      add2([], $.pos, delta),
+      set2([], $.size),
+      __copyAttribs($)
+    ),
     sphere: ($, delta) => new Sphere(add3([], $.pos, delta), $.r, __copyAttribs($)),
     text: ($, delta) => new Text(add2([], $.pos, delta), $.body, __copyAttribs($)),
-    tri: tx(Triangle),
-});
+    tri: tx(Triangle)
+  }
+);
+export {
+  translate
+};

package/triangle.js

@@ -1,7 +1,11 @@
 import { equilateralTriangle2 } from "@thi.ng/geom-poly-utils/equilateral";
 import { Triangle } from "./api/triangle.js";
 import { __pclike } from "./internal/pclike.js";
-export function triangle(...args) {
-    return __pclike(Triangle, args);
+function triangle(...args) {
+  return __pclike(Triangle, args);
 }
-export const equilateralTriangle = (a, b, attribs) => new Triangle(equilateralTriangle2(a, b), attribs);
+const equilateralTriangle = (a, b, attribs) => new Triangle(equilateralTriangle2(a, b), attribs);
+export {
+  equilateralTriangle,
+  triangle
+};

package/union.js

@@ -3,21 +3,18 @@ import { AABB } from "./api/aabb.js";
 import { Rect } from "./api/rect.js";
 import { __unionBounds } from "./internal/bounds.js";
 import { __dispatch } from "./internal/dispatch.js";
-/**
- * Computes shape "union" of given 2 shapes.
- *
- * @remarks
- * Currently only implemented for {@link AABB} and {@link Rect} to compute union
- * bounding boxes.
- *
- * @param a
- * @param b
- */
-export const union = defmulti(__dispatch, {}, {
+const union = defmulti(
+  __dispatch,
+  {},
+  {
     aabb: (a, b) => [
-        new AABB(...__unionBounds(a.pos, a.size, b.pos, b.size)),
+      new AABB(...__unionBounds(a.pos, a.size, b.pos, b.size))
     ],
     rect: (a, b) => [
-        new Rect(...__unionBounds(a.pos, a.size, b.pos, b.size)),
-    ],
-});
+      new Rect(...__unionBounds(a.pos, a.size, b.pos, b.size))
+    ]
+  }
+);
+export {
+  union
+};

package/unmap-point.js

@@ -2,29 +2,25 @@ import { defmulti } from "@thi.ng/defmulti/defmulti";
 import { madd } from "@thi.ng/vectors/madd";
 import { mixBilinear } from "@thi.ng/vectors/mix-bilinear";
 import { __dispatch } from "./internal/dispatch.js";
-/**
- * Projects given point `uv` (normalized coords) into the target space defined
- * by `shape` and writes result to `out` (or returns new vector).
- *
- * @remarks
- * See {@link mapPoint} for reverse operation. Both functions together can be
- * used to warp points from one shape into another.
- *
- * Currently only implemented for these shape types:
- *
- * - {@link AABB}
- * - {@link Quad}
- * - {@link Quad3}
- * - {@link Rect}
- *
- * @param shape - shape to operate on
- * @param uv - point to map in UV space
- * @param out - result
- */
-export const unmapPoint = defmulti(__dispatch, {
+const unmapPoint = defmulti(
+  __dispatch,
+  {
     aabb: "rect",
-    quad3: "quad",
-}, {
-    quad: ({ points }, uv, out = []) => mixBilinear(out, points[0], points[1], points[3], points[2], uv[0], uv[1]),
-    rect: ($, uvw, out = []) => madd(out, $.size, uvw, $.pos),
-});
+    quad3: "quad"
+  },
+  {
+    quad: ({ points }, uv, out = []) => mixBilinear(
+      out,
+      points[0],
+      points[1],
+      points[3],
+      points[2],
+      uv[0],
+      uv[1]
+    ),
+    rect: ($, uvw, out = []) => madd(out, $.size, uvw, $.pos)
+  }
+);
+export {
+  unmapPoint
+};

package/vertices.js

@@ -15,59 +15,16 @@ import { set2 } from "@thi.ng/vectors/set";
 import { Polygon } from "./api/polygon.js";
 import { __dispatch } from "./internal/dispatch.js";
 import { __circleOpts, __sampleAttribs } from "./internal/vertices.js";
-/**
- * Extracts/samples vertices from given shape's boundary and returns them as
- * array. Some shapes also support
- * [`SamplingOpts`](https://docs.thi.ng/umbrella/geom-api/interfaces/SamplingOpts.html).
- *
- * @remarks
- * The given sampling options (if any) can also be overridden per shape using
- * the special `__samples` attribute. If specified, these will be merged with
- * the options.
- *
- * @example
- * ```ts
- * // using default
- * vertices(circle(100))
- *
- * // specify resolution only
- * vertices(circle(100), 6)
- *
- * // specify more advanced options
- * vertices(circle(100), { dist: 10 })
- *
- * // using shape attribs
- * vertices(circle(100, { __samples: { dist: 10 } }))
- * ```
- *
- * Currently implemented for:
- *
- * - {@link AABB}
- * - {@link Arc}
- * - {@link BPatch}
- * - {@link Circle}
- * - {@link Cubic}
- * - {@link Ellipse}
- * - {@link Group}
- * - {@link Line}
- * - {@link Path}
- * - {@link Points}
- * - {@link Points3}
- * - {@link Quad}
- * - {@link Quadratic}
- * - {@link Rect}
- * - {@link Triangle}
- *
- * @param shape
- * @param opts
- */
-export const vertices = defmulti(__dispatch, {
+const vertices = defmulti(
+  __dispatch,
+  {
     line: "polyline",
     bpatch: "points",
     points3: "points",
     quad: "poly",
-    tri: "poly",
-}, {
+    tri: "poly"
+  },
+  {
     // e +----+ h
     //   |\   :\
     //   |f+----+ g
@@ -77,83 +34,104 @@ export const vertices = defmulti(__dispatch, {
     //   b +----+ c
     //
     aabb: ({ pos, size }) => {
-        const [px, py, pz] = pos;
-        const [qx, qy, qz] = add3([], pos, size);
-        return [
-            [px, py, pz], // a
-            [px, py, qz], // b
-            [qx, py, qz], // c
-            [qx, py, pz], // d
-            [px, qy, pz], // e
-            [px, qy, qz], // f
-            [qx, qy, qz], // g
-            [qx, qy, pz], // h
-        ];
+      const [px, py, pz] = pos;
+      const [qx, qy, qz] = add3([], pos, size);
+      return [
+        [px, py, pz],
+        // a
+        [px, py, qz],
+        // b
+        [qx, py, qz],
+        // c
+        [qx, py, pz],
+        // d
+        [px, qy, pz],
+        // e
+        [px, qy, qz],
+        // f
+        [qx, qy, qz],
+        // g
+        [qx, qy, pz]
+        // h
+      ];
     },
-    arc: ($, opts) => _arcVertices($.pos, $.r, $.axis, $.start, $.end, __sampleAttribs(opts, $.attribs)),
+    arc: ($, opts) => _arcVertices(
+      $.pos,
+      $.r,
+      $.axis,
+      $.start,
+      $.end,
+      __sampleAttribs(opts, $.attribs)
+    ),
     circle: ($, opts = DEFAULT_SAMPLES) => {
-        opts = __sampleAttribs(opts, $.attribs);
-        const pos = $.pos;
-        const r = $.r;
-        let [num, start, last] = __circleOpts(opts, r);
-        const delta = TAU / num;
-        last && num++;
-        const buf = new Array(num);
-        for (let i = 0; i < num; i++) {
-            buf[i] = cartesian2(null, [r, start + i * delta], pos);
-        }
-        return buf;
+      opts = __sampleAttribs(opts, $.attribs);
+      const pos = $.pos;
+      const r = $.r;
+      let [num, start, last] = __circleOpts(opts, r);
+      const delta = TAU / num;
+      last && num++;
+      const buf = new Array(num);
+      for (let i = 0; i < num; i++) {
+        buf[i] = cartesian2(null, [r, start + i * delta], pos);
+      }
+      return buf;
     },
     cubic: ($, opts) => sampleCubic($.points, __sampleAttribs(opts, $.attribs)),
     ellipse: ($, opts = DEFAULT_SAMPLES) => {
-        opts = __sampleAttribs(opts, $.attribs);
-        const buf = [];
-        const pos = $.pos;
-        const r = $.r;
-        let [num, start, last] = __circleOpts(opts, Math.max($.r[0], $.r[1]));
-        const delta = TAU / num;
-        last && num++;
-        for (let i = 0; i < num; i++) {
-            buf[i] = madd2([], cossin(start + i * delta), r, pos);
-        }
-        return buf;
+      opts = __sampleAttribs(opts, $.attribs);
+      const buf = [];
+      const pos = $.pos;
+      const r = $.r;
+      let [num, start, last] = __circleOpts(
+        opts,
+        Math.max($.r[0], $.r[1])
+      );
+      const delta = TAU / num;
+      last && num++;
+      for (let i = 0; i < num; i++) {
+        buf[i] = madd2([], cossin(start + i * delta), r, pos);
+      }
+      return buf;
     },
     group: ($, opts) => {
-        opts = __sampleAttribs(opts, $.attribs);
-        return $.children.reduce((acc, $) => acc.concat(vertices($, opts)), []);
+      opts = __sampleAttribs(opts, $.attribs);
+      return $.children.reduce(
+        (acc, $2) => acc.concat(vertices($2, opts)),
+        []
+      );
     },
     path: ($, opts) => {
-        opts = __sampleAttribs(opts, $.attribs);
-        const _opts = isNumber(opts) ? { num: opts } : opts;
-        let verts = [];
-        for (let segs = $.segments, n = segs.length - 1, i = 0; i <= n; i++) {
-            const s = segs[i];
-            if (s.geo) {
-                verts = verts.concat(vertices(s.geo, {
-                    ..._opts,
-                    last: i === n && !$.closed,
-                }));
-            }
+      opts = __sampleAttribs(opts, $.attribs);
+      const _opts = isNumber(opts) ? { num: opts } : opts;
+      let verts = [];
+      for (let segs = $.segments, n = segs.length - 1, i = 0; i <= n; i++) {
+        const s = segs[i];
+        if (s.geo) {
+          verts = verts.concat(
+            vertices(s.geo, {
+              ..._opts,
+              last: i === n && !$.closed
+            })
+          );
         }
-        return verts;
+      }
+      return verts;
     },
     points: ($) => $.points,
     poly: ($, opts) => resample($.points, __sampleAttribs(opts, $.attribs), true),
     polyline: ($, opts) => resample($.points, __sampleAttribs(opts, $.attribs)),
     quadratic: ($, opts) => sampleQuadratic($.points, __sampleAttribs(opts, $.attribs)),
     rect: ($, opts) => {
-        opts = __sampleAttribs(opts, $.attribs);
-        const p = $.pos;
-        const q = add2([], p, $.size);
-        const verts = [set2([], p), [q[0], p[1]], q, [p[0], q[1]]];
-        return opts != null ? vertices(new Polygon(verts), opts) : verts;
-    },
-});
-/**
- * Takes an array of vertices or an `IShape`. If the latter, calls
- * {@link vertices} with default options and returns result, else returns
- * original array.
- *
- * @param shape -
- */
-export const ensureVertices = (shape) => isArray(shape) ? shape : vertices(shape);
+      opts = __sampleAttribs(opts, $.attribs);
+      const p = $.pos;
+      const q = add2([], p, $.size);
+      const verts = [set2([], p), [q[0], p[1]], q, [p[0], q[1]]];
+      return opts != null ? vertices(new Polygon(verts), opts) : verts;
+    }
+  }
+);
+const ensureVertices = (shape) => isArray(shape) ? shape : vertices(shape);
+export {
+  ensureVertices,
+  vertices
+};

package/volume.js

@@ -1,19 +1,15 @@
 import { DEFAULT, defmulti } from "@thi.ng/defmulti/defmulti";
 import { PI } from "@thi.ng/math/api";
 import { __dispatch } from "./internal/dispatch.js";
-/**
- * Returns the volume of given 3D shape. Returns 0 for all others.
- *
- * @remarks
- * Currently only implemented for:
- *
- * - {@link AABB}
- * - {@link Sphere}
- *
- * @param shape
- */
-export const volume = defmulti(__dispatch, {}, {
+const volume = defmulti(
+  __dispatch,
+  {},
+  {
     [DEFAULT]: () => 0,
     aabb: ({ size }) => size[0] * size[1] * size[2],
-    sphere: ($) => (4 / 3) * PI * $.r ** 3,
-});
+    sphere: ($) => 4 / 3 * PI * $.r ** 3
+  }
+);
+export {
+  volume
+};

package/warp-points.js

@@ -2,30 +2,20 @@ import { bounds2 } from "@thi.ng/geom-poly-utils/bounds";
 import { mapPoint } from "./map-point.js";
 import { rectFromMinMax } from "./rect.js";
 import { unmapPoint } from "./unmap-point.js";
-/**
- * Transfers/remaps points (in world space) given in relation to `src` shape to
- * be relative to the space of `dest` shape. Writes results to `out` (or creates
- * new array).
- *
- * @remarks
- * The type of `src` must be supported by {@link mapPoint}. The type of `dest`
- * must be supported by {@link unmapPoint}.
- *
- * @param pts
- * @param dest
- * @param src
- * @param out
- */
-export const warpPoints = (pts, dest, src, out = []) => {
-    for (let n = pts.length, i = 0; i < n; i++) {
-        out.push(unmapPoint(dest, mapPoint(src, pts[i])));
-    }
-    return out;
+const warpPoints = (pts, dest, src, out = []) => {
+  for (let n = pts.length, i = 0; i < n; i++) {
+    out.push(unmapPoint(dest, mapPoint(src, pts[i])));
+  }
+  return out;
 };
-export const warpPointsBPatch = (pts, dest, src, out = []) => {
-    src = src || rectFromMinMax(...bounds2(pts));
-    for (let i = pts.length; i-- > 0;) {
-        out[i] = dest.unmapPoint(mapPoint(src, pts[i]));
-    }
-    return out;
+const warpPointsBPatch = (pts, dest, src, out = []) => {
+  src = src || rectFromMinMax(...bounds2(pts));
+  for (let i = pts.length; i-- > 0; ) {
+    out[i] = dest.unmapPoint(mapPoint(src, pts[i]));
+  }
+  return out;
+};
+export {
+  warpPoints,
+  warpPointsBPatch
 };

package/with-attribs.js

@@ -1,11 +1,4 @@
-/**
- * Returns a shallow copy of given shape with new `attribs` assigned (using
- * [`IAttributed`](https://docs.thi.ng/umbrella/geom-api/interfaces/IAttributed.html).withAttribs}).
- * If `replace` is false, the new attribs will be merged with the existing ones
- * (if any).
- *
- * @param shape
- * @param attribs
- * @param replace
- */
-export const withAttribs = (shape, attribs, replace = true) => shape.withAttribs(replace ? attribs : { ...shape.attribs, ...attribs });
+const withAttribs = (shape, attribs, replace = true) => shape.withAttribs(replace ? attribs : { ...shape.attribs, ...attribs });
+export {
+  withAttribs
+};