major: initial release

* initial development

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* pokemon

* pokemon

* pokemon

* pokemon

* pokemon

* pokemon

* improvements

* improvements

* ci/cd

* ci/cd

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

---------

Co-authored-by: sdine <sdine@sdine.com>

core/include/ccm/games/pokemon/PokemonCardPreviewSource.hpp

@@ -0,0 +1,42 @@
+#pragma once
+
+// PokemonCardPreviewSource: ICardPreviewSource implementation for the Pokemon
+// TCG. Calls the Pokemon TCG search endpoint at
+//   https://api.pokemontcg.io/v2/cards?q=name:"<name>" set.id:<setId> number:<setNo>
+// and returns `data[0].images.large` (with `images.small` as a graceful
+// fallback). Mirrors the established `getImage` flow in
+// `src/components/pokemon/SelectedPokemonPanel.tsx`.
+
+#include "ccm/ports/ICardPreviewSource.hpp"
+#include "ccm/ports/IHttpClient.hpp"
+
+#include <string>
+#include <string_view>
+
+namespace ccm {
+
+class PokemonCardPreviewSource final : public ICardPreviewSource {
+public:
+    explicit PokemonCardPreviewSource(IHttpClient& http);
+
+    Result<std::string> fetchImageUrl(std::string_view name,
+                                      std::string_view setId,
+                                      std::string_view setNo) override;
+
+    // Build the fully URL-encoded Pokemon TCG search URL for the given card.
+    // Exposed for unit testing and to keep encoding rules in one place.
+    static std::string buildSearchUrl(std::string_view name,
+                                      std::string_view setId,
+                                      std::string_view setNo);
+
+    // Parse a Pokemon TCG /v2/cards response body and pull out the image URL
+    // for the first matching card. Prefers `images.large`, falls back to
+    // `images.small`, and returns an error result if neither is present, the
+    // data array is empty, or the JSON is malformed.
+    static Result<std::string> parseResponse(const std::string& body);
+
+private:
+    IHttpClient& http_;
+};
+
+}  // namespace ccm

core/include/ccm/games/pokemon/PokemonGameModule.hpp

@@ -0,0 +1,28 @@
+#pragma once
+
+// PokemonGameModule: IGameModule for the Pokemon TCG. Owns its set source
+// and card preview source, both backed by api.pokemontcg.io/v2.
+
+#include "ccm/games/IGameModule.hpp"
+#include "ccm/games/pokemon/PokemonCardPreviewSource.hpp"
+#include "ccm/games/pokemon/PokemonSetSource.hpp"
+
+namespace ccm {
+
+class PokemonGameModule final : public IGameModule {
+public:
+    explicit PokemonGameModule(IHttpClient& http);
+
+    [[nodiscard]] Game        id() const noexcept override { return Game::Pokemon; }
+    [[nodiscard]] std::string dirName()     const override { return "pokemon"; }
+    [[nodiscard]] std::string displayName() const override { return "Pokemon"; }
+
+    ISetSource&         setSource()          override { return setSource_; }
+    ICardPreviewSource* cardPreviewSource() noexcept override { return &previewSource_; }
+
+private:
+    PokemonSetSource          setSource_;
+    PokemonCardPreviewSource  previewSource_;
+};
+
+}  // namespace ccm

core/include/ccm/games/pokemon/PokemonSetSource.hpp

@@ -0,0 +1,30 @@
+#pragma once
+
+// PokemonSetSource: ISetSource implementation for the Pokemon TCG.
+// Calls the Pokemon TCG API at https://api.pokemontcg.io/v2/sets, maps the
+// response into our `Set` domain type, and sorts by release date ascending.
+// The Pokemon TCG API already returns `releaseDate` in `YYYY/MM/DD` format,
+// so no rewriting is needed (unlike Scryfall's `released_at`).
+// Behavior matches `pokemon/set_services.rs::update_sets`.
+
+#include "ccm/games/IGameModule.hpp"
+#include "ccm/ports/IHttpClient.hpp"
+
+namespace ccm {
+
+class PokemonSetSource final : public ISetSource {
+public:
+    static constexpr const char* kEndpoint = "https://api.pokemontcg.io/v2/sets";
+
+    explicit PokemonSetSource(IHttpClient& http);
+
+    Result<std::vector<Set>> fetchAll() override;
+
+    // Pure parser exposed for unit testing without a network round-trip.
+    static Result<std::vector<Set>> parseResponse(const std::string& body);
+
+private:
+    IHttpClient& http_;
+};
+
+}  // namespace ccm