isaacscript-common 30.0.0 → 30.1.0

package/dist/index.rollup.d.ts

@@ -4618,6 +4618,15 @@ export declare function getClosestEntityTo<T extends AnyEntity>(referenceEntity:
 
 export declare function getClosestPlayer(position: Vector): EntityPlayer;
 
+/**
+ * Given an array of vectors, this helper function returns the closest one to a provided reference
+ * vector.
+ *
+ * @param referenceVector The vector to compare against.
+ * @param vectors The array of vectors to look through.
+ */
+export declare function getClosestVectorTo(referenceVector: Vector, vectors: Vector[]): Vector | undefined;
+
 /**
  * Helper function to get all of the coin pickup entities in the room.
  *

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 30.0.0
+isaacscript-common 30.1.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -17838,6 +17838,18 @@ function ____exports.doesVectorHaveLength(self, vector, threshold)
     end
     return vector:Length() >= threshold
 end
+function ____exports.getClosestVectorTo(self, referenceVector, vectors)
+    local closestVector
+    local closestDistance = math.huge
+    for ____, vector in ipairs(vectors) do
+        local distance = referenceVector:Distance(vector)
+        if distance < closestDistance then
+            closestVector = vector
+            closestDistance = distance
+        end
+    end
+    return closestVector
+end
 function ____exports.getRandomVector(self, seedOrRNG)
     if seedOrRNG == nil then
         seedOrRNG = getRandomSeed(nil)

package/dist/src/functions/vector.d.ts

@@ -23,6 +23,14 @@ export declare function deserializeVector(vector: SerializedVector): Vector;
  *                  0.01.
  */
 export declare function doesVectorHaveLength(vector: Vector, threshold?: number): boolean;
+/**
+ * Given an array of vectors, this helper function returns the closest one to a provided reference
+ * vector.
+ *
+ * @param referenceVector The vector to compare against.
+ * @param vectors The array of vectors to look through.
+ */
+export declare function getClosestVectorTo(referenceVector: Vector, vectors: Vector[]): Vector | undefined;
 /**
  * Helper function to get a random vector between (-1, -1) and (1, 1).
  *

package/dist/src/functions/vector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../../src/functions/vector.ts"],"names":[],"mappings":";AAAA,OAAO,EACL,yBAAyB,EACzB,SAAS,EACV,MAAM,8BAA8B,CAAC;AAatC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC;CACnD,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqBlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,SAAS,SAAO,GACf,OAAO,CAET;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,QAAQ,CAAC,MAAM,CAAC,CAOlB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,gBAAgB,CAM5B;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAG3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,MAAM,CAIpE"}
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../../src/functions/vector.ts"],"names":[],"mappings":";AAAA,OAAO,EACL,yBAAyB,EACzB,SAAS,EACV,MAAM,8BAA8B,CAAC;AAatC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC;CACnD,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqBlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,SAAS,SAAO,GACf,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,GAAG,SAAS,CAapB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,QAAQ,CAAC,MAAM,CAAC,CAOlB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,gBAAgB,CAM5B;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAG3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,MAAM,CAIpE"}

package/dist/src/functions/vector.lua

@@ -67,6 +67,23 @@ function ____exports.doesVectorHaveLength(self, vector, threshold)
     end
     return vector:Length() >= threshold
 end
+--- Given an array of vectors, this helper function returns the closest one to a provided reference
+-- vector.
+-- 
+-- @param referenceVector The vector to compare against.
+-- @param vectors The array of vectors to look through.
+function ____exports.getClosestVectorTo(self, referenceVector, vectors)
+    local closestVector
+    local closestDistance = math.huge
+    for ____, vector in ipairs(vectors) do
+        local distance = referenceVector:Distance(vector)
+        if distance < closestDistance then
+            closestVector = vector
+            closestDistance = distance
+        end
+    end
+    return closestVector
+end
 --- Helper function to get a random vector between (-1, -1) and (1, 1).
 -- 
 -- To get random vectors with a bigger length, multiply this with a number.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "30.0.0",
+  "version": "30.1.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/functions/vector.ts

@@ -78,6 +78,31 @@ export function doesVectorHaveLength(
   return vector.Length() >= threshold;
 }
 
+/**
+ * Given an array of vectors, this helper function returns the closest one to a provided reference
+ * vector.
+ *
+ * @param referenceVector The vector to compare against.
+ * @param vectors The array of vectors to look through.
+ */
+export function getClosestVectorTo(
+  referenceVector: Vector,
+  vectors: Vector[],
+): Vector | undefined {
+  let closestVector: Vector | undefined;
+  let closestDistance = math.huge;
+  for (const vector of vectors) {
+    const distance = referenceVector.Distance(vector);
+
+    if (distance < closestDistance) {
+      closestVector = vector;
+      closestDistance = distance;
+    }
+  }
+
+  return closestVector;
+}
+
 /**
  * Helper function to get a random vector between (-1, -1) and (1, 1).
  *