Enum SourceMap

pub enum SourceMap {
    Decoded(InnerSourceMap),
    Sectioned(SectionedSourceMap),
}

Implements the source map specification as either a decoded or sectioned sourcemap.

• A “decoded” map represents a source map as if it was came out of a JSON decode.
• A “sectioned” source map is a tree of many SourceMap covering regions of an output file.

The distinction between the source map spec’s [sourcemap::Index] and our SourceMap::Sectioned is whether the sections are represented with Vcs pointers.

Variants

Decoded(InnerSourceMap)

A decoded source map contains no Vcs.

Sectioned(SectionedSourceMap)

A sectioned source map contains many (possibly recursive) maps covering different regions of the file.

Implementations

impl SourceMap

pub fn cell(self) -> Vc<Self>

Places a value in a cell of the current task.

Cell is selected based on the value type and call order of cell.

pub fn resolved_cell(self) -> ResolvedVc<Self>

Places a value in a cell of the current task. Returns a ResolvedVc.

Cell is selected based on the value type and call order of cell.

impl SourceMap

pub fn empty_uncelled() -> Self

pub fn new_regular(map: RegularMap) -> Self

Creates a new SourceMap::Decoded Vc out of a [RegularMap] instance.

pub fn new_decoded(map: DecodedMap) -> Self

Creates a new SourceMap::Decoded Vc out of a [DecodedMap] instance.

pub fn new_sectioned(sections: Vec<SourceMapSection>) -> Self

Creates a new SourceMap::Sectioned Vc out of a collection of source map sections.

pub fn new_from_rope(content: &Rope) -> Result<Option<Self>>

pub async fn new_from_file(file: Vc<FileSystemPath>) -> Result<Option<Self>>

pub async fn new_from_file_content( content: Vc<FileContent>, ) -> Result<Option<Self>>

impl SourceMap

pub fn new_from_rope_cached( content: Vc<OptionStringifiedSourceMap>, ) -> Vc<OptionSourceMap>

This function should be used sparingly to reduce memory usage, only in cold code paths (issue resolving, etc).

impl SourceMap

pub async fn to_source_map(&self) -> Result<Arc<CrateMapWrapper>>

impl SourceMap

pub fn empty() -> Self

A source map that contains no actual source location information (no sources, no mappings that point into a source). This is used to tell Chrome that the generated code starting at a particular offset is no longer part of the previous section’s mappings.

pub fn empty_rope() -> Rope

A source map that contains no actual source location information (no sources, no mappings that point into a source). This is used to tell Chrome that the generated code starting at a particular offset is no longer part of the previous section’s mappings.

pub fn sections_to_rope( sections: impl IntoIterator<Item = (SourcePos, Rope)>, ) -> Result<Rope>

pub async fn to_rope(&self) -> Result<Rope>

Stringifies the source map into JSON bytes.

pub async fn lookup_token(&self, line: u32, column: u32) -> Result<Token>

Traces a generated line/column into an mapping token representing either synthetic code or user-authored original code.

pub async fn lookup_token_and_source( &self, line: u32, column: u32, ) -> Result<TokenWithSource>

Traces a generated line/column into an mapping token representing either synthetic code or user-authored original code.

pub async fn with_resolved_sources( &self, origin: Vc<FileSystemPath>, ) -> Result<Self>

Trait Implementations

impl Debug for SourceMap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SourceMap

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<SourceMap> for Vc<SourceMap>

fn from(value: SourceMap) -> Self

Converts to this type from the input type.

impl GenerateSourceMap for SourceMap

fn generate_source_map(self: Vc<Self>) -> Vc<OptionStringifiedSourceMap>

Generates a usable source map, capable of both tracing and stringifying.

fn by_section(self: Vc<Self>, _section: RcStr) -> Vc<OptionStringifiedSourceMap>

where Self: Sized,

Returns an individual section of the larger source map, if found.

impl PartialEq for SourceMap

fn eq(&self, other: &SourceMap) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SourceMap

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ShrinkToFit for SourceMap

fn shrink_to_fit(&mut self)

impl TraceRawVcs for SourceMap

fn trace_raw_vcs(&self, __context__: &mut TraceRawVcsContext)

fn get_raw_vcs(&self) -> Vec<RawVc>

impl ValueDebug for SourceMap

fn dbg(self: Vc<Self>) -> Vc<ValueDebugString>

fn dbg_depth(self: Vc<Self>, depth: usize) -> Vc<ValueDebugString>

Like dbg, but with a depth limit.

impl ValueDebugFormat for SourceMap

fn value_debug_format<'a>(&'a self, depth: usize) -> ValueDebugFormatString<'a>

impl VcValueType for SourceMap

type Read = VcDefaultRead<SourceMap>

How to read the value.

type CellMode = VcCellNewMode<SourceMap>

How to update cells of this value type.

fn get_value_type_id() -> ValueTypeId

Returns the type id of the value type.

impl Eq for SourceMap

impl NonLocalValue for SourceMap

impl StructuralPartialEq for SourceMap

impl Upcast<Box<dyn GenerateSourceMap>> for SourceMap

impl Upcast<Box<dyn ValueDebug>> for SourceMap