pub mod extract;
pub mod ir;
pub mod layout;
pub mod materialize;
pub mod measure;
pub mod paint;
pub mod theme;
pub mod types;
use crate::{ast::Diagram, builder::types::OutputConfig, error::DiagramResult};
use lievisual::fit::{FitOptions, fit_scene};
use lievisual::geometry::Size;
pub fn build_diagram(diagram: &Diagram) -> DiagramResult<lievisual::Scene> {
build_diagram_with_config(diagram, &OutputConfig::default())
}
pub fn build_diagram_with_config(
diagram: &Diagram,
config: &OutputConfig,
) -> DiagramResult<lievisual::Scene> {
let ug = extract::run(diagram)?;
let ug = measure::measure_all(ug);
let (gg, style) = layout::engine::run(&ug)
.map_err(|e| crate::error::DiagramError::RenderError(format!("layout failed: {e}")))?;
let sg = materialize::run(&gg, &style);
let mut scene = paint::run(&sg);
scene.background = config.background;
fit_scene(&mut scene, fit_options(config));
Ok(scene)
}
fn fit_options(config: &OutputConfig) -> FitOptions {
let mut opts = FitOptions::new()
.with_margin(CANVAS_MARGIN)
.with_upscale(config.upscale);
if let Some(w) = config.width {
opts = opts.with_max_width(w);
}
if let Some(h) = config.height {
opts = opts.with_max_height(h);
}
opts = opts.with_empty_size(Size::new(
resolve_cfg(config.width, types::DEFAULT_WIDTH),
resolve_cfg(config.height, types::DEFAULT_HEIGHT),
));
opts
}
pub(crate) const CANVAS_MARGIN: f64 = 8.0;
fn resolve_cfg(limit: Option<f64>, default: f64) -> f64 {
match limit {
Some(v) if v.is_finite() && v > 0.0 => v,
_ => default,
}
}
#[cfg(test)]
mod tests {
use super::*;
use lievisual::geometry::Rect;
use lievisual::scene::{Element, FillStrokeStyle, SceneNode};
fn scene_100x100() -> lievisual::Scene {
let mut s = lievisual::Scene::new(0.0, 0.0);
s.push(Element::rect(
Rect::new(0.0, 0.0, 100.0, 100.0),
FillStrokeStyle::default(),
));
s
}
fn fit(config: &OutputConfig) -> (f64, f64) {
let mut scene = scene_100x100();
fit_scene(&mut scene, fit_options(config));
(scene.width, scene.height)
}
#[test]
fn fit_upscale_scales_up() {
let config = OutputConfig {
upscale: true,
..OutputConfig::default()
};
let (w, h) = fit(&config);
assert!(
w > 500.0 && h > 500.0,
"upscale 应放大内容到目标尺寸,got {w}x{h}"
);
}
#[test]
fn fit_no_upscale_keeps_natural_size() {
let (w, h) = fit(&OutputConfig::default());
assert!(
w < 200.0 && h < 200.0,
"不 upscale 应保持自然尺寸,got {w}x{h}"
);
}
#[test]
fn fit_width_only_constraint() {
let config = OutputConfig {
width: Some(500.0),
height: None,
upscale: true,
..OutputConfig::default()
};
let (w, h) = fit(&config);
assert!((w - 500.0).abs() < 1.0, "只限宽时应放大到目标宽度,got {w}");
assert!((h - 500.0).abs() < 1.0, "高度应按比例同步放大,got {h}");
}
#[test]
fn fit_height_only_constraint() {
let config = OutputConfig {
width: None,
height: Some(500.0),
upscale: true,
..OutputConfig::default()
};
let (w, h) = fit(&config);
assert!((h - 500.0).abs() < 1.0, "只限高时应放大到目标高度,got {h}");
assert!((w - 500.0).abs() < 1.0, "宽度应按比例同步放大,got {w}");
}
#[test]
fn fit_accounts_for_stroke_width() {
use lievisual::geometry::Color;
use lievisual::scene::Stroke;
let mut s = lievisual::Scene::new(0.0, 0.0);
s.push(Element::rect(
Rect::new(0.0, 0.0, 100.0, 100.0),
FillStrokeStyle {
fill: None,
stroke: Some(Stroke::new(Color::BLACK, 20.0)),
},
));
let nodes = std::mem::take(&mut s.nodes);
s.nodes = nodes;
fit_scene(&mut s, FitOptions::new().with_margin(0.0));
assert!(
(s.width - 120.0).abs() < 0.5,
"应计入描边半宽,期望 120,got {}",
s.width
);
}
#[test]
fn fit_accounts_for_node_transform() {
use lievisual::geometry::Transform;
let mut s = lievisual::Scene::new(0.0, 0.0);
s.push(
SceneNode::new(Element::rect(
Rect::new(0.0, 0.0, 100.0, 100.0),
FillStrokeStyle::default(),
))
.with_transform(Transform::scale(2.0)),
);
fit_scene(&mut s, FitOptions::new().with_margin(0.0));
assert!(
(s.width - 200.0).abs() < 0.5,
"应应用节点 transform,期望 200,got {}",
s.width
);
}
}