vize_croquis 0.76.0

Croquis - Semantic analysis layer for Vize. Quick sketches of meaning from Vue templates.
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

//! # vize_croquis
//!
//! Croquis - The semantic analysis layer for Vize.
//!
//! ## Name Origin
//!
//! **Croquis** (/kʁɔ.ki/) is a French term for a quick, sketchy drawing that captures
//! the essential features of a subject. Like how artists use croquis to rapidly
//! capture the essence of a pose or scene, `vize_croquis` quickly analyzes Vue
//! templates to extract semantic meaning from the syntactic structure.
//!
//! ## Purpose
//!
//! This crate bridges the gap between parsing (vize_armature) and transformation
//! (vize_atelier_core) by providing:
//!
//! - **Scope Analysis**: Track variable scopes across templates and scripts
//! - **Binding Resolution**: Resolve identifiers to their declarations
//! - **Reactivity Tracking**: Understand ref/reactive dependencies
//! - **Symbol Tables**: Fast lookup of bindings and their metadata
//!
//! ## Architecture
//!
//! ```text
//! vize_armature (Parse)
//!        ↓
//!   vize_relief (AST)
//!        ↓
//!  vize_croquis (Semantic Analysis)  ← This crate
//!        ↓
//! vize_atelier_core (Transform)
//! ```

// Core modules
mod scope;
mod symbol;

// Analysis modules
pub mod analysis;
pub mod analyzer;
pub mod builtins;
pub mod call_graph;
pub mod css;
pub mod declaration_ts;
pub mod display;
pub mod hoist;
pub mod import_resolver;
pub mod macros;
pub mod naming;
pub mod optimization;
pub mod provide;
pub mod reactivity;
pub mod reactivity_tracking;
pub mod script_parser;
pub mod setup_context;
pub mod types;
pub mod virtual_ts;

// Cross-file analysis (opt-in)
pub mod cross_file;

// Re-export commonly used utilities from vize_carton for convenience
pub use vize_carton::{
    is_builtin_directive, is_builtin_tag, is_html_tag, is_math_ml_tag, is_native_tag,
    is_reserved_prop, is_svg_tag, is_void_tag,
};

// Re-export core types
pub use scope::{
    BindingFlags, BlockKind, BlockScopeData, CallbackScopeData, ClientOnlyScopeData,
    ClosureScopeData, EventHandlerScopeData, ExternalModuleScopeData, JsGlobalScopeData, JsRuntime,
    NonScriptSetupScopeData, ParamNames, ParentScopes, Scope, ScopeBinding, ScopeChain, ScopeData,
    ScopeId, ScopeKind, ScriptSetupScopeData, Span, UniversalScopeData, VForScopeData,
    VSlotScopeData, VueGlobalScopeData, PARAM_INLINE_CAP,
};
pub use symbol::{Symbol, SymbolFlags, SymbolId, SymbolTable};

// Re-export analysis types
pub use analysis::{
    AnalysisStats, BindingMetadata, Croquis, ImportStatementInfo, InvalidExport, InvalidExportKind,
    ReExportInfo, TemplateExpression, TemplateExpressionKind, TypeExport, TypeExportKind,
    UndefinedRef, UnusedTemplateVar, UnusedVarContext, COMPILER_MACRO_NAMES,
};
pub use analyzer::{Analyzer, AnalyzerOptions};

// Re-export common types
pub use vize_relief::BindingType;