oxc_minifier 0.124.0

A collection of JavaScript tools written in Rust.
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

use oxc_allocator::Allocator;
use oxc_semantic::Scoping;

use super::TraverseCtx;

/// Wrapper around [`TraverseCtx`], allowing its reuse.
///
/// We cannot expose ability to obtain an owned [`TraverseCtx`], as it's then possible to circumvent
/// the safety invariants of [`TraverseAncestry`].
///
/// This wrapper type can safely be passed to user code as only ways it can be used are to:
///
/// * Call `traverse_mut_with_ctx`, which maintains safety invariants.
/// * Unwrap it to [`Scoping`] and / or `State`, which discards the sensitive [`TraverseAncestry`] in the process.
///
/// [`TraverseAncestry`]: super::TraverseAncestry
#[repr(transparent)]
pub struct ReusableTraverseCtx<'a, State>(TraverseCtx<'a, State>);

// Public methods
impl<'a, State> ReusableTraverseCtx<'a, State> {
    /// Create new [`ReusableTraverseCtx`].
    pub fn new(state: State, scoping: Scoping, allocator: &'a Allocator) -> Self {
        Self(TraverseCtx::new(state, scoping, allocator))
    }

    /// Get a reference to the user state.
    pub fn state(&self) -> &State {
        &self.0.state
    }
}

// Internal methods
impl<'a, State> ReusableTraverseCtx<'a, State> {
    /// Mutably borrow [`TraverseCtx`] from a [`ReusableTraverseCtx`].
    #[inline] // because this function is a no-op at run time
    pub(crate) fn get_mut(&mut self) -> &mut TraverseCtx<'a, State> {
        &mut self.0
    }
}