| Index: pkg/polymer/lib/boot.dart
|
| diff --git a/pkg/polymer/lib/boot.dart b/pkg/polymer/lib/boot.dart
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..652709d7e642e9e75b69657cb650d0866b8e62a7
|
| --- /dev/null
|
| +++ b/pkg/polymer/lib/boot.dart
|
| @@ -0,0 +1,170 @@
|
| +// Copyright (c) 2014, 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.
|
| +
|
| +/// Bootstrap to initialize polymer applications. This library is not in use
|
| +/// yet but it will replace boot.js in the near future (see dartbug.com/18007).
|
| +///
|
| +/// This script contains logic to bootstrap polymer apps during development. It
|
| +/// internally discovers special Dart script tags through HTML imports, and
|
| +/// constructs a new entrypoint for the application that is then launched in an
|
| +/// isolate.
|
| +///
|
| +/// For each script tag found, we will load the corresponding Dart library and
|
| +/// execute all methods annotated with `@initMethod` and register all classes
|
| +/// labeled with `@CustomTag`. We keep track of the order of imports and execute
|
| +/// initializers in the same order.
|
| +///
|
| +/// All polymer applications use this bootstrap logic. It is included
|
| +/// automatically when you include the polymer.html import:
|
| +///
|
| +/// <link rel="import" href="packages/polymer/polymer.html">
|
| +///
|
| +/// There are two important changes compared to previous versions of polymer
|
| +/// (0.10.0-pre.6 and older):
|
| +///
|
| +/// * Use 'application/dart;component=1' instead of 'application/dart':
|
| +/// Dartium already limits to have a single script tag per document, but it
|
| +/// will be changing semantics soon and make them even stricter. Multiple
|
| +/// script tags are not going to be running on the same isolate after this
|
| +/// change. For polymer applications we'll use a parameter on the script tags
|
| +/// mime-type to prevent Dartium from loading them separately. Instead this
|
| +/// bootstrap script combines those special script tags and creates the
|
| +/// application Dartium needs to run.
|
| +///
|
| +// If you had:
|
| +///
|
| +/// <polymer-element name="x-foo"> ...
|
| +/// <script type="application/dart" src="x_foo.dart'></script>
|
| +///
|
| +/// Now you need to write:
|
| +///
|
| +/// <polymer-element name="x-foo"> ...
|
| +/// <script type="application/dart;component=1" src="x_foo.dart'></script>
|
| +///
|
| +/// * `initPolymer` is gone: we used to initialize applications in two
|
| +/// possible ways: using init.dart or invoking initPolymer in your main. Any
|
| +/// of these initialization patterns can be replaced to use an `@initMethod`
|
| +/// instead. For example, If you need to run some initialization code before
|
| +/// any other code is executed, include a "application/dart;component=1"
|
| +/// script tag that contains an initializer method with the body of your old
|
| +/// main, and make sure this tag is placed above other html-imports that load
|
| +/// the rest of the application. Initialization methods are executed in the
|
| +/// order in which they are discovered in the HTML document.
|
| +library polymer.src.boot;
|
| +
|
| +import 'dart:html';
|
| +import 'dart:mirrors';
|
| +
|
| +main() {
|
| + var scripts = _discoverScripts(document, window.location.href);
|
| + var sb = new StringBuffer()..write('library bootstrap;\n\n');
|
| + int count = 0;
|
| + for (var s in scripts) {
|
| + sb.writeln("import '$s' as prefix_$count;");
|
| + count++;
|
| + }
|
| + sb.writeln("import 'package:polymer/src/mirror_loader.dart';");
|
| + sb.write('\nmain() => startPolymerInDevelopment([\n');
|
| + for (var s in scripts) {
|
| + sb.writeln(" '$s',");
|
| + }
|
| + sb.write(']);\n');
|
| + var isolateUri = _asDataUri(sb.toString());
|
| + spawnDomUri(Uri.parse(isolateUri), [], '');
|
| +}
|
| +
|
| +/// Internal state used in [_discoverScripts].
|
| +class _State {
|
| + /// Documents that we have visited thus far.
|
| + final Set<Document> seen = new Set();
|
| +
|
| + /// Scripts that have been discovered, in tree order.
|
| + final List<String> scripts = [];
|
| +
|
| + /// Whether we've seen a type="application/dart" script tag, since we expect
|
| + /// to have only one of those.
|
| + bool scriptSeen = false;
|
| +}
|
| +
|
| +/// Walks the HTML import structure to discover all script tags that are
|
| +/// implicitly loaded. This code is only used in Dartium and should only be
|
| +/// called after all HTML imports are resolved. Polymer ensures this by asking
|
| +/// users to put their Dart script tags after all HTML imports (this is checked
|
| +/// by the linter, and Dartium will otherwise show an error message).
|
| +List<String> _discoverScripts(Document doc, String baseUri, [_State state]) {
|
| + if (state == null) state = new _State();
|
| + if (doc == null) {
|
| + print('warning: $baseUri not found.');
|
| + return state.scripts;
|
| + }
|
| + if (!state.seen.add(doc)) return state.scripts;
|
| +
|
| + for (var node in doc.querySelectorAll('script,link[rel="import"]')) {
|
| + if (node is LinkElement) {
|
| + _discoverScripts(node.import, node.href, state);
|
| + } else if (node is ScriptElement) {
|
| + if (node.type == 'application/dart;component=1') {
|
| + if (node.src != '' ||
|
| + node.text != "export 'package:polymer/boot.dart';") {
|
| + state.scripts.add(_getScriptUrl(node));
|
| + }
|
| + }
|
| +
|
| + if (node.type == 'application/dart') {
|
| + if (state.scriptSeen) {
|
| + print('Dartium currently only allows a single Dart script tag '
|
| + 'per application, and in the future it will run them in '
|
| + 'separtate isolates. To prepare for this Dart script '
|
| + 'tags need to be updated to use the mime-type '
|
| + '"application/dart;component=1" instead of "application/dart":');
|
| + }
|
| + state.scriptSeen = true;
|
| + }
|
| + }
|
| + }
|
| + return state.scripts;
|
| +}
|
| +
|
| +// TODO(sigmund): explore other (cheaper) ways to resolve URIs relative to the
|
| +// root library (see dartbug.com/12612)
|
| +final _rootUri = currentMirrorSystem().isolate.rootLibrary.uri;
|
| +
|
| +/// Returns a URI that can be used to load the contents of [script] in a Dart
|
| +/// import. This is either the source URI if [script] has a `src` attribute, or
|
| +/// a base64 encoded `data:` URI if the [script] contents are inlined.
|
| +String _getScriptUrl(script) {
|
| + var uriString = script.src;
|
| + if (uriString != '') {
|
| + var uri = _rootUri.resolve(uriString);
|
| + if (!_isHttpStylePackageUrl(uri)) return '$uri';
|
| + // Use package: urls if available. This rule here is more permissive than
|
| + // how we translate urls in polymer-build, but we expect Dartium to limit
|
| + // the cases where there are differences. The polymer-build issues an error
|
| + // when using packages/ inside lib without properly stepping out all the way
|
| + // to the packages folder. If users don't create symlinks in the source
|
| + // tree, then Dartium will also complain because it won't find the file seen
|
| + // in an HTML import.
|
| + var packagePath = uri.path.substring(
|
| + uri.path.lastIndexOf('packages/') + 'packages/'.length);
|
| + return 'package:$packagePath';
|
| + }
|
| +
|
| + return _asDataUri(script.text);
|
| +}
|
| +
|
| +/// Whether [uri] is an http URI that contains a 'packages' segment, and
|
| +/// therefore could be converted into a 'package:' URI.
|
| +bool _isHttpStylePackageUrl(Uri uri) {
|
| + var uriPath = uri.path;
|
| + return uri.scheme == _rootUri.scheme &&
|
| + // Don't process cross-domain uris.
|
| + uri.authority == _rootUri.authority &&
|
| + uriPath.endsWith('.dart') &&
|
| + (uriPath.contains('/packages/') || uriPath.startsWith('packages/'));
|
| +}
|
| +
|
| +/// Returns a base64 `data:` uri with the contents of [s].
|
| +// TODO(sigmund): change back to application/dart: using text/javascript seems
|
| +// wrong but it hides a warning in Dartium (dartbug.com/18000).
|
| +_asDataUri(s) => 'data:text/javascript;base64,${window.btoa(s)}';
|
|
|