add isBlockGroupPositionEqual

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "blockwise",
-	"version": "2.11.1",
+	"version": "2.12.0",
 	"description": "Minimalistic utility lib for writing simple 2d games where everything is a block.",
 	"main": "dist/index.js",
 	"repository": {

src/index.ts

@@ -10,6 +10,7 @@ export { isBlockColliding } from "./is-block-colliding";
 export { isBlockEqual } from "./is-block-equal";
 export { isBlockGroupColliding } from "./is-block-group-colliding";
 export { isBlockGroupCollidingBlockGroup } from "./is-block-group-colliding-block-group";
+export { isBlockGroupPositionEqual } from "./is-block-group-position-equal";
 export { isBlockIncluding } from "./is-block-including";
 export { isBlockNotEqual } from "./is-block-not-equal";
 export { isBlockPositionEqual } from "./is-block-position-equal";

src/is-block-group-position-equal.example.ts

@@ -0,0 +1,8 @@
+import { Block, isBlockGroupPositionEqual } from "blockwise";
+
+const a: Block[] = [{ x: 0, y: 0, w: 2, h: 2 }, { x: 0, y: 0, w: 1, h: 1 }];
+const b: Block = { x: 0, y: 0, w: 1, h: 1 };
+const c: Block = { x: 0, y: 1, w: 3, h: 3 };
+
+console.log(isBlockGroupPositionEqual(a, b)); // true
+console.log(isBlockGroupPositionEqual(a, c)); // false

src/is-block-group-position-equal.test.ts

@@ -0,0 +1,21 @@
+import { test, expect } from "vitest";
+import type { Block } from "./block";
+import { isBlockGroupPositionEqual } from "./is-block-group-position-equal";
+
+test("should return true when block group is same position as block", function() {
+	const a: Block[] = [{ x: 0, y: 0, w: 2, h: 2 }, { x: 0, y: 0, w: 1, h: 1 }];
+	const b: Block = { x: 0, y: 0, w: 1, h: 1 };
+	expect(isBlockGroupPositionEqual(a, b)).toEqual(true);
+});
+
+test("should return true when block group with some equal position is same position as block", function() {
+	const a: Block[] = [{ x: 0, y: 0, w: 2, h: 2 }, { x: 0, y: 1, w: 1, h: 1 }];
+	const b: Block = { x: 0, y: 0, w: 1, h: 1 };
+	expect(isBlockGroupPositionEqual(a, b)).toEqual(true);
+});
+
+test("should return false when block group is not the same position as block", function() {
+	const a: Block[] = [{ x: 0, y: 0, w: 2, h: 2 }, { x: 0, y: 0, w: 1, h: 1 }];
+	const b: Block = { x: 0, y: 1, w: 3, h: 3 };
+	expect(isBlockGroupPositionEqual(a, b)).toEqual(false);
+});

src/is-block-group-position-equal.ts

@@ -0,0 +1,10 @@
+import { Block, isBlockPositionEqual } from "blockwise";
+
+/**
+ * Check if a group of block is the same position as a block
+ *
+ * @includeExample ./src/is-block-group-position-equal.example.ts
+ */
+export function isBlockGroupPositionEqual(a: Block[], b: Block): boolean {
+	return a.some((block) => isBlockPositionEqual(b, block));
+}