Class: Opal::SourceMap::Index

Inherits:
Object
  • Object
show all
Includes:
Map
Defined in:
opal/lib/opal/source_map/index.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Map

#as_json, #cache, #marshal_dump, #marshal_load, #to_data_uri_comment, #to_h, #to_json, #to_s

Constructor Details

#initialize(source_maps, join: nil) ⇒ Index

Returns a new instance of Index.

Parameters:

  • source_maps (Opal::SourceMap::File)
  • join: (defaults to: nil)

    the string used to join the sources, empty by default, Opal::Builder uses "\n"



10
11
12
13
# File 'opal/lib/opal/source_map/index.rb', line 10

def initialize(source_maps, join: nil)
  @source_maps = source_maps
  @join = join
end

Instance Attribute Details

#source_mapsObject (readonly)

Returns the value of attribute source_maps.



6
7
8
# File 'opal/lib/opal/source_map/index.rb', line 6

def source_maps
  @source_maps
end

Instance Method Details

#mapObject

To support concatenating generated code and other common post processing, an alternate representation of a map is supported:

1: { 2: version : 3, 3: file: “app.js”, 4: sections: [ 5: { offset: column:0, url: “url_for_part1.map” } 6: { offset: column:10, map: 7: { 8: version : 3, 9: file: “section.js”, 10: sources: ["foo.js", "bar.js"], 11: names: ["src", "maps", "are", "fun"], 12: mappings: "AAAA,E;;ABCDE;" 13: } 14: } 15: ], 16: }

The index map follow the form of the standard map

Line 1: The entire file is an JSON object. Line 2: The version field. See the description of the standard map. Line 3: The name field. See the description of the standard map. Line 4: The sections field.

The “sections” field is an array of JSON objects that itself has two fields “offset” and a source map reference. “offset” is an object with two fields, “line” and “column”, that represent the offset into generated code that the referenced source map represents.

The other field must be either “url” or “map”. A “url” entry must be a URL where a source map can be found for this section and the url is resolved in the same way as the “sources” fields in the standard map. A “map” entry must be an embedded complete source map object. An embedded map does not inherit any values from the containing index map.

The sections must be sorted by starting position and the represented sections may not overlap.



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
# File 'opal/lib/opal/source_map/index.rb', line 56

def map
  offset_line = 0
  offset_column = 0
  {
    version: 3,
    # file: "app.js",
    sections: @source_maps.map do |source_map|
      map = {
        offset: {
          line: offset_line,
          column: offset_column,
        },
        map: source_map.to_h,
      }

      generated_code  = source_map.generated_code
      generated_code += @join if @join
      new_lines_count = generated_code.count("\n")
      last_line       = generated_code[generated_code.rindex("\n") + 1..-1]

      offset_line    += new_lines_count
      offset_column  += last_line.size

      map
    end
  }
end