isaacscript-common 1.2.268 → 1.2.272

package/dist/functions/boss.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+import { EntityTypeNonNPC } from "../types/EntityTypeNonNPC";
 /**
  * Helper function to get all of the non-dead bosses in the room.
  *
@@ -6,11 +7,21 @@
  * Horn holes.
  */
 export declare function getAliveBosses(matchingEntityType?: EntityType | int, matchingVariant?: int, matchingSubType?: int, ignoreFriendly?: boolean): EntityNPC[];
+/**
+ * Helper function to get the set of every boss in the game.
+ *
+ * The set contains strings with the entity type and variant, separated by a period.
+ *
+ * Also see the `getBossSet` and `getCombinedBossSet` functions.
+ */
+export declare function getAllBossesSet(): Set<string>;
 /**
  * Helper function to get the set of vanilla bosses for a particular stage and stage type
  * combination.
  *
- * Also see the `getCombinedBossSet` function.
+ * The set contains strings with the entity type and variant, separated by a period.
+ *
+ * Also see the `getAllBossesSet` and `getCombinedBossSet` functions.
  */
 export declare function getBossSet(stage: int, stageType: StageType): ReadonlySet<string> | undefined;
 /** Helper function to get all of the bosses in the room. */
@@ -20,8 +31,26 @@ export declare function getBosses(matchingEntityType?: EntityType | int, matchin
  * types. For example, specifying a stage of 2 will return a set with all of the bosses for
  * Basement, Cellar, Burning Basement, Downpour, and Dross.
  *
- * Also see the `getBossSet` function.
+ * The set contains strings with the entity type and variant, separated by a period.
+ *
+ * Also see the `getAllBossesSet` and `getBossSet` functions.
  */
-export declare function getCombinedBossSet(stage: int): ReadonlySet<string> | undefined;
+export declare function getCombinedBossSet(stage: int): Set<string> | undefined;
 /** Helper function to check if the provided NPC is a Sin miniboss, such as Sloth or Lust. */
 export declare function isSin(npc: EntityNPC): boolean;
+/**
+ * Helper function to spawn a boss.
+ *
+ * Use this function instead of `spawnNPC` since it handles automatically spawning multiple segments
+ * for multi-segment bosses.
+ *
+ * By default, this will spawn Chub (and his variants) with 3 segments and other multi-segment
+ * bosses with 4 segments. You can customize this via the "numSegments" argument.
+ */
+export declare function spawnBoss<T extends number>(entityType: T extends EntityTypeNonNPC ? never : T, variant: int, subType: int, position: Vector, velocity?: Readonly<Vector>, spawner?: Entity | undefined, seed?: Seed | undefined, numSegments?: int): EntityNPC;
+/**
+ * Helper function to spawn a boss with a specific seed.
+ *
+ * For more information, see the documentation for the `spawnBoss` function.
+ */
+export declare function spawnBossWithSeed(entityType: EntityType | int, variant: int, subType: int, position: Vector, seed: Seed, velocity?: Readonly<Vector>, spawner?: Entity | undefined, numSegments?: int): EntityNPC;

package/dist/functions/boss.lua

@@ -1,15 +1,26 @@
 local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
+local ____constants = require("constants")
+local VectorZero = ____constants.VectorZero
 local ____bossSets = require("sets.bossSets")
+local ALL_BOSSES_SET = ____bossSets.ALL_BOSSES_SET
 local STAGE_TO_COMBINED_BOSS_SET_MAP = ____bossSets.STAGE_TO_COMBINED_BOSS_SET_MAP
 local STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP = ____bossSets.STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP
 local ____sinEntityTypesSet = require("sets.sinEntityTypesSet")
 local SIN_ENTITY_TYPES_SET = ____sinEntityTypesSet.SIN_ENTITY_TYPES_SET
 local ____entitySpecific = require("functions.entitySpecific")
 local getNPCs = ____entitySpecific.getNPCs
+local spawnNPC = ____entitySpecific.spawnNPC
 local ____npc = require("functions.npc")
 local getAliveNPCs = ____npc.getAliveNPCs
+local ____set = require("functions.set")
+local copySet = ____set.copySet
+local ____utils = require("functions.utils")
+local ____repeat = ____utils["repeat"]
+local BOSSES_THAT_REQUIRE_MULTIPLE_SPAWNS = __TS__New(Set, {EntityType.ENTITY_LARRYJR, EntityType.ENTITY_CHUB, EntityType.ENTITY_TURDLET})
 function ____exports.getAliveBosses(self, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
     if ignoreFriendly == nil then
         ignoreFriendly = false
@@ -26,12 +37,19 @@ function ____exports.getAliveBosses(self, matchingEntityType, matchingVariant, m
         function(____, aliveNPC) return aliveNPC:IsBoss() end
     )
 end
+function ____exports.getAllBossesSet(self)
+    return copySet(nil, ALL_BOSSES_SET)
+end
 function ____exports.getBossSet(self, stage, stageType)
     local stageTypeMap = STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP:get(stage)
     if stageTypeMap == nil then
         return nil
     end
-    return stageTypeMap:get(stageType)
+    local bossSet = stageTypeMap:get(stageType)
+    if bossSet == nil then
+        return nil
+    end
+    return copySet(nil, bossSet)
 end
 function ____exports.getBosses(self, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
     if ignoreFriendly == nil then
@@ -50,9 +68,75 @@ function ____exports.getBosses(self, matchingEntityType, matchingVariant, matchi
     )
 end
 function ____exports.getCombinedBossSet(self, stage)
-    return STAGE_TO_COMBINED_BOSS_SET_MAP:get(stage)
+    local bossSet = STAGE_TO_COMBINED_BOSS_SET_MAP:get(stage)
+    if bossSet == nil then
+        return nil
+    end
+    return copySet(nil, bossSet)
 end
 function ____exports.isSin(self, npc)
     return SIN_ENTITY_TYPES_SET:has(npc.Type)
 end
+function ____exports.spawnBoss(self, entityType, variant, subType, position, velocity, spawner, seed, numSegments)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local npc = spawnNPC(
+        nil,
+        entityType,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    if BOSSES_THAT_REQUIRE_MULTIPLE_SPAWNS:has(entityType) then
+        local numSegmentsDefined = numSegments == nil and 4 or numSegments
+        local numSegmentsToUse = entityType == EntityType.ENTITY_CHUB and 3 or numSegmentsDefined
+        local remainingSegmentsToSpawn = numSegmentsToUse - 1
+        ____repeat(
+            nil,
+            remainingSegmentsToSpawn,
+            function()
+                spawnNPC(
+                    nil,
+                    entityType,
+                    variant,
+                    subType,
+                    position,
+                    velocity,
+                    spawner,
+                    seed
+                )
+            end
+        )
+    end
+    return npc
+end
+function ____exports.spawnBossWithSeed(self, entityType, variant, subType, position, seed, velocity, spawner, numSegments)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnBoss(
+        nil,
+        entityType,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed,
+        numSegments
+    )
+end
 return ____exports

package/dist/functions/entity.d.ts

@@ -67,6 +67,24 @@ export declare function isEntityMoving(entity: Entity, threshold?: number): bool
  * apply to non-story bosses, like Vanishing Twin. Also see the `STORY_BOSSES` constant.
  */
 export declare function isStoryBoss(entityType: EntityType | int): boolean;
+/**
+ * Helper function to parse a string that contains an entity type, a variant, and a sub-type,
+ * separated by periods.
+ *
+ * For example, passing "45.0.1" would return an array of [45, 0, 1].
+ *
+ * Returns undefined if the string cannot be parsed.
+ */
+export declare function parseEntityID(entityID: string): [entityType: EntityType | int, variant: int, subType: int] | undefined;
+/**
+ * Helper function to parse a string that contains an entity type and a variant separated by a
+ * period.
+ *
+ * For example, passing "45.0" would return an array of [45, 0].
+ *
+ * Returns undefined if the string cannot be parsed.
+ */
+export declare function parseEntityTypeVariantString(entityTypeVariantString: string): [entityType: EntityType | int, variant: int] | undefined;
 /**
  * Helper function to remove all of the matching entities in the room.
  *

package/dist/functions/entity.lua

@@ -2,6 +2,7 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__StringSplit = ____lualib.__TS__StringSplit
 local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
@@ -107,6 +108,42 @@ end
 function ____exports.isStoryBoss(self, entityType)
     return STORY_BOSSES_SET:has(entityType)
 end
+function ____exports.parseEntityID(self, entityID)
+    local entityIDArray = __TS__StringSplit(entityID, ".")
+    if #entityIDArray ~= 3 then
+        return nil
+    end
+    local entityTypeString, variantString, subTypeString = table.unpack(entityIDArray)
+    local entityType = tonumber(entityTypeString)
+    if entityType == nil then
+        return nil
+    end
+    local variant = tonumber(variantString)
+    if variant == nil then
+        return nil
+    end
+    local subType = tonumber(subTypeString)
+    if subType == nil then
+        return nil
+    end
+    return {entityType, variant, subType}
+end
+function ____exports.parseEntityTypeVariantString(self, entityTypeVariantString)
+    local entityTypeVariantArray = __TS__StringSplit(entityTypeVariantString, ".")
+    if #entityTypeVariantArray ~= 2 then
+        return nil
+    end
+    local entityTypeString, variantString = table.unpack(entityTypeVariantArray)
+    local entityType = tonumber(entityTypeString)
+    if entityType == nil then
+        return nil
+    end
+    local variant = tonumber(variantString)
+    if variant == nil then
+        return nil
+    end
+    return {entityType, variant}
+end
 function ____exports.removeAllMatchingEntities(self, entityType, entityVariant, entitySubType, cap)
     if entityVariant == nil then
         entityVariant = -1

package/dist/sets/bossSets.d.ts

@@ -1,3 +1,4 @@
 /// <reference types="isaac-typescript-definitions" />
 export declare const STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP: ReadonlyMap<int, ReadonlyMap<int, ReadonlySet<string>>>;
 export declare const STAGE_TO_COMBINED_BOSS_SET_MAP: ReadonlyMap<int, ReadonlySet<string>>;
+export declare const ALL_BOSSES_SET: ReadonlySet<string>;

package/dist/sets/bossSets.lua

@@ -468,4 +468,34 @@ ____exports.STAGE_TO_COMBINED_BOSS_SET_MAP = __TS__New(Map, {
     {10, ALL_STAGE_10_BOSSES_SET},
     {11, ALL_STAGE_11_BOSSES_SET}
 })
+local ____Set_13 = Set
+local ____array_12 = __TS__SparseArrayNew(__TS__Spread(ALL_BASEMENT_BOSSES_SET:values()))
+__TS__SparseArrayPush(
+    ____array_12,
+    __TS__Spread(ALL_CAVES_BOSSES_SET:values())
+)
+__TS__SparseArrayPush(
+    ____array_12,
+    __TS__Spread(ALL_DEPTHS_BOSSES_SET:values())
+)
+__TS__SparseArrayPush(
+    ____array_12,
+    __TS__Spread(ALL_WOMB_BOSSES_SET:values())
+)
+__TS__SparseArrayPush(
+    ____array_12,
+    __TS__Spread(BLUE_WOMB_BOSSES_SET:values())
+)
+__TS__SparseArrayPush(
+    ____array_12,
+    __TS__Spread(ALL_STAGE_10_BOSSES_SET:values())
+)
+__TS__SparseArrayPush(
+    ____array_12,
+    __TS__Spread(ALL_STAGE_11_BOSSES_SET:values())
+)
+____exports.ALL_BOSSES_SET = __TS__New(
+    ____Set_13,
+    {__TS__SparseArraySpread(____array_12)}
+)
 return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.268",
+  "version": "1.2.272",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",