Generate dart2js and analyzer files for shared messages.

pkg/dart_messages/lib/shared_messages.dart

 // Copyright (c) 2015, 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.
 
 // An update to this file must be followed by regenerating the corresponding
-// json file. Use `json_converter.dart` in the bin directory.
+// json, dart2js and analyzer file. Use `publish.dart` in the bin directory.
 //
 // Every message in this file must have an id. Use `message_id.dart` in the
 // bin directory to generate a fresh one.
 
 // The messages in this file should meet the following guide lines:
 //
 // 1. The message should be a complete sentence starting with an uppercase
 // letter, and ending with a period.
 //
 // 2. Reserved words and embedded identifiers should be in single quotes, so
@@ skipping 34 matching lines @@
 // 10. Prefer to not use imperative tone. That is, the message should not sound
 // accusing or like it is ordering the user around. The computer should
 // describe the problem, not criticize for violating the specification.
 //
 // Other things to keep in mind:
 //
 // Generally, we want to provide messages that consists of three sentences:
 // 1. what is wrong, 2. why is it wrong, 3. how do I fix it. However, we
 // combine the first two in [template] and the last in [howToFix].
 
-final Map<String, Map> MESSAGES = {
+import 'dart:convert';
+
+/// Encodes the category of the message.
+///
+/// This is currently only used in the analyzer.
+// TODO(floitsch): encode severity and type in the category, so we can generate
+// the corresponding ErrorCode subclasses.
+class Category {
+  static final analysisOptionsError = new Category("AnalysisOptionsError");
+
+  static final analysisOptionsWarning = new Category("AnalysisOptionsWarning");
+
+  static final checkedModeCompileTimeError = new Category(
+      "CheckedModeCompileTimeError");
+
+  final String name;
+
+  Category(this.name);
+}
+
+
+class Message {
+  final String id;
+  final Category category;
+  final String template;
+  // The analyzer fills holes positionally (and not named). The following field
+  // overrides the order of the holes.
+  // For example the template "The argument #field in #cls is bad", could have
+  // the order `["cls", "field"]', which means that the analyzer would first
+  // provide the class `cls` and then only `field`.
+  // This list is generally `null`, but when it is provided it must contain all
+  // holes.
+  final List templateHoleOrder;
+  final String howToFix;
+  final List<String> options;
+  final List examples;
+
+  Message({this.id, this.category, this.template, this.templateHoleOrder,
+      this.howToFix, this.options, this.examples});
+}
+
+String get messagesAsJson {
+  var jsonified = {};
+  MESSAGES.forEach((String name, Message message) {
+    jsonified[name] =  {
+      'id': message.id,
+      'category': message.category.name,
+      'template': message.template,
+      'howToFix': message.howToFix
+    };
+  });
+  return JSON.encode(jsonified);
+}
+
+final Map<String, Message> MESSAGES = {
+  'exampleMessage': new Message(
+      id: 'use an Id generated by bin/message_id.dart',
+      category: Category.analysisOptionsError,
+      template: "#use #named #arguments",
+      templateHoleOrder: ["arguments", "named", "use"],
+      howToFix: "an explanation on how to fix things",
+      examples: [r'''
+      Some multiline example;
+      That generates the bug.''',
+      {
+      'fileA.dart': '''
+        or a map from file to content.
+        again multiline''',
+      'fileB.dart': '''
+        with possibly multiple files.
+        muliline too'''
+      }
+    ]
+  ),
 };