/*
* Ricochet - A minimalist CLI web browser for fast, distraction-free navigation.
* Copyright (C) 2026 Richard Qin
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*/
#include "ricochet/core/browser.hh"
#include "ricochet/net/http_client.hh"
#include "ricochet/parser/html_lexer.hh"
#include "ricochet/parser/tree_builder.hh"
#include "ricochet/render/renderer.hh"
#include "ricochet/tui/terminal.hh"
#include
#include
#include
#include
namespace ricochet::core {
struct PageData
{
std::vector lines;
std::vector links;
std::string title;
};
namespace {
std::string extract_title( const parser::DomNode& root_node )
{
std::vector stack;
stack.push_back( &root_node );
while ( !stack.empty() ) {
const parser::DomNode* current = stack.back();
stack.pop_back();
std::string base_tag = current->tag_name;
const std::size_t space_pos = base_tag.find( ' ' );
if ( space_pos != std::string::npos ) {
base_tag = base_tag.substr( 0, space_pos );
}
for ( char& c : base_tag ) {
if ( c >= 'A' && c <= 'Z' ) {
c = static_cast( c + 32 );
}
}
if ( base_tag == "title" ) {
std::string full_title;
for ( const auto& child : current->children ) {
if ( child.tag_name.empty() ) {
full_title += child.text_content;
}
}
if ( !full_title.empty() ) {
return full_title;
}
}
for ( const auto& child : std::ranges::reverse_view( current->children ) ) {
stack.push_back( &child );
}
}
return "";
}
PageData load_page( std::string_view url )
{
const net::HttpClient client;
auto response_result = client.fetch( url );
if ( !response_result.has_value() ) {
return { .lines = { "[!] Failed to load: " + std::string( url ) }, .links = {}, .title = "Error" };
}
const parser::HtmlLexer lexer;
const parser::TreeBuilder builder;
const render::Renderer renderer;
const auto dom_root = builder.build( lexer.tokenize( response_result.value().body ) );
const render::RenderResult result = renderer.render( dom_root );
std::vector lines;
std::size_t start = 0;
while ( start < result.text.length() ) {
const std::size_t end = result.text.find( '\n', start );
if ( end == std::string::npos ) {
lines.push_back( result.text.substr( start ) );
break;
}
lines.push_back( result.text.substr( start, end - start ) );
start = end + 1;
}
const std::string title = extract_title( dom_root );
return { .lines = lines, .links = result.links, .title = title };
}
void draw_view( const tui::Terminal& terminal,
const std::vector& lines,
std::size_t scroll_y,
std::string_view url, // NOLINT(bugprone-easily-swappable-parameters)
std::string_view title ) // NOLINT(bugprone-easily-swappable-parameters)
{
terminal.clear_screen();
auto [width, height] = terminal.get_size();
const std::size_t usable_height = ( height > 2 ) ? ( height - 2 ) : 1;
std::string clean_title( title );
if ( clean_title.empty() ) {
const std::size_t start = url.find( "://" );
const std::size_t host_start = ( start == std::string::npos ) ? 0 : start + 3;
const std::size_t host_end = url.find( '/', host_start );
clean_title = std::string( url.substr( host_start, host_end - host_start ) );
}
for ( char& c : clean_title ) {
if ( c == '\n' || c == '\r' ) {
c = ' ';
}
}
std::string header = " PAGE: " + clean_title;
if ( header.size() < width ) {
header.append( width - header.size(), ' ' );
} else if ( header.size() > width && width > 3 ) {
header = header.substr( 0, width - 3 ) + "...";
}
std::cout << "\033[7m" << header << "\033[0m\r\n";
for ( std::size_t i = 0; i < usable_height; ++i ) {
if ( scroll_y + i < lines.size() ) {
std::cout << lines[scroll_y + i] << "\r\n";
} else {
std::cout << "~\r\n";
}
}
std::string footer = " URL: " + std::string( url ) + " | [j/k]Scroll [/]Jump [f]Follow [H/L]History [q]Quit ";
if ( footer.size() < width ) {
footer.append( width - footer.size(), ' ' );
} else if ( footer.size() > width && width > 3 ) {
footer = footer.substr( 0, width - 3 ) + "...";
}
std::cout << "\033[7m" << footer << "\033[0m";
std::cout.flush();
}
std::string format_url( std::string input )
{
if ( input.empty() ) {
return input;
}
if ( input.starts_with( "http://" ) || input.starts_with( "https://" ) ) {
return input;
}
const bool is_domain = input.contains( '.' ) && !input.contains( ' ' );
if ( is_domain ) {
input.insert( 0, "https://" );
return input;
}
for ( char& ch : input ) {
if ( ch == ' ' ) {
ch = '+';
}
}
return "https://lite.duckduckgo.com/lite/?q=" + input;
}
std::string get_url_input( const tui::Terminal& terminal )
{
auto [width, height] = terminal.get_size();
terminal.move_cursor( height, 1 );
std::cout << "\x1b[2K\033[7m URL: \033[0m ";
std::cout.flush();
std::string input;
terminal.show_cursor( true );
while ( true ) {
const char ch = terminal.read_key();
if ( ch == '\r' || ch == '\n' ) {
break;
}
if ( ch == 27 ) {
input.clear();
break;
}
if ( ch == 127 || ch == 8 ) {
if ( !input.empty() ) {
input.pop_back();
std::cout << "\b \b";
std::cout.flush();
}
} else if ( std::isprint( static_cast( ch ) ) ) {
input += ch;
std::cout << ch;
std::cout.flush();
}
}
terminal.show_cursor( false );
return format_url( std::move( input ) );
}
std::string get_link_input( const tui::Terminal& terminal )
{
auto [width, height] = terminal.get_size();
terminal.move_cursor( height, 1 );
std::cout << "\x1b[2K\033[7m Follow Link [#]: \033[0m ";
std::cout.flush();
std::string num_input;
terminal.show_cursor( true );
while ( true ) {
const char ch = terminal.read_key();
if ( ch == '\r' || ch == '\n' ) {
break;
}
if ( ch == 27 ) {
num_input.clear();
break;
}
if ( ch == 127 || ch == 8 ) {
if ( !num_input.empty() ) {
num_input.pop_back();
std::cout << "\b \b";
std::cout.flush();
}
} else if ( std::isdigit( static_cast( ch ) ) ) {
num_input += ch;
std::cout << ch;
std::cout.flush();
}
}
terminal.show_cursor( false );
return num_input;
}
std::string normalize_url( const std::string& target, const std::string& current_url )
{
if ( target.starts_with( "/" ) ) {
if ( target.starts_with( "//" ) ) {
return "https:" + target;
}
const std::size_t slash_pos = current_url.find( '/', 8 );
const std::string domain
= ( slash_pos == std::string::npos ) ? current_url : current_url.substr( 0, slash_pos );
return domain + target;
}
if ( !target.starts_with( "http" ) ) {
const std::size_t last_slash = current_url.rfind( '/' );
if ( last_slash > 7 ) {
return current_url.substr( 0, last_slash + 1 ) + target;
}
return current_url + "/" + target;
}
return target;
}
std::string strip_ddg_tracker( std::string target )
{
const std::size_t uddg_pos = target.find( "uddg=" );
if ( uddg_pos != std::string::npos ) {
const std::size_t end_pos = target.find( '&', uddg_pos );
const std::string encoded = target.substr( uddg_pos + 5, end_pos - ( uddg_pos + 5 ) );
std::string decoded;
for ( std::size_t i = 0; i < encoded.length(); ++i ) {
if ( encoded[i] == '%' && i + 2 < encoded.length() ) {
const std::string hex = encoded.substr( i + 1, 2 );
try {
decoded += static_cast( std::stoi( hex, nullptr, 16 ) );
} catch ( const std::exception& ) {
(void)0;
}
i += 2;
} else {
decoded += encoded[i];
}
}
return decoded;
}
return target;
}
void handle_follow_link( const tui::Terminal& terminal,
const std::vector& links,
std::string& current_url,
bool& navigate )
{
const std::string num_input = get_link_input( terminal );
if ( !num_input.empty() ) {
try {
const std::size_t index = std::stoul( num_input );
if ( index > 0 && index <= links.size() ) {
std::string target = links[index - 1];
target = normalize_url( target, current_url );
target = strip_ddg_tracker( target );
current_url = target;
navigate = true;
}
} catch ( const std::exception& e ) {
(void)e; // NOLINT
}
}
}
enum class InputAction : std::uint8_t
{
None,
Quit,
Navigate
};
InputAction process_key( char c,
const tui::Terminal& terminal,
const PageData& page_data,
std::string& current_url,
std::vector& history,
std::size_t& history_idx, // NOLINT(bugprone-easily-swappable-parameters)
std::size_t& scroll_y ) // NOLINT(bugprone-easily-swappable-parameters)
{
auto [width, height] = terminal.get_size();
const std::size_t view_h = ( height > 1 ) ? ( height - 1 ) : 1;
if ( c == 'q' ) {
return InputAction::Quit;
}
if ( c == 'j' && scroll_y + view_h < page_data.lines.size() ) {
scroll_y++;
}
if ( c == 'k' && scroll_y > 0 ) {
scroll_y--;
}
if ( c == 'H' && history_idx > 0 ) {
history_idx--;
return InputAction::Navigate;
}
if ( c == 'L' && history_idx + 1 < history.size() ) {
history_idx++;
return InputAction::Navigate;
}
if ( c == '/' ) {
const std::string next_url = get_url_input( terminal );
if ( !next_url.empty() ) {
history.resize( history_idx + 1 );
history.push_back( next_url );
history_idx++;
return InputAction::Navigate;
}
}
if ( c == 'f' ) {
const std::string old_url = current_url;
bool nav = false;
handle_follow_link( terminal, page_data.links, current_url, nav );
if ( nav && current_url != old_url ) {
history.resize( history_idx + 1 );
history.push_back( current_url );
history_idx++;
return InputAction::Navigate;
}
}
return InputAction::None;
}
std::vector wrap_lines( const std::vector& original_lines, std::size_t wrap_width )
{
std::vector wrapped_lines;
for ( const auto& line : original_lines ) {
std::string current_line;
std::size_t vis_count = 0;
bool in_ansi = false;
for ( const char c : line ) {
if ( c == '\x1b' ) {
in_ansi = true;
}
if ( in_ansi ) {
current_line += c;
if ( c == 'm' ) {
in_ansi = false;
}
} else {
if ( vis_count >= wrap_width ) {
wrapped_lines.push_back( current_line + "\033[0m" );
current_line.clear();
vis_count = 0;
}
current_line += c;
vis_count++;
}
}
if ( !current_line.empty() || line.empty() ) {
wrapped_lines.push_back( current_line + "\033[0m" );
}
}
return wrapped_lines;
}
} // namespace
int Browser::run( std::string_view initial_url )
{
std::vector history;
history.emplace_back( initial_url );
std::size_t history_idx = 0;
const tui::Terminal terminal;
terminal.show_cursor( false );
while ( true ) {
std::string current_url = history[history_idx];
terminal.clear_screen();
std::cout << "-> Fetching: " << current_url << "...\r\n";
std::cout.flush();
auto page_data = load_page( current_url );
auto [term_width, term_height] = terminal.get_size();
const std::size_t wrap_width = ( term_width > 1 ) ? ( term_width - 1 ) : 80;
page_data.lines = wrap_lines( page_data.lines, wrap_width );
std::size_t scroll_y = 0;
bool navigate = false;
while ( !navigate ) {
draw_view( terminal, page_data.lines, scroll_y, current_url, page_data.title );
const char c = terminal.read_key();
const InputAction action = process_key( c, terminal, page_data, current_url, history, history_idx, scroll_y );
if ( action == InputAction::Quit ) {
terminal.clear_screen();
return 0;
}
if ( action == InputAction::Navigate ) {
navigate = true;
}
}
}
terminal.clear_screen();
return 0;
}
} // namespace ricochet::core