unite-lib 1.0.2 → 1.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 unite-lib contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 unite-lib contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,203 +1,239 @@
-# unite-lib
-
-Assets and data library for **Pokémon Unite**: roster, names, images, moves, and maps. Use in any project via **npm** or **CDN**.
-
-## Install
-
-```bash
-npm install unite-lib
-```
-
-## Usage
-
-### Data and helpers
-
-```js
-import {
-  pokemons,
-  moves,
-  maps,
-  BattleType,
-  Tag,
-  getPokemonByName,
-  getPokemonByDex,
-  getPokemonsByBattleType,
-  getImageUrl,
-  getPokemonName,
-} from "unite-lib";
-
-// All roster entries
-console.log(pokemons.length);
-
-// Find by name or dex
-const pikachu = getPokemonByName("Pikachu");
-const dex25 = getPokemonByDex(25);
-
-// Filter by role
-const attackers = getPokemonsByBattleType(BattleType.ATTACKER);
-const ranged = getPokemonsByTag(Tag.RANGED);
-
-// Image URL (relative or with CDN base)
-const mainImg = getImageUrl(pikachu, "main");
-const cdnImg = getImageUrl(pikachu, "main", {
-  baseUrl: "https://cdn.jsdelivr.net/npm/unite-lib@1.0.0",
-});
-```
-
-### i18n (localized names)
-
-```js
-import { getPokemonName } from "unite-lib";
-// or
-import { getPokemonName } from "unite-lib/i18n";
-
-getPokemonName("venusaur", "en");    // "Venusaur"
-getPokemonName("venusaur", "pt-BR"); // "Venusaur"
-getPokemonName("venusaur", "ja-JP"); // "フシギバナ"
-getPokemonName("venusaur", "fr");    // "Florizarre"
-getPokemonName("venusaur", "es");    // "Venusaur"
-```
-
-Supported locales: `en`, `pt-BR`, `ja-JP`, `fr`, `es`.
-
-## Content
-
-The library includes data and images ready to use in Pokémon Unite apps, bots, and sites.
-
-### Roster (Pokémon)
-
-Roster icons and stat images for the full active roster.
-
-| Roster example | Stats example |
-|----------------|----------------|
-| ![Pikachu](pokemons/roster-pikachu.png) | ![Pikachu stats](pokemons/stat-pikachu.png) |
-| ![Charizard](pokemons/roster-charizard.png) | ![Charizard stats](pokemons/stat-charizard.png) |
-| ![Venusaur](pokemons/roster-venusaur.png) | ![Venusaur stats](pokemons/stat-venusaur.png) |
-
-### Moves
-
-Move images (slot 1 and 2, variants 1 and 2) per Pokémon.
-
-| Slot 1.1 | Slot 1.2 | Slot 2.1 | Slot 2.2 |
-|----------|----------|----------|----------|
-| ![Pikachu S11](moves/pikachu_s11.png) | ![Pikachu S12](moves/pikachu_s12.png) | ![Pikachu S21](moves/pikachu_s21.png) | ![Pikachu S22](moves/pikachu_s22.png) |
-
-### Maps
-
-Game map images (Remoat Stadium, Theia Sky Ruins, Mer Stadium, etc.).
-
-![Map](maps/groudon.png)
-
----
-
-## Local development (testing without publishing to npm)
-
-To test the library in another project on your machine without publishing to npm:
-
-### 1. Build the library
-
-From the **unite-lib** folder:
-
-```bash
-cd unite-lib
-npm run build
-```
-
-### 2. Use in your project
-
-**Option A — `npm link` (symlink, great for development)**
-
-From the library folder:
-
-```bash
-npm link
-```
-
-In your other project (e.g. the app that consumes the library):
-
-```bash
-cd /path/to/your/project
-npm link unite-lib
-```
-
-From then on, `import { pokemons, getPokemonName } from "unite-lib"` uses the local version. When you change the library, run `npm run build` again; the consuming project already points to the same package.
-
-To undo in the consuming project: `npm unlink unite-lib`.
-
-**Option B — `file:` dependency (install from path)**
-
-In your project's `package.json`, add:
-
-```json
-{
-  "dependencies": {
-    "unite-lib": "file:../unite-lib"
-  }
-}
-```
-
-Adjust `../unite-lib` to the relative (or absolute) path to the library folder. Then:
-
-```bash
-npm install
-```
-
-Whenever you change the library, run `npm run build` in it and, to refresh the copy in the consumer, run `npm install` again in the project (or use `npm update unite-lib`).
-
-### Images when testing locally
-
-Image paths are relative (e.g. `pokemons/roster-venusaur.png`). In the consumer you can:
-
-- Use **baseUrl** when calling `getImageUrl(pokemon, "main", { baseUrl: "http://localhost:3000/node_modules/unite-lib" })` if the bundler/server serves `node_modules`, or
-- Point **baseUrl** to where the `pokemons/`, `moves/`, and `maps/` folders are available in your app.
-
----
-
-## CDN (browser)
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/unite-lib@latest/dist/index.global.js"></script>
-<script>
-  const { pokemons, getPokemonName, BattleType } = window.UniteLib;
-</script>
-```
-
-Asset URLs via jsDelivr (substitua `@latest` por uma versão se quiser):
-
-- `https://cdn.jsdelivr.net/npm/unite-lib@latest/pokemons/roster-venusaur.png`
-- `https://cdn.jsdelivr.net/npm/unite-lib@latest/moves/venusaur_s11.png`
-
-## API overview
-
-| Export | Description |
-|--------|-------------|
-| `pokemons` | Full roster (name, dex, images, battleType, stats, tags, difficulty) |
-| `moves` | Move list (pokemonId, slotId, name, image) |
-| `maps` | Map list (id, name, image, 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` |
-| `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`) |
-
-## Project structure
-
-- **`dist/`** — Built ESM, CJS, and IIFE; type definitions (`.d.ts`)
-- **`pokemons/`** — Roster and stat images
-- **`moves/`** — Move images
-- **`maps/`** — Map images
-- **`.cursor/skills/`** — [Cursor Agent Skills](https://docs.cursor.com/context/agent-skills) for use with AI agents in this repo (e.g. syncing roster from images in `pokemons/` and `moves/`).
-- **`mcp/`** — [MCP server](mcp/README.md) (Model Context Protocol) para consumir a library em agentes de IA: tools para listar e buscar pokémons, moves, mapas, URLs de imagens e nomes localizados (Cursor, Claude Desktop, etc.).
-
-## License
-
-MIT. See [LICENSE](LICENSE).
-
-## Contributing
-
-Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and workflow.
+# unite-lib
+
+Assets and data library for **Pokémon Unite**: roster, names, images, moves, and maps. Use in any project via **npm** or **CDN**.
+
+## Install
+
+```bash
+npm install unite-lib
+```
+
+## Usage
+
+### Data and helpers
+
+```js
+import {
+  pokemons,
+  moves,
+  maps,
+  BattleType,
+  Tag,
+  getPokemonByName,
+  getPokemonByDex,
+  getPokemonsByBattleType,
+  getImageUrl,
+  getPokemonName,
+} from "unite-lib";
+
+// All roster entries
+console.log(pokemons.length);
+
+// Find by name or dex
+const pikachu = getPokemonByName("Pikachu");
+const dex25 = getPokemonByDex(25);
+
+// Filter by role
+const attackers = getPokemonsByBattleType(BattleType.ATTACKER);
+const ranged = getPokemonsByTag(Tag.RANGED);
+
+// Image URL (relative or with CDN base)
+const mainImg = getImageUrl(pikachu, "main");
+const cdnImg = getImageUrl(pikachu, "main", {
+  baseUrl: "https://cdn.jsdelivr.net/npm/unite-lib@1.0.0",
+});
+```
+
+### i18n (localized names)
+
+```js
+import { getPokemonName } from "unite-lib";
+// or
+import { getPokemonName } from "unite-lib/i18n";
+
+getPokemonName("venusaur", "en");    // "Venusaur"
+getPokemonName("venusaur", "pt-BR"); // "Venusaur"
+getPokemonName("venusaur", "ja-JP"); // "フシギバナ"
+getPokemonName("venusaur", "fr");    // "Florizarre"
+getPokemonName("venusaur", "es");    // "Venusaur"
+```
+
+Supported locales: `en`, `pt-BR`, `ja-JP`, `fr`, `es`.
+
+## Content
+
+The library includes data and images ready to use in Pokémon Unite apps, bots, and sites.
+
+### Roster (Pokémon)
+
+Roster icons and stat images for the full active roster.
+
+| Roster example | Stats example |
+|----------------|----------------|
+| ![Pikachu](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/pokemons/roster-pikachu.png) | ![Pikachu stats](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/pokemons/stat-pikachu.png) |
+| ![Charizard](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/pokemons/roster-charizard.png) | ![Charizard stats](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/pokemons/stat-charizard.png) |
+| ![Venusaur](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/pokemons/roster-venusaur.png) | ![Venusaur stats](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/pokemons/stat-venusaur.png) |
+
+### Moves
+
+Move images (slot 1 and 2, variants 1 and 2) per Pokémon.
+
+| Slot 1.1 | Slot 1.2 | Slot 2.1 | Slot 2.2 |
+|----------|----------|----------|----------|
+| ![Pikachu S11](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/moves/pikachu_s11.png) | ![Pikachu S12](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/moves/pikachu_s12.png) | ![Pikachu S21](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/moves/pikachu_s21.png) | ![Pikachu S22](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/moves/pikachu_s22.png) |
+
+### Maps
+
+Game map images (Remoat Stadium, Theia Sky Ruins, Mer Stadium, etc.).
+
+![Map](https://raw.githubusercontent.com/cesaroeduardo/unite-lib/main/maps/groudon.png)
+
+---
+
+## Local development (testing without publishing to npm)
+
+To test the library in another project on your machine without publishing to npm:
+
+### 1. Build the library
+
+From the **unite-lib** folder:
+
+```bash
+cd unite-lib
+npm run build
+```
+
+### 2. Use in your project
+
+**Option A — `npm link` (symlink, great for development)**
+
+From the library folder:
+
+```bash
+npm link
+```
+
+In your other project (e.g. the app that consumes the library):
+
+```bash
+cd /path/to/your/project
+npm link unite-lib
+```
+
+From then on, `import { pokemons, getPokemonName } from "unite-lib"` uses the local version. When you change the library, run `npm run build` again; the consuming project already points to the same package.
+
+To undo in the consuming project: `npm unlink unite-lib`.
+
+**Option B — `file:` dependency (install from path)**
+
+In your project's `package.json`, add:
+
+```json
+{
+  "dependencies": {
+    "unite-lib": "file:../unite-lib"
+  }
+}
+```
+
+Adjust `../unite-lib` to the relative (or absolute) path to the library folder. Then:
+
+```bash
+npm install
+```
+
+Whenever you change the library, run `npm run build` in it and, to refresh the copy in the consumer, run `npm install` again in the project (or use `npm update unite-lib`).
+
+### Images when testing locally
+
+Image paths are relative (e.g. `pokemons/roster-venusaur.png`). In the consumer you can:
+
+- Use **baseUrl** when calling `getImageUrl(pokemon, "main", { baseUrl: "http://localhost:3000/node_modules/unite-lib" })` if the bundler/server serves `node_modules`, or
+- Point **baseUrl** to where the `pokemons/`, `moves/`, and `maps/` folders are available in your app.
+
+---
+
+## CDN (browser)
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/unite-lib@latest/dist/index.global.js"></script>
+<script>
+  const { pokemons, getPokemonName, BattleType } = window.UniteLib;
+</script>
+```
+
+Asset URLs via jsDelivr (substitua `@latest` por uma versão se quiser):
+
+- `https://cdn.jsdelivr.net/npm/unite-lib@latest/pokemons/roster-venusaur.png`
+- `https://cdn.jsdelivr.net/npm/unite-lib@latest/moves/venusaur_s11.png`
+
+## API overview
+
+| Export | Description |
+|--------|-------------|
+| `pokemons` | Full roster (name, dex, images, battleType, stats, tags, difficulty) |
+| `moves` | Move list (pokemonId, slotId, name, image) |
+| `maps` | Map list (id, name, image, 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` |
+| `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`) |
+
+## Project structure
+
+- **`dist/`** — Built ESM, CJS, and IIFE; type definitions (`.d.ts`)
+- **`pokemons/`** — Roster and stat images
+- **`moves/`** — Move images
+- **`maps/`** — Map images
+- **`.cursor/skills/`** — [Cursor Agent Skills](https://docs.cursor.com/context/agent-skills) for use with AI agents in this repo (e.g. syncing roster from images in `pokemons/` and `moves/`).
+- **`mcp/`** — [MCP server](mcp/README.md) (Model Context Protocol) para consumir a library em agentes de IA: tools para listar e buscar pokémons, moves, mapas, URLs de imagens e nomes localizados (Cursor, Claude Desktop, etc.).
+
+## Releases (publicação no npm)
+
+As versões e a publicação no npm são feitas automaticamente com [semantic-release](https://github.com/semantic-release/semantic-release) quando há **push na branch `main`**.
+
+### Como a versão é definida
+
+Os commits seguem [Conventional Commits](https://www.conventionalcommits.org/). O semantic-release usa isso para decidir o tipo de release:
+
+| Tipo de commit   | Efeito na versão |
+|------------------|-------------------|
+| `feat:`          | **MINOR** (1.**x**.0) — nova funcionalidade |
+| `fix:`, `perf:`, `docs:` (sem escopo de código) | **PATCH** (1.0.**x**) — correção ou melhoria |
+| `BREAKING CHANGE` ou `!` no escopo (ex.: `feat!:`) | **MAJOR** (**x**.0.0) — mudança incompatível |
+
+Exemplos:
+
+```bash
+git commit -m "feat: add Mega Charizard Y to roster"
+git commit -m "fix: correct Venusaur stat image path"
+git commit -m "feat!: change getImageUrl signature"   # breaking → MAJOR
+```
+
+Commits que não indicam release (ex.: `chore:`, `style:`, `test:`) não geram nova versão; mesmo assim o push na `main` roda o workflow (que pode não publicar nada).
+
+### O que você precisa configurar
+
+1. **Token do npm (NPM_TOKEN)**  
+   No repositório no GitHub: **Settings → Secrets and variables → Actions** e crie um secret chamado **`NPM_TOKEN`**.
+   - Crie o token em [npmjs.com → Access Tokens](https://www.npmjs.com/settings/~youruser/tokens): “Automation” ou “Publish”.
+   - Cole o valor no secret `NPM_TOKEN`.
+
+2. **Conventional Commits**  
+   Para haver release, use pelo menos um commit com `feat:` ou `fix:` (ou breaking) no histórico desde a última tag. Se todos forem `chore:`/`style:`/`test:`, nenhuma versão será publicada.
+
+Depois disso, ao dar push na `main`, o workflow **Release** roda, o semantic-release analisa os commits, atualiza a versão no `package.json`, gera/atualiza o `CHANGELOG.md`, cria a release no GitHub e publica o pacote no npm.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and workflow.

package/dist/i18n/index.cjs

@@ -709,6 +709,56 @@ var pokemons = [
     ],
     "difficulty": 1
   },
+  {
+    "name": "Zapdos",
+    "dex": 145,
+    "images": {
+      "main": "pokemons/roster-zapdos.png",
+      "big": "pokemons/roster-zapdos-2x.png",
+      "complete": "pokemons/stat-zapdos.png",
+      "move_s11": "moves/zapdos_s11.png",
+      "move_s21": "moves/zapdos_s21.png"
+    },
+    "active": true,
+    "battleType": BattleType.ATTACKER,
+    "stats": {
+      "offense": 5,
+      "endurance": 2,
+      "mobility": 1,
+      "scoring": 2,
+      "support": 2
+    },
+    "tags": [
+      Tag.ATTACKER,
+      Tag.RANGED
+    ],
+    "difficulty": 1
+  },
+  {
+    "name": "Moltres",
+    "dex": 146,
+    "images": {
+      "main": "pokemons/roster-moltres.png",
+      "big": "pokemons/roster-moltres-2x.png",
+      "complete": "pokemons/stat-moltres.png",
+      "move_s11": "moves/moltres_s11.png",
+      "move_s21": "moves/moltres_s21.png"
+    },
+    "active": true,
+    "battleType": BattleType.ALLROUNDER,
+    "stats": {
+      "offense": 4,
+      "endurance": 2.5,
+      "mobility": 2,
+      "scoring": 2,
+      "support": 2
+    },
+    "tags": [
+      Tag.ALLROUNDER,
+      Tag.MELEE
+    ],
+    "difficulty": 2
+  },
   {
     "name": "Dragonite",
     "dex": 149,
@@ -737,7 +787,7 @@ var pokemons = [
     "difficulty": 1
   },
   {
-    "name": "Mewtwo X",
+    "name": "Mega Mewtwo X",
     "dex": 150,
     "images": {
       "main": "pokemons/roster-mewtwox.png",
@@ -764,7 +814,7 @@ var pokemons = [
     "difficulty": 1
   },
   {
-    "name": "Mewtwo Y",
+    "name": "Mega Mewtwo Y",
     "dex": 150,
     "images": {
       "main": "pokemons/roster-mewtwoy.png",
@@ -1787,8 +1837,7 @@ var pokemons = [
       "complete": "pokemons/stat-dhelmise.png",
       "move_s11": "moves/dhelmise_s11.png",
       "move_s12": "moves/dhelmise_s12.png",
-      "move_s21": "moves/dhelmise_s21.png",
-      "move_s22": "moves/dhelmise_s22.png"
+      "move_s21": "moves/dhelmise_s21.png"
     },
     "active": true,
     "battleType": BattleType.ALLROUNDER,
@@ -2389,6 +2438,7 @@ var jaJP = {
   lapras: "\u30E9\u30D7\u30E9\u30B9",
   vaporeon: "\u30B7\u30E3\u30EF\u30FC\u30BA",
   snorlax: "\u30AB\u30D3\u30B4\u30F3",
+  zapdos: "\u30B5\u30F3\u30C0\u30FC",
   dragonite: "\u30AB\u30A4\u30EA\u30E5\u30FC",
   mewtwox: "\u30E1\u30AC\u30DF\u30E5\u30A6\u30C4\u30FCX",
   mewtwoy: "\u30E1\u30AC\u30DF\u30E5\u30A6\u30C4\u30FCY",
@@ -2480,6 +2530,7 @@ var fr = {
   lapras: "Lokhlass",
   vaporeon: "Aquali",
   snorlax: "Ronflex",
+  zapdos: "\xC9lecthor",
   dragonite: "Dracolosse",
   mewtwox: "M\xE9ga-Mewtwo X",
   mewtwoy: "M\xE9ga-Mewtwo Y",
@@ -2571,6 +2622,7 @@ var es = {
   lapras: "Lapras",
   vaporeon: "Vaporeon",
   snorlax: "Snorlax",
+  zapdos: "Zapdos",
   dragonite: "Dragonite",
   mewtwox: "Mega-Mewtwo X",
   mewtwoy: "Mega-Mewtwo Y",