whiteoutlib 0.1.6

// SPDX-License-Identifier: BSD-3-Clause
// Copyright (c) 2026 Fernando Sahmkow

#pragma once

/**
 * @file parser.h
 * @brief JPEG file parser
 *
 * This file provides the Parser class for reading and decoding standard JPEG
 * (JFIF/Exif) files.  It supports baseline sequential DCT (SOF0) images with
 * 1 (grayscale) or 3 (Y'CbCr) components, including chroma subsampling.
 *
 * Parsing is non-throwing. Issues are collected and can be queried via
 * `hasIssues()` / `getIssues()`; on failure the parse methods return
 * `std::nullopt`.
 */

#include <memory>
#include <optional>
#include <span>
#include <string>
#include <vector>

#include <whiteout/common_types.h>
#include <whiteout/textures/parser.h>
#include <whiteout/textures/texture.h>

namespace whiteout::interfaces {
class WorkerPool;
}

namespace whiteout::textures::jpeg {

// ============================================================================
// Parser
// ============================================================================

/// Reads a JPEG file or byte buffer and decodes it into a Texture.
/// @bind methods=buffer_only, js_name=JpegParser
class Parser : public textures::Parser {
public:
    explicit Parser(interfaces::WorkerPool* pool = nullptr);
    ~Parser();

    Parser(const Parser&) = delete;
    Parser& operator=(const Parser&) = delete;

    /// Parse a JPEG file from disk.
    std::optional<Texture> parse(const std::string& filePath) override;

    /// Parse a JPEG byte buffer.
    std::optional<Texture> parse(std::span<const u8> buffer) override;

    /// @return true if the last parse produced any issues.
    bool hasIssues() const;

    /// @return accumulated issues from the last parse call.
    const std::vector<std::string>& getIssues() const;

private:
    class Impl;
    std::unique_ptr<Impl> pImpl;
};

} // namespace whiteout::textures::jpeg