Struct SourceMapBuilder 

pub struct SourceMapBuilder { /* private fields */ }

Accumulates source-map checkpoints during emission. Lives behind a RefCell on bynk-emit’s LowerCtx so the deep lowering chain and the declaration loop can both record without fighting the borrow checker. A sub-builder (one per spliced body) records against its local buffer, then is merged into the module builder at the splice offset.

Implementations

impl SourceMapBuilder

pub fn new() -> Self

pub fn add_source( &mut self, name: impl Into<String>, text: impl Into<String>, ) -> usize

Register a source file, returning its id (index into sources). Idempotent by name, so a test module that registers the same .bynk file for several cases reuses one id. The first registered source is the primary one (record targets it).

pub fn record(&mut self, byte_offset: usize, span: Span)

Record that generated text from byte_offset onward originates at span in the primary source (id 0), until the next checkpoint. Callers pass out.len() before appending the statement’s text. Sub-builders use this; merge re-tags the source id.

pub fn shift_checkpoints(&mut self, delta: usize)

Shift every recorded checkpoint’s generated-buffer offset forward by delta bytes. For a sub-builder whose checkpoints were recorded against a local buffer’s pre-splice contents, call this right after text is inserted before byte 0 of that buffer (e.g. emit_service’s subscriber-filter/schema-gate prologue, #1363) so the checkpoints stay correct against the buffer’s new contents before merge reads them — merge resolves each checkpoint’s line against sub_text as handed to it, which has no way to know a prologue was spliced in ahead of the recorded offsets.

pub fn merge( &mut self, sub: &SourceMapBuilder, sub_text: &str, out: &str, base_byte: usize, source_id: usize, )

Merge a sub-builder’s body checkpoints into this module builder, rebased to the spliced body’s position and re-tagged to source_id (v0.70).

sub_text is the body’s local buffer; out is the module buffer after the body has been spliced into it; base_byte is out.len() captured before the splice (where the body’s first line starts in out). The merge is line-anchored: a checkpoint on body line k maps to module line base_line + k, so it is correct whether the splice appended the body verbatim (handlers) or rebuilt it line-by-line with indentation (tests) — both preserve line structure. Column is irrelevant: maps are line-level.

pub fn to_v3(&self, generated: &str, generated_file: &str) -> Option<String>

Serialise to a source-map v3 JSON document over the registered sources. generated is the finished buffer; generated_file is the file field. Returns None when nothing resolves (no sources, or no in-range checkpoint).

Trait Implementations

impl Clone for SourceMapBuilder

fn clone(&self) -> SourceMapBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SourceMapBuilder

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

Formats the value using the given formatter.

impl Default for SourceMapBuilder

fn default() -> SourceMapBuilder

Returns the “default value” for a type.