OLD | NEW |
| (Empty) |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | |
2 // for details. All rights reserved. Use of this source code is governed by a | |
3 // BSD-style license that can be found in the LICENSE file. | |
4 | |
5 /// Contains a builder object useful for creating source maps programatically. | |
6 library source_maps.builder; | |
7 | |
8 // TODO(sigmund): add a builder for multi-section mappings. | |
9 | |
10 import 'dart:convert'; | |
11 | |
12 import 'package:source_span/source_span.dart'; | |
13 | |
14 import 'parser.dart'; | |
15 import 'src/source_map_span.dart'; | |
16 | |
17 /// Builds a source map given a set of mappings. | |
18 class SourceMapBuilder { | |
19 | |
20 final List<Entry> _entries = <Entry>[]; | |
21 | |
22 /// Adds an entry mapping the [targetOffset] to [source]. | |
23 void addFromOffset(SourceLocation source, SourceFile targetFile, | |
24 int targetOffset, String identifier) { | |
25 if (targetFile == null) { | |
26 throw new ArgumentError('targetFile cannot be null'); | |
27 } | |
28 _entries.add( | |
29 new Entry(source, targetFile.location(targetOffset), identifier)); | |
30 } | |
31 | |
32 /// Adds an entry mapping [target] to [source]. | |
33 /// | |
34 /// If [isIdentifier] is true or if [target] is a [SourceMapSpan] with | |
35 /// `isIdentifier` set to true, this entry is considered to represent an | |
36 /// identifier whose value will be stored in the source map. [isIdenfier] | |
37 /// takes precedence over [target]'s `isIdentifier` value. | |
38 void addSpan(SourceSpan source, SourceSpan target, {bool isIdentifier}) { | |
39 if (isIdentifier == null) { | |
40 isIdentifier = source is SourceMapSpan ? source.isIdentifier : false; | |
41 } | |
42 | |
43 var name = isIdentifier ? source.text : null; | |
44 _entries.add(new Entry(source.start, target.start, name)); | |
45 } | |
46 | |
47 /// Adds an entry mapping [target] to [source]. | |
48 void addLocation(SourceLocation source, SourceLocation target, | |
49 String identifier) { | |
50 _entries.add(new Entry(source, target, identifier)); | |
51 } | |
52 | |
53 /// Encodes all mappings added to this builder as a json map. | |
54 Map build(String fileUrl) { | |
55 return new SingleMapping.fromEntries(this._entries, fileUrl).toJson(); | |
56 } | |
57 | |
58 /// Encodes all mappings added to this builder as a json string. | |
59 String toJson(String fileUrl) => JSON.encode(build(fileUrl)); | |
60 } | |
61 | |
62 /// An entry in the source map builder. | |
63 class Entry implements Comparable { | |
64 /// Span denoting the original location in the input source file | |
65 final SourceLocation source; | |
66 | |
67 /// Span indicating the corresponding location in the target file. | |
68 final SourceLocation target; | |
69 | |
70 /// An identifier name, when this location is the start of an identifier. | |
71 final String identifierName; | |
72 | |
73 /// Creates a new [Entry] mapping [target] to [source]. | |
74 Entry(this.source, this.target, this.identifierName); | |
75 | |
76 /// Implements [Comparable] to ensure that entries are ordered by their | |
77 /// location in the target file. We sort primarily by the target offset | |
78 /// because source map files are encoded by printing each mapping in order as | |
79 /// they appear in the target file. | |
80 int compareTo(Entry other) { | |
81 int res = target.compareTo(other.target); | |
82 if (res != 0) return res; | |
83 res = source.sourceUrl.toString().compareTo( | |
84 other.source.sourceUrl.toString()); | |
85 if (res != 0) return res; | |
86 return source.compareTo(other.source); | |
87 } | |
88 } | |
OLD | NEW |