@thi.ng/geom 3.2.4 → 3.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2022-05-07T11:33:35Z
+- **Last updated**: 2022-06-20T17:33:30Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,15 @@ 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.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@3.3.0) (2022-06-20)
+
+#### 🚀 Features
+
+- update bounds() to support opt. margin ([8cdc372](https://github.com/thi-ng/umbrella/commit/8cdc372))
+- update rect/aabb, add new factory fns ([f74e377](https://github.com/thi-ng/umbrella/commit/f74e377))
+  - add ...WithMargin() factory fns
+  - add AABBLike.offset() impls
+
 ### [3.2.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@3.2.1) (2022-04-07)
 
 #### 🩹 Bug fixes

package/aabb.d.ts

@@ -5,7 +5,10 @@ import type { Sphere } from "./api/sphere.js";
 export declare function aabb(pos: Vec, size: number | Vec, attribs?: Attribs): AABB;
 export declare function aabb(size: number | Vec, attribs?: Attribs): AABB;
 export declare function aabb(attribs?: Attribs): AABB;
-export declare const aabbFromMinMax: (min: Vec, max: Vec, attribs?: Attribs | undefined) => AABB;
+export declare const aabbFromMinMax: (min: Vec, max: Vec, attribs?: Attribs) => AABB;
+export declare const aabbFromMinMaxWithMargin: (min: Vec, max: Vec, margin: number, attribs?: Attribs) => AABB;
+export declare const aabbFromCentroid: (centroid: Vec, size: Vec, attribs?: Attribs) => AABB;
+export declare const aabbFromCentroidWithMargin: (centroid: Vec, size: Vec, margin: number, attribs?: Attribs) => AABB;
 /**
  * Returns the intersection AABB of given inputs or `undefined` if they
  * are non-overlapping.

package/aabb.js

@@ -1,6 +1,7 @@
 import { SQRT2_2 } from "@thi.ng/math/api";
 import { add3 } from "@thi.ng/vectors/add";
 import { ZERO3 } from "@thi.ng/vectors/api";
+import { maddN3 } from "@thi.ng/vectors/maddn";
 import { max3 } from "@thi.ng/vectors/max";
 import { min3 } from "@thi.ng/vectors/min";
 import { sub3 } from "@thi.ng/vectors/sub";
@@ -11,6 +12,9 @@ export function aabb(...args) {
     return new AABB(...__argsVV(args));
 }
 export const aabbFromMinMax = (min, max, attribs) => new AABB(min, sub3([], max, min), attribs);
+export const aabbFromMinMaxWithMargin = (min, max, margin, attribs) => aabbFromMinMax(min, max, attribs).offset(margin);
+export const aabbFromCentroid = (centroid, size, attribs) => new AABB(maddN3([], size, -0.5, centroid), size, attribs);
+export const aabbFromCentroidWithMargin = (centroid, size, margin, attribs) => aabbFromCentroid(centroid, size, attribs).offset(margin);
 /**
  * Returns the intersection AABB of given inputs or `undefined` if they
  * are non-overlapping.

package/api/aabb.d.ts

@@ -8,5 +8,6 @@ export declare class AABB implements AABBLike {
     get type(): string;
     copy(): AABB;
     max(): Vec;
+    offset(offset: number): this;
 }
 //# sourceMappingURL=aabb.d.ts.map

package/api/aabb.js

@@ -1,6 +1,8 @@
 import { isNumber } from "@thi.ng/checks/is-number";
 import { add3 } from "@thi.ng/vectors/add";
+import { addN3 } from "@thi.ng/vectors/addn";
 import { set } from "@thi.ng/vectors/set";
+import { subN3 } from "@thi.ng/vectors/subn";
 import { __copyAttribs } from "../internal/copy.js";
 export class AABB {
     constructor(pos = [0, 0, 0], size = 1, attribs) {
@@ -17,4 +19,9 @@ export class AABB {
     max() {
         return add3([], this.pos, this.size);
     }
+    offset(offset) {
+        subN3(null, this.pos, offset);
+        addN3(null, this.size, offset * 2);
+        return this;
+    }
 }

package/api/rect.d.ts

@@ -8,6 +8,7 @@ export declare class Rect implements AABBLike, IHiccupShape {
     get type(): string;
     copy(): Rect;
     max(): Vec;
+    offset(offset: number): this;
     toHiccup(): (string | number | Attribs | undefined)[];
 }
 //# sourceMappingURL=rect.d.ts.map

package/api/rect.js

@@ -1,6 +1,8 @@
 import { isNumber } from "@thi.ng/checks/is-number";
 import { add2 } from "@thi.ng/vectors/add";
+import { addN2 } from "@thi.ng/vectors/addn";
 import { set2 } from "@thi.ng/vectors/set";
+import { subN2 } from "@thi.ng/vectors/subn";
 import { __copyAttribs } from "../internal/copy.js";
 export class Rect {
     constructor(pos = [0, 0], size = 1, attribs) {
@@ -17,6 +19,11 @@ export class Rect {
     max() {
         return add2([], this.pos, this.size);
     }
+    offset(offset) {
+        subN2(null, this.pos, offset);
+        addN2(null, this.size, offset * 2);
+        return this;
+    }
     toHiccup() {
         return ["rect", this.attribs, this.pos, this.size[0], this.size[1]];
     }

package/arc.d.ts

@@ -2,5 +2,5 @@ import type { Attribs } from "@thi.ng/geom-api";
 import type { ReadonlyVec, Vec } from "@thi.ng/vectors";
 import { Arc } from "./api/arc.js";
 export declare const arc: (pos: Vec, r: number | Vec, axis: number, start: number, end: number, xl?: boolean, clockwise?: boolean) => Arc;
-export declare const arcFrom2Points: (a: ReadonlyVec, b: ReadonlyVec, radii: ReadonlyVec, axis?: number, xl?: boolean, cw?: boolean, attribs?: Attribs | undefined) => Arc | undefined;
+export declare const arcFrom2Points: (a: ReadonlyVec, b: ReadonlyVec, radii: ReadonlyVec, axis?: number, xl?: boolean, cw?: boolean, attribs?: Attribs) => Arc | undefined;
 //# sourceMappingURL=arc.d.ts.map

package/as-path.d.ts

@@ -1,3 +1,3 @@
 import type { Attribs, IShape } from "@thi.ng/geom-api";
-export declare const asPath: (src: IShape, attribs?: Attribs | undefined) => import("./index.js").Path;
+export declare const asPath: (src: IShape, attribs?: Attribs) => import("./index.js").Path;
 //# sourceMappingURL=as-path.d.ts.map

package/bounds.d.ts

@@ -1,4 +1,4 @@
-import type { MultiFn1 } from "@thi.ng/defmulti";
+import type { MultiFn1O } from "@thi.ng/defmulti";
 import type { AABBLike, IShape } from "@thi.ng/geom-api";
-export declare const bounds: MultiFn1<IShape, AABBLike | undefined>;
+export declare const bounds: MultiFn1O<IShape, number, AABBLike | undefined>;
 //# sourceMappingURL=bounds.d.ts.map

package/bounds.js

@@ -7,18 +7,18 @@ 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 { addN2 } from "@thi.ng/vectors/addn";
 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 } from "@thi.ng/vectors/set";
 import { sub2 } from "@thi.ng/vectors/sub";
 import { subN2 } from "@thi.ng/vectors/subn";
-import { aabbFromMinMax } from "./aabb.js";
+import { aabbFromMinMaxWithMargin } from "./aabb.js";
 import { Rect } from "./api/rect.js";
 import { __collBounds } from "./internal/bounds.js";
 import { __dispatch } from "./internal/dispatch.js";
-import { rectFromMinMax } from "./rect.js";
+import { rectFromMinMaxWithMargin } from "./rect.js";
 export const bounds = defmulti(__dispatch, {
     aabb: "rect",
     bpatch: "points",
@@ -27,24 +27,29 @@ export const bounds = defmulti(__dispatch, {
     quad: "points",
     tri: "points",
 }, {
-    arc: ($) => rectFromMinMax(...arcBounds($.pos, $.r, $.axis, $.start, $.end)),
-    circle: ($) => new Rect(subN2([], $.pos, $.r), mulN2(null, [2, 2], $.r)),
-    cubic: ({ points }) => rectFromMinMax(...cubicBounds(points[0], points[1], points[2], points[3])),
-    ellipse: ($) => new Rect(sub2([], $.pos, $.r), mul2(null, [2, 2], $.r)),
-    group: ($) => {
+    arc: ($, margin = 0) => rectFromMinMaxWithMargin(...arcBounds($.pos, $.r, $.axis, $.start, $.end), margin),
+    circle: ($, margin = 0) => new Rect(subN2([], $.pos, $.r + margin), mulN2(null, [2, 2], $.r + margin)),
+    cubic: ({ points }, margin = 0) => rectFromMinMaxWithMargin(...cubicBounds(points[0], points[1], points[2], points[3]), margin),
+    ellipse: ($, margin = 0) => {
+        const r = addN2([], $.r, margin);
+        return new Rect(sub2([], $.pos, r), mul2(null, [2, 2], r));
+    },
+    group: ($, margin = 0) => {
         const res = __collBounds($.children, bounds);
-        return res ? new Rect(...res) : undefined;
+        return res ? new Rect(...res).offset(margin) : undefined;
     },
-    line: ({ points: [a, b] }) => rectFromMinMax(min([], a, b), max([], a, b)),
-    path: (path) => {
+    line: ({ points: [a, b] }, margin = 0) => rectFromMinMaxWithMargin(min([], a, b), max([], a, b), margin),
+    path: (path, margin = 0) => {
         const b = __collBounds([
             ...iterator1(comp(map((s) => s.geo), filter((s) => !!s)), path.segments),
         ], bounds);
-        return b ? new Rect(...b) : undefined;
+        return b ? new Rect(...b).offset(margin) : undefined;
     },
-    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]),
+    points: ($, margin = 0) => rectFromMinMaxWithMargin(...bounds2($.points), margin),
+    points3: ($, margin = 0) => aabbFromMinMaxWithMargin(...bounds3($.points), margin),
+    quadratic: ({ points }, margin = 0) => rectFromMinMaxWithMargin(...quadraticBounds(points[0], points[1], points[2]), margin),
+    rect: ($, margin = 0) => margin === 0
+        ? $.copy()
+        : $.copy().offset(margin),
+    text: ($, margin = 0) => new Rect(subN2([], $.pos, margin), [0, 0]), // TODO
 });

package/bpatch.d.ts

@@ -1,7 +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;
+export declare const bpatch: (pts: Vec[], attribs?: Attribs) => BPatch;
+export declare const bpatchFromQuad: (pts: Vec[], attribs?: Attribs) => BPatch;
+export declare const bpatchFromHex: (pts: Vec[], attribs?: Attribs) => BPatch;
 //# sourceMappingURL=bpatch.d.ts.map

package/circle.d.ts

@@ -5,6 +5,6 @@ export declare function circle(pos: Vec, r: number, attribs?: Attribs): Circle;
 export declare function circle(pos: Vec, attribs?: Attribs): Circle;
 export declare function circle(r: number, attribs?: Attribs): Circle;
 export declare function circle(attribs?: Attribs): Circle;
-export declare const circleFrom2Points: (a: ReadonlyVec, b: ReadonlyVec, attribs?: Attribs | undefined) => Circle;
-export declare const circleFrom3Points: (a: ReadonlyVec, b: ReadonlyVec, c: ReadonlyVec, attribs?: Attribs | undefined) => Circle | undefined;
+export declare const circleFrom2Points: (a: ReadonlyVec, b: ReadonlyVec, attribs?: Attribs) => Circle;
+export declare const circleFrom3Points: (a: ReadonlyVec, b: ReadonlyVec, c: ReadonlyVec, attribs?: Attribs) => Circle | undefined;
 //# sourceMappingURL=circle.d.ts.map

package/cubic.d.ts

@@ -5,6 +5,6 @@ import { Cubic } from "./api/cubic.js";
 export declare function cubic(a: Vec, b: Vec, c: Vec, d: Vec, attribs?: Attribs): Cubic;
 export declare function cubic(pts: Vec[], attribs?: Attribs): Cubic;
 export declare const cubicFromArc: (arc: Arc) => Cubic[];
-export declare const cubicFromLine: (a: Vec, b: Vec, attribs?: Attribs | undefined) => Cubic;
-export declare const cubicFromQuadratic: (a: Vec, b: Vec, c: Vec, attribs?: Attribs | undefined) => Cubic;
+export declare const cubicFromLine: (a: Vec, b: Vec, attribs?: Attribs) => Cubic;
+export declare const cubicFromQuadratic: (a: Vec, b: Vec, c: Vec, attribs?: Attribs) => Cubic;
 //# sourceMappingURL=cubic.d.ts.map

package/group.d.ts

@@ -1,4 +1,4 @@
 import type { Attribs, IHiccupShape } from "@thi.ng/geom-api";
 import { Group } from "./api/group.js";
-export declare const group: (attribs?: Attribs, children?: IHiccupShape[] | undefined) => Group;
+export declare const group: (attribs?: Attribs, children?: IHiccupShape[]) => Group;
 //# sourceMappingURL=group.d.ts.map

package/internal/bounds.d.ts

@@ -2,10 +2,10 @@ import type { Fn } from "@thi.ng/api";
 import type { AABBLike, IShape } from "@thi.ng/geom-api";
 import type { ReadonlyVec, VecPair } from "@thi.ng/vectors";
 /**
- * Computes the total bounds for the given shape collection, which
- * should either contain only 2D or 3D types. No mixed dimensions are
- * allowed! Currently the {@link bounds} function MUST be passed in as
- * arg to avoid circular module dependencies.
+ * Computes the total bounds for the given shape collection, which should either
+ * contain only 2D or 3D types. No mixed dimensions are allowed! Currently the
+ * {@link bounds} function MUST be passed in as arg to avoid circular module
+ * dependencies. Returns 2-tuple of `[pos, size]`.
  *
  * @param shapes - input shapes
  * @param bounds - bbox function

package/internal/bounds.js

@@ -3,10 +3,10 @@ import { max } from "@thi.ng/vectors/max";
 import { min } from "@thi.ng/vectors/min";
 import { sub } from "@thi.ng/vectors/sub";
 /**
- * Computes the total bounds for the given shape collection, which
- * should either contain only 2D or 3D types. No mixed dimensions are
- * allowed! Currently the {@link bounds} function MUST be passed in as
- * arg to avoid circular module dependencies.
+ * Computes the total bounds for the given shape collection, which should either
+ * contain only 2D or 3D types. No mixed dimensions are allowed! Currently the
+ * {@link bounds} function MUST be passed in as arg to avoid circular module
+ * dependencies. Returns 2-tuple of `[pos, size]`.
  *
  * @param shapes - input shapes
  * @param bounds - bbox function

package/internal/copy.d.ts

@@ -1,4 +1,6 @@
 import type { Attribs, IShape, PCLike, PCLikeConstructor } from "@thi.ng/geom-api";
+/** @internal */
 export declare const __copyAttribs: ($: IShape) => Attribs;
-export declare const __copyShape: (ctor: PCLikeConstructor, inst: PCLike) => PCLike;
+/** @internal */
+export declare const __copyShape: <T extends PCLike>(ctor: PCLikeConstructor, inst: T) => T;
 //# sourceMappingURL=copy.d.ts.map

package/internal/copy.js

@@ -1,3 +1,6 @@
+// thing:export
 import { copyVectors } from "@thi.ng/vectors/copy";
+/** @internal */
 export const __copyAttribs = ($) => ({ ...$.attribs });
+/** @internal */
 export const __copyShape = (ctor, inst) => new ctor(copyVectors(inst.points), __copyAttribs(inst));

package/internal/dispatch.d.ts

@@ -1,4 +1,6 @@
 import type { IShape } from "@thi.ng/geom-api";
+/** @internal */
 export declare const __dispatch: (x: IShape) => string | number;
+/** @internal */
 export declare const __dispatch2: (a: IShape, b: IShape) => string;
 //# sourceMappingURL=dispatch.d.ts.map

package/internal/dispatch.js

@@ -1,2 +1,4 @@
+/** @internal */
 export const __dispatch = (x) => x.type;
+/** @internal */
 export const __dispatch2 = (a, b) => a.type + "-" + b.type;

package/internal/points-as-shape.d.ts

@@ -1,4 +1,4 @@
 import type { Attribs, PCLikeConstructor } from "@thi.ng/geom-api";
 import type { Vec } from "@thi.ng/vectors";
-export declare const __pointArraysAsShapes: (ctor: PCLikeConstructor, src?: Iterable<Vec[]> | undefined, attribs?: Attribs | undefined) => import("@thi.ng/geom-api").PCLike[] | undefined;
+export declare const __pointArraysAsShapes: (ctor: PCLikeConstructor, src?: Iterable<Vec[]>, attribs?: Attribs) => import("@thi.ng/geom-api").PCLike[] | undefined;
 //# sourceMappingURL=points-as-shape.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/geom",
-  "version": "3.2.4",
+  "version": "3.3.0",
   "description": "Functional, polymorphic API for 2D geometry types & SVG generation",
   "type": "module",
   "module": "./index.js",
@@ -35,41 +35,41 @@
     "tool:bpatch": "tools:node-esm tools/bpatch.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.6",
-    "@thi.ng/arrays": "^2.2.3",
-    "@thi.ng/associative": "^6.1.8",
-    "@thi.ng/checks": "^3.1.6",
-    "@thi.ng/defmulti": "^2.1.6",
-    "@thi.ng/equiv": "^2.1.6",
-    "@thi.ng/errors": "^2.1.6",
-    "@thi.ng/geom-api": "^3.1.12",
-    "@thi.ng/geom-arc": "^2.1.12",
-    "@thi.ng/geom-clip-line": "^2.1.12",
-    "@thi.ng/geom-clip-poly": "^2.1.12",
-    "@thi.ng/geom-closest-point": "^2.1.12",
-    "@thi.ng/geom-hull": "^2.1.12",
-    "@thi.ng/geom-isec": "^2.1.12",
-    "@thi.ng/geom-poly-utils": "^2.2.4",
-    "@thi.ng/geom-resample": "^2.1.12",
-    "@thi.ng/geom-splines": "^2.1.12",
-    "@thi.ng/geom-subdiv-curve": "^2.1.12",
-    "@thi.ng/geom-tessellate": "^2.1.12",
-    "@thi.ng/hiccup": "^4.2.7",
-    "@thi.ng/hiccup-svg": "^4.2.12",
-    "@thi.ng/math": "^5.3.2",
-    "@thi.ng/matrices": "^2.1.12",
-    "@thi.ng/random": "^3.3.0",
-    "@thi.ng/strings": "^3.3.4",
-    "@thi.ng/transducers": "^8.3.3",
-    "@thi.ng/vectors": "^7.5.4"
+    "@thi.ng/api": "^8.3.7",
+    "@thi.ng/arrays": "^2.2.5",
+    "@thi.ng/associative": "^6.1.10",
+    "@thi.ng/checks": "^3.2.1",
+    "@thi.ng/defmulti": "^2.1.7",
+    "@thi.ng/equiv": "^2.1.7",
+    "@thi.ng/errors": "^2.1.7",
+    "@thi.ng/geom-api": "^3.2.0",
+    "@thi.ng/geom-arc": "^2.1.15",
+    "@thi.ng/geom-clip-line": "^2.1.15",
+    "@thi.ng/geom-clip-poly": "^2.1.15",
+    "@thi.ng/geom-closest-point": "^2.1.14",
+    "@thi.ng/geom-hull": "^2.1.14",
+    "@thi.ng/geom-isec": "^2.1.15",
+    "@thi.ng/geom-poly-utils": "^2.2.7",
+    "@thi.ng/geom-resample": "^2.1.15",
+    "@thi.ng/geom-splines": "^2.1.15",
+    "@thi.ng/geom-subdiv-curve": "^2.1.15",
+    "@thi.ng/geom-tessellate": "^2.1.15",
+    "@thi.ng/hiccup": "^4.2.9",
+    "@thi.ng/hiccup-svg": "^4.3.0",
+    "@thi.ng/math": "^5.3.3",
+    "@thi.ng/matrices": "^2.1.14",
+    "@thi.ng/random": "^3.3.2",
+    "@thi.ng/strings": "^3.3.5",
+    "@thi.ng/transducers": "^8.3.5",
+    "@thi.ng/vectors": "^7.5.6"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.23.1",
-    "@thi.ng/testament": "^0.2.7",
+    "@microsoft/api-extractor": "^7.25.0",
+    "@thi.ng/testament": "^0.2.8",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.22.15",
-    "typescript": "^4.6.4"
+    "typedoc": "^0.22.17",
+    "typescript": "^4.7.3"
   },
   "keywords": [
     "2d",
@@ -247,6 +247,15 @@
     "./group": {
       "default": "./group.js"
     },
+    "./internal/copy": {
+      "default": "./internal/copy.js"
+    },
+    "./internal/dispatch": {
+      "default": "./internal/dispatch.js"
+    },
+    "./internal/transform": {
+      "default": "./internal/transform.js"
+    },
     "./intersects": {
       "default": "./intersects.js"
     },
@@ -362,5 +371,5 @@
   "thi.ng": {
     "year": 2013
   },
-  "gitHead": "e23901b8582af71d8a29e0ce4929f15ac509f9e5\n"
+  "gitHead": "f50e292ecc7dc74a6705b07fc739bf827cc5efd7\n"
 }

package/path-builder.d.ts

@@ -40,5 +40,5 @@ export declare class PathBuilder {
     protected addCubic(cp1: Vec, cp2: Vec, p: Vec, relative: boolean): void;
     protected addQuadratic(cp: Vec, p: Vec, relative: boolean): void;
 }
-export declare const pathBuilder: (attribs?: Attribs | undefined, opts?: Partial<PathBuilderOpts> | undefined) => PathBuilder;
+export declare const pathBuilder: (attribs?: Attribs, opts?: Partial<PathBuilderOpts>) => PathBuilder;
 //# sourceMappingURL=path-builder.d.ts.map

package/path.d.ts

@@ -2,8 +2,8 @@ import type { Attribs, PathSegment } from "@thi.ng/geom-api";
 import type { Vec } from "@thi.ng/vectors";
 import type { Cubic } from "./api/cubic.js";
 import { Path } from "./api/path.js";
-export declare const path: (segments: PathSegment[], attribs?: Attribs | undefined) => Path;
-export declare const pathFromCubics: (cubics: Cubic[], attribs?: Attribs | undefined) => Path;
+export declare const path: (segments: PathSegment[], attribs?: Attribs) => Path;
+export declare const pathFromCubics: (cubics: Cubic[], attribs?: Attribs) => Path;
 export declare const normalizedPath: (path: Path) => Path;
-export declare const roundedRect: (pos: Vec, size: Vec, r: number | Vec, attribs?: Attribs | undefined) => Path;
+export declare const roundedRect: (pos: Vec, size: Vec, r: number | Vec, attribs?: Attribs) => Path;
 //# sourceMappingURL=path.d.ts.map

package/plane.d.ts

@@ -1,7 +1,7 @@
 import type { Attribs } from "@thi.ng/geom-api";
 import type { ReadonlyVec, Vec } from "@thi.ng/vectors";
 import { Plane } from "./api/plane.js";
-export declare const plane: (normal: Vec, w: number, attribs?: Attribs | undefined) => Plane;
-export declare const planeWithPoint: (normal: Vec, p: ReadonlyVec, attribs?: Attribs | undefined) => Plane;
-export declare const planeFrom3Points: (a: ReadonlyVec, b: ReadonlyVec, c: ReadonlyVec, attribs?: Attribs | undefined) => Plane;
+export declare const plane: (normal: Vec, w: number, attribs?: Attribs) => Plane;
+export declare const planeWithPoint: (normal: Vec, p: ReadonlyVec, attribs?: Attribs) => Plane;
+export declare const planeFrom3Points: (a: ReadonlyVec, b: ReadonlyVec, c: ReadonlyVec, attribs?: Attribs) => Plane;
 //# sourceMappingURL=plane.d.ts.map

package/points.d.ts

@@ -1,6 +1,6 @@
 import type { Attribs } from "@thi.ng/geom-api";
 import type { Vec } from "@thi.ng/vectors";
 import { Points, Points3 } from "./api/points.js";
-export declare const points: (pts?: Vec[] | undefined, attribs?: Attribs | undefined) => Points;
-export declare const points3: (pts?: Vec[] | undefined, attribs?: Attribs | undefined) => Points3;
+export declare const points: (pts?: Vec[], attribs?: Attribs) => Points;
+export declare const points3: (pts?: Vec[], attribs?: Attribs) => Points3;
 //# sourceMappingURL=points.d.ts.map

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[] | undefined, attribs?: Attribs | undefined) => Polygon;
-export declare const star: (r: number, n: number, profile: number[], attribs?: Attribs | undefined) => Polygon;
+export declare const polygon: (pts?: Vec[], attribs?: Attribs) => Polygon;
+export declare const star: (r: number, n: number, profile: number[], attribs?: Attribs) => Polygon;
 //# sourceMappingURL=polygon.d.ts.map

package/polyline.d.ts

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

package/quad.d.ts

@@ -7,5 +7,5 @@ export declare function quad(a: Vec, b: Vec, c: Vec, d: Vec, attribs?: Attribs):
 export declare function quad(pts: Vec[], attribs?: Attribs): Quad;
 export declare function quad3(a: Vec, b: Vec, c: Vec, d: Vec, attribs?: Attribs): Quad;
 export declare function quad3(pts: Vec[], attribs?: Attribs): Quad;
-export declare const quadOnPlane: (plane: Plane, pos: ReadonlyVec, size: number | ReadonlyVec, attribs?: Attribs | undefined) => Quad3;
+export declare const quadOnPlane: (plane: Plane, pos: ReadonlyVec, size: number | ReadonlyVec, attribs?: Attribs) => Quad3;
 //# sourceMappingURL=quad.d.ts.map

package/quadratic.d.ts

@@ -3,5 +3,5 @@ import type { Vec } from "@thi.ng/vectors";
 import { Quadratic } from "./api/quadratic.js";
 export declare function quadratic(a: Vec, b: Vec, c: Vec, attribs?: Attribs): Quadratic;
 export declare function quadratic(pts: Vec[], attribs?: Attribs): Quadratic;
-export declare const quadraticFromLine: (a: Vec, b: Vec, attribs?: Attribs | undefined) => Quadratic;
+export declare const quadraticFromLine: (a: Vec, b: Vec, attribs?: Attribs) => Quadratic;
 //# sourceMappingURL=quadratic.d.ts.map

package/ray.d.ts

@@ -1,5 +1,5 @@
 import type { Attribs } from "@thi.ng/geom-api";
 import type { Vec } from "@thi.ng/vectors";
 import { Ray } from "./api/ray.js";
-export declare const ray: (pos: Vec, dir: Vec, attribs?: Attribs | undefined, normalize?: boolean) => Ray;
+export declare const ray: (pos: Vec, dir: Vec, attribs?: Attribs, normalize?: boolean) => Ray;
 //# sourceMappingURL=ray.d.ts.map

package/rect.d.ts

@@ -6,8 +6,10 @@ import { Rect } from "./api/rect.js";
 export declare function rect(pos: Vec, size: number | Vec, attribs?: Attribs): Rect;
 export declare function rect(size: number | Vec, attribs?: Attribs): Rect;
 export declare function rect(attribs?: Attribs): Rect;
-export declare const rectFromMinMax: (min: Vec, max: Vec, attribs?: Attribs | undefined) => Rect;
-export declare const rectFromCentroid: (centroid: Vec, size: Vec, attribs?: Attribs | undefined) => Rect;
+export declare const rectFromMinMax: (min: Vec, max: Vec, attribs?: Attribs) => Rect;
+export declare const rectFromMinMaxWithMargin: (min: Vec, max: Vec, margin: number, attribs?: Attribs) => Rect;
+export declare const rectFromCentroid: (centroid: Vec, size: Vec, attribs?: Attribs) => Rect;
+export declare const rectFromCentroidWithMargin: (centroid: Vec, size: Vec, margin: number, attribs?: Attribs) => Rect;
 /**
  * Returns the intersection rect of given inputs or `undefined` if they
  * are non-overlapping.

package/rect.js

@@ -14,7 +14,9 @@ export function rect(...args) {
     return new Rect(...__argsVV(args));
 }
 export const rectFromMinMax = (min, max, attribs) => new Rect(min, sub2([], max, min), attribs);
+export const rectFromMinMaxWithMargin = (min, max, margin, attribs) => rectFromMinMax(min, max, attribs).offset(margin);
 export const rectFromCentroid = (centroid, size, attribs) => new Rect(maddN2([], size, -0.5, centroid), size, attribs);
+export const rectFromCentroidWithMargin = (centroid, size, margin, attribs) => rectFromCentroid(centroid, size, attribs).offset(margin);
 /**
  * Returns the intersection rect of given inputs or `undefined` if they
  * are non-overlapping.

package/sphere.d.ts

@@ -5,5 +5,5 @@ export declare function sphere(pos: Vec, r: number, attribs?: Attribs): Sphere;
 export declare function sphere(pos: Vec, attribs?: Attribs): Sphere;
 export declare function sphere(r: number, attribs?: Attribs): Sphere;
 export declare function sphere(attribs?: Attribs): Sphere;
-export declare const sphereFrom2Points: (a: ReadonlyVec, b: ReadonlyVec, attribs?: Attribs | undefined) => Sphere;
+export declare const sphereFrom2Points: (a: ReadonlyVec, b: ReadonlyVec, attribs?: Attribs) => Sphere;
 //# sourceMappingURL=sphere.d.ts.map

package/text.d.ts

@@ -1,5 +1,5 @@
 import type { Attribs } from "@thi.ng/geom-api";
 import type { Vec } from "@thi.ng/vectors";
 import { Text } from "./api/text.js";
-export declare const text: (pos: Vec, body: any, attribs?: Attribs | undefined) => Text;
+export declare const text: (pos: Vec, body: any, attribs?: Attribs) => Text;
 //# sourceMappingURL=text.d.ts.map

package/triangle.d.ts

@@ -3,5 +3,5 @@ import type { Vec } from "@thi.ng/vectors";
 import { Triangle } from "./api/triangle.js";
 export declare function triangle(a: Vec, b: Vec, c: Vec, attribs?: Attribs): Triangle;
 export declare function triangle(pts: Vec[], attribs?: Attribs): Triangle;
-export declare const equilateralTriangle: (a: Vec, b: Vec, attribs?: Attribs | undefined) => Triangle;
+export declare const equilateralTriangle: (a: Vec, b: Vec, attribs?: Attribs) => Triangle;
 //# sourceMappingURL=triangle.d.ts.map

package/warp-points.d.ts

@@ -3,5 +3,5 @@ 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[];
+export declare const warpPointsBPatch: (pts: ReadonlyVec[], dest: BPatch, src?: Rect, out?: Vec[]) => Vec[];
 //# sourceMappingURL=warp-points.d.ts.map