@pkmn/randoms 0.7.25 → 0.7.26

package/build/index.js

@@ -300,6 +300,10 @@ var RandomGen8Teams = class {
   random(m, n) {
     return this.prng.next(m, n);
   }
+  /**
+   * Remove an element from an unsorted array significantly faster
+   * than .splice
+   */
   fastPop(list, index) {
     const length = list.length;
     if (index < 0 || index >= list.length) {
@@ -310,6 +314,10 @@ var RandomGen8Teams = class {
     list.pop();
     return element;
   }
+  /**
+   * Remove a random element from an unsorted array and return it.
+   * Uses the battle's RNG if in a battle.
+   */
   sampleNoReplace(list) {
     const length = list.length;
     if (length === 0)
@@ -317,6 +325,11 @@ var RandomGen8Teams = class {
     const index = this.random(length);
     return this.fastPop(list, index);
   }
+  /**
+   * Removes n random elements from an unsorted array and returns them.
+   * If n is less than the array's length, randomly removes and returns all the elements
+   * in the array (so the returned array could have length < n).
+   */
   multipleSamplesNoReplace(list, n) {
     const samples = [];
     while (samples.length < n && list.length) {
@@ -324,6 +337,10 @@ var RandomGen8Teams = class {
     }
     return samples;
   }
+  /**
+   * Check if user has directly tried to ban/unban/restrict things in a custom battle.
+   * Doesn't count bans nested inside other formats/rules.
+   */
   hasDirectCustomBanlistChanges() {
     if (!this.format.customRules)
       return false;
@@ -335,11 +352,17 @@ var RandomGen8Teams = class {
     }
     return false;
   }
+  /**
+   * Inform user when custom bans are unsupported in a team generator.
+   */
   enforceNoDirectCustomBanlistChanges() {
     if (this.hasDirectCustomBanlistChanges()) {
       throw new Error(`Custom bans are not currently supported in ${this.format.name}.`);
     }
   }
+  /**
+   * Inform user when complex bans are unsupported in a team generator.
+   */
   enforceNoDirectComplexBans() {
     if (!this.format.customRules)
       return false;
@@ -349,6 +372,9 @@ var RandomGen8Teams = class {
       }
     }
   }
+  /**
+   * Validate set element pool size is sufficient to support size requirements after simple bans.
+   */
   enforceCustomPoolSizeNoComplexBans(effectTypeName, basicEffectPool, requiredCount, requiredCountExplanation) {
     if (basicEffectPool.length >= requiredCount)
       return;
@@ -884,7 +910,10 @@ var RandomGen8Teams = class {
             counter.add("stab");
             categories[move.category] += 0.1;
           }
-        } else if (moveType === "Normal" && ["Aerilate", "Galvanize", "Pixilate", "Refrigerate"].some((abil) => abilities.has(abil)) || move.priority === 0 && (abilities.has("Libero") || abilities.has("Protean")) && !this.noStab.includes(moveid) || moveType === "Steel" && abilities.has("Steelworker")) {
+        } else if (
+          // Less obvious forms of STAB
+          moveType === "Normal" && ["Aerilate", "Galvanize", "Pixilate", "Refrigerate"].some((abil) => abilities.has(abil)) || move.priority === 0 && (abilities.has("Libero") || abilities.has("Protean")) && !this.noStab.includes(moveid) || moveType === "Steel" && abilities.has("Steelworker")
+        ) {
           counter.add("stab");
         }
         if (move.flags["bite"])
@@ -1169,7 +1198,10 @@ var RandomGen8Teams = class {
       case "leafstorm":
         const leafBladePossible = movePool.includes("leafblade") || moves.has("leafblade");
         return {
-          cull: counter.setupType === "Physical" && (species.id === "virizion" || leafBladePossible) || moves.has("gigadrain") && !!counter.get("Status") || isDoubles && moves.has("energyball")
+          cull: (
+            // Virizion should always prefer Leaf Blade to Leaf Storm on Physical sets
+            counter.setupType === "Physical" && (species.id === "virizion" || leafBladePossible) || moves.has("gigadrain") && !!counter.get("Status") || isDoubles && moves.has("energyball")
+          )
         };
       case "powerwhip":
         return { cull: moves.has("leechlife") };
@@ -1246,7 +1278,8 @@ var RandomGen8Teams = class {
         return { cull: moves.has("knockoff") };
       case "shadowball":
         return {
-          cull: isDoubles && moves.has("phantomforce") || abilities.has("Pixilate") && (!!counter.setupType || counter.get("Status") > 1) || !types.has("Ghost") && movePool.includes("focusblast")
+          cull: isDoubles && moves.has("phantomforce") || // Special case for Sylveon, which never wants Shadow Ball as its only coverage move
+          abilities.has("Pixilate") && (!!counter.setupType || counter.get("Status") > 1) || !types.has("Ghost") && movePool.includes("focusblast")
         };
       case "shadowclaw":
         return { cull: types.has("Steel") && moves.has("shadowsneak") && counter.get("Physical") < 4 };
@@ -1259,7 +1292,10 @@ var RandomGen8Teams = class {
         return { cull: pulseIncompatible && !shiftryCase && counter.setupType !== "Special" };
       case "suckerpunch":
         return {
-          cull: isNoDynamax && species.id === "shiftry" && moves.has("defog") || moves.has("rest") || counter.damagingMoves.size < 2 || counter.setupType === "Special" || counter.get("Dark") > 1 && !types.has("Dark")
+          cull: (
+            // Shiftry in No Dynamax would otherwise get Choice Scarf Sucker Punch sometimes.
+            isNoDynamax && species.id === "shiftry" && moves.has("defog") || moves.has("rest") || counter.damagingMoves.size < 2 || counter.setupType === "Special" || counter.get("Dark") > 1 && !types.has("Dark")
+          )
         };
       case "dazzlinggleam":
         return { cull: ["fleurcannon", "moonblast", "petaldance"].some((m) => moves.has(m)) };
@@ -1280,7 +1316,9 @@ var RandomGen8Teams = class {
         return { cull: moves.has("rest") || moves.has("wish") || move.id === "synthesis" && moves.has("gigadrain") };
       case "roost":
         return {
-          cull: moves.has("throatchop") || moves.has("stoneedge") && species.id === "hawlucha" || moves.has("dualwingbeat") && (moves.has("outrage") || species.id === "scizor")
+          cull: moves.has("throatchop") || // Hawlucha doesn't want Roost + 3 attacks
+          moves.has("stoneedge") && species.id === "hawlucha" || // Special cases for Salamence, Dynaless Dragonite, and Scizor to help prevent sets with poor coverage or no setup.
+          moves.has("dualwingbeat") && (moves.has("outrage") || species.id === "scizor")
         };
       case "reflect":
       case "lightscreen":
@@ -1456,9 +1494,14 @@ var RandomGen8Teams = class {
       case "Synchronize":
         return counter.get("Status") < 3;
       case "Technician":
-        return !counter.get("technician") || moves.has("tailslap") || abilities.has("Punk Rock") || movePool.includes("snarl");
+        return !counter.get("technician") || moves.has("tailslap") || abilities.has("Punk Rock") || // For Doubles Alolan Persian
+        movePool.includes("snarl");
       case "Tinted Lens":
-        return moves.has("defog") || moves.has("hurricane") && abilities.has("Compound Eyes") || counter.get("Status") > 2 && !counter.setupType;
+        return (
+          // For Sigilyph
+          moves.has("defog") || // For Butterfree
+          moves.has("hurricane") && abilities.has("Compound Eyes") || counter.get("Status") > 2 && !counter.setupType
+        );
       case "Torrent":
         return moves.has("focusenergy") || moves.has("hypervoice");
       case "Tough Claws":
@@ -1564,6 +1607,7 @@ var RandomGen8Teams = class {
       return "Heavy-Duty Boots";
     }
   }
+  /** Item generation specific to Random Doubles */
   getDoublesItem(ability, types, moves, abilities, counter, teamDetails, species) {
     const defensiveStatTotal = species.baseStats.hp + species.baseStats.def + species.baseStats.spd;
     if (["dragonenergy", "eruption", "waterspout"].some((m) => moves.has(m)) && counter.damagingMoves.size >= 4)
@@ -1628,7 +1672,10 @@ var RandomGen8Teams = class {
     const defensiveStatTotal = species.baseStats.hp + species.baseStats.def + species.baseStats.spd;
     if (isLead && !isDoubles && !["Disguise", "Sturdy"].includes(ability) && !moves.has("substitute") && !counter.get("drain") && !counter.get("recoil") && !counter.get("recovery") && (defensiveStatTotal <= 250 && counter.get("hazards") || defensiveStatTotal <= 210))
       return "Focus Sash";
-    if (moves.has("clangoroussoul") || moves.has("boomburst") && Array.from(moves).some((m) => {
+    if (moves.has("clangoroussoul") || // We manually check for speed-boosting moves, rather than using `counter.get('speedsetup')`,
+    // because we want to check for ANY speed boosting move.
+    // In particular, Shift Gear + Boomburst Toxtricity should get Throat Spray.
+    moves.has("boomburst") && Array.from(moves).some((m) => {
       var _a;
       return (_a = this.dex.moves.get(m).boosts) == null ? void 0 : _a.spe;
     }))
@@ -1639,7 +1686,8 @@ var RandomGen8Teams = class {
       return "Heavy-Duty Boots";
     if (!isDoubles && this.dex.getEffectiveness("Ground", species) >= 2 && !types.has("Poison") && ability !== "Levitate" && !abilities.has("Iron Barbs"))
       return "Air Balloon";
-    if (!isDoubles && counter.damagingMoves.size >= 3 && !counter.get("damage") && ability !== "Sturdy" && (species.baseStats.spe >= 90 || !moves.has("voltswitch")) && ["foulplay", "rapidspin", "substitute", "uturn"].every((m) => !moves.has(m)) && (counter.get("speedsetup") || counter.get("drain") && (!isNoDynamax || species.id !== "buzzwole" || moves.has("roost")) || moves.has("trickroom") || moves.has("psystrike") || species.baseStats.spe > 40 && defensiveStatTotal < 275))
+    if (!isDoubles && counter.damagingMoves.size >= 3 && !counter.get("damage") && ability !== "Sturdy" && (species.baseStats.spe >= 90 || !moves.has("voltswitch")) && ["foulplay", "rapidspin", "substitute", "uturn"].every((m) => !moves.has(m)) && (counter.get("speedsetup") || // No Dynamax Buzzwole doesn't want Life Orb with Bulk Up + 3 attacks
+    counter.get("drain") && (!isNoDynamax || species.id !== "buzzwole" || moves.has("roost")) || moves.has("trickroom") || moves.has("psystrike") || species.baseStats.spe > 40 && defensiveStatTotal < 275))
       return "Life Orb";
     if (!isDoubles && counter.damagingMoves.size >= 4 && !counter.get("Dragon") && !counter.get("Normal")) {
       return "Expert Belt";
@@ -1669,6 +1717,7 @@ var RandomGen8Teams = class {
         NFE: 88
       };
       const customScale = {
+        // These Pokemon are too strong and need a lower level
         zaciancrowned: 65,
         calyrexshadow: 68,
         xerneas: 70,
@@ -1691,6 +1740,7 @@ var RandomGen8Teams = class {
         polteageist: 84,
         wobbuffet: 86,
         scrafty: 86,
+        // These Pokemon are too weak and need a higher level
         delibird: 100,
         vespiquen: 96,
         pikachu: 92,
@@ -1822,7 +1872,13 @@ var RandomGen8Teams = class {
         const moveIsRejectable = !(species.id === "genesectdouse" && move.id === "technoblast") && !(species.id === "togekiss" && move.id === "nastyplot") && !(species.id === "shuckle" && ["stealthrock", "stickyweb"].includes(move.id)) && (move.category === "Status" || !types.has(move.type) && move.id !== "judgment" || isLowBP && !move.multihit && !abilities.has("Technician"));
         const notImportantSetup = !counter.setupType || counter.setupType === "Mixed" || counter.get(counter.setupType) + counter.get("Status") > 3 && !counter.get("hazards") || move.category !== counter.setupType && move.category !== "Status";
         if (moveIsRejectable && (!cull && !isSetup && !move.weather && !move.stallingMove && notImportantSetup && !move.damage && (isDoubles ? this.unrejectableMovesInDoubles(move) : this.unrejectableMovesInSingles(move)))) {
-          if (!counter.get("stab") && counter.get("physicalpool") + counter.get("specialpool") > 0 && move.id !== "stickyweb" || moves.has("swordsdance") && species.id === "mew" && runEnforcementChecker("Flying") || abilities.has("Steelworker") && runEnforcementChecker("Steel") || !isDoubles && runEnforcementChecker("recovery") && move.id !== "stickyweb" || runEnforcementChecker("screens") || runEnforcementChecker("misc") || (isLead || species.id === "shuckle") && runEnforcementChecker("lead") || moves.has("leechseed") && runEnforcementChecker("leechseed")) {
+          if (
+            // Pokemon should have at least one STAB move
+            !counter.get("stab") && counter.get("physicalpool") + counter.get("specialpool") > 0 && move.id !== "stickyweb" || // Swords Dance Mew should have Brave Bird
+            moves.has("swordsdance") && species.id === "mew" && runEnforcementChecker("Flying") || // Dhelmise should have Anchor Shot
+            abilities.has("Steelworker") && runEnforcementChecker("Steel") || // Check for miscellaneous important moves
+            !isDoubles && runEnforcementChecker("recovery") && move.id !== "stickyweb" || runEnforcementChecker("screens") || runEnforcementChecker("misc") || (isLead || species.id === "shuckle") && runEnforcementChecker("lead") || moves.has("leechseed") && runEnforcementChecker("leechseed")
+          ) {
             cull = true;
           } else if (move.id !== "stickyweb" && !(species.id === "azumarill" && move.id === "aquajet")) {
             for (const type of types) {
@@ -1914,7 +1970,8 @@ var RandomGen8Teams = class {
       } while (rejectAbility);
       if (forme === "Copperajah" && gmax) {
         ability = "Heavy Metal";
-      } else if (abilities.has("Guts") && !abilities.has("Quick Feet") && (species.id === "gurdurr" || species.id === "throh" || moves.has("facade") || moves.has("rest") && moves.has("sleeptalk"))) {
+      } else if (abilities.has("Guts") && // for Ursaring in BDSP
+      !abilities.has("Quick Feet") && (species.id === "gurdurr" || species.id === "throh" || moves.has("facade") || moves.has("rest") && moves.has("sleeptalk"))) {
         ability = "Guts";
       } else if (abilities.has("Moxie") && (counter.get("Physical") > 3 || moves.has("bounce")) && !isDoubles) {
         ability = "Moxie";
@@ -3000,7 +3057,8 @@ var RandomGen7Teams = class extends RandomGen8Teams {
       case "facade":
         return { cull: moves.has("bulkup") || hasRestTalk };
       case "hiddenpower":
-        return { cull: moves.has("rest") || !counter.get("stab") && counter.damagingMoves.size < 2 || counter.setupType === "Special" && types.has("Fairy") && movePool.includes("moonblast") };
+        return { cull: moves.has("rest") || !counter.get("stab") && counter.damagingMoves.size < 2 || // Force Moonblast on Special-setup Fairies
+        counter.setupType === "Special" && types.has("Fairy") && movePool.includes("moonblast") };
       case "hypervoice":
         return { cull: moves.has("blizzard") };
       case "judgment":
@@ -3544,7 +3602,8 @@ var RandomGen7Teams = class extends RandomGen8Teams {
         if (counter.setupType === "Special" && moveid === "hiddenpower" && species.types.length > 1 && counter.get("Special") <= 2 && !types.has(move.type) && !counter.get("Physical") && counter.get("specialpool")) {
           cull = true;
         }
-        const singlesEnforcement = !["judgment", "lightscreen", "quiverdance", "reflect", "sleeptalk", "toxic"].includes(moveid) && (move.category !== "Status" || !(move.flags.heal && species.id !== "meganium"));
+        const singlesEnforcement = !["judgment", "lightscreen", "quiverdance", "reflect", "sleeptalk", "toxic"].includes(moveid) && (move.category !== "Status" || // should allow Meganium to cull a recovery move for the sake of STAB
+        !(move.flags.heal && species.id !== "meganium"));
         if (!cull && !move.damage && !isSetup && !move.weather && !move.stallingMove && (isDoubles || singlesEnforcement) && (!counter.setupType || counter.setupType === "Mixed" || move.category !== counter.setupType && move.category !== "Status" || counter.get(counter.setupType) + counter.get("Status") > 3 && !counter.get("hazards")) && (move.category === "Status" || !types.has(move.type) || move.basePower && move.basePower < 40 && !move.multihit)) {
           if (!counter.get("stab") && !moves.has("nightshade") && !moves.has("seismictoss") && (species.types.length > 1 || species.types[0] !== "Normal" && species.types[0] !== "Psychic" || !moves.has("icebeam") || species.baseStats.spa >= species.baseStats.spd) || moves.has("suckerpunch") && !abilities.has("Contrary") && counter.get("stab") < species.types.length && species.id !== "honchkrow" || ["recover", "roost", "slackoff", "softboiled"].some((m) => movePool.includes(m)) && counter.get("Status") && !counter.setupType && ["healingwish", "switcheroo", "trick", "trickroom"].every((m) => !moves.has(m)) || (movePool.includes("milkdrink") || movePool.includes("shoreup") || movePool.includes("moonlight") && types.size < 2 || movePool.includes("stickyweb") && !counter.setupType && !teamDetails.stickyWeb || movePool.includes("quiverdance") && ["defog", "uturn", "stickyweb"].every((m) => !moves.has(m)) && counter.get("Special") < 4) || isLead && movePool.includes("stealthrock") && counter.get("Status") && !counter.setupType && !counter.get("speedsetup") && !moves.has("substitute") || species.requiredMove && movePool.includes(_sim.toID.call(void 0, species.requiredMove)) || !counter.get("Normal") && (abilities.has("Aerilate") || abilities.has("Pixilate") || abilities.has("Refrigerate") && !moves.has("blizzard"))) {
             cull = true;
@@ -3701,12 +3760,14 @@ var RandomGen7Teams = class extends RandomGen8Teams {
     } else if (!isDoubles) {
       const levelScale = { uber: 76, ou: 80, uu: 82, ru: 84, nu: 86, pu: 88 };
       const customScale = {
+        // Banned Ability
         Dugtrio: 82,
         Gothitelle: 82,
         Pelipper: 84,
         Politoed: 84,
         Torkoal: 84,
         Wobbuffet: 82,
+        // Holistic judgement
         "Castform-Rainy": 100,
         "Castform-Snowy": 100,
         "Castform-Sunny": 100,
@@ -4737,7 +4798,8 @@ var RandomGen6Teams = class extends RandomGen7Teams {
       case "extremespeed":
         return { cull: counter.setupType !== "Physical" && moves.has("vacuumwave") };
       case "hiddenpower":
-        return { cull: moves.has("rest") || !counter.get("stab") && counter.damagingMoves.size < 2 || counter.setupType === "Special" && types.has("Fairy") && movePool.includes("moonblast") };
+        return { cull: moves.has("rest") || !counter.get("stab") && counter.damagingMoves.size < 2 || // Force Moonblast on Special-setup Fairies
+        counter.setupType === "Special" && types.has("Fairy") && movePool.includes("moonblast") };
       case "hypervoice":
         return { cull: moves.has("blizzard") || moves.has("return") };
       case "judgment":
@@ -5289,11 +5351,13 @@ var RandomGen6Teams = class extends RandomGen7Teams {
       pu: 88
     };
     const customScale = {
+      // Banned Ability
       Dugtrio: 82,
       Gothitelle: 82,
       Ninetales: 84,
       Politoed: 84,
       Wobbuffet: 82,
+      // Holistic judgement
       "Castform-Rainy": 100,
       "Castform-Snowy": 100,
       "Castform-Sunny": 100,
@@ -5786,7 +5850,8 @@ var RandomGen5Teams = class extends RandomGen6Teams {
         const gliscorCase = species.id === "gliscor" && moves.has("protect");
         return { cull: ["leechseed", "rest", "wish"].some((m) => moves.has(m)) || gliscorCase };
       case "substitute":
-        return { cull: moves.has("doubleedge") && !abilities.has("rockhead") || ["pursuit", "rest", "superpower", "uturn", "voltswitch"].some((m) => moves.has(m)) || moves.has("acrobatics") && moves.has("earthquake") };
+        return { cull: moves.has("doubleedge") && !abilities.has("rockhead") || ["pursuit", "rest", "superpower", "uturn", "voltswitch"].some((m) => moves.has(m)) || // Sceptile wants Swords Dance
+        moves.has("acrobatics") && moves.has("earthquake") };
       case "thunderwave":
         return { cull: !!counter.setupType || !!counter.get("speedsetup") || hasRestTalk || moves.has("discharge") || moves.has("trickroom") };
       case "willowisp":
@@ -6837,7 +6902,8 @@ var RandomGen4Teams = class extends RandomGen5Teams {
           }
         }
         if (counter.setupType && !isSetup && move.category !== counter.setupType && counter.get(counter.setupType) < 2 && !moves.has("batonpass")) {
-          if (moveid !== "rest" && moveid !== "sleeptalk" && !(recoveryMoves.includes(moveid) && (moves.has("healbell") || moves.has("refresh"))) && !((moveid === "healbell" || moveid === "refresh") && Array.from(moves).some((id) => recoveryMoves.includes(id))) && (move.category !== "Status" || counter.get(counter.setupType) + counter.get("Status") > 3 && counter.get("physicalsetup") + counter.get("specialsetup") < 2)) {
+          if (moveid !== "rest" && moveid !== "sleeptalk" && !(recoveryMoves.includes(moveid) && (moves.has("healbell") || moves.has("refresh"))) && !((moveid === "healbell" || moveid === "refresh") && Array.from(moves).some((id) => recoveryMoves.includes(id))) && // Reject Status moves only if there is nothing else to reject
+          (move.category !== "Status" || counter.get(counter.setupType) + counter.get("Status") > 3 && counter.get("physicalsetup") + counter.get("specialsetup") < 2)) {
             cull = true;
           }
         }
@@ -6860,9 +6926,14 @@ var RandomGen4Teams = class extends RandomGen5Teams {
             teamDetails
           );
         };
-        const moveIsRejectable = !move.weather && !move.damage && (move.category !== "Status" || !move.flags.heal) && (move.category === "Status" || !types.has(move.type) || move.basePower && move.basePower < 40 && !move.multihit) && !["judgment", "lightscreen", "reflect", "sleeptalk"].includes(moveid) && (counter.get("physicalsetup") + counter.get("specialsetup") < 2 && (!counter.setupType || counter.setupType === "Mixed" || move.category !== counter.setupType && move.category !== "Status" || counter.get(counter.setupType) + counter.get("Status") > 3));
+        const moveIsRejectable = !move.weather && !move.damage && (move.category !== "Status" || !move.flags.heal) && (move.category === "Status" || !types.has(move.type) || move.basePower && move.basePower < 40 && !move.multihit) && // These moves cannot be rejected in favor of a forced move
+        !["judgment", "lightscreen", "reflect", "sleeptalk"].includes(moveid) && // Setup-supported moves should only be rejected under specific circumstances
+        (counter.get("physicalsetup") + counter.get("specialsetup") < 2 && (!counter.setupType || counter.setupType === "Mixed" || move.category !== counter.setupType && move.category !== "Status" || counter.get(counter.setupType) + counter.get("Status") > 3));
         if (!cull && !isSetup && moveIsRejectable) {
-          const canRollForcedMoves = movePool.includes("spore") || !Array.from(moves).some((id) => recoveryMoves.includes(id)) && (movePool.includes("softboiled") && !moves.has("explosion") || species.baseSpecies === "Arceus" && movePool.includes("recover"));
+          const canRollForcedMoves = (
+            // These moves should always be rolled
+            movePool.includes("spore") || !Array.from(moves).some((id) => recoveryMoves.includes(id)) && (movePool.includes("softboiled") && !moves.has("explosion") || species.baseSpecies === "Arceus" && movePool.includes("recover"))
+          );
           const requiresStab = !counter.get("stab") && !counter.get("damage") && (species.types.length > 1 || species.types[0] !== "Normal" && species.types[0] !== "Psychic" || !moves.has("icebeam") || species.baseStats.spa >= species.baseStats.spd);
           if (canRollForcedMoves || requiresStab || species.requiredMove && movePool.includes(_sim.toID.call(void 0, species.requiredMove)) || counter.get("defensesetup") && !counter.get("recovery") && !moves.has("rest")) {
             cull = true;
@@ -7044,6 +7115,7 @@ var RandomGen3Teams = class extends RandomGen4Teams {
       Psychic: (movePool, moves, abilities, types, counter, species) => types.has("Psychic") && (movePool.includes("psychic") || movePool.includes("psychoboost")) && species.baseStats.spa >= 100,
       Rock: (movePool, moves, abilities, types, counter, species) => !counter.get("Rock") && species.baseStats.atk >= 100,
       Water: (movePool, moves, abilities, types, counter, species) => !counter.get("Water") && counter.setupType !== "Physical" && species.baseStats.spa >= 60,
+      // If the Pokémon has this move, the other move will be forced
       protect: (movePool) => movePool.includes("wish"),
       sunnyday: (movePool) => movePool.includes("solarbeam"),
       sleeptalk: (movePool) => movePool.includes("rest")
@@ -7097,7 +7169,8 @@ var RandomGen3Teams = class extends RandomGen4Teams {
       case "sunnyday":
         return { cull: counter.damagingMoves.size < 2 || moves.has("rest") };
       case "focuspunch":
-        return { cull: counter.damagingMoves.size < 2 || moves.has("rest") || counter.setupType && !moves.has("spore") || !moves.has("substitute") && (counter.get("Physical") < 4 || moves.has("fakeout")) || species.id === "breloom" && (moves.has("machpunch") || moves.has("skyuppercut")) };
+        return { cull: counter.damagingMoves.size < 2 || moves.has("rest") || counter.setupType && !moves.has("spore") || !moves.has("substitute") && (counter.get("Physical") < 4 || moves.has("fakeout")) || // Breloom likes to have coverage
+        species.id === "breloom" && (moves.has("machpunch") || moves.has("skyuppercut")) };
       case "moonlight":
         return { cull: moves.has("wish") || moves.has("protect") };
       case "perishsong":
@@ -7201,7 +7274,8 @@ var RandomGen3Teams = class extends RandomGen4Teams {
       case "gigadrain":
         return { cull: moves.has("morningsun") || moves.has("toxic") };
       case "hiddenpower":
-        const stabCondition = types.has(move.type) && counter.get(move.type) > 1 && (moves.has("substitute") && !counter.setupType && !moves.has("toxic") || species.id !== "meganium" && moves.has("toxic") && !moves.has("substitute") || restTalk);
+        const stabCondition = types.has(move.type) && counter.get(move.type) > 1 && (moves.has("substitute") && !counter.setupType && !moves.has("toxic") || // This otherwise causes STABless meganium
+        species.id !== "meganium" && moves.has("toxic") && !moves.has("substitute") || restTalk);
         return { cull: stabCondition || move.type === "Grass" && moves.has("sunnyday") && moves.has("solarbeam") };
       case "brickbreak":
       case "crosschop":
@@ -7332,8 +7406,12 @@ var RandomGen3Teams = class extends RandomGen4Teams {
         if (counter.setupType === "Physical" && move.category === "Special" && !types.has(move.type) && move.type !== "Fire" || counter.setupType === "Special" && move.category === "Physical" && moveid !== "superpower") {
           cull = true;
         }
-        const moveIsRejectable = !move.weather && (move.category !== "Status" || !move.flags.heal) && (counter.setupType || !move.stallingMove) && !["batonpass", "sleeptalk", "solarbeam", "substitute", "sunnyday"].includes(moveid) && (move.category === "Status" || !types.has(move.type) || move.basePower && move.basePower < 40 && !move.multihit);
-        const requiresStab = !counter.get("stab") && !moves.has("seismictoss") && !moves.has("nightshade") && species.id !== "castform" && species.id !== "umbreon" && !(moves.has("psychic") && types.has("Flying")) && !(types.has("Ghost") && species.baseStats.spa > species.baseStats.atk) && !(counter.setupType === "Special" && (species.id === "lugia" || types.has("Normal") && species.types.length < 2)) && !(counter.setupType === "Physical" && (types.has("Water") && species.types.length < 2 || types.has("Dark"))) && counter.get("physicalpool") + counter.get("specialpool") > 0;
+        const moveIsRejectable = !move.weather && (move.category !== "Status" || !move.flags.heal) && (counter.setupType || !move.stallingMove) && // These moves cannot be rejected in favor of a forced move
+        !["batonpass", "sleeptalk", "solarbeam", "substitute", "sunnyday"].includes(moveid) && (move.category === "Status" || !types.has(move.type) || move.basePower && move.basePower < 40 && !move.multihit);
+        const requiresStab = !counter.get("stab") && !moves.has("seismictoss") && !moves.has("nightshade") && species.id !== "castform" && species.id !== "umbreon" && // If a Flying-type has Psychic, it doesn't need STAB
+        !(moves.has("psychic") && types.has("Flying")) && !(types.has("Ghost") && species.baseStats.spa > species.baseStats.atk) && !// With Calm Mind, Lugia and pure Normal-types are fine without STAB
+        (counter.setupType === "Special" && (species.id === "lugia" || types.has("Normal") && species.types.length < 2)) && !// With Swords Dance, Dark-types and pure Water-types are fine without STAB
+        (counter.setupType === "Physical" && (types.has("Water") && species.types.length < 2 || types.has("Dark"))) && counter.get("physicalpool") + counter.get("specialpool") > 0;
         const runEnforcementChecker = (checkerName) => {
           if (!this.moveEnforcementCheckers[checkerName])
             return false;
@@ -7732,9 +7810,15 @@ var RandomGen2Teams = class extends RandomGen3Teams {
         if (counter.setupType === "Physical" && move.category === "Special" && !counter.get("Physical")) {
           cull = true;
         }
-        const moveIsRejectable = (move.category !== "Status" || !move.flags.heal) && !["batonpass", "sleeptalk", "spikes", "sunnyday"].includes(move.id) && (move.category === "Status" || !types.has(move.type) || move.basePower && move.basePower < 40);
+        const moveIsRejectable = (move.category !== "Status" || !move.flags.heal) && // These moves cannot be rejected in favor of a forced move
+        !["batonpass", "sleeptalk", "spikes", "sunnyday"].includes(move.id) && (move.category === "Status" || !types.has(move.type) || move.basePower && move.basePower < 40);
         if (!cull && !isSetup && moveIsRejectable && (counter.setupType || !move.stallingMove)) {
-          if (!counter.get("stab") && !counter.get("damage") && !types.has("Ghost") && counter.get("physicalpool") + counter.get("specialpool") > 0 || (movePool.includes("megahorn") || movePool.includes("softboiled") && moves.has("present")) || (moves.has("rest") && movePool.includes("sleeptalk") || moves.has("sleeptalk") && movePool.includes("rest")) || (moves.has("sunnyday") && movePool.includes("solarbeam") || moves.has("solarbeam") && movePool.includes("sunnyday")) || ["milkdrink", "recover", "spore"].some((m) => movePool.includes(m))) {
+          if (
+            // Pokemon should usually have at least one STAB move
+            !counter.get("stab") && !counter.get("damage") && !types.has("Ghost") && counter.get("physicalpool") + counter.get("specialpool") > 0 || (movePool.includes("megahorn") || movePool.includes("softboiled") && moves.has("present")) || // Rest + Sleep Talk should be selected together
+            (moves.has("rest") && movePool.includes("sleeptalk") || moves.has("sleeptalk") && movePool.includes("rest")) || // Sunny Day + Solar Beam should be selected together
+            (moves.has("sunnyday") && movePool.includes("solarbeam") || moves.has("solarbeam") && movePool.includes("sunnyday")) || ["milkdrink", "recover", "spore"].some((m) => movePool.includes(m))
+          ) {
             cull = true;
           } else {
             for (const type of types) {
@@ -7812,6 +7896,7 @@ var RandomGen2Teams = class extends RandomGen3Teams {
       ivs,
       item: this.getItem("None", types, moves, counter, species),
       level,
+      // No shiny chance because Gen 2 shinies have bad IVs
       shiny: false,
       gender: species.gender ? species.gender : "M"
     };
@@ -7820,6 +7905,7 @@ var RandomGen2Teams = class extends RandomGen3Teams {
 
 // src/gen1.ts
 var RandomGen1Teams = class extends RandomGen2Teams {
+  // Challenge Cup or CC teams are basically fully random teams.
   randomCCTeam() {
     this.enforceNoDirectCustomBanlistChanges();
     const team = [];
@@ -7894,6 +7980,7 @@ var RandomGen1Teams = class extends RandomGen2Teams {
     }
     return team;
   }
+  // Random team generation for Gen 1 Random Battles.
   randomTeam() {
     this.enforceNoDirectCustomBanlistChanges();
     const seed = this.prng.seed;
@@ -8012,6 +8099,9 @@ var RandomGen1Teams = class extends RandomGen2Teams {
     }
     return { cull: false };
   }
+  /**
+   * Random set generation for Gen 1 Random Battles.
+   */
   randomSet(species) {
     species = this.dex.species.get(species);
     if (!species.exists)
@@ -8208,6 +8298,7 @@ var RandomGen1Teams = class extends RandomGen2Teams {
         nature: "",
         level,
         shiny: false,
+        // Hacky but the only way to communicate stats/level generation properly
         hc: hackmonsCup[species.id]
       });
     }
@@ -8386,6 +8477,7 @@ function sereneGraceBenefits2(move) {
 }
 var RandomTeams = class {
   constructor(dex, format, prng) {
+    // TODO: Make types for this
     this.randomSets = randomSetsJSON;
     this.randomDoublesSets = randomSetsJSON;
     this.dex = dex;
@@ -8465,6 +8557,10 @@ var RandomTeams = class {
   random(m, n) {
     return this.prng.next(m, n);
   }
+  /**
+   * Remove an element from an unsorted array significantly faster
+   * than .splice
+   */
   fastPop(list, index) {
     const length = list.length;
     if (index < 0 || index >= list.length) {
@@ -8475,6 +8571,10 @@ var RandomTeams = class {
     list.pop();
     return element;
   }
+  /**
+   * Remove a random element from an unsorted array and return it.
+   * Uses the battle's RNG if in a battle.
+   */
   sampleNoReplace(list) {
     const length = list.length;
     if (length === 0)
@@ -8482,6 +8582,11 @@ var RandomTeams = class {
     const index = this.random(length);
     return this.fastPop(list, index);
   }
+  /**
+   * Removes n random elements from an unsorted array and returns them.
+   * If n is less than the array's length, randomly removes and returns all the elements
+   * in the array (so the returned array could have length < n).
+   */
   multipleSamplesNoReplace(list, n) {
     const samples = [];
     while (samples.length < n && list.length) {
@@ -8489,7 +8594,13 @@ var RandomTeams = class {
     }
     return samples;
   }
+  /**
+   * Check if user has directly tried to ban/unban/restrict things in a custom battle.
+   * Doesn't count bans nested inside other formats/rules.
+   */
   hasDirectCustomBanlistChanges() {
+    if (this.format.banlist.length || this.format.restricted.length || this.format.unbanlist.length)
+      return true;
     if (!this.format.customRules)
       return false;
     for (const rule of this.format.customRules) {
@@ -8500,11 +8611,17 @@ var RandomTeams = class {
     }
     return false;
   }
+  /**
+   * Inform user when custom bans are unsupported in a team generator.
+   */
   enforceNoDirectCustomBanlistChanges() {
     if (this.hasDirectCustomBanlistChanges()) {
       throw new Error(`Custom bans are not currently supported in ${this.format.name}.`);
     }
   }
+  /**
+   * Inform user when complex bans are unsupported in a team generator.
+   */
   enforceNoDirectComplexBans() {
     if (!this.format.customRules)
       return false;
@@ -8514,6 +8631,9 @@ var RandomTeams = class {
       }
     }
   }
+  /**
+   * Validate set element pool size is sufficient to support size requirements after simple bans.
+   */
   enforceCustomPoolSizeNoComplexBans(effectTypeName, basicEffectPool, requiredCount, requiredCountExplanation) {
     if (basicEffectPool.length >= requiredCount)
       return;
@@ -8676,6 +8796,7 @@ var RandomTeams = class {
     this.incompatibleMoves(moves, movePool, "bodypress", "mirrorcoat");
     this.incompatibleMoves(moves, movePool, "toxic", "clearsmog");
   }
+  // Checks for and removes incompatible moves, starting with the first move in movesA.
   incompatibleMoves(moves, movePool, movesA, movesB) {
     const moveArrayA = Array.isArray(movesA) ? movesA : [movesA];
     const moveArrayB = Array.isArray(movesB) ? movesB : [movesB];
@@ -8702,6 +8823,7 @@ var RandomTeams = class {
       }
     }
   }
+  // Adds a move to the moveset, returns the MoveCounter
   addMove(move, moves, types, abilities, teamDetails, species, isLead, isDoubles, movePool, teraType, role) {
     moves.add(move);
     this.fastPop(movePool, movePool.indexOf(move));
@@ -8709,6 +8831,7 @@ var RandomTeams = class {
     this.cullMovePool(types, moves, abilities, counter, movePool, teamDetails, species, isLead, isDoubles, teraType, role);
     return counter;
   }
+  // Returns the type of a given move for STAB/coverage enforcement purposes
   getMoveType(move, species, abilities, teraType) {
     if (move.id === "terablast")
       return teraType;
@@ -8735,6 +8858,7 @@ var RandomTeams = class {
     }
     return moveType;
   }
+  // Generate random moveset for a given species, role, tera type.
   randomMoveset(types, abilities, teamDetails, species, isLead, isDoubles, movePool, teraType, role) {
     const moves = /* @__PURE__ */ new Set();
     let counter = this.queryMoves(moves, species, teraType, abilities);
@@ -9398,6 +9522,8 @@ var RandomTeams = class {
     if (this.dex.getEffectiveness("Rock", species) >= 2)
       return "Heavy-Duty Boots";
   }
+  /** Item generation specific to Random Doubles */
+  // This will be changed and used later, once doubles is actually coming out.
   getDoublesItem(ability, types, moves, counter, teamDetails, species, teraType, role) {
     const defensiveStatTotal = species.baseStats.hp + species.baseStats.def + species.baseStats.spd;
     if (["dragonenergy", "eruption", "waterspout"].some((m) => moves.has(m)) && counter.damagingMoves.size >= 4)
@@ -9652,6 +9778,7 @@ var RandomTeams = class {
     }
     return [pokemonPool, baseSpeciesPool];
   }
+  // Doubles sets are the same as singles for now
   randomTeam() {
     this.enforceNoDirectCustomBanlistChanges();
     const seed = this.prng.seed;