Provide option to suppress mirrors metadata

lib/src/compiler/compiler.dart

 // Copyright (c) 2016, 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:collection' show HashSet;
 import 'package:args/args.dart' show ArgParser, ArgResults;
 import 'package:analyzer/analyzer.dart'
     show
         AnalysisError,
         CompilationUnit,
@@ skipping 132 matching lines @@
 
   /// If [sourceMap] is emitted, this will emit a `sourceMappingUrl` comment
   /// into the output JavaScript module.
   final bool sourceMapComment;
 
   /// Whether to emit a summary file containing API signatures.
   ///
   /// This is required for a modular build process.
   final bool summarizeApi;
 
+  /// Whether to preserve metdata only accessible via mirrors
+  final bool preserveAnnotations;
+
   /// Whether to force compilation of code with static errors.
   final bool unsafeForceCompile;
 
   /// Whether to emit Closure Compiler-friendly code.
   final bool closure;
 
   /// Enable ES6 destructuring of named parameters. Off by default.
   ///
   /// Older V8 versions do not accept default values with destructuring in
   /// arrow functions yet (e.g. `({a} = {}) => 1`) but happily accepts them
@@ skipping 11 matching lines @@
 
   /// Which module format to support.
   /// Currently 'es6' and 'legacy' are supported.
   final ModuleFormat moduleFormat;
 
   const CompilerOptions(
       {this.sourceMap: true,
       this.sourceMapComment: true,
       this.summarizeApi: true,
       this.unsafeForceCompile: false,
+      this.preserveAnnotations: false,
       this.closure: false,
       this.destructureNamedParams: false,
       this.moduleFormat: ModuleFormat.legacy});
 
   CompilerOptions.fromArguments(ArgResults args)
       : sourceMap = args['source-map'],
         sourceMapComment = args['source-map-comment'],
         summarizeApi = args['summarize'],
         unsafeForceCompile = args['unsafe-force-compile'],
+        preserveAnnotations = args['preserve-annotations'],
         closure = args['closure-experimental'],
         destructureNamedParams = args['destructure-named-params'],
         moduleFormat = parseModuleFormat(args['modules']);
 
   static ArgParser addArguments(ArgParser parser) => parser
     ..addFlag('summarize', help: 'emit an API summary file', defaultsTo: true)
     ..addFlag('source-map', help: 'emit source mapping', defaultsTo: true)
     ..addFlag('source-map-comment',
         help: 'adds a sourceMappingURL comment to the end of the JS,\n'
             'disable if using X-SourceMap header',
         defaultsTo: true)
     ..addOption('modules',
         help: 'module pattern to emit',
         allowed: ['es6', 'legacy', 'node'],
         allowedHelp: {
           'es6': 'es6 modules',
           'legacy': 'a custom format used by dartdevc, similar to AMD',
           'node': 'node.js modules (https://nodejs.org/api/modules.html)'
         },
         defaultsTo: 'legacy')
+    ..addFlag('preserve-annotations',

[Jennifer Messerly, 2016/05/17 21:39:42]

maybe "emit-metadata" -- slightly shorter?

we also seem to call it "metadata" in some of our docs:
https://www.dartlang.org/docs/dart-up-and-running/ch02.html#summary

(maybe it was to disambiguate "type annotations")

+        help: 'emit metadata annotations queriable via mirrors',
+        defaultsTo: false)
     ..addFlag('closure-experimental',
         help: 'emit Closure Compiler-friendly code (experimental)',
         defaultsTo: false)
     ..addFlag('destructure-named-params',
         help: 'Destructure named parameters', defaultsTo: false)
     ..addFlag('unsafe-force-compile',
         help: 'Compile code even if it has errors. ಠ_ಠ\n'
             'This has undefined behavior!',
         defaultsTo: false);
 }
@@ skipping 77 matching lines @@
   }
 }
 
 /// (Public for tests) the error code used when a part is missing.
 final missingPartErrorCode = const CompileTimeErrorCode(
     'MISSING_PART', 'The part was not supplied as an input to the compiler.');
 
 /// (Public for tests) the error code used when a part is unused.
 final unusedPartWarningCode = const StaticWarningCode(
     'UNUSED_PART', 'The part was not used by any libraries being compiled.');