ftermdata.h

/***********************************************************************
* ftermdata.h - Data class for FTerm                                   *
*                                                                      *
* This file is part of the FINAL CUT widget toolkit                    *
*                                                                      *
* Copyright 2018-2026 Markus Gans                                      *
*                                                                      *
* FINAL CUT is free software; you can redistribute it and/or modify    *
* it under the terms of the GNU Lesser General Public License as       *
* published by the Free Software Foundation; either version 3 of       *
* the License, or (at your option) any later version.                  *
*                                                                      *
* FINAL CUT is distributed in the hope that it will be useful, but     *
* WITHOUT ANY WARRANTY; without even the implied warranty of           *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
* GNU Lesser General Public License for more details.                  *
*                                                                      *
* You should have received a copy of the GNU Lesser General Public     *
* License along with this program.  If not, see                        *
* <http://www.gnu.org/licenses/>.                                      *
***********************************************************************/

/*  Standalone class
 *  ════════════════
 *
 * ▕▔▔▔▔▔▔▔▔▔▔▔▏
 * ▕ FTermData ▏
 * ▕▁▁▁▁▁▁▁▁▁▁▁▏
 */

#ifndef FTERMDATA_H
#define FTERMDATA_H

#if !defined (USE_FINAL_H) && !defined (COMPILE_FINAL_CUT)
  #error "Only <final/final.h> can be included directly."
#endif

#include <atomic>
#include <bitset>
#include <memory>
#include <mutex>
#include <string>
#include <unordered_map>
#include <vector>

#include "final/fc.h"
#include "final/ftypes.h"
#include "final/util/frect.h"
#include "final/util/fstring.h"

namespace finalcut
{

//----------------------------------------------------------------------
// class FCharSubstitution
//----------------------------------------------------------------------

class FCharSubstitution
{
  public:
    struct Map
    {
      wchar_t from;
      wchar_t to;
    };

    // Constructor
    FCharSubstitution();

    auto getMappedChar (wchar_t) const noexcept -> wchar_t;
    void setCharMapping (const Map&) noexcept;
    auto isEmpty() const noexcept -> bool;
    void sort();

  private:
    std::vector<Map> sub_map{};
};

// FTermData inline functions
//----------------------------------------------------------------------
inline FCharSubstitution::FCharSubstitution()
{
  sub_map.reserve(16);
}

//----------------------------------------------------------------------
inline auto FCharSubstitution::getMappedChar (wchar_t c) const noexcept -> wchar_t
{
  auto iter = std::lower_bound ( sub_map.begin(), sub_map.end()
                               , c
                               , [] (const Map& map, wchar_t value)
                                 {
                                   return map.from < value;
                                 } );

  if ( iter == sub_map.end() || iter->from != c )
    return L'\0';

  return iter->to;
}

//----------------------------------------------------------------------
inline void FCharSubstitution::setCharMapping (const Map& m) noexcept
{
  auto iter = std::lower_bound ( sub_map.begin(), sub_map.end()
                               , m.from
                               , [] (const Map& map, wchar_t value)
                                 {
                                   return map.from < value;
                                 } );

  if ( iter != sub_map.end() && iter->from == m.from )
    iter->to = m.to;          // Update existing mapping
  else
    sub_map.insert(iter, m);  // Insert in proper sorted position
}

//----------------------------------------------------------------------
inline auto FCharSubstitution::isEmpty() const noexcept -> bool
{
  return sub_map.empty();
}

//----------------------------------------------------------------------
inline void FCharSubstitution::sort()
{
  std::sort ( sub_map.begin(), sub_map.end()
            , [] (const auto& lhs, const auto& rhs)
              {
                return lhs.from < rhs.from;
              }
            );
}


//----------------------------------------------------------------------
// class FTermData
//----------------------------------------------------------------------

class FTermData final
{
  public:
    struct kittyVersion
    {
      int primary;
      int secondary;
    };

    // Using-declaration
    using EncodingMap = std::unordered_map<std::string, Encoding>;

    // Constructors
    FTermData () = default;

    // Accessors
    auto getClassName() const -> FString;
    static auto getInstance() -> FTermData&;
    auto getEncodingList() & -> EncodingMap&;
    auto getCharSubstitutionMap() & -> FCharSubstitution&;
    auto getTerminalEncoding() const -> Encoding;
    auto getTerminalGeometry() & -> FRect&;
    auto getTerminalGeometry() const & -> const FRect&;
    auto getTTYFileDescriptor() const noexcept -> int;
    auto getBaudrate() const noexcept -> uInt;
    auto getTermType() const & -> const std::string&;
    auto getTermFileName() const & -> const std::string&;
    auto getGnomeTerminalID() const noexcept -> int;
    auto getKittyVersion() const noexcept -> kittyVersion;
    auto getXtermFont() const & -> const FString&;
    auto getXtermTitle() const & -> const FString&;
#if DEBUG
    auto getFramebufferBpp() const noexcept -> int;
#endif

    // Predicates
    auto hasShadowCharacter() const noexcept -> bool;
    auto hasHalfBlockCharacter() const noexcept -> bool;
    auto hasCursorOptimisation() const noexcept -> bool;
    auto isCursorHidden() const noexcept -> bool;
    auto hasAlternateScreen() const noexcept -> bool;
    auto isInAlternateScreen() const noexcept -> bool;
    auto hasASCIIConsole() const noexcept -> bool;
    auto hasVT100Console() const noexcept -> bool;
    auto hasUTF8Console() const noexcept -> bool;
    auto isUTF8() const noexcept -> bool;
    auto isNewFont() const noexcept -> bool;
    auto isVGAFont() const noexcept -> bool;
    auto isMonochron() const noexcept -> bool;
    auto hasTermResized() -> bool;
    auto isTermType (FTermType) const -> bool;
    auto isTermType (FTermTypeT) const -> bool;

    // Mutators
    void setTermEncoding (Encoding) noexcept;
    void setTTYFileDescriptor (int) noexcept;
    void setBaudrate (uInt) noexcept;
    void supportShadowCharacter (bool = true) noexcept;
    void supportHalfBlockCharacter (bool = true) noexcept;
    void supportCursorOptimisation (bool = true) noexcept;
    void setCursorHidden (bool = true) noexcept;
    void useAlternateScreen (bool = true) noexcept;
    void setAlternateScreenInUse (bool = true) noexcept;
    void setASCIIConsole (bool = true) noexcept;
    void setVT100Console (bool = true) noexcept;
    void setUTF8Console (bool = true) noexcept;
    void setUTF8 (bool = true) noexcept;
    void setNewFont (bool = true) noexcept;
    void setVGAFont (bool = true) noexcept;
    void setMonochron (bool = true) noexcept;
    void setTermResized (bool = true);
    void setTermType (const std::string&);
    void setTermType (FTermType);
    void unsetTermType (FTermType);
    void setTermFileName (const std::string&);
    void setGnomeTerminalID (int) noexcept;
    void setKittyVersion (const kittyVersion&);
    void setXtermFont (const FString&);
    void setXtermTitle (const FString&);
#if DEBUG
    void setFramebufferBpp (int) noexcept;
#endif

  private:
    // Encoding-related fields
    struct EncodingInfo
    {
      EncodingMap        encoding_list{};
      FCharSubstitution  char_substitution_map{};
      Encoding           term_encoding{Encoding::Unknown};
    };

    // Terminal properties
    struct TerminalProperties
    {
      FRect       terminal_geometry{};  // current terminal geometry
      FString     xterm_font{};
      FString     xterm_title{};
      FTermTypeT  terminal_type{};
      // Teletype (tty) file descriptor is still undefined (-1)
      int         fd_tty{-1};
    };

    // Version and other settings
    struct TerminalSettings
    {
      // Gnome terminal id from SecDA
      // Example: vte version 0.40.0 = 0 * 100 + 40 * 100 + 0 = 4000
      //                      a.b.c  = a * 100 +  b * 100 + c
      int           gnome_terminal_id{0};
      kittyVersion  kitty_version{0, 0};
#if DEBUG
      int           framebuffer_bpp{-1};
#endif
      uInt          baudrate{0};
      std::string   termtype{};
      std::string   term_file_name{};
    };

    // Synchronization and state
    struct SynchronizationState
    {
      std::mutex        resize_mutex{};
      std::atomic<int>  resize_count{0};
    };

    struct Flags
    {
      bool  shadow_character{true};
      bool  half_block_character{true};
      bool  cursor_optimisation{true};
      bool  hidden_cursor{false};  // Global cursor hidden state
      bool  use_alternate_screen{true};
      bool  alternate_screen{false};
      bool  ascii_console{false};
      bool  vt100_console{false};
      bool  utf8_console{false};
      bool  utf8_state{false};
      bool  new_font{false};
      bool  vga_font{false};
      bool  monochron{false};
    };

    // Data members
    EncodingInfo         encoding_info{};
    TerminalProperties   terminal_properties{};
    TerminalSettings     terminal_settings{};
    SynchronizationState synchronization_state{};
    Flags                flags{};
};

// FTermData inline functions
//----------------------------------------------------------------------
inline auto FTermData::getClassName() const -> FString
{ return "FTermData"; }

//----------------------------------------------------------------------
inline auto FTermData::getInstance() -> FTermData&
{
  static const auto& data = std::make_unique<FTermData>();
  return *data;
}

//----------------------------------------------------------------------
inline auto FTermData::getEncodingList() & -> EncodingMap&
{ return encoding_info.encoding_list; }

//----------------------------------------------------------------------
inline auto FTermData::getCharSubstitutionMap() & -> FCharSubstitution&
{ return encoding_info.char_substitution_map; }

//----------------------------------------------------------------------
inline auto FTermData::getTerminalEncoding() const -> Encoding
{ return encoding_info.term_encoding; }

//----------------------------------------------------------------------
inline auto FTermData::getTerminalGeometry() & -> FRect&
{ return terminal_properties.terminal_geometry; }

//----------------------------------------------------------------------
inline auto FTermData::getTerminalGeometry() const & -> const FRect&
{ return terminal_properties.terminal_geometry; }

//----------------------------------------------------------------------
inline auto FTermData::getTTYFileDescriptor() const noexcept -> int
{ return terminal_properties.fd_tty; }

//----------------------------------------------------------------------
inline auto FTermData::getBaudrate() const noexcept -> uInt
{ return terminal_settings.baudrate; }

//----------------------------------------------------------------------
inline auto FTermData::getTermType() const & -> const std::string&
{ return terminal_settings.termtype; }

//----------------------------------------------------------------------
inline auto FTermData::getTermFileName() const & -> const std::string&
{ return terminal_settings.term_file_name; }

//----------------------------------------------------------------------
inline auto FTermData::getGnomeTerminalID() const noexcept -> int
{ return terminal_settings.gnome_terminal_id; }

//----------------------------------------------------------------------
inline auto FTermData::getKittyVersion() const noexcept -> kittyVersion
{ return terminal_settings.kitty_version; }

//----------------------------------------------------------------------
inline auto FTermData::getXtermFont() const & -> const FString&
{ return terminal_properties.xterm_font; }

//----------------------------------------------------------------------
inline auto FTermData::getXtermTitle() const & -> const FString&
{ return terminal_properties.xterm_title; }

//----------------------------------------------------------------------
#if DEBUG
inline auto FTermData::getFramebufferBpp() const noexcept -> int
{ return terminal_settings.framebuffer_bpp; }
#endif

//----------------------------------------------------------------------
inline auto FTermData::hasShadowCharacter() const noexcept -> bool
{ return flags.shadow_character; }

//----------------------------------------------------------------------
inline auto FTermData::hasHalfBlockCharacter() const noexcept -> bool
{ return flags.half_block_character; }

//----------------------------------------------------------------------
inline auto FTermData::hasCursorOptimisation() const noexcept -> bool
{ return flags.cursor_optimisation; }

//----------------------------------------------------------------------
inline auto FTermData::isCursorHidden() const noexcept -> bool
{ return flags.hidden_cursor; }

//----------------------------------------------------------------------
inline auto FTermData::hasAlternateScreen() const noexcept -> bool
{ return flags.use_alternate_screen; }

//----------------------------------------------------------------------
inline auto FTermData::isInAlternateScreen() const noexcept -> bool
{ return flags.alternate_screen; }

//----------------------------------------------------------------------
inline auto FTermData::hasASCIIConsole() const noexcept -> bool
{ return flags.ascii_console; }

//----------------------------------------------------------------------
inline auto FTermData::hasVT100Console() const noexcept -> bool
{ return flags.vt100_console; }

//----------------------------------------------------------------------
inline auto FTermData::hasUTF8Console() const noexcept -> bool
{ return flags.utf8_console; }

//----------------------------------------------------------------------
inline auto FTermData::isUTF8() const noexcept -> bool
{ return flags.utf8_state; }

//----------------------------------------------------------------------
inline auto FTermData::isNewFont() const noexcept -> bool
{ return flags.new_font; }

//----------------------------------------------------------------------
inline auto FTermData::isVGAFont() const noexcept -> bool
{ return flags.vga_font; }

//----------------------------------------------------------------------
inline auto FTermData::isMonochron() const noexcept -> bool
{ return flags.monochron; }

//----------------------------------------------------------------------
inline auto FTermData::hasTermResized() -> bool
{
  std::lock_guard<std::mutex> resize_lock_guard(synchronization_state.resize_mutex);
  return synchronization_state.resize_count.load() > 0;
}

//----------------------------------------------------------------------
inline auto FTermData::isTermType (FTermType type) const -> bool
{ return terminal_properties.terminal_type & static_cast<FTermTypeT>(type); }

//----------------------------------------------------------------------
inline auto FTermData::isTermType (FTermTypeT mask) const -> bool
{ return terminal_properties.terminal_type & mask; }

//----------------------------------------------------------------------
inline void FTermData::setTermEncoding (Encoding enc) noexcept
{ encoding_info.term_encoding = enc; }

//----------------------------------------------------------------------
inline void FTermData::setTTYFileDescriptor (int fd) noexcept
{ terminal_properties.fd_tty = fd; }

//----------------------------------------------------------------------
inline void FTermData::setBaudrate (uInt baud) noexcept
{ terminal_settings.baudrate = baud; }

//----------------------------------------------------------------------
inline void FTermData::supportShadowCharacter (bool available) noexcept
{ flags.shadow_character = available; }

//----------------------------------------------------------------------
inline void FTermData::supportHalfBlockCharacter (bool available) noexcept
{ flags.half_block_character = available; }

//----------------------------------------------------------------------
inline void FTermData::supportCursorOptimisation (bool available) noexcept
{ flags.cursor_optimisation = available; }

//----------------------------------------------------------------------
inline void FTermData::setCursorHidden (bool hidden_state) noexcept
{ flags.hidden_cursor = hidden_state; }

//----------------------------------------------------------------------
inline void FTermData::useAlternateScreen (bool use) noexcept
{ flags.use_alternate_screen = use; }

//----------------------------------------------------------------------
inline void FTermData::setAlternateScreenInUse (bool in_use) noexcept
{ flags.alternate_screen = in_use; }

//----------------------------------------------------------------------
inline void FTermData::setASCIIConsole (bool ascii) noexcept
{ flags.ascii_console = ascii; }

//----------------------------------------------------------------------
inline void FTermData::setVT100Console (bool vt100) noexcept
{ flags.vt100_console = vt100; }

//----------------------------------------------------------------------
inline void FTermData::setUTF8Console (bool utf8) noexcept
{ flags.utf8_console = utf8; }

//----------------------------------------------------------------------
inline void FTermData::setUTF8 (bool utf8) noexcept
{ flags.utf8_state = utf8; }

//----------------------------------------------------------------------
inline void FTermData::setNewFont (bool nfont) noexcept
{ flags.new_font = nfont; }

//----------------------------------------------------------------------
inline void FTermData::setVGAFont (bool vga) noexcept
{ flags.vga_font = vga; }

//----------------------------------------------------------------------
inline void FTermData::setMonochron (bool mono) noexcept
{ flags.monochron = mono; }

//----------------------------------------------------------------------
inline void FTermData::setTermResized (bool resize)
{
  std::lock_guard<std::mutex> resize_lock_guard(synchronization_state.resize_mutex);

  if ( resize )
    ++synchronization_state.resize_count;
  else if ( synchronization_state.resize_count.load() > 0 )
    --synchronization_state.resize_count;
}

//----------------------------------------------------------------------
inline void FTermData::setTermType (const std::string& name)
{
  if ( ! name.empty() )
    terminal_settings.termtype = name;
}

//----------------------------------------------------------------------
inline void FTermData::setTermType (FTermType type)
{ terminal_properties.terminal_type |= static_cast<FTermTypeT>(type); }

//----------------------------------------------------------------------
inline void FTermData::unsetTermType (FTermType type)
{ terminal_properties.terminal_type &= ~(static_cast<FTermTypeT>(type)); }

//----------------------------------------------------------------------
inline void FTermData::setTermFileName (const std::string& file_name)
{
  if ( ! file_name.empty() )
    terminal_settings.term_file_name = file_name;
}

//----------------------------------------------------------------------
inline void FTermData::setGnomeTerminalID (int id) noexcept
{ terminal_settings.gnome_terminal_id = id; }

//----------------------------------------------------------------------
inline void FTermData::setKittyVersion(const kittyVersion& version)
{
  terminal_settings.kitty_version.primary = version.primary;
  terminal_settings.kitty_version.secondary = version.secondary;
}

//----------------------------------------------------------------------
inline void FTermData::setXtermFont (const FString& font)
{ terminal_properties.xterm_font = font; }

//----------------------------------------------------------------------
inline void FTermData::setXtermTitle (const FString& title)
{ terminal_properties.xterm_title = title; }

//----------------------------------------------------------------------
#if DEBUG && defined(__linux__)
inline void FTermData::setFramebufferBpp (int bpp) noexcept
{ terminal_settings.framebuffer_bpp = bpp; }
#endif

}  // namespace finalcut

#endif  // FTERMDATA_H