vize_l2 0.483.0

L2 - the Davinci semantic IR (codename Disegno): the neutral op family every input dialect lowers into
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! Monomorphized construction capabilities; callbacks receive real child factories.

use super::{ArtifactError, RegionBuilder};
use crate::expr::{ExprRef, JsExpr};
use crate::op::{Attribute, Namespace};
use crate::provenance::ProvenanceRecord;
use vize_l0::{Span, id::NodeId};

/// A recursive body, invoked only by its factory's actual minted owner.
///
/// A concrete callback avoids requiring captured compile-local source and
/// recorder borrows to outlive every possible child-factory lifetime.
pub trait ComponentBody<'a> {
    fn run<R: ComponentFactory<'a>>(self, region: &mut R, node: NodeId);
}

/// A checked Component construction route, with retained JavaScript payloads.
///
/// Implementing this diagnostic capability does not confer file-resolution
/// completeness. An authoritative file owner keeps its recorder private and
/// resolves, constructs and associates each expression inside its own methods.
pub trait ComponentFactory<'a>: Sized {
    fn source(&self) -> &'a str;
    fn text(&mut self, text: &'a str, span: Span) -> Result<NodeId, ArtifactError>;
    fn comment(&mut self, text: &'a str, span: Span) -> Result<NodeId, ArtifactError>;
    fn interpolation(
        &mut self,
        expression: &'a JsExpr<'a>,
        span: Span,
    ) -> Result<NodeId, ArtifactError>;
    fn bind(
        &mut self,
        name: &'a str,
        name_span: Span,
        expression: &'a JsExpr<'a>,
        span: Span,
    ) -> Result<NodeId, ArtifactError>;
    fn element<B: ComponentBody<'a>>(
        &mut self,
        tag: &'a str,
        namespace: Namespace,
        attributes: vize_l0::Vec<'a, Attribute<'a>>,
        span: Span,
        body: B,
    ) -> Result<NodeId, ArtifactError>;
    fn component<B: ComponentBody<'a>>(
        &mut self,
        name: &'a str,
        attributes: vize_l0::Vec<'a, Attribute<'a>>,
        span: Span,
        body: B,
    ) -> Result<NodeId, ArtifactError>;
    fn record(&mut self, record: ProvenanceRecord) -> Result<(), ArtifactError>;
}

impl<'a> ComponentFactory<'a> for RegionBuilder<'_, 'a> {
    fn source(&self) -> &'a str {
        self.builder.parts.source
    }
    fn text(&mut self, text: &'a str, span: Span) -> Result<NodeId, ArtifactError> {
        RegionBuilder::text(self, text, span)
    }
    fn comment(&mut self, text: &'a str, span: Span) -> Result<NodeId, ArtifactError> {
        RegionBuilder::comment(self, text, span)
    }
    fn interpolation(
        &mut self,
        expression: &'a JsExpr<'a>,
        span: Span,
    ) -> Result<NodeId, ArtifactError> {
        RegionBuilder::interpolation(self, ExprRef::Js(expression), span)
    }
    fn bind(
        &mut self,
        name: &'a str,
        name_span: Span,
        expression: &'a JsExpr<'a>,
        span: Span,
    ) -> Result<NodeId, ArtifactError> {
        RegionBuilder::bind(self, name, name_span, ExprRef::Js(expression), span)
    }
    fn element<B: ComponentBody<'a>>(
        &mut self,
        tag: &'a str,
        namespace: Namespace,
        attributes: vize_l0::Vec<'a, Attribute<'a>>,
        span: Span,
        body: B,
    ) -> Result<NodeId, ArtifactError> {
        RegionBuilder::element(self, tag, namespace, attributes, span, |child, node| {
            body.run(child, node);
        })
    }
    fn component<B: ComponentBody<'a>>(
        &mut self,
        name: &'a str,
        attributes: vize_l0::Vec<'a, Attribute<'a>>,
        span: Span,
        body: B,
    ) -> Result<NodeId, ArtifactError> {
        RegionBuilder::component(self, name, attributes, span, |child, node| {
            body.run(child, node);
        })
    }
    fn record(&mut self, record: ProvenanceRecord) -> Result<(), ArtifactError> {
        RegionBuilder::record(self, record)
    }
}