* \brief Sets a CSS style property on this node. * * Uses the COMPUTED_STYLE setters map to parse and apply a CSS property value. * Silently ignore

* \brief Returns the tag name of an ELEMENT node. * * \return The tag name string (e.g., "div", "p", "a"). Empty string for TEXT nodes. */

* \brief Retrieves an HTML attribute value by name. * * Looks up an attribute in the attributes map. Returns empty string if * the attribute doesn'

* \brief Sets a new HTML document for rendering and updates history. * * Stores the document in browser history and triggers rendering with styling

* \brief Returns all computed styles for this node. * * \return A COMPUTED_STYLE object containing all CSS properties and their values. */

* \brief Returns the type of this node. * * \return The NODE_TYPE (ELEMENT or TEXT). */

* \brief Parses a sequence of HTML tokens into a DOM tree structure. * * Processes a vector of tokens and builds a hierarchical Node tree representa

* \brief Tokenizes HTML source code into a sequence of tokens. * * Parses HTML text into semantic tokens representing start tags, end tags, * and t

* \brief Adds a child node and establishes parent-child relationship. * * Appends a child node to this node's children list and sets this node * as

* \brief Returns the text content of a TEXT node. * * \return The text string for TEXT nodes. Empty string for ELEMENT nodes. */

* \brief Converts a DOM tree into a layout tree with computed positions and dimensions. * * Recursively traverses the DOM tree and creates a paralle

* \brief Creates a Node object from a TOKEN. * * Converts a single TOKEN into a corresponding Node. For text tokens, creates * a TEXT type node. Fo

* \brief Parses inline CSS style attributes into a property-value map. * * Parses a CSS style string (e.g., "color: red; font-size: 14px") into indi

* \brief Applies CSS styles to a DOM tree using cascade and inheritance. * * Performs a breadth-first traversal of the DOM tree, applying CSS rules

* \brief Calculates the total horizontal content width of a layout tree. * * Traverses the layout tree to find the rightmost extent of all boxes, *

* \brief Creates a CSSOM (CSS Object Model) from parsed CSS rules. * * Parses a CSS string and creates a CSSOM object containing all CSS rules * fo

* \brief Extracts CSS stylesheets from <style> tags in the DOM. * * Performs a breadth-first traversal of the DOM tree to find all <style> elements

* \brief Retrieves the parent node. * * Locks the weak pointer to the parent and returns a shared pointer. * Returns nullptr if the parent has been

* \brief Returns the inherited color value as a hex string. * * Converts the QColor member to its hexadecimal string representation for * use in CS

* \brief Returns the inherited font-family value as a string. * * Converts the font_family member (QString) to std::string for inheritance * to chi

* \brief Returns the inherited font-size value as a string. * * Converts the font_size member (in pixels) to its string representation * for inheri

* \brief Returns the inherited font-style value as a string. * * Returns the font_style member for inheritance to child elements. * * \return The

* \brief Returns the inherited font-weight value as a string. * * Converts the font_weight member (QFont::Weight enum) to its numeric * CSS represe

* \brief Returns the inherited line-height value as a string. * * Returns the line_height member for inheritance to child elements. * * \return Th

* \brief Returns the inherited text-align value as a string. * * Converts the text_align member (TextAlign enum) to its CSS string * representation

* \brief Returns the inherited text-decoration value as a string. * * Converts the text_decoration member (TextDecoration enum) to its CSS string *

* \brief Returns the inherited visibility value as a string. * * Converts the visibility boolean member to its CSS string representation * for inhe

* \brief Handles layout calculation for block-level elements. * * Calculates width, positions children vertically, handles absolute/fixed * positi

* \brief Handles layout calculation for image elements. * * Loads the image from various sources (local file, URL, or data URI), * calculates dime

* \brief Handles layout calculation for inline elements. * * Processes children inline with proper spacing, wrapping across lines, * and height ca

* \brief Handles layout calculation for text nodes. * * Splits text into words and calculates their positions on the current line, * handling word

* \brief Finds all CSS rules that match a given DOM node. * * Iterates through all CSS rules in the CSSOM and tests each selector against * the pro

* \brief Parses HTML attribute strings into a name-value map. * * Extracts HTML attributes from a string (e.g., "class=\"button\" id=\"submit\"") *

* \brief Parses CSS source text into an array of CSS rules. * * Tokenizes and parses a complete CSS stylesheet, handling comment removal * and rule

* \brief Sets an HTML attribute on this node. * * Stores a name-value pair in the attributes map if both are non-empty. * Used for attributes like

* \brief Sets the parent node reference. * * Stores a weak pointer to the parent node to avoid circular references * and prevent memory leaks in th

* \brief Constructs a Header widget with navigation and URL input controls. * * Initializes a Header widget containing back/forward buttons, file op

* \brief Constructs the main browser window with header and renderer. * * Initializes the main application window with a header bar, rendering area,

* \brief Constructs a DOM Node with type and content. * * Creates either an ELEMENT node with a tag name or a TEXT node with text content. * The co

* \brief Constructs a Renderer widget for displaying web content. * * Initializes the renderer with empty state, ready to receive and display * HTM

* \brief Searches up the DOM tree for the nearest link anchor element. * * Starting from a given node, bubbles up the DOM tree looking for an <a> ta

* \brief Tokenizes and parses HTML into a DOM tree. * * Converts an HTML string into tokens, then parses the tokens into a * complete DOM tree stru

* \brief Handles completion of image download from the network. * * Caches downloaded images in the image cache manager and triggers a reflow * to

* \brief Builds and displays the header widget UI layout. * * Creates the horizontal layout with back/forward navigation buttons, file opener button

* \brief Draws the visual aspects of an element box (background, border, image). * * Handles rendering the background color, border, and image cont

* \brief Draws text content with alignment, decoration, and special handling. * * Renders text nodes with proper alignment (left/center/right), tex

* \brief Fetches and renders HTML content from a network URL. * * Makes an asynchronous HTTP/HTTPS request to fetch HTML content from a URL, * pars

* \brief Finds the DOM node at a given viewport coordinate. * * Delegates to find_node_in_box with the root layout box and (0,0) offset. * * \para

* \brief Recursively searches layout boxes to find the node at a coordinate. * * Performs a depth-first search of layout boxes, checking children fi

* \brief Returns the default display type for this node based on tag name. * * Uses the HTML tag name to determine default CSS display property. *

* \brief Navigates to the previous page in browser history. * * Moves the history iterator backward and re-renders the previous page * if available

* \brief Navigates to the next page in browser history. * * Moves the history iterator forward and re-renders the next page * if available. */

============================================================================ Setter Initialization ===================================================

* \brief Tests if a CSS selector matches a DOM node. * * Supports three selector types: element selectors (tag names), * class selectors (dot notat

* \brief Handles mouse press events to detect clicked links. * * Finds the DOM node at the click position and searches up the tree * for an <a> tag

* \brief Navigates to a URL or file path clicked in the renderer. * * Routes link clicks to appropriate handlers: local file:// URLs are loaded * a

* \brief Paints the rendered layout tree onto the widget surface. * * Fills the background with white and recursively paints all layout boxes, * in

* \brief Paints a fixed-position layout box adjusted for scroll position. * * Calculates the screen position of a fixed element, accounting for scro

* \brief Recursively paints a layout box and its children. * * Draws background colors, borders, images, text, and text decorations. * Handles rela

* \brief Parses a string value to BOX_SIZING enum. * * \param value CSS box-sizing value (e.g., "border-box", "content-box") * \return Correspondi

* \brief Parses a CSS color value string into a QColor object. * * Handles both named colors and RGB/RGBA formats. Named colors are passed directly

* \brief Parses a string value to DISPLAY_TYPE enum. * * \param value CSS display value (e.g., "block", "inline", "none") * \return Corresponding

* \brief Parses a CSS font-size value string into pixel units. * * Converts font-size values from various CSS units (px, pt, cm, mm, in) and * CSS

* \brief Parses a string value to POSITION_TYPE enum. * * \param value CSS position value (e.g., "static", "relative", "absolute", "fixed") * \ret

* \brief Parses CSS spacing shorthand values (margin/padding with 1-4 values). * * Implements CSS shorthand syntax: * - 1 value: applied to all si

* \brief Parses a CSS numeric value string with units into a float. * * Converts string representations of numbers (with or without units) into * f

* \brief Parses a string value to TEXT_ALIGN enum. * * \param value CSS text-align value (e.g., "left", "center", "right", "justify") * \return Co

* \brief Parses a string value to TEXT_DECORATION enum. * * \param value CSS text-decoration value (e.g., "underline", "line-through", "overline")

* \brief Recalculates the layout tree based on current viewport dimensions. * * Creates a fresh layout tree with the current widget width, calculati

* \brief Recalculates the layout and re-renders the current document. * * Triggered by the reflow timer, updates the layout tree to account for * n

* \brief Renders a DOM tree by applying styles, creating layouts, and scheduling paint. * * Applies user agent and author CSS, creates a layout tree

* \brief Loads and renders an HTML file from the local filesystem. * * Opens a local HTML file, reads its content, parses it into a DOM tree, * and

* \brief Requests a delayed reflow of the rendered document. * * Starts a timer to defer DOM reflowing (layout recalculation) to batch * layout ope

* \brief Handles window resize events and recalculates layout if needed. * * Detects width changes and triggers layout recalculation to reflow conte

* \brief Establishes signal-slot connections for the main window. * * Connects header signals to main window slots for navigation, file loading, *

* \brief Establishes signal-slot connections for header widget interactions. * * Connects all header buttons and controls to their respective signal

* \brief Sets up the main window UI with header and renderer. * * Creates the central widget, vertical layout, header bar, and scrollable * renderi