Support user generated custom native JS classes.

pkg/compiler/lib/src/patch_parser.dart

 // Copyright (c) 2012, 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 contains the infrastructure to parse and integrate patch files.
  *
  * Three types of elements can be patched: [LibraryElement], [ClassElement],
  * [FunctionElement]. Patches are introduced in patch libraries which are loaded
  * together with the corresponding origin library. Which libraries that are
@@ skipping 115 matching lines @@
 import 'diagnostics/messages.dart' show
     MessageKind;
 import 'elements/elements.dart';
 import 'elements/modelx.dart' show
     BaseFunctionElementX,
     ClassElementX,
     GetterElementX,
     LibraryElementX,
     MetadataAnnotationX,
     SetterElementX;
+import 'js_backend/js_backend.dart' show
+    JavaScriptBackend;
 import 'library_loader.dart' show
     LibraryLoader;
 import 'parser/listener.dart' show
     Listener,
     ParserError;
 import 'parser/element_listener.dart' show
     ElementListener;
 import 'parser/member_listener.dart' show
     MemberListener;
 import 'parser/partial_elements.dart' show
@@ skipping 151 matching lines @@
 }
 
 void patchElement(Compiler compiler,
                   Element origin,
                   Element patch) {
   if (origin == null) {
     compiler.reportError(
         patch, MessageKind.PATCH_NON_EXISTING, {'name': patch.name});
     return;
   }
+
   if (!(origin.isClass ||
         origin.isConstructor ||
         origin.isFunction ||
         origin.isAbstractField)) {
     // TODO(ahe): Remove this error when the parser rejects all bad modifiers.
     compiler.reportError(origin, MessageKind.PATCH_NONPATCHABLE);
     return;
   }
   if (patch.isClass) {
     tryPatchClass(compiler, origin, patch);
@@ skipping 35 matching lines @@
   checkNativeAnnotation(compiler, patch);
 }
 
 /// Check whether [cls] has a `@Native(...)` annotation, and if so, set its
 /// native name from the annotation.
 checkNativeAnnotation(Compiler compiler, ClassElement cls) {
   EagerAnnotationHandler.checkAnnotation(compiler, cls,
       const NativeAnnotationHandler());
 }
 
+checkJsInteropAnnotation(Compiler compiler, element) {
+  EagerAnnotationHandler.checkAnnotation(compiler, element,
+      const JsInteropAnnotationHandler());
+}
+
+
 /// Abstract interface for pre-resolution detection of metadata.
 ///
 /// The detection is handled in two steps:
 /// - match the annotation syntactically and assume that the annotation is valid
 ///   if it looks correct,
 /// - setup a deferred action to check that the annotation has a valid constant
 ///   value and report an internal error if not.
 abstract class EagerAnnotationHandler<T> {
   /// Checks that [annotation] looks like a matching annotation and optionally
   /// applies actions on [element]. Returns a non-null annotation marker if the
@@ skipping 15 matching lines @@
                          Element element,
                          EagerAnnotationHandler handler) {
     for (Link<MetadataAnnotation> link = element.metadata;
          !link.isEmpty;
          link = link.tail) {
       MetadataAnnotation annotation = link.head;
       var result = handler.apply(compiler, element, annotation);
       if (result != null) {
         // TODO(johnniwinther): Perform this check in
         // [Compiler.onLibrariesLoaded].
-        compiler.enqueuer.resolution.addDeferredAction(element, () {
+        // TODO(jacobr): annotation resolution needs to be refactored.
+        actionCallback() {
           annotation.ensureResolved(compiler);
           handler.validate(
               compiler, element, annotation,
               compiler.constants.getConstantValue(annotation.constant));
-        });
+        }
+        if (compiler.enqueuer.resolution.queueIsClosed) {
+          actionCallback();
+        } else {
+          compiler.enqueuer.resolution.addDeferredAction(element,
+              actionCallback);
+        }
         return result;
       }
     }
     return null;
   }
 }
 
 /// Annotation handler for pre-resolution detection of `@Native(...)`
 /// annotations.
 class NativeAnnotationHandler implements EagerAnnotationHandler<String> {
@@ skipping 29 matching lines @@
                 Element element,
                 MetadataAnnotation annotation,
                 ConstantValue constant) {
     if (constant.getType(compiler.coreTypes).element !=
             compiler.nativeAnnotationClass) {
       compiler.internalError(annotation, 'Invalid @Native(...) annotation.');
     }
   }
 }
 
+/// Annotation handler for pre-resolution detection of `@Js(...)`
+/// annotations.
+class JsInteropAnnotationHandler implements EagerAnnotationHandler<String> {
+  const JsInteropAnnotationHandler();
+
+  // TODO(jacobr): this method is pure technical debt.
+  String dietResolveStringToken(StringToken token) {
+    String value = token.value;
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        value.startsWith("'") && value.endsWith("'")) {
+      return value.substring(1, value.length - 1);
+    } else {
+      throw 'Invalid @Js(...) annotation. Unexpected name: $value';
+    }
+  }
+
+  String getJsNameAnnotation(MetadataAnnotation annotation) {
+    if (annotation.beginToken != null &&
+        annotation.beginToken.next.value == 'Js') {
+      // Skipping '@', 'Js', and '('.
+      Token argument = annotation.beginToken.next.next.next;
+      return (argument is StringToken) ? dietResolveStringToken(argument) : '';
+    }
+
+    return null;
+  }
+
+  String apply(Compiler compiler,
+             Element element,
+             MetadataAnnotation annotation) {
+    String jsName = getJsNameAnnotation(annotation);
+    if (jsName != null) {
+      element.setJsInterop(jsName);
+      element.declaration.setJsInterop(jsName);
+    }
+    return jsName;
+  }
+
+  @override
+  void validate(Compiler compiler,
+                Element element,
+                MetadataAnnotation annotation,
+                ConstantValue constant) {
+    JavaScriptBackend backend = compiler.backend;
+    if (constant.getType(compiler.coreTypes).element !=
+        backend.jsAnnotationClass) {
+      compiler.internalError(annotation, 'Invalid @Js(...) annotation.');
+    }
+  }
+}
+
 /// Annotation handler for pre-resolution detection of `@patch` annotations.
 class PatchAnnotationHandler implements EagerAnnotationHandler<PatchVersion> {
   const PatchAnnotationHandler();
 
   PatchVersion getPatchVersion(MetadataAnnotation annotation) {
     if (annotation.beginToken != null) {
       if (annotation.beginToken.next.value == 'patch') {
         return const PatchVersion(null);
       } else if (annotation.beginToken.next.value == 'patch_full') {
         return const PatchVersion('full');
@@ skipping 129 matching lines @@
 
 class PatchVersion {
   final String tag;
 
   const PatchVersion(this.tag);
 
   bool isActive(String patchTag) => tag == null || tag == patchTag;
 
   String toString() => 'PatchVersion($tag)';
 }