Converting Polymer's WebComponentsLoaded to an onReady future

pkg/polymer/lib/src/instance.dart

 // Copyright (c) 2013, 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.
 
 part of polymer;
 
 /**
  * Use this annotation to publish a field as an attribute. For example:
  *
  *     class MyPlaybackElement extends PolymerElement {
@@ skipping 51 matching lines @@
     _typesByName[name] = type;
     // notify the registrar waiting for 'name', if any
     _notifyType(name);
   }
 
   /// The one syntax to rule them all.
   static final BindingDelegate _polymerSyntax = new PolymerExpressions();
 
   static int _preparingElements = 0;
 
+  static final Completer _ready = new Completer();
+  /// Future indicating that the Polymer library has been loaded and is ready

[Siggi Cherem (dart-lang), 2013/10/15 17:33:00]

nit:
 - add empty line above comment
 - /// vs /** */ debate - I'm ok to leave it how it is (I'd like to switch to
/// everywhere), but so far I think most of this package has been using /** */,
so for consistency I lean towards that.

[blois, 2013/10/15 17:36:38]

Done.

+  /// for use.
+  static Future get onReady => _ready.future;
+
   PolymerDeclaration _declaration;
 
   /** The most derived `<polymer-element>` declaration for this element. */
   PolymerDeclaration get declaration => _declaration;
 
   Map<String, StreamSubscription> _elementObservers;
   bool _unbound; // lazy-initialized
   Job _unbindAllJob;
 
   bool get _elementPrepared => _declaration != null;
@@ skipping 848 matching lines @@
 /**
  * Base class for PolymerElements deriving from HtmlElement.
  *
  * See [Polymer].
  */
 class PolymerElement extends HtmlElement with Polymer, ObservableMixin {
   PolymerElement.created() : super.created() {
     polymerCreated();
   }
 }