@pietrovich/wot-utils 0.2.0

package/.env.example

@@ -0,0 +1,3 @@
+WG_APP_ID=WG_APP_ID_HERE
+WG_CACHE_DIR=.data/wg/cache
+TOMATO_API_KEY=YOUR_TOMATO_API_KEY_HERE

package/LICENSE

@@ -0,0 +1,13 @@
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                    Version 2, December 2004
+
+ Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+ Everyone is permitted to copy and distribute verbatim or modified
+ copies of this license document, and changing it is allowed as long
+ as the name is changed.
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.

package/README.md

@@ -0,0 +1,109 @@
+# pie-wot
+
+A CLI toolkit for World of Tanks modders. Fetches live vehicle data from the Wargaming API, manipulates DDS textures and texture atlases, and generates custom icon sets — all from the terminal, no build step required.
+
+The long-term goal is to make it trivial to maintain and publish a custom icon set: when new vehicles are added to the game or tank characteristics change, re-running a handful of commands should be enough to produce an updated, publish-ready set. The [PogS icon set](https://github.com/pavelmaca/WoT-PogsIconSet) by @pavelmaca serves as the reference implementation and first supported style.
+
+## Pre-baked ready to use sets
+
+If you just want the icons without running the pipeline yourself, pre-baked sets are published periodically at [pietrovich/wot-pogs-like-icon-sets](https://github.com/pietrovich/wot-pogs-like-icon-sets) and kept in sync with game updates.
+
+## Install
+
+```bash
+npm install -g @pietrovich/wot-utils
+cp .env.example .env  # add your WG_APP_ID
+```
+
+Get a free application ID at [developers.wargaming.net](https://developers.wargaming.net/).
+
+> **Node.js ≥ 24** required.
+
+## Uninstall
+
+```bash
+npm uninstall -g @pietrovich/wot-utils
+```
+
+## Commands
+
+```
+pie-wot vehicle list              # list vehicles from the WG encyclopedia (table)
+pie-wot vehicle export            # save full vehicle data to JSON
+pie-wot vehicle fetch-icons       # download official vehicle icons
+pie-wot vehicle stats             # short-name character statistics
+pie-wot vehicle best-config       # best module configuration per vehicle
+pie-wot vehicle chars             # character distribution in short names
+
+pie-wot atlas inspect <map>       # list texture names in an atlas XML
+pie-wot atlas pick <map> <img>    # extract a single named texture
+pie-wot atlas extract             # extract all textures to a directory
+pie-wot atlas pack                # pack a directory of PNGs into a texture atlas
+
+pie-wot dds decode <file>         # decode a DDS texture to PNG
+pie-wot dds encode <file>         # encode a PNG to DXT5/BC3 DDS
+
+pie-wot icon dump-background      # generate per-type background images (PogS style)
+pie-wot icon render <query>       # render a vehicle icon: type background + short name label
+
+pie-wot font render [font] [text] # render text as PNG using a pixel font
+
+pie-wot cache purge               # clear the local API response cache
+
+pie-wot bake <script>             # run a bundled build script (see below)
+```
+
+Vehicle commands accept `--app-id <id>` (overrides `WG_APP_ID`) and `--no-cache`.
+
+### bake
+
+Runs a bundled shell script that drives the full icon-bake pipeline. All arguments after the script name are forwarded to the script unchanged.
+
+```bash
+pie-wot bake clear --src ./in/wot-2.3/ --out ./out/clear
+pie-wot bake color --src ./in/wot-2.3/ --out ./out/color
+```
+
+Available scripts:
+
+| Name | Description |
+|------|-------------|
+| `clear` | PogS clear variant (no colour background) |
+| `color` | PogS colour variant with DMG/FSR/VR/RLD labels |
+
+## Development
+
+### Running from source
+
+No build step needed — `tsx` runs TypeScript directly:
+
+```bash
+npm start -- <command>
+# e.g.
+npm start -- vehicle list
+```
+
+### LOCAL_DEV
+
+The bundled baker scripts (`scripts/`) detect whether the `pie-wot` global binary is available and use it by default. Set `LOCAL_DEV=true` in your `.env` (or environment) to force them to use `npm start` from the local clone instead:
+
+```
+LOCAL_DEV=true
+```
+
+This is useful when iterating on the CLI itself — changes to `src/` take effect immediately without a publish/reinstall cycle.
+
+## How it works
+
+API responses are cached locally (SHA-256 keyed, no TTL) so repeated runs don't hammer the Wargaming API. DDS encode/decode uses a trimmed BC1/BC3 codec derived from [photopea/UTEX.js](https://github.com/photopea/UTEX.js). Image compositing uses [sharp](https://sharp.pixelplumbing.com/).
+
+## Credits
+
+- Gradient data and assets for the PogS icon style ported from [WoT-PogsIconSet](https://github.com/pavelmaca/WoT-PogsIconSet) by [@pavelmaca](https://github.com/pavelmaca)
+- DDS codec derived from [photopea/UTEX.js](https://github.com/photopea/UTEX.js) by the Photopea team
+
+---
+
+GL, HF
+
+[![wtfpl-badge-2.png](wtfpl-badge-2.png)](./LICENSE)

package/dist/assets/fonts/pogs/3px.json5

@@ -0,0 +1,102 @@
+{
+  "version": "1.0",
+  "height": 5,
+  "name": "pogs font3",
+  "glyphs": {
+    "0": [
+      "XXX",
+      "X X",
+      "X X",
+      "X X",
+      "XXX"
+    ],
+    "1": [
+      "XX",
+      " X",
+      " X",
+      " X",
+      " X"
+    ],
+    "2": [
+      "XXX",
+      "  X",
+      "XXX",
+      "X",
+      "XXX"
+    ],
+    "3": [
+      "XXX",
+      "  X",
+      " XX",
+      "  X",
+      "XXX"
+    ],
+    "4": [
+      "X X",
+      "X X",
+      "XXX",
+      "  X",
+      "  X"
+    ],
+    "5": [
+      "XXX",
+      "X",
+      "XXX",
+      "  X",
+      "XXX"
+    ],
+    "6": [
+      "XXX",
+      "X",
+      "XXX",
+      "X X",
+      "XXX"
+    ],
+    "7": [
+      "XXX",
+      "  X",
+      "  X",
+      "  X",
+      "  X"
+    ],
+    "8": [
+      "XXX",
+      "X X",
+      "XXX",
+      "X X",
+      "XXX"
+    ],
+    "9": [
+      "XXX",
+      "X X",
+      "XXX",
+      "  X",
+      "XXX"
+    ],
+    "_": [],
+    "-": [
+      "",
+      "",
+      "XX"
+    ],
+    ".": [
+      "",
+      "",
+      "",
+      "",
+      "X"
+    ],
+    " ": [],
+    " ": [],
+    "*": [
+      "",
+      "",
+      "X"
+    ],
+    "·": [
+      "",
+      "",
+      "X"
+    ]
+  }
+}

package/dist/assets/fonts/pogs/4px.json5

@@ -0,0 +1,436 @@
+{
+  "version": "1.0",
+  "height": 5,
+  "name": "pogs font4",
+  "glyphs": {
+    "0": [
+      "XXXX",
+      "X  X",
+      "X  X",
+      "X  X",
+      "XXXX"
+    ],
+    "1": [
+      "XX",
+      " X",
+      " X",
+      " X",
+      " X"
+    ],
+    "2": [
+      "XXXX",
+      "   X",
+      "XXXX",
+      "X",
+      "XXXX"
+    ],
+    "3": [
+      "XXXX",
+      "   X",
+      " XXX",
+      "   X",
+      "XXXX"
+    ],
+    "4": [
+      "X  X",
+      "X  X",
+      "XXXX",
+      "   X",
+      "   X"
+    ],
+    "5": [
+      "XXXX",
+      "X",
+      "XXXX",
+      "   X",
+      "XXXX"
+    ],
+    "6": [
+      "XXX",
+      "X",
+      "XXXX",
+      "X  X",
+      "XXXX"
+    ],
+    "7": [
+      "XXXX",
+      "   X",
+      "   X",
+      "   X",
+      "   X"
+    ],
+    "8": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "X  X",
+      "XXXX"
+    ],
+    "9": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "   X",
+      "   X"
+    ],
+    "_": [],
+    "-": [
+      "",
+      "",
+      "XXX"
+    ],
+    "–": [
+      "",
+      "",
+      "XXX"
+    ],
+    ".": [
+      "",
+      "",
+      "",
+      "",
+      "X"
+    ],
+    " ": ["   "],
+    " ": ["   "],
+    "a": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "X  X",
+      "X  X"
+    ],
+    "b": [
+      "XXXX",
+      "X   X",
+      "XXXX",
+      "X   X",
+      "XXXX"
+    ],
+    "c": [
+      "XXXX",
+      "X",
+      "X",
+      "X",
+      "XXXX"
+    ],
+    "d": [
+      "XXX",
+      "X  X",
+      "X  X",
+      "X  X",
+      "XXX"
+    ],
+    "e": [
+      "XXXX",
+      "X",
+      "XXX",
+      "X",
+      "XXXX"
+    ],
+    "f": [
+      "XXXX",
+      "X",
+      "XXX",
+      "X",
+      "X"
+    ],
+    "g": [
+      "XXXX",
+      "X",
+      "X XX",
+      "X  X",
+      "XXXX"
+    ],
+    "h": [
+      "X  X",
+      "X  X",
+      "XXXX",
+      "X  X",
+      "X  X"
+    ],
+    "i": [
+      "X",
+      "X",
+      "X",
+      "X",
+      "X"
+    ],
+    "j": [
+      "   X",
+      "   X",
+      "   X",
+      "X  X",
+      "XXXX"
+    ],
+    "k": [
+      "X  X",
+      "X X",
+      "XX",
+      "X X",
+      "X  X"
+    ],
+    "l": [
+      "X",
+      "X",
+      "X",
+      "X",
+      "XXXX"
+    ],
+    "m": [
+      "XXXXX",
+      "X X X",
+      "X X X",
+      "X X X",
+      "X X X"
+    ],
+    "n": [
+      "XXXX",
+      "X  X",
+      "X  X",
+      "X  X",
+      "X  X"
+    ],
+    "o": [
+      "XXXX",
+      "X  X",
+      "X  X",
+      "X  X",
+      "XXXX"
+    ],
+    "p": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "X",
+      "X"
+    ],
+    "q": [
+      "XXXXX",
+      "X   X",
+      "X   X",
+      "X X X",
+      "XXXXX",
+      "  X"
+    ],
+    "r": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "X X",
+      "X  X"
+    ],
+    "s": [
+      "XXXX",
+      "X",
+      "XXXX",
+      "   X",
+      "XXXX"
+    ],
+    "t": [
+      "XXXXX",
+      "  X",
+      "  X",
+      "  X",
+      "  X"
+    ],
+    "u": [
+      "X  X",
+      "X  X",
+      "X  X",
+      "X  X",
+      "XXXX"
+    ],
+    "v": [
+      "X   X",
+      "X   X",
+      "X   X",
+      " X X",
+      "  X"
+    ],
+    "w": [
+      "X X X",
+      "X X X",
+      "X X X",
+      "X X X",
+      "XXXXX"
+    ],
+    "x": [
+      "X   X",
+      " X X",
+      "  X",
+      " X X",
+      "X   X"
+    ],
+    "y": [
+      "X   X",
+      " X X",
+      "  X",
+      "  X",
+      "  X"
+    ],
+    "z": [
+      "XXXXX",
+      "   X",
+      "  X",
+      " X",
+      "XXXXX"
+    ],
+    "(": [
+      " X",
+      "X",
+      "X",
+      "X",
+      " X"
+    ],
+    ")": [
+      "X",
+      " X",
+      " X",
+      " X",
+      "X"
+    ],
+    "ö": [
+      " X X",
+      "",
+      "XXXX",
+      "X  X",
+      "XXXX"
+    ],
+    "ä": [
+      "X XX",
+      "   X",
+      "XXXX",
+      "X  X",
+      "XXXX"
+    ],
+    "т": [
+      "XXX",
+      " X",
+      " X",
+      " X",
+      " X"
+    ],
+    "а": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "X  X",
+      "X  X"
+    ],
+    "б": [
+      "XXX",
+      "X",
+      "XXXX",
+      "X  X",
+      "XXXX"
+    ],
+    "в": [
+      "XXX",
+      "X  X",
+      "XXX",
+      "X  X",
+      "XXX"
+    ],
+    "д": [
+      "  XX",
+      " X X",
+      " X X",
+      " X X",
+      "XXXXX"
+    ],
+    "і": [
+      "X",
+      "",
+      "X",
+      "X",
+      "X"
+    ],
+    "з": [
+      "XXXX",
+      "   X",
+      " XX",
+      "   X",
+      "XXXX"
+    ],
+    "к": [
+      "X  X",
+      "X X",
+      "XX",
+      "X X",
+      "X  X"
+    ],
+    "о": [
+      " X",
+      "X X",
+      "X X",
+      "X X",
+      " X"
+    ],
+    "п": [
+      "XXX",
+      "X X",
+      "X X",
+      "X X",
+      "X X"
+    ],
+    "р": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "X",
+      "X"
+    ],
+    "/": [
+      "    X",
+      "   X",
+      "  X",
+      " X",
+      "X"
+    ],
+    "*": [
+      "",
+      "",
+      "X"
+    ],
+    "×": [
+      "",
+      "X X",
+      " X",
+      "X X"
+    ],
+    "·": [
+      "",
+      "",
+      "X"
+    ],
+    "š": [
+      "XXXX",
+      "X",
+      "XXXX",
+      "   X",
+      "XXXX"
+    ],
+    "á": [
+      "XXXX",
+      "X  X",
+      "XXXX",
+      "X  X",
+      "X  X"
+    ],
+    "ô": [
+      " XX",
+      "",
+      "XXXX",
+      "X  X",
+      "XXXX"
+    ],
+    "ü": [
+      " XX",
+      "",
+      "X  X",
+      "X  X",
+      " XXX"
+    ]
+  }
+}