isaacscript-common 1.2.270 → 1.2.271

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/package.json

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