isaacscript-common 9.18.4 → 9.19.2

package/dist/src/functions/gridEntitiesSpecific.lua

@@ -0,0 +1,493 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CrawlSpaceVariant = ____isaac_2Dtypescript_2Ddefinitions.CrawlSpaceVariant
+local DoorVariant = ____isaac_2Dtypescript_2Ddefinitions.DoorVariant
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local PitVariant = ____isaac_2Dtypescript_2Ddefinitions.PitVariant
+local PoopGridEntityVariant = ____isaac_2Dtypescript_2Ddefinitions.PoopGridEntityVariant
+local PressurePlateVariant = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateVariant
+local RockVariant = ____isaac_2Dtypescript_2Ddefinitions.RockVariant
+local ____gridEntities = require("src.functions.gridEntities")
+local getGridEntities = ____gridEntities.getGridEntities
+local getMatchingGridEntities = ____gridEntities.getMatchingGridEntities
+local removeGridEntities = ____gridEntities.removeGridEntities
+local spawnGridEntityWithVariant = ____gridEntities.spawnGridEntityWithVariant
+local ____types = require("src.functions.types")
+local asNumber = ____types.asNumber
+--- Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18) with a specific variant.
+function ____exports.spawnCrawlSpaceWithVariant(self, crawlSpaceVariant, gridIndexOrPosition)
+    return spawnGridEntityWithVariant(nil, GridEntityType.CRAWL_SPACE, crawlSpaceVariant, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.DOOR` (16).
+function ____exports.spawnDoorWithVariant(self, doorVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.DOOR, doorVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local door = gridEntity:ToDoor()
+    if door == nil then
+        error("Failed to spawn a door.")
+    end
+    return door
+end
+--- Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant.
+function ____exports.spawnPitWithVariant(self, pitVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.PIT, pitVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local pit = gridEntity:ToPit()
+    if pit == nil then
+        error("Failed to spawn a pit.")
+    end
+    return pit
+end
+--- Helper function to spawn a `GridEntityType.POOP` (14) with a specific variant.
+function ____exports.spawnPoopWithVariant(self, poopVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.POOP, poopVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local poop = gridEntity:ToPoop()
+    if poop == nil then
+        error("Failed to spawn a poop.")
+    end
+    return poop
+end
+--- Helper function to spawn a `GridEntityType.PRESSURE_PLATE` (20) with a specific variant.
+function ____exports.spawnPressurePlateWithVariant(self, pressurePlateVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.PRESSURE_PLATE, pressurePlateVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local pressurePlate = gridEntity:ToPressurePlate()
+    if pressurePlate == nil then
+        error("Failed to spawn a pressure plate.")
+    end
+    return pressurePlate
+end
+--- Helper function to spawn a `GridEntityType.ROCK` (2) with a specific variant.
+function ____exports.spawnRockWithVariant(self, rockVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.ROCK, rockVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local rock = gridEntity:ToRock()
+    if rock == nil then
+        error("Failed to spawn a rock.")
+    end
+    return rock
+end
+--- Helper function to spawn a `GridEntityType.SPIKES` (8) with a specific variant.
+function ____exports.spawnSpikesWithVariant(self, variant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.SPIKES, variant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local spikes = gridEntity:ToSpikes()
+    if spikes == nil then
+        error("Failed to spawn spikes.")
+    end
+    return spikes
+end
+--- Helper function to spawn a `GridEntityType.TNT` (12) with a specific variant.
+function ____exports.spawnTNTWithVariant(self, variant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.TNT, variant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local tnt = gridEntity:ToTNT()
+    if tnt == nil then
+        error("Failed to spawn TNT.")
+    end
+    return tnt
+end
+--- Helper function to spawn a `GridEntityType.TELEPORTER` (23) with a specific variant.
+function ____exports.spawnTeleporterWithVariant(self, variant, gridIndexOrPosition)
+    return spawnGridEntityWithVariant(nil, GridEntityType.TELEPORTER, variant, gridIndexOrPosition)
+end
+--- Helper function to get all of the grid entities of type `GridEntityType.CRAWL_SPACE` (18) in the
+-- room.
+-- 
+-- @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
+-- variant. Default is -1, which matches every variant.
+function ____exports.getCrawlSpaces(self, crawlSpaceVariant)
+    if crawlSpaceVariant == nil then
+        crawlSpaceVariant = -1
+    end
+    if asNumber(nil, crawlSpaceVariant) == -1 then
+        return getGridEntities(nil, GridEntityType.CRAWL_SPACE)
+    end
+    return getMatchingGridEntities(nil, GridEntityType.CRAWL_SPACE, crawlSpaceVariant)
+end
+--- Helper function to get all of the `GridEntityPit` in the room.
+-- 
+-- @param pitVariant Optional. If specified, will only get the pits that match the variant. Default
+-- is -1, which matches every variant.
+function ____exports.getPits(self, pitVariant)
+    if pitVariant == nil then
+        pitVariant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local pits = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pit = gridEntity:ToPit()
+        if pit ~= nil then
+            local gridEntityVariant = pit:GetVariant()
+            if asNumber(nil, pitVariant) == -1 or pitVariant == gridEntityVariant then
+                pits[#pits + 1] = pit
+            end
+        end
+    end
+    return pits
+end
+--- Helper function to get all of the `GridEntityPoop` in the room.
+-- 
+-- @param poopVariant Optional. If specified, will only get the poops that match the variant.
+-- Default is -1, which matches every variant.
+function ____exports.getPoops(self, poopVariant)
+    if poopVariant == nil then
+        poopVariant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local poops = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local poop = gridEntity:ToPoop()
+        if poop ~= nil then
+            local gridEntityVariant = poop:GetVariant()
+            if asNumber(nil, poopVariant) == -1 or poopVariant == gridEntityVariant then
+                poops[#poops + 1] = poop
+            end
+        end
+    end
+    return poops
+end
+--- Helper function to get all of the `GridEntityPressurePlate` in the room.
+-- 
+-- @param pressurePlateVariant Optional. If specified, will only get the pressure plates that match
+-- the variant. Default is -1, which matches every variant.
+function ____exports.getPressurePlates(self, pressurePlateVariant)
+    if pressurePlateVariant == nil then
+        pressurePlateVariant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local pressurePlates = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pressurePlate = gridEntity:ToPressurePlate()
+        if pressurePlate ~= nil then
+            local gridEntityVariant = pressurePlate:GetVariant()
+            if asNumber(nil, pressurePlateVariant) == -1 or pressurePlateVariant == gridEntityVariant then
+                pressurePlates[#pressurePlates + 1] = pressurePlate
+            end
+        end
+    end
+    return pressurePlates
+end
+--- Helper function to get all of the `GridEntityRock` in the room.
+-- 
+-- @param variant Optional. If specified, will only get the rocks that match the variant. Default is
+-- -1, which matches every variant. Note that this is not the same thing as the
+-- `RockVariant` enum, since that only applies to `GridEntityType.ROCK`, and other
+-- types of grid entities can be the `GridEntityRock` class.
+function ____exports.getRocks(self, variant)
+    if variant == nil then
+        variant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local rocks = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local rock = gridEntity:ToRock()
+        if rock ~= nil then
+            local gridEntityVariant = rock:GetVariant()
+            if variant == -1 or variant == gridEntityVariant then
+                rocks[#rocks + 1] = rock
+            end
+        end
+    end
+    return rocks
+end
+--- Helper function to get all of the `GridEntitySpikes` in the room.
+function ____exports.getSpikes(self, variant)
+    if variant == nil then
+        variant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local spikes = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local spike = gridEntity:ToSpikes()
+        if spike ~= nil then
+            local gridEntityVariant = spike:GetVariant()
+            if variant == -1 or variant == gridEntityVariant then
+                spikes[#spikes + 1] = spike
+            end
+        end
+    end
+    return spikes
+end
+--- Helper function to get all of the `GridEntityTNT` in the room.
+function ____exports.getTNT(self, variant)
+    if variant == nil then
+        variant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local tntArray = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local tnt = gridEntity:ToTNT()
+        if tnt ~= nil then
+            local gridEntityVariant = tnt:GetVariant()
+            if variant == -1 or variant == gridEntityVariant then
+                tntArray[#tntArray + 1] = tnt
+            end
+        end
+    end
+    return tntArray
+end
+--- Helper function to get all of the grid entities of type `GridEntityType.TELEPORTER` (23) in the
+-- room.
+-- 
+-- @param variant Optional. If specified, will only get the teleporters that match the variant.
+-- Default is -1, which matches every variant.
+function ____exports.getTeleporters(self, variant)
+    if variant == nil then
+        variant = -1
+    end
+    if variant == -1 then
+        return getGridEntities(nil, GridEntityType.TELEPORTER)
+    end
+    return getMatchingGridEntities(nil, GridEntityType.TELEPORTER, variant)
+end
+--- Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` (17) in the
+-- room. Specify a specific trapdoor variant to select only trapdoors of that variant.
+-- 
+-- @param trapdoorVariant Optional. If specified, will only get the trapdoors that match the
+-- variant. Default is -1, which matches every variant.
+function ____exports.getTrapdoors(self, trapdoorVariant)
+    if trapdoorVariant == nil then
+        trapdoorVariant = -1
+    end
+    if asNumber(nil, trapdoorVariant) == -1 then
+        return getGridEntities(nil, GridEntityType.TRAPDOOR)
+    end
+    return getMatchingGridEntities(nil, GridEntityType.TRAPDOOR, trapdoorVariant)
+end
+--- Helper function to remove all of the `GridEntityType.CRAWL_SPACE` (18) in the room.
+-- 
+-- @param crawlSpaceVariant Optional. If specified, will only remove the crawl spaces that match
+-- this variant. Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the crawl spaces are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of crawl spaces.
+-- @returns The crawl spaces that were removed.
+function ____exports.removeAllCrawlSpaces(self, crawlSpaceVariant, updateRoom, cap)
+    if crawlSpaceVariant == nil then
+        crawlSpaceVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local crawlSpaces = ____exports.getCrawlSpaces(nil, crawlSpaceVariant)
+    return removeGridEntities(nil, crawlSpaces, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityPit` in the room.
+-- 
+-- @param pitVariant Optional. If specified, will only remove the pits that match this variant.
+-- Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the pits are removed. Default
+-- is false. For more information, see the description of the `removeGridEntities`
+-- helper function.
+-- @param cap Optional. If specified, will only remove the given amount of pits.
+-- @returns The pits that were removed.
+function ____exports.removeAllPits(self, pitVariant, updateRoom, cap)
+    if pitVariant == nil then
+        pitVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local pits = ____exports.getPits(nil, pitVariant)
+    return removeGridEntities(nil, pits, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityPoop` in the room.
+-- 
+-- Note that poops can either be an entity or a grid entity, depending on the situation. This
+-- function will only remove the grid entity poops.
+-- 
+-- @param poopVariant Optional. If specified, will only remove the poops that match this variant.
+-- Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the poops are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of poops.
+-- @returns The poops that were removed.
+function ____exports.removeAllPoops(self, poopVariant, updateRoom, cap)
+    if poopVariant == nil then
+        poopVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local poops = ____exports.getPoops(nil, poopVariant)
+    return removeGridEntities(nil, poops, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityPressurePlate` in the room.
+-- 
+-- @param pressurePlateVariant Optional. If specified, will only remove the pressure plates that
+-- match this variant. Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the pressure plates are
+-- removed. Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of pressure plates.
+-- @returns The pressure plates that were removed.
+function ____exports.removeAllPressurePlates(self, pressurePlateVariant, updateRoom, cap)
+    if pressurePlateVariant == nil then
+        pressurePlateVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local pressurePlates = ____exports.getPressurePlates(nil, pressurePlateVariant)
+    return removeGridEntities(nil, pressurePlates, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityRock` in the room.
+-- 
+-- @param variant Optional. If specified, will only remove the rocks that match this variant.
+-- Default is -1, which matches every variant. Note that this is not the same thing
+-- as the `RockVariant` enum, since that only applies to `GridEntityType.ROCK`, and
+-- other types of grid entities can be the `GridEntityRock` class.
+-- @param updateRoom Optional. Whether or not to update the room after the rocks are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of rocks.
+-- @returns The rocks that were removed.
+function ____exports.removeAllRocks(self, variant, updateRoom, cap)
+    if variant == nil then
+        variant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local rocks = ____exports.getRocks(nil, variant)
+    return removeGridEntities(nil, rocks, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntitySpikes` in the room.
+-- 
+-- @param variant Optional. If specified, will only remove the spikes that match this variant.
+-- Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the spikes are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of spikes.
+-- @returns The spikes that were removed.
+function ____exports.removeAllSpikes(self, variant, updateRoom, cap)
+    if variant == nil then
+        variant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local spikes = ____exports.getSpikes(nil, variant)
+    return removeGridEntities(nil, spikes, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityTNT` in the room.
+-- 
+-- @param variant Optional. If specified, will only remove the TNTs that match this variant. Default
+-- is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the TNTs are removed. Default
+-- is false. For more information, see the description of the `removeGridEntities`
+-- helper function.
+-- @param cap Optional. If specified, will only remove the given amount of TNTs.
+-- @returns The TNTs that were removed.
+function ____exports.removeAllTNT(self, variant, updateRoom, cap)
+    if variant == nil then
+        variant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local tnt = ____exports.getTNT(nil, variant)
+    return removeGridEntities(nil, tnt, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityType.TELEPORTER` (23) in the room.
+-- 
+-- @param variant Optional. If specified, will only remove the teleporters that match this variant.
+-- Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the teleporters are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of teleporters.
+-- @returns The teleporters that were removed.
+function ____exports.removeAllTeleporters(self, variant, updateRoom, cap)
+    if variant == nil then
+        variant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local teleporters = ____exports.getTeleporters(nil, variant)
+    return removeGridEntities(nil, teleporters, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityType.TRAPDOOR` (17) in the room.
+-- 
+-- @param trapdoorVariant Optional. If specified, will only remove the trapdoors that match this
+-- variant. Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the trapdoors are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of trapdoors.
+-- @returns The trapdoors that were removed.
+function ____exports.removeAllTrapdoors(self, trapdoorVariant, updateRoom, cap)
+    if trapdoorVariant == nil then
+        trapdoorVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local trapdoors = ____exports.getTrapdoors(nil, trapdoorVariant)
+    return removeGridEntities(nil, trapdoors, updateRoom, cap)
+end
+--- Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18).
+function ____exports.spawnCrawlSpace(self, gridIndexOrPosition)
+    return ____exports.spawnCrawlSpaceWithVariant(nil, CrawlSpaceVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant.
+function ____exports.spawnDoor(self, gridIndexOrPosition)
+    return ____exports.spawnDoorWithVariant(nil, DoorVariant.UNSPECIFIED, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant.
+function ____exports.spawnPit(self, gridIndexOrPosition)
+    return ____exports.spawnPitWithVariant(nil, PitVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.POOP` (14).
+function ____exports.spawnPoop(self, gridIndexOrPosition)
+    return ____exports.spawnPoopWithVariant(nil, PoopGridEntityVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.PRESSURE_PLATE` (20).
+function ____exports.spawnPressurePlate(self, gridIndexOrPosition)
+    return ____exports.spawnPressurePlateWithVariant(nil, PressurePlateVariant.PRESSURE_PLATE, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.ROCK` (2).
+function ____exports.spawnRock(self, gridIndexOrPosition)
+    return ____exports.spawnRockWithVariant(nil, RockVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.SPIKES` (8).
+function ____exports.spawnSpikes(self, gridIndexOrPosition)
+    return ____exports.spawnSpikesWithVariant(nil, 0, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.TNT` (12).
+function ____exports.spawnTNT(self, gridIndexOrPosition)
+    return ____exports.spawnTNTWithVariant(nil, 0, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.TELEPORTER` (23).
+function ____exports.spawnTeleporter(self, gridIndexOrPosition)
+    return ____exports.spawnTeleporterWithVariant(nil, 0, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.TRAPDOOR` (17).
+function ____exports.spawnTrapdoor(self, gridIndexOrPosition)
+    return ____exports.spawnCrawlSpaceWithVariant(nil, CrawlSpaceVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.TRAPDOOR` (17) with a specific variant.
+function ____exports.spawnTrapdoorWithVariant(self, trapdoorVariant, gridIndexOrPosition)
+    return spawnGridEntityWithVariant(nil, GridEntityType.TRAPDOOR, trapdoorVariant, gridIndexOrPosition)
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../../src/functions/hex.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAMnE"}

package/dist/src/functions/hex.lua

@@ -0,0 +1,54 @@
+local ____lualib = require("lualib_bundle")
+local __TS__StringReplace = ____lualib.__TS__StringReplace
+local __TS__StringSubstring = ____lualib.__TS__StringSubstring
+local ____exports = {}
+local hexToRGB, HEX_STRING_LENGTH
+local ____log = require("src.functions.log")
+local logError = ____log.logError
+function hexToRGB(self, hexString)
+    hexString = __TS__StringReplace(hexString, "#", "")
+    if #hexString ~= HEX_STRING_LENGTH then
+        logError(
+            nil,
+            "Hex strings must be of length: " .. tostring(HEX_STRING_LENGTH)
+        )
+        return {0, 0, 0}
+    end
+    local rString = __TS__StringSubstring(hexString, 0, 2)
+    local r = tonumber("0x" .. rString)
+    if r == nil then
+        logError(nil, ("Failed to convert `0x" .. rString) .. "` to a number.")
+        return {0, 0, 0}
+    end
+    local gString = __TS__StringSubstring(hexString, 2, 4)
+    local g = tonumber("0x" .. gString)
+    if g == nil then
+        logError(nil, ("Failed to convert `0x" .. gString) .. "` to a number.")
+        return {0, 0, 0}
+    end
+    local bString = __TS__StringSubstring(hexString, 4, 6)
+    local b = tonumber("0x" .. bString)
+    if b == nil then
+        logError(nil, ("Failed to convert `0x" .. bString) .. "` to a number.")
+        return {0, 0, 0}
+    end
+    return {r, g, b}
+end
+HEX_STRING_LENGTH = 6
+--- Converts a hex string like "#33aa33" to a KColor object.
+-- 
+-- @param hexString A hex string like "#ffffff" or "ffffff". (The "#" character is optional.)
+function ____exports.hexToColor(self, hexString, alpha)
+    local r, g, b = table.unpack(hexToRGB(nil, hexString))
+    local base = 255
+    return Color(r / base, g / base, b / base, alpha)
+end
+--- Converts a hex string like "#33aa33" to a Color object.
+-- 
+-- @param hexString A hex string like "#ffffff" or "ffffff". (The "#" character is optional.)
+function ____exports.hexToKColor(self, hexString, alpha)
+    local r, g, b = table.unpack(hexToRGB(nil, hexString))
+    local base = 255
+    return KColor(r / base, g / base, b / base, alpha)
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"initArray.d.ts","sourceRoot":"","sources":["../../../src/functions/initArray.ts"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,EAAE,CAY5D"}

package/dist/src/functions/initArray.lua

@@ -0,0 +1,37 @@
+local ____exports = {}
+local ____deepCopy = require("src.functions.deepCopy")
+local deepCopy = ____deepCopy.deepCopy
+local ____types = require("src.functions.types")
+local isPrimitive = ____types.isPrimitive
+local ____utils = require("src.functions.utils")
+local ____repeat = ____utils["repeat"]
+--- Initializes an array with all of the elements containing the specified default value.
+-- 
+-- If the provided default value is not a boolean, number, or string, then it will be copied with
+-- the `deepCopy` function before adding it to the new array. In this way, you can initialize an
+-- array of arrays, or an array of maps, and so on. (If the `deepCopy` function was not used, then
+-- all of the array elements would just be references to the same underlying data structure.)
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const arrayWithZeroes = initArray(0, 10); // Has 10 elements of 0.
+-- const arrayWithArrays = initArray([0], 20); // Has 20 elements of an array with a 0 in it.
+-- ```
+function ____exports.initArray(self, defaultValue, size)
+    local array = {}
+    ____repeat(
+        nil,
+        size,
+        function()
+            if isPrimitive(nil, defaultValue) then
+                array[#array + 1] = defaultValue
+            else
+                local copy = deepCopy(nil, defaultValue)
+                array[#array + 1] = copy
+            end
+        end
+    )
+    return array
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EAEV,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAsCtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAO7E;AAED,wBAAgB,cAAc,IAAI,WAAW,CAAC,YAAY,CAAC,CAE1D;AAED,wBAAgB,eAAe,IAAI,WAAW,CAAC,YAAY,CAAC,CAE3D;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAK7E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,GACzB,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,SAAS,CAQpB"}