isaacscript-common 1.0.449 → 1.0.450

package/dist/functions/position.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to get a room position that is not overlapping with a grid entity, a heaven door,
+ * or a player. The `Room.FindFreePickupSpawnPosition()` function will return locations that are
+ * overlap with heaven doors and players, so use this function instead if you want to account for
+ * those specific situations.
+ */
+export declare function findFreePosition(startingPosition: Vector): Vector;

package/dist/functions/position.lua

@@ -0,0 +1,35 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____constants = require("constants")
+local DISTANCE_OF_GRID_TILE = ____constants.DISTANCE_OF_GRID_TILE
+local ____entity = require("functions.entity")
+local anyEntityCloserThan = ____entity.anyEntityCloserThan
+local getEffects = ____entity.getEffects
+local ____player = require("functions.player")
+local getPlayerCloserThan = ____player.getPlayerCloserThan
+function ____exports.findFreePosition(self, startingPosition)
+    local game = Game()
+    local room = game:GetRoom()
+    local heavenDoors = getEffects(nil, EffectVariant.HEAVEN_LIGHT_DOOR, 0)
+    do
+        local i = 0
+        while i < 100 do
+            do
+                local position = room:FindFreePickupSpawnPosition(startingPosition, i)
+                local closePlayer = getPlayerCloserThan(nil, position, DISTANCE_OF_GRID_TILE)
+                if closePlayer ~= nil then
+                    goto __continue3
+                end
+                local isCloseHeavenDoor = anyEntityCloserThan(nil, heavenDoors, position, DISTANCE_OF_GRID_TILE)
+                if isCloseHeavenDoor then
+                    goto __continue3
+                end
+                return position
+            end
+            ::__continue3::
+            i = i + 1
+        end
+    end
+    return room:FindFreePickupSpawnPosition(startingPosition)
+end
+return ____exports

package/dist/index.d.ts

@@ -30,6 +30,7 @@ export * from "./functions/pickups";
 export * from "./functions/player";
 export * from "./functions/playerHealth";
 export * from "./functions/pocketItems";
+export * from "./functions/position";
 export * from "./functions/random";
 export * from "./functions/revive";
 export * from "./functions/rooms";

package/dist/index.lua

@@ -251,6 +251,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.position")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.random")
     for ____exportKey, ____exportValue in pairs(____export) do

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.0.449",
+  "version": "1.0.450",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,7 +25,7 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.275",
+    "isaac-typescript-definitions": "^1.0.276",
     "isaacscript-lint": "^1.0.67",
     "typedoc": "^0.22.9",
     "typescript": "4.4.4",