OLD | NEW |
| (Empty) |
1 // Copyright (c) 2016, 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 part of js_ast; | |
6 | |
7 final _any = new AnyTypeRef._(); | |
8 final _unknown = new UnknownTypeRef._(); | |
9 final _null = new NullTypeRef(); | |
10 | |
11 /// JavaScript type reference, designed to support a subset of the type systems | |
12 /// of the Closure Compiler and TypeScript: | |
13 /// - https://developers.google.com/closure/compiler/docs/js-for-compiler#types | |
14 /// - https://github.com/Microsoft/TypeScript/blob/v1.8.0-beta/doc/spec.md#3 | |
15 /// | |
16 /// Note that some subtleties like "nullability" or "optionality" are handled | |
17 /// using unions (with a [NullTypeRef] or with an "undefined" named typeref). | |
18 /// Also, primitives aren't modeled differently than named / qualified types, | |
19 /// as it brings little value for now. Primitive-specific type formatting is | |
20 /// handled by the type printers (for instance, the knowledge that | |
21 /// `number|null` is just `number` in TypeScript, and is `number?` in Closure). | |
22 abstract class TypeRef extends Expression { | |
23 | |
24 int get precedenceLevel => PRIMARY; | |
25 | |
26 TypeRef(); | |
27 | |
28 factory TypeRef.any() => _any; | |
29 | |
30 factory TypeRef.void_() => new TypeRef.named('void'); | |
31 | |
32 factory TypeRef.unknown() => _unknown; | |
33 | |
34 factory TypeRef.generic(TypeRef rawType, Iterable<TypeRef> typeArgs) { | |
35 if (typeArgs.isEmpty) { | |
36 throw new ArgumentError.value(typeArgs, "typeArgs", "is empty"); | |
37 } | |
38 return new GenericTypeRef(rawType, typeArgs.toList()); | |
39 } | |
40 | |
41 factory TypeRef.array([TypeRef elementType]) => | |
42 new ArrayTypeRef(elementType); | |
43 | |
44 factory TypeRef.object([TypeRef keyType, TypeRef valueType]) { | |
45 // TODO(ochafik): Roll out a dedicated ObjectTypeRef? | |
46 var rawType = new TypeRef.named('Object'); | |
47 return keyType == null && valueType == null | |
48 ? rawType | |
49 : new GenericTypeRef(rawType, [keyType ?? _any, valueType ?? _any]); | |
50 } | |
51 | |
52 factory TypeRef.function( | |
53 [TypeRef returnType, Map<Identifier, TypeRef> paramTypes]) => | |
54 new FunctionTypeRef(returnType, paramTypes); | |
55 | |
56 factory TypeRef.record(Map<Identifier, TypeRef> types) => | |
57 new RecordTypeRef(types); | |
58 | |
59 factory TypeRef.string() => new TypeRef.named('string'); | |
60 | |
61 factory TypeRef.number() => new TypeRef.named('number'); | |
62 | |
63 factory TypeRef.undefined() => new TypeRef.named('undefined'); | |
64 | |
65 factory TypeRef.boolean() => new TypeRef.named('boolean'); | |
66 | |
67 factory TypeRef.qualified(List<Identifier> path) => | |
68 new QualifiedTypeRef(path); | |
69 | |
70 factory TypeRef.named(String name) => | |
71 new TypeRef.qualified(<Identifier>[new Identifier(name)]); | |
72 | |
73 bool get isAny => this is AnyTypeRef; | |
74 bool get isUnknown => this is UnknownTypeRef; | |
75 bool get isNull => this is NullTypeRef; | |
76 | |
77 TypeRef or(TypeRef other) => new UnionTypeRef([this, other]); | |
78 | |
79 TypeRef orUndefined() => or(new TypeRef.undefined()); | |
80 TypeRef orNull() => or(_null); | |
81 | |
82 TypeRef toOptional() => | |
83 new OptionalTypeRef(this); | |
84 } | |
85 | |
86 class AnyTypeRef extends TypeRef { | |
87 AnyTypeRef._() : super(); | |
88 | |
89 factory AnyTypeRef() => _any; | |
90 accept(NodeVisitor visitor) => visitor.visitAnyTypeRef(this); | |
91 void visitChildren(NodeVisitor visitor) {} | |
92 _clone() => new AnyTypeRef(); | |
93 } | |
94 | |
95 class NullTypeRef extends QualifiedTypeRef { | |
96 NullTypeRef() : super([new Identifier("null")]); | |
97 _clone() => new NullTypeRef(); | |
98 } | |
99 | |
100 class UnknownTypeRef extends TypeRef { | |
101 UnknownTypeRef._() : super(); | |
102 | |
103 factory UnknownTypeRef() => _unknown; | |
104 accept(NodeVisitor visitor) => visitor.visitUnknownTypeRef(this); | |
105 void visitChildren(NodeVisitor visitor) {} | |
106 _clone() => new UnknownTypeRef(); | |
107 } | |
108 | |
109 class QualifiedTypeRef extends TypeRef { | |
110 final List<Identifier> path; | |
111 QualifiedTypeRef(this.path); | |
112 | |
113 accept(NodeVisitor visitor) => visitor.visitQualifiedTypeRef(this); | |
114 void visitChildren(NodeVisitor visitor) => | |
115 path.forEach((p) => p.accept(visitor)); | |
116 _clone() => new QualifiedTypeRef(path); | |
117 } | |
118 | |
119 class ArrayTypeRef extends TypeRef { | |
120 final TypeRef elementType; | |
121 ArrayTypeRef(this.elementType); | |
122 accept(NodeVisitor visitor) => visitor.visitArrayTypeRef(this); | |
123 void visitChildren(NodeVisitor visitor) { | |
124 elementType.accept(visitor); | |
125 } | |
126 _clone() => new ArrayTypeRef(elementType); | |
127 } | |
128 | |
129 class GenericTypeRef extends TypeRef { | |
130 final TypeRef rawType; | |
131 final List<TypeRef> typeArgs; | |
132 GenericTypeRef(this.rawType, this.typeArgs); | |
133 | |
134 accept(NodeVisitor visitor) => visitor.visitGenericTypeRef(this); | |
135 void visitChildren(NodeVisitor visitor) { | |
136 rawType.accept(visitor); | |
137 typeArgs.forEach((p) => p.accept(visitor)); | |
138 } | |
139 _clone() => new GenericTypeRef(rawType, typeArgs); | |
140 } | |
141 | |
142 class UnionTypeRef extends TypeRef { | |
143 final List<TypeRef> types; | |
144 UnionTypeRef(this.types); | |
145 | |
146 accept(NodeVisitor visitor) => visitor.visitUnionTypeRef(this); | |
147 void visitChildren(NodeVisitor visitor) { | |
148 types.forEach((p) => p.accept(visitor)); | |
149 } | |
150 _clone() => new UnionTypeRef(types); | |
151 | |
152 @override | |
153 TypeRef or(TypeRef other) { | |
154 if (types.contains(other)) return this; | |
155 return new UnionTypeRef([]..addAll(types)..add(other)); | |
156 } | |
157 } | |
158 | |
159 class OptionalTypeRef extends TypeRef { | |
160 final TypeRef type; | |
161 OptionalTypeRef(this.type); | |
162 | |
163 accept(NodeVisitor visitor) => visitor.visitOptionalTypeRef(this); | |
164 void visitChildren(NodeVisitor visitor) { | |
165 type.accept(visitor); | |
166 } | |
167 _clone() => new OptionalTypeRef(type); | |
168 | |
169 @override | |
170 TypeRef orUndefined() => this; | |
171 } | |
172 | |
173 class RecordTypeRef extends TypeRef { | |
174 final Map<Identifier, TypeRef> types; | |
175 RecordTypeRef(this.types); | |
176 | |
177 accept(NodeVisitor visitor) => visitor.visitRecordTypeRef(this); | |
178 void visitChildren(NodeVisitor visitor) { | |
179 types.values.forEach((p) => p.accept(visitor)); | |
180 } | |
181 _clone() => new RecordTypeRef(types); | |
182 } | |
183 | |
184 class FunctionTypeRef extends TypeRef { | |
185 final TypeRef returnType; | |
186 final Map<Identifier, TypeRef> paramTypes; | |
187 FunctionTypeRef(this.returnType, this.paramTypes); | |
188 | |
189 accept(NodeVisitor visitor) => visitor.visitFunctionTypeRef(this); | |
190 void visitChildren(NodeVisitor visitor) { | |
191 returnType.accept(visitor); | |
192 paramTypes.forEach((n, t) { | |
193 n.accept(visitor); | |
194 t.accept(visitor); | |
195 }); | |
196 } | |
197 _clone() => new FunctionTypeRef(returnType, paramTypes); | |
198 } | |
OLD | NEW |