mirror of
https://github.com/slint-ui/slint.git
synced 2025-09-29 05:14:48 +00:00
105 lines
3.4 KiB
Rust
105 lines
3.4 KiB
Rust
/*!
|
|
# 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<DocNode: Into<parser::syntax_nodes::Document>>(
|
|
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);
|
|
}
|