///
/// HybridPngUtilsSpec.hpp
/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
/// https://github.com/mrousavy/nitro
/// Copyright © 2026 Marc Rousavy @ Margelo
///

#pragma once

#if __has_include(<NitroModules/HybridObject.hpp>)
#include <NitroModules/HybridObject.hpp>
#else
#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
#endif

// Forward declaration of `TextChunk` to properly resolve imports.
namespace margelo::nitro::pngutils { struct TextChunk; }
// Forward declaration of `ReplacePngChunksOptions` to properly resolve imports.
namespace margelo::nitro::pngutils { struct ReplacePngChunksOptions; }
// Forward declaration of `TextChunkResult` to properly resolve imports.
namespace margelo::nitro::pngutils { struct TextChunkResult; }
// Forward declaration of `ExtractPngChunksOptions` to properly resolve imports.
namespace margelo::nitro::pngutils { struct ExtractPngChunksOptions; }

#include <string>
#include "TextChunk.hpp"
#include <vector>
#include "ReplacePngChunksOptions.hpp"
#include <optional>
#include "TextChunkResult.hpp"
#include "ExtractPngChunksOptions.hpp"

namespace margelo::nitro::pngutils {

  using namespace margelo::nitro;

  /**
   * An abstract base class for `PngUtils`
   * Inherit this class to create instances of `HybridPngUtilsSpec` in C++.
   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
   * @example
   * ```cpp
   * class HybridPngUtils: public HybridPngUtilsSpec {
   * public:
   *   HybridPngUtils(...): HybridObject(TAG) { ... }
   *   // ...
   * };
   * ```
   */
  class HybridPngUtilsSpec: public virtual HybridObject {
    public:
      // Constructor
      explicit HybridPngUtilsSpec(): HybridObject(TAG) { }

      // Destructor
      ~HybridPngUtilsSpec() override = default;

    public:
      // Properties
      

    public:
      // Methods
      virtual std::string replacePngChunks(const std::string& imageBase64, const std::vector<TextChunk>& chunks, const std::optional<ReplacePngChunksOptions>& options) = 0;
      virtual std::vector<TextChunkResult> extractPngChunks(const std::string& imageBase64, const std::optional<ExtractPngChunksOptions>& options) = 0;

    protected:
      // Hybrid Setup
      void loadHybridMethods() override;

    protected:
      // Tag for logging
      static constexpr auto TAG = "PngUtils";
  };

} // namespace margelo::nitro::pngutils