ladybird/Userland/Libraries/LibWeb/Layout/BlockFormattingContext.h

/*
 * Copyright (c) 2020-2022, Andreas Kling <kling@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <AK/Vector.h>
#include <LibWeb/Forward.h>
#include <LibWeb/Layout/BlockContainer.h>
#include <LibWeb/Layout/FormattingContext.h>

namespace Web::Layout {

// https://www.w3.org/TR/css-display/#block-formatting-context
class BlockFormattingContext : public FormattingContext {
public:
    explicit BlockFormattingContext(FormattingState&, BlockContainer const&, FormattingContext* parent);
    ~BlockFormattingContext();

    virtual void run(Box const&, LayoutMode) override;

    bool is_initial() const;

    auto const& left_side_floats() const { return m_left_floats; }
    auto const& right_side_floats() const { return m_right_floats; }

    static float compute_theoretical_height(FormattingState const&, Box const&);
    void compute_width(Box const&);

    // https://www.w3.org/TR/css-display/#block-formatting-context-root
    BlockContainer const& root() const { return static_cast<BlockContainer const&>(context_box()); }

    virtual void parent_context_did_dimension_child_root_box() override;

    static void compute_height(Box const&, FormattingState&);

    void add_absolutely_positioned_box(Box const& box) { m_absolutely_positioned_boxes.append(box); }

    AvailableSpaceForLineInfo available_space_for_line(float y) const;

private:
    virtual bool is_block_formatting_context() const final { return true; }

    void compute_width_for_floating_box(Box const&);

    void compute_width_for_block_level_replaced_element_in_normal_flow(ReplacedBox const&);

    void layout_initial_containing_block(LayoutMode);

    void layout_block_level_children(BlockContainer const&, LayoutMode);
    void layout_inline_children(BlockContainer const&, LayoutMode);

    void compute_vertical_box_model_metrics(Box const& box, BlockContainer const& containing_block);
    void place_block_level_element_in_normal_flow_horizontally(Box const& child_box, BlockContainer const&);
    void place_block_level_element_in_normal_flow_vertically(Box const& child_box, BlockContainer const&);

    void layout_floating_child(Box const& child, BlockContainer const& containing_block);

    void apply_transformations_to_children(Box const&);

    void layout_list_item_marker(ListItemBox const&);

    enum class FloatSide {
        Left,
        Right,
    };

    struct FloatSideData {
        Vector<Box const&> boxes;
        float y_offset { 0 };
    };

    FloatSideData m_left_floats;
    FloatSideData m_right_floats;

    Vector<Box const&> m_absolutely_positioned_boxes;

    bool m_was_notified_after_parent_dimensioned_my_root_box { false };
};

}