| Index: tool/input_sdk/private/types.dart
|
| diff --git a/tool/input_sdk/private/types.dart b/tool/input_sdk/private/types.dart
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..d74be7190782067ac9f11ce947719fcb1498a979
|
| --- /dev/null
|
| +++ b/tool/input_sdk/private/types.dart
|
| @@ -0,0 +1,546 @@
|
| +// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file
|
| +// for details. All rights reserved. Use of this source code is governed by a
|
| +// BSD-style license that can be found in the LICENSE file.
|
| +
|
| +/// This library defines the representation of runtime types.
|
| +part of dart._runtime;
|
| +
|
| +/// The Symbol for storing type arguments on a specialized generic type.
|
| +final _mixins = JS('', 'Symbol("mixins")');
|
| +@JSExportName('implements')
|
| +final implements_ = JS('', 'Symbol("implements")');
|
| +final metadata = JS('', 'Symbol("metadata")');
|
| +
|
| +
|
| +///
|
| +/// Types in dart are represented at runtime as follows.
|
| +/// - Normal nominal types, produced from classes, are represented
|
| +/// at runtime by the JS class of which they are an instance.
|
| +/// If the type is the result of instantiating a generic class,
|
| +/// then the "classes" module manages the association between the
|
| +/// instantiated class and the original class declaration
|
| +/// and the type arguments with which it was instantiated. This
|
| +/// assocation can be queried via the "classes" module".
|
| +///
|
| +/// - All other types are represented as instances of class TypeRep,
|
| +/// defined in this module.
|
| +/// - Dynamic, Void, and Bottom are singleton instances of sentinal
|
| +/// classes.
|
| +/// - Function types are instances of subclasses of AbstractFunctionType.
|
| +///
|
| +/// Function types are represented in one of two ways:
|
| +/// - As an instance of FunctionType. These are eagerly computed.
|
| +/// - As an instance of TypeDef. The TypeDef representation lazily
|
| +/// computes an instance of FunctionType, and delegates to that instance.
|
| +///
|
| +/// All types satisfy the following interface:
|
| +/// get String name;
|
| +/// String toString();
|
| +///
|
| +///
|
| +final TypeRep = JS('', '''
|
| + class TypeRep extends $LazyTagged(() => $Type) {
|
| + get name() {return this.toString();}
|
| + }
|
| +''');
|
| +
|
| +final Dynamic = JS('', '''
|
| + class Dynamic extends $TypeRep {
|
| + toString() { return "dynamic"; }
|
| + }
|
| +''');
|
| +@JSExportName('dynamic')
|
| +final dynamicR = JS('', 'new $Dynamic()');
|
| +
|
| +final Void = JS('', '''
|
| + class Void extends $TypeRep {
|
| + toString() { return "void"; }
|
| + }
|
| +''');
|
| +
|
| +@JSExportName('void')
|
| +final voidR = JS('', 'new $Void()');
|
| +
|
| +final Bottom = JS('', '''
|
| + class Bottom extends $TypeRep {
|
| + toString() { return "bottom"; }
|
| + }
|
| +''');
|
| +final bottom = JS('', 'new $Bottom()');
|
| +
|
| +final JSObject = JS('', '''
|
| + class JSObject extends $TypeRep {
|
| + toString() { return "NativeJavaScriptObject"; }
|
| + }
|
| +''');
|
| +final jsobject = JS('', 'new $JSObject()');
|
| +
|
| +final AbstractFunctionType = JS('', '''
|
| + class AbstractFunctionType extends $TypeRep {
|
| + constructor() {
|
| + super();
|
| + this._stringValue = null;
|
| + }
|
| +
|
| + toString() { return this.name; }
|
| +
|
| + get name() {
|
| + if (this._stringValue) return this._stringValue;
|
| +
|
| + let buffer = '(';
|
| + for (let i = 0; i < this.args.length; ++i) {
|
| + if (i > 0) {
|
| + buffer += ', ';
|
| + }
|
| + buffer += $typeName(this.args[i]);
|
| + }
|
| + if (this.optionals.length > 0) {
|
| + if (this.args.length > 0) buffer += ', ';
|
| + buffer += '[';
|
| + for (let i = 0; i < this.optionals.length; ++i) {
|
| + if (i > 0) {
|
| + buffer += ', ';
|
| + }
|
| + buffer += $typeName(this.optionals[i]);
|
| + }
|
| + buffer += ']';
|
| + } else if (Object.keys(this.named).length > 0) {
|
| + if (this.args.length > 0) buffer += ', ';
|
| + buffer += '{';
|
| + let names = $getOwnPropertyNames(this.named).sort();
|
| + for (let i = 0; i < names.length; ++i) {
|
| + if (i > 0) {
|
| + buffer += ', ';
|
| + }
|
| + buffer += names[i] + ': ' + $typeName(this.named[names[i]]);
|
| + }
|
| + buffer += '}';
|
| + }
|
| +
|
| + buffer += ') -> ' + $typeName(this.returnType);
|
| + this._stringValue = buffer;
|
| + return buffer;
|
| + }
|
| + }
|
| +''');
|
| +
|
| +final FunctionType = JS('', '''
|
| + class FunctionType extends $AbstractFunctionType {
|
| + /**
|
| + * Construct a function type. There are two arrow constructors,
|
| + * distinguished by the "definite" flag.
|
| + *
|
| + * The fuzzy arrow (definite is false) treats any arguments
|
| + * of type dynamic as having type bottom, and will always be
|
| + * called with a dynamic invoke.
|
| + *
|
| + * The definite arrow (definite is true) leaves arguments unchanged.
|
| + *
|
| + * We eagerly canonize the argument types to avoid having to deal with
|
| + * this logic in multiple places.
|
| + *
|
| + * TODO(leafp): Figure out how to present this to the user. How
|
| + * should these be printed out?
|
| + */
|
| + constructor(definite, returnType, args, optionals, named) {
|
| + super();
|
| + this.definite = definite;
|
| + this.returnType = returnType;
|
| + this.args = args;
|
| + this.optionals = optionals;
|
| + this.named = named;
|
| +
|
| + // TODO(vsm): This is just parameter metadata for now.
|
| + this.metadata = [];
|
| + function process(array, metadata) {
|
| + var result = [];
|
| + for (var i = 0; i < array.length; ++i) {
|
| + var arg = array[i];
|
| + if (arg instanceof Array) {
|
| + metadata.push(arg.slice(1));
|
| + result.push(arg[0]);
|
| + } else {
|
| + metadata.push([]);
|
| + result.push(arg);
|
| + }
|
| + }
|
| + return result;
|
| + }
|
| + this.args = process(this.args, this.metadata);
|
| + this.optionals = process(this.optionals, this.metadata);
|
| + // TODO(vsm): Add named arguments.
|
| + this._canonize();
|
| + }
|
| + _canonize() {
|
| + if (this.definite) return;
|
| +
|
| + function replace(a) {
|
| + return (a == $dynamicR) ? $bottom : a;
|
| + }
|
| +
|
| + this.args = this.args.map(replace);
|
| +
|
| + if (this.optionals.length > 0) {
|
| + this.optionals = this.optionals.map(replace);
|
| + }
|
| +
|
| + if (Object.keys(this.named).length > 0) {
|
| + let r = {};
|
| + for (let name of $getOwnPropertyNames(this.named)) {
|
| + r[name] = replace(this.named[name]);
|
| + }
|
| + this.named = r;
|
| + }
|
| + }
|
| + }
|
| +''');
|
| +
|
| +final Typedef = JS('', '''
|
| + class Typedef extends $AbstractFunctionType {
|
| + constructor(name, closure) {
|
| + super();
|
| + this._name = name;
|
| + this._closure = closure;
|
| + this._functionType = null;
|
| + }
|
| +
|
| + get definite() {
|
| + return this._functionType.definite;
|
| + }
|
| +
|
| + get name() {
|
| + return this._name;
|
| + }
|
| +
|
| + get functionType() {
|
| + if (!this._functionType) {
|
| + this._functionType = this._closure();
|
| + }
|
| + return this._functionType;
|
| + }
|
| +
|
| + get returnType() {
|
| + return this.functionType.returnType;
|
| + }
|
| +
|
| + get args() {
|
| + return this.functionType.args;
|
| + }
|
| +
|
| + get optionals() {
|
| + return this.functionType.optionals;
|
| + }
|
| +
|
| + get named() {
|
| + return this.functionType.named;
|
| + }
|
| +
|
| + get metadata() {
|
| + return this.functionType.metadata;
|
| + }
|
| + }
|
| +''');
|
| +
|
| +_functionType(definite, returnType, args, extra) => JS('', '''(() => {
|
| + // TODO(vsm): Cache / memomize?
|
| + let optionals;
|
| + let named;
|
| + if ($extra === void 0) {
|
| + optionals = [];
|
| + named = {};
|
| + } else if ($extra instanceof Array) {
|
| + optionals = $extra;
|
| + named = {};
|
| + } else {
|
| + optionals = [];
|
| + named = $extra;
|
| + }
|
| + return new $FunctionType($definite, $returnType, $args, optionals, named);
|
| +})()''');
|
| +
|
| +///
|
| +/// Create a "fuzzy" function type. If any arguments are dynamic
|
| +/// they will be replaced with bottom.
|
| +///
|
| +functionType(returnType, args, extra) => JS('', '''(() => {
|
| + return _functionType(false, $returnType, $args, $extra);
|
| +})()''');
|
| +
|
| +///
|
| +/// Create a definite function type. No substitution of dynamic for
|
| +/// bottom occurs.
|
| +///
|
| +definiteFunctionType(returnType, args, extra) => JS('', '''(() => {
|
| + return _functionType(true, $returnType, $args, $extra);
|
| +})()''');
|
| +
|
| +typedef(name, closure) => JS('', '''(() => {
|
| + return new $Typedef($name, $closure);
|
| +})()''');
|
| +
|
| +isDartType(type) => JS('', '''(() => {
|
| + return $read($type) === $Type;
|
| +})()''');
|
| +
|
| +typeName(type) => JS('', '''(() => {
|
| + // Non-instance types
|
| + if ($type instanceof $TypeRep) return $type.toString();
|
| + // Instance types
|
| + let tag = $read($type);
|
| + if (tag === $Type) {
|
| + let name = $type.name;
|
| + let args = $getGenericArgs($type);
|
| + if (args) {
|
| + name += '<';
|
| + for (let i = 0; i < args.length; ++i) {
|
| + if (i > 0) name += ', ';
|
| + name += $typeName(args[i]);
|
| + }
|
| + name += '>';
|
| + }
|
| + return name;
|
| + }
|
| + if (tag) return "Not a type: " + tag.name;
|
| + return "JSObject<" + $type.name + ">";
|
| +})()''');
|
| +
|
| +isFunctionType(type) => JS('', '''(() => {
|
| + return $type instanceof $AbstractFunctionType || $type == $Function;
|
| +})()''');
|
| +
|
| +isFunctionSubType(ft1, ft2) => JS('', '''(() => {
|
| + if ($ft2 == $Function) {
|
| + return true;
|
| + }
|
| +
|
| + let ret1 = $ft1.returnType;
|
| + let ret2 = $ft2.returnType;
|
| +
|
| + if (!$isSubtype_(ret1, ret2)) {
|
| + // Covariant return types
|
| + // Note, void (which can only appear as a return type) is effectively
|
| + // treated as dynamic. If the base return type is void, we allow any
|
| + // subtype return type.
|
| + // E.g., we allow:
|
| + // () -> int <: () -> void
|
| + if (ret2 != $voidR) {
|
| + return false;
|
| + }
|
| + }
|
| +
|
| + let args1 = $ft1.args;
|
| + let args2 = $ft2.args;
|
| +
|
| + if (args1.length > args2.length) {
|
| + return false;
|
| + }
|
| +
|
| + for (let i = 0; i < args1.length; ++i) {
|
| + if (!$isSubtype_(args2[i], args1[i])) {
|
| + return false;
|
| + }
|
| + }
|
| +
|
| + let optionals1 = $ft1.optionals;
|
| + let optionals2 = $ft2.optionals;
|
| +
|
| + if (args1.length + optionals1.length < args2.length + optionals2.length) {
|
| + return false;
|
| + }
|
| +
|
| + let j = 0;
|
| + for (let i = args1.length; i < args2.length; ++i, ++j) {
|
| + if (!$isSubtype_(args2[i], optionals1[j])) {
|
| + return false;
|
| + }
|
| + }
|
| +
|
| + for (let i = 0; i < optionals2.length; ++i, ++j) {
|
| + if (!$isSubtype_(optionals2[i], optionals1[j])) {
|
| + return false;
|
| + }
|
| + }
|
| +
|
| + let named1 = $ft1.named;
|
| + let named2 = $ft2.named;
|
| +
|
| + let names = $getOwnPropertyNames(named2);
|
| + for (let i = 0; i < names.length; ++i) {
|
| + let name = names[i];
|
| + let n1 = named1[name];
|
| + let n2 = named2[name];
|
| + if (n1 === void 0) {
|
| + return false;
|
| + }
|
| + if (!$isSubtype_(n2, n1)) {
|
| + return false;
|
| + }
|
| + }
|
| +
|
| + return true;
|
| +})()''');
|
| +
|
| +///
|
| +/// Computes the canonical type.
|
| +/// This maps JS types onto their corresponding Dart Type.
|
| +///
|
| +// TODO(jmesserly): lots more needs to be done here.
|
| +canonicalType(t) => JS('', '''(() => {
|
| + if ($t === Object) return $Object;
|
| + if ($t === Function) return $Function;
|
| + if ($t === Array) return $List;
|
| +
|
| + // We shouldn't normally get here with these types, unless something strange
|
| + // happens like subclassing Number in JS and passing it to Dart.
|
| + if ($t === String) return $String;
|
| + if ($t === Number) return $double;
|
| + if ($t === Boolean) return $bool;
|
| + return $t;
|
| +})()''');
|
| +
|
| +final subtypeMap = JS('', 'new Map()');
|
| +isSubtype(t1, t2) => JS('', '''(() => {
|
| + // See if we already know the answer
|
| + // TODO(jmesserly): general purpose memoize function?
|
| + let map = $subtypeMap.get($t1);
|
| + let result;
|
| + if (map) {
|
| + result = map.get($t2);
|
| + if (result !== void 0) return result;
|
| + } else {
|
| + $subtypeMap.set($t1, map = new Map());
|
| + }
|
| + result = $isSubtype_($t1, $t2);
|
| + map.set($t2, result);
|
| + return result;
|
| +})()''');
|
| +
|
| +_isBottom(type) => JS('', '''(() => {
|
| + return $type == $bottom;
|
| +})()''');
|
| +
|
| +_isTop(type) => JS('', '''(() => {
|
| + return $type == $Object || ($type == $dynamicR);
|
| +})()''');
|
| +
|
| +isSubtype_(t1, t2) => JS('', '''(() => {
|
| + $t1 = $canonicalType($t1);
|
| + $t2 = $canonicalType($t2);
|
| + if ($t1 == $t2) return true;
|
| +
|
| + // Trivially true.
|
| + if ($_isTop($t2) || $_isBottom($t1)) {
|
| + return true;
|
| + }
|
| +
|
| + // Trivially false.
|
| + if ($_isTop($t1) || $_isBottom($t2)) {
|
| + return false;
|
| + }
|
| +
|
| + // "Traditional" name-based subtype check.
|
| + if ($isClassSubType($t1, $t2)) {
|
| + return true;
|
| + }
|
| +
|
| + // Function subtyping.
|
| + // TODO(vsm): Handle Objects with call methods. Those are functions
|
| + // even if they do not *nominally* subtype core.Function.
|
| + if ($isFunctionType($t1) &&
|
| + $isFunctionType($t2)) {
|
| + return $isFunctionSubType($t1, $t2);
|
| + }
|
| + return false;
|
| +})()''');
|
| +
|
| +isClassSubType(t1, t2) => JS('', '''(() => {
|
| + // We support Dart's covariant generics with the caveat that we do not
|
| + // substitute bottom for dynamic in subtyping rules.
|
| + // I.e., given T1, ..., Tn where at least one Ti != dynamic we disallow:
|
| + // - S !<: S<T1, ..., Tn>
|
| + // - S<dynamic, ..., dynamic> !<: S<T1, ..., Tn>
|
| + $t1 = $canonicalType($t1);
|
| + $assert_($t2 == $canonicalType($t2));
|
| + if ($t1 == $t2) return true;
|
| +
|
| + if ($t1 == $Object) return false;
|
| +
|
| + // If t1 is a JS Object, we may not hit core.Object.
|
| + if ($t1 == null) return $t2 == $Object || $t2 == $dynamicR;
|
| +
|
| + // Check if t1 and t2 have the same raw type. If so, check covariance on
|
| + // type parameters.
|
| + let raw1 = $getGenericClass($t1);
|
| + let raw2 = $getGenericClass($t2);
|
| + if (raw1 != null && raw1 == raw2) {
|
| + let typeArguments1 = $getGenericArgs($t1);
|
| + let typeArguments2 = $getGenericArgs($t2);
|
| + let length = typeArguments1.length;
|
| + if (typeArguments2.length == 0) {
|
| + // t2 is the raw form of t1
|
| + return true;
|
| + } else if (length == 0) {
|
| + // t1 is raw, but t2 is not
|
| + return false;
|
| + }
|
| + $assert_(length == typeArguments2.length);
|
| + for (let i = 0; i < length; ++i) {
|
| + if (!$isSubtype(typeArguments1[i], typeArguments2[i])) {
|
| + return false;
|
| + }
|
| + }
|
| + return true;
|
| + }
|
| +
|
| + // Check superclass.
|
| + if ($isClassSubType($t1.__proto__, $t2)) return true;
|
| +
|
| + // Check mixins.
|
| + let mixins = $getMixins($t1);
|
| + if (mixins) {
|
| + for (let m1 of mixins) {
|
| + // TODO(jmesserly): remove the != null check once we can load core libs.
|
| + if (m1 != null && $isClassSubType(m1, $t2)) return true;
|
| + }
|
| + }
|
| +
|
| + // Check interfaces.
|
| + let getInterfaces = $getImplements($t1);
|
| + if (getInterfaces) {
|
| + for (let i1 of getInterfaces()) {
|
| + // TODO(jmesserly): remove the != null check once we can load core libs.
|
| + if (i1 != null && $isClassSubType(i1, $t2)) return true;
|
| + }
|
| + }
|
| +
|
| + return false;
|
| +})()''');
|
| +
|
| +// TODO(jmesserly): this isn't currently used, but it could be if we want
|
| +// `obj is NonGroundType<T,S>` to be rejected at runtime instead of compile
|
| +// time.
|
| +isGroundType(type) => JS('', '''(() => {
|
| + // TODO(vsm): Cache this if we start using it at runtime.
|
| +
|
| + if ($type instanceof $AbstractFunctionType) {
|
| + if (!$_isTop($type.returnType)) return false;
|
| + for (let i = 0; i < $type.args.length; ++i) {
|
| + if (!$_isBottom($type.args[i])) return false;
|
| + }
|
| + for (let i = 0; i < $type.optionals.length; ++i) {
|
| + if (!$_isBottom($type.optionals[i])) return false;
|
| + }
|
| + let names = $getOwnPropertyNames($type.named);
|
| + for (let i = 0; i < names.length; ++i) {
|
| + if (!$_isBottom($type.named[names[i]])) return false;
|
| + }
|
| + return true;
|
| + }
|
| +
|
| + let typeArgs = $getGenericArgs($type);
|
| + if (!typeArgs) return true;
|
| + for (let t of typeArgs) {
|
| + if (t != $Object && t != $dynamicR) return false;
|
| + }
|
| + return true;
|
| +})()''');
|
|
|