Support DDC debugging tools.

lib/src/dartdevc/dartdevc.dart

 // Copyright (c) 2017, 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.
 
 import 'dart:async';
 import 'dart:io';
+import 'dart:convert' show JsonEncoder;
 
 import 'package:analyzer/analyzer.dart';
 import 'package:barback/barback.dart';
 import 'package:bazel_worker/bazel_worker.dart';
 import 'package:cli_util/cli_util.dart' as cli_util;
 import 'package:path/path.dart' as p;
 
 import '../dart.dart';
 import '../io.dart';
+import 'module.dart';
 import 'module_reader.dart';
 import 'scratch_space.dart';
 import 'summaries.dart';
 import 'workers.dart';
 
+// JavaScript snippet to determine the directory a script was run from.
+final _currentDirectoryScript = r'''
+var _currentDirectory = (function () {
+  var _url;
+  var lines = new Error().stack.split('\n');
+  function lookupUrl() {
+    if (lines.length > 2) {
+      var match = lines[1].match(/^\s+at (.+):\d+:\d+$/);
+      // Chrome.
+      if (match) return match[1];
+      // Chrome nested eval case.
+      match = lines[1].match(/^\s+at eval [(](.+):\d+:\d+[)]$/);
+      if (match) return match[1];
+      // Edge.
+      match = lines[1].match(/^\s+at.+\((.+):\d+:\d+\)$/);
+      if (match) return match[1];
+      // Firefox.
+      return lines[0].match(/[<][@](.+):\d+:\d+$/)[1];
+    }
+    // Safari.
+    return lines[0].match(/(.+):\d+:\d+$/)[1];
+  }
+  _url = lookupUrl();
+  var lastSlash = _url.lastIndexOf('/');
+  if (lastSlash == -1) return _url;
+  var currentDirectory = _url.substring(0, lastSlash + 1);
+  return currentDirectory;
+})();
+''';
+
 /// Returns whether or not [dartId] is an app entrypoint (basically, whether or
 /// not it has a `main` function).
 Future<bool> isAppEntryPoint(
     AssetId dartId, Future<Asset> getAsset(AssetId id)) async {
   assert(dartId.extension == '.dart');
   var dartAsset = await getAsset(dartId);
   // Skip reporting errors here, dartdevc will report them later with nicer
   // formatting.
   var parsed = parseCompilationUnit(await dartAsset.readAsString(),
       suppressErrors: true);
@@ skipping 22 matching lines @@
     ModuleReader moduleReader,
     Future<Asset> getAsset(AssetId id)) {
   var bootstrapId = dartEntrypointId.addExtension('.bootstrap.js');
   var jsEntrypointId = dartEntrypointId.addExtension('.js');
   var jsMapEntrypointId = jsEntrypointId.addExtension('.map');
 
   var outputCompleters = <AssetId, Completer<Asset>>{
     bootstrapId: new Completer(),
     jsEntrypointId: new Completer(),
   };
-  if (mode == BarbackMode.DEBUG) {
+  var debugMode = mode == BarbackMode.DEBUG;
+
+  if (debugMode) {
     outputCompleters[jsMapEntrypointId] = new Completer<Asset>();
   }
 
   return _ensureComplete(outputCompleters, () async {
     var module = await moduleReader.moduleFor(dartEntrypointId);
     if (module == null) return;
 
     // The path to the entrypoint JS module as it should appear in the call to
     // `require` in the bootstrap file.
     var moduleDir = topLevelDir(dartEntrypointId.path);
     var appModulePath = p.url.relative(p.url.join(moduleDir, module.id.name),
         from: p.url.dirname(dartEntrypointId.path));
 
     // The name of the entrypoint dart library within the entrypoint JS module.
     //
     // This is used to invoke `main()` from within the bootstrap script.
     //
     // TODO(jakemac53): Sane module name creation, this only works in the most
     // basic of cases.
     //
     // See https://github.com/dart-lang/sdk/issues/27262 for the root issue
     // which will allow us to not rely on the naming schemes that dartdevc uses
     // internally, but instead specify our own.
     var appModuleScope = p.url
         .split(p.url.withoutExtension(
             p.url.relative(dartEntrypointId.path, from: moduleDir)))
         .join("__")
         .replaceAll('.', '\$46');
 
-    // Modules not under a `packages` directory need custom module paths.
-    var customModulePaths = <String>[];
+    // Map from module name to module path.
+    // Modules outside of the `packages` directory have different module path
+    // and module names.
+    var modulePaths = new Map<String, String>();
+    modulePaths[appModulePath] = appModulePath;
+    modulePaths['dart_sdk'] = 'dart_sdk';
+
     var transitiveDeps = await moduleReader.readTransitiveDeps(module);
     for (var dep in transitiveDeps) {
       if (dep.dir != 'lib') {
         var relativePath = p.url.relative(p.url.join(moduleDir, dep.name),
             from: p.url.dirname(bootstrapId.path));
-        customModulePaths.add('"${dep.dir}/${dep.name}": "$relativePath"');
+        var jsModuleName = '${dep.dir}/${dep.name}';
+
+        modulePaths[jsModuleName] = relativePath;
       } else {
         var jsModuleName = 'packages/${dep.package}/${dep.name}';
         var actualModulePath = p.url.relative(
             p.url.join(moduleDir, jsModuleName),
             from: p.url.dirname(bootstrapId.path));
-        if (jsModuleName != actualModulePath) {
-          customModulePaths.add('"$jsModuleName": "$actualModulePath"');
-        }
+        modulePaths[jsModuleName] = actualModulePath;
       }
     }
+    var bootstrapContent = new StringBuffer('(function() {\n');
+    if (debugMode) {
+      bootstrapContent.write('''
+$_currentDirectoryScript
+let modulePaths = ${const JsonEncoder.withIndent(" ").convert(modulePaths)};
 
-    var bootstrapContent = '''
+if(!window.\$dartLoader) {
+   window.\$dartLoader = {
+     moduleIdToUrl: new Map(),
+     urlToModuleId: new Map(),
+     rootDirectories: new Set(),
+   };
+}
+
+let customModulePaths = {};
+window.\$dartLoader.rootDirectories.add(_currentDirectory);
+for (let moduleName of Object.getOwnPropertyNames(modulePaths)) {
+  let modulePath = modulePaths[moduleName];
+  if (modulePath != moduleName) {
+    customModulePaths[moduleName] = modulePath;
+  }
+  var src = _currentDirectory + modulePath + '.js';
+  if (window.\$dartLoader.moduleIdToUrl.has(moduleName)) {
+    continue;
+  }
+  \$dartLoader.moduleIdToUrl.set(moduleName, src);
+  \$dartLoader.urlToModuleId.set(src, moduleName);
+}
+''');
+    } else {
+      var customModulePaths = new Map<String, String>();
+      modulePaths.forEach((name, path) {
+        if (name != path) customModulePaths[name] = path;
+      });
+      var json = const JsonEncoder.withIndent(" ").convert(customModulePaths);
+      bootstrapContent.write('let customModulePaths = ${json};\n');
+    }
+
+    bootstrapContent.write('''
 require.config({
     waitSeconds: 30,
-    paths: {
-      ${customModulePaths.join(',\n      ')}
-    }
+    paths: customModulePaths
 });
 
 require(["$appModulePath", "dart_sdk"], function(app, dart_sdk) {
   dart_sdk._isolate_helper.startRootIsolate(() => {}, []);
+''');
+
+    if (debugMode) {
+      bootstrapContent.write('''
+  dart_sdk._debugger.registerDevtoolsFormatter();
+
+  if (window.\$dartStackTraceUtility && !window.\$dartStackTraceUtility.ready) {
+    window.\$dartStackTraceUtility.ready = true;
+    let dart = dart_sdk.dart;
+    window.\$dartStackTraceUtility.setSourceMapProvider(
+      function(url) {
+        var module = window.\$dartLoader.urlToModuleId.get(url);
+        if (!module) return null;
+        return dart.getSourceMap(module);
+      });
+  }
+  window.postMessage({ type: "DDC_STATE_CHANGE", state: "start" }, "*");
+''');
+    }
+
+    bootstrapContent.write('''
   app.$appModuleScope.main();
 });
-''';
-    outputCompleters[bootstrapId]
-        .complete(new Asset.fromString(bootstrapId, bootstrapContent));
+})();
+''');
+    outputCompleters[bootstrapId].complete(
+        new Asset.fromString(bootstrapId, bootstrapContent.toString()));
 
     var bootstrapModuleName = p.withoutExtension(
         p.relative(bootstrapId.path, from: p.dirname(dartEntrypointId.path)));
-    var entrypointJsContent = '''
-var el = document.createElement("script");
+    var entrypointJsContent = new StringBuffer('''
+var el;
+''');
+    if (debugMode) {
+      entrypointJsContent.write('''
+el = document.createElement("script");
+el.defer = true;
+el.async = false;
+el.src = "dart_stack_trace_mapper.js";
+document.head.appendChild(el);
+''');
+    }
+
+    entrypointJsContent.write('''
+el = document.createElement("script");
 el.defer = true;
 el.async = false;
 el.src = "require.js";
 el.setAttribute("data-main", "$bootstrapModuleName");
 document.head.appendChild(el);
-''';
-    outputCompleters[jsEntrypointId]
-        .complete(new Asset.fromString(jsEntrypointId, entrypointJsContent));
+''');
+    outputCompleters[jsEntrypointId].complete(
+        new Asset.fromString(jsEntrypointId, entrypointJsContent.toString()));
 
-    if (mode == BarbackMode.DEBUG) {
+    if (debugMode) {
       outputCompleters[jsMapEntrypointId].complete(new Asset.fromString(
           jsMapEntrypointId,
           '{"version":3,"sourceRoot":"","sources":[],"names":[],"mappings":"",'
           '"file":""}'));
     }
   });
 }
 
 /// Compiles [module] using the `dartdevc` binary from the SDK to a relative
 /// path under the package that looks like `$outputDir/${module.id.name}.js`.
@@ skipping 36 matching lines @@
       '--modules=amd',
       '--dart-sdk=${sdkDir.path}',
       '--module-root=${scratchSpace.tempDir.path}',
       '--library-root=${p.dirname(jsOutputFile.path)}',
       '--summary-extension=${linkedSummaryExtension.substring(1)}',
       '--no-summarize',
       '-o',
       jsOutputFile.path,
     ]);
 
     if (mode == BarbackMode.RELEASE) {

[jakemac, 2017/05/19 16:35:59]

nit: maybe just use the `debugMode` bool you already have?

[Jacob, 2017/05/19 16:54:25]

That debugMode var was in a different method. Switched this case to also check
for == DEBUG first as that is a little more consistent.

This is a different function. Added another
debugMode bool to this method and used it in this method.

       request.arguments.add('--no-source-map');
+    } else {
+      request.arguments.addAll([
+        '--source-map',
+        '--source-map-comment',
+        '--inline-source-map',
+      ]);
     }
 
     // Add environment constants.
     environmentConstants.forEach((key, value) {
       request.arguments.add('-D$key=$value');
     });
 
     // Add all the linked summaries as summary inputs.
     for (var id in linkedSummaryIds) {
       request.arguments.addAll(['-s', scratchSpace.fileFor(id).path]);
@@ skipping 87 matching lines @@
     } finally {
       for (var id in completers.keys) {
         if (!completers[id].isCompleted) {
           completers[id].completeError(new AssetNotFoundException(id));
         }
       }
     }
   }();
   return futures;
 }