Add source map support

Fix #18

Author: mgol

.eslintrc

@@ -9,17 +9,20 @@
         // Possible errors
         "no-comma-dangle": 0,
         "no-console": 0,
-        "no-extra-parens": 2,
 
         // Best practices
         "block-scoped-var": 2,
+        "complexity": [2, 10],
         "eqeqeq": [2, "smart"],
         "no-else-return": 2,
         "no-floating-decimal": 2,
+        "no-redeclare": 0, // TODO remove the disabling once let/const scope is calculated correctly
+        "no-self-compare": 2,
         "wrap-iife": [2, "inside"],
 
         // Variables
         "no-use-before-define": 0,
+        "no-shadow": 0,
 
         // Node.js
         "no-mixed-requires": 0,
@@ -33,7 +36,6 @@
         "space-after-keywords": 2,
         "space-in-brackets": [2, "never"],
         "space-infix-ops": 2,
-        "one-var": 2,
         "quotes": [2, "single"],
 
         // Legacy

Gruntfile.js

@@ -81,7 +81,7 @@ module.exports = function (grunt) {
             regexp: {
                 options: {
                     add: true,
-                    remove: true,
+                    remove: false,
                     regexp: /^matchedMod$/,
                 },
                 files: {
@@ -99,13 +99,33 @@ module.exports = function (grunt) {
             singleQuotes: {
                 options: {
                     add: true,
-                    remove: true,
+                    remove: false,
                     singleQuotes: true,
                 },
                 files: {
                     'test/tmp/not-annotated-singlequotes.js': ['test/fixtures/not-annotated.js'],
                 },
             },
+            sourceMap: {
+                options: {
+                    add: true,
+                    remove: false,
+                    sourceMap: true,
+                },
+                files: {
+                    'test/tmp/not-annotated-source-map.js': ['test/fixtures/not-annotated.js'],
+                },
+            },
+            sourceMapNotInline: {
+                options: {
+                    add: true,
+                    remove: false,
+                    sourceMap: 'test/tmp/not-annotated-source-map-external.js.map',
+                },
+                files: {
+                    'test/tmp/not-annotated-source-map-external.js': ['test/fixtures/not-annotated.js'],
+                },
+            },
             ngAnnotateOptions: {
                 options: {
                     singleQuotes: true,

README.md

@@ -20,10 +20,9 @@ Once the plugin has been installed, it may be enabled inside your Gruntfile with
 grunt.loadNpmTasks('grunt-ng-annotate');
 ```
 
-## The "ngAnnotate" task
+## Overview
 
-### Overview
-In your project's Gruntfile, add a section named `ngAnnotate` to the data object passed into `grunt.initConfig()`.
+This project defines the `ngAnnotate` task. In your project's Gruntfile, add a section named `ngAnnotate` to the data object passed into `grunt.initConfig()`.
 
 ```js
 grunt.initConfig({
@@ -38,19 +37,19 @@ grunt.initConfig({
 })
 ```
 
-### Options
+## Options
 
 The `ngAnnotate` task accepts a couple of options:
 
-#### add
+### add
 
 Tells if ngAnnotate should add annotations.
 
 Type: `boolean`
 
 Default: `true`
 
-#### remove
+### remove
 
 Tells if ngAnnotate should remove annotations.
 
@@ -61,23 +60,33 @@ Default: `false`
 Note that both `add` and `remove` options can be set to true; in such a case `ngAnnotate` first removes
 annotations and then re-adds them (it can be used to check if annotations were provided correctly).
 
-#### regexp
+### regexp
 
 If provided, only strings matched by the regexp are interpreted as module names. You can provide both a regular expression and a string representing one. See README of ng-annotate for further details: https://npmjs.org/package/ng-annotate
 
 Type: `regexp`
 
 Default: none
 
-#### singleQuotes
+### singleQuotes
 
 Switches the quote type for strings in the annotations array to single ones; e.g. `'$scope'` instead of `"$scope"`.
 
 Type: `boolean`
 
 Default: `false`
 
-#### ngAnnotateOptions
+### sourceMap
+
+Enables source map generation.
+
+Type: `boolean` or `string`
+
+Default: `false`
+
+If set to a string, the string points to a file where to save the source map. If set to `true`, an inline source map will be used.
+
+### ngAnnotateOptions
 
 If ngAnnotate supports a new option that is not directly supported via this Grunt task yet, you can pass it here. These options gets merged with the above specific to ngAnnotate. Options passed here have lower precedence to the direct ones described above.
 
@@ -86,7 +95,7 @@ Type: `object`
 Default: `{}`
 
 
-### Usage Examples
+## Usage Examples
 
 ```js
 grunt.initConfig({

package.json

@@ -43,6 +43,7 @@
     "grunt-mocha-test": "0.12.7",
     "jscs-trailing-comma": "0.3.0",
     "load-grunt-tasks": "2.0.0",
+    "lodash": "2.4.1",
     "mocha": "2.1.0",
     "time-grunt": "1.0.0"
   },