🥮 mooncakes.io

    sourcemap

    Pure MoonBit Source Map v3 parser, encoder, validator and lookup toolkit

    sourcemap
    source-map
    vlq
    compiler
    debug
    Download zip
    Author
    Version
    0.1.1
    License
    MIT
    Repository
    Last updated
    2 months ago
    Downloads
    46

    No dependencies

    #Derk2006/sourcemap

    Derk2006/sourcemap 是一个 MoonBit 原生 Source Map v3 工具库，提供 Base64 VLQ 编码解码、mappings 字段解析与生成、Source Map JSON 读写、位置查询、多阶段映射合成、范围裁剪、覆盖率统计、质量 lint 和可读报告。

    Source Map 是编译器、代码生成器、打包器、压缩器和 WASM 工具链常用的调试映射格式。本项目把这类能力做成可测试、可复用、无外部运行时依赖的 MoonBit 基础库，便于 MoonBit 生态中的编译器实验、构建工具和调试工具直接复用。

    #安装

    moon add Derk2006/sourcemap

    Mooncakes 包名：

    Derk2006/sourcemap

    #快速示例

    test {
      let map = @sourcemap.SourceMap::SourceMap(
        ["src/main.mbt"],
        [@sourcemap.MappingSegment::mapped(0, 0, 0, 3, 2, name_index=0)],
        names=["main"],
      )
      inspect(
        map.explain_generated(0, 4),
        content="generated 0:4 -> src/main.mbt:3:2 name=main",
      )
    }

    #本地运行

    moon check
moon build
moon test
moon run cmd/main
moon publish --dry-run

    #核心能力

    • Base64 VLQ：encode_vlq、decode_vlq、encode_vlq_values、decode_vlq_values
    • mappings 编解码：decode_mappings、encode_mappings、SourceMap::encoded_mappings
    • JSON 读写：SourceMap::from_json_string、SourceMap::to_json_string
    • 位置查询：find_original、find_generated、explain_generated
    • 校验诊断：validate、errors、warnings、ValidationPolicy
    • 统计报告：stats、source_summaries、report
    • Builder：SourceMapBuilder 自动维护 source/name 索引并支持合并片段
    • 索引与 span：index、spans、gaps_for_line、span_at
    • 范围裁剪：GeneratedRange、OriginalRange、slice_generated_range、slice_original_range
    • 多阶段合成：compose_with、compose_chain、compose_report
    • 质量门禁：SourceMapLintOptions、lint、lint_summary、lint_report
    • 覆盖率：coverage_for_lengths、coverage_for_text、coverage_text_report
    • 名称分析：name_uses、name_frequency、name_report
    • 差异分析：diff、SourceMapDiff::summary
    • 追踪调试：trace_vlq、trace_mappings、trace_mappings_report

    #适用场景

    • MoonBit 编译器实验和代码生成器输出 Source Map
    • 构建工具在 CI 中检查 sources、names、ignoreList 和 mappings 的一致性
    • 打包器或压缩器把多阶段 Source Map 合成为最终调试映射
    • 调试工具根据生成代码位置反查原始源码位置
    • 发布前裁剪 Source Map，只保留某个 bundle 片段或某个源文件区间
    • 构建报告统计每个源文件的映射覆盖情况

    #支持范围

    • Source Map v3 普通单文件 map
    • version、file、sourceRoot、sources、sourcesContent、names、mappings、ignoreList
    • 1 字段、4 字段和 5 字段 mapping segment
    • 生成位置到原始位置的最近段查询
    • 原始位置到生成位置的同源同线最近段查询
    • 多阶段 Source Map 合成
    • 生成范围和原始范围裁剪
    • CI lint、覆盖率报告和文本行表分析

    #暂不支持范围

    • sections 索引型 Source Map
    • 读取外部源码文件或远程 Source Map
    • 字符集探测和文件系统路径规范化
    • 与非 MoonBit 运行时的绑定层

    #开源与合规

    本项目采用 MIT 许可证。项目为原创 MoonBit 实现，不移植第三方源代码，不包含来源不明素材或私有代码。实现依据 Source Map v3 公开格式描述完成，核心功能全部使用 MoonBit 编写。

    #工程记录

    • 设计说明：docs/DESIGN.md
    • Mooncakes 非重复调研：docs/MOONCAKES_RESEARCH.md
    • 工单记录：docs/WORKLOG.md
    • 测试记录：docs/TEST_RECORD.md
    • 版本发布记录：docs/RELEASE_NOTES.md
    • 更新日志：CHANGELOG.md

    ComposeSummary

    source
    pub struct ComposeSummary {
      input_segments : Int
      composed_segments : Int
      preserved_segments : Int
      unmapped_segments : Int
      missing_intermediate_segments : Int
    } derive(Eq, ToJson, 
    Debug    )

    ComposeSummary::summary

    source
    fn ComposeSummary::summary(self : ComposeSummary) -> String

    CoverageLine

    source
    pub struct CoverageLine {
      line : Int
      line_length : Int
      mapped_columns : Int
      unmapped_columns : Int
      gap_count : Int
      mapped_ratio : Double
    } derive(Eq, ToJson, 
    Debug    )

    CoverageLine::summary

    source
    fn CoverageLine::summary(self : CoverageLine) -> String

    CoverageReport

    source
    pub struct CoverageReport {
      lines : Array[CoverageLine]
      total_columns : Int
      mapped_columns : Int
      unmapped_columns : Int
      mapped_ratio : Double
    } derive(Eq, ToJson, 
    Debug    )

    CoverageReport::render

    source
    fn CoverageReport::render(self : CoverageReport) -> String

    CoverageReport::summary

    source
    fn CoverageReport::summary(self : CoverageReport) -> String

    Diagnostic

    source
    pub struct Diagnostic {
      severity : String
      code : String
      path : String
      message : String
    } derive(Eq, ToJson, 
    Debug    )

    Validation diagnostic. severity is "error" or "warning"; path points at the field or mapping segment that triggered the diagnostic.

    GeneratedGap

    source
    pub struct GeneratedGap {
      line : Int
      start_column : Int
      end_column : Int?
    } derive(Eq, ToJson, 
    Debug    )

    GeneratedLineInfo

    source
    pub struct GeneratedLineInfo {
      line : Int
      start_offset : Int
      end_offset : Int
      length : Int
      has_line_break : Bool
    } derive(Eq, ToJson, 
    Debug    )

    GeneratedLineInfo::summary

    source
    fn GeneratedLineInfo::summary(self : GeneratedLineInfo) -> String

    GeneratedPosition

    source
    pub struct GeneratedPosition {
      line : Int
      column : Int
    } derive(Eq, ToJson, 
    Debug    )

    Position in generated code. Lines and columns are zero-based, matching the Source Map v3 format.

    GeneratedPosition::GeneratedPosition

    source
    fn GeneratedPosition::GeneratedPosition(line : Int, column : Int) -> GeneratedPosition

    GeneratedRange

    source
    pub struct GeneratedRange {
      start_line : Int
      start_column : Int
      end_line : Int?
      end_column : Int?
    } derive(Eq, ToJson, 
    Debug    )

    Half-open generated-code range. end_line=None means the range has no upper bound. When end_line is present and end_column=None, the range ends at the start of end_line.

    GeneratedRange::GeneratedRange

    source
    fn GeneratedRange::GeneratedRange(start_line : Int, start_column? : Int, end_line? : Int, end_column? : Int) -> GeneratedRange

    GeneratedRange::contains

    source
    fn GeneratedRange::contains(self : GeneratedRange, line : Int, column : Int) -> Bool

    GeneratedRange::is_empty

    source
    fn GeneratedRange::is_empty(self : GeneratedRange) -> Bool

    GeneratedSpan

    source
    pub struct GeneratedSpan {
      line : Int
      start_column : Int
      end_column : Int?
      source_index : Int?
      original_line : Int?
      original_column : Int?
      name_index : Int?
    } derive(Eq, ToJson, 
    Debug    )

    A generated-code span derived from adjacent mapping segments on the same generated line. end_column=None means the span extends to the end of line.

    GeneratedSpan::contains

    source
    fn GeneratedSpan::contains(self : GeneratedSpan, line : Int, column : Int) -> Bool

    GeneratedSpan::width_hint

    source
    fn GeneratedSpan::width_hint(self : GeneratedSpan, fallback_end : Int) -> Int

    LineIndexEntry

    source
    pub struct LineIndexEntry {
      line : Int
      start : Int
      end : Int
    } derive(Eq, ToJson, 
    Debug    )

    LineSummary

    source
    pub struct LineSummary {
      line : Int
      segment_count : Int
      mapped_segment_count : Int
      unmapped_segment_count : Int
      first_column : Int?
      last_column : Int?
    } derive(Eq, ToJson, 
    Debug    )

    LintSummary

    source
    pub struct LintSummary {
      errors : Int
      warnings : Int
      mapped_ratio : Double
      unused_sources : Int
      unused_names : Int
      duplicate_sources : Int
      duplicate_names : Int
    } derive(Eq, ToJson, 
    Debug    )

    LintSummary::passes

    source
    fn LintSummary::passes(self : LintSummary) -> Bool

    LintSummary::summary

    source
    fn LintSummary::summary(self : LintSummary) -> String

    MappingIndex

    source
    pub struct MappingIndex {
      segments : Array[MappingSegment]
      lines : Array[LineIndexEntry]
    } derive(Eq, ToJson, 
    Debug    )

    MappingIndex::entry_for_line

    source
    fn MappingIndex::entry_for_line(self : MappingIndex, line : Int) -> LineIndexEntry?

    MappingIndex::find_generated_exact

    source
    fn MappingIndex::find_generated_exact(self : MappingIndex, line : Int, column : Int) -> MappingSegment?

    MappingIndex::find_generated_floor

    source
    fn MappingIndex::find_generated_floor(self : MappingIndex, line : Int, column : Int) -> MappingSegment?

    MappingIndex::first_segment_for_line

    source
    fn MappingIndex::first_segment_for_line(self : MappingIndex, line : Int) -> MappingSegment?

    MappingIndex::generated_line_numbers

    source
    fn MappingIndex::generated_line_numbers(self : MappingIndex) -> Array[Int]

    MappingIndex::last_segment_for_line

    source
    fn MappingIndex::last_segment_for_line(self : MappingIndex, line : Int) -> MappingSegment?

    MappingIndex::line_count

    source
    fn MappingIndex::line_count(self : MappingIndex) -> Int

    MappingIndex::line_has_mappings

    source
    fn MappingIndex::line_has_mappings(self : MappingIndex, line : Int) -> Bool

    MappingIndex::line_summary

    source
    fn MappingIndex::line_summary(self : MappingIndex, line : Int) -> LineSummary

    MappingIndex::mapped_segments

    source
    fn MappingIndex::mapped_segments(self : MappingIndex) -> Array[MappingSegment]

    MappingIndex::named_segments

    source
    fn MappingIndex::named_segments(self : MappingIndex) -> Array[MappingSegment]

    MappingIndex::segment_count

    source
    fn MappingIndex::segment_count(self : MappingIndex) -> Int

    MappingIndex::segments_for_line

    source
    fn MappingIndex::segments_for_line(self : MappingIndex, line : Int) -> Array[MappingSegment]

    MappingIndex::summaries

    source
    fn MappingIndex::summaries(self : MappingIndex) -> Array[LineSummary]

    MappingIndex::unmapped_segments

    source
    fn MappingIndex::unmapped_segments(self : MappingIndex) -> Array[MappingSegment]

    MappingSegment

    source
    pub struct MappingSegment {
      generated_line : Int
      generated_column : Int
      source_index : Int?
      original_line : Int?
      original_column : Int?
      name_index : Int?
    } derive(Eq, ToJson, 
    Debug    )

    A decoded mapping segment. A segment with only generated fields is an unmapped generated span; mapped segments carry a source index and original coordinates, plus an optional name index.

    MappingSegment::generated_position

    source
    fn MappingSegment::generated_position(self : MappingSegment) -> GeneratedPosition

    MappingSegment::has_name

    source
    fn MappingSegment::has_name(self : MappingSegment) -> Bool

    MappingSegment::is_mapped

    source
    fn MappingSegment::is_mapped(self : MappingSegment) -> Bool

    MappingSegment::mapped

    source
    fn MappingSegment::mapped(generated_line : Int, generated_column : Int, source_index : Int, original_line : Int, original_column : Int, name_index? : Int) -> MappingSegment

    MappingSegment::unmapped

    source
    fn MappingSegment::unmapped(generated_line : Int, generated_column : Int) -> MappingSegment

    MappingStats

    source
    pub struct MappingStats {
      generated_lines : Int
      total_segments : Int
      mapped_segments : Int
      unmapped_segments : Int
      named_segments : Int
      source_count : Int
      name_count : Int
      ignored_source_count : Int
    } derive(Eq, ToJson, 
    Debug    )

    Aggregated counts that are useful in CI output and smoke tests.

    MappingStats::summary

    source
    fn MappingStats::summary(self : MappingStats) -> String

    NameUse

    source
    pub struct NameUse {
      name : String
      name_index : Int
      generated_line : Int
      generated_column : Int
      source : String?
      original_line : Int?
      original_column : Int?
    } derive(Eq, ToJson, 
    Debug    )

    OriginalPosition

    source
    pub struct OriginalPosition {
      source : String
      line : Int
      column : Int
      name : String?
    } derive(Eq, ToJson, 
    Debug    )

    Position in an original source file. name is optional because most source maps only attach names to identifiers and call sites.

    OriginalPosition::OriginalPosition

    source
    fn OriginalPosition::OriginalPosition(source : StringView, line : Int, column : Int, name? : String) -> OriginalPosition

    OriginalRange

    source
    pub struct OriginalRange {
      source : String
      start_line : Int
      start_column : Int
      end_line : Int?
      end_column : Int?
    } derive(Eq, ToJson, 
    Debug    )

    OriginalRange::OriginalRange

    source
    fn OriginalRange::OriginalRange(source : StringView, start_line : Int, start_column? : Int, end_line? : Int, end_column? : Int) -> OriginalRange

    OriginalRange::contains

    source
    fn OriginalRange::contains(self : OriginalRange, source : StringView, line : Int, column : Int) -> Bool

    OriginalRange::is_empty

    source
    fn OriginalRange::is_empty(self : OriginalRange) -> Bool

    PruneSummary

    source
    pub struct PruneSummary {
      sources_before : Int
      sources_after : Int
      names_before : Int
      names_after : Int
      mappings_before : Int
      mappings_after : Int
    } derive(Eq, ToJson, 
    Debug    )

    PruneSummary::summary

    source
    fn PruneSummary::summary(self : PruneSummary) -> String

    SegmentTrace

    source
    pub struct SegmentTrace {
      line : Int
      segment : Int
      start_offset : Int
      end_offset : Int
      raw : String
      values : Array[Int]
      decoded : MappingSegment?
      error : String?
    } derive(Eq, ToJson, 
    Debug    )

    SegmentTrace::summary

    source
    fn SegmentTrace::summary(self : SegmentTrace) -> String

    SourceMap

    source
    pub struct SourceMap {
      version : Int
      file : String?
      source_root : String?
      sources : Array[String]
      sources_content : Array[String?]
      names : Array[String]
      mappings : Array[MappingSegment]
      ignore_list : Array[Int]
    } derive(Eq, ToJson, 
    Debug    )

    Source Map v3 data model. mappings is stored decoded so callers can query, validate and transform it without repeatedly parsing VLQ text.

    SourceMap::SourceMap

    source
    fn SourceMap::SourceMap(sources : ArrayView[String], mappings : ArrayView[MappingSegment], names? : ArrayView[String], file? : String, source_root? : String, sources_content? : ArrayView[String?], ignore_list? : ArrayView[Int]) -> SourceMap

    SourceMap::canonical

    source
    fn SourceMap::canonical(self : SourceMap) -> SourceMap

    SourceMap::compact

    source
    fn SourceMap::compact(self : SourceMap) -> SourceMap

    SourceMap::compose_report

    source
    fn SourceMap::compose_report(self : SourceMap, previous : SourceMap, intermediate_source? : String) -> String

    SourceMap::compose_summary

    source
    fn SourceMap::compose_summary(self : SourceMap, previous : SourceMap, intermediate_source? : String) -> ComposeSummary

    SourceMap::compose_with

    source
    fn SourceMap::compose_with(self : SourceMap, previous : SourceMap, intermediate_source? : String, preserve_unresolved? : Bool) -> SourceMap

    SourceMap::coverage_for_lengths

    source
    fn SourceMap::coverage_for_lengths(self : SourceMap, line_lengths : ArrayView[Int]) -> CoverageReport

    SourceMap::coverage_for_text

    source
    fn SourceMap::coverage_for_text(self : SourceMap, generated : StringView) -> CoverageReport

    SourceMap::coverage_line

    source
    fn SourceMap::coverage_line(self : SourceMap, line : Int, line_length : Int) -> CoverageLine

    SourceMap::coverage_text_report

    source
    fn SourceMap::coverage_text_report(self : SourceMap, line_lengths : ArrayView[Int]) -> String

    SourceMap::coverage_text_report_for_text

    source
    fn SourceMap::coverage_text_report_for_text(self : SourceMap, generated : StringView) -> String

    SourceMap::deduplicate_names

    source
    fn SourceMap::deduplicate_names(self : SourceMap) -> SourceMap

    SourceMap::deduplicate_sources

    source
    fn SourceMap::deduplicate_sources(self : SourceMap) -> SourceMap

    SourceMap::diff

    source
    fn SourceMap::diff(self : SourceMap, other : SourceMap) -> SourceMapDiff

    SourceMap::drop_generated_before

    source
    fn SourceMap::drop_generated_before(self : SourceMap, line : Int, column? : Int) -> SourceMap

    SourceMap::drop_unmapped

    source
    fn SourceMap::drop_unmapped(self : SourceMap) -> SourceMap

    SourceMap::empty

    source
    fn SourceMap::empty() -> SourceMap

    SourceMap::encoded_mappings

    source
    fn SourceMap::encoded_mappings(self : SourceMap) -> String

    SourceMap::errors

    source
    fn SourceMap::errors(self : SourceMap) -> Array[Diagnostic]

    SourceMap::explain_generated

    source
    fn SourceMap::explain_generated(self : SourceMap, generated_line : Int, generated_column : Int) -> String

    SourceMap::filter_names

    source
    fn SourceMap::filter_names(self : SourceMap, keep : (String) -> Bool) -> SourceMap

    SourceMap::filter_sources

    source
    fn SourceMap::filter_sources(self : SourceMap, keep : (String) -> Bool) -> SourceMap

    SourceMap::find_generated

    source
    fn SourceMap::find_generated(self : SourceMap, source : StringView, original_line : Int, original_column : Int) -> GeneratedPosition?

    SourceMap::find_original

    source
    fn SourceMap::find_original(self : SourceMap, generated_line : Int, generated_column : Int) -> OriginalPosition?

    SourceMap::from_json

    source
    fn SourceMap::from_json(json : Json) -> Result[SourceMap, SourceMapError]

    SourceMap::from_json_string

    source
    fn SourceMap::from_json_string(text : StringView) -> Result[SourceMap, SourceMapError]

    SourceMap::gaps_for_line

    source
    fn SourceMap::gaps_for_line(self : SourceMap, line : Int, line_length : Int) -> Array[GeneratedGap]

    SourceMap::generated_lines

    source
    fn SourceMap::generated_lines(self : SourceMap) -> Int

    SourceMap::generated_range_summary

    source
    fn SourceMap::generated_range_summary(self : SourceMap, range : GeneratedRange) -> String

    SourceMap::index

    source
    fn SourceMap::index(self : SourceMap) -> MappingIndex

    SourceMap::is_source_ignored

    source
    fn SourceMap::is_source_ignored(self : SourceMap, source : StringView) -> Bool

    SourceMap::is_valid

    source
    fn SourceMap::is_valid(self : SourceMap) -> Bool

    SourceMap::line_summaries

    source
    fn SourceMap::line_summaries(self : SourceMap) -> Array[LineSummary]

    SourceMap::lint

    source
    fn SourceMap::lint(self : SourceMap, line_lengths? : ArrayView[Int], options? : SourceMapLintOptions) -> Array[Diagnostic]

    SourceMap::lint_report

    source
    fn SourceMap::lint_report(self : SourceMap, line_lengths? : ArrayView[Int], options? : SourceMapLintOptions) -> String

    SourceMap::lint_summary

    source
    fn SourceMap::lint_summary(self : SourceMap, line_lengths? : ArrayView[Int], options? : SourceMapLintOptions) -> LintSummary

    SourceMap::map_generated_columns

    source
    fn SourceMap::map_generated_columns(self : SourceMap, f : (Int, Int) -> Int) -> SourceMap

    SourceMap::map_original_lines

    source
    fn SourceMap::map_original_lines(self : SourceMap, f : (String, Int) -> Int) -> SourceMap

    SourceMap::mapped_spans

    source
    fn SourceMap::mapped_spans(self : SourceMap) -> Array[GeneratedSpan]

    SourceMap::name_frequency

    source
    fn SourceMap::name_frequency(self : SourceMap) -> Array[(String, Int)]

    SourceMap::name_report

    source
    fn SourceMap::name_report(self : SourceMap) -> String

    SourceMap::name_uses

    source
    fn SourceMap::name_uses(self : SourceMap) -> Array[NameUse]

    SourceMap::normalize_source_slashes

    source
    fn SourceMap::normalize_source_slashes(self : SourceMap) -> SourceMap

    SourceMap::passes_lint

    source
    fn SourceMap::passes_lint(self : SourceMap, line_lengths? : ArrayView[Int], options? : SourceMapLintOptions) -> Bool

    SourceMap::passes_policy

    source
    fn SourceMap::passes_policy(self : SourceMap, policy : ValidationPolicy) -> Bool

    SourceMap::prefix_sources

    source
    fn SourceMap::prefix_sources(self : SourceMap, prefix : StringView) -> SourceMap

    SourceMap::prune_summary

    source
    fn SourceMap::prune_summary(self : SourceMap) -> PruneSummary

    SourceMap::prune_unused

    source
    fn SourceMap::prune_unused(self : SourceMap) -> SourceMap

    SourceMap::prune_unused_names

    source
    fn SourceMap::prune_unused_names(self : SourceMap) -> SourceMap

    SourceMap::prune_unused_sources

    source
    fn SourceMap::prune_unused_sources(self : SourceMap) -> SourceMap

    SourceMap::rename_name

    source
    fn SourceMap::rename_name(self : SourceMap, old_name : StringView, new_name : StringView) -> SourceMap

    SourceMap::rename_source

    source
    fn SourceMap::rename_source(self : SourceMap, old_source : StringView, new_source : StringView) -> SourceMap

    SourceMap::replace_source_prefix

    source
    fn SourceMap::replace_source_prefix(self : SourceMap, old_prefix : StringView, new_prefix : StringView) -> SourceMap

    SourceMap::report

    source
    fn SourceMap::report(self : SourceMap) -> String

    SourceMap::segments_for_source

    source
    fn SourceMap::segments_for_source(self : SourceMap, source : StringView) -> Array[MappingSegment]

    SourceMap::shift_generated

    source
    fn SourceMap::shift_generated(self : SourceMap, line_delta : Int, column_delta_for_first_line : Int) -> SourceMap

    SourceMap::slice_generated_lines

    source
    fn SourceMap::slice_generated_lines(self : SourceMap, start_line : Int, end_line : Int) -> SourceMap

    SourceMap::slice_generated_range

    source
    fn SourceMap::slice_generated_range(self : SourceMap, range : GeneratedRange, rebase? : Bool) -> SourceMap

    SourceMap::slice_original_range

    source
    fn SourceMap::slice_original_range(self : SourceMap, range : OriginalRange, keep_unmapped? : Bool) -> SourceMap

    SourceMap::sorted

    source
    fn SourceMap::sorted(self : SourceMap) -> SourceMap

    SourceMap::source_summaries

    source
    fn SourceMap::source_summaries(self : SourceMap) -> Array[SourceSummary]

    SourceMap::sources_in_generated_range

    source
    fn SourceMap::sources_in_generated_range(self : SourceMap, range : GeneratedRange) -> Array[String]

    SourceMap::span_at

    source
    fn SourceMap::span_at(self : SourceMap, line : Int, column : Int) -> GeneratedSpan?

    SourceMap::spans

    source
    fn SourceMap::spans(self : SourceMap) -> Array[GeneratedSpan]

    SourceMap::spans_for_line

    source
    fn SourceMap::spans_for_line(self : SourceMap, line : Int) -> Array[GeneratedSpan]

    SourceMap::stats

    source
    fn SourceMap::stats(self : SourceMap) -> MappingStats

    SourceMap::symbolicate_frame

    source
    fn SourceMap::symbolicate_frame(self : SourceMap, frame : StackFrame) -> SymbolicatedFrame

    SourceMap::symbolicate_stack

    source
    fn SourceMap::symbolicate_stack(self : SourceMap, stack : StringView) -> Array[SymbolicatedFrame]

    SourceMap::symbolicate_stack_report

    source
    fn SourceMap::symbolicate_stack_report(self : SourceMap, stack : StringView) -> String

    SourceMap::take_generated_before

    source
    fn SourceMap::take_generated_before(self : SourceMap, line : Int, column? : Int) -> SourceMap

    SourceMap::to_builder

    source
    fn SourceMap::to_builder(self : SourceMap) -> SourceMapBuilder

    SourceMap::to_json

    source
    fn SourceMap::to_json(self : SourceMap) -> Json

    SourceMap::to_json_string

    source
    fn SourceMap::to_json_string(self : SourceMap, indent? : Int) -> String

    SourceMap::unmapped_spans

    source
    fn SourceMap::unmapped_spans(self : SourceMap) -> Array[GeneratedSpan]

    SourceMap::unused_names

    source
    fn SourceMap::unused_names(self : SourceMap) -> Array[String]

    SourceMap::unused_sources

    source
    fn SourceMap::unused_sources(self : SourceMap) -> Array[String]

    SourceMap::validate

    source
    fn SourceMap::validate(self : SourceMap) -> Array[Diagnostic]

    SourceMap::validate_with

    source
    fn SourceMap::validate_with(self : SourceMap, policy : ValidationPolicy) -> Array[Diagnostic]

    SourceMap::warnings

    source
    fn SourceMap::warnings(self : SourceMap) -> Array[Diagnostic]

    SourceMap::with_file

    source
    fn SourceMap::with_file(self : SourceMap, file : StringView) -> SourceMap

    SourceMap::with_source_root

    source
    fn SourceMap::with_source_root(self : SourceMap, source_root : StringView) -> SourceMap

    SourceMap::with_sources_content

    source
    fn SourceMap::with_sources_content(self : SourceMap, contents : ArrayView[String?]) -> SourceMap

    SourceMap::without_file

    source
    fn SourceMap::without_file(self : SourceMap) -> SourceMap

    SourceMap::without_names

    source
    fn SourceMap::without_names(self : SourceMap) -> SourceMap

    SourceMap::without_source_root

    source
    fn SourceMap::without_source_root(self : SourceMap) -> SourceMap

    SourceMap::without_sources_content

    source
    fn SourceMap::without_sources_content(self : SourceMap) -> SourceMap

    SourceMapBuilder

    source
    pub struct SourceMapBuilder {
      file : String?
      source_root : String?
      sources : Array[String]
      sources_content : Array[String?]
      names : Array[String]
      mappings : Array[MappingSegment]
      ignore_list : Array[Int]
    } derive(
    Debug    )

    Mutable builder for producing Source Map v3 values without manually maintaining source and name indexes.

    SourceMapBuilder::SourceMapBuilder

    source
    fn SourceMapBuilder::SourceMapBuilder(file? : String, source_root? : String) -> SourceMapBuilder

    SourceMapBuilder::add_line_start

    source
    fn SourceMapBuilder::add_line_start(self : SourceMapBuilder, generated_line : Int, source : StringView, original_line : Int) -> Unit

    SourceMapBuilder::add_mapping

    source
    fn SourceMapBuilder::add_mapping(self : SourceMapBuilder, generated_line : Int, generated_column : Int, source : StringView, original_line : Int, original_column : Int, name? : StringView) -> Unit

    SourceMapBuilder::add_name

    source
    fn SourceMapBuilder::add_name(self : SourceMapBuilder, name : StringView) -> Int

    SourceMapBuilder::add_source

    source
    fn SourceMapBuilder::add_source(self : SourceMapBuilder, source : StringView) -> Int

    SourceMapBuilder::add_unmapped

    source
    fn SourceMapBuilder::add_unmapped(self : SourceMapBuilder, generated_line : Int, generated_column : Int) -> Unit

    SourceMapBuilder::append_segments

    source
    fn SourceMapBuilder::append_segments(self : SourceMapBuilder, segments : ArrayView[MappingSegment]) -> Unit

    SourceMapBuilder::build

    source

    SourceMapBuilder::clear_file

    source
    fn SourceMapBuilder::clear_file(self : SourceMapBuilder) -> Unit

    SourceMapBuilder::clear_source_content

    source
    fn SourceMapBuilder::clear_source_content(self : SourceMapBuilder, source : StringView) -> Bool

    SourceMapBuilder::clear_source_root

    source
    fn SourceMapBuilder::clear_source_root(self : SourceMapBuilder) -> Unit

    SourceMapBuilder::mapping_count

    source
    fn SourceMapBuilder::mapping_count(self : SourceMapBuilder) -> Int

    SourceMapBuilder::mark_ignored

    source
    fn SourceMapBuilder::mark_ignored(self : SourceMapBuilder, source : StringView) -> Int

    SourceMapBuilder::merge_from

    source
    fn SourceMapBuilder::merge_from(self : SourceMapBuilder, other : SourceMap, generated_line_offset? : Int, generated_column_offset? : Int) -> Unit

    SourceMapBuilder::name_count

    source
    fn SourceMapBuilder::name_count(self : SourceMapBuilder) -> Int

    SourceMapBuilder::reset_all

    source
    fn SourceMapBuilder::reset_all(self : SourceMapBuilder) -> Unit

    SourceMapBuilder::reset_mappings

    source
    fn SourceMapBuilder::reset_mappings(self : SourceMapBuilder) -> Unit

    SourceMapBuilder::set_file

    source
    fn SourceMapBuilder::set_file(self : SourceMapBuilder, file : StringView) -> Unit

    SourceMapBuilder::set_source_content

    source
    fn SourceMapBuilder::set_source_content(self : SourceMapBuilder, source : StringView, content : StringView) -> Int

    SourceMapBuilder::set_source_root

    source
    fn SourceMapBuilder::set_source_root(self : SourceMapBuilder, source_root : StringView) -> Unit

    SourceMapBuilder::sort_mappings

    source
    fn SourceMapBuilder::sort_mappings(self : SourceMapBuilder) -> Unit

    SourceMapBuilder::source_count

    source
    fn SourceMapBuilder::source_count(self : SourceMapBuilder) -> Int

    SourceMapBuilder::unmark_ignored

    source
    fn SourceMapBuilder::unmark_ignored(self : SourceMapBuilder, source : StringView) -> Bool

    SourceMapDiff

    source
    pub struct SourceMapDiff {
      same_version : Bool
      same_file : Bool
      added_sources : Array[String]
      removed_sources : Array[String]
      added_names : Array[String]
      removed_names : Array[String]
      mapping_count_before : Int
      mapping_count_after : Int
      changed_mapping_count : Int
    } derive(Eq, ToJson, 
    Debug    )

    SourceMapDiff::has_changes

    source
    fn SourceMapDiff::has_changes(self : SourceMapDiff) -> Bool

    SourceMapDiff::summary

    source
    fn SourceMapDiff::summary(self : SourceMapDiff) -> String

    SourceMapError

    source
    pub(all) enum SourceMapError {
      InvalidBase64(char~ : Char, offset~ : Int)
      TruncatedVlq(offset~ : Int)
      VlqOverflow(offset~ : Int)
      InvalidSegment(line~ : Int, segment~ : Int, values~ : Int, reason~ : String)
      JsonParse(message~ : String)
      JsonDecode(path~ : String, expected~ : String)
      MissingField(field~ : String)
      InvalidField(field~ : String, message~ : String)
    } derive(Eq, ToJson, 
    Debug    )

    Error type returned by parsing and encoding helpers.

    SourceMapError::message

    source
    fn SourceMapError::message(self : SourceMapError) -> String

    SourceMapLintOptions

    source
    pub struct SourceMapLintOptions {
      require_file : Bool
      require_sorted_mappings : Bool
      require_no_duplicate_sources : Bool
      require_no_duplicate_names : Bool
      require_all_sources_used : Bool
      require_all_names_used : Bool
      min_mapped_ratio : Double?
      max_unmapped_segments : Int?
    } derive(Eq, ToJson, 
    Debug    )

    SourceMapLintOptions::SourceMapLintOptions

    source
    fn SourceMapLintOptions::SourceMapLintOptions(require_file? : Bool, require_sorted_mappings? : Bool, require_no_duplicate_sources? : Bool, require_no_duplicate_names? : Bool, require_all_sources_used? : Bool, require_all_names_used? : Bool, min_mapped_ratio? : Double, max_unmapped_segments? : Int) -> SourceMapLintOptions

    SourceMapLintOptions::ci

    source

    SourceSummary

    source
    pub struct SourceSummary {
      source : String
      index : Int
      mapped_segments : Int
      named_segments : Int
      first_original_line : Int?
      last_original_line : Int?
      ignored : Bool
    } derive(Eq, ToJson, 
    Debug    )

    Per-source summary for dashboards and build reports.

    StackFrame

    source
    pub struct StackFrame {
      function_name : String?
      file : String
      line : Int
      column : Int
    } derive(Eq, ToJson, 
    Debug    )

    StackFrame::render

    source
    fn StackFrame::render(self : StackFrame) -> String

    SymbolicatedFrame

    source
    pub struct SymbolicatedFrame {
      generated : StackFrame
      original : OriginalPosition?
    } derive(Eq, ToJson, 
    Debug    )

    SymbolicatedFrame::render

    source
    fn SymbolicatedFrame::render(self : SymbolicatedFrame) -> String

    ValidationPolicy

    source
    pub struct ValidationPolicy {
      require_file : Bool
      require_sources_content : Bool
      forbid_empty_sources : Bool
      forbid_empty_names : Bool
      allow_unmapped_segments : Bool
      allow_ignore_list : Bool
      max_segment_count : Int?
      max_source_count : Int?
    } derive(Eq, ToJson, 
    Debug    )

    ValidationPolicy::ValidationPolicy

    source
    fn ValidationPolicy::ValidationPolicy(require_file? : Bool, require_sources_content? : Bool, forbid_empty_sources? : Bool, forbid_empty_names? : Bool, allow_unmapped_segments? : Bool, allow_ignore_list? : Bool, max_segment_count? : Int, max_source_count? : Int) -> ValidationPolicy

    ValidationPolicy::default

    source

    ValidationPolicy::strict

    source

    ValidationPolicy::with_ignore_list

    source
    fn ValidationPolicy::with_ignore_list(self : ValidationPolicy, allow : Bool) -> ValidationPolicy

    ValidationPolicy::with_limits

    source
    fn ValidationPolicy::with_limits(self : ValidationPolicy, max_segment_count? : Int, max_source_count? : Int) -> ValidationPolicy

    ValidationPolicy::with_unmapped_segments

    source
    fn ValidationPolicy::with_unmapped_segments(self : ValidationPolicy, allow : Bool) -> ValidationPolicy

    VlqTraceStep

    source
    pub struct VlqTraceStep {
      offset : Int
      char : String
      digit : Int
      payload : Int
      continuation : Bool
      shift : Int
      partial : Int
    } derive(Eq, ToJson, 
    Debug    )

    compose_chain

    source
    fn compose_chain(maps : ArrayView[SourceMap]) -> SourceMap

    decode_mappings

    source
    fn decode_mappings(input : StringView) -> Result[Array[MappingSegment], SourceMapError]

    decode_vlq

    source
    fn decode_vlq(input : StringView, offset : Int) -> Result[(Int, Int), SourceMapError]

    decode_vlq_values

    source
    fn decode_vlq_values(input : StringView) -> Result[Array[Int], SourceMapError]

    encode_mappings

    source
    fn encode_mappings(segments : ArrayView[MappingSegment]) -> String

    encode_vlq

    source
    fn encode_vlq(value : Int) -> String

    encode_vlq_values

    source
    fn encode_vlq_values(values : ArrayView[Int]) -> String

    generated_line_count

    source
    fn generated_line_count(input : StringView) -> Int

    generated_line_lengths

    source
    fn generated_line_lengths(input : StringView) -> Array[Int]

    generated_offset_to_position

    source
    fn generated_offset_to_position(input : StringView, offset : Int) -> GeneratedPosition?

    generated_position_to_offset

    source
    fn generated_position_to_offset(input : StringView, line : Int, column : Int) -> Int?

    line_table

    source
    fn line_table(input : StringView) -> Array[GeneratedLineInfo]

    line_table_report

    source
    fn line_table_report(input : StringView) -> String

    parse_stack

    source
    fn parse_stack(text : StringView) -> Array[StackFrame]

    parse_stack_frame

    source
    fn parse_stack_frame(line : StringView) -> StackFrame?

    render_symbolicated_stack

    source
    fn render_symbolicated_stack(frames : ArrayView[SymbolicatedFrame]) -> String

    trace_mappings

    source
    fn trace_mappings(input : StringView) -> Array[SegmentTrace]

    trace_mappings_report

    source
    fn trace_mappings_report(input : StringView) -> String

    trace_vlq

    source
    fn trace_vlq(input : StringView, offset : Int) -> Result[Array[VlqTraceStep], SourceMapError]

    vlq_fixture_checksum

    source
    fn vlq_fixture_checksum() -> Int

    vlq_fixture_values

    source
    fn vlq_fixture_values() -> Array[Int]

    Regression corpus for Base64 VLQ roundtrip checks. The dense -350..350 window crosses every low-bit continuation boundary used by Source Map VLQ.

    Source Files

    Powered by MoonBit

    Site sourceReport issueModulesSkillsCLIBuild queueStatistics

    © 2026 mooncakes.io