pokenode-ts 2.1.0 → 2.2.0

package/lib/index.d.cts

@@ -1,5 +1,5 @@
 //#endregion
-//#region src/models/Common/resource.d.ts
+//#region src/models/common/resource.d.ts
 /**
  * Marks what a link points at.
  *
@@ -78,7 +78,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.
  */
@@ -89,7 +89,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.
  */
@@ -108,7 +108,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.
  */
@@ -119,7 +119,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.
  */
@@ -130,10 +130,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 {
@@ -149,7 +150,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. */
@@ -165,6 +167,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 {
@@ -178,7 +181,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.
  *
@@ -211,10 +214,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 {
@@ -274,6 +278,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 {
@@ -287,12 +292,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 {
@@ -304,7 +310,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.
  */
@@ -405,6 +411,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 {
@@ -440,7 +447,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.
@@ -470,11 +477,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 {
@@ -495,6 +503,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 {
@@ -514,7 +523,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.
  */
@@ -654,7 +663,7 @@ interface Type {
   sprites: TypeSprites;
 }
 //#endregion
-//#region src/models/Evolution/evolution.d.ts
+//#region src/models/evolution/evolution.d.ts
 /**
  * ## Evolution Detail
  * All details regarding the specific details of the referenced Pokémon species evolution.
@@ -773,6 +782,7 @@ interface EvolutionChain {
  * 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 {
@@ -786,7 +796,7 @@ interface EvolutionTrigger {
   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.
  */
@@ -797,12 +807,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 {
@@ -824,20 +835,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 {
@@ -862,11 +873,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 {
@@ -880,7 +892,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.
  */
@@ -893,6 +905,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 {
@@ -910,11 +923,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 {
@@ -930,11 +944,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 {
@@ -966,10 +981,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 {
@@ -1014,7 +1030,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
@@ -1070,13 +1086,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 {
@@ -1924,11 +1941,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 {
@@ -1986,11 +2004,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 {
@@ -2013,7 +2032,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.
@@ -2079,6 +2098,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 {
@@ -2092,6 +2112,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 {
@@ -2189,6 +2210,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 {
@@ -2245,11 +2267,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 {
@@ -2273,12 +2296,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 = {
@@ -2298,10 +2322,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 {
@@ -2337,7 +2362,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.
  */
@@ -2350,7 +2375,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.
  */
@@ -2361,7 +2386,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.
@@ -2380,7 +2405,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.
  */
@@ -2391,7 +2416,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.
  */
@@ -2404,7 +2429,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.
  */
@@ -2437,7 +2462,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,
@@ -2546,7 +2571,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;
 }
 /**
@@ -2566,6 +2594,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.
@@ -2665,7 +2737,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. */
@@ -2694,15 +2766,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.
@@ -2730,11 +2837,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;
 }
 /**
@@ -2746,13 +2854,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: {
@@ -3318,7 +3419,7 @@ declare const MOVE_TARGETS: {
   readonly ALL_ALLIES: 15;
 };
 //#endregion
-//#region src/constants/pokemons.d.ts
+//#region src/constants/pokemon.d.ts
 declare const EGG_GROUPS: {
   readonly MONSTER: 1;
   readonly WATER1: 2;
@@ -3455,6 +3556,13 @@ declare const TYPES: {
   readonly SHADOW: 10002;
 };
 //#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: {
   readonly JA_HRKT: 1;
@@ -3470,6 +3578,7 @@ 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 };
@@ -3481,6 +3590,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.
@@ -3502,49 +3651,149 @@ 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.
+ * ## 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;
+  /**
+   * 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. A {@link CacheStore} that does not implement
-   * `clear` is left alone.
+   * 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:
    *
-   * The URL is joined by concatenation: `new URL(path, base)` would discard the
-   * base's own `/api/v2` path.
+   * ```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.
+   *
+   * ```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.
    *
@@ -3553,7 +3802,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.
    *
@@ -3566,6 +3815,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
@@ -3573,10 +3881,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 {
@@ -3605,10 +3914,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 {
@@ -3633,8 +3943,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 {
@@ -3651,10 +3962,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 {
@@ -3683,9 +3995,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 {
@@ -3706,11 +4019,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 {
@@ -3745,12 +4059,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 {
@@ -3791,11 +4106,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 {
@@ -3830,8 +4146,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 {
@@ -3846,14 +4163,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 {
@@ -3906,23 +4224,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 {
@@ -4026,9 +4345,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 {
@@ -4039,19 +4359,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>>;
 }
@@ -4061,26 +4382,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;
@@ -4093,9 +4419,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
@@ -4115,11 +4439,48 @@ 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/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>;
+}
+/**
+ * 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; // 'イーブイ'
+ * ```
+ *
+ * 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. Filter first when you want a
+ * particular version.
+ *
+ * @returns The entry, or `undefined` when that language is absent. Which
+ *   language to try instead is the caller's decision, so nothing is guessed here.
+ */
+declare const localize: <T extends Localized>(entries: readonly T[], language?: string) => T | undefined;
+//#endregion
 //#region src/utils/sprites.d.ts
 /**
  * ## Sprite Variant
@@ -4180,5 +4541,5 @@ 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 };
+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, type EtagEntry, EtagStore, type EtagStoreOptions, 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, type ListFn, type ListMethodName, type ListPage, 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, RedBlue, Region, type RequestScope, type ResolveOptions, type ResourceLink, type RetryOptions, RubySapphire, STATS, ScarletViolet, Showdown, Silver, type 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, localize };
 //# sourceMappingURL=index.d.cts.map