@js-draw/math 1.24.2 → 1.26.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-2024 Henry Heino
+Copyright (c) 2023-2025 Henry Heino
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/cjs/shapes/Rect2.d.ts

@@ -52,6 +52,13 @@ export declare class Rect2 extends Abstract2DShape {
     divideIntoGrid(columns: number, rows: number): Rect2[];
     grownToPoint(point: Point2, margin?: number): Rect2;
     grownBy(margin: number): Rect2;
+    /**
+     * If this rectangle is smaller than `minSize`, returns a copy of this
+     * with a larger width/height.
+     *
+     * If smaller than `minSize`, padding is applied on both sides.
+     */
+    grownToSize(minSize: Vec2): Rect2;
     getClosestPointOnBoundaryTo(target: Point2): Vec3;
     /**
      * Returns `true` iff all points in this rectangle are within `distance` from `point`:

package/dist/cjs/shapes/Rect2.js

@@ -155,6 +155,20 @@ class Rect2 extends Abstract2DShape_1.default {
         }
         return new Rect2(this.x - margin, this.y - margin, this.w + margin * 2, this.h + margin * 2);
     }
+    /**
+     * If this rectangle is smaller than `minSize`, returns a copy of this
+     * with a larger width/height.
+     *
+     * If smaller than `minSize`, padding is applied on both sides.
+     */
+    grownToSize(minSize) {
+        if (this.width >= minSize.x && this.height >= minSize.y) {
+            return this;
+        }
+        const deltaWidth = Math.max(0, minSize.x - this.width);
+        const deltaHeight = Math.max(0, minSize.y - this.height);
+        return new Rect2(this.x - deltaWidth / 2, this.y - deltaHeight / 2, this.width + deltaWidth, this.height + deltaHeight);
+    }
     getClosestPointOnBoundaryTo(target) {
         const closestEdgePoints = this.getEdges().map((edge) => {
             return edge.closestPointTo(target);

package/dist/mjs/shapes/Rect2.d.ts

@@ -52,6 +52,13 @@ export declare class Rect2 extends Abstract2DShape {
     divideIntoGrid(columns: number, rows: number): Rect2[];
     grownToPoint(point: Point2, margin?: number): Rect2;
     grownBy(margin: number): Rect2;
+    /**
+     * If this rectangle is smaller than `minSize`, returns a copy of this
+     * with a larger width/height.
+     *
+     * If smaller than `minSize`, padding is applied on both sides.
+     */
+    grownToSize(minSize: Vec2): Rect2;
     getClosestPointOnBoundaryTo(target: Point2): Vec3;
     /**
      * Returns `true` iff all points in this rectangle are within `distance` from `point`:

package/dist/mjs/shapes/Rect2.mjs

@@ -149,6 +149,20 @@ export class Rect2 extends Abstract2DShape {
         }
         return new Rect2(this.x - margin, this.y - margin, this.w + margin * 2, this.h + margin * 2);
     }
+    /**
+     * If this rectangle is smaller than `minSize`, returns a copy of this
+     * with a larger width/height.
+     *
+     * If smaller than `minSize`, padding is applied on both sides.
+     */
+    grownToSize(minSize) {
+        if (this.width >= minSize.x && this.height >= minSize.y) {
+            return this;
+        }
+        const deltaWidth = Math.max(0, minSize.x - this.width);
+        const deltaHeight = Math.max(0, minSize.y - this.height);
+        return new Rect2(this.x - deltaWidth / 2, this.y - deltaHeight / 2, this.width + deltaWidth, this.height + deltaHeight);
+    }
     getClosestPointOnBoundaryTo(target) {
         const closestEdgePoints = this.getEdges().map((edge) => {
             return edge.closestPointTo(target);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@js-draw/math",
-	"version": "1.24.2",
+	"version": "1.26.0",
 	"description": "A math library for js-draw. ",
 	"types": "./dist/mjs/lib.d.ts",
 	"main": "./dist/cjs/lib.js",
@@ -27,7 +27,7 @@
 		"bezier-js": "6.1.3"
 	},
 	"devDependencies": {
-		"@js-draw/build-tool": "^1.24.2",
+		"@js-draw/build-tool": "^1.26.0",
 		"@types/bezier-js": "4.1.0",
 		"@types/jest": "29.5.5",
 		"@types/jsdom": "21.1.3"
@@ -44,5 +44,5 @@
 		"svg",
 		"math"
 	],
-	"gitHead": "32c8db56fc8996c8d485118d1ee37077428344a3"
+	"gitHead": "6529cad584ca93a992f2576a43f25af48da3d707"
 }

package/src/shapes/Rect2.test.ts

@@ -138,6 +138,14 @@ describe('Rect2', () => {
 		expect(new Rect2(1, 2, 2, 8).grownBy(-2)).objEq(new Rect2(2, 4, 0, 4));
 	});
 
+	it('.grownToSize should grow the rectangle to the given minimum size', () => {
+		expect(Rect2.empty.grownToSize(Vec2.of(10, 10))).objEq(new Rect2(-5, -5, 10, 10));
+		expect(Rect2.empty.grownToSize(Vec2.of(10, 4))).objEq(new Rect2(-5, -2, 10, 4));
+
+		expect(Rect2.unitSquare.grownToSize(Vec2.of(0.5, 0.5))).toBe(Rect2.unitSquare);
+		expect(new Rect2(0, 0, 2, 2).grownToSize(Vec2.of(4, 0.5))).objEq(new Rect2(-1, 0, 4, 2));
+	});
+
 	describe('should correctly expand to include a given point', () => {
 		it('Growing an empty rectange to include (1, 0)', () => {
 			const originalRect = Rect2.empty;

package/src/shapes/Rect2.ts

@@ -200,6 +200,28 @@ export class Rect2 extends Abstract2DShape {
 		return new Rect2(this.x - margin, this.y - margin, this.w + margin * 2, this.h + margin * 2);
 	}
 
+	/**
+	 * If this rectangle is smaller than `minSize`, returns a copy of this
+	 * with a larger width/height.
+	 *
+	 * If smaller than `minSize`, padding is applied on both sides.
+	 */
+	public grownToSize(minSize: Vec2) {
+		if (this.width >= minSize.x && this.height >= minSize.y) {
+			return this;
+		}
+
+		const deltaWidth = Math.max(0, minSize.x - this.width);
+		const deltaHeight = Math.max(0, minSize.y - this.height);
+
+		return new Rect2(
+			this.x - deltaWidth / 2,
+			this.y - deltaHeight / 2,
+			this.width + deltaWidth,
+			this.height + deltaHeight,
+		);
+	}
+
 	public getClosestPointOnBoundaryTo(target: Point2) {
 		const closestEdgePoints = this.getEdges().map((edge) => {
 			return edge.closestPointTo(target);