hephaestus 0.2.0

Backend-agnostic 2D scene renderer for data visualization.
Documentation 
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

//! Rich-text markdown support. Gated behind `text`; layered on top of
//! [`crate::text::TextRun`].
//!
//! **Marquee parity.** The parser recognises standard CommonMark plus
//! the marquee extensions: `~~strike~~`, `^sup^`, `~sub~`, `$math$`,
//! `$$display math$$`, `:::class …:::` fenced divs, and marquee-style
//! `{selector body}` inline spans. `{selector body}` heads carry
//! **one** selector token; combine styles by nesting:
//! `{.red {.17 x}}`. Selector tokens are `.name` (class or CSS colour
//! fallback), `#RRGGBB` / `#RGB` (hex colour), `.<number>` (size in
//! pt), or `#name` (style-sheet lookup in the id namespace).
//!
//! **`_x_` is underline**, `*x*` is italic — marquee's reading of the
//! two emphasis delimiters. Parsing never fails; malformed markup
//! renders as the characters that spell it.
//!
//! **Drawing surface.** [`draw_rich_text`] mirrors marquee's
//! `marquee_grob` positioning vocabulary: `(x, y)` plus a
//! [`RichAnchor`] that specifies which point on the laid-out box
//! coincides with `(x, y)` ([`HAnchor::Left`] / `LeftInk` / `Center`
//! / `CenterInk` / `RightInk` / `Right` / `Fraction(f)` and the
//! analogous [`VAnchor`] adding `TopInk` / `FirstLine` / `LastLine`
//! / `BottomInk`). The `transform` argument composes **around the
//! anchor** so a rotation implicitly pivots at `(x, y)`.
//!
//! **Wrap width.** [`RichTextRun::new`] shapes at natural width (no
//! wrap). Use [`RichTextRun::new_with_width`] or
//! [`RichTextRun::set_max_width`] to force wrap at a specific
//! pixel width, mirroring marquee's `marquee_grob(width = ...)`.
//! When the run is used in a composition (via `height_at`)
//! the wrap width comes from the layout solver, matching marquee's
//! `width = NULL` "parent container width" semantics.
//!
//! **Known limitations.** Images are not rendered: `![alt](path)`
//! drops the image and renders `alt` as plain text, since there is no
//! host image-resolver hook yet. Math renders as its source
//! characters rather than as an equation. Marquee's seven-value
//! alignment vocabulary, gradient backgrounds, and explicit control
//! over underline / strikethrough metrics are also unimplemented.
//!
//! See `src/text/rich/CLAUDE.md` for the full architectural note.

pub mod anchor;
pub mod block;
mod border;
pub mod cache;
pub mod draw;
pub mod length;
pub mod parser;
pub mod reduce;
pub mod run;
mod shape;
pub mod style;
mod wrap;

#[cfg(test)]
mod tests;

pub use anchor::{AnchorOffsets, HAnchor, LayoutBounds, RichAnchor, VAnchor};
pub use block::{BlockBorder, BlockPaint};
pub use cache::{RichKey, RichShapeCache};
pub use draw::draw_rich_text;
pub use length::{
    em, pt, relative, rem, FieldSet, LengthSpec, LineHeightSpec, RichMargin, StyleField,
};
pub use parser::{parse, RichEvent, Selector};
pub use reduce::{reduce, BaselineRun, Block, BlockKind, BuiltRuns, InlineRun};
pub use run::{RichBrush, RichTextRun, RichTextWidth};
pub use style::{css_color, Direction, ResolvedStyle, RichTextStyleSheet, StyleDelta};