vize_l0 0.591.0

L0 - the Davinci foundation level: ids, side tables, keys, dumps, diagnostics, passes and facts
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
109
110
111
112
113
114
115
116
117

//! Compiler config model.

use serde::Deserialize;

use super::vue::VueVersion;

/// Template syntax compatibility mode from `compiler.templateSyntax`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Deserialize)]
#[serde(rename_all = "lowercase")]
pub(crate) enum RawTemplateSyntaxConfig {
    Standard,
    Strict,
    Quirks,
}

impl RawTemplateSyntaxConfig {
    pub(crate) fn as_str(self) -> &'static str {
        match self {
            Self::Standard => "standard",
            Self::Strict => "strict",
            Self::Quirks => "quirks",
        }
    }
}

/// Default JSX/TSX output backend from `compiler.jsxMode` (#1496).
///
/// Selects the mode applied to `.jsx`/`.tsx` components that carry no
/// `"use vue:vapor"` / `"use vue:vdom"` directive prologue. Distinct from
/// `compiler.vapor`, which only toggles Vapor for `.vue` SFCs; a project can
/// keep SFCs on VDOM while defaulting JSX to Vapor, or vice versa.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum JsxMode {
    /// Virtual DOM output — the default, matching Vue's default renderer.
    #[default]
    Vdom,
    /// Vapor output.
    Vapor,
}

impl JsxMode {
    /// The canonical `compiler.jsxMode` config value for this mode.
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Vdom => "vdom",
            Self::Vapor => "vapor",
        }
    }
}

/// JSX/TSX compilation semantics from `compiler.jsxCompat` (#3391).
///
/// `Babel` opts `.jsx`/`.tsx` compilation into `@vue/babel-plugin-jsx`
/// semantics for projects migrating off the babel plugin. It is orthogonal to
/// [`JsxMode`]: the plugin is vdom-era, so `babel` with `jsxMode: "vapor"` is
/// rejected with a diagnostic rather than silently ignored.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum JsxCompat {
    /// Vize's own JSX semantics — the default. Must stay the default: flipping
    /// it would silently change output for every existing project.
    #[default]
    Native,
    /// `@vue/babel-plugin-jsx` semantics.
    Babel,
}

impl JsxCompat {
    /// The canonical `compiler.jsxCompat` config value for this mode.
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Native => "native",
            Self::Babel => "babel",
        }
    }
}

#[derive(Debug, Clone, Default, Deserialize)]
#[serde(default, rename_all = "camelCase")]
pub(crate) struct RawCompilerCompatibilityConfig {
    pub(crate) vue_version: Option<VueVersion>,
    pub(crate) host_compiler: Option<bool>,
}

#[derive(Debug, Clone, Default, Deserialize)]
#[serde(default, rename_all = "camelCase")]
pub(crate) struct RawCompilerConfig {
    /// Explicit SFC SSR mode switch from `compiler.ssr`.
    pub(crate) ssr: Option<bool>,
    /// Explicit SFC Vapor mode switch from `compiler.vapor`.
    pub(crate) vapor: Option<bool>,
    pub(crate) template_syntax: Option<RawTemplateSyntaxConfig>,
    #[serde(deserialize_with = "deserialize_whitespace")]
    pub(crate) whitespace: Option<String>,
    /// Default JSX output mode (`compiler.jsxMode`); `None` when absent, which
    /// the JSX entry points treat as VDOM.
    pub(crate) jsx_mode: Option<JsxMode>,
    /// JSX compatibility semantics (`compiler.jsxCompat`); `None` when absent,
    /// which the JSX entry points treat as `native`.
    pub(crate) jsx_compat: Option<JsxCompat>,
    /// Tag patterns that compile as custom elements instead of Vue components.
    pub(crate) custom_elements: Vec<crate::String>,
    pub(crate) compatibility: RawCompilerCompatibilityConfig,
}

/// Retain the old ignored-field behavior for every non-string JSON value.
/// RawValue validates syntax without converting numbers such as `1e400`.
fn deserialize_whitespace<'de, D>(deserializer: D) -> Result<Option<String>, D::Error>
where
    D: serde::Deserializer<'de>,
{
    let raw = Option::<Box<serde_json::value::RawValue>>::deserialize(deserializer)?;
    raw.filter(|value| value.get().starts_with('"'))
        .map(|value| serde_json::from_str(value.get()).map_err(serde::de::Error::custom))
        .transpose()
}