htui 0.2.0

A terminal HTML/CSS renderer with an embedded JavaScript engine — build interactive TUIs from HTML, CSS and JS
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

//! Block / inline-block formatting context implementation.
//!
//! Every layout function in this module implements [`LayoutFn`](crate::layout::LayoutFn)
//! for an element type that participates in the default block flow. Layouts
//! here treat the containing block as a vertical sequence of rows; every
//! block reserves `height` rows starting at the current cursor and advances
//! the cursor past the box's border-box plus `margin.bottom`.
//!
//! Flex, table, and replaced boxes are selected by the geometry dispatcher
//! before normal-flow handlers in this module are consulted.
//!
//! ## Module layout
//!
//! ```text
//! flow/
//! ├── mod.rs           ← re-exports (this file)
//! ├── tree.rs          ← layout_tree() orchestrator
//! ├── layout_block/    ← shared layout_block() + OuterGeometry + LayoutBlockOptions
//! │   ├── mod.rs       ←   re-exports
//! │   ├── geometry.rs  ←   outer-geometry helpers
//! │   ├── options.rs   ←   LayoutBlockOptions
//! │   └── core.rs      ←   layout_block() main pipeline
//! ├── aside.rs / body.rs / div.rs / generic.rs / head.rs
//! ├── header_footer.rs / html.rs / list.rs / p.rs
//! ├── img.rs
//! └── table/           ← table-element layout (see `table/mod.rs`)
//!     ├── mod.rs       ←   re-exports + table constants
//!     ├── table.rs     ←   layout_table orchestrator
//!     ├── row_group.rs ←   layout_row_group pass-through
//!     ├── tr.rs        ←   layout_tr pass-through
//!     ├── td.rs        ←   layout_td + layout_th pass-through
//!     ├── cell.rs      ←   CellInfo + layout_cell
//!     └── measure.rs   ←   collect_rows + collect_cells + cell_text_width +
//!                          compute_column_widths
//! ```
//!
//! `collect_runs` lives at `crate::layout::layoutbox::collect_runs` because it
//! is shared with the flex layout (see the flex submodule).

mod a;
mod elements;
mod generic;
mod head;
mod img;
mod layout_block;
mod list;
mod table;
mod tree;

pub use crate::html::css_parse::FontContext;
pub use a::layout_a;
pub use elements::layout_standard_block;
pub use generic::{
    layout_generic, layout_hr, layout_inline_blockify, layout_progress, layout_summary,
};
pub use head::{layout_hn, layout_meta, layout_title};
pub use img::{layout_img, layout_img_with_rect};
pub use layout_block::{
    LayoutBlockOptions, OuterGeometry, apply_horizontal_auto_margins, block_left,
    build_border_rect, compute_outer_geometry, constrained_block_width, layout_block,
    reserve_border_box, resolve_block_width,
};
pub use list::{layout_li, layout_menu, layout_ol, layout_ul};
pub use table::{layout_row_group, layout_table, layout_td, layout_th, layout_tr};
pub(crate) use tree::dispatch_flow_geometry;
pub use tree::{dispatch, layout_children, layout_tree, layout_tree_with_scroll_offsets};