vize_carton 0.232.0

Carton - The artist's toolbox for Vize compiler
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

// vize_carton defines and bridges std types, so it needs to use them directly.
#![allow(clippy::disallowed_types, clippy::disallowed_methods)]

//! Carton - The artist's toolbox for Vize.
//!
//! This crate provides the foundational utilities and data structures for the Vize compiler,
//! much like a carton (artist's portfolio case) holds all the essential tools and materials
//! an artist needs for their work.
//!
//! # Modules
//!
//! - **Allocator**: Arena-based memory allocation for efficient AST construction
//! - **Shared utilities**: DOM configuration, optimization flags, and helper functions
//! - **Telegraph**: Generic message fan-out for report emitters
//!
//! # Example
//!
//! ```
//! use vize_carton::{Allocator, Box, Vec};
//!
//! let allocator = Allocator::default();
//!
//! // Allocate a boxed value
//! let boxed = Box::new_in(42, allocator.as_bump());
//! assert_eq!(*boxed, 42);
//!
//! // Create a vector
//! let mut vec = Vec::new_in(allocator.as_bump());
//! vec.push(1);
//! vec.push(2);
//! vec.push(3);
//! assert_eq!(vec.len(), 3);
//! ```

// Allocator modules
mod allocator;
mod boxed;
mod clone_in;
mod vec;

// Shared modules
pub mod config;
#[cfg(not(target_arch = "wasm32"))]
pub mod corsa_resolver;
pub mod dialect;
pub mod directive;
pub mod dom_tag_config;
pub mod flags;
pub mod general;
pub mod hash;
pub mod i18n;
mod i18n_supplemental;
mod i18n_supplemental_extra;
mod i18n_supplemental_extra2;
pub mod line_index;
pub mod lsp;
pub mod path;
pub mod profiler;
pub mod source_range;
pub mod string_builder;
pub mod telegraph;

// Re-export allocator types
pub use allocator::Allocator;
pub use boxed::Box;
pub use clone_in::CloneIn;
pub use vec::Vec;

// Re-export bumpalo types for convenience
pub use bumpalo::Bump;
pub use bumpalo::collections::String as BumpString;
pub use bumpalo::collections::Vec as BumpVec;

// Re-export compact_str::CompactString for convenience
pub use compact_str::CompactString;
pub use compact_str::CompactString as String;
pub use compact_str::ToCompactString;

// Re-export smallvec for stack-optimized collections
pub use smallvec::{SmallVec, smallvec};

// Re-export bitflags for flag types
pub use bitflags::bitflags;

// Re-export rustc-hash for fast hash maps/sets
pub use rustc_hash::{FxHashMap, FxHashSet};

// Re-export phf for compile-time perfect hash functions
pub use phf::{Map as PhfMap, Set as PhfSet, phf_map, phf_set};

// Re-export shared utilities
pub use dom_tag_config::*;
pub use flags::*;
pub use general::*;