/*! # The SixtyFPS compiler library **NOTE:** This library is an internal crate for the SixtyFPS project. This crate should not be used directly by application using SixtyFPS. You should use the `sixtyfps` crate instead */ // It would be nice to keep the compiler free of unsafe code #![deny(unsafe_code)] #[cfg(feature = "proc_macro_span")] extern crate proc_macro; use std::{cell::RefCell, rc::Rc}; pub mod diagnostics; pub mod expression_tree; pub mod generator; pub mod layout; pub mod object_tree; pub mod parser; pub mod typeregister; mod passes { // Trait for the purpose of applying modifications to Expressions that are stored in various // data structures. pub trait ExpressionFieldsVisitor { fn visit_expressions( &mut self, visitor: impl FnMut(&mut super::expression_tree::Expression), ); } pub mod collect_resources; pub mod compile_paths; pub mod inlining; pub mod lower_layout; pub mod move_declarations; pub mod repeater_component; pub mod resolving; pub mod unique_id; } #[derive(Default)] /// CompilationConfiguration allows configuring different aspects of the compiler. pub struct CompilerConfiguration<'a> { /// Indicate whether to embed resources such as images in the generated output or whether /// to retain references to the resources on the file system. pub embed_resources: bool, /// The compiler will look in these paths for components used in the file to compile. pub include_paths: &'a [&'a std::path::Path], } pub fn compile_syntax_node>( doc_node: DocNode, mut diagnostics: diagnostics::FileDiagnostics, compiler_config: &CompilerConfiguration, ) -> (object_tree::Document, diagnostics::BuildDiagnostics) { let mut all_diagnostics = diagnostics::BuildDiagnostics::default(); let global_type_registry = typeregister::TypeRegister::builtin(); let type_registry = if !compiler_config.include_paths.is_empty() { let library = Rc::new(RefCell::new(typeregister::TypeRegister::new(&global_type_registry))); all_diagnostics.extend( compiler_config .include_paths .iter() .map(|path| typeregister::TypeRegister::add_from_directory(&library, path)) .filter_map(Result::ok) .flatten(), ); library } else { global_type_registry }; let doc = crate::object_tree::Document::from_node(doc_node.into(), &mut diagnostics, &type_registry); run_passes(&doc, &mut diagnostics, compiler_config); all_diagnostics.add(diagnostics); (doc, all_diagnostics) } pub fn run_passes( doc: &object_tree::Document, diag: &mut diagnostics::FileDiagnostics, compiler_config: &CompilerConfiguration, ) { passes::resolving::resolve_expressions(doc, diag); passes::inlining::inline(doc); passes::compile_paths::compile_paths(&doc.root_component, &doc.local_registry, diag); passes::unique_id::assign_unique_id(&doc.root_component); passes::lower_layout::lower_layouts(&doc.root_component, diag); if compiler_config.embed_resources { passes::collect_resources::collect_resources(&doc.root_component); } passes::repeater_component::create_repeater_components(&doc.root_component, diag); passes::move_declarations::move_declarations(&doc.root_component); }