engawa 0.1.2

Engawa (縁側) — typed render-graph IR for pleme-io GPU consumers. Bevy-inspired render-graph design distilled to mado-shaped needs: no ECS, no game loop, no asset pipeline. Pure-data IR + topo sort + cycle detection + integration with garasu's headless GPU primitives.
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

//! Typed errors. Every failure path through the graph compile
//! returns one of these; consumers never see a generic
//! `anyhow::Error` from engawa.

use thiserror::Error;

use crate::node::NodeId;
use crate::resource::ResourceId;

#[derive(Debug, Error, Clone, PartialEq, Eq)]
pub enum EngawaError {
    #[error("validation failed: {0}")]
    Validation(#[from] ValidationError),
}

/// Validation errors caught at compile time — before any wgpu
/// command lands on the GPU. Every variant carries enough
/// context that an operator looking at the error message can
/// trace it back to the offending declaration in their effect
/// catalog.
#[derive(Debug, Error, Clone, PartialEq, Eq)]
pub enum ValidationError {
    #[error("duplicate node id: {0:?}")]
    DuplicateNode(NodeId),

    #[error("duplicate resource id: {0:?}")]
    DuplicateResource(ResourceId),

    #[error(
        "node {node:?} references resource {resource:?} that no other node produces \
         and that isn't declared as a graph input"
    )]
    UnboundInput {
        node: NodeId,
        resource: ResourceId,
    },

    #[error(
        "cycle detected in render graph; involved nodes: {0:?}"
    )]
    Cycle(Vec<NodeId>),

    #[error(
        "graph output {0:?} is not produced by any node"
    )]
    UnboundOutput(ResourceId),

    #[error(
        "resource {0:?} is produced by multiple nodes; each resource must have a single writer"
    )]
    MultipleWriters(ResourceId),
}