pokenode-ts 2.0.0 → 2.2.0

package/lib/index.d.ts

@@ -1,19 +1,42 @@
-//#region src/models/Common/resource.d.ts
+//#region src/models/common/resource.d.ts
+/**
+ * Marks what a link points at.
+ *
+ * A type parameter that appears nowhere in an interface is not inferable, and
+ * every instantiation of it stays mutually assignable — so `NamedAPIResource<T>`
+ * needs somewhere to carry `T`. This key exists only in the type system: it is
+ * never present at runtime, and reading it is not the point.
+ *
+ * A `unique symbol` is nominal per declaration, and the package emits one set of
+ * declarations per module format — so a link crossing the ESM/CJS boundary keeps
+ * assigning structurally but stops carrying `T`, and comes back as `unknown`.
+ * Documented in `docs/src/clients/utility-client.md`, alongside the same split
+ * behind `PokenodeError.isPokenodeError`.
+ */
+declare const RESOURCE_TYPE: unique symbol;
 /**
  * The name and the URL of the referenced resource.
+ *
+ * @template T - What the URL resolves to. Defaults to `unknown`, so a link whose
+ *   target has not been declared still type-checks; pass it to
+ *   {@link UtilityClient.getResourceByUrl} and the resource comes back typed.
  */
-interface NamedAPIResource {
+interface NamedAPIResource<T = unknown> {
   /** The name of the referenced resource. */
   name: string;
   /** The URL of the referenced resource. */
   url: string;
+  /** Phantom. Never present at runtime. */
+  readonly [RESOURCE_TYPE]?: T;
 }
 /**
  * Calling any API endpoint without a resource ID or name will return a paginated list of available resources for that API.
  * By default, a list "page" will contain up to 20 resources. If you would like to change this just add a 'limit' query parameter
  * to the GET request, e.g. ?=60. You can use 'offset' to move to the next page, e.g. ?limit=60&offset=60.
+ *
+ * @template T - What the listed links resolve to.
  */
-interface NamedAPIResourceList {
+interface NamedAPIResourceList<T = unknown> {
   /** The total number of resources available from this API. */
   count: number;
   /** The URL for the next page in the list. */
@@ -21,76 +44,40 @@ interface NamedAPIResourceList {
   /** The URL for the previous page in the list. */
   previous: string | null;
   /** A list of named API resources. */
-  results: NamedAPIResource[];
-}
-/** A URL for another resource in the API. */
-interface APIResource {
-  /** The URL of the referenced resource. */
-  url: string;
-}
-//#endregion
-//#region src/models/Common/description.d.ts
-/**
- * The localized description for an API resource in a specific language.
- */
-interface Description {
-  /** The localized description for an API resource in a specific language. */
-  description: string;
-  /** The language this name is in. */
-  language: NamedAPIResource;
-}
-//#endregion
-//#region src/models/Common/effect.d.ts
-/**
- * The localized effect text for an API resource in a specific language.
- */
-interface Effect {
-  /** The localized effect text for an API resource in a specific language. */
-  effect: string;
-  /** The language this effect is in. */
-  language: NamedAPIResource;
-}
-//#endregion
-//#region src/models/Common/encounter.d.ts
-/** Information about a Pokémon encounter. */
-interface Encounter {
-  /** The lowest level the Pokémon could be encountered at. */
-  min_level: number;
-  /** The highest level the Pokémon could be encountered at. */
-  max_level: number;
-  /** A list of condition values that must be in effect for this encounter to occur. */
-  condition_values: NamedAPIResource[];
-  /** Percent chance that this encounter will occur. */
-  chance: number;
-  /** The method by which this encounter happens. */
-  method: NamedAPIResource;
+  results: NamedAPIResource<T>[];
 }
-//#endregion
-//#region src/models/Common/flavor-text.d.ts
 /**
- * The localized flavor text for an API resource in a specific language.
+ * A URL for another resource in the API.
+ *
+ * @template T - What the URL resolves to.
  */
-interface FlavorText {
-  /** The localized flavor text for an API resource in a specific language. */
-  flavor_text: string;
-  /** The language this name is in. */
-  language: NamedAPIResource;
-  /** The game version this flavor text appears in. */
-  version: NamedAPIResource;
+interface APIResource<T = unknown> {
+  /** The URL of the referenced resource. */
+  url: string;
+  /** Phantom. Never present at runtime. */
+  readonly [RESOURCE_TYPE]?: T;
 }
-//#endregion
-//#region src/models/Common/generation.d.ts
 /**
- * The generation relevant to this game index.
+ * A paginated list whose entries are identified by URL alone.
+ *
+ * The `machine`, `contest-effect`, `super-contest-effect`, `evolution-chain` and
+ * `characteristic` sections have no names to list, so their entries carry a `url`
+ * and nothing else.
+ *
+ * @template T - What the listed links resolve to.
  */
-interface GenerationGameIndex {
-  /** The internal id of an API resource within game data. */
-  game_index: number;
-  /** The generation relevant to this game index. */
-  generation: NamedAPIResource;
+interface APIResourceList<T = unknown> {
+  /** The total number of resources available from this API. */
+  count: number;
+  /** The URL for the next page in the list. */
+  next: string | null;
+  /** The URL for the previous page in the list. */
+  previous: string | null;
+  /** A list of unnamed API resources. */
+  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.
  */
@@ -98,10 +85,10 @@ interface Name {
   /** The localized name for an API resource in a specific language. */
   name: string;
   /** The language this name is in. */
-  language: NamedAPIResource;
+  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.
  */
@@ -120,154 +107,117 @@ interface Language {
   names: Name[];
 }
 //#endregion
-//#region src/models/Common/machine.d.ts
+//#region src/models/common/description.d.ts
 /**
- * The machine that teaches a move from an item.
+ * The localized description for an API resource in a specific language.
  */
-interface MachineVersionDetail {
-  /** The machine that teaches a move from an item. */
-  machine: APIResource;
-  /** The version group of this specific machine. */
-  version_group: NamedAPIResource;
+interface Description {
+  /** The localized description for an API resource in a specific language. */
+  description: string;
+  /** The language this name is in. */
+  language: NamedAPIResource<Language>;
 }
 //#endregion
-//#region src/models/Common/verbose.d.ts
+//#region src/models/common/effect.d.ts
 /**
- * The localized effect for an API resource.
+ * The localized effect text for an API resource in a specific language.
  */
-interface VerboseEffect {
+interface Effect {
   /** The localized effect text for an API resource in a specific language. */
   effect: string;
-  /** The localized effect text in brief. */
-  short_effect: string;
   /** The language this effect is in. */
-  language: NamedAPIResource;
-}
-//#endregion
-//#region src/models/Common/version.d.ts
-/**
- * Encounters and their specific details.
- */
-interface VersionEncounterDetail {
-  /** The game version this encounter happens in. */
-  version: NamedAPIResource;
-  /** The total percentage of all encounter potential. */
-  max_chance: number;
-  /** A list of encounters and their specifics. */
-  encounter_details: Encounter[];
-}
-/**
- * The internal id and version of an API resource.
- */
-interface VersionGameIndex {
-  /** The internal id of an API resource within game data. */
-  game_index: number;
-  /** The version relevant to this game index. */
-  version: NamedAPIResource;
-}
-/**
- * The flavor text of an API resource.
- */
-interface VersionGroupFlavorText {
-  /** The localized name for an API resource in a specific language. */
-  text: string;
-  /** The language this name is in. */
-  language: NamedAPIResource;
-  /** The version group which uses this flavor text. */
-  version_group: NamedAPIResource;
+  language: NamedAPIResource<Language>;
 }
 //#endregion
-//#region src/models/Berry/berry.d.ts
+//#region src/models/encounter/encounter.d.ts
 /**
- * ## Berry
- * Berries are small fruits that can provide HP and status condition restoration,
- * stat enhancement, and even damage negation when eaten by Pokémon.
+ * ## 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/Berry) for greater detail.
+ * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Wild_Pok%C3%A9mon) for greater detail.
  */
-type Berry = {
+interface EncounterMethod {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
   name: string;
-  /** Time it takes the tree to grow one stage, in hours. Berry trees go through four of these growth stages before they can be picked. */
-  growth_time: number;
-  /** The maximum number of these berries that can grow on one tree in Generation IV. */
-  max_harvest: number;
-  /** The power of the move "Natural Gift" when used with this Berry. */
-  natural_gift_power: number;
-  /** The size of this Berry, in millimeters. */
-  size: number;
-  /** The smoothness of this Berry, used in making Pokéblocks or Poffins. */
-  smoothness: number;
-  /** The speed at which this Berry dries out the soil as it grows. A higher rate means the soil dries more quickly. */
-  soil_dryness: number;
-  /** The firmness of this berry, used in making Pokéblocks or Poffins. */
-  firmness: NamedAPIResource;
-  /** A list of references to each flavor a berry can have and the potency of each of those flavors in regard to this berry. */
-  flavors: BerryFlavorMap[];
-  /** Berries are actually items. This is a reference to the item specific data for this berry. */
-  item: NamedAPIResource;
-  /** The type inherited by "Natural Gift" when used with this Berry. */
-  natural_gift_type: NamedAPIResource;
-};
-/**
- * Reference to the flavor a berry can have and the potency of each of those flavors in regard to this berry.
- */
-type BerryFlavorMap = {
-  /** How powerful the referenced flavor is for this berry. */
-  potency: number;
-  /** The referenced berry flavor. */
-  flavor: NamedAPIResource;
-};
+  /** A good value for sorting. */
+  order: number;
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+}
 /**
- * ## Berry Flavor
- * Flavors determine whether a Pokémon will benefit or suffer from eating a berry based on its nature.
+ * ## 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/Flavor) for greater detail.
+ * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Time).
  */
-type BerryFlavor = {
+interface EncounterCondition {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
-  name: "spicy" | "dry" | "sweet" | "bitter" | "sour";
-  /** A list of the berries with this flavor. */
-  berries: FlavorBerryMap[];
-  /** The contest type that correlates with this berry flavor. */
-  contest_type: NamedAPIResource;
+  name: string;
   /** The name of this resource listed in different languages. */
   names: Name[];
-};
-/**
- * Berry with the given flavor.
- */
-type FlavorBerryMap = {
-  /** How powerful the referenced flavor is for this berry. */
-  potency: number;
-  /** The berry with the referenced flavor. */
-  berry: NamedAPIResource;
-};
+  /** A list of possible values for this encounter condition. */
+  values: NamedAPIResource<EncounterConditionValue>[];
+}
 /**
- * ## Berry Firmness
- * Berries can be soft, very soft, hard, super hard or very hard.
+ * ## 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/Category:Berries_by_firmness) for greater detail.
+ * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Time).
  */
-type BerryFirmness = {
+interface EncounterConditionValue {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
-  name: "very-soft" | "soft" | "hard" | "very-hard" | "super-hard";
-  /** A list of the berries with this firmness. */
-  berries: NamedAPIResource[];
+  name: string;
+  /** The condition this encounter condition value pertains to. */
+  condition: NamedAPIResource<EncounterCondition>;
   /** The name of this resource listed in different languages. */
   names: Name[];
-};
+}
+//#endregion
+//#region src/models/common/encounter.d.ts
+/**
+ * How the encountered Pokémon itself is generated, where a game constrains it.
+ *
+ * Only the games that impose such constraints populate this — guaranteed
+ * perfect IVs, forced or forbidden shininess, and Legends: Arceus alphas.
+ */
+interface EncounterPokemonDetail {
+  /** How many IVs are guaranteed to be perfect, if the game guarantees any. */
+  min_perfect_ivs: number | null;
+  /** Whether the encountered Pokémon is always shiny. */
+  always_shiny: boolean;
+  /** Whether the encountered Pokémon can never be shiny. */
+  never_shiny: boolean;
+  /** Whether the encountered Pokémon is an alpha. */
+  is_alpha: boolean;
+}
+/** Information about a Pokémon encounter. */
+interface Encounter {
+  /** The lowest level the Pokémon could be encountered at. */
+  min_level: number;
+  /** The highest level the Pokémon could be encountered at. */
+  max_level: number;
+  /** A list of condition values that must be in effect for this encounter to occur. */
+  condition_values: NamedAPIResource<EncounterConditionValue>[];
+  /** Percent chance that this encounter will occur. */
+  chance: number;
+  /** The method by which this encounter happens. */
+  method: NamedAPIResource<EncounterMethod>;
+  /** How the encountered Pokémon is generated, where the game constrains it. */
+  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 {
@@ -276,7 +226,7 @@ interface ContestType {
   /** The name for this resource. */
   name: "cool" | "beauty" | "cute" | "smart" | "tough";
   /** The berry flavor that correlates with this contest type. */
-  berry_flavor: NamedAPIResource;
+  berry_flavor: NamedAPIResource<BerryFlavor>;
   /** The name of this contest type listed in different languages. */
   names: ContestName[];
 }
@@ -289,7 +239,19 @@ interface ContestName {
   /** The color associated with this contest's name. */
   color: string;
   /** The language that this name is in. */
-  language: NamedAPIResource;
+  language: NamedAPIResource<Language>;
+}
+/**
+ * Flavor text for a contest effect, in a single language.
+ *
+ * Deliberately not the shared `FlavorText`: contest effects are not tied to a
+ * game, so the API omits the `version` that type carries.
+ */
+interface ContestFlavorText {
+  /** The localized flavor text. */
+  flavor_text: string;
+  /** The language this flavor text is in. */
+  language: NamedAPIResource<Language>;
 }
 /**
  * ## Contest Effect
@@ -305,7 +267,7 @@ interface ContestEffect {
   /** The result of this contest effect listed in different languages. */
   effect_entries: Effect[];
   /** The flavor text of this contest effect listed in different languages. */
-  flavor_text_entries: FlavorText[];
+  flavor_text_entries: ContestFlavorText[];
 }
 /**
  * ## Super Contest Effect
@@ -315,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 {
@@ -323,17 +286,18 @@ interface SuperContestEffect {
   /** The level of appeal this super contest effect has. */
   appeal: number;
   /** The flavor text of this super contest effect listed in different languages. */
-  flavor_text_entries: FlavorText[];
+  flavor_text_entries: ContestFlavorText[];
   /** A list of moves that have the effect when used in super contests. */
-  moves: NamedAPIResource[];
+  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 {
@@ -345,74 +309,379 @@ interface Currency {
   names: Name[];
 }
 //#endregion
-//#region src/models/Encounter/encounter.d.ts
+//#region src/models/item/item.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.
+ * Sprites used to depict the given item in the game.
  */
-interface EncounterMethod {
+interface ItemSprites {
+  /** The default depiction of this item. */
+  default: string;
+}
+/**
+ * Pokémon that might be found in the wild holding the given item.
+ */
+interface ItemHolderPokemon {
+  /** The Pokémon that holds this item. */
+  pokemon: NamedAPIResource<Pokemon>;
+  /** The details for the version that this item is held in by the Pokémon. */
+  version_details: ItemHolderPokemonVersionDetail[];
+}
+/**
+ * The details for the version that the given item is held in by the Pokémon.
+ */
+interface ItemHolderPokemonVersionDetail {
+  /** How often this Pokémon holds this item in this version. */
+  rarity: number;
+  /** The version that this item is held in by the Pokémon. */
+  version: NamedAPIResource<Version>;
+}
+/**
+ * ## Item Attribute
+ * Item attributes define particular aspects of items, e.g. "usable in battle" or "consumable".
+ */
+interface ItemAttribute {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
   name: string;
-  /** A good value for sorting. */
-  order: number;
-  /** The name of this resource listed in different languages. */
+  /** A list of items that have this attribute. */
+  items: NamedAPIResource<Item>[];
+  /** The name of this item attribute listed in different languages. */
   names: Name[];
+  /** The description of this item attribute listed in different languages. */
+  descriptions: Description[];
 }
 /**
- * ## 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).
+ * ## Item Category
+ * Item categories determine where items will be placed in the player's bag.
  */
-interface EncounterCondition {
+interface ItemCategory {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
   name: string;
-  /** The name of this resource listed in different languages. */
+  /** A list of items that are a part of this category. */
+  items: NamedAPIResource<Item>[];
+  /** The name of this item category listed in different languages. */
   names: Name[];
-  /** A list of possible values for this encounter condition. */
-  values: NamedAPIResource[];
+  /** The pocket items in this category would be put in. */
+  pocket: NamedAPIResource<ItemPocket>;
 }
 /**
- * ## 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).
+ * ## Item Fling Effect
+ * The various effects of the move "Fling" when used with different items.
  */
-interface EncounterConditionValue {
+interface ItemFlingEffect {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
   name: string;
-  /** The condition this encounter condition value pertains to. */
-  condition: NamedAPIResource;
+  /** The result of this fling effect listed in different languages. */
+  effect_entries: Effect[];
+  /** A list of items that have this fling effect. */
+  items: NamedAPIResource<Item>[];
+}
+/**
+ * ## Item Pocket
+ * Pockets within the player's bag used for storing items by category.
+ */
+interface ItemPocket {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** A list of item categories that are relevant to this item pocket. */
+  categories: NamedAPIResource<ItemCategory>[];
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+}
+/** The price of an item in a single version group. */
+interface ItemPrice {
+  /** The currency used for this price. */
+  currency: NamedAPIResource<Currency>;
+  /** The purchase price of this item in this version group. Null if the item cannot be purchased. */
+  purchase_price: number | null;
+  /** The sell price of this item in this version group. Null if the item cannot be sold. */
+  sell_price: number | null;
+  /** The version group these prices apply to. */
+  version_group: NamedAPIResource<VersionGroup>;
+}
+/**
+ * ## 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 {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** The purchase and sell prices of this item for each version group. */
+  prices: ItemPrice[];
+  /** The power of the move Fling when used with this item. */
+  fling_power: number | null;
+  /** The effect of the move Fling when used with this item. */
+  fling_effect: NamedAPIResource<ItemFlingEffect> | null;
+  /** A list of attributes this item has. */
+  attributes: NamedAPIResource<ItemAttribute>[];
+  /** The category of items this item falls into. */
+  category: NamedAPIResource<ItemCategory>;
+  /** The effect of this ability listed in different languages. */
+  effect_entries: VerboseEffect[];
+  /** The flavor text of this ability listed in different languages. */
+  flavor_text_entries: VersionGroupFlavorText[];
+  /** A list of game indices relevant to this item by generation. */
+  game_indices: GenerationGameIndex[];
+  /** The name of this item listed in different languages. */
+  names: Name[];
+  /** A set of sprites used to depict this item in the game. */
+  sprites: ItemSprites;
+  /** A list of Pokémon that might be found in the wild holding this item. */
+  held_by_pokemon: ItemHolderPokemon[];
+  /** An evolution chain this item requires to produce a baby during mating. */
+  baby_trigger_for: APIResource<EvolutionChain> | null;
+  /** A list of the machines related to this item. */
+  machines: MachineVersionDetail[];
+}
+//#endregion
+//#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.
+ */
+interface EncounterMethodRate {
+  /** The method in which Pokémon may be encountered in an area. */
+  encounter_method: NamedAPIResource<EncounterMethod>;
+  /** The chance of the encounter to occur on a version of the game. */
+  version_details: EncounterVersionDetails[];
+}
+/**
+ * The chance of the encounter to occur on a version of the game.
+ */
+interface EncounterVersionDetails {
+  /** The chance of an encounter to occur. */
+  rate: number;
+  /** The version of the game in which the encounter can occur with the given chance. */
+  version: NamedAPIResource<Version>;
+}
+/**
+ * Describes a pokémon encounter in a given area.
+ */
+interface PokemonEncounter {
+  /** The Pokémon being encountered. */
+  pokemon: NamedAPIResource<Pokemon>;
+  /** A list of versions and encounters with Pokémon that might happen in the referenced location area. */
+  version_details: VersionEncounterDetail[];
+}
+//#endregion
+//#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 {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** The region this location can be found in. */
+  region: NamedAPIResource<Region> | null;
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+  /** A list of game indices relevant to this location by generation. */
+  game_indices: GenerationGameIndex[];
+  /** Areas that can be found within this location. */
+  areas: NamedAPIResource<LocationArea>[];
+}
+/**
+ * ## 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 {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** The internal id of an API resource within game data. */
+  game_index: number;
+  /** A list of methods in which Pokémon may be encountered in this area and how likely the method will occur depending on the version of the game. */
+  encounter_method_rates: EncounterMethodRate[];
+  /** The region this location area can be found in. */
+  location: NamedAPIResource<Location>;
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+  /** A list of Pokémon that can be encountered in this area along with version specific details about the encounter. */
+  pokemon_encounters: PokemonEncounter[];
+}
+//#endregion
+//#region src/models/pokemon/type.d.ts
+/**
+ * Details of Pokémon for a specific type.
+ */
+interface TypePokemon {
+  /** The order the Pokémon's types are listed in. */
+  slot: number;
+  /** The Pokémon that has the referenced type. */
+  pokemon: NamedAPIResource<Pokemon>;
+}
+/**
+ * Detail of how effective a type is toward others and vice versa.
+ */
+interface TypeRelations {
+  /** A list of types this type has no effect on. */
+  no_damage_to: NamedAPIResource<Type>[];
+  /** A list of types this type is not very effective against. */
+  half_damage_to: NamedAPIResource<Type>[];
+  /** A list of types this type is very effective against. */
+  double_damage_to: NamedAPIResource<Type>[];
+  /** A list of types that have no effect on this type. */
+  no_damage_from: NamedAPIResource<Type>[];
+  /** A list of types that are not very effective against this type. */
+  half_damage_from: NamedAPIResource<Type>[];
+  /** A list of types that are very effective against this type. */
+  double_damage_from: NamedAPIResource<Type>[];
+}
+/**
+ * Details of how effective this type was toward others and vice versa in a previous generation.
+ */
+interface TypeRelationsPast {
+  /** The last generation in which the referenced type had the listed damage relations. */
+  generation: NamedAPIResource<Generation>;
+  /** The damage relations the referenced type had up to and including the listed generation. */
+  damage_relations: TypeRelations;
+}
+/**
+ * The pair of icons a single game uses to depict a type.
+ *
+ * `symbol_icon` is the type's bare glyph and `name_icon` spells the name out;
+ * games that only ever shipped one of the two leave the other `null`.
+ */
+interface TypeGameSprites {
+  /** The icon spelling out the type's name. */
+  name_icon: string | null;
+  /** The icon showing the type's symbol alone. */
+  symbol_icon: string | null;
+}
+/** Generation-III type icons, by game. */
+interface GenerationIIITypeSprites {
+  colosseum: TypeGameSprites;
+  emerald: TypeGameSprites;
+  "firered-leafgreen": TypeGameSprites;
+  "ruby-sapphire": TypeGameSprites;
+  xd: TypeGameSprites;
+}
+/** Generation-IV type icons, by game. */
+interface GenerationIVTypeSprites {
+  "diamond-pearl": TypeGameSprites;
+  "heartgold-soulsilver": TypeGameSprites;
+  platinum: TypeGameSprites;
+}
+/** Generation-V type icons, by game. */
+interface GenerationVTypeSprites {
+  "black-2-white-2": TypeGameSprites;
+  "black-white": TypeGameSprites;
+}
+/** Generation-VI type icons, by game. */
+interface GenerationVITypeSprites {
+  "omega-ruby-alpha-sapphire": TypeGameSprites;
+  "x-y": TypeGameSprites;
+}
+/** Generation-VII type icons, by game. */
+interface GenerationVIITypeSprites {
+  "lets-go-pikachu-lets-go-eevee": TypeGameSprites;
+  "sun-moon": TypeGameSprites;
+  "ultra-sun-ultra-moon": TypeGameSprites;
+}
+/** Generation-VIII type icons, by game. */
+interface GenerationVIIITypeSprites {
+  "brilliant-diamond-shining-pearl": TypeGameSprites;
+  "legends-arceus": TypeGameSprites;
+  "sword-shield": TypeGameSprites;
+}
+/** Generation-IX type icons, by game. */
+interface GenerationIXTypeSprites {
+  "scarlet-violet": TypeGameSprites;
+}
+/**
+ * The icons used to depict a type, by generation and game.
+ *
+ * Generations I and II are absent: neither displayed type icons in-game.
+ */
+interface TypeSprites {
+  /** Generation-III type icons. */
+  "generation-iii": GenerationIIITypeSprites;
+  /** Generation-IV type icons. */
+  "generation-iv": GenerationIVTypeSprites;
+  /** Generation-V type icons. */
+  "generation-v": GenerationVTypeSprites;
+  /** Generation-VI type icons. */
+  "generation-vi": GenerationVITypeSprites;
+  /** Generation-VII type icons. */
+  "generation-vii": GenerationVIITypeSprites;
+  /** Generation-VIII type icons. */
+  "generation-viii": GenerationVIIITypeSprites;
+  /** Generation-IX type icons. */
+  "generation-ix": GenerationIXTypeSprites;
+}
+/**
+ * ## Type
+ * Types are properties for Pokémon and their moves.
+ * Each type has three properties: which types of Pokémon it is super effective against,
+ * which types of Pokémon it is not very effective against, and which types of Pokémon it is completely ineffective against.
+ */
+interface Type {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** A detail of how effective this type is toward others and vice versa. */
+  damage_relations: TypeRelations;
+  /** A list of details of how effective this type was toward others and vice versa in previous generations. */
+  past_damage_relations: TypeRelationsPast[];
+  /** A list of game indices relevant to this item by generation. */
+  game_indices: GenerationGameIndex[];
+  /** The generation this type was introduced in. */
+  generation: NamedAPIResource<Generation>;
+  /** The class of damage inflicted by this type. */
+  move_damage_class: NamedAPIResource<MoveDamageClass>;
   /** The name of this resource listed in different languages. */
   names: Name[];
+  /** A list of details of Pokémon that have this type. */
+  pokemon: TypePokemon[];
+  /** A list of moves that have this type. */
+  moves: NamedAPIResource<Move>[];
+  /** The icons used to depict this type, by generation and game. */
+  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.
  */
 interface EvolutionDetail {
   /** The item required to cause evolution into this Pokémon species. */
-  item: NamedAPIResource | null;
+  item: NamedAPIResource<Item> | null;
   /** The type of event that triggers evolution into this Pokémon species. */
-  trigger: NamedAPIResource;
+  trigger: NamedAPIResource<EvolutionTrigger>;
   /** The gender the evolving Pokémon species must be in order to evolve into this Pokémon species. */
   gender: number | null;
   /** The item the evolving Pokémon species must be holding during the evolution trigger event to evolve into this Pokémon species. */
-  held_item: NamedAPIResource | null;
+  held_item: NamedAPIResource<Item> | null;
   /** The move that must be known by the evolving Pokémon species during the evolution trigger event in order to evolve into this Pokémon species. */
-  known_move: NamedAPIResource | null;
+  known_move: NamedAPIResource<Move> | null;
   /** The evolving Pokémon species must know a move with this type during the evolution trigger event in order to evolve into this Pokémon species. */
-  known_move_type: NamedAPIResource | null;
+  known_move_type: NamedAPIResource<Type> | null;
   /** The location the evolution must be triggered at. */
-  location: NamedAPIResource | null;
+  location: NamedAPIResource<Location> | null;
   /** The minimum required level the evolving Pokémon species must reach to evolve into this Pokémon species. */
   min_level: number | null;
   /** The minimum required level of happiness the evolving Pokémon species must have to evolve into this Pokémon species. */
@@ -424,22 +693,22 @@ interface EvolutionDetail {
   /** Whether or not it must be raining in the overworld to cause evolution into this Pokémon species. */
   needs_overworld_rain: boolean;
   /** The Pokémon species that must be in the player's party in order for the evolving Pokémon species to evolve into this Pokémon species. */
-  party_species: NamedAPIResource | null;
+  party_species: NamedAPIResource<PokemonSpecies> | null;
   /**
    * The player must have a Pokémon of this type in their party during the evolution trigger event
    * in order for the evolving Pokémon species to evolve into this Pokémon species.
    */
-  party_type: NamedAPIResource | null;
+  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" | "";
   /** Pokémon species for which this one must be traded. */
-  trade_species: NamedAPIResource | null;
+  trade_species: NamedAPIResource<PokemonSpecies> | null;
   /** Whether or not the 3DS needs to be turned upside-down as this Pokémon levels up. */
   turn_upside_down: boolean;
   /** The version group in which the evolution was introduced. */
-  version_group: NamedAPIResource;
+  version_group: NamedAPIResource<VersionGroup>;
   /**
    * Whether the evolution is the expected one in a main series game. Each Pokémon variety of a line
    * capable of evolution has exactly one default evolution per distinct variety it evolves into.
@@ -450,16 +719,16 @@ interface EvolutionDetail {
   /** Whether or not multiplayer link play is needed to evolve into this species, e.g. Union Circle. */
   needs_multiplayer: boolean;
   /** The region this evolution must occur in. */
-  region: NamedAPIResource | null;
+  region: NamedAPIResource<Region> | null;
   /** The form the evolving Pokémon must be in for this evolution to occur. */
-  base_form: NamedAPIResource | null;
+  base_form: NamedAPIResource<PokemonForm> | null;
   /** The form this evolution produces. */
-  evolved_form: NamedAPIResource | null;
+  evolved_form: NamedAPIResource<PokemonForm> | null;
   /**
    * The move that must be used by the evolving Pokémon species during the evolution trigger event
    * in order to evolve into this Pokémon species.
    */
-  used_move: NamedAPIResource | null;
+  used_move: NamedAPIResource<Move> | null;
   /** The minimum number of times `used_move` must be used to evolve into this species. */
   min_move_count: number | null;
   /** The minimum number of steps that must be taken to evolve into this species. */
@@ -479,7 +748,7 @@ interface ChainLink {
   /** Whether or not this link is for a baby Pokémon. This would only ever be true on the base link. */
   is_baby: boolean;
   /** The Pokémon species at this point in the evolution chain. */
-  species: NamedAPIResource;
+  species: NamedAPIResource<PokemonSpecies>;
   /** All details regarding the specific details of the referenced Pokémon species evolution. */
   evolution_details: EvolutionDetail[];
   /** A list of chain objects. */
@@ -499,7 +768,7 @@ interface EvolutionChain {
    * The item that a Pokémon would be holding when mating that would trigger
    * the egg hatching a baby Pokémon rather than a basic Pokémon.
    */
-  baby_trigger_item: NamedAPIResource | null;
+  baby_trigger_item: NamedAPIResource<Item> | null;
   /**
    * The base chain link object. Each link contains evolution details for a Pokémon in the chain.
    * Each link references the next Pokémon in the natural evolution order.
@@ -512,6 +781,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 {
@@ -522,38 +792,10 @@ interface EvolutionTrigger {
   /** 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[];
-}
-//#endregion
-//#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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** A list of abilities that were introduced in this generation. */
-  abilities: NamedAPIResource[];
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** The main region travelled in this generation. */
-  main_region: NamedAPIResource;
-  /** A list of moves that were introduced in this generation. */
-  moves: NamedAPIResource[];
-  /** A list of Pokémon species that were introduced in this generation. */
-  pokemon_species: NamedAPIResource[];
-  /** A list of types that were introduced in this generation. */
-  types: NamedAPIResource[];
-  /** A list of version groups that were introduced in this generation. */
-  version_groups: NamedAPIResource[];
+  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.
  */
@@ -561,15 +803,16 @@ interface PokemonEntry {
   /** The index of this Pokémon species entry within the Pokédex. */
   entry_number: number;
   /** The Pokémon species being encountered. */
-  pokemon_species: NamedAPIResource;
+  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 {
@@ -586,288 +829,39 @@ interface Pokedex {
   /** A list of Pokémon catalogued in this Pokédex and their indexes. */
   pokemon_entries: PokemonEntry[];
   /** The region this Pokédex catalogues Pokémon for. */
-  region: NamedAPIResource | null;
+  region: NamedAPIResource<Region> | null;
   /** A list of version groups this Pokédex is relevant to. */
-  version_groups: NamedAPIResource[];
+  version_groups: NamedAPIResource<VersionGroup>[];
 }
 //#endregion
-//#region src/models/Game/version.d.ts
+//#region src/models/location/palpark.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.
+ * ## 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 Version {
+interface PalParkArea {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
   name: string;
   /** The name of this resource listed in different languages. */
   names: Name[];
-  /** The version group this version belongs to. */
-  version_group: NamedAPIResource;
+  /** A list of Pokémon encountered in this pal park area along with details. */
+  pokemon_encounters: PalParkEncounterSpecies[];
 }
 /**
- * ## Version Group
- * Version groups categorize highly similar versions of the games.
- */
-interface VersionGroup {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** Order for sorting. Almost by date of release, except similar versions are grouped together. */
-  order: number;
-  /** The generation this version was introduced in. */
-  generation: NamedAPIResource;
-  /** A list of methods in which Pokémon can learn moves in this version group. */
-  move_learn_methods: NamedAPIResource[];
-  /** A list of Pokédexes introduced in this version group. */
-  pokedexes: NamedAPIResource[];
-  /** A list of regions that can be visited in this version group. */
-  regions: NamedAPIResource[];
-  /** The versions this version group owns. */
-  versions: NamedAPIResource[];
-}
-//#endregion
-//#region src/models/Item/item.d.ts
-/**
- * Sprites used to depict the given item in the game.
- */
-interface ItemSprites {
-  /** The default depiction of this item. */
-  default: string;
-}
-/**
- * Pokémon that might be found in the wild holding the given item.
- */
-interface ItemHolderPokemon {
-  /** The Pokémon that holds this item. */
-  pokemon: NamedAPIResource;
-  /** The details for the version that this item is held in by the Pokémon. */
-  version_details: ItemHolderPokemonVersionDetail[];
-}
-/**
- * The details for the version that the given item is held in by the Pokémon.
- */
-interface ItemHolderPokemonVersionDetail {
-  /** How often this Pokémon holds this item in this version. */
-  rarity: number;
-  /** The version that this item is held in by the Pokémon. */
-  version: NamedAPIResource;
-}
-/**
- * ## Item Attribute
- * Item attributes define particular aspects of items, e.g. "usable in battle" or "consumable".
- */
-interface ItemAttribute {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** A list of items that have this attribute. */
-  items: NamedAPIResource[];
-  /** The name of this item attribute listed in different languages. */
-  names: Name[];
-  /** The description of this item attribute listed in different languages. */
-  descriptions: Description[];
-}
-/**
- * ## Item Category
- * Item categories determine where items will be placed in the player's bag.
- */
-interface ItemCategory {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** A list of items that are a part of this category. */
-  items: NamedAPIResource[];
-  /** The name of this item category listed in different languages. */
-  names: Name[];
-  /** The pocket items in this category would be put in. */
-  pocket: NamedAPIResource;
-}
-/**
- * ## Item Fling Effect
- * The various effects of the move "Fling" when used with different items.
- */
-interface ItemFlingEffect {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** The result of this fling effect listed in different languages. */
-  effect_entries: Effect[];
-  /** A list of items that have this fling effect. */
-  items: NamedAPIResource[];
-}
-/**
- * ## Item Pocket
- * Pockets within the player's bag used for storing items by category.
- */
-interface ItemPocket {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** A list of item categories that are relevant to this item pocket. */
-  categories: NamedAPIResource[];
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-}
-/** The price of an item in a single version group. */
-interface ItemPrice {
-  /** The currency used for this price. */
-  currency: NamedAPIResource;
-  /** The purchase price of this item in this version group. Null if the item cannot be purchased. */
-  purchase_price: number | null;
-  /** The sell price of this item in this version group. Null if the item cannot be sold. */
-  sell_price: number | null;
-  /** The version group these prices apply to. */
-  version_group: NamedAPIResource;
-}
-/**
- * ## 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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** The purchase and sell prices of this item for each version group. */
-  prices: ItemPrice[];
-  /** The power of the move Fling when used with this item. */
-  fling_power: number | null;
-  /** The effect of the move Fling when used with this item. */
-  fling_effect: NamedAPIResource | null;
-  /** A list of attributes this item has. */
-  attributes: NamedAPIResource[];
-  /** The category of items this item falls into. */
-  category: NamedAPIResource;
-  /** The effect of this ability listed in different languages. */
-  effect_entries: VerboseEffect[];
-  /** The flavor text of this ability listed in different languages. */
-  flavor_text_entries: VersionGroupFlavorText[];
-  /** A list of game indices relevant to this item by generation. */
-  game_indices: GenerationGameIndex[];
-  /** The name of this item listed in different languages. */
-  names: Name[];
-  /** A set of sprites used to depict this item in the game. */
-  sprites: ItemSprites;
-  /** A list of Pokémon that might be found in the wild holding this item. */
-  held_by_pokemon: ItemHolderPokemon[];
-  /** An evolution chain this item requires to produce a baby during mating. */
-  baby_trigger_for: APIResource | null;
-  /** A list of the machines related to this item. */
-  machines: MachineVersionDetail[];
-}
-//#endregion
-//#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.
- */
-interface EncounterMethodRate {
-  /** The method in which Pokémon may be encountered in an area. */
-  encounter_method: NamedAPIResource;
-  /** The chance of the encounter to occur on a version of the game. */
-  version_details: EncounterVersionDetails[];
-}
-/**
- * The chance of the encounter to occur on a version of the game.
- */
-interface EncounterVersionDetails {
-  /** The chance of an encounter to occur. */
-  rate: number;
-  /** The version of the game in which the encounter can occur with the given chance. */
-  version: NamedAPIResource;
-}
-/**
- * Describes a pokémon encounter in a given area.
- */
-interface PokemonEncounter {
-  /** The Pokémon being encountered. */
-  pokemon: NamedAPIResource;
-  /** A list of versions and encounters with Pokémon that might happen in the referenced location area. */
-  version_details: VersionEncounterDetail[];
-}
-//#endregion
-//#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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** The region this location can be found in. */
-  region: NamedAPIResource | null;
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** A list of game indices relevant to this location by generation. */
-  game_indices: GenerationGameIndex[];
-  /** Areas that can be found within this location. */
-  areas: NamedAPIResource[];
-}
-/**
- * ## 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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** The internal id of an API resource within game data. */
-  game_index: number;
-  /** A list of methods in which Pokémon may be encountered in this area and how likely the method will occur depending on the version of the game. */
-  encounter_method_rates: EncounterMethodRate[];
-  /** The region this location area can be found in. */
-  location: NamedAPIResource;
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** A list of Pokémon that can be encountered in this area along with version specific details about the encounter. */
-  pokemon_encounters: PokemonEncounter[];
-}
-//#endregion
-//#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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** A list of Pokémon encountered in this pal park area along with details. */
-  pokemon_encounters: PalParkEncounterSpecies[];
-}
-/**
- * Details of a Pokémon encountered in this Pal Park area.
+ * Details of a Pokémon encountered in this Pal Park area.
  */
 interface PalParkEncounterSpecies {
   /** The base score given to the player when this Pokémon is caught during a pal park run. */
@@ -875,181 +869,29 @@ interface PalParkEncounterSpecies {
   /** The base rate for encountering this Pokémon in this pal park area. */
   rate: number;
   /** The Pokémon species being encountered. */
-  pokemon_species: NamedAPIResource;
-}
-//#endregion
-//#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 = {
-  /** The identifier for this resource. */
-  id: number;
-  /** A list of locations that can be found in this region. */
-  locations: NamedAPIResource[];
-  /** The name for this resource. */
-  name: string;
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** The generation this region was introduced in. */
-  main_generation: NamedAPIResource;
-  /** A list of Pokédexes that catalogue Pokémon in this region. */
-  pokedexes: NamedAPIResource[];
-  /** A list of version groups where this region can be visited. */
-  version_groups: NamedAPIResource[];
-};
-//#endregion
-//#region src/models/Machine/machine.d.ts
-/**
- * ## Machine
- * Machines are the representation of items that teach moves to Pokémon.
- * They vary from version to version, so it is not certain that one specific
- * [TM (Technical Machine)](https://bulbapedia.bulbagarden.net/wiki/TM) or
- * [HM (Hidden Machine)](https://bulbapedia.bulbagarden.net/wiki/HM) corresponds to a single Machine.
- */
-type Machine = {
-  /** The identifier for this resource. */
-  id: number;
-  /** The TM or HM item that corresponds to this machine. */
-  item: NamedAPIResource;
-  /** The move that is taught by this machine. */
-  move: NamedAPIResource;
-  /** The version group that this machine applies to. */
-  version_group: NamedAPIResource;
-};
-//#endregion
-//#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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** Whether or not this ability originated in the main series of the video games. */
-  is_main_series: boolean;
-  /** The generation this ability originated in. */
-  generation: NamedAPIResource;
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** The effect of this ability listed in different languages. */
-  effect_entries: VerboseEffect[];
-  /** The list of previous effects this ability has had across version groups. */
-  effect_changes: AbilityEffectChange[];
-  /** The flavor text of this ability listed in different languages. */
-  flavor_text_entries: AbilityFlavorText[];
-  /** A list of Pokémon that could potentially have this ability. */
-  pokemon: AbilityPokemon[];
-}
-/**
- * Previous effects an ability has had across version groups.
- */
-interface AbilityEffectChange {
-  /** The previous effect of this ability listed in different languages. */
-  effect_entries: Effect[];
-  /** The version group in which the previous effect of this ability originated. */
-  version_group: NamedAPIResource;
-}
-/**
- * The flavor text of an ability.
- */
-interface AbilityFlavorText {
-  /** The localized name for an API resource in a specific language. */
-  flavor_text: string;
-  /** The language this text resource is in. */
-  language: NamedAPIResource;
-  /** The version group that uses this flavor text. */
-  version_group: NamedAPIResource;
-}
-/**
- * Pokémon that could potentially have the given ability.
- */
-interface AbilityPokemon {
-  /** Whether or not this is a hidden ability for the referenced Pokémon. */
-  is_hidden: boolean;
-  /**
-   * Pokémon have 3 ability 'slots' which hold references to possible abilities they could have.
-   * This is the slot of this ability for the referenced pokemon.
-   */
-  slot: number;
-  /** The Pokémon this ability could belong to. */
-  pokemon: NamedAPIResource;
-}
-//#endregion
-//#region src/models/Pokemon/characteristics.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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The remainder of the highest stat/IV divided by 5. */
-  gene_modulo: number;
-  /** The possible values of the highest stat that would result in a Pokémon receiving this characteristic when divided by 5. */
-  possible_values: number[];
-  /** The highest stat for the referenced characteristic. */
-  highest_stat: NamedAPIResource;
-  /** Descriptions for the referenced characteristic. */
-  descriptions: Description[];
+  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 {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: "monster" | "water1" | "water2" | "water3" | "bug" | "flying" | "ground" | "fairy" | "plant" | "humanshape" | "mineral" | "indeterminate" | "ditto" | "dragon" | "no-eggs";
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** A list of all Pokémon species that are members of this egg group. */
-  pokemon_species: NamedAPIResource[];
-}
-//#endregion
-//#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 {
+interface EggGroup {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
-  name: "male" | "female" | "genderless";
-  /** A list of Pokémon species that can be this gender and how likely it is that they will be. */
-  pokemon_species_details: PokemonSpeciesGender[];
-  /** A list of Pokémon species that required this gender in order for a Pokémon to evolve into them. */
-  required_for_evolution: NamedAPIResource[];
-}
-/**
- * Pokémon species that can be this gender and how likely it is that they will be.
- */
-interface PokemonSpeciesGender {
-  /** The chance of this Pokémon being female, in eighths; or -1 for genderless. */
-  rate: number;
-  /** A Pokémon species that can be the referenced gender. */
-  pokemon_species: NamedAPIResource;
+  name: "monster" | "water1" | "water2" | "water3" | "bug" | "flying" | "ground" | "fairy" | "plant" | "humanshape" | "mineral" | "indeterminate" | "ditto" | "dragon" | "no-eggs";
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+  /** A list of all Pokémon species that are members of this egg group. */
+  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.
  */
@@ -1062,6 +904,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 {
@@ -1076,13 +919,72 @@ interface GrowthRate {
   /** A list of levels and the amount of experience needed to attain them based on this growth rate. */
   levels: GrowthRateExperienceLevel[];
   /** A list of Pokémon species that gain levels at this growth rate. */
-  pokemon_species: NamedAPIResource[];
+  pokemon_species: NamedAPIResource<PokemonSpecies>[];
+}
+//#endregion
+//#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 {
+  /** The identifier for this resource. */
+  id: number;
+  /** The remainder of the highest stat/IV divided by 5. */
+  gene_modulo: number;
+  /** The possible values of the highest stat that would result in a Pokémon receiving this characteristic when divided by 5. */
+  possible_values: number[];
+  /** The highest stat for the referenced characteristic. */
+  highest_stat: NamedAPIResource<Stat>;
+  /** Descriptions for the referenced characteristic. */
+  descriptions: Description[];
+}
+//#endregion
+//#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 {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: "speed" | "power" | "skill" | "stamina" | "jump";
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+  /** A detail of natures which affect this Pokéathlon stat positively or negatively. */
+  affecting_natures: NaturePokeathlonStatAffectSets;
+}
+/**
+ * A nature and how it changes the referenced Pokéathlon stat.
+ */
+interface NaturePokeathlonStatAffect {
+  /** The maximum amount of change to the referenced Pokéathlon stat. */
+  max_change: -1 | -2 | 1 | 2;
+  /** The nature causing the change. */
+  nature: NamedAPIResource<Nature>;
+}
+/**
+ * A detail of natures which affect this Pokéathlon stat positively or negatively.
+ */
+interface NaturePokeathlonStatAffectSets {
+  /** A list of natures and how they change the referenced Pokéathlon stat. */
+  increase: NaturePokeathlonStatAffect[];
+  /** A list of natures and how they change the referenced Pokéathlon stat. */
+  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 {
@@ -1091,13 +993,13 @@ interface Nature {
   /** The name for this resource. */
   name: string;
   /** The stat decreased by 10% in Pokémon with this nature. */
-  decreased_stat: NamedAPIResource | null;
+  decreased_stat: NamedAPIResource<Stat> | null;
   /** The stat increased by 10% in Pokémon with this nature. */
-  increased_stat: NamedAPIResource | null;
+  increased_stat: NamedAPIResource<Stat> | null;
   /** The flavor hated by Pokémon with this nature. */
-  hates_flavor: NamedAPIResource | null;
+  hates_flavor: NamedAPIResource<BerryFlavor> | null;
   /** The flavor liked by Pokémon with this nature. */
-  likes_flavor: NamedAPIResource | null;
+  likes_flavor: NamedAPIResource<BerryFlavor> | null;
   /** A list of Pokéathlon stats this nature affects and by how much. */
   pokeathlon_stat_changes: NatureStatChange[];
   /** A list of battle styles and how likely a Pokémon with this nature is to use them in the Battle Palace or Battle Tent. */
@@ -1112,7 +1014,7 @@ interface NatureStatChange {
   /** The amount of change. */
   max_change: -1 | 1 | -2 | 2;
   /** The stat being affected. */
-  pokeathlon_stat: NamedAPIResource;
+  pokeathlon_stat: NamedAPIResource<PokeathlonStat>;
 }
 /**
  * Battle Style and how likely a Pokémon with the given nature is to use them
@@ -1124,52 +1026,73 @@ interface MoveBattleStylePreference {
   /** Chance of using the move, in percent, if HP is over one half. */
   high_hp_preference: number;
   /** The move battle style. */
-  move_battle_style: NamedAPIResource;
+  move_battle_style: NamedAPIResource<MoveBattleStyle>;
 }
 //#endregion
-//#region src/models/Pokemon/pokeathlon-stat.d.ts
+//#region src/models/pokemon/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.
+ * ## Stat
+ * Stats determine certain aspects of battles. Each Pokémon has a value for each stat
+ * which grows as they gain levels and can be altered momentarily by effects in battles.
  */
-interface PokeathlonStat {
+interface Stat {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
-  name: "speed" | "power" | "skill" | "stamina" | "jump";
+  name: "hp" | "attack" | "defense" | "special-attack" | "special-defense" | "speed" | "accuracy" | "evasion";
+  /** ID the games use for this stat. */
+  game_index: number;
+  /** Whether this stat only exists within a battle. */
+  is_battle_only: boolean;
+  /** A detail of moves which affect this stat positively or negatively. */
+  affecting_moves: MoveStatAffectSets;
+  /** A detail of natures which affect this stat positively or negatively. */
+  affecting_natures: NatureStatAffectSets;
+  /** A list of items which affect this stat. */
+  affecting_items: NamedAPIResource<Item>[];
+  /** A list of characteristics that are set on a Pokémon when its highest base stat is this stat. */
+  characteristics: APIResource<Characteristic>[];
+  /** The class of damage this stat is directly related to. */
+  move_damage_class: NamedAPIResource<MoveDamageClass> | null;
   /** The name of this resource listed in different languages. */
   names: Name[];
-  /** A detail of natures which affect this Pokéathlon stat positively or negatively. */
-  affecting_natures: NaturePokeathlonStatAffectSets;
 }
 /**
- * A nature and how it changes the referenced Pokéathlon stat.
+ * A detail of natures which affect the given stat positively or negatively.
  */
-interface NaturePokeathlonStatAffect {
-  /** The maximum amount of change to the referenced Pokéathlon stat. */
-  max_change: -1 | -2 | 1 | 2;
-  /** The nature causing the change. */
-  nature: NamedAPIResource;
+interface NatureStatAffectSets {
+  /** A list of natures and how they change the referenced stat. */
+  increase: NamedAPIResource<Nature>[];
+  /** A list of natures and how they change the referenced stat. */
+  decrease: NamedAPIResource<Nature>[];
 }
 /**
- * A detail of natures which affect this Pokéathlon stat positively or negatively.
+ * A move and how it changes the referenced stat.
  */
-interface NaturePokeathlonStatAffectSets {
-  /** A list of natures and how they change the referenced Pokéathlon stat. */
-  increase: NaturePokeathlonStatAffect[];
-  /** A list of natures and how they change the referenced Pokéathlon stat. */
-  decrease: NaturePokeathlonStatAffect[];
+interface MoveStatAffect {
+  /** The maximum amount of change to the referenced stat. */
+  change: -1 | -2 | 1 | 2;
+  /** The move causing the change. */
+  move: NamedAPIResource<Move>;
+}
+/**
+ * A detail of moves which affect a stat positively or negatively.
+ */
+interface MoveStatAffectSets {
+  /** A list of moves and how they change the referenced stat. */
+  increase: MoveStatAffect[];
+  /** A list of moves and how they change the referenced stat. */
+  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 {
@@ -1190,7 +1113,7 @@ interface Pokemon {
   /** A list of abilities this Pokémon could potentially have. */
   abilities: PokemonAbility[];
   /** A list of forms this Pokémon can take on. */
-  forms: NamedAPIResource[];
+  forms: NamedAPIResource<PokemonForm>[];
   /** A list of game indices relevant to this Pokémon by generation. */
   game_indices: VersionGameIndex[];
   /** A list of items this Pokémon may be holding when encountered. */
@@ -1204,7 +1127,7 @@ interface Pokemon {
   /** A set of cries used to depict this Pokémon in the game. */
   cries: PokemonCries;
   /** The species this Pokémon belongs to. */
-  species: NamedAPIResource;
+  species: NamedAPIResource<PokemonSpecies>;
   /** A list of base stat values for this Pokémon. */
   stats: PokemonStat[];
   /** A list of details showing types this Pokémon has. */
@@ -1232,7 +1155,7 @@ interface PokemonAbility {
   /** The slot this ability occupies in this Pokémon species. */
   slot: number;
   /** The ability the Pokémon may have. */
-  ability: NamedAPIResource;
+  ability: NamedAPIResource<Ability>;
 }
 /**
  * Details showing types the given Pokémon has.
@@ -1241,14 +1164,14 @@ interface PokemonType {
   /** The order the Pokémon's types are listed in. */
   slot: number;
   /** The type the referenced Pokémon has. */
-  type: NamedAPIResource;
+  type: NamedAPIResource<Type>;
 }
 /**
  * Data describing a Pokémon's types in a previous generation.
  */
 interface PokemonPastType {
   /** The generation of this Pokémon Type. */
-  generation: NamedAPIResource;
+  generation: NamedAPIResource<Generation>;
   /** The types this Pokémon had in a previous generation. */
   types: PokemonType[];
 }
@@ -1259,19 +1182,19 @@ interface PokemonPastAbilitySlot {
   /** The slot this ability occupied in this Pokémon species. */
   slot: number;
   /** The ability that occupied the slot, or `null` when the slot was empty. */
-  ability: NamedAPIResource | null;
+  ability: NamedAPIResource<Ability> | null;
 }
 /** Data describing a Pokémon's abilities in a previous generation. */
 interface PokemonPastAbility {
   /** The last generation in which the referenced Pokémon had the listed abilities. */
-  generation: NamedAPIResource;
+  generation: NamedAPIResource<Generation>;
   /** The abilities the referenced Pokémon had up to and including the listed generation. */
   abilities: PokemonPastAbilitySlot[];
 }
 /** Data describing a Pokémon's stats in a previous generation. */
 interface PokemonPastStat {
   /** The last generation in which the referenced Pokémon had the listed stats. */
-  generation: NamedAPIResource;
+  generation: NamedAPIResource<Generation>;
   /** The stats the Pokémon had up to and including the listed generation. */
   stats: PokemonStat[];
 }
@@ -1280,7 +1203,7 @@ interface PokemonPastStat {
  */
 interface PokemonHeldItem {
   /** The item the referenced Pokémon holds. */
-  item: NamedAPIResource;
+  item: NamedAPIResource<Item>;
   /** The details of the different versions in which the item is held. */
   version_details: PokemonHeldItemVersion[];
 }
@@ -1289,7 +1212,7 @@ interface PokemonHeldItem {
  */
 interface PokemonHeldItemVersion {
   /** The version in which the item is held. */
-  version: NamedAPIResource;
+  version: NamedAPIResource<Version>;
   /** How often the item is held. */
   rarity: number;
 }
@@ -1298,7 +1221,7 @@ interface PokemonHeldItemVersion {
  */
 interface PokemonMove {
   /** The move the Pokémon can learn. */
-  move: NamedAPIResource;
+  move: NamedAPIResource<Move>;
   /** The details of the version in which the Pokémon can learn the move. */
   version_group_details: PokemonMoveVersion[];
 }
@@ -1307,9 +1230,9 @@ interface PokemonMove {
  */
 interface PokemonMoveVersion {
   /** The method by which the move is learned. */
-  move_learn_method: NamedAPIResource;
+  move_learn_method: NamedAPIResource<MoveLearnMethod>;
   /** The version group in which the move is learned. */
-  version_group: NamedAPIResource;
+  version_group: NamedAPIResource<VersionGroup>;
   /** The minimum level to learn the move. */
   level_learned_at: number;
   /**
@@ -1323,7 +1246,7 @@ interface PokemonMoveVersion {
  */
 interface PokemonStat {
   /** The stat the Pokémon has. */
-  stat: NamedAPIResource;
+  stat: NamedAPIResource<Stat>;
   /** The effort points (EV) the Pokémon has in the stat. */
   effort: number;
   /** The base value of the stat. */
@@ -1347,6 +1270,8 @@ interface VersionSprites {
   "generation-vii": GenerationVIISprites;
   /** Generation-VIII Sprites of this Pokémon. */
   "generation-viii": GenerationVIIISprites;
+  /** Generation-IX Sprites of this Pokémon. */
+  "generation-ix": GenerationIXSprites;
 }
 /**
  * A set of sprites used to depict this Pokémon in the game.
@@ -1396,6 +1321,8 @@ interface DreamWorld {
 interface OfficialArtwork {
   /** The default depiction of this Pokémon from the front in battle. */
   front_default: string | null;
+  /** The shiny depiction of this Pokémon from the front in battle. */
+  front_shiny: string | null;
 }
 /** Home sprites. */
 interface Home {
@@ -1725,6 +1652,8 @@ interface UltraSunUltraMoon {
 interface GenerationVIIISprites {
   /** Icon sprites of this Pokémon. */
   icons: GenerationViiiIcons;
+  /** Brilliant Diamond and Shining Pearl sprites of this Pokémon. */
+  "brilliant-diamond-shining-pearl": BrilliantDiamondShiningPearl;
 }
 /** Generation VIII icons. */
 interface GenerationViiiIcons {
@@ -1733,13 +1662,32 @@ interface GenerationViiiIcons {
   /** The female depiction of this Pokémon from the front in battle. */
   front_female: string | null;
 }
+/** Brilliant Diamond and Shining Pearl sprites. */
+interface BrilliantDiamondShiningPearl {
+  /** The default depiction of this Pokémon from the front in battle. */
+  front_default: string | null;
+  /** The female depiction of this Pokémon from the front in battle. */
+  front_female: string | null;
+}
+/** Generation-IX Sprites */
+interface GenerationIXSprites {
+  /** Scarlet and Violet sprites of this Pokémon. */
+  "scarlet-violet": ScarletViolet;
+}
+/** Scarlet and Violet sprites. */
+interface ScarletViolet {
+  /** The default depiction of this Pokémon from the front in battle. */
+  front_default: string | null;
+  /** The female depiction of this Pokémon from the front in battle. */
+  front_female: string | null;
+}
 /**
  * ## Location Area Encounter
  * Pokémon location areas where Pokémon can be found.
  */
 interface LocationAreaEncounter {
   /** The location area the referenced Pokémon can be encountered in. */
-  location_area: NamedAPIResource;
+  location_area: NamedAPIResource<LocationArea>;
   /** A list of versions and encounters with the referenced Pokémon that might happen. */
   version_details: VersionEncounterDetail[];
 }
@@ -1757,7 +1705,7 @@ interface PokemonColor {
   /** The name of this resource listed in different languages. */
   names: Name[];
   /** A list of the Pokémon species that have this color. */
-  pokemon_species: NamedAPIResource[];
+  pokemon_species: NamedAPIResource<PokemonSpecies>[];
 }
 /**
  * ## Pokémon Form
@@ -1785,11 +1733,11 @@ interface PokemonForm {
   /** The name of this form. */
   form_name: string;
   /** The Pokémon that can take on this form. */
-  pokemon: NamedAPIResource;
+  pokemon: NamedAPIResource<Pokemon>;
   /** A set of sprites used to depict this Pokémon form in the game. */
   sprites: PokemonFormSprites;
   /** The version group this Pokémon form was introduced in. */
-  version_group: NamedAPIResource;
+  version_group: NamedAPIResource<VersionGroup>;
   /** The form specific full name of this Pokémon form, or empty if the form does not have a specific name. */
   names: Name[];
   /** The form specific form name of this Pokémon form, or empty if the form does not have a specific name. */
@@ -1811,7 +1759,7 @@ interface PokemonFormCondition {
   /** What kind of resource triggers the form, e.g. `held-item` or `ability`. */
   trigger: string;
   /** The form the Pokémon changes from, when the condition switches between two forms. */
-  base_form?: NamedAPIResource;
+  base_form?: NamedAPIResource<PokemonForm>;
 }
 /**
  * Sprites used to depict this Pokémon form in the game.
@@ -1833,6 +1781,25 @@ interface PokemonFormSprites {
   back_shiny: string | null;
   /** The shiny female depiction of this Pokémon form from the back in battle. */
   back_shiny_female: string | null;
+  /** Version Sprites of this Pokémon form. */
+  versions: PokemonFormVersionSprites;
+}
+/**
+ * Version sprites of a Pokémon form.
+ *
+ * Only the two generations that ship form-specific sprites appear, which is why
+ * this is not the Pokémon-level {@link VersionSprites}.
+ */
+interface PokemonFormVersionSprites {
+  /** Generation-VIII Sprites of this Pokémon form. */
+  "generation-viii": PokemonFormGenerationVIIISprites;
+  /** Generation-IX Sprites of this Pokémon form. */
+  "generation-ix": GenerationIXSprites;
+}
+/** Generation-VIII sprites of a Pokémon form. */
+interface PokemonFormGenerationVIIISprites {
+  /** Brilliant Diamond and Shining Pearl sprites of this Pokémon form. */
+  "brilliant-diamond-shining-pearl": BrilliantDiamondShiningPearl;
 }
 /**
  * ## Pokémon Habitat
@@ -1847,7 +1814,7 @@ interface PokemonHabitat {
   /** The name of this resource listed in different languages. */
   names: Name[];
   /** A list of the Pokémon species that can be found in this habitat. */
-  pokemon_species: NamedAPIResource[];
+  pokemon_species: NamedAPIResource<PokemonSpecies>[];
 }
 /**
  * ## Pokémon Shape
@@ -1863,7 +1830,7 @@ interface PokemonShape {
   /** The name of this resource listed in different languages. */
   names: Name[];
   /** A list of the Pokémon species that have this shape. */
-  pokemon_species: NamedAPIResource[];
+  pokemon_species: NamedAPIResource<PokemonSpecies>[];
 }
 /**
  * The "scientific" name of the Pokémon shape listed in different languages.
@@ -1872,7 +1839,7 @@ interface AwesomeName {
   /** The localized "scientific" name for an API resource in a specific language. */
   awesome_name: string;
   /** The language this "scientific" name is in. */
-  language: NamedAPIResource;
+  language: NamedAPIResource<Language>;
 }
 /**
  * ## Pokémon Species
@@ -1906,23 +1873,23 @@ interface PokemonSpecies {
   /** Whether or not this Pokémon has multiple forms and can switch between them. */
   forms_switchable: boolean;
   /** The rate at which this Pokémon species gains levels. */
-  growth_rate: NamedAPIResource;
+  growth_rate: NamedAPIResource<GrowthRate>;
   /** A list of Pokédexes and the indexes reserved within them for this Pokémon species. */
   pokedex_numbers: PokemonSpeciesDexEntry[];
   /** A list of egg groups this Pokémon species is a member of. */
-  egg_groups: NamedAPIResource[];
+  egg_groups: NamedAPIResource<EggGroup>[];
   /** The color of this Pokémon for Pokédex search. */
-  color: NamedAPIResource;
+  color: NamedAPIResource<PokemonColor>;
   /** The shape of this Pokémon for Pokédex search. */
-  shape: NamedAPIResource;
-  /** The Pokémon species that evolves into this Pokémon species. */
-  evolves_from_species: NamedAPIResource;
+  shape: NamedAPIResource<PokemonShape>;
+  /** The Pokémon species that evolves into this Pokémon species, if any. */
+  evolves_from_species: NamedAPIResource<PokemonSpecies> | null;
   /** The evolution chain this Pokémon species is a member of. */
-  evolution_chain: APIResource;
+  evolution_chain: APIResource<EvolutionChain>;
   /** The habitat this Pokémon species can be encountered in. */
-  habitat: NamedAPIResource;
+  habitat: NamedAPIResource<PokemonHabitat>;
   /** The generation this Pokémon species was introduced in. */
-  generation: NamedAPIResource;
+  generation: NamedAPIResource<Generation>;
   /** The name of this resource listed in different languages. */
   names: Name[];
   /** A list of encounters that can be had with this Pokémon species in pal park. */
@@ -1943,14 +1910,14 @@ interface Genus {
   /** The localized genus for the referenced Pokémon species. */
   genus: string;
   /** The language this genus is in. */
-  language: NamedAPIResource;
+  language: NamedAPIResource<Language>;
 }
 /** Pokédexes and the indexes reserved within them for the given Pokémon species. */
 interface PokemonSpeciesDexEntry {
   /** The index number within the Pokédex. */
   entry_number: number;
   /** The Pokédex the referenced Pokémon species can be found in. */
-  pokedex: NamedAPIResource;
+  pokedex: NamedAPIResource<Pokedex>;
 }
 /**
  * Encounter that can be had with the given Pokémon species in pal park.
@@ -1961,7 +1928,7 @@ interface PalParkEncounterArea {
   /** The base rate for encountering the referenced Pokémon in this pal park area. */
   rate: number;
   /** The pal park area where this encounter happens. */
-  area: NamedAPIResource;
+  area: NamedAPIResource<PalParkArea>;
 }
 /**
  * Pokémon that exist within this Pokémon species.
@@ -1970,129 +1937,101 @@ interface PokemonSpeciesVariety {
   /** Whether this variety is the default variety. */
   is_default: boolean;
   /** The Pokémon variety. */
-  pokemon: NamedAPIResource;
+  pokemon: NamedAPIResource<Pokemon>;
 }
 //#endregion
-//#region src/models/Pokemon/stats.d.ts
+//#region src/models/pokemon/ability.d.ts
 /**
- * ## Stat
- * Stats determine certain aspects of battles. Each Pokémon has a value for each stat
- * which grows as they gain levels and can be altered momentarily by effects in battles.
+ * ## 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 Stat {
+interface Ability {
   /** The identifier for this resource. */
   id: number;
   /** The name for this resource. */
-  name: "hp" | "attack" | "defense" | "special-attack" | "special-defense" | "speed" | "accuracy" | "evasion";
-  /** ID the games use for this stat. */
-  game_index: number;
-  /** Whether this stat only exists within a battle. */
-  is_battle_only: boolean;
-  /** A detail of moves which affect this stat positively or negatively. */
-  affecting_moves: MoveStatAffectSets;
-  /** A detail of natures which affect this stat positively or negatively. */
-  affecting_natures: NatureStatAffectSets;
-  /** A list of characteristics that are set on a Pokémon when its highest base stat is this stat. */
-  characteristics: APIResource[];
-  /** The class of damage this stat is directly related to. */
-  move_damage_class: NamedAPIResource | null;
+  name: string;
+  /** Whether or not this ability originated in the main series of the video games. */
+  is_main_series: boolean;
+  /** The generation this ability originated in. */
+  generation: NamedAPIResource<Generation>;
   /** The name of this resource listed in different languages. */
   names: Name[];
+  /** The effect of this ability listed in different languages. */
+  effect_entries: VerboseEffect[];
+  /** The list of previous effects this ability has had across version groups. */
+  effect_changes: AbilityEffectChange[];
+  /** The flavor text of this ability listed in different languages. */
+  flavor_text_entries: AbilityFlavorText[];
+  /** A list of Pokémon that could potentially have this ability. */
+  pokemon: AbilityPokemon[];
 }
 /**
- * A detail of natures which affect the given stat positively or negatively.
- */
-interface NatureStatAffectSets {
-  /** A list of natures and how they change the referenced stat. */
-  increase: NamedAPIResource[];
-  /** A list of natures and how they change the referenced stat. */
-  decrease: NamedAPIResource[];
-}
-/**
- * A move and how it changes the referenced stat.
+ * Previous effects an ability has had across version groups.
  */
-interface MoveStatAffect {
-  /** The maximum amount of change to the referenced stat. */
-  change: -1 | -2 | 1 | 2;
-  /** The move causing the change. */
-  move: NamedAPIResource;
+interface AbilityEffectChange {
+  /** The previous effect of this ability listed in different languages. */
+  effect_entries: Effect[];
+  /** The version group in which the previous effect of this ability originated. */
+  version_group: NamedAPIResource<VersionGroup>;
 }
 /**
- * A detail of moves which affect a stat positively or negatively.
+ * The flavor text of an ability.
  */
-interface MoveStatAffectSets {
-  /** A list of moves and how they change the referenced stat. */
-  increase: MoveStatAffect[];
-  /** A list of moves and how they change the referenced stat. */
-  decrease: MoveStatAffect[];
+interface AbilityFlavorText {
+  /** The localized name for an API resource in a specific language. */
+  flavor_text: string;
+  /** The language this text resource is in. */
+  language: NamedAPIResource<Language>;
+  /** The version group that uses this flavor text. */
+  version_group: NamedAPIResource<VersionGroup>;
 }
-//#endregion
-//#region src/models/Pokemon/type.d.ts
 /**
- * Details of Pokémon for a specific type.
+ * Pokémon that could potentially have the given ability.
  */
-interface TypePokemon {
-  /** The order the Pokémon's types are listed in. */
+interface AbilityPokemon {
+  /** Whether or not this is a hidden ability for the referenced Pokémon. */
+  is_hidden: boolean;
+  /**
+   * Pokémon have 3 ability 'slots' which hold references to possible abilities they could have.
+   * This is the slot of this ability for the referenced pokemon.
+   */
   slot: number;
-  /** The Pokémon that has the referenced type. */
-  pokemon: NamedAPIResource;
-}
-/**
- * Detail of how effective a type is toward others and vice versa.
- */
-interface TypeRelations {
-  /** A list of types this type has no effect on. */
-  no_damage_to: NamedAPIResource[];
-  /** A list of types this type is not very effective against. */
-  half_damage_to: NamedAPIResource[];
-  /** A list of types this type is very effective against. */
-  double_damage_to: NamedAPIResource[];
-  /** A list of types that have no effect on this type. */
-  no_damage_from: NamedAPIResource[];
-  /** A list of types that are not very effective against this type. */
-  half_damage_from: NamedAPIResource[];
-  /** A list of types that are very effective against this type. */
-  double_damage_from: NamedAPIResource[];
+  /** The Pokémon this ability could belong to. */
+  pokemon: NamedAPIResource<Pokemon>;
 }
+//#endregion
+//#region src/models/pokemon/gender.d.ts
 /**
- * Details of how effective this type was toward others and vice versa in a previous generation.
+ * ## 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 TypeRelationsPast {
-  /** The last generation in which the referenced type had the listed damage relations. */
-  generation: NamedAPIResource;
-  /** The damage relations the referenced type had up to and including the listed generation. */
-  damage_relations: TypeRelations;
-}
-/**
- * ## Type
- * Types are properties for Pokémon and their moves.
- * Each type has three properties: which types of Pokémon it is super effective against,
- * which types of Pokémon it is not very effective against, and which types of Pokémon it is completely ineffective against.
+interface Gender {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: "male" | "female" | "genderless";
+  /** A list of Pokémon species that can be this gender and how likely it is that they will be. */
+  pokemon_species_details: PokemonSpeciesGender[];
+  /** A list of Pokémon species that required this gender in order for a Pokémon to evolve into them. */
+  required_for_evolution: NamedAPIResource<PokemonSpecies>[];
+}
+/**
+ * Pokémon species that can be this gender and how likely it is that they will be.
  */
-interface Type {
-  /** The identifier for this resource. */
-  id: number;
-  /** The name for this resource. */
-  name: string;
-  /** A detail of how effective this type is toward others and vice versa. */
-  damage_relations: TypeRelations;
-  /** A list of details of how effective this type was toward others and vice versa in previous generations. */
-  past_damage_relations: TypeRelationsPast[];
-  /** A list of game indices relevant to this item by generation. */
-  game_indices: GenerationGameIndex[];
-  /** The generation this type was introduced in. */
-  generation: NamedAPIResource;
-  /** The class of damage inflicted by this type. */
-  move_damage_class: NamedAPIResource;
-  /** The name of this resource listed in different languages. */
-  names: Name[];
-  /** A list of details of Pokémon that have this type. */
-  pokemon: TypePokemon[];
-  /** A list of moves that have this type. */
-  moves: NamedAPIResource[];
+interface PokemonSpeciesGender {
+  /** The chance of this Pokémon being female, in eighths; or -1 for genderless. */
+  rate: number;
+  /** A Pokémon species that can be the referenced gender. */
+  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.
@@ -2105,7 +2044,7 @@ interface MoveTarget {
   /** The description of this resource listed in different languages. */
   descriptions: Description[];
   /** A list of moves that are directed at this target. */
-  moves: NamedAPIResource[];
+  moves: NamedAPIResource<Move>[];
   /** The name of this resource listed in different languages. */
   names: Name[];
 }
@@ -2123,7 +2062,7 @@ interface MoveLearnMethod {
   /** The name of this resource listed in different languages. */
   names: Name[];
   /** A list of version groups where moves can be learned through this method. */
-  version_groups: NamedAPIResource[];
+  version_groups: NamedAPIResource<VersionGroup>[];
 }
 /**
  * ## Move Damage Class
@@ -2137,7 +2076,7 @@ interface MoveDamageClass {
   /** The description of this resource listed in different languages. */
   descriptions: Description[];
   /** A list of moves that fall into this damage class. */
-  moves: NamedAPIResource[];
+  moves: NamedAPIResource<Move>[];
   /** The name of this resource listed in different languages. */
   names: Name[];
 }
@@ -2151,13 +2090,14 @@ interface MoveCategory {
   /** The name for this resource. */
   name: string;
   /** A list of moves that fall into this category. */
-  moves: NamedAPIResource[];
+  moves: NamedAPIResource<Move>[];
   /** The description of this resource listed in different languages. */
   descriptions: Description[];
 }
 /**
  * ## 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 {
@@ -2171,6 +2111,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 {
@@ -2179,7 +2120,7 @@ interface MoveAilment {
   /** The name for this resource. */
   name: string;
   /** A list of moves that cause this ailment. */
-  moves: NamedAPIResource[];
+  moves: NamedAPIResource<Move>[];
   /** The name of this resource listed in different languages. */
   names: Name[];
 }
@@ -2196,23 +2137,23 @@ interface PastMoveStatValues {
   /** The effect of this move listed in different languages. */
   effect_entries: VerboseEffect[];
   /** The elemental type of this move. */
-  type: NamedAPIResource | null;
+  type: NamedAPIResource<Type> | null;
   /** The version group in which these move stat values were in effect. */
-  version_group: NamedAPIResource;
+  version_group: NamedAPIResource<VersionGroup>;
 }
 /** A stat this move changes, and by how much. */
 interface MoveStatChange {
   /** The amount of change. */
   change: number;
   /** The stat being affected. */
-  stat: NamedAPIResource;
+  stat: NamedAPIResource<Stat>;
 }
 /** Metadata about a move. */
 interface MoveMetaData {
   /** The status ailment this move inflicts on its target. */
-  ailment: NamedAPIResource;
+  ailment: NamedAPIResource<MoveAilment>;
   /** The category of move this move falls under, e.g. damage or ailment. */
-  category: NamedAPIResource;
+  category: NamedAPIResource<MoveCategory>;
   /** The minimum number of times this move hits. Null if it always only hits once. */
   min_hits: number | null;
   /** The maximum number of times this move hits. Null if it always only hits once. */
@@ -2241,18 +2182,18 @@ interface MoveFlavorText {
   /** The localized flavor text for an API resource in a specific language. */
   flavor_text: string;
   /** The language this name is in. */
-  language: NamedAPIResource;
+  language: NamedAPIResource<Language>;
   /** The version group that uses this flavor text. */
-  version_group: NamedAPIResource;
+  version_group: NamedAPIResource<VersionGroup>;
 }
 /**
  * A detail of moves this move can be used before or after, granting additional appeal points in super contests.
  */
 interface ContestComboDetail {
   /** A list of moves to use before this move. */
-  use_before: NamedAPIResource[] | null;
+  use_before: NamedAPIResource<Move>[] | null;
   /** A list of moves to use after this move. */
-  use_after: NamedAPIResource[] | null;
+  use_after: NamedAPIResource<Move>[] | null;
 }
 /**
  * A detail of normal and super contest combos that require this move.
@@ -2268,6 +2209,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 {
@@ -2291,11 +2233,11 @@ interface Move {
   /** A detail of normal and super contest combos that require this move. */
   contest_combos: ContestComboSets | null;
   /** The type of appeal this move gives a Pokémon when used in a contest. */
-  contest_type: NamedAPIResource | null;
+  contest_type: NamedAPIResource<ContestType> | null;
   /** The effect the move has when used in a contest. */
-  contest_effect: APIResource | null;
+  contest_effect: APIResource<ContestEffect> | null;
   /** The type of damage the move inflicts on the target, e.g. physical. */
-  damage_class: NamedAPIResource | null;
+  damage_class: NamedAPIResource<MoveDamageClass> | null;
   /** The effect of this move listed in different languages. */
   effect_entries: VerboseEffect[];
   /** The list of previous effects this move has had across version groups of the games. */
@@ -2303,26 +2245,308 @@ interface Move {
   /** The flavor text of this move listed in different languages. */
   flavor_text_entries: MoveFlavorText[];
   /** The generation in which this move was introduced. */
-  generation: NamedAPIResource;
+  generation: NamedAPIResource<Generation>;
   /** A list of the machines that teach this move. */
   machines: MachineVersionDetail[];
   /** Metadata about this move. */
   meta: MoveMetaData | null;
   /** The name of this resource listed in different languages. */
   names: Name[];
-  /** A list of move resource value changes across version groups of the game. */
-  past_values: PastMoveStatValues[];
-  /** A list of stats this move affects and by how much. */
-  stat_changes: MoveStatChange[];
-  /** The effect the move has when used in a super contest. */
-  super_contest_effect: APIResource | null;
-  /** The type of target that will receive the effects of the attack. */
-  target: NamedAPIResource;
-  /** The elemental type of this move. */
-  type: NamedAPIResource;
-  /** A list of Pokémon that learned this move. */
-  learned_by_pokemon: NamedAPIResource[];
-}
+  /** A list of move resource value changes across version groups of the game. */
+  past_values: PastMoveStatValues[];
+  /** A list of stats this move affects and by how much. */
+  stat_changes: MoveStatChange[];
+  /** The effect the move has when used in a super contest. */
+  super_contest_effect: APIResource<SuperContestEffect> | null;
+  /** The type of target that will receive the effects of the attack. */
+  target: NamedAPIResource<MoveTarget>;
+  /** The elemental type of this move. */
+  type: NamedAPIResource<Type>;
+  /** A list of Pokémon that learned this move. */
+  learned_by_pokemon: NamedAPIResource<Pokemon>[];
+}
+//#endregion
+//#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 {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** A list of abilities that were introduced in this generation. */
+  abilities: NamedAPIResource<Ability>[];
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+  /** The main region travelled in this generation. */
+  main_region: NamedAPIResource<Region>;
+  /** A list of moves that were introduced in this generation. */
+  moves: NamedAPIResource<Move>[];
+  /** A list of Pokémon species that were introduced in this generation. */
+  pokemon_species: NamedAPIResource<PokemonSpecies>[];
+  /** A list of types that were introduced in this generation. */
+  types: NamedAPIResource<Type>[];
+  /** A list of version groups that were introduced in this generation. */
+  version_groups: NamedAPIResource<VersionGroup>[];
+}
+//#endregion
+//#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 = {
+  /** The identifier for this resource. */
+  id: number;
+  /** A list of locations that can be found in this region. */
+  locations: NamedAPIResource<Location>[];
+  /** The name for this resource. */
+  name: string;
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+  /** The generation this region was introduced in. */
+  main_generation: NamedAPIResource<Generation>;
+  /** A list of Pokédexes that catalogue Pokémon in this region. */
+  pokedexes: NamedAPIResource<Pokedex>[];
+  /** A list of version groups where this region can be visited. */
+  version_groups: NamedAPIResource<VersionGroup>[];
+};
+//#endregion
+//#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 {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+  /** The version group this version belongs to. */
+  version_group: NamedAPIResource<VersionGroup>;
+}
+/**
+ * ## Version Group
+ * Version groups categorize highly similar versions of the games.
+ */
+interface VersionGroup {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** Order for sorting. Almost by date of release, except similar versions are grouped together. */
+  order: number;
+  /** The generation this version was introduced in. */
+  generation: NamedAPIResource<Generation>;
+  /** A list of methods in which Pokémon can learn moves in this version group. */
+  move_learn_methods: NamedAPIResource<MoveLearnMethod>[];
+  /** A list of Pokédexes introduced in this version group. */
+  pokedexes: NamedAPIResource<Pokedex>[];
+  /** A list of regions that can be visited in this version group. */
+  regions: NamedAPIResource<Region>[];
+  /** The versions this version group owns. */
+  versions: NamedAPIResource<Version>[];
+}
+//#endregion
+//#region src/models/common/flavor-text.d.ts
+/**
+ * The localized flavor text for an API resource in a specific language.
+ */
+interface FlavorText {
+  /** The localized flavor text for an API resource in a specific language. */
+  flavor_text: string;
+  /** The language this name is in. */
+  language: NamedAPIResource<Language>;
+  /** The game version this flavor text appears in. */
+  version: NamedAPIResource<Version>;
+}
+//#endregion
+//#region src/models/common/generation.d.ts
+/**
+ * The generation relevant to this game index.
+ */
+interface GenerationGameIndex {
+  /** The internal id of an API resource within game data. */
+  game_index: number;
+  /** The generation relevant to this game index. */
+  generation: NamedAPIResource<Generation>;
+}
+//#endregion
+//#region src/models/machine/machine.d.ts
+/**
+ * ## Machine
+ * Machines are the representation of items that teach moves to Pokémon.
+ * They vary from version to version, so it is not certain that one specific
+ * [TM (Technical Machine)](https://bulbapedia.bulbagarden.net/wiki/TM) or
+ * [HM (Hidden Machine)](https://bulbapedia.bulbagarden.net/wiki/HM) corresponds to a single Machine.
+ */
+type Machine = {
+  /** The identifier for this resource. */
+  id: number;
+  /** The TM or HM item that corresponds to this machine. */
+  item: NamedAPIResource<Item>;
+  /** The move that is taught by this machine. */
+  move: NamedAPIResource<Move>;
+  /** The version group that this machine applies to. */
+  version_group: NamedAPIResource<VersionGroup>;
+};
+//#endregion
+//#region src/models/common/machine.d.ts
+/**
+ * The machine that teaches a move from an item.
+ */
+interface MachineVersionDetail {
+  /** The machine that teaches a move from an item. */
+  machine: APIResource<Machine>;
+  /** The version group of this specific machine. */
+  version_group: NamedAPIResource<VersionGroup>;
+}
+//#endregion
+//#region src/models/common/verbose.d.ts
+/**
+ * The localized effect for an API resource.
+ */
+interface VerboseEffect {
+  /** The localized effect text for an API resource in a specific language. */
+  effect: string;
+  /** The localized effect text in brief. */
+  short_effect: string;
+  /** The language this effect is in. */
+  language: NamedAPIResource<Language>;
+}
+//#endregion
+//#region src/models/common/version.d.ts
+/**
+ * Encounters and their specific details.
+ */
+interface VersionEncounterDetail {
+  /** The game version this encounter happens in. */
+  version: NamedAPIResource<Version>;
+  /** The total percentage of all encounter potential. */
+  max_chance: number;
+  /** A list of encounters and their specifics. */
+  encounter_details: Encounter[];
+}
+/**
+ * The internal id and version of an API resource.
+ */
+interface VersionGameIndex {
+  /** The internal id of an API resource within game data. */
+  game_index: number;
+  /** The version relevant to this game index. */
+  version: NamedAPIResource<Version>;
+}
+/**
+ * The flavor text of an API resource.
+ */
+interface VersionGroupFlavorText {
+  /** The localized name for an API resource in a specific language. */
+  text: string;
+  /** The language this name is in. */
+  language: NamedAPIResource<Language>;
+  /** The version group which uses this flavor text. */
+  version_group: NamedAPIResource<VersionGroup>;
+}
+//#endregion
+//#region src/models/berry/berry.d.ts
+/**
+ * ## Berry
+ * Berries are small fruits that can provide HP and status condition restoration,
+ * stat enhancement, and even damage negation when eaten by Pokémon.
+ *
+ * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Berry) for greater detail.
+ */
+type Berry = {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: string;
+  /** Time it takes the tree to grow one stage, in hours. Berry trees go through four of these growth stages before they can be picked. */
+  growth_time: number;
+  /** The maximum number of these berries that can grow on one tree in Generation IV. */
+  max_harvest: number;
+  /** The power of the move "Natural Gift" when used with this Berry. */
+  natural_gift_power: number;
+  /** The size of this Berry, in millimeters. */
+  size: number;
+  /** The smoothness of this Berry, used in making Pokéblocks or Poffins. */
+  smoothness: number;
+  /** The speed at which this Berry dries out the soil as it grows. A higher rate means the soil dries more quickly. */
+  soil_dryness: number;
+  /** The firmness of this berry, used in making Pokéblocks or Poffins. */
+  firmness: NamedAPIResource<BerryFirmness>;
+  /** A list of references to each flavor a berry can have and the potency of each of those flavors in regard to this berry. */
+  flavors: BerryFlavorMap[];
+  /** Berries are actually items. This is a reference to the item specific data for this berry. */
+  item: NamedAPIResource<Item>;
+  /** The type inherited by "Natural Gift" when used with this Berry. */
+  natural_gift_type: NamedAPIResource<Type>;
+};
+/**
+ * Reference to the flavor a berry can have and the potency of each of those flavors in regard to this berry.
+ */
+type BerryFlavorMap = {
+  /** How powerful the referenced flavor is for this berry. */
+  potency: number;
+  /** The referenced berry flavor. */
+  flavor: NamedAPIResource<BerryFlavor>;
+};
+/**
+ * ## Berry Flavor
+ * Flavors determine whether a Pokémon will benefit or suffer from eating a berry based on its nature.
+ *
+ * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Flavor) for greater detail.
+ */
+type BerryFlavor = {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: "spicy" | "dry" | "sweet" | "bitter" | "sour";
+  /** A list of the berries with this flavor. */
+  berries: FlavorBerryMap[];
+  /** The contest type that correlates with this berry flavor. */
+  contest_type: NamedAPIResource<ContestType>;
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+};
+/**
+ * Berry with the given flavor.
+ */
+type FlavorBerryMap = {
+  /** How powerful the referenced flavor is for this berry. */
+  potency: number;
+  /** The berry with the referenced flavor. */
+  berry: NamedAPIResource<Berry>;
+};
+/**
+ * ## Berry Firmness
+ * Berries can be soft, very soft, hard, super hard or very hard.
+ *
+ * - See [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Category:Berries_by_firmness) for greater detail.
+ */
+type BerryFirmness = {
+  /** The identifier for this resource. */
+  id: number;
+  /** The name for this resource. */
+  name: "very-soft" | "soft" | "hard" | "very-hard" | "super-hard";
+  /** A list of the berries with this firmness. */
+  berries: NamedAPIResource<Berry>[];
+  /** The name of this resource listed in different languages. */
+  names: Name[];
+};
 //#endregion
 //#region src/config/cache.d.ts
 /**
@@ -2346,7 +2570,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;
 }
 /**
@@ -2366,31 +2593,266 @@ 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.
+ *
+ * Declared structurally rather than as the DOM's `Storage`: the package compiles
+ * without `lib.dom`, and stays usable anywhere the same shape exists.
+ *
+ * Every method may return a promise, so a React Native `AsyncStorage` works as-is.
+ * Key enumeration is the one place the two shapes differ: `Storage` exposes
+ * `length` and `key(index)`, `AsyncStorage` exposes `getAllKeys`, and a property
+ * cannot be awaited — so both are accepted, and a storage offering neither still
+ * caches; it just never evicts or clears.
+ */
+interface WebStorageLike {
+  getItem(key: string): string | null | Promise<string | null>;
+  setItem(key: string, value: string): void | Promise<void>;
+  removeItem(key: string): void | Promise<void>;
+  /** Every key held, this store's and the application's alike. */
+  getAllKeys?(): readonly string[] | Promise<readonly string[]>;
+  key?(index: number): string | null;
+  readonly length?: number;
+}
+/**
+ * ## Web Storage Cache Options
+ * Used to configure a store backed by `localStorage` or `sessionStorage`.
+ */
+interface WebStorageCacheOptions {
+  /**
+   * Where entries are kept. Pass `localStorage`, `sessionStorage`, a React Native
+   * `AsyncStorage`, or anything else matching {@link WebStorageLike}.
+   */
+  storage: WebStorageLike;
+  /** How long a cached response stays fresh, in milliseconds. Defaults to 5 minutes. */
+  ttl?: number;
+  /** Namespace for the keys this store writes. Defaults to `pokenode:`. */
+  prefix?: string;
+}
+/**
+ * ## Web Storage Cache
+ * A {@link CacheStore} backed by `localStorage` or `sessionStorage`, so a cached
+ * response survives a page reload.
+ *
+ * ```ts
+ * const api = new PokemonClient({ cache: new WebStorageCache({ storage: localStorage }) });
+ * ```
+ *
+ * Only keys under {@link WebStorageCacheOptions.prefix} are ever read, evicted or
+ * cleared — the storage is assumed to be shared with the surrounding application.
+ *
+ * Values round-trip through JSON, so unlike {@link MemoryCache} every hit returns a
+ * fresh copy. Anything a `JSON.stringify` cannot represent does not survive, which
+ * covers every PokéAPI response.
+ *
+ * A storage that throws instead of answering is treated as empty: a read is a miss
+ * and a write is dropped, because neither is worth failing the request that
+ * triggered it over.
+ */
+declare class WebStorageCache implements CacheStore {
+  private readonly storage;
+  private readonly ttl;
+  private readonly prefix;
+  constructor(options: WebStorageCacheOptions);
+  get(key: string): Promise<unknown>;
+  set(key: string, value: unknown): Promise<void>;
+  delete(key: string): Promise<void>;
+  clear(): Promise<void>;
+  /** Reads a namespaced key, treating unreadable content as a miss. */
+  private read;
+  /**
+   * Frees space by dropping expired entries, falling back to the ones closest to
+   * expiring when nothing has expired yet.
+   */
+  private evict;
+  /**
+   * Collects this store's keys before any removal: `key(index)` walks a list that
+   * shifts underneath a loop that deletes as it goes.
+   */
+  private ownKeys;
+  /**
+   * Every key the storage holds, however it is willing to list them. A storage
+   * offering no enumeration at all reports none, which leaves eviction and
+   * `clear` as no-ops rather than an error on a path that only tidies up.
+   */
+  private allKeys;
+  /** Removes a key on a path that is only tidying up, where a refusal is moot. */
+  private remove;
+}
 //#endregion
 //#region src/config/logger.d.ts
+/**
+ * Fields shared by every payload.
+ *
+ * The text is carried twice on purpose. pino, bunyan and roarr read `msg`;
+ * winston reads `message`. Sending both is what lets a logger from either family
+ * be passed straight in, with no adapter to write and nothing logged as
+ * `undefined`.
+ */
+interface LogFields {
+  /** Which point of the request lifecycle this is, for filtering. */
+  event: "request" | "response" | "retry" | "cancelled" | "error";
+  msg: string;
+  message: string;
+  /** The request URL, with any credentials the base URL carried removed. */
+  url: string;
+}
+/**
+ * ## Log Request Payload
+ * A request is about to be resolved, from cache or over the network.
+ */
+interface LogRequestPayload extends LogFields {
+  event: "request";
+  /** The HTTP method, uppercase, as RFC 9110 and OpenTelemetry both expect. */
+  method: string;
+}
+/**
+ * ## Log Response Payload
+ * A response was produced.
+ */
+interface LogResponsePayload extends LogFields {
+  event: "response";
+  status: number;
+  /**
+   * Where the response came from.
+   *
+   * - `network` — a round trip was made.
+   * - `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 `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" | "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.
+ *
+ * The error is carried twice for the same reason the message is: pino runs its
+ * error serializer on `err` and nothing else, so an `Error` under any other key
+ * would reach the log as `{}` — no message, no stack.
+ */
+interface LogErrorPayload extends LogFields {
+  event: "error";
+  /** Whatever `fetch` or the API produced. */
+  err: unknown;
+  error: unknown;
+}
 /**
  * ## Logger
- * Receives one call per request lifecycle event.
+ * Where a client reports what it did.
+ *
+ * Deliberately the shape every logging library already has, so one can be passed
+ * without glue:
+ *
+ * ```ts
+ * new PokemonClient({ logger: pino() });
+ * new PokemonClient({ logger: console });
+ * new PokemonClient({ logger: winston.createLogger() });
+ * ```
  *
- * Pass one as `ClientOptions.logger`; leave it unset and a client logs nothing.
- * Use {@link consoleLogger}, or forward to pino, winston, or a metrics collector.
+ * 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 {
-  /** A request is about to be resolved, from cache or over the network. */
-  request(method: string, url: string): void;
-  /** A response was produced. `cached` distinguishes a cache hit from a round trip. */
-  response(status: number, cached: boolean): void;
-  /** A request failed. The error is whatever `fetch` or the API produced. */
-  error(error: unknown): void;
-}
-/** A {@link Logger} that writes the request lifecycle to the console. */
+  debug(payload: LogRequestPayload | LogResponsePayload | LogRetryPayload | LogCancelledPayload): void;
+  error(payload: LogErrorPayload): void;
+}
+/**
+ * A {@link Logger} that writes the request lifecycle to the console as one
+ * formatted line per event.
+ *
+ * `console` itself is a valid {@link Logger} and logs the payload as an object;
+ * this is for when the terminal should stay readable.
+ */
 declare const consoleLogger: Logger;
 //#endregion
-//#region src/constants/base.d.ts
-declare const BASE_URL: {
-  readonly REST: "https://pokeapi.co/api/v2";
-};
-//#endregion
 //#region src/constants/berries.d.ts
 /** Enum of Berries (NAME - ID) */
 declare const BERRIES: {
@@ -2956,7 +3418,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;
@@ -3093,6 +3555,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;
@@ -3108,6 +3577,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 };
@@ -3119,6 +3589,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.
@@ -3140,68 +3650,229 @@ 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.
+ */
+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.
  */
-declare class BaseClient {
+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.
    *
-   * The URL is joined by concatenation: `new URL(path, base)` would discard the
-   * base's own `/api/v2` path.
+   * 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.
+   *
+   * ```ts
+   * const types = await api.resolveAll(pokemon.types.map((slot) => slot.type));
+   * //    ^? Type[]
+   * ```
    */
-  private request;
-  private fetchResource;
+  resolveAll<T>(resources: readonly ResourceLink<T>[], options?: ResolveOptions): Promise<T[]>;
   /**
    * Retrieves a single resource from the PokéAPI by its endpoint and identifier.
    *
-   * @template T - The type of the resource to be returned.
-   * @param endpoint - The endpoint of the resource.
-   * @param identifier - The identifier of the resource, or a path below the endpoint.
-   *   Omit it to address the endpoint itself.
-   * @returns A promise that resolves to the requested resource.
+   * @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.
+   * Retrieves a resource by its URL, or by a link taken from another response.
+   *
+   * A link knows what it points at, so passing one infers `T`; a bare string
+   * does not, and needs `T` named.
    *
-   * @template T - The type of the resource to be returned.
-   * @param url - The URL of the resource.
-   * @param baseURL - The base URL to use. Defaults to the one the client was built with.
-   * @returns A promise that resolves to the requested resource.
-   * @throws {TypeError} If `url` is not a valid URL, or names no endpoint under `baseURL`.
+   * @throws {TypeError} If the URL is not valid, or names no endpoint under `baseURL`.
    */
-  protected getResourceByURL<T>(url: string, 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.
    *
-   * @param endpoint - The endpoint of the resource.
-   * @param offset - The offset for pagination. Defaults to 0.
-   * @param limit - The limit for pagination. Defaults to 20.
-   * @returns A promise that resolves to a list of named API resources.
+   * @template T - What the listed links resolve to.
    */
-  protected getListResource(endpoint: Endpoint, offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  protected getListResource<T = unknown>(endpoint: Endpoint, offset?: number, limit?: number): Promise<NamedAPIResourceList<T>>;
+  /**
+   * Retrieves a list of resources that have no name to list, with pagination support.
+   *
+   * @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
@@ -3209,78 +3880,32 @@ 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 {
-  /**
-   * Get a Berry by its name.
-   * @param name The Berry name.
-   * @returns The matching Berry.
-   */
+  /** Get a Berry by its name. */
   getBerryByName(name: string): Promise<Berry>;
-  /**
-   * Get a Berry by its ID.
-   * @param id The Berry ID.
-   * @returns The matching Berry.
-   */
+  /** Get a Berry by its ID. */
   getBerryById(id: number): Promise<Berry>;
-  /**
-   * Get a Berry Firmness by its ID.
-   * @param id The Berry Firmness ID.
-   * @returns The matching Berry Firmness.
-   */
+  /** Get a Berry Firmness by its ID. */
   getBerryFirmnessById(id: number): Promise<BerryFirmness>;
-  /**
-   * Get a Berry Firmness by its name.
-   * @param name The Berry Firmness name.
-   * @returns The matching Berry Firmness.
-   */
+  /** Get a Berry Firmness by its name. */
   getBerryFirmnessByName(name: string): Promise<BerryFirmness>;
-  /**
-   * Get a Berry Flavor by its ID.
-   *
-   * Flavors determine whether a Pokémon benefits or suffers from eating a berry,
-   * based on its nature. See
-   * [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Flavor) for greater detail.
-   * @param id The Berry Flavor ID.
-   * @returns The matching Berry Flavor.
-   */
+  /** Get a Berry Flavor by its ID. */
   getBerryFlavorById(id: number): Promise<BerryFlavor>;
-  /**
-   * Get a Berry Flavor by its name.
-   *
-   * Flavors determine whether a Pokémon benefits or suffers from eating a berry,
-   * based on its nature. See
-   * [Bulbapedia](https://bulbapedia.bulbagarden.net/wiki/Flavor) for greater detail.
-   * @param name The Berry Flavor name.
-   * @returns The matching Berry Flavor.
-   */
+  /** Get a Berry Flavor by its name. */
   getBerryFlavorByName(name: string): Promise<BerryFlavor>;
-  /**
-   * List Berries.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Berries.
-   */
-  listBerries(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Berry Firmnesses.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Berry Firmnesses.
-   */
-  listBerryFirmnesses(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Berry Flavors.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Berry Flavors.
-   */
-  listBerryFlavors(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Berries. Page defaults to 20 entries from offset 0. */
+  listBerries(offset?: number, limit?: number): Promise<NamedAPIResourceList<Berry>>;
+  /** List Berry Firmnesses. Page defaults to 20 entries from offset 0. */
+  listBerryFirmnesses(offset?: number, limit?: number): Promise<NamedAPIResourceList<BerryFirmness>>;
+  /** List Berry Flavors. Page defaults to 20 entries from offset 0. */
+  listBerryFlavors(offset?: number, limit?: number): Promise<NamedAPIResourceList<BerryFlavor>>;
 }
 //#endregion
 //#region src/clients/contest.client.d.ts
@@ -3288,58 +3913,28 @@ 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 {
-  /**
-   * Get a Contest Type by its name.
-   * @param name The Contest Type name.
-   * @returns The matching Contest Type.
-   */
+  /** Get a Contest Type by its name. */
   getContestTypeByName(name: string): Promise<ContestType>;
-  /**
-   * Get a Contest Type by its ID.
-   * @param id The Contest Type ID.
-   * @returns The matching Contest Type.
-   */
+  /** Get a Contest Type by its ID. */
   getContestTypeById(id: number): Promise<ContestType>;
-  /**
-   * Get a Contest Effect by its ID.
-   * @param id The Contest Effect ID.
-   * @returns The matching Contest Effect.
-   */
+  /** Get a Contest Effect by its ID. */
   getContestEffectById(id: number): Promise<ContestEffect>;
-  /**
-   * Get a Super Contest Effect by its ID.
-   * @param id The Super Contest Effect ID.
-   * @returns The matching Super Contest Effect.
-   */
+  /** Get a Super Contest Effect by its ID. */
   getSuperContestEffectById(id: number): Promise<SuperContestEffect>;
-  /**
-   * List Contest Types.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Contest Types.
-   */
-  listContestTypes(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Contest Effects.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Contest Effects.
-   */
-  listContestEffects(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Super Contest Effects.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Super Contest Effects.
-   */
-  listSuperContestEffects(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Contest Types. Page defaults to 20 entries from offset 0. */
+  listContestTypes(offset?: number, limit?: number): Promise<NamedAPIResourceList<ContestType>>;
+  /** List Contest Effects. Page defaults to 20 entries from offset 0. */
+  listContestEffects(offset?: number, limit?: number): Promise<APIResourceList<ContestEffect>>;
+  /** List Super Contest Effects. Page defaults to 20 entries from offset 0. */
+  listSuperContestEffects(offset?: number, limit?: number): Promise<APIResourceList<SuperContestEffect>>;
 }
 //#endregion
 //#region src/clients/currency.client.d.ts
@@ -3347,30 +3942,18 @@ 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 {
-  /**
-   * Get a Currency by its name.
-   * @param name The Currency name.
-   * @returns The matching Currency.
-   */
+  /** Get a Currency by its name. */
   getCurrencyByName(name: string): Promise<Currency>;
-  /**
-   * Get a Currency by its ID.
-   * @param id The Currency ID.
-   * @returns The matching Currency.
-   */
+  /** Get a Currency by its ID. */
   getCurrencyById(id: number): Promise<Currency>;
-  /**
-   * List Currencies.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Currencies.
-   */
-  listCurrencies(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Currencies. Page defaults to 20 entries from offset 0. */
+  listCurrencies(offset?: number, limit?: number): Promise<NamedAPIResourceList<Currency>>;
 }
 //#endregion
 //#region src/clients/encounter.client.d.ts
@@ -3378,70 +3961,32 @@ 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 {
-  /**
-   * Get an Encounter Method by its name.
-   * @param name The Encounter Method name.
-   * @returns The matching Encounter Method.
-   */
+  /** Get an Encounter Method by its name. */
   getEncounterMethodByName(name: string): Promise<EncounterMethod>;
-  /**
-   * Get an Encounter Method by its ID.
-   * @param id The Encounter Method ID.
-   * @returns The matching Encounter Method.
-   */
+  /** Get an Encounter Method by its ID. */
   getEncounterMethodById(id: number): Promise<EncounterMethod>;
-  /**
-   * Get an Encounter Condition by its ID.
-   * @param id The Encounter Condition ID.
-   * @returns The matching Encounter Condition.
-   */
+  /** Get an Encounter Condition by its ID. */
   getEncounterConditionById(id: number): Promise<EncounterCondition>;
-  /**
-   * Get an Encounter Condition by its name.
-   * @param name The Encounter Condition name.
-   * @returns The matching Encounter Condition.
-   */
+  /** Get an Encounter Condition by its name. */
   getEncounterConditionByName(name: string): Promise<EncounterCondition>;
-  /**
-   * Get an Encounter Condition Value by its name.
-   * @param name The Encounter Condition Value name.
-   * @returns The matching Encounter Condition Value.
-   */
+  /** Get an Encounter Condition Value by its name. */
   getEncounterConditionValueByName(name: string): Promise<EncounterConditionValue>;
-  /**
-   * Get an Encounter Condition Value by its ID.
-   * @param id The Encounter Condition Value ID.
-   * @returns The matching Encounter Condition Value.
-   */
+  /** Get an Encounter Condition Value by its ID. */
   getEncounterConditionValueById(id: number): Promise<EncounterConditionValue>;
-  /**
-   * List Encounter Methods.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Encounter Methods.
-   */
-  listEncounterMethods(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Encounter Conditions.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Encounter Conditions.
-   */
-  listEncounterConditions(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Encounter Condition Values.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Encounter Condition Values.
-   */
-  listEncounterConditionValues(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Encounter Methods. Page defaults to 20 entries from offset 0. */
+  listEncounterMethods(offset?: number, limit?: number): Promise<NamedAPIResourceList<EncounterMethod>>;
+  /** List Encounter Conditions. Page defaults to 20 entries from offset 0. */
+  listEncounterConditions(offset?: number, limit?: number): Promise<NamedAPIResourceList<EncounterCondition>>;
+  /** List Encounter Condition Values. Page defaults to 20 entries from offset 0. */
+  listEncounterConditionValues(offset?: number, limit?: number): Promise<NamedAPIResourceList<EncounterConditionValue>>;
 }
 //#endregion
 //#region src/clients/evolution.client.d.ts
@@ -3449,44 +3994,23 @@ 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 {
-  /**
-   * Get an Evolution Chain by its ID.
-   * @param id The Evolution Chain ID.
-   * @returns The matching Evolution Chain.
-   */
+  /** Get an Evolution Chain by its ID. */
   getEvolutionChainById(id: number): Promise<EvolutionChain>;
-  /**
-   * Get an Evolution Trigger by its ID.
-   * @param id The Evolution Trigger ID.
-   * @returns The matching Evolution Trigger.
-   */
+  /** Get an Evolution Trigger by its ID. */
   getEvolutionTriggerById(id: number): Promise<EvolutionTrigger>;
-  /**
-   * Get an Evolution Trigger by its name.
-   * @param name The Evolution Trigger name.
-   * @returns The matching Evolution Trigger.
-   */
+  /** Get an Evolution Trigger by its name. */
   getEvolutionTriggerByName(name: string): Promise<EvolutionTrigger>;
-  /**
-   * List Evolution Chains.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Evolution Chains.
-   */
-  listEvolutionChains(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Evolution Triggers.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Evolution Triggers.
-   */
-  listEvolutionTriggers(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Evolution Chains. Page defaults to 20 entries from offset 0. */
+  listEvolutionChains(offset?: number, limit?: number): Promise<APIResourceList<EvolutionChain>>;
+  /** List Evolution Triggers. Page defaults to 20 entries from offset 0. */
+  listEvolutionTriggers(offset?: number, limit?: number): Promise<NamedAPIResourceList<EvolutionTrigger>>;
 }
 //#endregion
 //#region src/clients/game.client.d.ts
@@ -3494,90 +4018,39 @@ 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 {
-  /**
-   * Get a Generation by its name.
-   * @param name The Generation name.
-   * @returns The matching Generation.
-   */
+  /** Get a Generation by its name. */
   getGenerationByName(name: string): Promise<Generation>;
-  /**
-   * Get a Generation by its ID.
-   * @param id The Generation ID.
-   * @returns The matching Generation.
-   */
-  getGenerationById(id: number): Promise<Generation>;
-  /**
-   * Get a Pokédex by its name.
-   * @param name The Pokédex name.
-   * @returns The matching Pokédex.
-   */
+  /** Get a Generation by its ID. */
+  getGenerationById(id: number): Promise<Generation>;
+  /** Get a Pokédex by its name. */
   getPokedexByName(name: string): Promise<Pokedex>;
-  /**
-   * Get a Pokédex by its ID.
-   * @param id The Pokédex ID.
-   * @returns The matching Pokédex.
-   */
+  /** Get a Pokédex by its ID. */
   getPokedexById(id: number): Promise<Pokedex>;
-  /**
-   * Get a Version by its name.
-   * @param name The Version name.
-   * @returns The matching Version.
-   */
+  /** Get a Version by its name. */
   getVersionByName(name: string): Promise<Version>;
-  /**
-   * Get a Version by its ID.
-   * @param id The Version ID.
-   * @returns The matching Version.
-   */
+  /** Get a Version by its ID. */
   getVersionById(id: number): Promise<Version>;
-  /**
-   * Get a Version Group by its name.
-   * @param name The Version Group name.
-   * @returns The matching Version Group.
-   */
+  /** Get a Version Group by its name. */
   getVersionGroupByName(name: string): Promise<VersionGroup>;
-  /**
-   * Get a Version Group by its ID.
-   * @param id The Version Group ID.
-   * @returns The matching Version Group.
-   */
+  /** Get a Version Group by its ID. */
   getVersionGroupById(id: number): Promise<VersionGroup>;
-  /**
-   * List Generations.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Generations.
-   */
-  listGenerations(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokédexes.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokédexes.
-   */
-  listPokedexes(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Versions.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Versions.
-   */
-  listVersions(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Version Groups.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Version Groups.
-   */
-  listVersionGroups(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Generations. Page defaults to 20 entries from offset 0. */
+  listGenerations(offset?: number, limit?: number): Promise<NamedAPIResourceList<Generation>>;
+  /** List Pokédexes. Page defaults to 20 entries from offset 0. */
+  listPokedexes(offset?: number, limit?: number): Promise<NamedAPIResourceList<Pokedex>>;
+  /** List Versions. Page defaults to 20 entries from offset 0. */
+  listVersions(offset?: number, limit?: number): Promise<NamedAPIResourceList<Version>>;
+  /** List Version Groups. Page defaults to 20 entries from offset 0. */
+  listVersionGroups(offset?: number, limit?: number): Promise<NamedAPIResourceList<VersionGroup>>;
 }
 //#endregion
 //#region src/clients/item.client.d.ts
@@ -3585,110 +4058,46 @@ 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 {
-  /**
-   * Get an Item by its name.
-   * @param name The Item name.
-   * @returns The matching Item.
-   */
+  /** Get an Item by its name. */
   getItemByName(name: string): Promise<Item>;
-  /**
-   * Get an Item by its ID.
-   * @param id The Item ID.
-   * @returns The matching Item.
-   */
+  /** Get an Item by its ID. */
   getItemById(id: number): Promise<Item>;
-  /**
-   * Get an Item Attribute by its name.
-   * @param name The Item Attribute name.
-   * @returns The matching Item Attribute.
-   */
+  /** Get an Item Attribute by its name. */
   getItemAttributeByName(name: string): Promise<ItemAttribute>;
-  /**
-   * Get an Item Attribute by its ID.
-   * @param id The Item Attribute ID.
-   * @returns The matching Item Attribute.
-   */
+  /** Get an Item Attribute by its ID. */
   getItemAttributeById(id: number): Promise<ItemAttribute>;
-  /**
-   * Get an Item Category by its name.
-   * @param name The Item Category name.
-   * @returns The matching Item Category.
-   */
+  /** Get an Item Category by its name. */
   getItemCategoryByName(name: string): Promise<ItemCategory>;
-  /**
-   * Get an Item Category by its ID.
-   * @param id The Item Category ID.
-   * @returns The matching Item Category.
-   */
+  /** Get an Item Category by its ID. */
   getItemCategoryById(id: number): Promise<ItemCategory>;
-  /**
-   * Get an Item Fling Effect by its name.
-   * @param name The Item Fling Effect name.
-   * @returns The matching Item Fling Effect.
-   */
+  /** Get an Item Fling Effect by its name. */
   getItemFlingEffectByName(name: string): Promise<ItemFlingEffect>;
-  /**
-   * Get an Item Fling Effect by its ID.
-   * @param id The Item Fling Effect ID.
-   * @returns The matching Item Fling Effect.
-   */
+  /** Get an Item Fling Effect by its ID. */
   getItemFlingEffectById(id: number): Promise<ItemFlingEffect>;
-  /**
-   * Get an Item Pocket by its name.
-   * @param name The Item Pocket name.
-   * @returns The matching Item Pocket.
-   */
+  /** Get an Item Pocket by its name. */
   getItemPocketByName(name: string): Promise<ItemPocket>;
-  /**
-   * Get an Item Pocket by its ID.
-   * @param id The Item Pocket ID.
-   * @returns The matching Item Pocket.
-   */
+  /** Get an Item Pocket by its ID. */
   getItemPocketById(id: number): Promise<ItemPocket>;
-  /**
-   * List Items.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Items.
-   */
-  listItems(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Item Attributes.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Item Attributes.
-   */
-  listItemAttributes(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Item Categories.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Item Categories.
-   */
-  listItemCategories(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Item Fling Effects.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Item Fling Effects.
-   */
-  listItemFlingEffects(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Item Pockets.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Item Pockets.
-   */
-  listItemPockets(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Items. Page defaults to 20 entries from offset 0. */
+  listItems(offset?: number, limit?: number): Promise<NamedAPIResourceList<Item>>;
+  /** List Item Attributes. Page defaults to 20 entries from offset 0. */
+  listItemAttributes(offset?: number, limit?: number): Promise<NamedAPIResourceList<ItemAttribute>>;
+  /** List Item Categories. Page defaults to 20 entries from offset 0. */
+  listItemCategories(offset?: number, limit?: number): Promise<NamedAPIResourceList<ItemCategory>>;
+  /** List Item Fling Effects. Page defaults to 20 entries from offset 0. */
+  listItemFlingEffects(offset?: number, limit?: number): Promise<NamedAPIResourceList<ItemFlingEffect>>;
+  /** List Item Pockets. Page defaults to 20 entries from offset 0. */
+  listItemPockets(offset?: number, limit?: number): Promise<NamedAPIResourceList<ItemPocket>>;
 }
 //#endregion
 //#region src/clients/location.client.d.ts
@@ -3696,90 +4105,39 @@ 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 {
-  /**
-   * Get a Location by its name.
-   * @param name The Location name.
-   * @returns The matching Location.
-   */
+  /** Get a Location by its name. */
   getLocationByName(name: string): Promise<Location>;
-  /**
-   * Get a Location by its ID.
-   * @param id The Location ID.
-   * @returns The matching Location.
-   */
+  /** Get a Location by its ID. */
   getLocationById(id: number): Promise<Location>;
-  /**
-   * Get a Location Area by its name.
-   * @param name The Location Area name.
-   * @returns The matching Location Area.
-   */
+  /** Get a Location Area by its name. */
   getLocationAreaByName(name: string): Promise<LocationArea>;
-  /**
-   * Get a Location Area by its ID.
-   * @param id The Location Area ID.
-   * @returns The matching Location Area.
-   */
+  /** Get a Location Area by its ID. */
   getLocationAreaById(id: number): Promise<LocationArea>;
-  /**
-   * Get a Pal Park Area by its name.
-   * @param name The Pal Park Area name.
-   * @returns The matching Pal Park Area.
-   */
+  /** Get a Pal Park Area by its name. */
   getPalParkAreaByName(name: string): Promise<PalParkArea>;
-  /**
-   * Get a Pal Park Area by its ID.
-   * @param id The Pal Park Area ID.
-   * @returns The matching Pal Park Area.
-   */
+  /** Get a Pal Park Area by its ID. */
   getPalParkAreaById(id: number): Promise<PalParkArea>;
-  /**
-   * Get a Region by its name.
-   * @param name The Region name.
-   * @returns The matching Region.
-   */
+  /** Get a Region by its name. */
   getRegionByName(name: string): Promise<Region>;
-  /**
-   * Get a Region by its ID.
-   * @param id The Region ID.
-   * @returns The matching Region.
-   */
+  /** Get a Region by its ID. */
   getRegionById(id: number): Promise<Region>;
-  /**
-   * List Locations.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Locations.
-   */
-  listLocations(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Location Areas.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Location Areas.
-   */
-  listLocationAreas(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pal Park Areas.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pal Park Areas.
-   */
-  listPalParkAreas(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Regions.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Regions.
-   */
-  listRegions(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Locations. Page defaults to 20 entries from offset 0. */
+  listLocations(offset?: number, limit?: number): Promise<NamedAPIResourceList<Location>>;
+  /** List Location Areas. Page defaults to 20 entries from offset 0. */
+  listLocationAreas(offset?: number, limit?: number): Promise<NamedAPIResourceList<LocationArea>>;
+  /** List Pal Park Areas. Page defaults to 20 entries from offset 0. */
+  listPalParkAreas(offset?: number, limit?: number): Promise<NamedAPIResourceList<PalParkArea>>;
+  /** List Regions. Page defaults to 20 entries from offset 0. */
+  listRegions(offset?: number, limit?: number): Promise<NamedAPIResourceList<Region>>;
 }
 //#endregion
 //#region src/clients/machine.client.d.ts
@@ -3787,24 +4145,16 @@ 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 {
-  /**
-   * Get a Machine by its ID.
-   * @param id The Machine ID.
-   * @returns The matching Machine.
-   */
+  /** Get a Machine by its ID. */
   getMachineById(id: number): Promise<Machine>;
-  /**
-   * List Machines.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Machines.
-   */
-  listMachines(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Machines. Page defaults to 20 entries from offset 0. */
+  listMachines(offset?: number, limit?: number): Promise<APIResourceList<Machine>>;
 }
 //#endregion
 //#region src/clients/move.client.d.ts
@@ -3812,150 +4162,60 @@ 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 {
-  /**
-   * Get a Move by its name.
-   * @param name The Move name.
-   * @returns The matching Move.
-   */
+  /** Get a Move by its name. */
   getMoveByName(name: string): Promise<Move>;
-  /**
-   * Get a Move by its ID.
-   * @param id The Move ID.
-   * @returns The matching Move.
-   */
+  /** Get a Move by its ID. */
   getMoveById(id: number): Promise<Move>;
-  /**
-   * Get a Move Ailment by its name.
-   * @param name The Move Ailment name.
-   * @returns The matching Move Ailment.
-   */
+  /** Get a Move Ailment by its name. */
   getMoveAilmentByName(name: string): Promise<MoveAilment>;
-  /**
-   * Get a Move Ailment by its ID.
-   * @param id The Move Ailment ID.
-   * @returns The matching Move Ailment.
-   */
+  /** Get a Move Ailment by its ID. */
   getMoveAilmentById(id: number): Promise<MoveAilment>;
-  /**
-   * Get a Move Battle Style by its name.
-   * @param name The Move Battle Style name.
-   * @returns The matching Move Battle Style.
-   */
+  /** Get a Move Battle Style by its name. */
   getMoveBattleStyleByName(name: string): Promise<MoveBattleStyle>;
-  /**
-   * Get a Move Battle Style by its ID.
-   * @param id The Move Battle Style ID.
-   * @returns The matching Move Battle Style.
-   */
+  /** Get a Move Battle Style by its ID. */
   getMoveBattleStyleById(id: number): Promise<MoveBattleStyle>;
-  /**
-   * Get a Move Category by its name.
-   * @param name The Move Category name.
-   * @returns The matching Move Category.
-   */
+  /** Get a Move Category by its name. */
   getMoveCategoryByName(name: string): Promise<MoveCategory>;
-  /**
-   * Get a Move Category by its ID.
-   * @param id The Move Category ID.
-   * @returns The matching Move Category.
-   */
+  /** Get a Move Category by its ID. */
   getMoveCategoryById(id: number): Promise<MoveCategory>;
-  /**
-   * Get a Move Damage Class by its name.
-   * @param name The Move Damage Class name.
-   * @returns The matching Move Damage Class.
-   */
+  /** Get a Move Damage Class by its name. */
   getMoveDamageClassByName(name: string): Promise<MoveDamageClass>;
-  /**
-   * Get a Move Damage Class by its ID.
-   * @param id The Move Damage Class ID.
-   * @returns The matching Move Damage Class.
-   */
+  /** Get a Move Damage Class by its ID. */
   getMoveDamageClassById(id: number): Promise<MoveDamageClass>;
-  /**
-   * Get a Move Learn Method by its name.
-   * @param name The Move Learn Method name.
-   * @returns The matching Move Learn Method.
-   */
+  /** Get a Move Learn Method by its name. */
   getMoveLearnMethodByName(name: string): Promise<MoveLearnMethod>;
-  /**
-   * Get a Move Learn Method by its ID.
-   * @param id The Move Learn Method ID.
-   * @returns The matching Move Learn Method.
-   */
+  /** Get a Move Learn Method by its ID. */
   getMoveLearnMethodById(id: number): Promise<MoveLearnMethod>;
-  /**
-   * Get a Move Target by its name.
-   * @param name The Move Target name.
-   * @returns The matching Move Target.
-   */
+  /** Get a Move Target by its name. */
   getMoveTargetByName(name: string): Promise<MoveTarget>;
-  /**
-   * Get a Move Target by its ID.
-   * @param id The Move Target ID.
-   * @returns The matching Move Target.
-   */
+  /** Get a Move Target by its ID. */
   getMoveTargetById(id: number): Promise<MoveTarget>;
-  /**
-   * List Moves.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Moves.
-   */
-  listMoves(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Move Ailments.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Move Ailments.
-   */
-  listMoveAilments(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Move Battle Styles.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Move Battle Styles.
-   */
-  listMoveBattleStyles(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Move Categories.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Move Categories.
-   */
-  listMoveCategories(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Move Damage Classes.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Move Damage Classes.
-   */
-  listMoveDamageClasses(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Move Learn Methods.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Move Learn Methods.
-   */
-  listMoveLearnMethods(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Move Targets.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Move Targets.
-   */
-  listMoveTargets(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Moves. Page defaults to 20 entries from offset 0. */
+  listMoves(offset?: number, limit?: number): Promise<NamedAPIResourceList<Move>>;
+  /** List Move Ailments. Page defaults to 20 entries from offset 0. */
+  listMoveAilments(offset?: number, limit?: number): Promise<NamedAPIResourceList<MoveAilment>>;
+  /** List Move Battle Styles. Page defaults to 20 entries from offset 0. */
+  listMoveBattleStyles(offset?: number, limit?: number): Promise<NamedAPIResourceList<MoveBattleStyle>>;
+  /** List Move Categories. Page defaults to 20 entries from offset 0. */
+  listMoveCategories(offset?: number, limit?: number): Promise<NamedAPIResourceList<MoveCategory>>;
+  /** List Move Damage Classes. Page defaults to 20 entries from offset 0. */
+  listMoveDamageClasses(offset?: number, limit?: number): Promise<NamedAPIResourceList<MoveDamageClass>>;
+  /** List Move Learn Methods. Page defaults to 20 entries from offset 0. */
+  listMoveLearnMethods(offset?: number, limit?: number): Promise<NamedAPIResourceList<MoveLearnMethod>>;
+  /** List Move Targets. Page defaults to 20 entries from offset 0. */
+  listMoveTargets(offset?: number, limit?: number): Promise<NamedAPIResourceList<MoveTarget>>;
 }
 //#endregion
 //#region src/clients/pokemon.client.d.ts
@@ -3963,311 +4223,120 @@ 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 {
-  /**
-   * Get an Ability by its name.
-   * @param name The Ability name.
-   * @returns The matching Ability.
-   */
+  /** Get an Ability by its name. */
   getAbilityByName(name: string): Promise<Ability>;
-  /**
-   * Get an Ability by its ID.
-   * @param id The Ability ID.
-   * @returns The matching Ability.
-   */
+  /** Get an Ability by its ID. */
   getAbilityById(id: number): Promise<Ability>;
-  /**
-   * Get a Characteristic by its ID.
-   * @param id The Characteristic ID.
-   * @returns The matching Characteristic.
-   */
+  /** Get a Characteristic by its ID. */
   getCharacteristicById(id: number): Promise<Characteristic>;
-  /**
-   * Get an Egg Group by its name.
-   * @param name The Egg Group name.
-   * @returns The matching Egg Group.
-   */
+  /** Get an Egg Group by its name. */
   getEggGroupByName(name: string): Promise<EggGroup>;
-  /**
-   * Get an Egg Group by its ID.
-   * @param id The Egg Group ID.
-   * @returns The matching Egg Group.
-   */
+  /** Get an Egg Group by its ID. */
   getEggGroupById(id: number): Promise<EggGroup>;
-  /**
-   * Get a Gender by its name.
-   * @param name The Gender name.
-   * @returns The matching Gender.
-   */
+  /** Get a Gender by its name. */
   getGenderByName(name: string): Promise<Gender>;
-  /**
-   * Get a Gender by its ID.
-   * @param id The Gender ID.
-   * @returns The matching Gender.
-   */
+  /** Get a Gender by its ID. */
   getGenderById(id: number): Promise<Gender>;
-  /**
-   * Get a Growth Rate by its name.
-   * @param name The Growth Rate name.
-   * @returns The matching Growth Rate.
-   */
+  /** Get a Growth Rate by its name. */
   getGrowthRateByName(name: string): Promise<GrowthRate>;
-  /**
-   * Get a Growth Rate by its ID.
-   * @param id The Growth Rate ID.
-   * @returns The matching Growth Rate.
-   */
+  /** Get a Growth Rate by its ID. */
   getGrowthRateById(id: number): Promise<GrowthRate>;
-  /**
-   * Get a Nature by its name.
-   * @param name The Nature name.
-   * @returns The matching Nature.
-   */
+  /** Get a Nature by its name. */
   getNatureByName(name: string): Promise<Nature>;
-  /**
-   * Get a Nature by its ID.
-   * @param id The Nature ID.
-   * @returns The matching Nature.
-   */
+  /** Get a Nature by its ID. */
   getNatureById(id: number): Promise<Nature>;
-  /**
-   * Get a Pokéathlon Stat by its name.
-   * @param name The Pokéathlon Stat name.
-   * @returns The matching Pokéathlon Stat.
-   */
+  /** Get a Pokéathlon Stat by its name. */
   getPokeathlonStatByName(name: string): Promise<PokeathlonStat>;
-  /**
-   * Get a Pokéathlon Stat by its ID.
-   * @param id The Pokéathlon Stat ID.
-   * @returns The matching Pokéathlon Stat.
-   */
+  /** Get a Pokéathlon Stat by its ID. */
   getPokeathlonStatById(id: number): Promise<PokeathlonStat>;
-  /**
-   * Get a Pokémon by its name.
-   * @param name The Pokémon name.
-   * @returns The matching Pokémon.
-   */
+  /** Get a Pokémon by its name. */
   getPokemonByName(name: string): Promise<Pokemon>;
-  /**
-   * Get a Pokémon by its ID.
-   * @param id The Pokémon ID.
-   * @returns The matching Pokémon.
-   */
+  /** Get a Pokémon by its ID. */
   getPokemonById(id: number): Promise<Pokemon>;
   /**
    * Get the areas a Pokémon can be encountered in, by its ID.
-   * @param id The Pokémon ID.
    * @returns Every location area the Pokémon appears in, with its encounter details.
    */
   getPokemonLocationAreaById(id: number): Promise<LocationAreaEncounter[]>;
-  /**
-   * Get a Pokémon Color by its name.
-   * @param name The Pokémon Color name.
-   * @returns The matching Pokémon Color.
-   */
+  /** Get a Pokémon Color by its name. */
   getPokemonColorByName(name: string): Promise<PokemonColor>;
-  /**
-   * Get a Pokémon Color by its ID.
-   * @param id The Pokémon Color ID.
-   * @returns The matching Pokémon Color.
-   */
+  /** Get a Pokémon Color by its ID. */
   getPokemonColorById(id: number): Promise<PokemonColor>;
-  /**
-   * Get a Pokémon Form by its name.
-   * @param name The Pokémon Form name.
-   * @returns The matching Pokémon Form.
-   */
+  /** Get a Pokémon Form by its name. */
   getPokemonFormByName(name: string): Promise<PokemonForm>;
-  /**
-   * Get a Pokémon Form by its ID.
-   * @param id The Pokémon Form ID.
-   * @returns The matching Pokémon Form.
-   */
+  /** Get a Pokémon Form by its ID. */
   getPokemonFormById(id: number): Promise<PokemonForm>;
-  /**
-   * Get a Pokémon Habitat by its name.
-   * @param name The Pokémon Habitat name.
-   * @returns The matching Pokémon Habitat.
-   */
+  /** Get a Pokémon Habitat by its name. */
   getPokemonHabitatByName(name: string): Promise<PokemonHabitat>;
-  /**
-   * Get a Pokémon Habitat by its ID.
-   * @param id The Pokémon Habitat ID.
-   * @returns The matching Pokémon Habitat.
-   */
+  /** Get a Pokémon Habitat by its ID. */
   getPokemonHabitatById(id: number): Promise<PokemonHabitat>;
-  /**
-   * Get a Pokémon Shape by its name.
-   * @param name The Pokémon Shape name.
-   * @returns The matching Pokémon Shape.
-   */
+  /** Get a Pokémon Shape by its name. */
   getPokemonShapeByName(name: string): Promise<PokemonShape>;
-  /**
-   * Get a Pokémon Shape by its ID.
-   * @param id The Pokémon Shape ID.
-   * @returns The matching Pokémon Shape.
-   */
+  /** Get a Pokémon Shape by its ID. */
   getPokemonShapeById(id: number): Promise<PokemonShape>;
-  /**
-   * Get a Pokémon Species by its name.
-   * @param name The Pokémon Species name.
-   * @returns The matching Pokémon Species.
-   */
+  /** Get a Pokémon Species by its name. */
   getPokemonSpeciesByName(name: string): Promise<PokemonSpecies>;
-  /**
-   * Get a Pokémon Species by its ID.
-   * @param id The Pokémon Species ID.
-   * @returns The matching Pokémon Species.
-   */
+  /** Get a Pokémon Species by its ID. */
   getPokemonSpeciesById(id: number): Promise<PokemonSpecies>;
-  /**
-   * Get a Stat by its name.
-   * @param name The Stat name.
-   * @returns The matching Stat.
-   */
+  /** Get a Stat by its name. */
   getStatByName(name: string): Promise<Stat>;
-  /**
-   * Get a Stat by its ID.
-   * @param id The Stat ID.
-   * @returns The matching Stat.
-   */
+  /** Get a Stat by its ID. */
   getStatById(id: number): Promise<Stat>;
-  /**
-   * Get a Type by its name.
-   * @param name The Type name.
-   * @returns The matching Type.
-   */
+  /** Get a Type by its name. */
   getTypeByName(name: string): Promise<Type>;
-  /**
-   * Get a Type by its ID.
-   * @param id The Type ID.
-   * @returns The matching Type.
-   */
+  /** Get a Type by its ID. */
   getTypeById(id: number): Promise<Type>;
-  /**
-   * List Abilities.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Abilities.
-   */
-  listAbilities(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Characteristics.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Characteristics.
-   */
-  listCharacteristics(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Egg Groups.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Egg Groups.
-   */
-  listEggGroups(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Genders.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Genders.
-   */
-  listGenders(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Growth Rates.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Growth Rates.
-   */
-  listGrowthRates(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Natures.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Natures.
-   */
-  listNatures(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokéathlon Stats.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokéathlon Stats.
-   */
-  listPokeathlonStats(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokémon.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokémon.
-   */
-  listPokemons(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokémon Colors.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokémon Colors.
-   */
-  listPokemonColors(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokémon Forms.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokémon Forms.
-   */
-  listPokemonForms(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokémon Habitats.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokémon Habitats.
-   */
-  listPokemonHabitats(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokémon Shapes.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokémon Shapes.
-   */
-  listPokemonShapes(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Pokémon Species.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Pokémon Species.
-   */
-  listPokemonSpecies(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Stats.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Stats.
-   */
-  listStats(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
-  /**
-   * List Types.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Types.
-   */
-  listTypes(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  /** List Abilities. Page defaults to 20 entries from offset 0. */
+  listAbilities(offset?: number, limit?: number): Promise<NamedAPIResourceList<Ability>>;
+  /** List Characteristics. Page defaults to 20 entries from offset 0. */
+  listCharacteristics(offset?: number, limit?: number): Promise<APIResourceList<Characteristic>>;
+  /** List Egg Groups. Page defaults to 20 entries from offset 0. */
+  listEggGroups(offset?: number, limit?: number): Promise<NamedAPIResourceList<EggGroup>>;
+  /** List Genders. Page defaults to 20 entries from offset 0. */
+  listGenders(offset?: number, limit?: number): Promise<NamedAPIResourceList<Gender>>;
+  /** List Growth Rates. Page defaults to 20 entries from offset 0. */
+  listGrowthRates(offset?: number, limit?: number): Promise<NamedAPIResourceList<GrowthRate>>;
+  /** List Natures. Page defaults to 20 entries from offset 0. */
+  listNatures(offset?: number, limit?: number): Promise<NamedAPIResourceList<Nature>>;
+  /** List Pokéathlon Stats. Page defaults to 20 entries from offset 0. */
+  listPokeathlonStats(offset?: number, limit?: number): Promise<NamedAPIResourceList<PokeathlonStat>>;
+  /** List Pokémon. Page defaults to 20 entries from offset 0. */
+  listPokemons(offset?: number, limit?: number): Promise<NamedAPIResourceList<Pokemon>>;
+  /** List Pokémon Colors. Page defaults to 20 entries from offset 0. */
+  listPokemonColors(offset?: number, limit?: number): Promise<NamedAPIResourceList<PokemonColor>>;
+  /** List Pokémon Forms. Page defaults to 20 entries from offset 0. */
+  listPokemonForms(offset?: number, limit?: number): Promise<NamedAPIResourceList<PokemonForm>>;
+  /** List Pokémon Habitats. Page defaults to 20 entries from offset 0. */
+  listPokemonHabitats(offset?: number, limit?: number): Promise<NamedAPIResourceList<PokemonHabitat>>;
+  /** List Pokémon Shapes. Page defaults to 20 entries from offset 0. */
+  listPokemonShapes(offset?: number, limit?: number): Promise<NamedAPIResourceList<PokemonShape>>;
+  /** List Pokémon Species. Page defaults to 20 entries from offset 0. */
+  listPokemonSpecies(offset?: number, limit?: number): Promise<NamedAPIResourceList<PokemonSpecies>>;
+  /** List Stats. Page defaults to 20 entries from offset 0. */
+  listStats(offset?: number, limit?: number): Promise<NamedAPIResourceList<Stat>>;
+  /** List Types. Page defaults to 20 entries from offset 0. */
+  listTypes(offset?: number, limit?: number): Promise<NamedAPIResourceList<Type>>;
 }
 //#endregion
 //#region src/clients/utility.client.d.ts
@@ -4275,38 +4344,36 @@ 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 {
-  /**
-   * Get a Language by its ID.
-   * @param id The Language ID.
-   * @returns The matching Language.
-   */
+  /** Get a Language by its ID. */
   getLanguageById(id: number): Promise<Language>;
-  /**
-   * Get a Language by its name.
-   * @param name The Language name.
-   * @returns The matching Language.
-   */
+  /** Get a Language by its name. */
   getLanguageByName(name: string): Promise<Language>;
   /**
-   * Get any resource by its URL, as returned inside a PokéAPI response.
-   * @param url The absolute URL of the resource.
+   * Get any resource by its URL, or by a link taken from another response.
+   *
+   * ```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 `url` is not a valid URL, or names no PokéAPI endpoint.
-   */
-  getResourceByUrl<T>(url: string): Promise<T>;
-  /**
-   * List Languages.
-   * @param offset Index of the first resource returned. Defaults to 0.
-   * @param limit How many resources per page. Defaults to 20.
-   * @returns A paginated list of Languages.
+   * @throws {TypeError} If the URL is not valid, or names no PokéAPI endpoint.
    */
-  listLanguages(offset?: number, limit?: number): Promise<NamedAPIResourceList>;
+  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>>;
 }
 //#endregion
 //#region src/clients/main.client.d.ts
@@ -4314,26 +4381,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;
@@ -4346,9 +4418,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
@@ -4368,10 +4438,107 @@ 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
-export { APIResource, Ability, AbilityEffectChange, AbilityFlavorText, AbilityPokemon, Animated, AwesomeName, BASE_URL, BERRIES, BERRY_FIRMNESSES, BERRY_FLAVORS, Berry, BerryClient, BerryFirmness, BerryFlavor, BerryFlavorMap, BlackWhite, index_d_exports as CONSTANTS, CONTEST_TYPES, CURRENCIES, type CacheStore, ChainLink, Characteristic, type ClientOptions, ContestClient, ContestComboDetail, ContestComboSets, ContestEffect, 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, EncounterVersionDetails, Endpoint, EvolutionChain, EvolutionClient, EvolutionDetail, EvolutionTrigger, type FetchLike, FireredLeafgreen, FlavorBerryMap, FlavorText, GENDERS, GENERATIONS, GROWTH_RATES, GameClient, Gender, Generation, GenerationGameIndex, GenerationIIISprites, GenerationIISprites, GenerationISprites, GenerationIVSprites, GenerationVIIISprites, GenerationVIISprites, GenerationVISprites, GenerationVSprites, 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 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, PokemonFormSprites, PokemonHabitat, PokemonHeldItem, PokemonHeldItemVersion, PokemonMove, PokemonMoveVersion, PokemonPastAbility, PokemonPastAbilitySlot, PokemonPastStat, PokemonPastType, PokemonShape, PokemonSpecies, PokemonSpeciesDexEntry, PokemonSpeciesGender, PokemonSpeciesVariety, PokemonSprites, PokemonStat, PokemonType, PokenodeError, REGIONS, RedBlue, Region, RubySapphire, STATS, Showdown, Silver, Stat, SuperContestEffect, TYPES, Type, TypePokemon, TypeRelations, TypeRelationsPast, UltraSunUltraMoon, UtilityClient, VERSIONS, VERSION_GROUPS, VerboseEffect, Version, VersionEncounterDetail, VersionGameIndex, VersionGroup, VersionGroupFlavorText, VersionSprites, XY, Yellow, consoleLogger };
+//#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
+ * The sprite sets the PokéAPI publishes for a Pokémon.
+ */
+type SpriteVariant = "default" | "official-artwork" | "home" | "dream-world" | "showdown";
+/**
+ * ## Pokemon Sprite Options
+ * Which sprite to build a URL for.
+ *
+ * The sets do not carry the same images, so the options are constrained per
+ * variant: only `default` and `showdown` have back-facing sprites, and only
+ * `official-artwork` has no gendered ones.
+ */
+type PokemonSpriteOptions = {
+  variant?: "default";
+  shiny?: boolean;
+  back?: boolean;
+  female?: boolean;
+} | {
+  variant: "showdown";
+  shiny?: boolean;
+  back?: boolean;
+  female?: boolean;
+} | {
+  variant: "home";
+  shiny?: boolean;
+  female?: boolean;
+  back?: never;
+} | {
+  variant: "official-artwork";
+  shiny?: boolean;
+  back?: never;
+  female?: never;
+} | {
+  variant: "dream-world";
+  female?: boolean;
+  shiny?: never;
+  back?: never;
+};
+/**
+ * Builds the URL of a Pokémon sprite, without a request.
+ *
+ * ```ts
+ * getPokemonSpriteUrl(25); // front, default set
+ * getPokemonSpriteUrl(25, { variant: "official-artwork" });
+ * getPokemonSpriteUrl(25, { variant: "showdown", back: true, shiny: true });
+ * ```
+ *
+ * The sprite repository does not hold every combination for every Pokémon — a
+ * back-facing sprite of a recent generation, or a gendered form of a species with
+ * one appearance, simply does not exist. This builds a well-formed URL; it does
+ * not promise the file is there.
+ *
+ * @param id The Pokémon ID. Names are not addressable — the sprites are keyed by ID.
+ * @param options Which sprite set and which facing to build for.
+ * @returns The URL of the sprite.
+ */
+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, 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.ts.map