isaacscript-common 87.3.0 → 87.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/dist/cachedEnumValues.d.ts +15 -3
  2. package/dist/cachedEnumValues.d.ts.map +1 -1
  3. package/dist/classes/features/callbackLogic/ItemPickupDetection.d.ts.map +1 -1
  4. package/dist/classes/features/callbackLogic/ItemPickupDetection.js +6 -2
  5. package/dist/classes/features/callbackLogic/ItemPickupDetection.lua +6 -1
  6. package/dist/core/constants.d.ts +5 -1
  7. package/dist/core/constants.d.ts.map +1 -1
  8. package/dist/enums/ModCallbackCustom.d.ts +5 -4
  9. package/dist/enums/ModCallbackCustom.d.ts.map +1 -1
  10. package/dist/enums/ModCallbackCustom.js +5 -4
  11. package/dist/functions/entities.d.ts +3 -3
  12. package/dist/functions/entities.d.ts.map +1 -1
  13. package/dist/functions/entities.js +5 -4
  14. package/dist/functions/entities.lua +4 -11
  15. package/dist/functions/gridEntities.d.ts.map +1 -1
  16. package/dist/functions/gridEntities.js +6 -0
  17. package/dist/functions/gridEntities.lua +9 -5
  18. package/dist/functions/players.d.ts +2 -0
  19. package/dist/functions/players.d.ts.map +1 -1
  20. package/dist/functions/players.js +2 -0
  21. package/dist/functions/players.lua +2 -0
  22. package/dist/functions/string.d.ts +1 -1
  23. package/dist/functions/string.js +1 -1
  24. package/dist/functions/string.lua +1 -1
  25. package/dist/functions/utils.d.ts +11 -0
  26. package/dist/functions/utils.d.ts.map +1 -1
  27. package/dist/functions/utils.js +20 -1
  28. package/dist/functions/utils.lua +16 -0
  29. package/dist/index.lua +432 -0
  30. package/dist/index.rollup.d.ts +33 -12
  31. package/dist/indexLua.lua +432 -0
  32. package/dist/interfaces/private/AddCallbackParametersCustom.d.ts +5 -3
  33. package/dist/interfaces/private/AddCallbackParametersCustom.d.ts.map +1 -1
  34. package/dist/isaacscript-common.lua +1099 -1895
  35. package/dist/lualib_bundle.lua +97 -4
  36. package/dist/maps/defaultPlayerStatMap.d.ts +5 -1
  37. package/dist/maps/defaultPlayerStatMap.d.ts.map +1 -1
  38. package/dist/objects/doorSlotToDoorSlotFlag.d.ts +45 -9
  39. package/dist/objects/doorSlotToDoorSlotFlag.d.ts.map +1 -1
  40. package/dist/tsdoc-metadata.json +1 -1
  41. package/package.json +2 -2
  42. package/src/classes/features/callbackLogic/ItemPickupDetection.ts +6 -2
  43. package/src/enums/ModCallbackCustom.ts +5 -4
  44. package/src/functions/entities.ts +5 -11
  45. package/src/functions/gridEntities.ts +12 -0
  46. package/src/functions/players.ts +2 -0
  47. package/src/functions/string.ts +1 -1
  48. package/src/functions/utils.ts +29 -0
  49. package/src/interfaces/private/AddCallbackParametersCustom.ts +8 -3
package/dist/index.lua CHANGED
@@ -1103,6 +1103,110 @@ do
1103
1103
  end
1104
1104
  end
1105
1105
  end
1106
+ do
1107
+ local ____export = require("interfaces.ChargeBarSprites")
1108
+ for ____exportKey, ____exportValue in pairs(____export) do
1109
+ if ____exportKey ~= "default" then
1110
+ ____exports[____exportKey] = ____exportValue
1111
+ end
1112
+ end
1113
+ end
1114
+ do
1115
+ local ____export = require("interfaces.Corner")
1116
+ for ____exportKey, ____exportValue in pairs(____export) do
1117
+ if ____exportKey ~= "default" then
1118
+ ____exports[____exportKey] = ____exportValue
1119
+ end
1120
+ end
1121
+ end
1122
+ do
1123
+ local ____export = require("interfaces.CustomStageTSConfig")
1124
+ for ____exportKey, ____exportValue in pairs(____export) do
1125
+ if ____exportKey ~= "default" then
1126
+ ____exports[____exportKey] = ____exportValue
1127
+ end
1128
+ end
1129
+ end
1130
+ do
1131
+ local ____export = require("interfaces.GridEntityCustomData")
1132
+ for ____exportKey, ____exportValue in pairs(____export) do
1133
+ if ____exportKey ~= "default" then
1134
+ ____exports[____exportKey] = ____exportValue
1135
+ end
1136
+ end
1137
+ end
1138
+ do
1139
+ local ____export = require("interfaces.JSONRoomsFile")
1140
+ for ____exportKey, ____exportValue in pairs(____export) do
1141
+ if ____exportKey ~= "default" then
1142
+ ____exports[____exportKey] = ____exportValue
1143
+ end
1144
+ end
1145
+ end
1146
+ do
1147
+ local ____export = require("interfaces.PlayerHealth")
1148
+ for ____exportKey, ____exportValue in pairs(____export) do
1149
+ if ____exportKey ~= "default" then
1150
+ ____exports[____exportKey] = ____exportValue
1151
+ end
1152
+ end
1153
+ end
1154
+ do
1155
+ local ____export = require("interfaces.PlayerStats")
1156
+ for ____exportKey, ____exportValue in pairs(____export) do
1157
+ if ____exportKey ~= "default" then
1158
+ ____exports[____exportKey] = ____exportValue
1159
+ end
1160
+ end
1161
+ end
1162
+ do
1163
+ local ____export = require("interfaces.PocketItemDescription")
1164
+ for ____exportKey, ____exportValue in pairs(____export) do
1165
+ if ____exportKey ~= "default" then
1166
+ ____exports[____exportKey] = ____exportValue
1167
+ end
1168
+ end
1169
+ end
1170
+ do
1171
+ local ____export = require("interfaces.RoomDescription")
1172
+ for ____exportKey, ____exportValue in pairs(____export) do
1173
+ if ____exportKey ~= "default" then
1174
+ ____exports[____exportKey] = ____exportValue
1175
+ end
1176
+ end
1177
+ end
1178
+ do
1179
+ local ____export = require("interfaces.SaveData")
1180
+ for ____exportKey, ____exportValue in pairs(____export) do
1181
+ if ____exportKey ~= "default" then
1182
+ ____exports[____exportKey] = ____exportValue
1183
+ end
1184
+ end
1185
+ end
1186
+ do
1187
+ local ____export = require("interfaces.StageHistoryEntry")
1188
+ for ____exportKey, ____exportValue in pairs(____export) do
1189
+ if ____exportKey ~= "default" then
1190
+ ____exports[____exportKey] = ____exportValue
1191
+ end
1192
+ end
1193
+ end
1194
+ do
1195
+ local ____export = require("interfaces.TSTLClassMetatable")
1196
+ for ____exportKey, ____exportValue in pairs(____export) do
1197
+ if ____exportKey ~= "default" then
1198
+ ____exports[____exportKey] = ____exportValue
1199
+ end
1200
+ end
1201
+ end
1202
+ do
1203
+ local ____export = require("interfaces.TrinketSituation")
1204
+ for ____exportKey, ____exportValue in pairs(____export) do
1205
+ if ____exportKey ~= "default" then
1206
+ ____exports[____exportKey] = ____exportValue
1207
+ end
1208
+ end
1209
+ end
1106
1210
  do
1107
1211
  local ____export = require("maps.cardNameToTypeMap")
1108
1212
  for ____exportKey, ____exportValue in pairs(____export) do
@@ -1175,6 +1279,182 @@ do
1175
1279
  end
1176
1280
  end
1177
1281
  end
1282
+ do
1283
+ local ____export = require("types.AddSubtract")
1284
+ for ____exportKey, ____exportValue in pairs(____export) do
1285
+ if ____exportKey ~= "default" then
1286
+ ____exports[____exportKey] = ____exportValue
1287
+ end
1288
+ end
1289
+ end
1290
+ do
1291
+ local ____export = require("types.AllButFirst")
1292
+ for ____exportKey, ____exportValue in pairs(____export) do
1293
+ if ____exportKey ~= "default" then
1294
+ ____exports[____exportKey] = ____exportValue
1295
+ end
1296
+ end
1297
+ end
1298
+ do
1299
+ local ____export = require("types.AllButLast")
1300
+ for ____exportKey, ____exportValue in pairs(____export) do
1301
+ if ____exportKey ~= "default" then
1302
+ ____exports[____exportKey] = ____exportValue
1303
+ end
1304
+ end
1305
+ end
1306
+ do
1307
+ local ____export = require("types.AnyClass")
1308
+ for ____exportKey, ____exportValue in pairs(____export) do
1309
+ if ____exportKey ~= "default" then
1310
+ ____exports[____exportKey] = ____exportValue
1311
+ end
1312
+ end
1313
+ end
1314
+ do
1315
+ local ____export = require("types.AnyEntity")
1316
+ for ____exportKey, ____exportValue in pairs(____export) do
1317
+ if ____exportKey ~= "default" then
1318
+ ____exports[____exportKey] = ____exportValue
1319
+ end
1320
+ end
1321
+ end
1322
+ do
1323
+ local ____export = require("types.AnyFunction")
1324
+ for ____exportKey, ____exportValue in pairs(____export) do
1325
+ if ____exportKey ~= "default" then
1326
+ ____exports[____exportKey] = ____exportValue
1327
+ end
1328
+ end
1329
+ end
1330
+ do
1331
+ local ____export = require("types.AnyGridEntity")
1332
+ for ____exportKey, ____exportValue in pairs(____export) do
1333
+ if ____exportKey ~= "default" then
1334
+ ____exports[____exportKey] = ____exportValue
1335
+ end
1336
+ end
1337
+ end
1338
+ do
1339
+ local ____export = require("types.CompositionTypeSatisfiesEnum")
1340
+ for ____exportKey, ____exportValue in pairs(____export) do
1341
+ if ____exportKey ~= "default" then
1342
+ ____exports[____exportKey] = ____exportValue
1343
+ end
1344
+ end
1345
+ end
1346
+ do
1347
+ local ____export = require("types.ConversionHeartSubType")
1348
+ for ____exportKey, ____exportValue in pairs(____export) do
1349
+ if ____exportKey ~= "default" then
1350
+ ____exports[____exportKey] = ____exportValue
1351
+ end
1352
+ end
1353
+ end
1354
+ do
1355
+ local ____export = require("types.Decrement")
1356
+ for ____exportKey, ____exportValue in pairs(____export) do
1357
+ if ____exportKey ~= "default" then
1358
+ ____exports[____exportKey] = ____exportValue
1359
+ end
1360
+ end
1361
+ end
1362
+ do
1363
+ local ____export = require("types.ERange")
1364
+ for ____exportKey, ____exportValue in pairs(____export) do
1365
+ if ____exportKey ~= "default" then
1366
+ ____exports[____exportKey] = ____exportValue
1367
+ end
1368
+ end
1369
+ end
1370
+ do
1371
+ local ____export = require("types.EntityID")
1372
+ for ____exportKey, ____exportValue in pairs(____export) do
1373
+ if ____exportKey ~= "default" then
1374
+ ____exports[____exportKey] = ____exportValue
1375
+ end
1376
+ end
1377
+ end
1378
+ do
1379
+ local ____export = require("types.FunctionTuple")
1380
+ for ____exportKey, ____exportValue in pairs(____export) do
1381
+ if ____exportKey ~= "default" then
1382
+ ____exports[____exportKey] = ____exportValue
1383
+ end
1384
+ end
1385
+ end
1386
+ do
1387
+ local ____export = require("types.GridEntityID")
1388
+ for ____exportKey, ____exportValue in pairs(____export) do
1389
+ if ____exportKey ~= "default" then
1390
+ ____exports[____exportKey] = ____exportValue
1391
+ end
1392
+ end
1393
+ end
1394
+ do
1395
+ local ____export = require("types.HasFunction")
1396
+ for ____exportKey, ____exportValue in pairs(____export) do
1397
+ if ____exportKey ~= "default" then
1398
+ ____exports[____exportKey] = ____exportValue
1399
+ end
1400
+ end
1401
+ end
1402
+ do
1403
+ local ____export = require("types.IRange")
1404
+ for ____exportKey, ____exportValue in pairs(____export) do
1405
+ if ____exportKey ~= "default" then
1406
+ ____exports[____exportKey] = ____exportValue
1407
+ end
1408
+ end
1409
+ end
1410
+ do
1411
+ local ____export = require("types.Immutable")
1412
+ for ____exportKey, ____exportValue in pairs(____export) do
1413
+ if ____exportKey ~= "default" then
1414
+ ____exports[____exportKey] = ____exportValue
1415
+ end
1416
+ end
1417
+ end
1418
+ do
1419
+ local ____export = require("types.Increment")
1420
+ for ____exportKey, ____exportValue in pairs(____export) do
1421
+ if ____exportKey ~= "default" then
1422
+ ____exports[____exportKey] = ____exportValue
1423
+ end
1424
+ end
1425
+ end
1426
+ do
1427
+ local ____export = require("types.LowercaseKeys")
1428
+ for ____exportKey, ____exportValue in pairs(____export) do
1429
+ if ____exportKey ~= "default" then
1430
+ ____exports[____exportKey] = ____exportValue
1431
+ end
1432
+ end
1433
+ end
1434
+ do
1435
+ local ____export = require("types.NaturalNumbersLessThan")
1436
+ for ____exportKey, ____exportValue in pairs(____export) do
1437
+ if ____exportKey ~= "default" then
1438
+ ____exports[____exportKey] = ____exportValue
1439
+ end
1440
+ end
1441
+ end
1442
+ do
1443
+ local ____export = require("types.NaturalNumbersLessThanOrEqualTo")
1444
+ for ____exportKey, ____exportValue in pairs(____export) do
1445
+ if ____exportKey ~= "default" then
1446
+ ____exports[____exportKey] = ____exportValue
1447
+ end
1448
+ end
1449
+ end
1450
+ do
1451
+ local ____export = require("types.ObjectValues")
1452
+ for ____exportKey, ____exportValue in pairs(____export) do
1453
+ if ____exportKey ~= "default" then
1454
+ ____exports[____exportKey] = ____exportValue
1455
+ end
1456
+ end
1457
+ end
1178
1458
  do
1179
1459
  local ____export = require("types.PickingUpItem")
1180
1460
  for ____exportKey, ____exportValue in pairs(____export) do
@@ -1183,6 +1463,38 @@ do
1183
1463
  end
1184
1464
  end
1185
1465
  end
1466
+ do
1467
+ local ____export = require("types.PickupIndex")
1468
+ for ____exportKey, ____exportValue in pairs(____export) do
1469
+ if ____exportKey ~= "default" then
1470
+ ____exports[____exportKey] = ____exportValue
1471
+ end
1472
+ end
1473
+ end
1474
+ do
1475
+ local ____export = require("types.PlayerIndex")
1476
+ for ____exportKey, ____exportValue in pairs(____export) do
1477
+ if ____exportKey ~= "default" then
1478
+ ____exports[____exportKey] = ____exportValue
1479
+ end
1480
+ end
1481
+ end
1482
+ do
1483
+ local ____export = require("types.PossibleStatType")
1484
+ for ____exportKey, ____exportValue in pairs(____export) do
1485
+ if ____exportKey ~= "default" then
1486
+ ____exports[____exportKey] = ____exportValue
1487
+ end
1488
+ end
1489
+ end
1490
+ do
1491
+ local ____export = require("types.PublicInterface")
1492
+ for ____exportKey, ____exportValue in pairs(____export) do
1493
+ if ____exportKey ~= "default" then
1494
+ ____exports[____exportKey] = ____exportValue
1495
+ end
1496
+ end
1497
+ end
1186
1498
  do
1187
1499
  local ____export = require("types.ReadonlyMap")
1188
1500
  for ____exportKey, ____exportValue in pairs(____export) do
@@ -1191,6 +1503,14 @@ do
1191
1503
  end
1192
1504
  end
1193
1505
  end
1506
+ do
1507
+ local ____export = require("types.ReadonlyRecord")
1508
+ for ____exportKey, ____exportValue in pairs(____export) do
1509
+ if ____exportKey ~= "default" then
1510
+ ____exports[____exportKey] = ____exportValue
1511
+ end
1512
+ end
1513
+ end
1194
1514
  do
1195
1515
  local ____export = require("types.ReadonlySet")
1196
1516
  for ____exportKey, ____exportValue in pairs(____export) do
@@ -1199,4 +1519,116 @@ do
1199
1519
  end
1200
1520
  end
1201
1521
  end
1522
+ do
1523
+ local ____export = require("types.StartsWithLowercase")
1524
+ for ____exportKey, ____exportValue in pairs(____export) do
1525
+ if ____exportKey ~= "default" then
1526
+ ____exports[____exportKey] = ____exportValue
1527
+ end
1528
+ end
1529
+ end
1530
+ do
1531
+ local ____export = require("types.StartsWithUppercase")
1532
+ for ____exportKey, ____exportValue in pairs(____export) do
1533
+ if ____exportKey ~= "default" then
1534
+ ____exports[____exportKey] = ____exportValue
1535
+ end
1536
+ end
1537
+ end
1538
+ do
1539
+ local ____export = require("types.TSTLClass")
1540
+ for ____exportKey, ____exportValue in pairs(____export) do
1541
+ if ____exportKey ~= "default" then
1542
+ ____exports[____exportKey] = ____exportValue
1543
+ end
1544
+ end
1545
+ end
1546
+ do
1547
+ local ____export = require("types.Tuple")
1548
+ for ____exportKey, ____exportValue in pairs(____export) do
1549
+ if ____exportKey ~= "default" then
1550
+ ____exports[____exportKey] = ____exportValue
1551
+ end
1552
+ end
1553
+ end
1554
+ do
1555
+ local ____export = require("types.TupleKeys")
1556
+ for ____exportKey, ____exportValue in pairs(____export) do
1557
+ if ____exportKey ~= "default" then
1558
+ ____exports[____exportKey] = ____exportValue
1559
+ end
1560
+ end
1561
+ end
1562
+ do
1563
+ local ____export = require("types.TupleToIntersection")
1564
+ for ____exportKey, ____exportValue in pairs(____export) do
1565
+ if ____exportKey ~= "default" then
1566
+ ____exports[____exportKey] = ____exportValue
1567
+ end
1568
+ end
1569
+ end
1570
+ do
1571
+ local ____export = require("types.TupleToUnion")
1572
+ for ____exportKey, ____exportValue in pairs(____export) do
1573
+ if ____exportKey ~= "default" then
1574
+ ____exports[____exportKey] = ____exportValue
1575
+ end
1576
+ end
1577
+ end
1578
+ do
1579
+ local ____export = require("types.TupleWithLengthBetween")
1580
+ for ____exportKey, ____exportValue in pairs(____export) do
1581
+ if ____exportKey ~= "default" then
1582
+ ____exports[____exportKey] = ____exportValue
1583
+ end
1584
+ end
1585
+ end
1586
+ do
1587
+ local ____export = require("types.TupleWithMaxLength")
1588
+ for ____exportKey, ____exportValue in pairs(____export) do
1589
+ if ____exportKey ~= "default" then
1590
+ ____exports[____exportKey] = ____exportValue
1591
+ end
1592
+ end
1593
+ end
1594
+ do
1595
+ local ____export = require("types.UnionToIntersection")
1596
+ for ____exportKey, ____exportValue in pairs(____export) do
1597
+ if ____exportKey ~= "default" then
1598
+ ____exports[____exportKey] = ____exportValue
1599
+ end
1600
+ end
1601
+ end
1602
+ do
1603
+ local ____export = require("types.UppercaseKeys")
1604
+ for ____exportKey, ____exportValue in pairs(____export) do
1605
+ if ____exportKey ~= "default" then
1606
+ ____exports[____exportKey] = ____exportValue
1607
+ end
1608
+ end
1609
+ end
1610
+ do
1611
+ local ____export = require("types.WeightedArray")
1612
+ for ____exportKey, ____exportValue in pairs(____export) do
1613
+ if ____exportKey ~= "default" then
1614
+ ____exports[____exportKey] = ____exportValue
1615
+ end
1616
+ end
1617
+ end
1618
+ do
1619
+ local ____export = require("types.WidenLiteral")
1620
+ for ____exportKey, ____exportValue in pairs(____export) do
1621
+ if ____exportKey ~= "default" then
1622
+ ____exports[____exportKey] = ____exportValue
1623
+ end
1624
+ end
1625
+ end
1626
+ do
1627
+ local ____export = require("types.Writable")
1628
+ for ____exportKey, ____exportValue in pairs(____export) do
1629
+ if ____exportKey ~= "default" then
1630
+ ____exports[____exportKey] = ____exportValue
1631
+ end
1632
+ end
1633
+ end
1202
1634
  return ____exports
@@ -725,12 +725,14 @@ declare interface AddCallbackParametersCustom {
725
725
  playerVariant?: PlayerVariant,
726
726
  character?: PlayerType
727
727
  ];
728
- [ModCallbackCustom.PRE_ITEM_PICKUP]: [callback: (player: EntityPlayer, pickingUpItem: PickingUpItem) => void] | [
729
- callback: (player: EntityPlayer, pickingUpItem: PickingUpItemCollectible) => void,
728
+ [ModCallbackCustom.PRE_ITEM_PICKUP]: [
729
+ callback: (player: EntityPlayer, pickingUpItem: PickingUpItem) => boolean | undefined
730
+ ] | [
731
+ callback: (player: EntityPlayer, pickingUpItem: PickingUpItemCollectible) => boolean | undefined,
730
732
  itemType: ItemType.PASSIVE | ItemType.ACTIVE | ItemType.FAMILIAR,
731
733
  collectibleType?: CollectibleType
732
734
  ] | [
733
- callback: (player: EntityPlayer, pickingUpItem: PickingUpItemTrinket) => void,
735
+ callback: (player: EntityPlayer, pickingUpItem: PickingUpItemTrinket) => boolean | undefined,
734
736
  itemType: ItemType.TRINKET,
735
737
  trinketType?: TrinketType
736
738
  ];
@@ -947,7 +949,11 @@ export declare function addTrinketCostume(player: EntityPlayer, trinketType: Tri
947
949
  * - `DisplayFlag.SHADOW` (1 << 1)
948
950
  * - `DisplayFlag.SHOW_ICON` (1 << 2)
949
951
  */
950
- export declare const ALL_DISPLAY_FLAGS: BitFlags<DisplayFlag>;
952
+ export declare const ALL_DISPLAY_FLAGS: BitFlags<number & {
953
+ readonly __bitFlagBrand: symbol;
954
+ } & {
955
+ readonly __displayFlagBrand: symbol;
956
+ }>;
951
957
 
952
958
  /** Helper type to create a new tuple containing all but the first element of another tuple. */
953
959
  export declare type AllButFirst<T extends unknown[]> = T extends [
@@ -3698,6 +3704,8 @@ declare class DeployJSONRoom extends Feature {
3698
3704
  *
3699
3705
  * Under the hood, this clones the `QueuedItemData`, since directly setting the `Item` field to
3700
3706
  * `undefined` does not work for some reason.
3707
+ *
3708
+ * This method was discovered by im_tem.
3701
3709
  */
3702
3710
  export declare function dequeueItem(player: EntityPlayer): boolean;
3703
3711
 
@@ -10054,6 +10062,18 @@ export declare function isRepentanceDoor(door: GridEntityDoor): boolean;
10054
10062
  */
10055
10063
  export declare function isRepentanceStage(stageType: StageType): boolean;
10056
10064
 
10065
+ /**
10066
+ * Helper function to check if the player is using REPENTOGON, an exe-hack which expands the modding
10067
+ * API.
10068
+ *
10069
+ * Although REPENTOGON has a `REPENTOGON` global to check if it's present, it is not safe to use as
10070
+ * it can be overwritten by other mods.
10071
+ *
10072
+ * Specifically, this function checks for the `Sprite.Continue` method:
10073
+ * https://repentogon.com/Sprite.html#continue
10074
+ */
10075
+ export declare function isRepentogon(): boolean;
10076
+
10057
10077
  /** Returns true for card types that have `ItemConfigCardType.TAROT_REVERSE`. */
10058
10078
  export declare function isReverseTarotCard(cardType: CardType): boolean;
10059
10079
 
@@ -12814,8 +12834,8 @@ export declare enum ModCallbackCustom {
12814
12834
  */
12815
12835
  POST_PLAYER_COLLECTIBLE_REMOVED = 88,
12816
12836
  /**
12817
- * Fires from the `ENTITY_TAKE_DMG` callback when a player takes fatal damage. Return false to
12818
- * prevent the fatal damage.
12837
+ * Fires from the `ENTITY_TAKE_DMG` callback when a player takes fatal damage. You can optionally
12838
+ * return false to prevent the fatal damage.
12819
12839
  *
12820
12840
  * Note that this function does properly take into account Guppy's Collar, Broken Ankh, Spirit
12821
12841
  * Shackles, and Mysterious Paper. It also takes into account using The Bible on Satan.
@@ -13572,7 +13592,8 @@ export declare enum ModCallbackCustom {
13572
13592
  PRE_GET_PEDESTAL = 132,
13573
13593
  /**
13574
13594
  * Fires from the `POST_PEFFECT_UPDATE_REORDERED` callback when an item becomes queued (i.e. when
13575
- * the player begins to hold the item above their head).
13595
+ * the player begins to hold the item above their head). You can optionally return false if you
13596
+ * want the item to not be granted to the player.
13576
13597
  *
13577
13598
  * Note that this callback will only fire once per Forgotten/Soul pair.
13578
13599
  *
@@ -13586,7 +13607,7 @@ export declare enum ModCallbackCustom {
13586
13607
  * function preItemPickup(
13587
13608
  * player: EntityPlayer,
13588
13609
  * pickingUpItem: PickingUpItem,
13589
- * ): void {}
13610
+ * ): boolean | undefined {}
13590
13611
  * ```
13591
13612
  */
13592
13613
  PRE_ITEM_PICKUP = 133,
@@ -15363,7 +15384,7 @@ export declare function parseIntSafe(string: string): int | undefined;
15363
15384
  * Helper function to parse a Semantic Versioning string into its individual constituents. Returns
15364
15385
  * undefined if the submitted string was not a proper Semantic Version string.
15365
15386
  *
15366
- * https://semver.org/
15387
+ * @see https://semver.org/
15367
15388
  */
15368
15389
  export declare function parseSemanticVersion(versionString: string): {
15369
15390
  majorVersion: int;
@@ -18286,8 +18307,8 @@ export declare function sortTwoDimensionalArray<T>(a: readonly T[], b: readonly
18286
18307
  export declare type SoulHeartType = HeartSubType.SOUL | HeartSubType.BLACK | HeartSubType.BONE;
18287
18308
 
18288
18309
  /**
18289
- * Helper function to spawn an entity. Use this instead of the `Isaac.Spawn` method if you do not
18290
- * need to specify the velocity or spawner.
18310
+ * Helper function to spawn an entity. Always use this instead of the `Isaac.Spawn` method, since
18311
+ * using that method can crash the game.
18291
18312
  *
18292
18313
  * Also see the `spawnWithSeed` helper function.
18293
18314
  *
@@ -18299,7 +18320,7 @@ export declare type SoulHeartType = HeartSubType.SOUL | HeartSubType.BLACK | Hea
18299
18320
  * @param spawner Optional. The entity that will be the `SpawnerEntity`. Default is undefined.
18300
18321
  * @param seedOrRNG Optional. The seed or RNG object to use to generate the `InitSeed` of the
18301
18322
  * entity. Default is undefined, which will make the entity spawn with a random
18302
- * seed using the `Isaac.Spawn` method.
18323
+ * seed.
18303
18324
  */
18304
18325
  export declare function spawn(entityType: EntityType, variant: int, subType: int, positionOrGridIndex: Vector | int, velocity?: Vector, spawner?: Entity | undefined, seedOrRNG?: Seed | RNG | undefined): Entity;
18305
18326