pokenode-ts 2.1.0 → 2.3.0

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-//#region src/models/Common/resource.d.ts
+//#region src/models/common/resource.d.ts
 /**
  * Marks what a link points at.
  *
@@ -77,7 +77,7 @@ interface APIResourceList<T = unknown> {
   results: APIResource<T>[];
 }
 //#endregion
-//#region src/models/Common/name.d.ts
+//#region src/models/common/name.d.ts
 /**
  * The localized name for an API resource in a specific language.
  */
@@ -88,7 +88,7 @@ interface Name {
   language: NamedAPIResource<Language>;
 }
 //#endregion
-//#region src/models/Common/language.d.ts
+//#region src/models/common/language.d.ts
 /**
  * Languages for translations of API resource information.
  */
@@ -107,7 +107,7 @@ interface Language {
   names: Name[];
 }
 //#endregion
-//#region src/models/Common/description.d.ts
+//#region src/models/common/description.d.ts
 /**
  * The localized description for an API resource in a specific language.
  */
@@ -118,7 +118,7 @@ interface Description {
   language: NamedAPIResource<Language>;
 }
 //#endregion
-//#region src/models/Common/effect.d.ts
+//#region src/models/common/effect.d.ts
 /**
  * The localized effect text for an API resource in a specific language.
  */
@@ -129,10 +129,11 @@ interface Effect {
   language: NamedAPIResource<Language>;
 }
 //#endregion
-//#region src/models/Encounter/encounter.d.ts
+//#region src/models/encounter/encounter.d.ts
 /**
  * ## Encounter Method
  * Methods by which the player can encounter Pokémon in the wild, e.g., walking in tall grass.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Wild_Pok%C3%A9mon) for greater detail.
  */
 interface EncounterMethod {
@@ -148,7 +149,8 @@ interface EncounterMethod {
 /**
  * ## Encounter Condition
  * Conditions which affect what Pokémon might appear in the wild, e.g., day or night.
- *  - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Time).
+ *
+ * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Time).
  */
 interface EncounterCondition {
   /** The identifier for this resource. */
@@ -164,6 +166,7 @@ interface EncounterCondition {
  * ## Encounter Condition Value
  * Encounter condition values are the various states that an encounter
  * condition can have, i.e., time of day can be either **day** or **night**
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Time).
  */
 interface EncounterConditionValue {
@@ -177,7 +180,7 @@ interface EncounterConditionValue {
   names: Name[];
 }
 //#endregion
-//#region src/models/Common/encounter.d.ts
+//#region src/models/common/encounter.d.ts
 /**
  * How the encountered Pokémon itself is generated, where a game constrains it.
  *
@@ -210,10 +213,11 @@ interface Encounter {
   pokemon_details: EncounterPokemonDetail | null;
 }
 //#endregion
-//#region src/models/Contest/contest.d.ts
+//#region src/models/contest/contest.d.ts
 /**
  * ## Contest Type
  * Contest types are categories judges used to weigh a Pokémon's condition in Pokémon contests.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Contest_condition) for greater detail.
  */
 interface ContestType {
@@ -273,6 +277,7 @@ interface ContestEffect {
  * specifically in [Diamond, Pearl](https://bulbapedia.bulbagarden.net/wiki/Pok%C3%A9mon_Diamond_and_Pearl_Versions),
  * and [Platinum](https://bulbapedia.bulbagarden.net/wiki/Pok%C3%A9mon_Platinum_Version).
  * In it, Pokémon are rated on their appearance and performance, rather than strength.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Pok%C3%A9mon_Super_Contest).
  */
 interface SuperContestEffect {
@@ -286,12 +291,13 @@ interface SuperContestEffect {
   moves: NamedAPIResource<Move>[];
 }
 //#endregion
-//#region src/models/Currency/currency.d.ts
+//#region src/models/currency/currency.d.ts
 /**
  * ## Currency
  * Currencies are what items are bought and sold with. Most items are priced in
  * Pokémon Dollars, but a shop can trade in anything from Battle Points to
  * Volcanic Ash.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Currency) for greater detail.
  */
 interface Currency {
@@ -303,7 +309,7 @@ interface Currency {
   names: Name[];
 }
 //#endregion
-//#region src/models/Item/item.d.ts
+//#region src/models/item/item.d.ts
 /**
  * Sprites used to depict the given item in the game.
  */
@@ -404,6 +410,7 @@ interface ItemPrice {
  * ## Item
  * An item is an object in the games which the player can pick up, keep in their bag, and use in some manner.
  * They have various uses, including healing, powering up, helping catch Pokémon, or to access a new area.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Item).
  */
 interface Item {
@@ -439,7 +446,7 @@ interface Item {
   machines: MachineVersionDetail[];
 }
 //#endregion
-//#region src/models/Location/encounter.d.ts
+//#region src/models/location/encounter.d.ts
 /**
  * Method in which Pokémon may be encountered in the given area
  * and how likely the method will occur depending on the version of the game.
@@ -469,11 +476,12 @@ interface PokemonEncounter {
   version_details: VersionEncounterDetail[];
 }
 //#endregion
-//#region src/models/Location/location.d.ts
+//#region src/models/location/location.d.ts
 /**
  * ## Location
  * Locations that can be visited within the games.
  * Locations make up sizable portions of regions, like cities or routes.
+ *
  * - See the [List of Locations](https://bulbapedia.bulbagarden.net/wiki/List_of_locations_by_name).
  */
 interface Location {
@@ -494,6 +502,7 @@ interface Location {
  * ## Location Area
  * Location areas are sections of areas, such as floors in a building or cave.
  * Each area has its own set of possible Pokémon encounters.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Area) for greater detail.
  */
 interface LocationArea {
@@ -513,7 +522,7 @@ interface LocationArea {
   pokemon_encounters: PokemonEncounter[];
 }
 //#endregion
-//#region src/models/Pokemon/type.d.ts
+//#region src/models/pokemon/type.d.ts
 /**
  * Details of Pokémon for a specific type.
  */
@@ -653,7 +662,14 @@ interface Type {
   sprites: TypeSprites;
 }
 //#endregion
-//#region src/models/Evolution/evolution.d.ts
+//#region src/models/evolution/evolution.d.ts
+/**
+ * ## Evolution Time Of Day
+ * The times of day an evolution can be tied to, lower case as the API writes
+ * them. `dusk` is Lycanroc's Dusk Form and `full-moon` is Ursaluna, so this is
+ * wider than the day/night pair the endpoint documentation describes.
+ */
+type EvolutionTimeOfDay = "day" | "night" | "dusk" | "full-moon";
 /**
  * ## Evolution Detail
  * All details regarding the specific details of the referenced Pokémon species evolution.
@@ -692,8 +708,8 @@ interface EvolutionDetail {
   party_type: NamedAPIResource<Type> | null;
   /** The required relation between the Pokémon's Attack and Defense stats. 1 means Attack > Defense. 0 means Attack = Defense. -1 means Attack < Defense. */
   relative_physical_stats: 1 | 0 | -1 | null;
-  /** The required time of day. Day or night. */
-  time_of_day: "Day" | "Night" | "";
+  /** The required time of day, or `""` when any time will do. */
+  time_of_day: EvolutionTimeOfDay | "";
   /** Pokémon species for which this one must be traded. */
   trade_species: NamedAPIResource<PokemonSpecies> | null;
   /** Whether or not the 3DS needs to be turned upside-down as this Pokémon levels up. */
@@ -766,26 +782,34 @@ interface EvolutionChain {
    */
   chain: ChainLink;
 }
+/**
+ * ## Evolution Trigger Name
+ * Every trigger the PokéAPI publishes, in the order `/evolution-trigger` lists
+ * them — which is the order their ids run in, and the order
+ * {@link EVOLUTION_TRIGGERS} mirrors.
+ */
+type EvolutionTriggerName = "level-up" | "trade" | "use-item" | "shed" | "spin" | "tower-of-darkness" | "tower-of-waters" | "three-critical-hits" | "take-damage" | "other" | "agile-style-move" | "strong-style-move" | "recoil-damage" | "use-move" | "three-defeated-bisharp" | "gimmighoul-coins";
 /**
  * ## Evolution Trigger
  * Evolution triggers are the events and conditions that cause a Pokémon to evolve.
  * There are numerous methods of evolution which define how and when Pokémon evolve.
  * Most Pokémon will evolve by leveling up while others evolve through specific means,
  * such as being traded, achieving a certain amount of friendship or leveling at certain times, among others.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Methods_of_evolution) for greater detail.
  */
 interface EvolutionTrigger {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
-  name: "level-up" | "trade" | "use-item" | "shed" | "other";
+  name: EvolutionTriggerName;
   /** The name of this resource listed in different languages. */
   names: Name[];
   /** A list of Pokémon species that result from this evolution trigger. */
   pokemon_species: NamedAPIResource<PokemonSpecies>[];
 }
 //#endregion
-//#region src/models/Game/pokemon-entry.d.ts
+//#region src/models/game/pokemon-entry.d.ts
 /**
  * A Pokémon catalogued in a Pokédex.
  */
@@ -796,12 +820,13 @@ interface PokemonEntry {
   pokemon_species: NamedAPIResource<PokemonSpecies>;
 }
 //#endregion
-//#region src/models/Game/pokedex.d.ts
+//#region src/models/game/pokedex.d.ts
 /**
  * ## Pokédex
  * A Pokédex is a handheld electronic encyclopedia device;
  * one which is capable of recording and retaining information of the various Pokémon in a given region
  * with the exception of the national dex and some smaller dexes related to portions of a region.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Pok%C3%A9dex) for greater detail.
  */
 interface Pokedex {
@@ -823,20 +848,20 @@ interface Pokedex {
   version_groups: NamedAPIResource<VersionGroup>[];
 }
 //#endregion
-//#region src/models/Location/palpark.d.ts
+//#region src/models/location/palpark.d.ts
 /**
  * ## Pal Park Area
  * Areas used for grouping Pokémon encounters in Pal Park.
  * They're like habitats that are specific to Pal Park.
  * Pal Park is divided into five separate areas:
- * ---
+ *
  * - [Field](https://bulbapedia.bulbagarden.net/wiki/List_of_Pok%C3%A9mon_by_Pal_Park_location#Field)
  * - [Forest](https://bulbapedia.bulbagarden.net/wiki/List_of_Pok%C3%A9mon_by_Pal_Park_location#Forest)
  * - [Mountain](https://bulbapedia.bulbagarden.net/wiki/List_of_Pok%C3%A9mon_by_Pal_Park_location#Mountain)
  * - [Pond](https://bulbapedia.bulbagarden.net/wiki/List_of_Pok%C3%A9mon_by_Pal_Park_location#Pound)
  * - [Sea](https://bulbapedia.bulbagarden.net/wiki/List_of_Pok%C3%A9mon_by_Pal_Park_location#Sea)
  * - [Trivia](https://bulbapedia.bulbagarden.net/wiki/List_of_Pok%C3%A9mon_by_Pal_Park_location#Trivia)
- * ---
+ *
  * See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Pal_Park) for greater detail.
  */
 interface PalParkArea {
@@ -861,11 +886,12 @@ interface PalParkEncounterSpecies {
   pokemon_species: NamedAPIResource<PokemonSpecies>;
 }
 //#endregion
-//#region src/models/Pokemon/egg-group.d.ts
+//#region src/models/pokemon/egg-group.d.ts
 /**
  * ## Egg Group
  * Egg Groups are categories which determine which Pokémon are able to interbreed.
  * Pokémon may belong to either one or two Egg Groups.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Egg_Group) for greater detail.
  */
 interface EggGroup {
@@ -879,7 +905,7 @@ interface EggGroup {
   pokemon_species: NamedAPIResource<PokemonSpecies>[];
 }
 //#endregion
-//#region src/models/Pokemon/growth-rates.d.ts
+//#region src/models/pokemon/growth-rate.d.ts
 /**
  * Levels and the amount of experience needed to attain them based on the given growth rate.
  */
@@ -892,6 +918,7 @@ interface GrowthRateExperienceLevel {
 /**
  * ## Growth Rate
  * Growth rates are the speed with which Pokémon gain levels through experience.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Experience) for greater detail.
  */
 interface GrowthRate {
@@ -909,11 +936,12 @@ interface GrowthRate {
   pokemon_species: NamedAPIResource<PokemonSpecies>[];
 }
 //#endregion
-//#region src/models/Pokemon/characteristics.d.ts
+//#region src/models/pokemon/characteristic.d.ts
 /**
  * ## Characteristic
  * Characteristics indicate which stat contains a Pokémon's highest IV.
  * A Pokémon's Characteristic is determined by the remainder of its highest IV divided by 5 (gene_modulo).
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Characteristic) for greater detail.
  */
 interface Characteristic {
@@ -929,11 +957,12 @@ interface Characteristic {
   descriptions: Description[];
 }
 //#endregion
-//#region src/models/Pokemon/pokeathlon-stat.d.ts
+//#region src/models/pokemon/pokeathlon-stat.d.ts
 /**
  * ## Pokéathlon Stat
  * Pokéathlon Stats are different attributes of a Pokémon's performance in Pokéathlons.
  * In Pokéathlons, competitions happen on different courses; one for each of the different Pokéathlon stats.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Pok%C3%A9athlon) for greater detail.
  */
 interface PokeathlonStat {
@@ -965,10 +994,11 @@ interface NaturePokeathlonStatAffectSets {
   decrease: NaturePokeathlonStatAffect[];
 }
 //#endregion
-//#region src/models/Pokemon/nature.d.ts
+//#region src/models/pokemon/nature.d.ts
 /**
  * ## Nature
  * Natures influence how a Pokémon's stats grow.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Nature) for greater detail.
  */
 interface Nature {
@@ -1013,7 +1043,7 @@ interface MoveBattleStylePreference {
   move_battle_style: NamedAPIResource<MoveBattleStyle>;
 }
 //#endregion
-//#region src/models/Pokemon/stats.d.ts
+//#region src/models/pokemon/stat.d.ts
 /**
  * ## Stat
  * Stats determine certain aspects of battles. Each Pokémon has a value for each stat
@@ -1069,13 +1099,14 @@ interface MoveStatAffectSets {
   decrease: MoveStatAffect[];
 }
 //#endregion
-//#region src/models/Pokemon/pokemon.d.ts
+//#region src/models/pokemon/pokemon.d.ts
 /**
  * ## Pokémon
  * Pokémon are the creatures that inhabit the world of the Pokémon games.
  * They can be caught using Pokéballs and trained by battling with other Pokémon.
  * Each Pokémon belongs to a specific species but may take on a variant
  * which makes it differ from other Pokémon of the same species, such as base stats, available abilities and typings.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Pok%C3%A9mon_(species)) for greater detail.
  */
 interface Pokemon {
@@ -1923,11 +1954,12 @@ interface PokemonSpeciesVariety {
   pokemon: NamedAPIResource<Pokemon>;
 }
 //#endregion
-//#region src/models/Pokemon/ability.d.ts
+//#region src/models/pokemon/ability.d.ts
 /**
  * ## Ability
  * Abilities provide passive effects for Pokémon in battle or in the overworld.
  * Pokémon have multiple possible abilities but can have only one ability at a time.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Ability) for greater detail.
  */
 interface Ability {
@@ -1985,11 +2017,12 @@ interface AbilityPokemon {
   pokemon: NamedAPIResource<Pokemon>;
 }
 //#endregion
-//#region src/models/Pokemon/gender.d.ts
+//#region src/models/pokemon/gender.d.ts
 /**
  * ## Gender
  * Genders were introduced in Generation II for the purposes of breeding Pokémon
  * but can also result in visual differences or even different evolutionary lines.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Gender) for greater detail.
  */
 interface Gender {
@@ -2012,7 +2045,7 @@ interface PokemonSpeciesGender {
   pokemon_species: NamedAPIResource<PokemonSpecies>;
 }
 //#endregion
-//#region src/models/Moves/moves.d.ts
+//#region src/models/move/move.d.ts
 /**
  * ## Move Target
  * Targets moves can be directed at during battle. Targets can be Pokémon, environments or even other moves.
@@ -2078,6 +2111,7 @@ interface MoveCategory {
 /**
  * ## Move Battle Style
  * Styles of moves when used in the Battle Palace.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Battle_Frontier_(Generation_III)) for greater detail.
  */
 interface MoveBattleStyle {
@@ -2091,6 +2125,7 @@ interface MoveBattleStyle {
 /**
  * ## Move Ailment
  * Move Ailments are status conditions caused by moves used during battle.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Status_condition) for greater detail.
  */
 interface MoveAilment {
@@ -2188,6 +2223,7 @@ interface ContestComboSets {
  * Moves are the skills of Pokémon in battle. In battle, a Pokémon uses one move each turn.
  * Some moves (including those learned by Hidden Machine) can be used outside of battle as well,
  * usually for the purpose of removing obstacles or exploring new areas.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Move) for greater detail.
  */
 interface Move {
@@ -2244,11 +2280,12 @@ interface Move {
   learned_by_pokemon: NamedAPIResource<Pokemon>[];
 }
 //#endregion
-//#region src/models/Game/generation.d.ts
+//#region src/models/game/generation.d.ts
 /**
  * ## Generation
  * A generation is a grouping of the Pokémon games that separates them based on the Pokémon they include.
  * In each generation, a new set of Pokémon, Moves, Abilities and Types that did not exist in the previous generation are released.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Generation) for greater detail.
  */
 interface Generation {
@@ -2272,12 +2309,13 @@ interface Generation {
   version_groups: NamedAPIResource<VersionGroup>[];
 }
 //#endregion
-//#region src/models/Location/region.d.ts
+//#region src/models/location/region.d.ts
 /**
  * ## Region
  * A region is an organized area of the Pokémon world.
  * Most often, the main difference between regions is
  * the species of Pokémon that can be encountered within them.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Region) for greater detail.
  */
 type Region = {
@@ -2297,10 +2335,11 @@ type Region = {
   version_groups: NamedAPIResource<VersionGroup>[];
 };
 //#endregion
-//#region src/models/Game/version.d.ts
+//#region src/models/game/version.d.ts
 /**
  * ## Version
  * Versions of the games, e.g. Red, Blue or Yellow.
+ *
  * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Core_series) for greater detail.
  */
 interface Version {
@@ -2336,7 +2375,7 @@ interface VersionGroup {
   versions: NamedAPIResource<Version>[];
 }
 //#endregion
-//#region src/models/Common/flavor-text.d.ts
+//#region src/models/common/flavor-text.d.ts
 /**
  * The localized flavor text for an API resource in a specific language.
  */
@@ -2349,7 +2388,7 @@ interface FlavorText {
   version: NamedAPIResource<Version>;
 }
 //#endregion
-//#region src/models/Common/generation.d.ts
+//#region src/models/common/generation.d.ts
 /**
  * The generation relevant to this game index.
  */
@@ -2360,7 +2399,7 @@ interface GenerationGameIndex {
   generation: NamedAPIResource<Generation>;
 }
 //#endregion
-//#region src/models/Machine/machine.d.ts
+//#region src/models/machine/machine.d.ts
 /**
  * ## Machine
  * Machines are the representation of items that teach moves to Pokémon.
@@ -2379,7 +2418,7 @@ type Machine = {
   version_group: NamedAPIResource<VersionGroup>;
 };
 //#endregion
-//#region src/models/Common/machine.d.ts
+//#region src/models/common/machine.d.ts
 /**
  * The machine that teaches a move from an item.
  */
@@ -2390,7 +2429,7 @@ interface MachineVersionDetail {
   version_group: NamedAPIResource<VersionGroup>;
 }
 //#endregion
-//#region src/models/Common/verbose.d.ts
+//#region src/models/common/verbose.d.ts
 /**
  * The localized effect for an API resource.
  */
@@ -2403,7 +2442,7 @@ interface VerboseEffect {
   language: NamedAPIResource<Language>;
 }
 //#endregion
-//#region src/models/Common/version.d.ts
+//#region src/models/common/version.d.ts
 /**
  * Encounters and their specific details.
  */
@@ -2436,7 +2475,7 @@ interface VersionGroupFlavorText {
   version_group: NamedAPIResource<VersionGroup>;
 }
 //#endregion
-//#region src/models/Berry/berry.d.ts
+//#region src/models/berry/berry.d.ts
 /**
  * ## Berry
  * Berries are small fruits that can provide HP and status condition restoration,
@@ -2545,7 +2584,10 @@ interface CacheStore {
 interface MemoryCacheOptions {
   /** How long a cached response stays fresh, in milliseconds. Defaults to 5 minutes. */
   ttl?: number;
-  /** Maximum number of responses kept. The least recently used entry is evicted. Defaults to 500. */
+  /**
+   * Maximum number of responses kept. The least recently used entry is evicted.
+   * Defaults to 500; zero keeps none.
+   */
   maxEntries?: number;
 }
 /**
@@ -2565,6 +2607,50 @@ declare class MemoryCache implements CacheStore {
   delete(key: string): void;
   clear(): void;
 }
+/**
+ * ## Etag Entry
+ * What a URL last answered with, and the validator that says so.
+ */
+interface EtagEntry {
+  /** The `ETag` the response carried. */
+  etag: string;
+  /** The parsed body that `etag` identifies. */
+  value: unknown;
+}
+/**
+ * ## Etag Store Options
+ * Used to configure an {@link EtagStore}.
+ */
+interface EtagStoreOptions {
+  /**
+   * How many URLs to remember. The least recently used is evicted. Defaults to
+   * 500; zero remembers none.
+   */
+  maxEntries?: number;
+}
+/**
+ * ## Etag Store
+ * Remembers the `ETag` each URL answered with, and the body it identified, so an
+ * expired cache entry can be revalidated instead of downloaded again.
+ *
+ * Deliberately not a {@link CacheStore}: the two answer different questions. A
+ * `CacheStore` says "this response is still fresh, use it"; this says "here is
+ * what the response was last time, ask the server whether it still holds". They
+ * are kept apart so that a store someone else owns — a shared Redis — is never
+ * given a second key shape, and `cache.get(url)` keeps returning the resource
+ * itself.
+ *
+ * Entries live in memory and are never persisted: an `ETag` is only worth what
+ * the body beside it is, and the body is what would cost memory to keep.
+ */
+declare class EtagStore {
+  private readonly entries;
+  private readonly maxEntries;
+  constructor(options?: EtagStoreOptions);
+  get(url: string): EtagEntry | undefined;
+  set(url: string, entry: EtagEntry): void;
+  clear(): void;
+}
 /**
  * ## Web Storage Like
  * The part of the browser's `Storage` interface a {@link WebStorageCache} uses.
@@ -2664,7 +2750,7 @@ declare class WebStorageCache implements CacheStore {
  */
 interface LogFields {
   /** Which point of the request lifecycle this is, for filtering. */
-  event: "request" | "response" | "error";
+  event: "request" | "response" | "retry" | "cancelled" | "error";
   msg: string;
   message: string;
   /** The request URL, with any credentials the base URL carried removed. */
@@ -2693,15 +2779,50 @@ interface LogResponsePayload extends LogFields {
    * - `cache` — served by the {@link CacheStore}; nothing left the process.
    * - `in-flight` — an identical request was already on the wire and this caller
    *   shared it, so it made no round trip of its own.
+   * - `revalidated` — a round trip was made, the API answered 304, and the body
+   *   already held for that URL was reused. Cheap, but not free.
    *
-   * Counting only `network` gives the number of requests the PokéAPI actually
-   * saw. Every caller reports, so counting all three gives the number of calls
-   * the application made.
+   * Counting `network` and `revalidated` gives the number of requests the
+   * PokéAPI actually saw. Every caller reports, so counting all four gives the
+   * number of calls the application made.
    */
-  source: "network" | "cache" | "in-flight";
+  source: "network" | "cache" | "in-flight" | "revalidated";
   /** How long the client took to resolve the request, in milliseconds. */
   durationMs: number;
 }
+/**
+ * ## Log Retry Payload
+ * An attempt failed and another one is coming.
+ *
+ * Only emitted when `retry` is configured, and never for the attempt that gives
+ * up — that one is a `response` or an `error` like any other. Counting these
+ * gives the round trips the PokéAPI saw beyond the ones it answered.
+ */
+interface LogRetryPayload extends LogFields {
+  event: "retry";
+  /** Which attempt just failed, counting from one. */
+  attempt: number;
+  /** How long the client will wait before the next one, in milliseconds. */
+  delayMs: number;
+  /** The status that failed. Absent when the attempt never got a response. */
+  status?: number;
+}
+/**
+ * ## Log Cancelled Payload
+ * A request was cancelled by the scope it was made through.
+ *
+ * A caller that hangs up asked for this, so it is not a failure and does not
+ * reach `error`: a handler that scopes every request would otherwise report its
+ * own timeouts as its error rate. Counting `response` and `cancelled` together
+ * accounts for every `request` logged.
+ */
+interface LogCancelledPayload extends LogFields {
+  event: "cancelled";
+  /** `signal.reason`, or the `TimeoutError` a scoped timeout raised. */
+  reason: unknown;
+  /** How long the request had been running when it was cancelled, in milliseconds. */
+  durationMs: number;
+}
 /**
  * ## Log Error Payload
  * A request failed.
@@ -2729,11 +2850,12 @@ interface LogErrorPayload extends LogFields {
  * new PokemonClient({ logger: winston.createLogger() });
  * ```
  *
- * Requests and responses go to `debug`; failures go to `error`. Nothing is
- * logged unless a logger is passed, and a client never picks a level of its own.
+ * Requests, responses and cancellations go to `debug`; failures go to `error`.
+ * Nothing is logged unless a logger is passed, and a client never picks a level
+ * of its own.
  */
 interface Logger {
-  debug(payload: LogRequestPayload | LogResponsePayload): void;
+  debug(payload: LogRequestPayload | LogResponsePayload | LogRetryPayload | LogCancelledPayload): void;
   error(payload: LogErrorPayload): void;
 }
 /**
@@ -2745,13 +2867,6 @@ interface Logger {
  */
 declare const consoleLogger: Logger;
 //#endregion
-//#region src/constants/base.d.ts
-declare const BASE_URL: {
-  readonly REST: "https://pokeapi.co/api/v2";
-  /** Root of the sprite repository the API's own sprite URLs point at. */
-  readonly SPRITES: "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites";
-};
-//#endregion
 //#region src/constants/berries.d.ts
 /** Enum of Berries (NAME - ID) */
 declare const BERRIES: {
@@ -2819,6 +2934,10 @@ declare const BERRIES: {
   readonly CUSTAP: 62;
   readonly JABOCA: 63;
   readonly ROWAP: 64;
+  readonly KEE: 65;
+  readonly MARANGA: 66;
+  readonly HOPO: 67;
+  readonly ROSELI: 68;
 };
 /** Enum of Berry Firmnesses (NAME - ID) */
 declare const BERRY_FIRMNESSES: {
@@ -2889,14 +3008,63 @@ declare const ENCOUNTER_METHODS: {
   readonly ROUGH_TERRAIN: 17;
   readonly GIFT: 18;
   readonly GIFT_EGG: 19;
-  readonly ONLY_ONE: 20;
+  readonly STATIC: 20;
   readonly POKEFLUTE: 21;
   readonly HEADBUTT_LOW: 22;
   readonly HEADBUTT_NORMAL: 23;
-  readonly HEADBUT_HIGH: 24;
+  readonly HEADBUTT_HIGH: 24;
   readonly SQUIRT_BOTTLE: 25;
   readonly WAILMER_PAIL: 26;
   readonly SEAWEED: 27;
+  readonly ROAMING_GRASS: 28;
+  readonly ROAMING_WATER: 29;
+  readonly DEVON_SCOPE: 30;
+  readonly FEEBAS_TILE_FISHING: 31;
+  readonly ISLAND_SCAN: 32;
+  readonly SOS: 33;
+  readonly BUBBLING_SPOTS: 34;
+  readonly BERRY_TREES: 35;
+  readonly NPC_TRADE: 36;
+  readonly SOS_FROM_BUBBLING_SPOT: 37;
+  readonly OVERWORLD: 38;
+  readonly OVERWORLD_WATER: 39;
+  readonly OVERWORLD_FLYING: 40;
+  readonly OVERWORLD_SPECIAL: 41;
+  readonly OVERWORLD_FLYING_SPECIAL: 42;
+  readonly OVERWORLD_WATER_SPECIAL: 43;
+  readonly HORDE: 44;
+  readonly COLOSSEUM_BONUS_DISC_US: 45;
+  readonly COLOSSEUM_BONUS_DISC_JPN: 46;
+  readonly POKEMON_CHANNEL_PAL: 47;
+  readonly POKEMON_RANGER: 48;
+  readonly POKEMON_BATTLE_REVOLUTION: 49;
+  readonly NEW_YORK_POKECENTER_WISH_EGGS: 50;
+  readonly SNAG: 51;
+  readonly SNAG_REMATCH: 52;
+  readonly POKESPOT: 53;
+  readonly HIDDEN_GROTTO: 54;
+  readonly HONEY_TREE: 55;
+  readonly OVERWORLD_DIRT: 56;
+  readonly WANDERER: 57;
+  readonly WANDERER_WATER: 58;
+  readonly CHASE_WATER: 59;
+  readonly DYNAMAX_ADVENTURE: 60;
+  readonly MAX_RAID: 61;
+  readonly TRASH_CAN_AMBUSH: 62;
+  readonly RUSTLING_BUSH_AMBUSH: 63;
+  readonly CEILING_AMBUSH: 64;
+  readonly GROUND_AMBUSH: 65;
+  readonly SKY_AMBUSH: 66;
+  /**
+   * @deprecated Misspelled: the endpoint names this `headbutt-high`.
+   *   Use {@link ENCOUNTER_METHODS.HEADBUTT_HIGH}. Removed in 3.0.
+   */
+  readonly HEADBUT_HIGH: 24;
+  /**
+   * @deprecated The endpoint names this `static` now.
+   *   Use {@link ENCOUNTER_METHODS.STATIC}. Removed in 3.0.
+   */
+  readonly ONLY_ONE: 20;
 };
 declare const ENCOUNTER_CONDITIONS: {
   readonly SWARM: 1;
@@ -2909,6 +3077,26 @@ declare const ENCOUNTER_CONDITIONS: {
   readonly TV_OPTION: 8;
   readonly STORY_PROGRESS: 9;
   readonly OTHER: 10;
+  readonly ITEM: 11;
+  readonly WEEKDAY: 12;
+  readonly FIRST_PARTY_POKEMON: 13;
+  readonly SPECIAL_ENCOUNTER: 14;
+  readonly TRADE: 15;
+  readonly COINS: 16;
+  readonly FRIEND_SAFARI_SLOT: 17;
+  readonly GREAT_MARSH_DAILY_SLOT: 18;
+  readonly HONEY_TREE_GROUP: 19;
+  readonly HEADBUTT_TREE: 20;
+  readonly BACKLOT: 21;
+  readonly BUG_CATCHING_CONTEST: 22;
+  readonly SAVE_DATA: 23;
+  readonly ALOLAN_DIGLETT_FOUND: 24;
+  readonly WEATHER: 25;
+  readonly JOHTO_SAFARI_BLOCKS: 26;
+  readonly MAX_DEN_RARITY: 27;
+  readonly MAX_DEN_RATING: 28;
+  readonly BERRY_TREE_TYPE: 29;
+  readonly TRASH_CAN_TYPE: 30;
 };
 declare const ENCOUNTER_CONDITION_VALUES: {
   readonly SWARM_YES: 1;
@@ -2920,16 +3108,16 @@ declare const ENCOUNTER_CONDITION_VALUES: {
   readonly RADAR_OFF: 7;
   readonly SLOT2_NONE: 8;
   readonly SLOT2_RUBY: 9;
-  readonly SLOT2_SAPHIRE: 10;
+  readonly SLOT2_SAPPHIRE: 10;
   readonly SLOT2_EMERALD: 11;
   readonly SLOT2_FIRERED: 12;
   readonly SLOT2_LEAFGREEN: 13;
   readonly RADIO_OFF: 14;
-  readonly RADIO_HOEN: 15;
+  readonly RADIO_HOENN: 15;
   readonly RADIO_SINNOH: 16;
   readonly SEASON_SPRING: 17;
   readonly SEASON_SUMMER: 18;
-  readonly SWASON_AUTUMN: 19;
+  readonly SEASON_AUTUMN: 19;
   readonly SEASON_WINTER: 20;
   readonly STARTER_BULBASAUR: 21;
   readonly STARTER_SQUIRTLE: 22;
@@ -2942,14 +3130,361 @@ declare const ENCOUNTER_CONDITION_VALUES: {
   readonly STORY_PROGRESS_AWAKENED_BEASTS: 29;
   readonly STORY_PROGRESS_BEAT_GALACTIC_CORONET: 30;
   readonly STORY_PROGRESS_OAK_ETERNA_CITY: 31;
-  readonly STORY_PROGRESS_OAK_VERMILION_COPYCAT: 32;
+  readonly STORY_PROGRESS_VERMILION_COPYCAT: 32;
   readonly STORY_PROGRESS_MET_TORNADUS_THUNDURUS: 33;
   readonly STORY_PROGRESS_BEAT_ELITE_FOUR_ROUND_TWO: 34;
   readonly STORY_PROGRESS_HALL_OF_FAME: 35;
   readonly STORY_PROGRESS_NONE: 36;
   readonly STORY_PROGRESS_NATIONAL_DEX: 37;
   readonly OTHER_NONE: 38;
+  readonly OTHER_SNORLAX_11_BEAT_LEAGUE: 39;
+  readonly OTHER_VIRTUAL_CONSOLE: 40;
+  readonly STORY_PROGRESS_CURE_ELDRITCH_NIGHTMARES: 41;
+  readonly OTHER_TALK_TO_CYNTHIAS_GRANDMOTHER: 42;
+  readonly ITEM_NONE: 43;
+  readonly ITEM_ADAMANT_ORB: 44;
+  readonly ITEM_LUSTROUS_ORB: 45;
+  readonly ITEM_HELIX_FOSSIL: 46;
+  readonly ITEM_DOME_FOSSIL: 47;
+  readonly ITEM_OLD_AMBER: 48;
+  readonly ITEM_ROOT_FOSSIL: 49;
+  readonly ITEM_CLAW_FOSSIL: 50;
+  readonly STORY_PROGRESS_DEFEAT_JUPITER: 51;
+  readonly STORY_PROGRESS_BEAT_TEAM_GALACTIC_IRON_ISLAND: 52;
+  readonly OTHER_CORRECT_PASSWORD: 53;
+  readonly STORY_PROGRESS_ZEPHYR_BADGE: 54;
+  readonly STORY_PROGRESS_BEAT_RED: 55;
+  readonly OTHER_RECEIVED_KANTO_STARTER: 56;
+  readonly STORY_PROGRESS_RECEIVE_TM_FROM_CLAIRE: 57;
+  readonly OTHER_REGIROCK_REGICE_REGISTEEL_IN_PARTY: 58;
+  readonly WEEKDAY_SUNDAY: 59;
+  readonly WEEKDAY_MONDAY: 60;
+  readonly WEEKDAY_TUESDAY: 61;
+  readonly WEEKDAY_WEDNESDAY: 62;
+  readonly WEEKDAY_THURSDAY: 63;
+  readonly WEEKDAY_FRIDAY: 64;
+  readonly WEEKDAY_SATURDAY: 65;
+  readonly FIRST_PARTY_POKEMON_HIGH_FRIENDSHIP: 66;
+  readonly STORY_PROGRESS_DEFEAT_MARS: 67;
+  readonly ITEM_ODD_KEYSTONE: 68;
+  readonly OTHER_TALKED_TO_32_PEOPLE_UNDERGROUND: 69;
+  readonly STORY_PROGRESS_RETURNED_MACHINE_PART: 70;
+  readonly OTHER_EVENT_ARCEUS_IN_PARTY: 71;
+  readonly SPECIAL_ENCOUNTER_COULDNT_CAPTURE_BEFORE: 72;
+  readonly ITEM_ICE_KEY: 73;
+  readonly ITEM_IRON_KEY: 74;
+  readonly STORY_PROGRESS_JUNIPER_CAVE_OF_BEING: 75;
+  readonly ITEM_LUNAR_WING: 76;
+  readonly STORY_PROGRESS_QUAKE_BADGE: 77;
+  readonly ITEM_LIGHT_STONE: 78;
+  readonly ITEM_DARK_STONE: 79;
+  readonly OTHER_CAPTURED_RESHIRAM_OR_ZEKROM: 80;
+  readonly DEFEATED_GHETSIS: 81;
+  readonly OTHER_FOUND_11_TIMES_ROAMING: 82;
+  readonly TIME_MINUTE_00_TO_19: 83;
+  readonly TIME_MINUTE_20_TO_39: 84;
+  readonly TIME_MINUTE_40_TO_59: 85;
+  readonly TIME_04_00_TO_19_59: 86;
+  readonly TIME_20_00_TO_21_59: 87;
+  readonly TIME_21_00_TO_03_59: 88;
+  readonly ITEM_TIDAL_BELL: 89;
+  readonly ITEM_CLEAR_BELL: 90;
+  readonly STORY_PROGRESS_DEFEATED_GROUDON_OR_KYOGRE: 91;
+  readonly OTHER_UXIE_MESPRIT_AZELF_IN_PARTY: 92;
+  readonly OTHER_NICKNAMED_COLD_ITEM_REGICE_REGIROCK_REGISTEEL3: 93;
+  readonly OTHER_DIALGA_OR_PALKIA_IN_PARTY: 94;
+  readonly OTHER_CASTFORM_IN_PARTY: 95;
+  readonly OTHER_LEVEL_100_POKEMON_IN_PARTY: 96;
+  readonly OTHER_TORNADUS_THUNDURUS_IN_PARTY: 97;
+  readonly OTHER_RESHIRAM_ZEKROM_IN_PARTY: 98;
+  readonly OTHER_CAPTURED_ALL_ULTRA_BEASTS: 99;
+  readonly STORY_PROGRESS_FINISHED_LOOKER_SIDEQUEST: 100;
+  readonly STORY_PROGRESS_BEAT_OLIVIAS_TRIAL: 101;
+  readonly OTHER_RAIKOU_ENTEI_IN_PARTY: 102;
+  readonly OTHER_GROUDON_KYOGRE_IN_PARTY: 103;
+  readonly OTHER_DIALGA_PALKIA_IN_PARTY: 104;
+  readonly OTHER_SCAN_QR_CODE: 105;
+  readonly OTHER_CAUGHT_ARTICUNO: 106;
+  readonly OTHER_CAUGHT_ZAPDOS: 107;
+  readonly OTHER_CAUGHT_MOLTRES: 108;
+  readonly TRADE_TOGEPI_OR_TOGETIC: 109;
+  readonly TRADE_TRAPINCH: 110;
+  readonly TRADE_SURSKIT: 111;
+  readonly TRADE_WOOPER: 112;
+  readonly STORY_PROGRESS_CATCH_ALL_SHADOW_POKEMON: 113;
+  readonly OTHER_COMPLETE_MT_BATTLE: 114;
+  readonly COINS_180: 115;
+  readonly COINS_500: 116;
+  readonly COINS_1200: 117;
+  readonly COINS_2800: 118;
+  readonly COINS_5500: 119;
+  readonly COINS_9999: 120;
+  readonly COINS_120: 121;
+  readonly COINS_750: 122;
+  readonly COINS_2500: 123;
+  readonly COINS_4600: 124;
+  readonly COINS_6500: 125;
+  readonly COINS_230: 126;
+  readonly COINS_1000: 127;
+  readonly COINS_2680: 128;
+  readonly COINS_3333: 129;
+  readonly COINS_6666: 130;
+  readonly COINS_200: 131;
+  readonly COINS_700: 132;
+  readonly COINS_2100: 133;
+  readonly COINS_100: 134;
+  readonly COINS_800: 135;
+  readonly COINS_1500: 136;
+  readonly COINS_2222: 137;
+  readonly COINS_5555: 138;
+  readonly COINS_8888: 139;
+  readonly COINS_150: 140;
+  readonly COINS_620: 141;
+  readonly COINS_2880: 142;
+  readonly COINS_5400: 143;
+  readonly COINS_8300: 144;
+  readonly TRADE_ABRA: 145;
+  readonly TRADE_NIDORAN_M: 146;
+  readonly TRADE_NIDORINO: 147;
+  readonly TRADE_SLOWBRO: 148;
+  readonly TRADE_POLIWHIRL: 149;
+  readonly TRADE_SPEAROW: 150;
+  readonly TRADE_RAICHU: 151;
+  readonly TRADE_VENONAT: 152;
+  readonly TRADE_PONYTA: 153;
+  readonly TRADE_CLEFAIRY: 154;
+  readonly TRADE_CUBONE: 155;
+  readonly TRADE_LICKITUNG: 156;
+  readonly TRADE_TANGELA: 157;
+  readonly TRADE_GOLDUCK: 158;
+  readonly TRADE_GROWLITHE: 159;
+  readonly TRADE_KANGASKHAN: 160;
+  readonly TRADE_BELLSPROUT: 161;
+  readonly TRADE_DROWZEE: 162;
+  readonly TRADE_KRABBY: 163;
+  readonly TRADE_DRAGONAIR: 164;
+  readonly TRADE_CHANSEY: 165;
+  readonly TRADE_GLOOM: 166;
+  readonly TRADE_HAUNTER: 167;
+  readonly TRADE_DUGTRIO: 168;
+  readonly TRADE_SLAKOTH: 169;
+  readonly TRADE_PIKACHU: 170;
+  readonly TRADE_BELLOSSOM: 171;
+  readonly TRADE_RALTS: 172;
+  readonly TRADE_VOLBEAT: 173;
+  readonly TRADE_BAGON: 174;
+  readonly TRADE_SKITTY: 175;
+  readonly FRIEND_SAFARI_SLOT_1: 176;
+  readonly FRIEND_SAFARI_SLOT_2: 177;
+  readonly FRIEND_SAFARI_SLOT_3: 178;
+  readonly ITEM_SKULL_FOSSIL: 179;
+  readonly ITEM_ARMOR_FOSSIL: 180;
+  readonly GREAT_MARSH_DAILY_SLOT_NONE: 181;
+  readonly GREAT_MARSH_DAILY_SLOT_1_OF_32: 182;
+  readonly GREAT_MARSH_DAILY_SLOT_2_OF_32: 183;
+  readonly GREAT_MARSH_DAILY_SLOT_3_OF_32: 184;
+  readonly GREAT_MARSH_DAILY_SLOT_5_OF_32: 185;
+  readonly STORY_PROGRESS_BEFORE_NATIONAL_DEX: 186;
+  readonly GREAT_MARSH_DAILY_SLOT_4_OF_32: 187;
+  readonly GREAT_MARSH_DAILY_SLOT_15_OF_32: 188;
+  readonly HONEY_TREE_GROUP_A: 189;
+  readonly HONEY_TREE_GROUP_B: 190;
+  readonly HONEY_TREE_GROUP_C: 191;
+  readonly HEADBUTT_TREE_COMMON: 192;
+  readonly HEADBUTT_TREE_RARE: 193;
+  readonly HEADBUTT_TREE_SECRET: 194;
+  readonly TRADE_COTTONEE: 195;
+  readonly TRADE_PETILIL: 196;
+  readonly TRADE_EMOLGA: 197;
+  readonly TRADE_MANTINE: 198;
+  readonly TRADE_DITTO: 199;
+  readonly TRADE_EXCADRILL: 200;
+  readonly TRADE_HIPPOWDON: 201;
+  readonly BACKLOT_NOT_MENTIONED: 202;
+  readonly BACKLOT_MENTIONED: 203;
+  readonly BUG_CATCHING_CONTEST_NO: 204;
+  readonly BUG_CATCHING_CONTEST_YES: 205;
+  readonly SAVE_DATA_FROM_LETS_GO_PIKACHU: 206;
+  readonly SAVE_DATA_FROM_LETS_GO_EEVEE: 207;
+  readonly ITEM_FOSSILIZED_BIRD: 208;
+  readonly ITEM_FOSSILIZED_DRAKE: 209;
+  readonly ITEM_FOSSILIZED_DINO: 210;
+  readonly ITEM_FOSSILIZED_FISH: 211;
+  readonly STORY_PROGRESS_MASTER_DOJO_COMPLETE_FIRST_TRIAL: 212;
+  readonly STORY_PROGRESS_MASTER_DOJO_COMPLETE_THIRD_TRIAL: 213;
+  readonly ALOLAN_DIGLETT_FOUND_5: 214;
+  readonly ALOLAN_DIGLETT_FOUND_10: 215;
+  readonly ALOLAN_DIGLETT_FOUND_20: 216;
+  readonly ALOLAN_DIGLETT_FOUND_30: 217;
+  readonly ALOLAN_DIGLETT_FOUND_40: 218;
+  readonly ALOLAN_DIGLETT_FOUND_50: 219;
+  readonly ALOLAN_DIGLETT_FOUND_75: 220;
+  readonly ALOLAN_DIGLETT_FOUND_100: 221;
+  readonly ALOLAN_DIGLETT_FOUND_150: 222;
+  readonly STARTER_GROOKEY: 223;
+  readonly STARTER_SCORBUNNY: 224;
+  readonly STARTER_SOBBLE: 225;
+  readonly STORY_PROGRESS_SAVE_VILLAGE_FROM_GLASTRIER_SPECTRIER: 226;
+  readonly STORY_PROGRESS_CATCH_FIVE_ULTRA_BEASTS: 227;
+  readonly TRADE_BUNNELBY: 228;
+  readonly TRADE_MEOWTH_GALAR: 229;
+  readonly TRADE_MINCCINO: 230;
+  readonly TRADE_TOXEL: 231;
+  readonly TRADE_MARACTUS: 232;
+  readonly TRADE_YAMASK_GALAR: 233;
+  readonly TRADE_VANILLISH: 234;
+  readonly TRADE_OBSTAGOON: 235;
+  readonly TRADE_FROSMOTH: 236;
+  readonly TRADE_FARFETCHD_GALAR: 237;
+  readonly TRADE_CORSOLA_GALAR: 238;
+  readonly TRADE_PONYTA_GALAR: 239;
+  readonly TRADE_MR_MIME_GALAR: 240;
+  readonly TRADE_DARUMAKA_GALAR: 241;
+  readonly TRADE_ZIGZAGOON_GALAR: 242;
+  readonly TRADE_STUNFISK_GALAR: 243;
+  readonly TRADE_WEEZING_GALAR: 244;
+  readonly TRADE_EXEGGUTOR: 245;
+  readonly TRADE_MAROWAK: 246;
+  readonly WEATHER_NORMAL: 247;
+  readonly WEATHER_OVERCAST: 248;
+  readonly WEATHER_RAINING: 249;
+  readonly WEATHER_THUNDERSTORM: 250;
+  readonly WEATHER_SNOWING: 251;
+  readonly WEATHER_SNOWSTORM: 252;
+  readonly WEATHER_SANDSTORM: 253;
+  readonly WEATHER_INTENSE_SUN: 254;
+  readonly WEATHER_FOG: 255;
+  readonly STORY_PROGRESS_BEFORE_HALL_OF_FAME: 256;
+  readonly JOHTO_SAFARI_BLOCKS_INACTIVE: 257;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_2: 258;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_3: 259;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_4: 260;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_5: 261;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_6: 262;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_10: 263;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_12: 264;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_14: 265;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_15: 266;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_24: 267;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_28: 268;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_35: 269;
+  readonly JOHTO_SAFARI_BLOCKS_PLAINS_MIN_49: 270;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_3: 271;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_4: 272;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_5: 273;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_8: 274;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_10: 275;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_14: 276;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_15: 277;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_18: 278;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_20: 279;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_28: 280;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_35: 281;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_42: 282;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_49: 283;
+  readonly JOHTO_SAFARI_BLOCKS_FOREST_MIN_56: 284;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_3: 285;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_4: 286;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_5: 287;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_6: 288;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_8: 289;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_10: 290;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_15: 291;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_21: 292;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_24: 293;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_28: 294;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_35: 295;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_42: 296;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_49: 297;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_56: 298;
+  readonly JOHTO_SAFARI_BLOCKS_PEAK_MIN_63: 299;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_2: 300;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_3: 301;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_4: 302;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_5: 303;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_6: 304;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_7: 305;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_8: 306;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_9: 307;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_10: 308;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_12: 309;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_13: 310;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_14: 311;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_15: 312;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_16: 313;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_18: 314;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_20: 315;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_24: 316;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_28: 317;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_35: 318;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_42: 319;
+  readonly JOHTO_SAFARI_BLOCKS_WATER_MIN_49: 320;
+  readonly ITEM_COVER_FOSSIL: 321;
+  readonly ITEM_PLUME_FOSSIL: 322;
+  readonly OTHER_GIRATINA_NOT_CAUGHT_IN_DISTORTION_WORLD: 323;
+  readonly OTHER_FIND_50_CAVERN_FOOTPRINTS: 324;
+  readonly OTHER_FIND_50_GRASSLAND_FOOTPRINTS: 325;
+  readonly OTHER_FIND_50_IRON_WILL_FOOTPRINTS: 326;
+  readonly OTHER_REGIROCK_REGICE_REGISTEEL_REGIELEKI_REGIDRAGO_IN_PARTY: 327;
+  readonly OTHER_CHOOSE_REGIELEKI_PATTERN: 328;
+  readonly OTHER_CHOOSE_REGIDRAGO_PATTERN: 329;
+  readonly OTHER_GROW_ICEROOT_CARROT: 330;
+  readonly OTHER_GROW_SHADEROOT_CARROT: 331;
+  readonly OTHER_TALKED_TO_32_PEOPLE: 332;
+  readonly OTHER_EAT_CURRY_WITH_COBALION_TERRAKION_VIRIZION: 333;
+  readonly ITEM_REINS_OF_UNITY: 334;
+  readonly OTHER_WITNESS_GALARIAN_BIRD_FIGHT: 335;
+  readonly MAX_DEN_RARITY_COMMON: 336;
+  readonly MAX_DEN_RARITY_RARE: 337;
+  readonly MAX_DEN_RATING_1_STAR: 338;
+  readonly MAX_DEN_RATING_2_STAR: 339;
+  readonly MAX_DEN_RATING_3_STAR: 340;
+  readonly MAX_DEN_RATING_4_STAR: 341;
+  readonly MAX_DEN_RATING_5_STAR: 342;
+  readonly MAX_DEN_RARITY_SPECIAL: 343;
+  readonly BERRY_TREE_TYPE_RED: 344;
+  readonly BERRY_TREE_TYPE_BLUE: 345;
+  readonly BERRY_TREE_TYPE_PURPLE: 346;
+  readonly BERRY_TREE_TYPE_GREEN: 347;
+  readonly BERRY_TREE_TYPE_YELLOW: 348;
+  readonly BERRY_TREE_TYPE_PINK: 349;
+  readonly TRASH_CAN_TYPE_DAILY: 350;
+  readonly TRASH_CAN_TYPE_TUESDAY: 351;
+  readonly TRASH_CAN_TYPE_THURSDAY: 352;
+  readonly TRADE_NIDORAN_F: 353;
+  readonly TRADE_NIDORINA: 354;
+  readonly TRADE_MACHOP: 355;
+  readonly TRADE_BUIZEL: 356;
+  readonly TRADE_MEDICHAM: 357;
+  readonly TRADE_FINNEON: 358;
+  readonly TRADE_FORRETRESS: 359;
+  readonly TRADE_BONSLY: 360;
+  readonly TRADE_ANY_POKEMON: 361;
+  /**
+   * @deprecated Misspelled: the endpoint names this `other-snorlax-11-beat-league`.
+   *   Use {@link ENCOUNTER_CONDITION_VALUES.OTHER_SNORLAX_11_BEAT_LEAGUE}. Removed in 3.0.
+   */
   readonly OTHER_SNORLAX_LL_BEAT_LEAGUE: 39;
+  /**
+   * @deprecated Misspelled: the endpoint names this `radio-hoenn`.
+   *   Use {@link ENCOUNTER_CONDITION_VALUES.RADIO_HOENN}. Removed in 3.0.
+   */
+  readonly RADIO_HOEN: 15;
+  /**
+   * @deprecated Misspelled: the endpoint names this `slot2-sapphire`.
+   *   Use {@link ENCOUNTER_CONDITION_VALUES.SLOT2_SAPPHIRE}. Removed in 3.0.
+   */
+  readonly SLOT2_SAPHIRE: 10;
+  /**
+   * @deprecated The endpoint names this `story-progress-vermilion-copycat` now.
+   *   Use {@link ENCOUNTER_CONDITION_VALUES.STORY_PROGRESS_VERMILION_COPYCAT}. Removed in 3.0.
+   */
+  readonly STORY_PROGRESS_OAK_VERMILION_COPYCAT: 32;
+  /**
+   * @deprecated Misspelled: the endpoint names this `season-autumn`.
+   *   Use {@link ENCOUNTER_CONDITION_VALUES.SEASON_AUTUMN}. Removed in 3.0.
+   */
+  readonly SWASON_AUTUMN: 19;
 };
 //#endregion
 //#region src/constants/endpoints.d.ts
@@ -3018,10 +3553,21 @@ declare const EVOLUTION_TRIGGERS: {
   readonly SHED: 4;
   readonly SPIN: 5;
   readonly TOWER_OF_DARKNESS: 6;
-  readonly TOWER_OF_WATER: 7;
+  readonly TOWER_OF_WATERS: 7;
   readonly THREE_CRITICAL_HITS: 8;
   readonly TAKE_DAMAGE: 9;
   readonly OTHER: 10;
+  readonly AGILE_STYLE_MOVE: 11;
+  readonly STRONG_STYLE_MOVE: 12;
+  readonly RECOIL_DAMAGE: 13;
+  readonly USE_MOVE: 14;
+  readonly THREE_DEFEATED_BISHARP: 15;
+  readonly GIMMIGHOUL_COINS: 16;
+  /**
+   * @deprecated Misspelled: the endpoint names this trigger `tower-of-waters`.
+   *   Use {@link EVOLUTION_TRIGGERS.TOWER_OF_WATERS}. Removed in 3.0.
+   */
+  readonly TOWER_OF_WATER: 7;
 };
 //#endregion
 //#region src/constants/games.d.ts
@@ -3034,7 +3580,19 @@ declare const GENERATIONS: {
   readonly GENERATION_VI: 6;
   readonly GENERATION_VII: 7;
   readonly GENERATION_VIII: 8;
+  readonly GENERATION_IX: 9;
 };
+/**
+ * ## Generation Name
+ * A generation as the PokéAPI names it, which is what a
+ * `NamedAPIResource<Generation>` carries and what the helpers that resolve a
+ * resource's past state are given.
+ *
+ * Written out rather than derived from {@link GENERATIONS}: turning
+ * `GENERATION_VIII` into `generation-viii` in the type system takes a recursive
+ * template literal, and the set is closed and nine long.
+ */
+type GenerationName = "generation-i" | "generation-ii" | "generation-iii" | "generation-iv" | "generation-v" | "generation-vi" | "generation-vii" | "generation-viii" | "generation-ix";
 declare const POKEDEXES: {
   readonly NATIONAL: 1;
   readonly KANTO: 2;
@@ -3048,7 +3606,7 @@ declare const POKEDEXES: {
   readonly CONQUEST_GALLERY: 11;
   readonly KALOS_CENTRAL: 12;
   readonly KALOS_COASTAL: 13;
-  readonly KALOS_MONTAIN: 14;
+  readonly KALOS_MOUNTAIN: 14;
   readonly UPDATED_HOENN: 15;
   readonly ORIGINAL_ALOLA: 16;
   readonly ORIGINAL_MELEMELE: 17;
@@ -3060,10 +3618,27 @@ declare const POKEDEXES: {
   readonly UPDATED_AKALA: 23;
   readonly UPDATED_ULAULA: 24;
   readonly UPDATED_PONI: 25;
-  readonly UPDATED_KANTO: 26;
+  readonly LETSGO_KANTO: 26;
   readonly GALAR: 27;
   readonly ISLE_OF_ARMOR: 28;
   readonly CROWN_TUNDRA: 29;
+  readonly HISUI: 30;
+  readonly PALDEA: 31;
+  readonly KITAKAMI: 32;
+  readonly BLUEBERRY: 33;
+  readonly LUMIOSE_CITY: 34;
+  readonly HYPERSPACE: 35;
+  readonly CHAMPIONS: 36;
+  /**
+   * @deprecated Misspelled: the endpoint names this `kalos-mountain`.
+   *   Use {@link POKEDEXES.KALOS_MOUNTAIN}. Removed in 3.0.
+   */
+  readonly KALOS_MONTAIN: 14;
+  /**
+   * @deprecated The endpoint names this `letsgo-kanto` now.
+   *   Use {@link POKEDEXES.LETSGO_KANTO}. Removed in 3.0.
+   */
+  readonly UPDATED_KANTO: 26;
 };
 declare const VERSIONS: {
   readonly RED: 1;
@@ -3100,11 +3675,35 @@ declare const VERSIONS: {
   readonly LETS_GO_EEVEE: 32;
   readonly SWORD: 33;
   readonly SHIELD: 34;
-  readonly THE_ISLE_OF_ARMOR: 35;
-  readonly THE_CROWN_TUNDRA: 36;
+  readonly THE_ISLE_OF_ARMOR_SWORD: 35;
+  readonly THE_CROWN_TUNDRA_SWORD: 36;
   readonly BRILLIANT_DIAMOND: 37;
   readonly SHINING_PEARL: 38;
   readonly LEGENDS_ARCEUS: 39;
+  readonly SCARLET: 40;
+  readonly VIOLET: 41;
+  readonly THE_TEAL_MASK_SCARLET: 42;
+  readonly THE_INDIGO_DISK_SCARLET: 43;
+  readonly RED_JAPAN: 44;
+  readonly GREEN_JAPAN: 45;
+  readonly BLUE_JAPAN: 46;
+  readonly LEGENDS_ZA: 47;
+  readonly MEGA_DIMENSION: 48;
+  readonly CHAMPIONS: 49;
+  readonly THE_ISLE_OF_ARMOR_SHIELD: 50;
+  readonly THE_CROWN_TUNDRA_SHIELD: 51;
+  readonly THE_TEAL_MASK_VIOLET: 52;
+  readonly THE_INDIGO_DISK_VIOLET: 53;
+  /**
+   * @deprecated The endpoint names this `the-crown-tundra-sword` now.
+   *   Use {@link VERSIONS.THE_CROWN_TUNDRA_SWORD}. Removed in 3.0.
+   */
+  readonly THE_CROWN_TUNDRA: 36;
+  /**
+   * @deprecated The endpoint names this `the-isle-of-armor-sword` now.
+   *   Use {@link VERSIONS.THE_ISLE_OF_ARMOR_SWORD}. Removed in 3.0.
+   */
+  readonly THE_ISLE_OF_ARMOR: 35;
 };
 declare const VERSION_GROUPS: {
   readonly RED_BLUE: 1;
@@ -3125,12 +3724,30 @@ declare const VERSION_GROUPS: {
   readonly OMEGA_RUBY_ALPHA_SAPPHIRE: 16;
   readonly SUN_MOON: 17;
   readonly ULTRA_SUN_ULTRA_MOON: 18;
-  readonly LETS_GO: 19;
+  readonly LETS_GO_PIKACHU_LETS_GO_EEVEE: 19;
   readonly SWORD_SHIELD: 20;
   readonly THE_ISLE_OF_ARMOR: 21;
   readonly THE_CROWN_TUNDRA: 22;
-  readonly BRILLIANT_DIAMOND_AND_SHINING_PEARL: 23;
+  readonly BRILLIANT_DIAMOND_SHINING_PEARL: 23;
   readonly LEGENDS_ARCEUS: 24;
+  readonly SCARLET_VIOLET: 25;
+  readonly THE_TEAL_MASK: 26;
+  readonly THE_INDIGO_DISK: 27;
+  readonly RED_GREEN_JAPAN: 28;
+  readonly BLUE_JAPAN: 29;
+  readonly LEGENDS_ZA: 30;
+  readonly MEGA_DIMENSION: 31;
+  readonly CHAMPIONS: 32;
+  /**
+   * @deprecated The endpoint names this `brilliant-diamond-shining-pearl` now.
+   *   Use {@link VERSION_GROUPS.BRILLIANT_DIAMOND_SHINING_PEARL}. Removed in 3.0.
+   */
+  readonly BRILLIANT_DIAMOND_AND_SHINING_PEARL: 23;
+  /**
+   * @deprecated The endpoint names this `lets-go-pikachu-lets-go-eevee` now.
+   *   Use {@link VERSION_GROUPS.LETS_GO_PIKACHU_LETS_GO_EEVEE}. Removed in 3.0.
+   */
+  readonly LETS_GO: 19;
 };
 //#endregion
 //#region src/constants/items.d.ts
@@ -3192,9 +3809,18 @@ declare const ITEM_CATEGORIES: {
   readonly Z_CRYSTALS: 46;
   readonly SPECIES_CANDIES: 47;
   readonly CATCHING_BONUS: 48;
-  readonly DYNAMAX_CRISTALS: 49;
+  readonly DYNAMAX_CRYSTALS: 49;
   readonly NATURE_MINTS: 50;
   readonly CURRY_INGREDIENTS: 51;
+  readonly TERA_SHARD: 52;
+  readonly SANDWICH_INGREDIENTS: 53;
+  readonly TM_MATERIALS: 54;
+  readonly PICNIC: 55;
+  /**
+   * @deprecated Misspelled: the endpoint names this `dynamax-crystals`.
+   *   Use {@link ITEM_CATEGORIES.DYNAMAX_CRYSTALS}. Removed in 3.0.
+   */
+  readonly DYNAMAX_CRISTALS: 49;
 };
 declare const ITEM_FLING_EFFECTS: {
   readonly BADLY_POISON: 1;
@@ -3227,6 +3853,8 @@ declare const REGIONS: {
   readonly ALOLA: 7;
   readonly GALAR: 8;
   readonly HISUI: 9;
+  readonly PALDEA: 10;
+  readonly ORRE: 11;
 };
 declare const PAL_PARK_AREAS: {
   readonly FOREST: 1;
@@ -3298,6 +3926,8 @@ declare const MOVE_LEARN_METHODS: {
   readonly XD_SHADOW: 8;
   readonly XD_PURIFICATION: 9;
   readonly FORM_CHANGE: 10;
+  readonly ZYGARDE_CUBE: 11;
+  readonly TRAIN: 12;
 };
 declare const MOVE_TARGETS: {
   readonly SPECIFIC_MOVE: 1;
@@ -3312,12 +3942,18 @@ declare const MOVE_TARGETS: {
   readonly SELECTED_POKEMON: 10;
   readonly ALL_OPPONENTS: 11;
   readonly ENTIRE_FIELD: 12;
-  readonly USER_AND_ALIES: 13;
+  readonly USER_AND_ALLIES: 13;
   readonly ALL_POKEMON: 14;
   readonly ALL_ALLIES: 15;
+  readonly FAINTING_POKEMON: 16;
+  /**
+   * @deprecated Misspelled: the endpoint names this `user-and-allies`.
+   *   Use {@link MOVE_TARGETS.USER_AND_ALLIES}. Removed in 3.0.
+   */
+  readonly USER_AND_ALIES: 13;
 };
 //#endregion
-//#region src/constants/pokemons.d.ts
+//#region src/constants/pokemon.d.ts
 declare const EGG_GROUPS: {
   readonly MONSTER: 1;
   readonly WATER1: 2;
@@ -3398,12 +4034,17 @@ declare const POKEMON_HABITATS: {
   readonly CAVE: 1;
   readonly FOREST: 2;
   readonly GRASSLAND: 3;
-  readonly MONTAIN: 4;
+  readonly MOUNTAIN: 4;
   readonly RARE: 5;
   readonly ROUGH_TERRAIN: 6;
   readonly SEA: 7;
   readonly URBAN: 8;
   readonly WATERS_EDGE: 9;
+  /**
+   * @deprecated Misspelled: the endpoint names this `mountain`.
+   *   Use {@link POKEMON_HABITATS.MOUNTAIN}. Removed in 3.0.
+   */
+  readonly MONTAIN: 4;
 };
 declare const POKEMON_SHAPES: {
   readonly BALL: 1;
@@ -3430,6 +4071,7 @@ declare const STATS: {
   readonly SPEED: 6;
   readonly ACCURACY: 7;
   readonly EVASION: 8;
+  readonly SPECIAL: 9;
 };
 declare const TYPES: {
   readonly NORMAL: 1;
@@ -3450,9 +4092,33 @@ declare const TYPES: {
   readonly DRAGON: 16;
   readonly DARK: 17;
   readonly FAIRY: 18;
+  readonly STELLAR: 19;
   readonly UNKNOWN: 10001;
   readonly SHADOW: 10002;
 };
+/**
+ * ## Type Name
+ * A battle type as the PokéAPI names it, which is what a
+ * `NamedAPIResource<Type>` carries and what the type chart is keyed by.
+ *
+ * The eighteen types a Pokémon can be, and `stellar`, which is a Tera type and
+ * nothing else. `unknown` and `shadow` are in {@link TYPES} but not here: they
+ * are artefacts of Generation II's internals and of Colosseum/XD, they appear in
+ * no damage relation, and a table keyed by them would be a table with two entries
+ * nothing can ever fill.
+ *
+ * Written out rather than derived from {@link TYPES}, for the same reason
+ * `GenerationName` is: the set is closed, and the two exclusions are a decision
+ * rather than a transformation.
+ */
+type TypeName = "normal" | "fighting" | "flying" | "poison" | "ground" | "rock" | "bug" | "ghost" | "steel" | "fire" | "water" | "grass" | "electric" | "psychic" | "ice" | "dragon" | "dark" | "fairy" | "stellar";
+//#endregion
+//#region src/constants/urls.d.ts
+declare const BASE_URL: {
+  readonly REST: "https://pokeapi.co/api/v2";
+  /** Root of the sprite repository the API's own sprite URLs point at. */
+  readonly SPRITES: "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites";
+};
 //#endregion
 //#region src/constants/utilities.d.ts
 declare const LANGUAGES: {
@@ -3469,9 +4135,10 @@ declare const LANGUAGES: {
   readonly JA: 11;
   readonly ZH_HANS: 12;
   readonly PT_BR: 13;
+  readonly ES_419: 14;
 };
 declare namespace index_d_exports {
-  export { BASE_URL, BERRIES, BERRY_FIRMNESSES, BERRY_FLAVORS, CONTEST_TYPES, CURRENCIES, EGG_GROUPS, ENCOUNTER_CONDITIONS, ENCOUNTER_CONDITION_VALUES, ENCOUNTER_METHODS, ENDPOINTS, EVOLUTION_TRIGGERS, Endpoint, GENDERS, GENERATIONS, GROWTH_RATES, ITEM_ATTRIBUTES, ITEM_CATEGORIES, ITEM_FLING_EFFECTS, ITEM_POCKETS, LANGUAGES, MOVE_AILMENTS, MOVE_BATTLE_STYLES, MOVE_CATEGORIES, MOVE_DAMAGE_CLASSES, MOVE_LEARN_METHODS, MOVE_TARGETS, NATURES, PAL_PARK_AREAS, POKEATHLON_STATS, POKEDEXES, POKEMON_COLORS, POKEMON_HABITATS, POKEMON_SHAPES, REGIONS, STATS, TYPES, VERSIONS, VERSION_GROUPS };
+  export { BASE_URL, BERRIES, BERRY_FIRMNESSES, BERRY_FLAVORS, CONTEST_TYPES, CURRENCIES, EGG_GROUPS, ENCOUNTER_CONDITIONS, ENCOUNTER_CONDITION_VALUES, ENCOUNTER_METHODS, ENDPOINTS, EVOLUTION_TRIGGERS, Endpoint, GENDERS, GENERATIONS, GROWTH_RATES, GenerationName, ITEM_ATTRIBUTES, ITEM_CATEGORIES, ITEM_FLING_EFFECTS, ITEM_POCKETS, LANGUAGES, MOVE_AILMENTS, MOVE_BATTLE_STYLES, MOVE_CATEGORIES, MOVE_DAMAGE_CLASSES, MOVE_LEARN_METHODS, MOVE_TARGETS, NATURES, PAL_PARK_AREAS, POKEATHLON_STATS, POKEDEXES, POKEMON_COLORS, POKEMON_HABITATS, POKEMON_SHAPES, REGIONS, STATS, TYPES, TypeName, VERSIONS, VERSION_GROUPS };
 }
 //#endregion
 //#region src/clients/base.d.ts
@@ -3480,6 +4147,46 @@ declare namespace index_d_exports {
  * A `fetch` implementation taking a string URL, as every client call does.
  */
 type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/**
+ * ## Resource Link
+ * Something naming a single resource: a link taken from a response, or its URL
+ * as a bare string.
+ *
+ * A link carries what it points at, so passing one infers `T`; a string does
+ * not, and needs `T` named.
+ */
+type ResourceLink<T> = string | NamedAPIResource<T> | APIResource<T>;
+/**
+ * ## Retry Options
+ * When a failed request is worth attempting again.
+ *
+ * Retrying is off unless this is given — a client that quietly triples its own
+ * traffic is not something to opt out of after the fact.
+ */
+interface RetryOptions {
+  /** Attempts in total, the first one included. Defaults to 3. */
+  attempts?: number;
+  /** Statuses worth another attempt. Defaults to 429, 500, 502, 503 and 504. */
+  statuses?: number[];
+  /** The first wait, in milliseconds, doubling from there. Defaults to 300. */
+  initialDelay?: number;
+  /** The longest this client will ever wait between attempts. Defaults to 5000. */
+  maxDelay?: number;
+}
+/**
+ * ## Request Scope
+ * Cancellation applied to every request a client makes.
+ *
+ * Passed to {@link ClientFacade.with}, not to the constructor: a signal belongs
+ * to one unit of work, while a client outlives many, and a client holding a
+ * signal for its whole life is dead the first time that signal aborts.
+ */
+interface RequestScope {
+  /** Aborts the requests made through this scope. */
+  signal?: AbortSignal;
+  /** How long a request may take, in milliseconds, before it is aborted. */
+  timeout?: number;
+}
 /**
  * ## Client Options
  * Optional configuration accepted by every client.
@@ -3501,49 +4208,213 @@ interface ClientOptions {
    * Custom `fetch` implementation, for proxies, retries, cancellation or
    * instrumentation. Defaults to the global `fetch`.
    *
-   * Requests carry no timeout of their own: supply an `AbortSignal` here if you
-   * want one.
+   * Requests carry no timeout of their own: derive a scoped client with
+   * {@link ClientFacade.with} if you want one.
    */
   fetch?: FetchLike;
+  /**
+   * When to attempt a failed request again. Leave empty to attempt each request
+   * exactly once.
+   */
+  retry?: RetryOptions;
+  /**
+   * Ask the PokéAPI whether a response has changed, rather than downloading it
+   * again, once the {@link CacheStore} entry for it has expired.
+   *
+   * Pass `true` for a default {@link EtagStore}, or one of your own to size it.
+   * Leave empty and every expired entry is refetched in full.
+   */
+  revalidate?: boolean | EtagStore;
 }
 /**
- * ## Base Client
- * Base class for every section client. Handles requests to the PokéAPI, along
- * with caching and logging.
+ * ## Client Stats
+ * How many resolutions came from where, since the client was built.
+ *
+ * One count per `source` a {@link LogResponsePayload} reports, which is the only
+ * thing that tells a cache hit from a revalidation from a real round trip once
+ * the promise has settled. A failed request is counted by neither: it resolved
+ * nothing, and it is the logger's `error` event that has it.
+ */
+interface ClientStats {
+  /** Responses downloaded in full. */
+  network: number;
+  /** Responses answered from the {@link CacheStore}, with no request made. */
+  cache: number;
+  /** Callers that joined a request already on the wire rather than repeating it. */
+  inFlight: number;
+  /** Responses the PokéAPI answered `304` for, served from the {@link EtagStore}. */
+  revalidated: number;
+  /**
+   * Requests that left the process — what the PokéAPI actually saw.
+   *
+   * Not `network + revalidated`. A revalidation is a round trip that saved a
+   * body rather than a request that never happened, so it is in here; and a
+   * resolution the `retry` option attempted three times is one `network` and
+   * three of these. The attempts are the half a caller cannot see, and they are
+   * the half that shows up in someone else's rate limit.
+   */
+  roundTrips: number;
+}
+/**
+ * ## List Page
+ * The part of a resource list a walk needs: how much there is, and this page of
+ * it. Both {@link NamedAPIResourceList} and {@link APIResourceList} qualify.
  */
-declare class BaseClient {
+interface ListPage<L> {
+  count: number;
+  results: L[];
+}
+/**
+ * ## List Fn
+ * A list method, called with the offset and the limit of the page to fetch.
+ */
+type ListFn<L> = (offset: number, limit: number) => Promise<ListPage<L>>;
+/**
+ * ## List Method
+ * The shape every `list*` method on a section client has.
+ */
+type ListMethod = (offset?: number, limit?: number) => Promise<ListPage<APIResource<unknown>>>;
+/**
+ * ## List Method Name
+ * The names of `C`'s own list methods, and nothing else — so naming one to
+ * {@link BaseClient.paginate} is checked and completed by the compiler.
+ */
+type ListMethodName<C> = { [K in keyof C]: C[K] extends ListMethod ? K : never; }[keyof C];
+/** What a list method's page is made of. */
+type Listed<F> = F extends ((offset?: number, limit?: number) => Promise<ListPage<infer L>>) ? L : never;
+/** What a listed link resolves to. */
+type Resolves<L> = L extends APIResource<infer T> ? T : never;
+/**
+ * ## Paginate Options
+ * How {@link BaseClient.paginate} walks a list endpoint.
+ */
+interface PaginateOptions {
+  /** Entries fetched per request. Defaults to 20. */
+  pageSize?: number;
+  /** Fetch each link and yield the resource instead. Defaults to `false`. */
+  resolve?: boolean;
+  /** Links resolved at a time, when `resolve` is set. Defaults to 4. */
+  concurrency?: number;
+}
+/**
+ * ## Resolve Options
+ * How {@link ClientFacade.resolveAll} fetches the links it was given.
+ */
+interface ResolveOptions {
+  /** Links fetched at a time. Defaults to 4. */
+  concurrency?: number;
+}
+/**
+ * ## Client Facade
+ * What every client is, underneath: something that owns a transport and talks
+ * to it. Holds the members {@link BaseClient} and {@link MainClient} would
+ * otherwise each declare — the cache, the scope, and following a link.
+ *
+ * The transport is a `#private` field rather than a `protected` one so that
+ * nothing about it reaches the published types: a `protected` member keeps its
+ * type in the emitted `.d.ts`, which would put the whole internal transport
+ * surface in front of consumers who cannot name it.
+ */
+declare abstract class ClientFacade {
+  #private;
+  constructor(options?: ClientOptions);
   /** The store backing this client, or `undefined` when caching is disabled. */
-  readonly cache: CacheStore | undefined;
-  private readonly baseURL;
-  private readonly logger;
-  private readonly fetch;
-  /** Requests already on the wire, so concurrent callers share one round trip. */
-  private readonly inFlight;
-  constructor(clientOptions?: ClientOptions);
+  get cache(): CacheStore | undefined;
   /**
-   * Drops every cached response. A {@link CacheStore} that does not implement
-   * `clear` is left alone.
+   * How many resolutions came from where.
+   *
+   * ```ts
+   * await api.pokemon.getPokemonByName('luxray');
+   * await api.pokemon.getPokemonByName('luxray');
+   *
+   * api.stats; // { network: 1, cache: 1, inFlight: 0, revalidated: 0, roundTrips: 1 }
+   * ```
+   *
+   * The counts are the transport's, so they cover every section of a
+   * {@link MainClient} and every client derived with {@link ClientFacade.with} —
+   * the same sharing that makes one cache serve all of them.
+   *
+   * A snapshot, read at the moment it is asked for. Keeping one to compare
+   * against later means keeping the object, not the client.
+   */
+  get stats(): ClientStats;
+  /**
+   * What has been counted since `snapshot` was taken.
+   *
+   * ```ts
+   * const before = api.stats;
+   * await renderTeam();
+   *
+   * api.statsSince(before).roundTrips; // what that render cost
+   * ```
+   *
+   * There is no way to reset the counts, and this is why: the transport behind
+   * them is shared by every section of a {@link MainClient} and by every client
+   * derived with {@link ClientFacade.with}, so zeroing it for one measurement
+   * zeroes it for whatever else is measuring. Subtraction is the same answer
+   * without the shared mutation.
+   */
+  statsSince(snapshot: ClientStats): ClientStats;
+  /**
+   * Derives a client whose requests carry a signal, a timeout, or both.
+   *
+   * The clone shares this client's transport — its cache, its validators and the
+   * requests already on the wire — so a scoped call still joins an identical
+   * unscoped one instead of repeating it. Cloning is cheap, but not free: derive
+   * one per unit of work — a request handler, a job — rather than one per call.
+   *
+   * ```ts
+   * const scoped = api.with({ signal: request.signal, timeout: 2_000 });
+   * ```
+   */
+  with(scope: RequestScope): this;
+  /**
+   * Drops every cached response, and any `ETag` learned for one — otherwise the
+   * next request revalidates and is answered with the body just dropped.
+   *
+   * A {@link CacheStore} that does not implement `clear` is left alone.
+   *
+   * The store is the transport's, so a client sharing one with others clears
+   * theirs too.
    */
   clearCache(): Promise<void>;
   /**
-   * Resolves a resource through the cache, then through any identical request
-   * already in flight, and only then over the network.
+   * Fetches what a link points at, through this client's cache and scope.
+   *
+   * A link carries what it points at, so the result is typed without saying so:
+   *
+   * ```ts
+   * const pokemon = await api.getPokemonByName('luxray');
+   * const species = await api.resolve(pokemon.species);
+   * //    ^? PokemonSpecies
+   * ```
+   *
+   * A link names a resource, not a section, so any client resolves any link.
+   *
+   * @throws {TypeError} If the URL is not valid, or names no PokéAPI endpoint.
+   */
+  resolve<T>(resource: ResourceLink<T>): Promise<T>;
+  /**
+   * Fetches what several links point at, in the order they were given.
+   *
+   * At most `concurrency` requests run at a time — four by default, because the
+   * PokéAPI's fair-use policy asks clients not to flood it. The first failure
+   * rejects, and no further link is fetched.
    *
-   * The URL is joined by concatenation: `new URL(path, base)` would discard the
-   * base's own `/api/v2` path.
+   * ```ts
+   * const types = await api.resolveAll(pokemon.types.map((slot) => slot.type));
+   * //    ^? Type[]
+   * ```
    */
-  private request;
-  /** Issues a request and remembers it, so a concurrent caller can share it. */
-  private dispatch;
-  private fetchResource;
-  private logResponse;
+  resolveAll<T>(resources: readonly ResourceLink<T>[], options?: ResolveOptions): Promise<T[]>;
   /**
    * Retrieves a single resource from the PokéAPI by its endpoint and identifier.
    *
-   * @param identifier - The identifier of the resource, or a path below the endpoint.
-   *   Omit it to address the endpoint itself.
+   * @param segments - The identifier of the resource, followed by any path below
+   *   it. Each is percent-encoded, so pass `id, 'encounters'` rather than
+   *   `` `${id}/encounters` ``. Omit them to address the endpoint itself.
    */
-  protected getResource<T>(endpoint: Endpoint, identifier?: string | number): Promise<T>;
+  protected getResource<T>(endpoint: Endpoint, ...segments: (string | number)[]): Promise<T>;
   /**
    * Retrieves a resource by its URL, or by a link taken from another response.
    *
@@ -3552,7 +4423,7 @@ declare class BaseClient {
    *
    * @throws {TypeError} If the URL is not valid, or names no endpoint under `baseURL`.
    */
-  protected getResourceByURL<T>(resource: string | NamedAPIResource<T> | APIResource<T>, baseURL?: string): Promise<T>;
+  protected getResourceByURL<T>(resource: ResourceLink<T>, baseURL?: string): Promise<T>;
   /**
    * Retrieves a list of resources from the PokéAPI with pagination support.
    *
@@ -3565,6 +4436,65 @@ declare class BaseClient {
    * @template T - What the listed links resolve to.
    */
   protected getUnnamedListResource<T = unknown>(endpoint: Endpoint, offset?: number, limit?: number): Promise<APIResourceList<T>>;
+  /**
+   * Walks every page of a list, yielding one entry at a time. The bridge
+   * {@link BaseClient.paginate} reaches the transport through, so that no
+   * signature here has to name one.
+   */
+  protected walk<T>(list: ListFn<APIResource<T>>, options?: PaginateOptions): AsyncGenerator<APIResource<T> | T>;
+}
+/**
+ * ## Base Client
+ * Base class for every section client. Names endpoints; the transport behind
+ * {@link ClientFacade} does everything else — requests, caching, coalescing,
+ * retries and logs.
+ *
+ * A {@link MainClient} builds one transport and hands it to all twelve of its
+ * section clients, which is what makes them share a cache and a round trip.
+ */
+declare class BaseClient extends ClientFacade {
+  /**
+   * Walks every page of a list endpoint, yielding one entry at a time.
+   *
+   * Name the list method to walk; the offset and the limit are this method's to
+   * manage.
+   *
+   * ```ts
+   * for await (const berry of api.berry.paginate('listBerries')) {
+   *   console.log(berry.name);
+   * }
+   * ```
+   *
+   * With `resolve`, each link is fetched and the resource is yielded instead of
+   * the link. Requests are capped at `concurrency` at a time — the default is
+   * deliberately low, because walking a section is exactly the traffic the
+   * PokéAPI's fair-use policy asks clients to keep gentle.
+   *
+   * ```ts
+   * for await (const berry of api.berry.paginate('listBerries', { resolve: true })) {
+   *   console.log(berry.growth_time);
+   * }
+   * ```
+   *
+   * A function is accepted too, for a list this client does not carry — a page
+   * of a foreign endpoint, or one narrowed before the walk sees it.
+   *
+   * ```ts
+   * api.berry.paginate((offset, limit) => api.berry.listBerries(offset, limit));
+   * ```
+   */
+  paginate<K extends ListMethodName<this>>(list: K, options?: PaginateOptions & {
+    resolve?: false;
+  }): AsyncGenerator<Listed<this[K]>>;
+  paginate<K extends ListMethodName<this>>(list: K, options: PaginateOptions & {
+    resolve: true;
+  }): AsyncGenerator<Resolves<Listed<this[K]>>>;
+  paginate<L extends APIResource<unknown>>(list: ListFn<L>, options?: PaginateOptions & {
+    resolve?: false;
+  }): AsyncGenerator<L>;
+  paginate<T>(list: ListFn<APIResource<T>>, options: PaginateOptions & {
+    resolve: true;
+  }): AsyncGenerator<T>;
 }
 //#endregion
 //#region src/clients/berry.client.d.ts
@@ -3572,10 +4502,11 @@ declare class BaseClient {
  * ### Berry Client
  *
  * Client used to access the Berry Endpoints:
- *  - [Berries](https://pokeapi.co/docs/v2#berries)
- *  - [Berry Firmnesses](https://pokeapi.co/docs/v2#berry-firmnesses)
- *  - [Berry Flavors](https://pokeapi.co/docs/v2#berry-flavors)
- * ---
+ *
+ * - [Berries](https://pokeapi.co/docs/v2#berries)
+ * - [Berry Firmnesses](https://pokeapi.co/docs/v2#berry-firmnesses)
+ * - [Berry Flavors](https://pokeapi.co/docs/v2#berry-flavors)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#berries-section)
  */
 declare class BerryClient extends BaseClient {
@@ -3604,10 +4535,11 @@ declare class BerryClient extends BaseClient {
  * ### Contest Client
  *
  * Client used to access the Contest Endpoints:
- *  - [Contest Types](https://pokeapi.co/docs/v2#contest-types)
- *  - [Contest Effects](https://pokeapi.co/docs/v2#contest-effects)
- *  - [Super Contest Effects](https://pokeapi.co/docs/v2#super-contest-effects)
- * ---
+ *
+ * - [Contest Types](https://pokeapi.co/docs/v2#contest-types)
+ * - [Contest Effects](https://pokeapi.co/docs/v2#contest-effects)
+ * - [Super Contest Effects](https://pokeapi.co/docs/v2#super-contest-effects)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#contests-section)
  */
 declare class ContestClient extends BaseClient {
@@ -3632,8 +4564,9 @@ declare class ContestClient extends BaseClient {
  * ### Currency Client
  *
  * Client used to access the Currency Endpoints:
- *  - [Currencies](https://pokeapi.co/docs/v2#currencies)
- * ---
+ *
+ * - [Currencies](https://pokeapi.co/docs/v2#currencies)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#currencies-section)
  */
 declare class CurrencyClient extends BaseClient {
@@ -3650,10 +4583,11 @@ declare class CurrencyClient extends BaseClient {
  * ### Encounter Client
  *
  * Client used to access the Encounter Endpoints:
- *  - [Encounter Methods](https://pokeapi.co/docs/v2#encounter-methods)
- *  - [Encounter Conditions](https://pokeapi.co/docs/v2#encounter-conditions)
- *  - [Encounter Condition Values](https://pokeapi.co/docs/v2#encounter-condition-values)
- * ---
+ *
+ * - [Encounter Methods](https://pokeapi.co/docs/v2#encounter-methods)
+ * - [Encounter Conditions](https://pokeapi.co/docs/v2#encounter-conditions)
+ * - [Encounter Condition Values](https://pokeapi.co/docs/v2#encounter-condition-values)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#encounters-section)
  */
 declare class EncounterClient extends BaseClient {
@@ -3682,9 +4616,10 @@ declare class EncounterClient extends BaseClient {
  * ### Evolution Client
  *
  * Client used to access the Evolution Endpoints:
- *  - [Evolution Chains](https://pokeapi.co/docs/v2#evolution-chains)
- *  - [Evolution Triggers](https://pokeapi.co/docs/v2#evolution-triggers)
- * ---
+ *
+ * - [Evolution Chains](https://pokeapi.co/docs/v2#evolution-chains)
+ * - [Evolution Triggers](https://pokeapi.co/docs/v2#evolution-triggers)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#evolution-section)
  */
 declare class EvolutionClient extends BaseClient {
@@ -3705,11 +4640,12 @@ declare class EvolutionClient extends BaseClient {
  * ### Game Client
  *
  * Client used to access the Game Endpoints:
- *  - [Generations](https://pokeapi.co/docs/v2#generations)
- *  - [Pokédexes](https://pokeapi.co/docs/v2#pokedexes)
- *  - [Versions](https://pokeapi.co/docs/v2#version)
- *  - [Version Groups](https://pokeapi.co/docs/v2#version-groups)
- * ---
+ *
+ * - [Generations](https://pokeapi.co/docs/v2#generations)
+ * - [Pokédexes](https://pokeapi.co/docs/v2#pokedexes)
+ * - [Versions](https://pokeapi.co/docs/v2#version)
+ * - [Version Groups](https://pokeapi.co/docs/v2#version-groups)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#games-section)
  */
 declare class GameClient extends BaseClient {
@@ -3744,12 +4680,13 @@ declare class GameClient extends BaseClient {
  * ### Item Client
  *
  * Client used to access the Item Endpoints:
- *  - [Items](https://pokeapi.co/docs/v2#item)
- *  - [Item Attributes](https://pokeapi.co/docs/v2#item-attributes)
- *  - [Item Categories](https://pokeapi.co/docs/v2#item-categories)
- *  - [Item Fling Effects](https://pokeapi.co/docs/v2#item-fling-effects)
- *  - [Item Pockets](https://pokeapi.co/docs/v2#item-pockets)
- * ---
+ *
+ * - [Items](https://pokeapi.co/docs/v2#item)
+ * - [Item Attributes](https://pokeapi.co/docs/v2#item-attributes)
+ * - [Item Categories](https://pokeapi.co/docs/v2#item-categories)
+ * - [Item Fling Effects](https://pokeapi.co/docs/v2#item-fling-effects)
+ * - [Item Pockets](https://pokeapi.co/docs/v2#item-pockets)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#items-section)
  */
 declare class ItemClient extends BaseClient {
@@ -3790,11 +4727,12 @@ declare class ItemClient extends BaseClient {
  * ### Location Client
  *
  * Client used to access the Location Endpoints:
- *  - [Locations](https://pokeapi.co/docs/v2#locations)
- *  - [Location Areas](https://pokeapi.co/docs/v2#location-areas)
- *  - [Pal Park Areas](https://pokeapi.co/docs/v2#pal-park-areas)
- *  - [Regions](https://pokeapi.co/docs/v2#regions)
- * ---
+ *
+ * - [Locations](https://pokeapi.co/docs/v2#locations)
+ * - [Location Areas](https://pokeapi.co/docs/v2#location-areas)
+ * - [Pal Park Areas](https://pokeapi.co/docs/v2#pal-park-areas)
+ * - [Regions](https://pokeapi.co/docs/v2#regions)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#locations-section)
  */
 declare class LocationClient extends BaseClient {
@@ -3829,8 +4767,9 @@ declare class LocationClient extends BaseClient {
  * ### Machine Client
  *
  * Client used to access the Machine Endpoints:
- *  - [Machines](https://pokeapi.co/docs/v2#machines)
- * ---
+ *
+ * - [Machines](https://pokeapi.co/docs/v2#machines)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#machines-section)
  */
 declare class MachineClient extends BaseClient {
@@ -3845,14 +4784,15 @@ declare class MachineClient extends BaseClient {
  * ### Move Client
  *
  * Client used to access the Move Endpoints:
- *  - [Moves](https://pokeapi.co/docs/v2#moves)
- *  - [Move Ailments](https://pokeapi.co/docs/v2#move-ailments)
- *  - [Move Battle Styles](https://pokeapi.co/docs/v2#move-battle-styles)
- *  - [Move Categories](https://pokeapi.co/docs/v2#move-categories)
- *  - [Move Damage Classes](https://pokeapi.co/docs/v2#move-damage-classes)
- *  - [Move Learn Methods](https://pokeapi.co/docs/v2#move-learn-methods)
- *  - [Move Targets](https://pokeapi.co/docs/v2#move-targets)
- * ---
+ *
+ * - [Moves](https://pokeapi.co/docs/v2#moves)
+ * - [Move Ailments](https://pokeapi.co/docs/v2#move-ailments)
+ * - [Move Battle Styles](https://pokeapi.co/docs/v2#move-battle-styles)
+ * - [Move Categories](https://pokeapi.co/docs/v2#move-categories)
+ * - [Move Damage Classes](https://pokeapi.co/docs/v2#move-damage-classes)
+ * - [Move Learn Methods](https://pokeapi.co/docs/v2#move-learn-methods)
+ * - [Move Targets](https://pokeapi.co/docs/v2#move-targets)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#moves-section)
  */
 declare class MoveClient extends BaseClient {
@@ -3905,23 +4845,24 @@ declare class MoveClient extends BaseClient {
  * ### Pokémon Client
  *
  * Client used to access the Pokémon Endpoints:
- *  - [Abilities](https://pokeapi.co/docs/v2#abilities)
- *  - [Characteristics](https://pokeapi.co/docs/v2#characteristics)
- *  - [Egg Groups](https://pokeapi.co/docs/v2#egg-groups)
- *  - [Genders](https://pokeapi.co/docs/v2#genders)
- *  - [Growth Rates](https://pokeapi.co/docs/v2#growth-rates)
- *  - [Natures](https://pokeapi.co/docs/v2#natures)
- *  - [Pokéathlon Stats](https://pokeapi.co/docs/v2#pokeathlon-stats)
- *  - [Pokémon](https://pokeapi.co/docs/v2#pokemon)
- *  - [Pokémon Location Areas](https://pokeapi.co/docs/v2#pokemon-location-areas)
- *  - [Pokémon Colors](https://pokeapi.co/docs/v2#pokemon-colors)
- *  - [Pokémon Forms](https://pokeapi.co/docs/v2#pokemon-forms)
- *  - [Pokémon Habitats](https://pokeapi.co/docs/v2#pokemon-habitats)
- *  - [Pokémon Shapes](https://pokeapi.co/docs/v2#pokemon-shapes)
- *  - [Pokémon Species](https://pokeapi.co/docs/v2#pokemon-species)
- *  - [Stats](https://pokeapi.co/docs/v2#stats)
- *  - [Types](https://pokeapi.co/docs/v2#types)
- * ---
+ *
+ * - [Abilities](https://pokeapi.co/docs/v2#abilities)
+ * - [Characteristics](https://pokeapi.co/docs/v2#characteristics)
+ * - [Egg Groups](https://pokeapi.co/docs/v2#egg-groups)
+ * - [Genders](https://pokeapi.co/docs/v2#genders)
+ * - [Growth Rates](https://pokeapi.co/docs/v2#growth-rates)
+ * - [Natures](https://pokeapi.co/docs/v2#natures)
+ * - [Pokéathlon Stats](https://pokeapi.co/docs/v2#pokeathlon-stats)
+ * - [Pokémon](https://pokeapi.co/docs/v2#pokemon)
+ * - [Pokémon Location Areas](https://pokeapi.co/docs/v2#pokemon-location-areas)
+ * - [Pokémon Colors](https://pokeapi.co/docs/v2#pokemon-colors)
+ * - [Pokémon Forms](https://pokeapi.co/docs/v2#pokemon-forms)
+ * - [Pokémon Habitats](https://pokeapi.co/docs/v2#pokemon-habitats)
+ * - [Pokémon Shapes](https://pokeapi.co/docs/v2#pokemon-shapes)
+ * - [Pokémon Species](https://pokeapi.co/docs/v2#pokemon-species)
+ * - [Stats](https://pokeapi.co/docs/v2#stats)
+ * - [Types](https://pokeapi.co/docs/v2#types)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#pokemon-section)
  */
 declare class PokemonClient extends BaseClient {
@@ -4025,9 +4966,10 @@ declare class PokemonClient extends BaseClient {
  * ### Utility Client
  *
  * Client used to access the Utility Endpoints:
- *  - [Languages](https://pokeapi.co/docs/v2#languages)
- *  - [Resources](https://pokeapi.co/docs/v2#resource-listspagination-section)
- * ---
+ *
+ * - [Languages](https://pokeapi.co/docs/v2#languages)
+ * - [Resources](https://pokeapi.co/docs/v2#resource-listspagination-section)
+ *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2#utility-section)
  */
 declare class UtilityClient extends BaseClient {
@@ -4038,19 +4980,20 @@ declare class UtilityClient extends BaseClient {
   /**
    * Get any resource by its URL, or by a link taken from another response.
    *
-   * A link carries what it points at, so the result is typed without saying so:
-   *
    * ```ts
    * const pokemon = await api.pokemon.getPokemonByName('luxray');
    * const species = await api.utility.getResourceByUrl(pokemon.species);
    * //    ^? PokemonSpecies
    * ```
    *
+   * Every client carries {@link BaseClient.resolve}, which does the same thing;
+   * this is the name it went out under, and it stays.
+   *
    * @param resource The absolute URL of the resource, or a link to it.
    * @returns The resource the URL points at.
    * @throws {TypeError} If the URL is not valid, or names no PokéAPI endpoint.
    */
-  getResourceByUrl<T>(resource: string | NamedAPIResource<T> | APIResource<T>): Promise<T>;
+  getResourceByUrl<T>(resource: ResourceLink<T>): Promise<T>;
   /** List Languages. Page defaults to 20 entries from offset 0. */
   listLanguages(offset?: number, limit?: number): Promise<NamedAPIResourceList<Language>>;
 }
@@ -4060,26 +5003,31 @@ declare class UtilityClient extends BaseClient {
  * ### Main Client
  *
  * The main client used to access all the PokéAPI Endpoints:
- *  - [Berries](https://pokeapi.co/docs/v2#berries-section)
- *  - [Contests](https://pokeapi.co/docs/v2#contests-section)
- *  - [Currencies](https://pokeapi.co/docs/v2#currencies-section)
- *  - [Encounters](https://pokeapi.co/docs/v2#encounters-section)
- *  - [Evolution](https://pokeapi.co/docs/v2#evolution-section)
- *  - [Games](https://pokeapi.co/docs/v2#games-section)
- *  - [Items](https://pokeapi.co/docs/v2#items-section)
- *  - [Locations](https://pokeapi.co/docs/v2#locations-section)
- *  - [Machines](https://pokeapi.co/docs/v2#machines-section)
- *  - [Moves](https://pokeapi.co/docs/v2#moves-section)
- *  - [Pokémon](https://pokeapi.co/docs/v2#pokemon-section)
- *  - [Utility](https://pokeapi.co/docs/v2#utility-section)
- * ---
- * All the clients below share a single cache, so a resource fetched through one
- * of them is served from memory by the rest.
+ *
+ * - [Berries](https://pokeapi.co/docs/v2#berries-section)
+ * - [Contests](https://pokeapi.co/docs/v2#contests-section)
+ * - [Currencies](https://pokeapi.co/docs/v2#currencies-section)
+ * - [Encounters](https://pokeapi.co/docs/v2#encounters-section)
+ * - [Evolution](https://pokeapi.co/docs/v2#evolution-section)
+ * - [Games](https://pokeapi.co/docs/v2#games-section)
+ * - [Items](https://pokeapi.co/docs/v2#items-section)
+ * - [Locations](https://pokeapi.co/docs/v2#locations-section)
+ * - [Machines](https://pokeapi.co/docs/v2#machines-section)
+ * - [Moves](https://pokeapi.co/docs/v2#moves-section)
+ * - [Pokémon](https://pokeapi.co/docs/v2#pokemon-section)
+ * - [Utility](https://pokeapi.co/docs/v2#utility-section)
+ *
+ * All the clients below share a single transport, so a resource fetched through
+ * one of them is served from cache by the rest — and two of them asking for the
+ * same URL at once make one round trip, not two.
+ *
+ * Composes its sections rather than inheriting from them: it extends
+ * {@link ClientFacade}, not {@link BaseClient}, so it carries no endpoint of its
+ * own.
  *
  * See [PokéAPI Documentation](https://pokeapi.co/docs/v2)
  */
-declare class MainClient {
-  readonly cache: CacheStore | undefined;
+declare class MainClient extends ClientFacade {
   readonly berry: BerryClient;
   readonly contest: ContestClient;
   readonly currency: CurrencyClient;
@@ -4092,9 +5040,7 @@ declare class MainClient {
   readonly move: MoveClient;
   readonly pokemon: PokemonClient;
   readonly utility: UtilityClient;
-  constructor(clientOptions?: ClientOptions);
-  /** Drops every cached response, for all the clients at once. */
-  clearCache(): Promise<void>;
+  constructor(options?: ClientOptions);
 }
 //#endregion
 //#region src/config/errors.d.ts
@@ -4114,11 +5060,416 @@ declare class PokenodeError extends Error {
   readonly url: string;
   /** Parsed response body, when the error response carried JSON. */
   readonly body: unknown;
-  constructor(response: Response, body: unknown);
+  /**
+   * @param message Overrides the default text, for a status whose failure is not
+   *   self-explanatory.
+   */
+  constructor(response: Response, body: unknown, message?: string);
   /** Whether the error came from a pokenode-ts client. */
   static isPokenodeError(error: unknown): error is PokenodeError;
 }
 //#endregion
+//#region src/utils/evolution.d.ts
+/**
+ * ## Evolution Step
+ * One edge of an evolution chain: a species, what it evolves into, and every way
+ * that happens.
+ */
+interface EvolutionStep {
+  /** The species that evolves. */
+  from: NamedAPIResource<PokemonSpecies>;
+  /** What it evolves into. */
+  to: NamedAPIResource<PokemonSpecies>;
+  /**
+   * The ways this step happens, which are alternatives rather than a sequence —
+   * the API publishes one per version group, so Leafeon carries five mossy-rock
+   * locations and a Leaf Stone. Never empty.
+   */
+  details: EvolutionDetail[];
+  /** How deep in the chain this step sits: `1` for a first evolution. */
+  depth: number;
+  /** Whether {@link EvolutionStep.to} is a baby Pokémon. */
+  isBaby: boolean;
+}
+/**
+ * ## Flatten Options
+ * How {@link flattenChain} narrows the chain it walks.
+ */
+interface FlattenOptions {
+  /**
+   * Keep only the details tagged with this version group, by the name the API
+   * gives it — `sword-shield`, not `Sword/Shield` — and drop the steps left with
+   * none. The tag is the game that introduced the method, not every game it
+   * applies in — see {@link flattenChain}.
+   */
+  versionGroup?: string;
+}
+/**
+ * Flattens an evolution chain into one step per evolution, depth-first in the
+ * order the API lists them.
+ *
+ * ```ts
+ * const species = await api.pokemon.getPokemonSpeciesByName('eevee');
+ * const chain = await api.resolve(species.evolution_chain);
+ *
+ * for (const step of flattenChain(chain)) {
+ *   console.log(`${step.from.name} → ${step.to.name}`);
+ * }
+ * ```
+ *
+ * The root is not a step: it is what the chain starts from, and the API gives it
+ * no `evolution_details` to describe.
+ *
+ * `versionGroup` keeps only the details tagged with that version group, which is
+ * what picks the Leaf Stone out of Leafeon's six alternatives:
+ *
+ * ```ts
+ * flattenChain(chain, { versionGroup: 'sword-shield' });
+ * ```
+ *
+ * That tag is the game which *introduced* the method, not every game it applies
+ * in: Eevee's Water Stone is tagged `red-blue` alone, so filtering to
+ * `sword-shield` drops Vaporeon even though Sword/Shield evolves it the same way
+ * it always did. The question this answers is what a game changed.
+ *
+ * A step with nothing left after that is dropped, but the chain below it is
+ * still walked — every edge is filtered on its own terms, and `depth` stays the
+ * position in the chain rather than in the result.
+ */
+declare const flattenChain: (chain: EvolutionChain, options?: FlattenOptions) => EvolutionStep[];
+/**
+ * The steps leading from the root of a chain to `species`.
+ *
+ * ```ts
+ * pathTo(chain, 'dustox')?.map((step) => step.to.name); // ['cascoon', 'dustox']
+ * ```
+ *
+ * Matched against the name the API gives a species, which is not the name a game
+ * displays: `localize(species.names)` is `Papilord` in French and finds nothing
+ * here. Pass the link itself when you have one.
+ *
+ * @returns The steps, `[]` when `species` is the root the chain starts from, and
+ *   `undefined` when the chain does not contain it. The two empty answers are
+ *   different questions, so they are different values.
+ */
+declare const pathTo: (chain: EvolutionChain, species: string | NamedAPIResource<PokemonSpecies>) => EvolutionStep[] | undefined;
+/**
+ * ## Evolution Requirement
+ * One condition an evolution is subject to, as a discriminated union — what an
+ * {@link EvolutionDetail}'s thirty-odd nullable fields say, without the nulls.
+ *
+ * `is_default` and `version_group` are not here: they describe the record, not
+ * what the Pokémon has to do.
+ */
+type EvolutionRequirement = {
+  kind: "trigger";
+  trigger: NamedAPIResource<EvolutionTrigger>;
+} | {
+  kind: "item";
+  item: NamedAPIResource<Item>;
+} | {
+  kind: "held-item";
+  item: NamedAPIResource<Item>;
+} | {
+  kind: "min-level";
+  level: number;
+} | {
+  kind: "min-happiness";
+  happiness: number;
+} | {
+  kind: "min-beauty";
+  beauty: number;
+} | {
+  kind: "min-affection";
+  affection: number;
+} | {
+  kind: "known-move";
+  move: NamedAPIResource<Move>;
+} | {
+  kind: "known-move-type";
+  type: NamedAPIResource<Type>;
+} | {
+  kind: "used-move";
+  move: NamedAPIResource<Move>;
+} | {
+  kind: "min-move-count";
+  count: number;
+} | {
+  kind: "min-steps";
+  steps: number;
+} | {
+  kind: "min-damage-taken";
+  damage: number;
+} | {
+  kind: "location";
+  location: NamedAPIResource<Location>;
+} | {
+  kind: "region";
+  region: NamedAPIResource<Region>;
+} | {
+  kind: "time-of-day";
+  time: EvolutionTimeOfDay;
+} | {
+  kind: "gender";
+  gender: number;
+} | {
+  kind: "relative-physical-stats";
+  comparison: 1 | 0 | -1;
+} | {
+  kind: "party-species";
+  species: NamedAPIResource<PokemonSpecies>;
+} | {
+  kind: "party-type";
+  type: NamedAPIResource<Type>;
+} | {
+  kind: "trade-species";
+  species: NamedAPIResource<PokemonSpecies>;
+} | {
+  kind: "base-form";
+  form: NamedAPIResource<PokemonForm>;
+} | {
+  kind: "evolved-form";
+  form: NamedAPIResource<PokemonForm>;
+} | {
+  kind: "needs-overworld-rain";
+} | {
+  kind: "turn-upside-down";
+} | {
+  kind: "near-special-rock";
+} | {
+  kind: "needs-multiplayer";
+};
+/**
+ * The conditions one {@link EvolutionDetail} sets out, with everything it left
+ * unset dropped.
+ *
+ * ```ts
+ * requirementsOf(step.details[0]); // eevee → umbreon
+ * // [
+ * //   { kind: 'trigger', trigger: { name: 'level-up', … } },
+ * //   { kind: 'min-happiness', happiness: 160 },
+ * //   { kind: 'time-of-day', time: 'night' },
+ * //   { kind: 'base-form', form: { name: 'eevee', … } },
+ * // ]
+ * ```
+ *
+ * The trigger leads, so rendering the result is a walk over one array.
+ *
+ * Every field is tested against the value the API uses for "unset" rather than
+ * for truthiness: `relative_physical_stats` is `0` when Attack has to equal
+ * Defense, and `time_of_day` is `''`.
+ */
+declare const requirementsOf: (detail: EvolutionDetail) => EvolutionRequirement[];
+/**
+ * ## Requirement Phrases
+ * One renderer per {@link EvolutionRequirement} kind. Exhaustive, so a kind added
+ * to that union has to be given words here too.
+ */
+type RequirementPhrases = { [K in EvolutionRequirement["kind"]]: (requirement: Extract<EvolutionRequirement, {
+  kind: K;
+}>) => string; };
+/**
+ * ## Resource Namer
+ * How a resource a requirement names is written out.
+ *
+ * @param resource The item, move, species, location, region, form or type the
+ *   requirement carries.
+ * @returns What to print for it.
+ */
+type ResourceNamer = (resource: NamedAPIResource<unknown>) => string;
+/**
+ * Builds the English table around a way of naming resources.
+ *
+ * Everything except the name is fixed; `namer` is the one thing a caller who
+ * keeps the English sentence still has to replace, because `spaced` prints what
+ * the API calls a resource and no localized name is derivable from it.
+ *
+ * ```ts
+ * const names = new Map([['water-stone', 'Pedra da Água']]);
+ *
+ * requirementPhrases((resource) => names.get(resource.name) ?? resource.name);
+ * ```
+ *
+ * @param namer How to write a resource out. Defaults to the API's own name, with
+ *   the hyphens turned to spaces.
+ */
+declare const requirementPhrases: (namer?: ResourceNamer) => RequirementPhrases;
+/**
+ * ## Requirement Phrases
+ * The English {@link formatRequirements} renders with, naming resources the way
+ * the API does. Exported so a caller can replace the wording of one kind — or
+ * all of them, in another language — without rebuilding the rest of the renderer
+ * around it, and so an override can fall back to the default for what it does
+ * not handle.
+ *
+ * ```ts
+ * formatRequirements(requirements, {
+ *   phrases: { 'min-happiness': ({ happiness }) => `com ${happiness} de felicidade` },
+ * });
+ *
+ * formatRequirements(requirements, {
+ *   phrases: {
+ *     trigger: (requirement) => MINE[requirement.trigger.name] ?? REQUIREMENT_PHRASES.trigger(requirement),
+ *   },
+ * });
+ * ```
+ */
+declare const REQUIREMENT_PHRASES: RequirementPhrases;
+/**
+ * ## Format Options
+ * How {@link formatRequirements} words what it renders.
+ */
+interface FormatOptions {
+  /**
+   * How to write out the resources the requirements name. Defaults to the API's
+   * own name with the hyphens turned to spaces — `water stone`.
+   *
+   * This is the half of a translation that `phrases` cannot do: a display name
+   * is `localize(item.names)`, which is a request, so it has to come from the
+   * caller. Applied to the default table, and to nothing a `phrases` entry
+   * overrides — that entry is handed the resource and names it however it likes.
+   *
+   * Hold the function rather than writing it inline: the table built around a
+   * namer is kept and reused, and a new closure per call is a new table per call.
+   */
+  name?: ResourceNamer;
+  /**
+   * Wording for the kinds named, {@link REQUIREMENT_PHRASES} for the rest —
+   * everything around it, including the `use-item` de-duplication, stays.
+   */
+  phrases?: Partial<RequirementPhrases>;
+}
+/**
+ * Renders requirements as an English phrase.
+ *
+ * ```ts
+ * formatRequirements(requirementsOf(detail)); // eevee → umbreon
+ * // 'level up, with at least 160 happiness, during the night, in its eevee form'
+ * ```
+ *
+ * The only English in the library, and a separate export for that reason: an
+ * application rendering its own copy — in its own language, or as anything other
+ * than a sentence — drops this and the phrase table with it. Use
+ * {@link requirementsOf} for that, or `phrases` to keep the sentence and change
+ * the words:
+ *
+ * ```ts
+ * formatRequirements(requirements, { phrases: { trade: () => 'by trade' } });
+ * ```
+ *
+ * Resources are named the way the API names them, not the way a game displays
+ * them. `localize(item.names)` is the display name, it costs a request, and
+ * `name` is where it goes:
+ *
+ * ```ts
+ * const items = await api.resolveAll(links);
+ * const display = new Map(items.map((item) => [item.name, localize(item.names)?.name]));
+ *
+ * formatRequirements(requirements, { name: (resource) => display.get(resource.name) ?? resource.name });
+ * // 'use Water Stone'
+ * ```
+ *
+ * The two options are the two halves of a translation and are independent:
+ * `phrases` is the words the library supplies, `name` the words the API does.
+ *
+ * A `use-item` trigger and the item it uses are one phrase, since "use an item,
+ * use water stone" says it twice. That holds under `phrases` too: the trigger is
+ * dropped before anything is rendered, so an overridden `item` is still what says
+ * the item is used.
+ */
+declare const formatRequirements: (requirements: readonly EvolutionRequirement[], options?: FormatOptions) => string;
+//#endregion
+//#region src/utils/localize.d.ts
+/**
+ * ## Localized
+ * An entry the PokéAPI publishes once per language — a `Name`, `FlavorText`,
+ * `Description`, `Effect`, `VerboseEffect`, and everything shaped like them.
+ */
+interface Localized {
+  language: NamedAPIResource<Language>;
+}
+/**
+ * ## Localize Options
+ * Which language to pick, and which to settle for.
+ */
+interface LocalizeOptions {
+  /** The language wanted, by the name the PokéAPI gives it. Defaults to `en`. */
+  language?: string;
+  /**
+   * The language to try when the first one is absent. Left out, nothing is tried
+   * and the answer is `undefined` — a fallback is a decision about the product,
+   * not a default.
+   */
+  fallback?: string;
+}
+/**
+ * Picks the entry written in `language`, by the name the PokéAPI gives that
+ * language: `en`, `ja`, `ja-hrkt`, `zh-hans`, `es-419`, and so on.
+ *
+ * ```ts
+ * const species = await api.pokemon.getPokemonSpeciesByName('eevee');
+ *
+ * localize(species.names)?.name; // 'Eevee'
+ * localize(species.names, 'ja')?.name; // 'イーブイ'
+ * localize(species.names, { language: 'gd', fallback: 'en' })?.name; // 'Eevee'
+ * ```
+ *
+ * Matched without regard to case: the PokéAPI writes these tags in lower case,
+ * while BCP 47 capitalizes the script subtag — `ja-Hrkt` is the form anyone used
+ * to language tags will reach for, and it should not silently match nothing.
+ *
+ * A section may list several entries for one language — flavor text, one per
+ * version — and the first is the one returned. {@link localizeAll} is the way to
+ * see the rest and pick by version.
+ *
+ * @returns The entry, the one in `fallback` when that language is absent, or
+ *   `undefined` when neither is there.
+ */
+declare const localize: <T extends Localized>(entries: readonly T[], language?: string | LocalizeOptions) => T | undefined;
+/**
+ * Every entry written in `language`, in the order the API lists them.
+ *
+ * ```ts
+ * const species = await api.pokemon.getPokemonSpeciesByName('eevee');
+ *
+ * const entries = localizeAll(species.flavor_text_entries, 'en');
+ * entries.find((entry) => entry.version.name === 'sword')?.flavor_text;
+ * ```
+ *
+ * Which is what a section publishing one entry per version needs: `localize`
+ * answers with the first, and the first is an arbitrary game's Pokédex entry
+ * rather than the one asked for. The version is on the entry — `version` on
+ * flavor text, `version_group` on the sections that change per group — so the
+ * filter belongs to the caller, who knows which of the two is there.
+ *
+ * @returns The entries, those in `fallback` when the language is absent, or `[]`
+ *   when neither is there.
+ */
+declare const localizeAll: <T extends Localized>(entries: readonly T[], language?: string | LocalizeOptions) => T[];
+//#endregion
+//#region src/utils/resource-id.d.ts
+/**
+ * The id inside a resource URL, without a request.
+ *
+ * ```ts
+ * const page = await api.pokemon.listPokemons(0, 20);
+ *
+ * page.results.map((link) => getPokemonSpriteUrl(resourceId(link)));
+ * ```
+ *
+ * A list page gives names and URLs and no ids, while the sprite repository is
+ * keyed by id alone — this is what joins the two, and it is what lets a grid of
+ * every Pokémon render off one list request instead of one request per card.
+ *
+ * The id is read off the URL rather than fetched, so it is only as good as the
+ * link: a URL the API did not write is not promised to end in one.
+ *
+ * @param resource The link, as a URL or as the resource object carrying one.
+ * @returns The id.
+ * @throws {TypeError} If the URL does not end in an id.
+ */
+declare const resourceId: (resource: ResourceLink<unknown>) => number;
+//#endregion
 //#region src/utils/sprites.d.ts
 /**
  * ## Sprite Variant
@@ -4179,5 +5530,120 @@ type PokemonSpriteOptions = {
  */
 declare const getPokemonSpriteUrl: (id: number, options?: PokemonSpriteOptions) => string;
 //#endregion
-export { APIResource, APIResourceList, Ability, AbilityEffectChange, AbilityFlavorText, AbilityPokemon, Animated, AwesomeName, BASE_URL, BERRIES, BERRY_FIRMNESSES, BERRY_FLAVORS, Berry, BerryClient, BerryFirmness, BerryFlavor, BerryFlavorMap, BlackWhite, BrilliantDiamondShiningPearl, index_d_exports as CONSTANTS, CONTEST_TYPES, CURRENCIES, type CacheStore, ChainLink, Characteristic, type ClientOptions, ContestClient, ContestComboDetail, ContestComboSets, ContestEffect, ContestFlavorText, ContestName, ContestType, Crystal, Currency, CurrencyClient, Description, DiamondPearl, DreamWorld, EGG_GROUPS, ENCOUNTER_CONDITIONS, ENCOUNTER_CONDITION_VALUES, ENCOUNTER_METHODS, ENDPOINTS, EVOLUTION_TRIGGERS, Effect, EggGroup, Emerald, Encounter, EncounterClient, EncounterCondition, EncounterConditionValue, EncounterMethod, EncounterMethodRate, EncounterPokemonDetail, EncounterVersionDetails, Endpoint, EvolutionChain, EvolutionClient, EvolutionDetail, EvolutionTrigger, type FetchLike, FireredLeafgreen, FlavorBerryMap, FlavorText, GENDERS, GENERATIONS, GROWTH_RATES, GameClient, Gender, Generation, GenerationGameIndex, GenerationIIISprites, GenerationIIITypeSprites, GenerationIISprites, GenerationISprites, GenerationIVSprites, GenerationIVTypeSprites, GenerationIXSprites, GenerationIXTypeSprites, GenerationVIIISprites, GenerationVIIITypeSprites, GenerationVIISprites, GenerationVIITypeSprites, GenerationVISprites, GenerationVITypeSprites, GenerationVSprites, GenerationVTypeSprites, GenerationViiIcons, GenerationViiiIcons, Genus, Gold, GrowthRate, GrowthRateExperienceLevel, HeartgoldSoulsilver, Home, ITEM_ATTRIBUTES, ITEM_CATEGORIES, ITEM_FLING_EFFECTS, ITEM_POCKETS, Item, ItemAttribute, ItemCategory, ItemClient, ItemFlingEffect, ItemHolderPokemon, ItemHolderPokemonVersionDetail, ItemPocket, ItemPrice, ItemSprites, LANGUAGES, Language, Location, LocationArea, LocationAreaEncounter, LocationClient, type LogErrorPayload, type LogRequestPayload, type LogResponsePayload, type Logger, MOVE_AILMENTS, MOVE_BATTLE_STYLES, MOVE_CATEGORIES, MOVE_DAMAGE_CLASSES, MOVE_LEARN_METHODS, MOVE_TARGETS, Machine, MachineClient, MachineVersionDetail, MainClient, MemoryCache, type MemoryCacheOptions, Move, MoveAilment, MoveBattleStyle, MoveBattleStylePreference, MoveCategory, MoveClient, MoveDamageClass, MoveFlavorText, MoveLearnMethod, MoveMetaData, MoveStatAffect, MoveStatAffectSets, MoveStatChange, MoveTarget, NATURES, Name, NamedAPIResource, NamedAPIResourceList, Nature, NaturePokeathlonStatAffect, NaturePokeathlonStatAffectSets, NatureStatAffectSets, NatureStatChange, OfficialArtwork, OmegarubyAlphasapphire, OtherPokemonSprites, PAL_PARK_AREAS, POKEATHLON_STATS, POKEDEXES, POKEMON_COLORS, POKEMON_HABITATS, POKEMON_SHAPES, PalParkArea, PalParkEncounterArea, PalParkEncounterSpecies, PastMoveStatValues, Platinum, PokeathlonStat, Pokedex, Pokemon, PokemonAbility, PokemonClient, PokemonColor, PokemonCries, PokemonEncounter, PokemonEntry, PokemonForm, PokemonFormCondition, PokemonFormGenerationVIIISprites, PokemonFormSprites, PokemonFormVersionSprites, PokemonHabitat, PokemonHeldItem, PokemonHeldItemVersion, PokemonMove, PokemonMoveVersion, PokemonPastAbility, PokemonPastAbilitySlot, PokemonPastStat, PokemonPastType, PokemonShape, PokemonSpecies, PokemonSpeciesDexEntry, PokemonSpeciesGender, PokemonSpeciesVariety, PokemonSpriteOptions, PokemonSprites, PokemonStat, PokemonType, PokenodeError, REGIONS, RedBlue, Region, RubySapphire, STATS, ScarletViolet, Showdown, Silver, SpriteVariant, Stat, SuperContestEffect, TYPES, Type, TypeGameSprites, TypePokemon, TypeRelations, TypeRelationsPast, TypeSprites, UltraSunUltraMoon, UtilityClient, VERSIONS, VERSION_GROUPS, VerboseEffect, Version, VersionEncounterDetail, VersionGameIndex, VersionGroup, VersionGroupFlavorText, VersionSprites, WebStorageCache, type WebStorageCacheOptions, type WebStorageLike, XY, Yellow, consoleLogger, getPokemonSpriteUrl };
+//#region src/utils/type-chart.d.ts
+/**
+ * ## Generation Scope
+ * Which generation's type chart to read. Leave it out for the current one.
+ */
+interface GenerationScope {
+  generation?: GenerationName;
+}
+/**
+ * The damage relations `type` had in `generation`, or the current ones when no
+ * generation is named.
+ *
+ * ```ts
+ * const ghost = await api.pokemon.getTypeByName('ghost');
+ *
+ * relationsFor(ghost).half_damage_to; // [dark]
+ * relationsFor(ghost, 'generation-iii')?.half_damage_to; // [dark, steel]
+ * ```
+ *
+ * Each entry in `past_damage_relations` records the *last* generation it applied
+ * to, so the chart in force is the first entry still at or after the generation
+ * asked for — Ghost's `generation-v` entry is what Ghost looked like from II
+ * through V, and the current relations take over at VI.
+ *
+ * @returns The relations, or `undefined` when `type` did not exist yet in
+ *   `generation`. Nothing is guessed: Steel in generation I has no chart, and a
+ *   neutral one would be a confidently wrong answer rather than a missing one.
+ */
+declare const relationsFor: (type: Type, generation?: GenerationName) => TypeRelations | undefined;
+/**
+ * The damage multiplier `attacking` deals to a defender that has `defending`
+ * types — `0`, `0.25`, `0.5`, `1`, `2` or `4`.
+ *
+ * ```ts
+ * const fire = await api.pokemon.getTypeByName('fire');
+ * const ferrothorn = await api.pokemon.getPokemonByName('ferrothorn');
+ *
+ * effectiveness(fire, ferrothorn.types.map((slot) => slot.type)); // 4
+ * ```
+ *
+ * Read from the attacking type's own offensive relations, so this needs the one
+ * type fetched rather than one per defending type.
+ *
+ * With a `generation`, the chart of that generation is used and the result is
+ * `undefined` when `attacking` postdates it. Only the attacker is checked that
+ * way: the defenders arrive as links, which carry no generation to check
+ * against. `Pokemon.past_types` is where a historically correct defender comes
+ * from.
+ */
+declare function effectiveness(attacking: Type, defending: readonly NamedAPIResource<Type>[]): number;
+declare function effectiveness(attacking: Type, defending: readonly NamedAPIResource<Type>[], options: {
+  generation: GenerationName;
+}): number | undefined;
+/**
+ * What every one of `types` does to a defender that has `defending` types, keyed
+ * by attacking type name — the "what is this Pokémon weak to" table.
+ *
+ * ```ts
+ * const types: Type[] = [];
+ * for await (const type of api.pokemon.paginate('listTypes', { resolve: true })) {
+ *   types.push(type);
+ * }
+ *
+ * const profile = defensiveProfile(types, gengar.types.map((slot) => slot.type));
+ * profile.psychic; // 2
+ * profile.normal; // 0
+ * ```
+ *
+ * The whole `type` section is one cached walk, and every lookup after that is
+ * local. A type that did not exist in the generation asked for is left out of the
+ * table rather than reported as neutral.
+ *
+ * `Partial` because of that, and because `types` is whatever the caller resolved:
+ * an entry is there when the attacking type is, so every lookup is `number |
+ * undefined`. `unknown` and `shadow` are not {@link TypeName}s and are skipped —
+ * they hold no damage relations, so they have no place in a matchup table.
+ *
+ * Reach for {@link defensiveProfileFrom} unless you are asking about a past
+ * generation: it answers the same question from the defender's own types, which
+ * is one or two resources rather than the whole section. This is the form that
+ * takes a `generation`, because only the attacking type carries the history.
+ *
+ * Keyed by the name the API gives a type, which is not the name a game displays:
+ * `localize(type.names)` is what a table headed in French needs, and it is a
+ * property of the resource rather than of this table.
+ */
+declare const defensiveProfile: (types: readonly Type[], defending: readonly NamedAPIResource<Type>[], options?: GenerationScope) => Partial<Record<TypeName, number>>;
+/**
+ * The same table, read off the defending types themselves — what every type does
+ * to a Pokémon that has `defending` types.
+ *
+ * ```ts
+ * const gengar = await api.pokemon.getPokemonByName('gengar');
+ * const types = await api.resolveAll(gengar.types.map((slot) => slot.type));
+ *
+ * const profile = defensiveProfileFrom(types);
+ * profile.psychic; // 2
+ * profile.normal; // 0
+ * ```
+ *
+ * Two requests for a dual-typed Pokémon, against the whole `type` section that
+ * {@link defensiveProfile} needs — the answer is the same because the chart is
+ * symmetric, which `tests/live/relations.live.spec.ts` is what keeps honest.
+ *
+ * Every {@link TypeName} is present: the defending types name every attacker
+ * they interact with, and the rest are neutral rather than unknown. There is no
+ * `generation` option for exactly the reason the entries are total — a defending
+ * type's arrays are the current chart, and they have no way to say that an
+ * attacking type did not exist yet. That question needs {@link defensiveProfile}.
+ *
+ * Keyed by the API's name for a type, as {@link defensiveProfile} is;
+ * `localize(type.names)` is the displayed one.
+ */
+declare const defensiveProfileFrom: (defending: readonly Type[]) => Record<TypeName, number>;
+//#endregion
+export { APIResource, APIResourceList, Ability, AbilityEffectChange, AbilityFlavorText, AbilityPokemon, Animated, AwesomeName, BASE_URL, BERRIES, BERRY_FIRMNESSES, BERRY_FLAVORS, Berry, BerryClient, BerryFirmness, BerryFlavor, BerryFlavorMap, BlackWhite, BrilliantDiamondShiningPearl, index_d_exports as CONSTANTS, CONTEST_TYPES, CURRENCIES, type CacheStore, ChainLink, Characteristic, type ClientOptions, type ClientStats, ContestClient, ContestComboDetail, ContestComboSets, ContestEffect, ContestFlavorText, ContestName, ContestType, Crystal, Currency, CurrencyClient, Description, DiamondPearl, DreamWorld, EGG_GROUPS, ENCOUNTER_CONDITIONS, ENCOUNTER_CONDITION_VALUES, ENCOUNTER_METHODS, ENDPOINTS, EVOLUTION_TRIGGERS, Effect, EggGroup, Emerald, Encounter, EncounterClient, EncounterCondition, EncounterConditionValue, EncounterMethod, EncounterMethodRate, EncounterPokemonDetail, EncounterVersionDetails, Endpoint, type EtagEntry, EtagStore, type EtagStoreOptions, EvolutionChain, EvolutionClient, EvolutionDetail, type EvolutionRequirement, type EvolutionStep, EvolutionTimeOfDay, EvolutionTrigger, EvolutionTriggerName, type FetchLike, FireredLeafgreen, type FlattenOptions, FlavorBerryMap, FlavorText, type FormatOptions, GENDERS, GENERATIONS, GROWTH_RATES, GameClient, Gender, Generation, GenerationGameIndex, GenerationIIISprites, GenerationIIITypeSprites, GenerationIISprites, GenerationISprites, GenerationIVSprites, GenerationIVTypeSprites, GenerationIXSprites, GenerationIXTypeSprites, GenerationName, type GenerationScope, GenerationVIIISprites, GenerationVIIITypeSprites, GenerationVIISprites, GenerationVIITypeSprites, GenerationVISprites, GenerationVITypeSprites, GenerationVSprites, GenerationVTypeSprites, GenerationViiIcons, GenerationViiiIcons, Genus, Gold, GrowthRate, GrowthRateExperienceLevel, HeartgoldSoulsilver, Home, ITEM_ATTRIBUTES, ITEM_CATEGORIES, ITEM_FLING_EFFECTS, ITEM_POCKETS, Item, ItemAttribute, ItemCategory, ItemClient, ItemFlingEffect, ItemHolderPokemon, ItemHolderPokemonVersionDetail, ItemPocket, ItemPrice, ItemSprites, LANGUAGES, Language, type ListFn, type ListMethodName, type ListPage, type LocalizeOptions, type Localized, Location, LocationArea, LocationAreaEncounter, LocationClient, type LogCancelledPayload, type LogErrorPayload, type LogRequestPayload, type LogResponsePayload, type LogRetryPayload, type Logger, MOVE_AILMENTS, MOVE_BATTLE_STYLES, MOVE_CATEGORIES, MOVE_DAMAGE_CLASSES, MOVE_LEARN_METHODS, MOVE_TARGETS, Machine, MachineClient, MachineVersionDetail, MainClient, MemoryCache, type MemoryCacheOptions, Move, MoveAilment, MoveBattleStyle, MoveBattleStylePreference, MoveCategory, MoveClient, MoveDamageClass, MoveFlavorText, MoveLearnMethod, MoveMetaData, MoveStatAffect, MoveStatAffectSets, MoveStatChange, MoveTarget, NATURES, Name, NamedAPIResource, NamedAPIResourceList, Nature, NaturePokeathlonStatAffect, NaturePokeathlonStatAffectSets, NatureStatAffectSets, NatureStatChange, OfficialArtwork, OmegarubyAlphasapphire, OtherPokemonSprites, PAL_PARK_AREAS, POKEATHLON_STATS, POKEDEXES, POKEMON_COLORS, POKEMON_HABITATS, POKEMON_SHAPES, type PaginateOptions, PalParkArea, PalParkEncounterArea, PalParkEncounterSpecies, PastMoveStatValues, Platinum, PokeathlonStat, Pokedex, Pokemon, PokemonAbility, PokemonClient, PokemonColor, PokemonCries, PokemonEncounter, PokemonEntry, PokemonForm, PokemonFormCondition, PokemonFormGenerationVIIISprites, PokemonFormSprites, PokemonFormVersionSprites, PokemonHabitat, PokemonHeldItem, PokemonHeldItemVersion, PokemonMove, PokemonMoveVersion, PokemonPastAbility, PokemonPastAbilitySlot, PokemonPastStat, PokemonPastType, PokemonShape, PokemonSpecies, PokemonSpeciesDexEntry, PokemonSpeciesGender, PokemonSpeciesVariety, type PokemonSpriteOptions, PokemonSprites, PokemonStat, PokemonType, PokenodeError, REGIONS, REQUIREMENT_PHRASES, RedBlue, Region, type RequestScope, type RequirementPhrases, type ResolveOptions, type ResourceLink, type ResourceNamer, type RetryOptions, RubySapphire, STATS, ScarletViolet, Showdown, Silver, type SpriteVariant, Stat, SuperContestEffect, TYPES, Type, TypeGameSprites, TypeName, TypePokemon, TypeRelations, TypeRelationsPast, TypeSprites, UltraSunUltraMoon, UtilityClient, VERSIONS, VERSION_GROUPS, VerboseEffect, Version, VersionEncounterDetail, VersionGameIndex, VersionGroup, VersionGroupFlavorText, VersionSprites, WebStorageCache, type WebStorageCacheOptions, type WebStorageLike, XY, Yellow, consoleLogger, defensiveProfile, defensiveProfileFrom, effectiveness, flattenChain, formatRequirements, getPokemonSpriteUrl, localize, localizeAll, pathTo, relationsFor, requirementPhrases, requirementsOf, resourceId };
 //# sourceMappingURL=index.d.ts.map