unite-lib 1.1.0 → 1.2.0

package/README.md

@@ -47,18 +47,24 @@ const cdnImg = getImageUrl(pikachu, "main", {
 ### i18n (localized names)
 
 ```js
-import { getPokemonName } from "unite-lib";
+import { getPokemonName, getMapName, getMapDescription } from "unite-lib";
 // or
-import { getPokemonName } from "unite-lib/i18n";
+import { getPokemonName, getMapName, getMapDescription } from "unite-lib/i18n";
 
+// Pokémon names
 getPokemonName("venusaur", "en");    // "Venusaur"
 getPokemonName("venusaur", "pt-BR"); // "Venusaur"
 getPokemonName("venusaur", "ja-JP"); // "フシギバナ"
 getPokemonName("venusaur", "fr");    // "Florizarre"
 getPokemonName("venusaur", "es");    // "Venusaur"
+
+// Map names and descriptions (optional — use when you need localized UI)
+getMapName("map-groudon", "en");       // "Theia Sky Ruins"
+getMapName("map-groudon", "pt-BR");   // "Ruínas Celestes de Theia"
+getMapDescription("map-groudon", "es"); // "Mapa 5v5 con Groudon."
 ```
 
-Supported locales: `en`, `pt-BR`, `ja-JP`, `fr`, `es`.
+Supported locales: `en`, `pt-BR`, `ja-JP`, `fr`, `es`. Each map in `maps` has a default `name` and `description` (English); use `getMapName(mapId, locale)` and `getMapDescription(mapId, locale)` when you want to show them in another language.
 
 ## Content
 
@@ -84,7 +90,7 @@ Move images (slot 1 and 2, variants 1 and 2) per Pokémon.
 
 ### Maps
 
-Game map images (Remoat Stadium, Theia Sky Ruins, Mer Stadium, etc.).
+Game map images (Theia Sky Ruins variants: Groudon, Kyogre, Rayquaza). Each map has multiple resolutions (1x, 2x, 4x); use `getMapImageUrl(map, resolution?, options?)` to pick one. Names and descriptions are available in all supported locales via `getMapName(mapId, locale)` and `getMapDescription(mapId, locale)` (see [i18n](#i18n-localized-names)).
 
 ![Map](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/maps/groudon.png)
 
@@ -173,17 +179,20 @@ Asset URLs via jsDelivr (substitua `@latest` por uma versão se quiser):
 |--------|-------------|
 | `pokemons` | Full roster (name, dex, images, battleType, stats, tags, difficulty) |
 | `moves` | Move list (pokemonId, slotId, name, image) |
-| `maps` | Map list (id, name, image, description) |
+| `maps` | Map list (id, name, image, images by resolution, description) |
 | `BattleType` | `attacker`, `defender`, `allrounder`, `speedster`, `supporter` |
 | `Tag` | Role + style: `attacker`, `defender`, `melee`, `ranged`, … |
 | `getImageUrl(pokemon, key, options?)` | Image path or full URL with `baseUrl` |
+| `getMapImageUrl(map, resolution?, options?)` | Map image URL (resolution: `"1"`, `"2"`, `"4"`) |
 | `getPokemonByName(name)` | Find by display name |
 | `getPokemonByDex(dex)` | Find by Pokédex number |
 | `getPokemonBySlug(slug)` | Find by slug (e.g. `venusaur`) |
 | `getPokemonsByBattleType(type)` | Filter by BattleType |
 | `getPokemonsByTag(tag)` | Filter by Tag |
 | `getActivePokemons()` | Only active roster entries |
-| `getPokemonName(slug, locale)` | Localized name (from main package or `unite-lib/i18n`) |
+| `getPokemonName(slug, locale)` | Localized Pokémon name (from main package or `unite-lib/i18n`) |
+| `getMapName(mapId, locale)` | Localized map name |
+| `getMapDescription(mapId, locale)` | Localized map description |
 
 ## Project structure
 

package/dist/i18n/index.cjs

@@ -23,6 +23,8 @@ __export(i18n_exports, {
   en: () => en_default,
   es: () => es_default,
   fr: () => fr_default,
+  getMapDescription: () => getMapDescription,
+  getMapName: () => getMapName,
   getPokemonName: () => getPokemonName,
   jaJP: () => ja_JP_default,
   ptBR: () => pt_BR_default
@@ -2397,6 +2399,44 @@ var pokemons = [
 ];
 var pokemons_default = pokemons;
 
+// src/maps.ts
+var maps = [
+  {
+    id: "map-groudon",
+    name: "Theia Sky Ruins",
+    image: "maps/map-groudon/map-groudon@4x.png",
+    images: {
+      "1": "maps/map-groudon/map-groudon@1x.png",
+      "2": "maps/map-groudon/map-groudon@2x.png",
+      "4": "maps/map-groudon/map-groudon@4x.png"
+    },
+    description: "Map with Groudon."
+  },
+  {
+    id: "map-kyogre",
+    name: "Theia Sky Ruins",
+    image: "maps/map-kyogre/map-kyogre@4x.png",
+    images: {
+      "1": "maps/map-kyogre/map-kyogre@1x.png",
+      "2": "maps/map-kyogre/map-kyogre@2x.png",
+      "4": "maps/map-kyogre/map-kyogre@4x.png"
+    },
+    description: "Map with Kyogre."
+  },
+  {
+    id: "map-rayquaza",
+    name: "Theia Sky Ruins",
+    image: "maps/map-rayquaza/map-rayquaza@4x.png",
+    images: {
+      "1": "maps/map-rayquaza/map-rayquaza@1x.png",
+      "2": "maps/map-rayquaza/map-rayquaza@2x.png",
+      "4": "maps/map-rayquaza/map-rayquaza@4x.png"
+    },
+    description: "Map with Rayquaza."
+  }
+];
+var maps_default = maps;
+
 // src/i18n/en.ts
 function slugFromMain(mainPath) {
   return mainPath.replace(/^pokemons\/roster-/, "").replace(/\.png$/, "");
@@ -2405,10 +2445,23 @@ var names = {};
 for (const p of pokemons_default) {
   names[slugFromMain(p.images.main)] = p.name;
 }
+for (const m of maps_default) {
+  names[m.id] = m.name;
+  if (m.description) names[`${m.id}.description`] = m.description;
+}
 var en_default = names;
 
 // src/i18n/pt-BR.ts
-var ptBR = { ...en_default };
+var ptBR = {
+  ...en_default,
+  // Maps — names and descriptions
+  "map-groudon": "Ru\xEDnas Celestes de Theia",
+  "map-groudon.description": "Mapa 5v5 com Groudon.",
+  "map-kyogre": "Ru\xEDnas Celestes de Theia",
+  "map-kyogre.description": "Mapa 5v5 com Kyogre.",
+  "map-rayquaza": "Ru\xEDnas Celestes de Theia",
+  "map-rayquaza.description": "Mapa 5v5 com Rayquaza."
+};
 var pt_BR_default = ptBR;
 
 // src/i18n/ja-JP.ts
@@ -2499,7 +2552,14 @@ var jaJP = {
   armarouge: "\u30B0\u30EC\u30F3\u30A2\u30EB\u30DE",
   ceruledge: "\u30BD\u30A6\u30D6\u30EC\u30A4\u30BA",
   tinkaton: "\u30C7\u30AB\u30CC\u30C1\u30E3\u30F3",
-  miraidon: "\u30DF\u30E9\u30A4\u30C9\u30F3"
+  miraidon: "\u30DF\u30E9\u30A4\u30C9\u30F3",
+  // Maps — names and descriptions
+  "map-groudon": "\u30C6\u30A4\u30A2\u306E\u5929\u7A7A\u907A\u8DE1",
+  "map-groudon.description": "\u30B0\u30E9\u30FC\u30C9\u30F3\u304C\u767B\u5834\u3059\u308B5v5\u30DE\u30C3\u30D7\u3002",
+  "map-kyogre": "\u30C6\u30A4\u30A2\u306E\u5929\u7A7A\u907A\u8DE1",
+  "map-kyogre.description": "\u30AB\u30A4\u30AA\u30FC\u30AC\u304C\u767B\u5834\u3059\u308B5v5\u30DE\u30C3\u30D7\u3002",
+  "map-rayquaza": "\u30C6\u30A4\u30A2\u306E\u5929\u7A7A\u907A\u8DE1",
+  "map-rayquaza.description": "\u30EC\u30C3\u30AF\u30A6\u30B6\u304C\u767B\u5834\u3059\u308B5v5\u30DE\u30C3\u30D7\u3002"
 };
 var ja_JP_default = jaJP;
 
@@ -2591,7 +2651,14 @@ var fr = {
   armarouge: "Carmadura",
   ceruledge: "Malvalame",
   tinkaton: "Forgerette",
-  miraidon: "Miraidon"
+  miraidon: "Miraidon",
+  // Maps — names and descriptions
+  "map-groudon": "Ruines C\xE9lestes de Theia",
+  "map-groudon.description": "Carte 5v5 avec Groudon.",
+  "map-kyogre": "Ruines C\xE9lestes de Theia",
+  "map-kyogre.description": "Carte 5v5 avec Kyogre.",
+  "map-rayquaza": "Ruines C\xE9lestes de Theia",
+  "map-rayquaza.description": "Carte 5v5 avec Rayquaza."
 };
 var fr_default = fr;
 
@@ -2683,7 +2750,14 @@ var es = {
   armarouge: "Armarouge",
   ceruledge: "Ceruledge",
   tinkaton: "Tinkaton",
-  miraidon: "Miraidon"
+  miraidon: "Miraidon",
+  // Maps — names and descriptions
+  "map-groudon": "Ruinas Celestiales de Theia",
+  "map-groudon.description": "Mapa 5v5 con Groudon.",
+  "map-kyogre": "Ruinas Celestiales de Theia",
+  "map-kyogre.description": "Mapa 5v5 con Kyogre.",
+  "map-rayquaza": "Ruinas Celestiales de Theia",
+  "map-rayquaza.description": "Mapa 5v5 con Rayquaza."
 };
 var es_default = es;
 
@@ -2699,11 +2773,22 @@ function getPokemonName(id, locale = "en") {
   const map = locales[locale] ?? en_default;
   return map[id] ?? en_default[id] ?? id;
 }
+function getMapName(mapId, locale = "en") {
+  const map = locales[locale] ?? en_default;
+  return map[mapId] ?? en_default[mapId] ?? mapId;
+}
+function getMapDescription(mapId, locale = "en") {
+  const key = `${mapId}.description`;
+  const map = locales[locale] ?? en_default;
+  return map[key] ?? en_default[key] ?? "";
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   en,
   es,
   fr,
+  getMapDescription,
+  getMapName,
   getPokemonName,
   jaJP,
   ptBR