@thi.ng/geom 3.1.7 → 3.2.2

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2021-12-13T10:26:00Z
+- **Last updated**: 2022-04-07T14:17:30Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,22 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+### [3.2.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@3.2.1) (2022-04-07)
+
+#### 🩹 Bug fixes
+
+- fix [#336](https://github.com/thi-ng/umbrella/issues/336), update attrib ctor arg handling ([cb8e52a](https://github.com/thi-ng/umbrella/commit/cb8e52a))
+  - update internal __argAttribs() helper
+  - add tests
+
+## [3.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@3.2.0) (2022-03-11)
+
+#### 🚀 Features
+
+- update/refactor various shape ops ([0e3b99a](https://github.com/thi-ng/umbrella/commit/0e3b99a))
+- add BPatch type, ctors and warp fn ([ea81cb5](https://github.com/thi-ng/umbrella/commit/ea81cb5))
+- add opt. bleed attrib for `svgDoc()` ([fb3ed1e](https://github.com/thi-ng/umbrella/commit/fb3ed1e))
+
 ## [3.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@3.1.0) (2021-11-17)
 
 #### 🚀 Features

package/README.md

@@ -41,7 +41,7 @@ themselves too):
 - [@thi.ng/geom-api](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-api) - Shared type & interface declarations for [@thi.ng/geom](https://github.com/thi-ng/umbrella/tree/develop/packages/geom) packages
 - [@thi.ng/geom-arc](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-arc) - 2D circular / elliptic arc operations
 - [@thi.ng/geom-clip-line](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-clip-line) - 2D line clipping (Liang-Barsky)
-- [@thi.ng/geom-clip-poly](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-clip-poly) - 2D convex polygon clipping (Sutherland-Hodgeman)
+- [@thi.ng/geom-clip-poly](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-clip-poly) - 2D polygon clipping / offsetting (Sutherland-Hodgeman, Grainer-Hormann)
 - [@thi.ng/geom-closest-point](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-closest-point) - 2D / 3D closest point / proximity helpers
 - [@thi.ng/geom-fuzz](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-fuzz) - Highly configurable, fuzzy line & polygon creation with presets and composable fill & stroke styles. Canvas & SVG support
 - [@thi.ng/geom-hull](https://github.com/thi-ng/umbrella/tree/develop/packages/geom-hull) - Fast 2D convex hull (Graham Scan)
@@ -84,12 +84,13 @@ node --experimental-repl-await
 > const geom = await import("@thi.ng/geom");
 ```
 
-Package sizes (gzipped, pre-treeshake): ESM: 11.79 KB
+Package sizes (gzipped, pre-treeshake): ESM: 12.44 KB
 
 ## Dependencies
 
 - [@thi.ng/api](https://github.com/thi-ng/umbrella/tree/develop/packages/api)
 - [@thi.ng/arrays](https://github.com/thi-ng/umbrella/tree/develop/packages/arrays)
+- [@thi.ng/associative](https://github.com/thi-ng/umbrella/tree/develop/packages/associative)
 - [@thi.ng/checks](https://github.com/thi-ng/umbrella/tree/develop/packages/checks)
 - [@thi.ng/defmulti](https://github.com/thi-ng/umbrella/tree/develop/packages/defmulti)
 - [@thi.ng/equiv](https://github.com/thi-ng/umbrella/tree/develop/packages/equiv)
@@ -165,4 +166,4 @@ If this project contributes to an academic publication, please cite it as:
 
 ## License
 
-© 2013 - 2021 Karsten Schmidt // Apache Software License 2.0
+© 2013 - 2022 Karsten Schmidt // Apache Software License 2.0

package/aabb.d.ts

@@ -10,8 +10,8 @@ export declare const aabbFromMinMax: (min: Vec, max: Vec, attribs?: Attribs | un
  * Returns the intersection AABB of given inputs or `undefined` if they
  * are non-overlapping.
  *
- * @param a
- * @param b
+ * @param a -
+ * @param b -
  */
 export declare const intersectionAABB: (a: AABB, b: AABB) => AABB | undefined;
 /**

package/aabb.js

@@ -15,8 +15,8 @@ export const aabbFromMinMax = (min, max, attribs) => new AABB(min, sub3([], max,
  * Returns the intersection AABB of given inputs or `undefined` if they
  * are non-overlapping.
  *
- * @param a
- * @param b
+ * @param a -
+ * @param b -
  */
 export const intersectionAABB = (a, b) => {
     const p = max3([], a.pos, b.pos);

package/api/bpatch.d.ts

@@ -0,0 +1,38 @@
+import type { Attribs, IHiccupShape } from "@thi.ng/geom-api";
+import type { ReadonlyVec, Vec } from "@thi.ng/vectors";
+import { APC } from "./apc.js";
+/**
+ * nD Cubic bezier patch defined by array of 4x4 control points in this
+ * order:
+ *
+ * ```
+ *           7   11
+ *     3 +---+---+---+ 15 (UV = 1,1)
+ *       |   |   |   |
+ *     2 +---+---+---+ 14
+ *       |   |   |   |
+ *     1 +---+---+---+ 13
+ *  v    |   |   |   |
+ *  ^  0 +---+---+---+ 12
+ *  |        4   8
+ *  |
+ *  +----> u
+ * ```
+ *
+ * The class implements a `unmapPoint()` method to transform a 2D UV coordinate
+ * into the worldspace position on the patch surface.
+ *
+ * The `toHiccup()` impl is only suitable for 2D patches.
+ *
+ * Ported from toxiclibs.
+ *
+ */
+export declare class BPatch extends APC implements IHiccupShape {
+    constructor(points: Vec[], attribs?: Attribs);
+    get type(): string;
+    copy(): BPatch;
+    edges(): Vec[][];
+    unmapPoint(uv: ReadonlyVec, out?: Vec): Vec;
+    toHiccup(): any[];
+}
+//# sourceMappingURL=bpatch.d.ts.map

package/api/bpatch.js

@@ -0,0 +1,100 @@
+import { assert } from "@thi.ng/errors/assert";
+import { mixCubic } from "@thi.ng/vectors/mix-cubic";
+import { __copyShape } from "../internal/copy.js";
+import { APC } from "./apc.js";
+/**
+ * nD Cubic bezier patch defined by array of 4x4 control points in this
+ * order:
+ *
+ * ```
+ *           7   11
+ *     3 +---+---+---+ 15 (UV = 1,1)
+ *       |   |   |   |
+ *     2 +---+---+---+ 14
+ *       |   |   |   |
+ *     1 +---+---+---+ 13
+ *  v    |   |   |   |
+ *  ^  0 +---+---+---+ 12
+ *  |        4   8
+ *  |
+ *  +----> u
+ * ```
+ *
+ * The class implements a `unmapPoint()` method to transform a 2D UV coordinate
+ * into the worldspace position on the patch surface.
+ *
+ * The `toHiccup()` impl is only suitable for 2D patches.
+ *
+ * Ported from toxiclibs.
+ *
+ */
+export class BPatch extends APC {
+    constructor(points, attribs) {
+        assert(points.length === 16, "require 16 control points");
+        super(points, attribs);
+    }
+    get type() {
+        return "bpatch";
+    }
+    copy() {
+        return __copyShape(BPatch, this);
+    }
+    edges() {
+        const p = this.points;
+        return [
+            [0, 1],
+            [1, 2],
+            [2, 3],
+            [0, 4],
+            [1, 5],
+            [2, 6],
+            [3, 7],
+            [4, 5],
+            [5, 6],
+            [6, 7],
+            [4, 8],
+            [5, 9],
+            [6, 10],
+            [7, 11],
+            [8, 9],
+            [9, 10],
+            [10, 11],
+            [8, 12],
+            [9, 13],
+            [10, 14],
+            [11, 15],
+            [12, 13],
+            [13, 14],
+            [14, 15],
+        ].map(([a, b]) => [p[a], p[b]]);
+    }
+    unmapPoint(uv, out) {
+        const cp = this.points;
+        const [u, v] = uv;
+        return mixCubic(out || null, mixCubic([], cp[0], cp[4], cp[8], cp[12], v), mixCubic([], cp[1], cp[5], cp[9], cp[13], v), mixCubic([], cp[2], cp[6], cp[10], cp[14], v), mixCubic([], cp[3], cp[7], cp[11], cp[15], v), u);
+    }
+    toHiccup() {
+        const attribs = this.attribs;
+        const acc = ["g", { fill: "none", ...attribs }];
+        if (attribs && attribs.res) {
+            const res = attribs.res - 1;
+            const delta = 1 / res;
+            for (let u = 0; u <= res; u++) {
+                const col = [];
+                const row = [];
+                const uu = u * delta;
+                for (let v = 0; v <= res; v++) {
+                    const p = [uu, v * delta];
+                    col.push(this.unmapPoint(p));
+                    row.push(this.unmapPoint([p[1], p[0]]));
+                }
+                acc.push(["polyline", {}, col]);
+                acc.push(["polyline", {}, row]);
+            }
+        }
+        else {
+            this.edges().forEach((l) => acc.push(["line", {}, ...l]));
+        }
+        return acc;
+    }
+}

package/as-svg.d.ts

@@ -1,4 +1,16 @@
 import type { Attribs, IShape } from "@thi.ng/geom-api";
 export declare const asSvg: (...args: any[]) => string;
+/**
+ * Creates a hiccup SVG doc element for given {@link IShape}s and attribs. If
+ * the attribs do not include a `viewBox`, it will be computed automatically.
+ * Furthermore (and only for the case a viewbox needs to be computed), a `bleed`
+ * attrib can be provided to include a bleed/margin for the viewbox.
+ *
+ * @remarks
+ * Use {@link asSvg} to serialize the resulting doc to an SVG string.
+ *
+ * @param attribs
+ * @param xs
+ */
 export declare const svgDoc: (attribs: Attribs, ...xs: IShape[]) => any[];
 //# sourceMappingURL=as-svg.d.ts.map

package/as-svg.js

@@ -1,3 +1,4 @@
+import { withoutKeysObj } from "@thi.ng/associative/without-keys";
 import { convertTree } from "@thi.ng/hiccup-svg/convert";
 import { ff } from "@thi.ng/hiccup-svg/format";
 import { svg } from "@thi.ng/hiccup-svg/svg";
@@ -5,17 +6,33 @@ import { serialize } from "@thi.ng/hiccup/serialize";
 import { bounds } from "./bounds.js";
 import { __collBounds } from "./internal/bounds.js";
 export const asSvg = (...args) => args.map((x) => serialize(convertTree(x))).join("");
+/**
+ * Creates a hiccup SVG doc element for given {@link IShape}s and attribs. If
+ * the attribs do not include a `viewBox`, it will be computed automatically.
+ * Furthermore (and only for the case a viewbox needs to be computed), a `bleed`
+ * attrib can be provided to include a bleed/margin for the viewbox.
+ *
+ * @remarks
+ * Use {@link asSvg} to serialize the resulting doc to an SVG string.
+ *
+ * @param attribs
+ * @param xs
+ */
 export const svgDoc = (attribs, ...xs) => {
     if (xs.length > 0) {
-        if (!attribs || !attribs.viewBox) {
+        if (!attribs.viewBox) {
             const cbounds = __collBounds(xs, bounds);
             if (cbounds) {
                 const [[x, y], [w, h]] = cbounds;
+                const bleed = attribs.bleed || 0;
+                const bleed2 = 2 * bleed;
+                const width = ff(w + bleed2);
+                const height = ff(h + bleed2);
                 attribs = {
-                    width: ff(w),
-                    height: ff(h),
-                    viewBox: `${ff(x)} ${ff(y)} ${ff(w)} ${ff(h)}`,
-                    ...attribs,
+                    width,
+                    height,
+                    viewBox: `${ff(x - bleed)} ${ff(y - bleed)} ${width} ${height}`,
+                    ...withoutKeysObj(attribs, ["bleed"]),
                 };
             }
         }

package/bounds.js

@@ -1,18 +1,17 @@
 import { defmulti } from "@thi.ng/defmulti/defmulti";
 import { bounds as arcBounds } from "@thi.ng/geom-arc/bounds";
-import { bounds as _bounds } from "@thi.ng/geom-poly-utils/bounds";
+import { bounds2, bounds3 } from "@thi.ng/geom-poly-utils/bounds";
 import { cubicBounds } from "@thi.ng/geom-splines/cubic-bounds";
 import { quadraticBounds } from "@thi.ng/geom-splines/quadratic-bounds";
 import { comp } from "@thi.ng/transducers/comp";
 import { filter } from "@thi.ng/transducers/filter";
 import { iterator1 } from "@thi.ng/transducers/iterator";
 import { map } from "@thi.ng/transducers/map";
-import { MAX2, MAX3, MIN2, MIN3 } from "@thi.ng/vectors/api";
 import { max } from "@thi.ng/vectors/max";
 import { min } from "@thi.ng/vectors/min";
 import { mul2 } from "@thi.ng/vectors/mul";
 import { mulN2 } from "@thi.ng/vectors/muln";
-import { set2, set3 } from "@thi.ng/vectors/set";
+import { set2 } from "@thi.ng/vectors/set";
 import { sub2 } from "@thi.ng/vectors/sub";
 import { subN2 } from "@thi.ng/vectors/subn";
 import { aabbFromMinMax } from "./aabb.js";
@@ -22,6 +21,7 @@ import { __dispatch } from "./internal/dispatch.js";
 import { rectFromMinMax } from "./rect.js";
 export const bounds = defmulti(__dispatch, {
     aabb: "rect",
+    bpatch: "points",
     poly: "points",
     polyline: "points",
     quad: "points",
@@ -42,8 +42,8 @@ export const bounds = defmulti(__dispatch, {
         ], bounds);
         return b ? new Rect(...b) : undefined;
     },
-    points: ($) => rectFromMinMax(..._bounds($.points, set2([], MAX2), set2([], MIN2))),
-    points3: ($) => aabbFromMinMax(..._bounds($.points, set3([], MAX3), set3([], MIN3))),
+    points: ($) => rectFromMinMax(...bounds2($.points)),
+    points3: ($) => aabbFromMinMax(...bounds3($.points)),
     quadratic: ({ points }) => rectFromMinMax(...quadraticBounds(points[0], points[1], points[2])),
     rect: ($) => $.copy(),
     text: ($) => new Rect(set2([], $.pos), [0, 0]),

package/bpatch.d.ts

@@ -0,0 +1,7 @@
+import type { Attribs } from "@thi.ng/geom-api";
+import { Vec } from "@thi.ng/vectors";
+import { BPatch } from "./api/bpatch.js";
+export declare const bpatch: (pts: Vec[], attribs?: Attribs | undefined) => BPatch;
+export declare const bpatchFromQuad: (pts: Vec[], attribs?: Attribs | undefined) => BPatch;
+export declare const bpatchFromHex: (pts: Vec[], attribs?: Attribs | undefined) => BPatch;
+//# sourceMappingURL=bpatch.d.ts.map

package/bpatch.js

@@ -0,0 +1,20 @@
+import { assert } from "@thi.ng/errors/assert";
+import { mixBilinear } from "@thi.ng/vectors";
+import { BPatch } from "./api/bpatch.js";
+export const bpatch = (pts, attribs) => new BPatch(pts, attribs);
+export const bpatchFromQuad = (pts, attribs) => {
+    assert(pts.length === 4, "require 4 points");
+    const [a, b, c, d] = pts;
+    const cps = [];
+    for (let u = 0; u < 4; u++) {
+        for (let v = 0; v < 4; v++) {
+            cps.push(mixBilinear([], a, b, d, c, u / 3, v / 3));
+        }
+    }
+    return new BPatch(cps, attribs);
+};
+export const bpatchFromHex = (pts, attribs) => {
+    assert(pts.length === 6, "require 6 points");
+    const [a, b, c, d, e, f] = pts;
+    return new BPatch([e, e, f, f, d, d, a, a, d, d, a, a, c, c, b, b], attribs);
+};

package/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./api/aabb.js";
 export * from "./api/apc.js";
 export * from "./api/arc.js";
+export * from "./api/bpatch.js";
 export * from "./api/circle.js";
 export * from "./api/cubic.js";
 export * from "./api/ellipse.js";
@@ -21,6 +22,7 @@ export * from "./api/text.js";
 export * from "./api/triangle.js";
 export * from "./aabb.js";
 export * from "./arc.js";
+export * from "./bpatch.js";
 export * from "./circle.js";
 export * from "./cubic.js";
 export * from "./ellipse.js";

package/index.js

@@ -1,6 +1,7 @@
 export * from "./api/aabb.js";
 export * from "./api/apc.js";
 export * from "./api/arc.js";
+export * from "./api/bpatch.js";
 export * from "./api/circle.js";
 export * from "./api/cubic.js";
 export * from "./api/ellipse.js";
@@ -21,6 +22,7 @@ export * from "./api/text.js";
 export * from "./api/triangle.js";
 export * from "./aabb.js";
 export * from "./arc.js";
+export * from "./bpatch.js";
 export * from "./circle.js";
 export * from "./cubic.js";
 export * from "./ellipse.js";

package/internal/args.d.ts

@@ -1,7 +1,7 @@
 /**
- * Takes an array of arguments, checks if last element is a plain object
- * and if so, removes it from array and returns it. Else returns
- * `undefined`.
+ * Takes an array of arguments, checks if last element is a plain object or
+ * nullish and if so, removes value from array and returns it (`null` will be
+ * cast to `undefined`). Else returns `undefined`.
  *
  * @param args -
  *

package/internal/args.js

@@ -1,16 +1,24 @@
-import { peek } from "@thi.ng/arrays/peek";
 import { isNumber } from "@thi.ng/checks/is-number";
 import { isPlainObject } from "@thi.ng/checks/is-plain-object";
 /**
- * Takes an array of arguments, checks if last element is a plain object
- * and if so, removes it from array and returns it. Else returns
- * `undefined`.
+ * Takes an array of arguments, checks if last element is a plain object or
+ * nullish and if so, removes value from array and returns it (`null` will be
+ * cast to `undefined`). Else returns `undefined`.
  *
  * @param args -
  *
  * @internal
  */
-export const __argAttribs = (args) => isPlainObject(peek(args)) ? args.pop() : undefined;
+export const __argAttribs = (args) => {
+    if (args.length) {
+        const last = args[args.length - 1];
+        return isPlainObject(last)
+            ? args.pop()
+            : last == null
+                ? (args.pop(), undefined)
+                : undefined;
+    }
+};
 /**
  * Args parser for functions expecting up to 2 vector args and optional
  * attribs object. Returns 3-tuple of re-structured args.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/geom",
-  "version": "3.1.7",
+  "version": "3.2.2",
   "description": "Functional, polymorphic API for 2D geometry types & SVG generation",
   "type": "module",
   "module": "./index.js",
@@ -31,43 +31,45 @@
     "doc:readme": "yarn doc:stats && tools:readme",
     "doc:stats": "tools:module-stats",
     "pub": "yarn npm publish --access public",
-    "test": "testament test"
+    "test": "testament test",
+    "tool:bpatch": "tools:node-esm tools/bpatch.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.3",
-    "@thi.ng/arrays": "^2.1.3",
-    "@thi.ng/checks": "^3.1.3",
-    "@thi.ng/defmulti": "^2.1.3",
-    "@thi.ng/equiv": "^2.1.3",
-    "@thi.ng/errors": "^2.1.3",
-    "@thi.ng/geom-api": "^3.1.7",
-    "@thi.ng/geom-arc": "^2.1.7",
-    "@thi.ng/geom-clip-line": "^2.1.7",
-    "@thi.ng/geom-clip-poly": "^2.1.7",
-    "@thi.ng/geom-closest-point": "^2.1.7",
-    "@thi.ng/geom-hull": "^2.1.7",
-    "@thi.ng/geom-isec": "^2.1.7",
-    "@thi.ng/geom-poly-utils": "^2.1.7",
-    "@thi.ng/geom-resample": "^2.1.7",
-    "@thi.ng/geom-splines": "^2.1.7",
-    "@thi.ng/geom-subdiv-curve": "^2.1.7",
-    "@thi.ng/geom-tessellate": "^2.1.7",
-    "@thi.ng/hiccup": "^4.2.4",
-    "@thi.ng/hiccup-svg": "^4.2.7",
-    "@thi.ng/math": "^5.2.0",
-    "@thi.ng/matrices": "^2.1.7",
-    "@thi.ng/random": "^3.2.3",
-    "@thi.ng/strings": "^3.3.1",
-    "@thi.ng/transducers": "^8.2.0",
-    "@thi.ng/vectors": "^7.4.3"
+    "@thi.ng/api": "^8.3.5",
+    "@thi.ng/arrays": "^2.2.1",
+    "@thi.ng/associative": "^6.1.6",
+    "@thi.ng/checks": "^3.1.5",
+    "@thi.ng/defmulti": "^2.1.5",
+    "@thi.ng/equiv": "^2.1.5",
+    "@thi.ng/errors": "^2.1.5",
+    "@thi.ng/geom-api": "^3.1.10",
+    "@thi.ng/geom-arc": "^2.1.10",
+    "@thi.ng/geom-clip-line": "^2.1.10",
+    "@thi.ng/geom-clip-poly": "^2.1.10",
+    "@thi.ng/geom-closest-point": "^2.1.10",
+    "@thi.ng/geom-hull": "^2.1.10",
+    "@thi.ng/geom-isec": "^2.1.10",
+    "@thi.ng/geom-poly-utils": "^2.2.2",
+    "@thi.ng/geom-resample": "^2.1.10",
+    "@thi.ng/geom-splines": "^2.1.10",
+    "@thi.ng/geom-subdiv-curve": "^2.1.10",
+    "@thi.ng/geom-tessellate": "^2.1.10",
+    "@thi.ng/hiccup": "^4.2.6",
+    "@thi.ng/hiccup-svg": "^4.2.10",
+    "@thi.ng/math": "^5.3.1",
+    "@thi.ng/matrices": "^2.1.10",
+    "@thi.ng/random": "^3.2.5",
+    "@thi.ng/strings": "^3.3.3",
+    "@thi.ng/transducers": "^8.3.1",
+    "@thi.ng/vectors": "^7.5.2"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.19.2",
-    "@thi.ng/testament": "^0.2.3",
+    "@microsoft/api-extractor": "^7.19.4",
+    "@thi.ng/testament": "^0.2.5",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.22.10",
-    "typescript": "^4.5.3"
+    "typedoc": "^0.22.13",
+    "typescript": "^4.6.2"
   },
   "keywords": [
     "2d",
@@ -105,254 +107,260 @@
   ],
   "exports": {
     ".": {
-      "import": "./index.js"
+      "default": "./index.js"
     },
     "./aabb": {
-      "import": "./aabb.js"
+      "default": "./aabb.js"
     },
     "./api/aabb": {
-      "import": "./api/aabb.js"
+      "default": "./api/aabb.js"
     },
     "./api/apc": {
-      "import": "./api/apc.js"
+      "default": "./api/apc.js"
     },
     "./api/arc": {
-      "import": "./api/arc.js"
+      "default": "./api/arc.js"
+    },
+    "./api/bpatch": {
+      "default": "./api/bpatch.js"
     },
     "./api/circle": {
-      "import": "./api/circle.js"
+      "default": "./api/circle.js"
     },
     "./api/cubic": {
-      "import": "./api/cubic.js"
+      "default": "./api/cubic.js"
     },
     "./api/ellipse": {
-      "import": "./api/ellipse.js"
+      "default": "./api/ellipse.js"
     },
     "./api/group": {
-      "import": "./api/group.js"
+      "default": "./api/group.js"
     },
     "./api/line": {
-      "import": "./api/line.js"
+      "default": "./api/line.js"
     },
     "./api/path": {
-      "import": "./api/path.js"
+      "default": "./api/path.js"
     },
     "./api/plane": {
-      "import": "./api/plane.js"
+      "default": "./api/plane.js"
     },
     "./api/points": {
-      "import": "./api/points.js"
+      "default": "./api/points.js"
     },
     "./api/polygon": {
-      "import": "./api/polygon.js"
+      "default": "./api/polygon.js"
     },
     "./api/polyline": {
-      "import": "./api/polyline.js"
+      "default": "./api/polyline.js"
     },
     "./api/quad": {
-      "import": "./api/quad.js"
+      "default": "./api/quad.js"
     },
     "./api/quad3": {
-      "import": "./api/quad3.js"
+      "default": "./api/quad3.js"
     },
     "./api/quadratic": {
-      "import": "./api/quadratic.js"
+      "default": "./api/quadratic.js"
     },
     "./api/ray": {
-      "import": "./api/ray.js"
+      "default": "./api/ray.js"
     },
     "./api/rect": {
-      "import": "./api/rect.js"
+      "default": "./api/rect.js"
     },
     "./api/sphere": {
-      "import": "./api/sphere.js"
+      "default": "./api/sphere.js"
     },
     "./api/text": {
-      "import": "./api/text.js"
+      "default": "./api/text.js"
     },
     "./api/triangle": {
-      "import": "./api/triangle.js"
+      "default": "./api/triangle.js"
     },
     "./arc-length": {
-      "import": "./arc-length.js"
+      "default": "./arc-length.js"
     },
     "./arc": {
-      "import": "./arc.js"
+      "default": "./arc.js"
     },
     "./area": {
-      "import": "./area.js"
+      "default": "./area.js"
     },
     "./as-cubic": {
-      "import": "./as-cubic.js"
+      "default": "./as-cubic.js"
     },
     "./as-path": {
-      "import": "./as-path.js"
+      "default": "./as-path.js"
     },
     "./as-polygon": {
-      "import": "./as-polygon.js"
+      "default": "./as-polygon.js"
     },
     "./as-polyline": {
-      "import": "./as-polyline.js"
+      "default": "./as-polyline.js"
     },
     "./as-svg": {
-      "import": "./as-svg.js"
+      "default": "./as-svg.js"
     },
     "./bounds": {
-      "import": "./bounds.js"
+      "default": "./bounds.js"
+    },
+    "./bpatch": {
+      "default": "./bpatch.js"
     },
     "./center": {
-      "import": "./center.js"
+      "default": "./center.js"
     },
     "./centroid": {
-      "import": "./centroid.js"
+      "default": "./centroid.js"
     },
     "./circle": {
-      "import": "./circle.js"
+      "default": "./circle.js"
     },
     "./classify-point": {
-      "import": "./classify-point.js"
+      "default": "./classify-point.js"
     },
     "./clip-convex": {
-      "import": "./clip-convex.js"
+      "default": "./clip-convex.js"
     },
     "./closest-point": {
-      "import": "./closest-point.js"
+      "default": "./closest-point.js"
     },
     "./convex-hull": {
-      "import": "./convex-hull.js"
+      "default": "./convex-hull.js"
     },
     "./cubic": {
-      "import": "./cubic.js"
+      "default": "./cubic.js"
     },
     "./edges": {
-      "import": "./edges.js"
+      "default": "./edges.js"
     },
     "./ellipse": {
-      "import": "./ellipse.js"
+      "default": "./ellipse.js"
     },
     "./fit-into-bounds": {
-      "import": "./fit-into-bounds.js"
+      "default": "./fit-into-bounds.js"
     },
     "./flip": {
-      "import": "./flip.js"
+      "default": "./flip.js"
     },
     "./group": {
-      "import": "./group.js"
+      "default": "./group.js"
     },
     "./intersects": {
-      "import": "./intersects.js"
+      "default": "./intersects.js"
     },
     "./line": {
-      "import": "./line.js"
+      "default": "./line.js"
     },
     "./map-point": {
-      "import": "./map-point.js"
+      "default": "./map-point.js"
     },
     "./offset": {
-      "import": "./offset.js"
+      "default": "./offset.js"
     },
     "./path-builder": {
-      "import": "./path-builder.js"
+      "default": "./path-builder.js"
     },
     "./path-from-svg": {
-      "import": "./path-from-svg.js"
+      "default": "./path-from-svg.js"
     },
     "./path": {
-      "import": "./path.js"
+      "default": "./path.js"
     },
     "./plane": {
-      "import": "./plane.js"
+      "default": "./plane.js"
     },
     "./point-at": {
-      "import": "./point-at.js"
+      "default": "./point-at.js"
     },
     "./point-inside": {
-      "import": "./point-inside.js"
+      "default": "./point-inside.js"
     },
     "./points": {
-      "import": "./points.js"
+      "default": "./points.js"
     },
     "./polygon": {
-      "import": "./polygon.js"
+      "default": "./polygon.js"
     },
     "./polyline": {
-      "import": "./polyline.js"
+      "default": "./polyline.js"
     },
     "./quad": {
-      "import": "./quad.js"
+      "default": "./quad.js"
     },
     "./quadratic": {
-      "import": "./quadratic.js"
+      "default": "./quadratic.js"
     },
     "./ray": {
-      "import": "./ray.js"
+      "default": "./ray.js"
     },
     "./rect": {
-      "import": "./rect.js"
+      "default": "./rect.js"
     },
     "./resample": {
-      "import": "./resample.js"
+      "default": "./resample.js"
     },
     "./scatter": {
-      "import": "./scatter.js"
+      "default": "./scatter.js"
     },
     "./simplify": {
-      "import": "./simplify.js"
+      "default": "./simplify.js"
     },
     "./sphere": {
-      "import": "./sphere.js"
+      "default": "./sphere.js"
     },
     "./split-at": {
-      "import": "./split-at.js"
+      "default": "./split-at.js"
     },
     "./split-near": {
-      "import": "./split-near.js"
+      "default": "./split-near.js"
     },
     "./subdiv-curve": {
-      "import": "./subdiv-curve.js"
+      "default": "./subdiv-curve.js"
     },
     "./tangent-at": {
-      "import": "./tangent-at.js"
+      "default": "./tangent-at.js"
     },
     "./tessellate": {
-      "import": "./tessellate.js"
+      "default": "./tessellate.js"
     },
     "./text": {
-      "import": "./text.js"
+      "default": "./text.js"
     },
     "./transform-vertices": {
-      "import": "./transform-vertices.js"
+      "default": "./transform-vertices.js"
     },
     "./transform": {
-      "import": "./transform.js"
+      "default": "./transform.js"
     },
     "./translate": {
-      "import": "./translate.js"
+      "default": "./translate.js"
     },
     "./triangle": {
-      "import": "./triangle.js"
+      "default": "./triangle.js"
     },
     "./union": {
-      "import": "./union.js"
+      "default": "./union.js"
     },
     "./unmap-point": {
-      "import": "./unmap-point.js"
+      "default": "./unmap-point.js"
     },
     "./vertices": {
-      "import": "./vertices.js"
+      "default": "./vertices.js"
     },
     "./volume": {
-      "import": "./volume.js"
+      "default": "./volume.js"
     },
     "./warp-points": {
-      "import": "./warp-points.js"
+      "default": "./warp-points.js"
     },
     "./with-attribs": {
-      "import": "./with-attribs.js"
+      "default": "./with-attribs.js"
     }
   },
   "thi.ng": {
     "year": 2013
   },
-  "gitHead": "1ba92c6b9509e74e509b4c0b875fc380a97bbbc1\n"
+  "gitHead": "542bf14bd0c7a56b4e6297718189eea772a824b7\n"
 }

package/polygon.d.ts

@@ -1,6 +1,6 @@
 import type { Attribs } from "@thi.ng/geom-api";
 import type { Vec } from "@thi.ng/vectors";
 import { Polygon } from "./api/polygon.js";
-export declare const polygon: (pts: Vec[], attribs?: Attribs | undefined) => Polygon;
+export declare const polygon: (pts?: Vec[] | undefined, attribs?: Attribs | undefined) => Polygon;
 export declare const star: (r: number, n: number, profile: number[], attribs?: Attribs | undefined) => Polygon;
 //# sourceMappingURL=polygon.d.ts.map

package/rect.d.ts

@@ -12,8 +12,8 @@ export declare const rectFromCentroid: (centroid: Vec, size: Vec, attribs?: Attr
  * Returns the intersection rect of given inputs or `undefined` if they
  * are non-overlapping.
  *
- * @param a
- * @param b
+ * @param a -
+ * @param b -
  */
 export declare const intersectionRect: (a: Rect, b: Rect) => Rect | undefined;
 /**

package/rect.js

@@ -19,8 +19,8 @@ export const rectFromCentroid = (centroid, size, attribs) => new Rect(maddN2([],
  * Returns the intersection rect of given inputs or `undefined` if they
  * are non-overlapping.
  *
- * @param a
- * @param b
+ * @param a -
+ * @param b -
  */
 export const intersectionRect = (a, b) => {
     const p = max2([], a.pos, b.pos);

package/vertices.d.ts

@@ -7,7 +7,7 @@ export declare const vertices: MultiFn1O<IShape, number | Partial<SamplingOpts>,
  * Takes array of vectors or an `IShape`. If the latter, calls {@link vertices}
  * and return result, else returns original array.
  *
- * @param shape
+ * @param shape -
  */
 export declare const ensureVertices: (shape: IShape | Vec[]) => Vec[];
 //# sourceMappingURL=vertices.d.ts.map

package/vertices.js

@@ -16,6 +16,7 @@ import { Polygon } from "./api/polygon.js";
 import { __dispatch } from "./internal/dispatch.js";
 export const vertices = defmulti(__dispatch, {
     line: "polyline",
+    bpatch: "points",
     points3: "points",
     quad: "poly",
     tri: "poly",
@@ -98,7 +99,7 @@ export const vertices = defmulti(__dispatch, {
  * Takes array of vectors or an `IShape`. If the latter, calls {@link vertices}
  * and return result, else returns original array.
  *
- * @param shape
+ * @param shape -
  */
 export const ensureVertices = (shape) => isArray(shape) ? shape : vertices(shape);
 const circleOpts = (opts, r) => isNumber(opts)

package/warp-points.d.ts

@@ -1,4 +1,7 @@
 import type { IShape } from "@thi.ng/geom-api";
-import type { ReadonlyVec, Vec } from "@thi.ng/vectors";
+import type { ReadonlyVec, Vec } from "@thi.ng/vectors/api";
+import type { BPatch } from "./api/bpatch.js";
+import type { Rect } from "./api/rect.js";
 export declare const warpPoints: (pts: ReadonlyVec[], dest: IShape, src: IShape) => Vec[];
+export declare const warpPointsBPatch: (pts: ReadonlyVec[], dest: BPatch, src?: Rect | undefined, out?: Vec[]) => Vec[];
 //# sourceMappingURL=warp-points.d.ts.map

package/warp-points.js

@@ -1,4 +1,6 @@
+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";
 export const warpPoints = (pts, dest, src) => {
     const res = [];
@@ -7,3 +9,10 @@ export const warpPoints = (pts, dest, src) => {
     }
     return res;
 };
+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;
+};