liemermaid 0.3.1

Mermaid diagram parser + renderer (SVG / vello_cpu PNG), unified through lievisual Scene IR.
Documentation
//! 第三层 IR:[`SceneGraph`](SG,视觉自足 IR)。
//!
//! 由 `materialize` 阶段(消费 GG + StyleIntent + Theme)产出:颜色 / 线型 / 字体已解析,
//! 与 [`crate::ast`] 完全解耦。是 `paint` 的唯一输入;`paint` 将其纯机械翻译成
//! `lievisual::Scene` 原语,不再有任何图类型判断或 theme 硬编码。

use lievisual::geometry::{Color, Point, Size};
use lievisual::scene::{Fill, Stroke};
use lievisual::text::{RichSpan, TextStyle};

use super::common::*;
use super::geograph::RoutePath;
use super::shape::*;
use super::unigraph::EdgeKind;

/// 视觉自足的场景图。
#[derive(Debug, Clone, Default)]
pub struct SceneGraph {
    pub size: Size,
    pub background: Color,
    /// 按 z_index 升序,painter 直接遍历。
    pub items: Vec<SceneItem>,
}

/// 场景绘制项(视觉自足)。
#[derive(Debug, Clone)]
pub enum SceneItem {
    /// 形状(含容器 / 节点 / 扇区)。
    Shape {
        geometry: ShapeGeometry,
        fill: Option<Fill>,
        stroke: Option<Stroke>,
        /// 语义名(如 `edge-label`),用于 SVG 端标记(`<g id>`),
        /// 供测试 / 宿主识别特定几何;节点形状通常为 None。
        name: Option<String>,
        z: i32,
    },
    /// 连线(已含箭头标记作为 ends 描述)。
    /// `ends: (start_ends, end_ends)`:起、终两端各自的标记类型(多数边起点为 None)。
    /// `path` 为路由段序列(直线/贝塞尔段),paint 按段类型画折线或曲线。
    Edge {
        path: RoutePath,
        stroke: Stroke,
        ends: (EdgeEnds, EdgeEnds),
        z: i32,
    },
    /// 文本(已测量,含布局)。
    Label {
        text: Vec<RichSpan>,
        position: Point,
        style: TextStyle,
        anchor: Anchor,
        z: i32,
    },
    /// 分组(仅用于 z / clip 管理,子项已展平到 items)。
    Group { children: Vec<SceneItem>, z: i32 },
}

/// 文本对齐锚点。
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum Anchor {
    #[default]
    Center,
    Left,
    Right,
    Top,
    Bottom,
}

/// 视觉意图:LayoutEngine 在 layout 结束时从 UG 抽取的轻量结构。**不含几何坐标**。
///
/// 注意:当前 `materialize` 仍直接按 `theme` 常量解析颜色 / 线型,本结构是
/// **为后续可配置主题预留的接口**(参数保留以免后续改动公开 API)。UG 可在
/// layout 后 drop,materialize / paint 不持有 UG 引用。
#[derive(Debug, Clone, Default)]
pub struct StyleIntent {
    pub node_styles: Vec<(NodeId, StyleRef)>,
    pub edge_styles: Vec<(EdgeId, EdgeKind, ArrowSpec)>,
    pub container_styles: Vec<(ContainerId, ContainerKind)>,
}