ember-cli 4.1.1 → 4.3.0-beta.1

package/docs/build/data.json

@@ -3,7 +3,7 @@
         "logo": "https://ember-cli.com/assets/images/ember-cli-logo-small-dark.png",
         "name": "ember-cli",
         "description": "Command line tool for developing ambitious ember.js apps",
-        "version": "4.1.1-release-1841d84da1"
+        "version": "4.3.0-beta.1-beta-7f49a34e21"
     },
     "files": {
         "lib/broccoli/default-packager.js": {
@@ -44,6 +44,20 @@
             "fors": {},
             "namespaces": {}
         },
+        "lib/debug/assert.js": {
+            "name": "lib/debug/assert.js",
+            "modules": {},
+            "classes": {},
+            "fors": {},
+            "namespaces": {}
+        },
+        "lib/debug/deprecate.js": {
+            "name": "lib/debug/deprecate.js",
+            "modules": {},
+            "classes": {},
+            "fors": {},
+            "namespaces": {}
+        },
         "lib/models/package-info-cache/index.js": {
             "name": "lib/models/package-info-cache/index.js",
             "modules": {},
@@ -402,7 +416,7 @@
             "extension_for": [],
             "module": "ember-cli",
             "file": "lib/broccoli/default-packager.js",
-            "line": 99,
+            "line": 100,
             "description": "Responsible for packaging Ember.js application.",
             "is_constructor": 1
         },
@@ -592,7 +606,7 @@
             "module": "ember-cli",
             "namespace": "Blueprint",
             "file": "lib/models/blueprint.js",
-            "line": 30,
+            "line": 32,
             "description": "A blueprint is a bundle of template files with optional install\nlogic.\n\nBlueprints follow a simple structure. Let's take the built-in\n`controller` blueprint as an example:\n\n```\nblueprints/controller\n├── files\n│   ├── app\n│   │   └── __path__\n│   │       └── __name__.js\n└── index.js\n\nblueprints/controller-test\n├── files\n│   └── tests\n│       └── unit\n│           └── controllers\n│               └── __test__.js\n└── index.js\n```\n\n## Files\n\n`files` contains templates for the all the files to be\ninstalled into the target directory.\n\nThe `__name__` token is subtituted with the dasherized\nentity name at install time. For example, when the user\ninvokes `ember generate controller foo` then `__name__` becomes\n`foo`. When the `--pod` flag is used, for example `ember\ngenerate controller foo --pod` then `__name__` becomes\n`controller`.\n\nThe `__path__` token is substituted with the blueprint\nname at install time. For example, when the user invokes\n`ember generate controller foo` then `__path__` becomes\n`controller`. When the `--pod` flag is used, for example\n`ember generate controller foo --pod` then `__path__`\nbecomes `foo` (or `<podModulePrefix>/foo` if the\npodModulePrefix is defined). This token is primarily for\npod support, and is only necessary if the blueprint can be\nused in pod structure. If the blueprint does not require pod\nsupport, simply use the blueprint name instead of the\n`__path__` token.\n\nThe `__test__` token is substituted with the dasherized\nentity name and appended with `-test` at install time.\nThis token is primarily for pod support and only necessary\nif the blueprint requires support for a pod structure. If\nthe blueprint does not require pod support, simply use the\n`__name__` token instead.\n\n## Template Variables (AKA Locals)\n\nVariables can be inserted into templates with\n`<%= someVariableName %>`.\n\nFor example, the built-in `util` blueprint\n`files/app/utils/__name__.js` looks like this:\n\n```js\nexport default function <%= camelizedModuleName %>() {\n  return true;\n}\n```\n\n`<%= camelizedModuleName %>` is replaced with the real\nvalue at install time.\n\nThe following template variables are provided by default:\n\n- `dasherizedPackageName`\n- `classifiedPackageName`\n- `dasherizedModuleName`\n- `classifiedModuleName`\n- `camelizedModuleName`\n\n`packageName` is the project name as found in the project's\n`package.json`.\n\n`moduleName` is the name of the entity being generated.\n\nThe mechanism for providing custom template variables is\ndescribed below.\n\n## Index.js\n\nCustom installation and uninstallation behavior can be added\nby overriding the hooks documented below. `index.js` should\nexport a plain object, which will extend the prototype of the\n`Blueprint` class. If needed, the original `Blueprint` prototype\ncan be accessed through the `_super` property.\n\n```js\nmodule.exports = {\n  locals(options) {\n    // Return custom template variables here.\n    return {};\n  },\n\n  normalizeEntityName(entityName) {\n    // Normalize and validate entity name here.\n    return entityName;\n  },\n\n  fileMapTokens(options) {\n    // Return custom tokens to be replaced in your files\n    return {\n      __token__(options){\n        // logic to determine value goes here\n        return 'value';\n      }\n    }\n  },\n\n  filesPath(options) {\n    return path.join(this.path, 'files');\n  },\n\n  beforeInstall(options) {},\n  afterInstall(options) {},\n  beforeUninstall(options) {},\n  afterUninstall(options) {}\n\n};\n```\n\n## Blueprint Hooks\n\n### beforeInstall & beforeUninstall\n\nCalled before any of the template files are processed and receives\nthe `options` and `locals` hashes as parameters. Typically used for\nvalidating any additional command line options or for any asynchronous\nsetup that is needed.   As an example, the `controller` blueprint validates\nits `--type` option in this hook.  If you need to run any asynchronous code,\nwrap it in a promise and return that promise from these hooks.  This will\nensure that your code is executed correctly.\n\n### afterInstall & afterUninstall\n\nThe `afterInstall` and `afterUninstall` hooks receives the same\narguments as `locals`. Use it to perform any custom work after the\nfiles are processed. For example, the built-in `route` blueprint\nuses these hooks to add and remove relevant route declarations in\n`app/router.js`.\n\n### Overriding Install\n\nIf you don't want your blueprint to install the contents of\n`files` you can override the `install` method. It receives the\nsame `options` object described above and must return a promise.\nSee the built-in `resource` blueprint for an example of this.",
             "is_constructor": 1,
             "extends": "CoreObject",
@@ -673,7 +687,7 @@
             "module": "ember-cli",
             "namespace": "",
             "file": "lib/models/project.js",
-            "line": 28,
+            "line": 29,
             "description": "The Project model is tied to your package.json. It is instantiated\nby giving {{#crossLink \"Project/closestSync:method\"}}{{/crossLink}}\nthe path to your project.",
             "is_constructor": 1,
             "params": [
@@ -1571,6 +1585,53 @@
             "class": "CLI",
             "module": "ember-cli"
         },
+        {
+            "file": "lib/debug/assert.js",
+            "line": 3,
+            "description": "Verify that a certain condition is met, or throw an error if otherwise.\n\nThis is useful for communicating expectations in the code to other human\nreaders as well as catching bugs that accidentally violate these expectations.\n\n```js\nconst { assert } = require('ember-cli/lib/debug');\n\n// Test for truthiness:\nassert('Must pass a string.', typeof str === 'string');\n\n// Fail unconditionally:\nassert('This code path should never run.');\n```",
+            "itemtype": "method",
+            "name": "assert",
+            "params": [
+                {
+                    "name": "description",
+                    "description": "Describes the condition.\nThis will become the message of the error thrown if the assertion fails.",
+                    "type": "String"
+                },
+                {
+                    "name": "condition",
+                    "description": "Must be truthy for the assertion to pass.\nIf falsy, an error will be thrown.",
+                    "type": "Any"
+                }
+            ],
+            "class": "PackageInfoCache",
+            "module": "ember-cli"
+        },
+        {
+            "file": "lib/debug/deprecate.js",
+            "line": 7,
+            "description": "Display a deprecation message.\n\n```js\nconst { deprecate } = require('ember-cli/lib/debug');\n\ndeprecate('The `foo` method is deprecated.', false, {\n  for: 'ember-cli',\n  id: 'ember-cli.foo-method',\n  since: {\n    available: '4.1.0',\n    enabled: '4.2.0',\n  },\n  until: '5.0.0',\n  url: 'https://example.com',\n});\n```",
+            "itemtype": "method",
+            "name": "deprecate",
+            "params": [
+                {
+                    "name": "description",
+                    "description": "Describes the deprecation.",
+                    "type": "String"
+                },
+                {
+                    "name": "condition",
+                    "description": "If falsy, the deprecation message will be displayed.",
+                    "type": "Any"
+                },
+                {
+                    "name": "options",
+                    "description": "An object including the deprecation's details:\n- `for` The library that the deprecation is for\n- `id` The deprecation's unique id\n- `since.available` A SemVer version indicating when the deprecation was made available\n- `since.enabled` A SemVer version indicating when the deprecation was enabled\n- `until` A SemVer version indicating until when the deprecation will be active\n- `url` A URL that refers to additional information about the deprecation",
+                    "type": "Object"
+                }
+            ],
+            "class": "PackageInfoCache",
+            "module": "ember-cli"
+        },
         {
             "file": "lib/models/package-info-cache/index.js",
             "line": 36,
@@ -3603,7 +3664,19 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 205,
+            "line": 200,
+            "description": "Indicates whether or not a blueprint is a candidate for automatic transpilation from TS to JS.\nThis property could be false in the case that the blueprint is written in JS and is not intended\nto work with TS at all, OR in the case that the blueprint is written in TS and the author does\nnot intend to support transpilation to JS.",
+            "access": "public",
+            "tagname": "",
+            "itemtype": "property",
+            "name": "shouldTransformTypeScript",
+            "type": "Boolean",
+            "class": "Blueprint",
+            "module": "ember-cli"
+        },
+        {
+            "file": "lib/models/blueprint.js",
+            "line": 219,
             "description": "Hook to specify the path to the blueprint's files. By default this is\n`path.join(this.path, 'files)`.\n\nThis can be used to customize which set of files to install based on options\nor environmental variables. It defaults to the `files` directory within the\nblueprint's folder.",
             "access": "public",
             "tagname": "",
@@ -3625,7 +3698,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 222,
+            "line": 236,
             "description": "Used to retrieve files for blueprint.",
             "access": "public",
             "tagname": "",
@@ -3640,7 +3713,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 244,
+            "line": 258,
             "itemtype": "method",
             "name": "srcPath",
             "params": [
@@ -3659,7 +3732,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 253,
+            "line": 267,
             "description": "Hook for normalizing entity name\n\nUse the `normalizeEntityName` hook to add custom normalization and\nvalidation of the provided entity name. The default hook does not\nmake any changes to the entity name, but makes sure an entity name\nis present and that it doesn't have a trailing slash.\n\nThis hook receives the entity name as its first argument. The string\nreturned by this hook will be used as the new entity name.",
             "access": "public",
             "tagname": "",
@@ -3681,7 +3754,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 273,
+            "line": 287,
             "description": "Write a status and message to the UI",
             "access": "private",
             "tagname": "",
@@ -3709,7 +3782,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 287,
+            "line": 301,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -3730,7 +3803,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 299,
+            "line": 313,
             "description": "Actions lookup",
             "access": "private",
             "tagname": "",
@@ -3742,7 +3815,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 337,
+            "line": 351,
             "description": "Calls an action.",
             "access": "private",
             "tagname": "",
@@ -3768,7 +3841,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 355,
+            "line": 369,
             "description": "Prints warning for pod unsupported.",
             "access": "private",
             "tagname": "",
@@ -3779,7 +3852,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 372,
+            "line": 386,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -3796,7 +3869,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 383,
+            "line": 397,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -3813,7 +3886,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 412,
+            "line": 426,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -3845,7 +3918,54 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 438,
+            "line": 452,
+            "access": "private",
+            "tagname": "",
+            "itemtype": "method",
+            "name": "shouldConvertToJS",
+            "params": [
+                {
+                    "name": "options",
+                    "description": "",
+                    "type": "Object"
+                },
+                {
+                    "name": "fileInfo",
+                    "description": "",
+                    "type": "FileInfo"
+                }
+            ],
+            "return": {
+                "description": "",
+                "type": "Boolean"
+            },
+            "class": "Blueprint",
+            "module": "ember-cli"
+        },
+        {
+            "file": "lib/models/blueprint.js",
+            "line": 506,
+            "access": "private",
+            "tagname": "",
+            "itemtype": "method",
+            "name": "convertToJS",
+            "params": [
+                {
+                    "name": "fileInfo",
+                    "description": "",
+                    "type": "FileInfo"
+                }
+            ],
+            "return": {
+                "description": "",
+                "type": "Promise"
+            },
+            "class": "Blueprint",
+            "module": "ember-cli"
+        },
+        {
+            "file": "lib/models/blueprint.js",
+            "line": 525,
             "itemtype": "method",
             "name": "install",
             "params": [
@@ -3864,7 +3984,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 468,
+            "line": 555,
             "itemtype": "method",
             "name": "uninstall",
             "params": [
@@ -3883,7 +4003,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 493,
+            "line": 580,
             "description": "Hook for running operations before install.",
             "itemtype": "method",
             "name": "beforeInstall",
@@ -3896,7 +4016,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 500,
+            "line": 587,
             "description": "Hook for running operations after install.",
             "itemtype": "method",
             "name": "afterInstall",
@@ -3909,7 +4029,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 507,
+            "line": 594,
             "description": "Hook for running operations before uninstall.",
             "itemtype": "method",
             "name": "beforeUninstall",
@@ -3922,7 +4042,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 514,
+            "line": 601,
             "description": "Hook for running operations after uninstall.",
             "itemtype": "method",
             "name": "afterUninstall",
@@ -3935,7 +4055,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 523,
+            "line": 610,
             "description": "Hook for adding custom template variables.\n\nWhen the following is called on the command line:\n\n```sh\nember generate controller foo --type=array --dry-run isAdmin:true\n```\n\nThe object passed to `locals` looks like this:\n\n```js\n{\n  entity: {\n    name: 'foo',\n    options: {\n      isAdmin: true\n    }\n  },\n  dryRun: true\n  type: \"array\"\n  // more keys\n}\n```\n\nThis hook must return an object or a Promise which resolves to an object.\nThe resolved object will be merged with the aforementioned default locals.",
             "access": "public",
             "tagname": "",
@@ -3957,7 +4077,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 558,
+            "line": 645,
             "description": "Hook to add additional or override existing fileMap tokens.\n\nUse `fileMapTokens` to add custom fileMap tokens for use\nin the `mapFile` method. The hook must return an object in the\nfollowing pattern:\n\n```js\n{\n  __token__(options){\n    // logic to determine value goes here\n    return 'value';\n  }\n}\n```\n\nIt will be merged with the default `fileMapTokens`, and can be used\nto override any of the default tokens.\n\nTokens are used in the files folder (see `files`), and get replaced with\nvalues when the `mapFile` method is called.",
             "access": "public",
             "tagname": "",
@@ -3972,7 +4092,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 586,
+            "line": 673,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -3993,7 +4113,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 642,
+            "line": 729,
             "description": "Used to generate fileMap tokens for mapFile.",
             "itemtype": "method",
             "name": "generateFileMap",
@@ -4013,7 +4133,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 657,
+            "line": 744,
             "itemtype": "method",
             "name": "buildFileInfo",
             "params": [
@@ -4042,7 +4162,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 678,
+            "line": 765,
             "itemtype": "method",
             "name": "isUpdate",
             "return": {
@@ -4054,7 +4174,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 688,
+            "line": 775,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4085,7 +4205,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 700,
+            "line": 787,
             "description": "Add update files to ignored files or reset them",
             "access": "private",
             "tagname": "",
@@ -4096,7 +4216,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 713,
+            "line": 800,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4117,7 +4237,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 726,
+            "line": 813,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4139,7 +4259,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 740,
+            "line": 827,
             "itemtype": "method",
             "name": "processFiles",
             "params": [
@@ -4163,7 +4283,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 762,
+            "line": 860,
             "itemtype": "method",
             "name": "processFilesForUninstall",
             "params": [
@@ -4183,7 +4303,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 775,
+            "line": 911,
             "itemtype": "method",
             "name": "mapFile",
             "params": [
@@ -4206,7 +4326,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 792,
+            "line": 928,
             "description": "Looks for a __root__ token in the files folder. Must be present for\nthe blueprint to support addon tokens. The `server`, `blueprints`, and `test`",
             "access": "private",
             "tagname": "",
@@ -4221,7 +4341,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 804,
+            "line": 940,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4251,7 +4371,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 834,
+            "line": 970,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4272,7 +4392,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 867,
+            "line": 1003,
             "description": "Used to add a package to the project's `package.json`.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that a package that is required by a given blueprint is\navailable.",
             "itemtype": "method",
             "name": "addPackageToProject",
@@ -4297,7 +4417,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 889,
+            "line": 1025,
             "description": "Used to add multiple packages to the project's `package.json`.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that a package that is required by a given blueprint is\navailable.\n\nExpects each array item to be an object with a `name`.  Each object\nmay optionally have a `target` to specify a specific version.",
             "itemtype": "method",
             "name": "addPackagesToProject",
@@ -4320,7 +4440,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 938,
+            "line": 1074,
             "description": "Used to remove a package from the project's `package.json`.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that any package conflicts can be resolved before the\naddon is used.",
             "itemtype": "method",
             "name": "removePackageFromProject",
@@ -4340,7 +4460,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 955,
+            "line": 1091,
             "description": "Used to remove multiple packages from the project's `package.json`.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that any package conflicts can be resolved before the\naddon is used.\n\nExpects each array item to be an object with a `name` property.",
             "itemtype": "method",
             "name": "removePackagesFromProject",
@@ -4360,7 +4480,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 996,
+            "line": 1132,
             "description": "Used to add a package to the projects `bower.json`.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that a package that is required by a given blueprint is\navailable.\n\n`localPackageName` and `target` may be thought of as equivalent\nto the key-value pairs in the `dependency` or `devDepencency`\nobjects contained within a bower.json file.",
             "itemtype": "method",
             "name": "addBowerPackageToProject",
@@ -4393,7 +4513,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1026,
+            "line": 1181,
             "description": "Used to add an array of packages to the projects `bower.json`.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that a package that is required by a given blueprint is\navailable.\n\nExpects each array item to be an object with a `name`.  Each object\nmay optionally have a `target` to specify a specific version, or a\n`source` to specify a non-local name to be resolved.",
             "itemtype": "method",
             "name": "addBowerPackagesToProject",
@@ -4418,7 +4538,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1063,
+            "line": 1237,
             "description": "Used to add an addon to the project's `package.json` and run it's\n`defaultBlueprint` if it provides one.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that a package that is required by a given blueprint is\navailable.",
             "itemtype": "method",
             "name": "addAddonToProject",
@@ -4438,7 +4558,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1083,
+            "line": 1257,
             "description": "Used to add multiple addons to the project's `package.json` and run their\n`defaultBlueprint` if they provide one.\n\nGenerally, this would be done from the `afterInstall` hook, to\nensure that a package that is required by a given blueprint is\navailable.",
             "itemtype": "method",
             "name": "addAddonsToProject",
@@ -4458,7 +4578,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1129,
+            "line": 1303,
             "description": "Used to retrieve a task with the given name. Passes the new task\nthe standard information available (like `ui`, `analytics`, `project`, etc).",
             "itemtype": "method",
             "name": "taskFor",
@@ -4475,7 +4595,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1147,
+            "line": 1321,
             "description": "Inserts the given content into a file. If the `contentsToInsert` string is already\npresent in the current contents, the file will not be changed unless `force` option\nis passed.\n\nIf `options.before` is specified, `contentsToInsert` will be inserted before\nthe first instance of that string.  If `options.after` is specified, the\ncontents will be inserted after the first instance of that string.\nIf the string specified by options.before or options.after is not in the file,\nno change will be made.\n\nIf neither `options.before` nor `options.after` are present, `contentsToInsert`\nwill be inserted at the end of the file.\n\nExample:\n```\n// app/router.js\nRouter.map(function () {\n});\n```\n\n```\ninsertIntoFile('app/router.js', '  this.route(\"admin\");', {\n  after: 'Router.map(function () {' + EOL\n}).then(function() {\n  // file has been inserted into!\n});\n\n\n```\n\n```\n// app/router.js\nRouter.map(function () {\n  this.route(\"admin\");\n});\n```",
             "itemtype": "method",
             "name": "insertIntoFile",
@@ -4505,7 +4625,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1251,
+            "line": 1425,
             "description": "Used to retrieve a blueprint with the given name.",
             "itemtype": "method",
             "name": "lookupBlueprint",
@@ -4527,7 +4647,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1268,
+            "line": 1442,
             "static": 1,
             "itemtype": "method",
             "name": "lookup",
@@ -4568,7 +4688,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1298,
+            "line": 1489,
             "description": "Loads a blueprint from given path.",
             "static": 1,
             "itemtype": "method",
@@ -4590,7 +4710,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1325,
+            "line": 1516,
             "static": 1,
             "itemtype": "method",
             "name": "list",
@@ -4620,7 +4740,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1374,
+            "line": 1565,
             "description": "Files that are renamed when installed into the target directory.\nThis allows including files in the blueprint that would have an effect\non another process, such as a file named `.gitignore`.\n\nThe keys are the filenames used in the files folder.\nThe values are the filenames used in the target directory.",
             "static": 1,
             "itemtype": "property",
@@ -4631,7 +4751,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1389,
+            "line": 1580,
             "static": 1,
             "itemtype": "property",
             "name": "ignoredFiles",
@@ -4641,7 +4761,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1395,
+            "line": 1586,
             "static": 1,
             "itemtype": "property",
             "name": "ignoredUpdateFiles",
@@ -4651,7 +4771,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1401,
+            "line": 1592,
             "static": 1,
             "itemtype": "property",
             "name": "defaultLookupPaths",
@@ -4661,7 +4781,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1409,
+            "line": 1600,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4683,7 +4803,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1422,
+            "line": 1613,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4701,7 +4821,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1433,
+            "line": 1624,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4719,7 +4839,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1442,
+            "line": 1633,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4746,7 +4866,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1456,
+            "line": 1647,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4768,7 +4888,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1468,
+            "line": 1659,
             "description": "Combines provided lookup paths with defaults and removes\nduplicates.",
             "access": "private",
             "tagname": "",
@@ -4791,7 +4911,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1483,
+            "line": 1674,
             "description": "Looks for a __path__ token in the files folder. Must be present for\nthe blueprint to support pod tokens.",
             "access": "private",
             "tagname": "",
@@ -4814,7 +4934,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1522,
+            "line": 1713,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4836,7 +4956,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1536,
+            "line": 1727,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4858,7 +4978,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1546,
+            "line": 1737,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -4873,7 +4993,7 @@
         },
         {
             "file": "lib/models/blueprint.js",
-            "line": 1559,
+            "line": 1750,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -5706,7 +5826,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 54,
+            "line": 55,
             "description": "Set when the `Watcher.detectWatchman` helper method finishes running,\nso that other areas of the system can be aware that watchman is being used.\n\nFor example, this information is used in the broccoli build pipeline to know\nif we can watch additional directories (like bower_components) \"cheaply\".\n\nContains `enabled` and `version`.",
             "access": "private",
             "tagname": "",
@@ -5722,7 +5842,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 107,
+            "line": 108,
             "description": "Sets the name of the bower directory for this project",
             "access": "private",
             "tagname": "",
@@ -5733,7 +5853,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 180,
+            "line": 202,
             "description": "Returns the name from package.json.",
             "access": "private",
             "tagname": "",
@@ -5748,7 +5868,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 193,
+            "line": 215,
             "description": "Returns whether or not this is an Ember CLI project.\nThis checks whether ember-cli is listed in devDependencies.",
             "access": "private",
             "tagname": "",
@@ -5763,7 +5883,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 205,
+            "line": 227,
             "description": "Returns whether or not this is an Ember CLI addon.",
             "itemtype": "method",
             "name": "isEmberCLIAddon",
@@ -5776,7 +5896,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 215,
+            "line": 237,
             "description": "Returns the path to the configuration.",
             "access": "private",
             "tagname": "",
@@ -5791,7 +5911,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 232,
+            "line": 254,
             "description": "Loads the configuration for this project and its addons.",
             "access": "public",
             "tagname": "",
@@ -5813,7 +5933,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 251,
+            "line": 273,
             "access": "private",
             "tagname": "",
             "itemtype": "method",
@@ -5834,7 +5954,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 270,
+            "line": 292,
             "description": "Returns the targets of this project, or the default targets if not present.",
             "access": "public",
             "tagname": "",
@@ -5849,7 +5969,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 297,
+            "line": 319,
             "description": "Returns the addons configuration.",
             "access": "private",
             "tagname": "",
@@ -5876,7 +5996,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 320,
+            "line": 342,
             "description": "Returns whether or not the given file name is present in this project.",
             "access": "private",
             "tagname": "",
@@ -5898,7 +6018,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 332,
+            "line": 354,
             "description": "Resolves the absolute path to a file synchronously",
             "access": "private",
             "tagname": "",
@@ -5920,7 +6040,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 346,
+            "line": 368,
             "description": "Calls `require` on a given module from the context of the project. For\ninstance, an addon may want to require a class from the root project's\nversion of ember-cli.",
             "access": "public",
             "tagname": "",
@@ -5942,7 +6062,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 361,
+            "line": 383,
             "description": "Returns the dependencies from a package.json",
             "access": "private",
             "tagname": "",
@@ -5973,7 +6093,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 381,
+            "line": 403,
             "description": "Returns the bower dependencies for this project.",
             "access": "private",
             "tagname": "",
@@ -5995,7 +6115,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 397,
+            "line": 440,
             "description": "Provides the list of paths to consult for addons that may be provided\ninternally to this project. Used for middleware addons with built-in support.",
             "access": "private",
             "tagname": "",
@@ -6006,7 +6126,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 423,
+            "line": 466,
             "description": "Discovers all addons for this project and stores their names and\npackage.json contents in this.addonPackages as key-value pairs.\n\nAny packageInfos that we find that are marked as not valid are excluded.",
             "access": "private",
             "tagname": "",
@@ -6017,7 +6137,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 445,
+            "line": 488,
             "description": "Loads and initializes all addons for this project.",
             "access": "private",
             "tagname": "",
@@ -6028,7 +6148,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 465,
+            "line": 508,
             "description": "Returns what commands are made available by addons by inspecting\n`includedCommands` for every addon.",
             "access": "private",
             "tagname": "",
@@ -6043,7 +6163,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 506,
+            "line": 549,
             "description": "Execute a given callback for every addon command.\nExample:\n\n```\nproject.eachAddonCommand(function(addonName, commands) {\n  console.log('Addon ' + addonName + ' exported the following commands:' + commands.keys().join(', '));\n});\n```",
             "access": "private",
             "tagname": "",
@@ -6061,7 +6181,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 529,
+            "line": 572,
             "description": "Path to the blueprints for this project.",
             "access": "private",
             "tagname": "",
@@ -6076,7 +6196,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 540,
+            "line": 583,
             "description": "Returns a list of paths (including addon paths) where blueprints will be looked up.",
             "access": "private",
             "tagname": "",
@@ -6091,7 +6211,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 558,
+            "line": 601,
             "description": "Returns a list of addon paths where blueprints will be looked up.",
             "access": "private",
             "tagname": "",
@@ -6106,7 +6226,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 581,
+            "line": 624,
             "description": "Reloads package.json of the project. Clears and reloads the packageInfo and\nper-bundle addon cache, too.",
             "access": "private",
             "tagname": "",
@@ -6121,7 +6241,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 609,
+            "line": 652,
             "description": "Re-initializes addons.",
             "access": "private",
             "tagname": "",
@@ -6132,7 +6252,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 621,
+            "line": 664,
             "description": "Find an addon by its name",
             "access": "public",
             "tagname": "",
@@ -6154,7 +6274,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 635,
+            "line": 678,
             "description": "Generate test file contents.\n\nThis method is supposed to be overwritten by test framework addons\nlike `ember-qunit` and `ember-mocha`.",
             "access": "public",
             "tagname": "",
@@ -6181,7 +6301,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 659,
+            "line": 702,
             "description": "Returns a new project based on the first `package.json` that is found\nin `pathName`.\n\nIf the above `package.json` specifies `ember-addon.projectRoot`, we load\nthe project based on the relative path between this directory and the\nspecified `projectRoot`.",
             "access": "private",
             "tagname": "",
@@ -6209,7 +6329,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 710,
+            "line": 753,
             "description": "Returns a new project based on the first package.json that is found\nin `pathName`, or the nullProject.\n\nThe nullProject signifies no-project, but abides by the null object pattern",
             "access": "private",
             "tagname": "",
@@ -6232,7 +6352,7 @@
         },
         {
             "file": "lib/models/project.js",
-            "line": 734,
+            "line": 777,
             "description": "Returns the project root based on the first package.json that is found",
             "static": 1,
             "itemtype": "method",