isaacscript-common 15.0.4 → 15.0.5

package/dist/index.d.ts

@@ -4704,6 +4704,9 @@ export declare function getGridEntities(...gridEntityTypes: GridEntityType[]): G
  */
 export declare function getGridEntitiesExcept(...gridEntityTypes: GridEntityType[]): GridEntity[];
 
+/** Helper function to get all grid entities in a given radius around a given point. */
+export declare function getGridEntitiesInRadius(targetPosition: Vector, radius: number): GridEntity[];
+
 /**
  * Helper function to get a map of every grid entity in the current room. The indexes of the map are
  * equal to the grid index. The values of the map are equal to the grid entities.
@@ -4713,6 +4716,9 @@ export declare function getGridEntitiesExcept(...gridEntityTypes: GridEntityType
  */
 export declare function getGridEntitiesMap(...gridEntityTypes: GridEntityType[]): Map<int, GridEntity>;
 
+/** Helper function to get the top left and bottom right corners of a given grid entity. */
+export declare function getGridEntityCollisionPoints(gridEntity: GridEntity): [topLeft: Vector, bottomRight: Vector];
+
 /** Helper function to get a string containing the grid entity's type and variant. */
 export declare function getGridEntityID(gridEntity: GridEntity): string;
 
@@ -12306,7 +12312,7 @@ export declare function roomUpdateSafe(): void;
  * From: http://lua-users.org/wiki/SimpleRound
  *
  * @param num The number to round.
- * @param numDecimalPlaces Default is 0.
+ * @param numDecimalPlaces Optional. Default is 0.
  */
 export declare function round(num: float, numDecimalPlaces?: number): float;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 15.0.4
+isaacscript-common 15.0.5
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -25434,6 +25434,7 @@ local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
 local ____constants = require("src.core.constants")
 local DISTANCE_OF_GRID_TILE = ____constants.DISTANCE_OF_GRID_TILE
+local VectorOne = ____constants.VectorOne
 local ____gridEntityTypeToBrokenStateMap = require("src.maps.gridEntityTypeToBrokenStateMap")
 local GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP = ____gridEntityTypeToBrokenStateMap.GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP
 local ____gridEntityXMLMap = require("src.maps.gridEntityXMLMap")
@@ -25456,6 +25457,7 @@ local asNumber = ____types.asNumber
 local isNumber = ____types.isNumber
 local ____utils = require("src.functions.utils")
 local eRange = ____utils.eRange
+local iRange = ____utils.iRange
 local ____vector = require("src.functions.vector")
 local isVector = ____vector.isVector
 local vectorEquals = ____vector.vectorEquals
@@ -25475,6 +25477,11 @@ function getAllGridEntities(self)
     end
     return gridEntities
 end
+function ____exports.getGridEntityCollisionPoints(self, gridEntity)
+    local topLeft = Vector(gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2)
+    local bottomRight = Vector(gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2)
+    return {topLeft, bottomRight}
+end
 function ____exports.getTopLeftWallGridIndex(self)
     local room = game:GetRoom()
     local roomShape = room:GetRoomShape()
@@ -25568,8 +25575,7 @@ function ____exports.convertXMLGridEntityType(self, gridEntityXMLType, gridEntit
     return {gridEntityType, variant}
 end
 function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
-    local gridEntityCollisionTopLeft = Vector(gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2)
-    local gridEntityCollisionBottomRight = Vector(gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2)
+    local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
     local closeEntities = Isaac.FindInRadius(gridEntity.Position, DISTANCE_OF_GRID_TILE * 2)
     return __TS__ArrayFilter(
         closeEntities,
@@ -25577,8 +25583,8 @@ function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
             nil,
             entity.Position,
             entity.Size + 0.1,
-            gridEntityCollisionTopLeft,
-            gridEntityCollisionBottomRight
+            topLeft,
+            bottomRight
         ) end
     )
 end
@@ -25612,6 +25618,42 @@ function ____exports.getGridEntitiesExcept(self, ...)
         end
     )
 end
+function ____exports.getGridEntitiesInRadius(self, targetPosition, radius)
+    radius = math.abs(radius)
+    local topLeftOffset = VectorOne * -radius
+    local mostTopLeftPosition = targetPosition + topLeftOffset
+    local room = game:GetRoom()
+    local diameter = radius * 2
+    local iterations = math.ceil(diameter / DISTANCE_OF_GRID_TILE)
+    local separation = diameter / iterations
+    local gridEntities = {}
+    local registeredGridIndexes = __TS__New(Set)
+    for ____, x in ipairs(iRange(nil, iterations)) do
+        for ____, y in ipairs(iRange(nil, iterations)) do
+            do
+                local position = mostTopLeftPosition + Vector(x * separation, y * separation)
+                local gridIndex = room:GetGridIndex(position)
+                local gridEntity = room:GetGridEntityFromPos(position)
+                if gridEntity == nil or registeredGridIndexes:has(gridIndex) then
+                    goto __continue20
+                end
+                registeredGridIndexes:add(gridIndex)
+                local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
+                if isCircleIntersectingRectangle(
+                    nil,
+                    targetPosition,
+                    radius,
+                    topLeft,
+                    bottomRight
+                ) then
+                    gridEntities[#gridEntities + 1] = gridEntity
+                end
+            end
+            ::__continue20::
+        end
+    end
+    return gridEntities
+end
 function ____exports.getGridEntitiesMap(self, ...)
     local gridEntities = ____exports.getGridEntities(nil, ...)
     local gridEntityMap = __TS__New(Map)

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

@@ -52,6 +52,8 @@ export declare function getGridEntities(...gridEntityTypes: GridEntityType[]): G
  * exclude.
  */
 export declare function getGridEntitiesExcept(...gridEntityTypes: GridEntityType[]): GridEntity[];
+/** Helper function to get all grid entities in a given radius around a given point. */
+export declare function getGridEntitiesInRadius(targetPosition: Vector, radius: number): GridEntity[];
 /**
  * Helper function to get a map of every grid entity in the current room. The indexes of the map are
  * equal to the grid index. The values of the map are equal to the grid entities.
@@ -60,6 +62,8 @@ export declare function getGridEntitiesExcept(...gridEntityTypes: GridEntityType
  * arguments to match specific grid entity types.
  */
 export declare function getGridEntitiesMap(...gridEntityTypes: GridEntityType[]): Map<int, GridEntity>;
+/** Helper function to get the top left and bottom right corners of a given grid entity. */
+export declare function getGridEntityCollisionPoints(gridEntity: GridEntity): [topLeft: Vector, bottomRight: Vector];
 /** Helper function to get a string containing the grid entity's type and variant. */
 export declare function getGridEntityID(gridEntity: GridEntity): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"gridEntities.d.ts","sourceRoot":"","sources":["../../../src/functions/gridEntities.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACd,iBAAiB,EAIlB,MAAM,8BAA8B,CAAC;AAStC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAgCvD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,iBAAiB,EACpC,oBAAoB,EAAE,GAAG,GACxB,CAAC,cAAc,EAAE,GAAG,CAAC,GAAG,SAAS,CAqBnC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,EAAE,CAKzC;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,UAAU,GACrB,MAAM,EAAE,CA4BV;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,eAAe,EAAE,cAAc,EAAE,GACnC,UAAU,EAAE,CAYd;AAgBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,eAAe,EAAE,cAAc,EAAE,GACnC,UAAU,EAAE,CAYd;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,eAAe,EAAE,cAAc,EAAE,GACnC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAUtB;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,GAAG,GACX,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,GAAG,GACX,UAAU,EAAE,CAKd;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,GACrB,UAAU,EAAE,CA2Bd;AAED,wBAAgB,cAAc,IAAI,UAAU,GAAG,SAAS,CAIvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,GAAG,CAS7C;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,UAAU,GACrB,OAAO,CAWT;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAIlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAKpE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,eAAe,EAAE,cAAc,EAAE,GACnC,UAAU,EAAE,CAiBd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,cAAc,EAAE,cAAc,EAAE,GAClC,UAAU,EAAE,CAYd;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,UAAU,GACrB,IAAI,CAON;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,aAAa,EACxD,YAAY,EAAE,CAAC,EAAE,EACjB,UAAU,EAAE,OAAO,EACnB,GAAG,CAAC,EAAE,GAAG,GACR,CAAC,EAAE,CAoBL;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,qBAAqB,EAAE,UAAU,GAAG,GAAG,EACvC,UAAU,EAAE,OAAO,GAClB,IAAI,CAqCN;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAGnE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,GAAG,GAAG,IAAI,CA4B1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,cAAc,EAC9B,mBAAmB,EAAE,GAAG,GAAG,MAAM,GAChC,UAAU,GAAG,SAAS,CAExB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,GAAG,GAAG,MAAM,GAChC,UAAU,GAAG,SAAS,CAgCxB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,UAAU,GAAG,SAAS,CAkBtE"}
+{"version":3,"file":"gridEntities.d.ts","sourceRoot":"","sources":["../../../src/functions/gridEntities.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/gridEntities.lua

@@ -16,6 +16,7 @@ local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
 local ____constants = require("src.core.constants")
 local DISTANCE_OF_GRID_TILE = ____constants.DISTANCE_OF_GRID_TILE
+local VectorOne = ____constants.VectorOne
 local ____gridEntityTypeToBrokenStateMap = require("src.maps.gridEntityTypeToBrokenStateMap")
 local GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP = ____gridEntityTypeToBrokenStateMap.GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP
 local ____gridEntityXMLMap = require("src.maps.gridEntityXMLMap")
@@ -38,6 +39,7 @@ local asNumber = ____types.asNumber
 local isNumber = ____types.isNumber
 local ____utils = require("src.functions.utils")
 local eRange = ____utils.eRange
+local iRange = ____utils.iRange
 local ____vector = require("src.functions.vector")
 local isVector = ____vector.isVector
 local vectorEquals = ____vector.vectorEquals
@@ -60,6 +62,12 @@ function getAllGridEntities(self)
     end
     return gridEntities
 end
+--- Helper function to get the top left and bottom right corners of a given grid entity.
+function ____exports.getGridEntityCollisionPoints(self, gridEntity)
+    local topLeft = Vector(gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2)
+    local bottomRight = Vector(gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2)
+    return {topLeft, bottomRight}
+end
 --- Helper function to get the grid index of the top left wall. (This will depend on what the current
 -- room shape is.)
 function ____exports.getTopLeftWallGridIndex(self)
@@ -181,8 +189,7 @@ end
 -- Note that this function will not work properly in the `POST_NEW_ROOM` callback, since entities do
 -- not have collision yet in that callback.
 function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
-    local gridEntityCollisionTopLeft = Vector(gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2)
-    local gridEntityCollisionBottomRight = Vector(gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2)
+    local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
     local closeEntities = Isaac.FindInRadius(gridEntity.Position, DISTANCE_OF_GRID_TILE * 2)
     return __TS__ArrayFilter(
         closeEntities,
@@ -190,8 +197,8 @@ function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
             nil,
             entity.Position,
             entity.Size + 0.1,
-            gridEntityCollisionTopLeft,
-            gridEntityCollisionBottomRight
+            topLeft,
+            bottomRight
         ) end
     )
 end
@@ -251,6 +258,43 @@ function ____exports.getGridEntitiesExcept(self, ...)
         end
     )
 end
+--- Helper function to get all grid entities in a given radius around a given point.
+function ____exports.getGridEntitiesInRadius(self, targetPosition, radius)
+    radius = math.abs(radius)
+    local topLeftOffset = VectorOne * -radius
+    local mostTopLeftPosition = targetPosition + topLeftOffset
+    local room = game:GetRoom()
+    local diameter = radius * 2
+    local iterations = math.ceil(diameter / DISTANCE_OF_GRID_TILE)
+    local separation = diameter / iterations
+    local gridEntities = {}
+    local registeredGridIndexes = __TS__New(Set)
+    for ____, x in ipairs(iRange(nil, iterations)) do
+        for ____, y in ipairs(iRange(nil, iterations)) do
+            do
+                local position = mostTopLeftPosition + Vector(x * separation, y * separation)
+                local gridIndex = room:GetGridIndex(position)
+                local gridEntity = room:GetGridEntityFromPos(position)
+                if gridEntity == nil or registeredGridIndexes:has(gridIndex) then
+                    goto __continue20
+                end
+                registeredGridIndexes:add(gridIndex)
+                local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
+                if isCircleIntersectingRectangle(
+                    nil,
+                    targetPosition,
+                    radius,
+                    topLeft,
+                    bottomRight
+                ) then
+                    gridEntities[#gridEntities + 1] = gridEntity
+                end
+            end
+            ::__continue20::
+        end
+    end
+    return gridEntities
+end
 --- Helper function to get a map of every grid entity in the current room. The indexes of the map are
 -- equal to the grid index. The values of the map are equal to the grid entities.
 -- 

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

@@ -40,7 +40,7 @@ export declare function lerpAngleDegrees(aStart: number, aEnd: number, percent:
  * From: http://lua-users.org/wiki/SimpleRound
  *
  * @param num The number to round.
- * @param numDecimalPlaces Default is 0.
+ * @param numDecimalPlaces Optional. Default is 0.
  */
 export declare function round(num: float, numDecimalPlaces?: number): float;
 /**

package/dist/src/functions/math.lua

@@ -90,7 +90,7 @@ end
 -- From: http://lua-users.org/wiki/SimpleRound
 -- 
 -- @param num The number to round.
--- @param numDecimalPlaces Default is 0.
+-- @param numDecimalPlaces Optional. Default is 0.
 function ____exports.round(self, num, numDecimalPlaces)
     if numDecimalPlaces == nil then
         numDecimalPlaces = 0

package/package.json

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

package/src/functions/gridEntities.ts

@@ -8,7 +8,7 @@ import {
   TrapdoorVariant,
 } from "isaac-typescript-definitions";
 import { game } from "../core/cachedClasses";
-import { DISTANCE_OF_GRID_TILE } from "../core/constants";
+import { DISTANCE_OF_GRID_TILE, VectorOne } from "../core/constants";
 import { GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP } from "../maps/gridEntityTypeToBrokenStateMap";
 import { GRID_ENTITY_XML_MAP } from "../maps/gridEntityXMLMap";
 import {
@@ -22,7 +22,7 @@ import { isCircleIntersectingRectangle } from "./math";
 import { roomUpdateSafe } from "./rooms";
 import { clearSprite } from "./sprites";
 import { asNumber, isNumber } from "./types";
-import { eRange } from "./utils";
+import { eRange, iRange } from "./utils";
 import { isVector, vectorEquals } from "./vector";
 
 const BREAKABLE_GRID_ENTITY_TYPES_BY_EXPLOSIONS: ReadonlySet<GridEntityType> =
@@ -100,15 +100,7 @@ export function getAllGridIndexes(): int[] {
 export function getCollidingEntitiesWithGridEntity(
   gridEntity: GridEntity,
 ): Entity[] {
-  const gridEntityCollisionTopLeft = Vector(
-    gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2,
-    gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2,
-  );
-
-  const gridEntityCollisionBottomRight = Vector(
-    gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2,
-    gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2,
-  );
+  const [topLeft, bottomRight] = getGridEntityCollisionPoints(gridEntity);
 
   const closeEntities = Isaac.FindInRadius(
     gridEntity.Position,
@@ -123,8 +115,8 @@ export function getCollidingEntitiesWithGridEntity(
         // We arbitrarily add 0.1 to account for entities that are already pushed back by the time
         // the `POST_UPDATE` callback fires.
         entity.Size + 0.1,
-        gridEntityCollisionTopLeft,
-        gridEntityCollisionBottomRight,
+        topLeft,
+        bottomRight,
       ),
   );
 }
@@ -205,6 +197,53 @@ export function getGridEntitiesExcept(
   });
 }
 
+/** Helper function to get all grid entities in a given radius around a given point. */
+export function getGridEntitiesInRadius(
+  targetPosition: Vector,
+  radius: number,
+): GridEntity[] {
+  radius = math.abs(radius);
+  const topLeftOffset = VectorOne.mul(-radius);
+  const mostTopLeftPosition = targetPosition.add(topLeftOffset);
+  const room = game.GetRoom();
+
+  const diameter = radius * 2;
+  const iterations = math.ceil(diameter / DISTANCE_OF_GRID_TILE);
+  const separation = diameter / iterations;
+
+  const gridEntities: GridEntity[] = [];
+  const registeredGridIndexes = new Set<number>();
+  for (const x of iRange(iterations)) {
+    for (const y of iRange(iterations)) {
+      const position = mostTopLeftPosition.add(
+        Vector(x * separation, y * separation),
+      );
+
+      const gridIndex = room.GetGridIndex(position);
+      const gridEntity = room.GetGridEntityFromPos(position);
+      if (gridEntity === undefined || registeredGridIndexes.has(gridIndex)) {
+        continue;
+      }
+
+      registeredGridIndexes.add(gridIndex);
+      const [topLeft, bottomRight] = getGridEntityCollisionPoints(gridEntity);
+
+      if (
+        isCircleIntersectingRectangle(
+          targetPosition,
+          radius,
+          topLeft,
+          bottomRight,
+        )
+      ) {
+        gridEntities.push(gridEntity);
+      }
+    }
+  }
+
+  return gridEntities;
+}
+
 /**
  * Helper function to get a map of every grid entity in the current room. The indexes of the map are
  * equal to the grid index. The values of the map are equal to the grid entities.
@@ -226,6 +265,22 @@ export function getGridEntitiesMap(
   return gridEntityMap;
 }
 
+/** Helper function to get the top left and bottom right corners of a given grid entity. */
+export function getGridEntityCollisionPoints(
+  gridEntity: GridEntity,
+): [topLeft: Vector, bottomRight: Vector] {
+  const topLeft = Vector(
+    gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2,
+    gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2,
+  );
+  const bottomRight = Vector(
+    gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2,
+    gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2,
+  );
+
+  return [topLeft, bottomRight];
+}
+
 /** Helper function to get a string containing the grid entity's type and variant. */
 export function getGridEntityID(gridEntity: GridEntity): string {
   const gridEntityType = gridEntity.GetType();

package/src/functions/math.ts

@@ -122,7 +122,7 @@ export function lerpAngleDegrees(
  * From: http://lua-users.org/wiki/SimpleRound
  *
  * @param num The number to round.
- * @param numDecimalPlaces Default is 0.
+ * @param numDecimalPlaces Optional. Default is 0.
  */
 export function round(num: float, numDecimalPlaces = 0): float {
   const roundedNum = tonumber(string.format(`%.${numDecimalPlaces}f`, num));