1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
/*
* 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 <https://www.gnu.org/licenses/>.
*/
#pragma once
#include "paint.hh"
#include "ricochet/tui/view.hh"
#include "text.hh"
#include <cstddef>
#include <cstdint>
#include <optional>
#include <span>
#include <variant>
#include <vector>
namespace ricochet::tui::detail {
class DocumentText;
using HitTarget = std::variant<LinkId, ControlId>;
struct LayoutPoint
{
std::size_t row { 0 };
std::int64_t column { 0 };
};
struct LayoutHit
{
DisplayPosition position {};
DocumentRange unit {};
std::optional<HitTarget> target {};
};
struct FocusStep
{
DisplayPosition position {};
bool wrapped { false };
};
struct ScrollWindow
{
BlockId block {};
std::int64_t left { 0 };
std::int64_t width { 0 };
std::int64_t offset { 0 };
std::int64_t maximum { 0 };
};
enum class WordMotion : std::uint8_t
{
Next,
Previous,
End
};
struct LayoutGlyph
{
LayoutPoint position {};
int columns { 0 };
std::wstring text {};
TextStyle style {};
DocumentRange source {};
std::optional<HitTarget> target {};
// Clip bounds are in document-layout columns and also constrain hit testing.
std::int64_t clip_left { 0 };
std::int64_t clip_right { 0 };
// Structural boundaries locate anchors but do not displace nearby text hits.
bool boundary_only { false };
std::int64_t line_start { 0 };
bool decoration { false };
bool line_break { false };
bool fill { false };
bool word_start { false };
bool word_end { false };
// Inner-to-outer windows allow a code block inside a table to be revealed.
std::vector<ScrollWindow> scrolls {};
};
struct LayoutData
{
// Reading order, including table cells in row/cell order; not screen order.
std::vector<LayoutGlyph> glyphs {};
std::size_t rows { 1 };
std::int64_t extent { 0 };
};
// A derived snapshot for one Document + initial control values + width/scrolls.
// Editing will supply a separate draft snapshot; this stage uses revision zero.
// No ncurses headers, terminal objects or business-module dependencies.
class DocumentLayout
{
public:
DocumentLayout( const Document& document,
const TextService& text,
int columns,
std::span<const HorizontalScroll> scrolls );
int columns() const;
std::size_t rows() const;
std::optional<LayoutPoint> locate( const DisplayPosition& position ) const;
std::optional<LayoutHit> hit( LayoutPoint point ) const;
DisplayPosition first() const;
DisplayPosition last() const;
DisplayPosition adjacent( const DisplayPosition& position, int direction ) const;
DisplayPosition word( const DisplayPosition& position, WordMotion motion ) const;
DisplayPosition on_row( LayoutPoint point ) const;
DisplayPosition line_edge( const DisplayPosition& position, bool end ) const;
DocumentRange unit( const DisplayPosition& position ) const;
std::optional<HitTarget> target( const DisplayPosition& position ) const;
std::optional<FocusStep> focus( const DisplayPosition& position, bool backward ) const;
std::optional<LayoutPoint> cursor_cell( const DisplayPosition& position ) const;
std::vector<HorizontalScroll> reveal( const DisplayPosition& position ) const;
std::vector<HorizontalScroll> pan( const DisplayPosition& position, int direction ) const;
void append_frame( Frame& frame,
std::size_t first_row,
CellPoint origin,
ScreenSize viewport,
const DocumentText& content,
std::optional<DocumentRange> selection,
const DisplayPosition& cursor,
std::optional<HitTarget> focus = {} ) const;
private:
struct ReadingPosition
{
std::size_t index { 0 };
bool at_start { true };
};
ReadingPosition reading_position( const DisplayPosition& position ) const;
std::size_t nearest_stop( LayoutPoint point ) const;
const LayoutGlyph& cursor_glyph( const DisplayPosition& position ) const;
DisplayPosition stop( std::size_t index ) const;
struct FocusEntry
{
HitTarget target {};
std::size_t stop { 0 };
};
int columns_;
LayoutData data_;
std::vector<std::size_t> stops_ {};
// First reading stop per enabled object, independent of viewport clipping.
std::vector<FocusEntry> focus_ {};
};
} // namespace ricochet::tui::detail
|
