npm - ember-cli - Versions diffs - 4.0.0 → 4.1.1 - Mend

ember-cli 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (114) hide show

package/.github/workflows/ci.yml +4 -4
package/CHANGELOG.md +42 -2
package/blueprints/addon/additional-dev-dependencies.json +1 -1
package/blueprints/addon/files/.github/workflows/ci.yml +0 -1
package/blueprints/addon/files/.travis.yml +0 -1
package/blueprints/addon/files/addon-config/ember-try.js +0 -13
package/blueprints/app/files/config/environment.js +1 -1
package/blueprints/app/files/package.json +6 -6
package/docs/build/data.json +3 -3
package/lib/models/host-info-cache.js +3 -5
package/lib/models/per-bundle-addon-cache/index.js +2 -3
package/lib/tasks/npm-task.js +1 -1
package/lib/utilities/get-lang-arg.js +45 -45
package/package.json +25 -25
package/tests/helpers/mock-project.js +1 -1
package/.github/ISSUE_TEMPLATE.md +0 -12
package/.github/dependabot.yml +0 -15
package/.github/workflows/coverage.yml +0 -31
package/docs/analytics.md +0 -44
package/docs/architecture.md +0 -316
package/docs/assets/architecture/Ember-CLI architecture.png +0 -0
package/docs/assets/architecture/Ember-CLI architecture.xml +0 -1
package/docs/assets/architecture/README.md +0 -5
package/docs/brocfile-transition.md +0 -46
package/docs/build/api.js +0 -44
package/docs/build/assets/css/external-small.png +0 -0
package/docs/build/assets/css/logo.png +0 -0
package/docs/build/assets/css/main.css +0 -555
package/docs/build/assets/favicon.ico +0 -0
package/docs/build/assets/img/spinner.gif +0 -0
package/docs/build/assets/index.html +0 -10
package/docs/build/assets/js/api-filter.js +0 -56
package/docs/build/assets/js/api-list.js +0 -255
package/docs/build/assets/js/api-search.js +0 -98
package/docs/build/assets/js/apidocs.js +0 -376
package/docs/build/assets/js/yui-prettify.js +0 -17
package/docs/build/assets/vendor/prettify/CHANGES.html +0 -130
package/docs/build/assets/vendor/prettify/COPYING +0 -202
package/docs/build/assets/vendor/prettify/README.html +0 -203
package/docs/build/assets/vendor/prettify/prettify-min.css +0 -1
package/docs/build/assets/vendor/prettify/prettify-min.js +0 -1
package/docs/build/classes/Addon.html +0 -4318
package/docs/build/classes/AmdTransformAddon.html +0 -202
package/docs/build/classes/Blueprint.html +0 -4796
package/docs/build/classes/Builder.html +0 -611
package/docs/build/classes/CLI.html +0 -810
package/docs/build/classes/Command.html +0 -1655
package/docs/build/classes/DefaultPackager.html +0 -202
package/docs/build/classes/EmberAddon.html +0 -2207
package/docs/build/classes/EmberApp.html +0 -2225
package/docs/build/classes/HardwareInfo.html +0 -620
package/docs/build/classes/HistorySupportAddon.html +0 -203
package/docs/build/classes/Instrumentation.html +0 -695
package/docs/build/classes/NodeModulesList.html +0 -460
package/docs/build/classes/NpmTask.html +0 -333
package/docs/build/classes/PackageInfo.html +0 -1390
package/docs/build/classes/PackageInfoCache.html +0 -963
package/docs/build/classes/PerBundleAddonCache {.html +0 -1010
package/docs/build/classes/Project.html +0 -2083
package/docs/build/classes/ServeFilesAddon.html +0 -260
package/docs/build/classes/TestsServerAddon.html +0 -203
package/docs/build/classes/WatcherAddon.html +0 -204
package/docs/build/classes/WindowsSymlinkChecker.html +0 -1505
package/docs/build/files/lib_broccoli_default-packager.js.html +0 -1426
package/docs/build/files/lib_broccoli_ember-addon.js.html +0 -159
package/docs/build/files/lib_broccoli_ember-app.js.html +0 -1913
package/docs/build/files/lib_cli_cli.js.html +0 -417
package/docs/build/files/lib_models_addon-info.js.html +0 -112
package/docs/build/files/lib_models_addon.js.html +0 -1866
package/docs/build/files/lib_models_blueprint.js.html +0 -1678
package/docs/build/files/lib_models_builder.js.html +0 -417
package/docs/build/files/lib_models_command.js.html +0 -804
package/docs/build/files/lib_models_hardware-info.js.html +0 -479
package/docs/build/files/lib_models_host-info-cache.js.html +0 -428
package/docs/build/files/lib_models_installation-checker.js.html +0 -181
package/docs/build/files/lib_models_instantiate-addons.js.html +0 -191
package/docs/build/files/lib_models_instrumentation.js.html +0 -433
package/docs/build/files/lib_models_package-info-cache_index.js.html +0 -793
package/docs/build/files/lib_models_package-info-cache_node-modules-list.js.html +0 -208
package/docs/build/files/lib_models_package-info-cache_package-info.js.html +0 -661
package/docs/build/files/lib_models_per-bundle-addon-cache_addon-proxy.js.html +0 -252
package/docs/build/files/lib_models_per-bundle-addon-cache_index.js.html +0 -485
package/docs/build/files/lib_models_per-bundle-addon-cache_target-instance.js.html +0 -108
package/docs/build/files/lib_models_project.js.html +0 -913
package/docs/build/files/lib_models_task.js.html +0 -117
package/docs/build/files/lib_tasks_build-watch.js.html +0 -157
package/docs/build/files/lib_tasks_npm-task.js.html +0 -463
package/docs/build/files/lib_tasks_serve.js.html +0 -207
package/docs/build/files/lib_tasks_server_middleware_broccoli-serve-files_index.js.html +0 -127
package/docs/build/files/lib_tasks_server_middleware_broccoli-watcher_index.js.html +0 -158
package/docs/build/files/lib_tasks_server_middleware_history-support_index.js.html +0 -181
package/docs/build/files/lib_tasks_server_middleware_tests-server_index.js.html +0 -171
package/docs/build/files/lib_tasks_test-server.js.html +0 -167
package/docs/build/files/lib_tasks_transforms_amd_index.js.html +0 -143
package/docs/build/files/lib_utilities_ember-app-utils.js.html +0 -292
package/docs/build/files/lib_utilities_insert-into-file.js.html +0 -219
package/docs/build/files/lib_utilities_is-lazy-engine.js.html +0 -125
package/docs/build/files/lib_utilities_is-yarn-project.js.html +0 -120
package/docs/build/files/lib_utilities_valid-project-name.js.html +0 -142
package/docs/build/files/lib_utilities_will-interrupt-process.js.html +0 -290
package/docs/build/files/lib_utilities_windows-admin.js.html +0 -230
package/docs/build/index.html +0 -125
package/docs/build/modules/ember-cli.html +0 -152
package/docs/build/modules/is-lazy-engine.html +0 -106
package/docs/build-concurrency.md +0 -15
package/docs/build-pipeline-debugging.md +0 -33
package/docs/code-coverage.md +0 -14
package/docs/error-propagation.md +0 -136
package/docs/experiments.md +0 -53
package/docs/node-support.md +0 -43
package/docs/perf-guide.md +0 -250
package/docs/project_version_preprocessor.js +0 -8
package/docs/sourcemaps.md +0 -60
package/docs/yuidoc.json +0 -13

package/docs/build/classes/PackageInfoCache.html DELETED Viewed

@@ -1,963 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8">
-    <title>PackageInfoCache - ember-cli</title>
-    <link rel="stylesheet" href="../assets/vendor/prettify/prettify-min.css">
-    <link rel="stylesheet" href="../assets/css/main.css" id="site_styles">
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/yui/3.18.0/yui/yui-min.js"></script>
-</head>
-<body class="yui3-skin-sam">
-<div id="doc">
-    <div class="yui3-g">
-        <div id="sidebar" class="yui3-u">
-            <div class="logo">
-              <a href="../index.html">
-                  <img src="https://ember-cli.com/assets/images/ember-cli-logo-small-dark.png">
-              </a>
-            </div>
-            <div id="modules" class="sidebox">
-                <div class="hd">
-                    <h2 class="no-toc">Modules</h2>
-                </div>
-                <div class="bd">
-                    <ul>
-                            <li><a href="../modules/ember-cli.html">ember-cli</a>
-                            </li>
-                            <li><a href="../modules/is-lazy-engine.html">is-lazy-engine</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-            <div id="classes" class="sidebox">
-                <div class="hd">
-                    <h2 class="no-toc">Classes</h2>
-                </div>
-                <div class="bd">
-                    <ul>
-                            <li><a href="../classes/Addon.html">Addon</a></li>
-                            <li><a href="../classes/AmdTransformAddon.html">AmdTransformAddon</a></li>
-                            <li><a href="../classes/Blueprint.html">Blueprint</a></li>
-                            <li><a href="../classes/Builder.html">Builder</a></li>
-                            <li><a href="../classes/CLI.html">CLI</a></li>
-                            <li><a href="../classes/Command.html">Command</a></li>
-                            <li><a href="../classes/DefaultPackager.html">DefaultPackager</a></li>
-                            <li><a href="../classes/EmberAddon.html">EmberAddon</a></li>
-                            <li><a href="../classes/EmberApp.html">EmberApp</a></li>
-                            <li><a href="../classes/HardwareInfo.html">HardwareInfo</a></li>
-                            <li><a href="../classes/HistorySupportAddon.html">HistorySupportAddon</a></li>
-                            <li><a href="../classes/Instrumentation.html">Instrumentation</a></li>
-                            <li><a href="../classes/NodeModulesList.html">NodeModulesList</a></li>
-                            <li><a href="../classes/NpmTask.html">NpmTask</a></li>
-                            <li><a href="../classes/PackageInfo.html">PackageInfo</a></li>
-                            <li><a href="../classes/PackageInfoCache.html">PackageInfoCache</a></li>
-                            <li><a href="../classes/PerBundleAddonCache {.html">PerBundleAddonCache {</a></li>
-                            <li><a href="../classes/Project.html">Project</a></li>
-                            <li><a href="../classes/ServeFilesAddon.html">ServeFilesAddon</a></li>
-                            <li><a href="../classes/TestsServerAddon.html">TestsServerAddon</a></li>
-                            <li><a href="../classes/WatcherAddon.html">WatcherAddon</a></li>
-                            <li><a href="../classes/WindowsSymlinkChecker.html">WindowsSymlinkChecker</a></li>
-                    </ul>
-                </div>
-            </div>
-            <div id="sections" class="sidebox">
-              <div class="hd">
-                <h2 class="no-toc">PackageInfoCache</h2>
-              </div>
-              <div class="bd">
-                  <div><a href="#method-summary">Method Summary</a></div>
-                  <div><a href="#public-methods">Public Methods</a></div>
-                  <ul>
-                      <li><a href="#method_contains">contains</a></li>
-                      <li><a href="#method_getEntry">getEntry</a></li>
-                      <li><a href="#method_hasErrors">hasErrors</a></li>
-                      <li><a href="#method_loadAddon">loadAddon</a></li>
-                      <li><a href="#method_loadProject">loadProject</a></li>
-                      <li><a href="#method_reloadProjects">reloadProjects</a></li>
-                      <li><a href="#method_showErrors">showErrors</a></li>
-                  </ul>
-                  <div><a href="#private-methods">Private Methods</a></div>
-                  <ul>
-                      <li><a href="#method__addEntry">_addEntry</a></li>
-                      <li><a href="#method__clear">_clear</a></li>
-                      <li><a href="#method__readModulesList">_readModulesList</a></li>
-                      <li><a href="#method__readPackage">_readPackage</a></li>
-                      <li><a href="#method__resolveDependencies">_resolveDependencies</a></li>
-                      <li><a href="#method__showObjErrors">_showObjErrors</a></li>
-                  </ul>
-              </div>
-            </div>
-            <div class="version-info">
-              Version: 4.0.0-release-b4cbb1029f
-            </div>
-        </div>
-        <div id="main" class="yui3-u">
-            <div class="content"><div class="title">
-    <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l23"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:23</code></a></span>
-    <h1 class="class-name">PackageInfoCache</h1>
-</div>
-<div class="class-description"><p>Class that stores entries that are either PackageInfo or NodeModulesList objects.
-The entries are stored in a map keyed by real directory path.</p>
-</div>
-  <h2 id="method-summary">Method Summary</h2>
-    <table class="summary">
-      <thead>
-      <tr>
-        <th colspan="2">Public Methods</th>
-      </tr>
-      </thead>
-      <tbody>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_contains">contains</a>(path):
-            </div>
-            <div class="short-description">
-              <p>Indicate if an entry for a given path exists in the cache.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_getEntry">getEntry</a>(path): <a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a>
-            </div>
-            <div class="short-description">
-              <p>Retrieve an entry from the cache.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_hasErrors">hasErrors</a>( ):
-            </div>
-            <div class="short-description">
-              <p>Indicates if there is at least one error in any object in the cache.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_loadAddon">loadAddon</a>(addonInstance): <a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a>
-            </div>
-            <div class="short-description">
-              <p>Do the actual processing of the root directory of an addon, when the addon object already exists (i.e. the addon is acting as the root object of a tree, like project does). We need the object in order to find the internal addons. _readPackage takes care of the general processing of the root directory and common locations for addons, filling the cache with each.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_loadProject">loadProject</a>(projectInstance): <a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a>
-            </div>
-            <div class="short-description">
-              <p>Process the root directory of a project, given a Project object (we need the object in order to find the internal addons). _readPackage takes care of the general processing of the root directory and common locations for addons, filling the cache with each. Once it returns, we take care of the locations for addons that are specific to projects, not other packages (e.g. internal addons, cli root).</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_reloadProjects">reloadProjects</a>( ):
-            </div>
-            <div class="short-description">
-              <p>To support the project.reloadPkg method, we need the ability to flush the cache and reload from the updated package.json. There are some issues with doing this:</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_showErrors">showErrors</a>( )
-            </div>
-            <div class="short-description">
-              <p>Gather all the errors in the PIC and any cached objects, then dump them out to the ui-console.</p>
-            </div>
-          </td>
-        </tr>
-      </tbody>
-    </table>
-    <table class="summary">
-      <thead>
-      <tr>
-        <th colspan="2">Private Methods</th>
-      </tr>
-      </thead>
-      <tbody>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method__addEntry">_addEntry</a>( )
-            </div>
-            <div class="short-description">
-              <p>Add an entry to the cache.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method__clear">_clear</a>( )
-            </div>
-            <div class="short-description">
-              <p>Clear the cache information.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method__readModulesList">_readModulesList</a>(nodeModulesDir)
-            </div>
-            <div class="short-description">
-              <p>Process a directory of modules in a given package directory.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method__readPackage">_readPackage</a>(pkgDir, isRoot,)
-            </div>
-            <div class="short-description">
-              <p>Given a directory that supposedly contains a package, create a PackageInfo object and try to fill it out, EVEN IF the package.json is not readable. Errors will then be stored in the PackageInfo for anything with the package that might be wrong. Because it's possible that the path given to the packageDir is not actually valid, we'll just use the path.resolve() version of that path to search for the path in the cache, before trying to get the 'real' path (which also then resolves links). The cache itself is keyed on either the realPath, if the packageDir is actually a real valid directory path, or the normalized path (before path.resolve()), if it is not.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method__resolveDependencies">_resolveDependencies</a>( )
-            </div>
-            <div class="short-description">
-              <p>Resolve the node_module dependencies across all packages after they have been loaded into the cache, because we don't know when a particular package will enter the cache.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method__showObjErrors">_showObjErrors</a>( )
-            </div>
-            <div class="short-description">
-              <p>Dump all the errors for a single object in the cache out to the ui-console.</p>
-            </div>
-          </td>
-        </tr>
-      </tbody>
-    </table>
-  <div id="methods public">
-    <h2 id="public-methods">Public Methods</h2>
-<div class="method item public">
-    <div id="method_contains" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l321"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:321</code></a></span>
-        <h3 class="">
-            public
-            contains(path):
-        </h3>
-    </div>
-    <div class="method-description"><p>Indicate if an entry for a given path exists in the cache.</p>
-</div>
-      <div class="params">
-        <h4>Parameters:</h4>
-        <table>
-          <thead>
-          <tr>
-            <th>Name</th>
-            <th>Type</th>
-            <th>Attribute</th>
-            <th>Description</th>
-          </tr>
-          </thead>
-          <tbody>
-            <tr>
-              <td>path</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String" class="crosslink external" target="_blank">String</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the real path to check for in the cache.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-description"><p>true if the entry is present for the given path, false otherwise.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item public">
-    <div id="method_getEntry" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l309"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:309</code></a></span>
-        <h3 class="">
-            public
-            getEntry(path): <a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Retrieve an entry from the cache.</p>
-</div>
-      <div class="params">
-        <h4>Parameters:</h4>
-        <table>
-          <thead>
-          <tr>
-            <th>Name</th>
-            <th>Type</th>
-            <th>Attribute</th>
-            <th>Description</th>
-          </tr>
-          </thead>
-          <tbody>
-            <tr>
-              <td>path</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String" class="crosslink external" target="_blank">String</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the real path whose PackageInfo or NodeModulesList is desired.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a></span>
-          <span class="return-description"><p>or {NodeModulesList} the desired entry.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item public">
-    <div id="method_hasErrors" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l48"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:48</code></a></span>
-        <h3 class="">
-            public
-            hasErrors( ):
-        </h3>
-    </div>
-    <div class="method-description"><p>Indicates if there is at least one error in any object in the cache.</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-description"><p>true if there are any errors in the cache, for any entries, else false.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item public">
-    <div id="method_loadAddon" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l228"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:228</code></a></span>
-        <h3 class="">
-            public
-            loadAddon(addonInstance): <a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Do the actual processing of the root directory of an addon, when the addon
-object already exists (i.e. the addon is acting as the root object of a
-tree, like project does). We need the object in order to find the internal addons.
-_readPackage takes care of the general processing of the root directory
-and common locations for addons, filling the cache with each.</p>
-<p>Once all the addon processing is done, go back through all cache entries
-to create references between the packageInfo objects.</p>
-</div>
-      <div class="params">
-        <h4>Parameters:</h4>
-        <table>
-          <thead>
-          <tr>
-            <th>Name</th>
-            <th>Type</th>
-            <th>Attribute</th>
-            <th>Description</th>
-          </tr>
-          </thead>
-          <tbody>
-            <tr>
-              <td>addonInstance</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the instance of the Addon object to load package data
-about into the cache.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a></span>
-          <span class="return-description"><p>the PackageInfo object for the given Addon object.
-Note that if the addon path is already in the cache, that will be returned.
-No copy is made.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item public">
-    <div id="method_loadProject" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l146"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:146</code></a></span>
-        <h3 class="">
-            public
-            loadProject(projectInstance): <a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Process the root directory of a project, given a
-Project object (we need the object in order to find the internal addons).
-_readPackage takes care of the general processing of the root directory
-and common locations for addons, filling the cache with each. Once it
-returns, we take care of the locations for addons that are specific to
-projects, not other packages (e.g. internal addons, cli root).</p>
-<p>Once all the project processing is done, go back through all cache entries
-to create references between the packageInfo objects.</p>
-</div>
-      <div class="params">
-        <h4>Parameters:</h4>
-        <table>
-          <thead>
-          <tr>
-            <th>Name</th>
-            <th>Type</th>
-            <th>Attribute</th>
-            <th>Description</th>
-          </tr>
-          </thead>
-          <tbody>
-            <tr>
-              <td>projectInstance</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the instance of the Project object to load package data
-about into the cache.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a></span>
-          <span class="return-description"><p>the PackageInfo object for the given Project object.
-Note that if the project path is already in the cache, that will be returned.
-No copy is made.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item public">
-    <div id="method_reloadProjects" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l203"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:203</code></a></span>
-        <h3 class="">
-            public
-            reloadProjects( ):
-        </h3>
-    </div>
-    <div class="method-description"><p>To support the project.reloadPkg method, we need the ability to flush
-the cache and reload from the updated package.json.
-There are some issues with doing this:</p>
-<ul>
-<li>Because of the possible relationship between projects and their addons
-due to symlinks, it's not trivial to flush only the data related to a
-given project.</li>
-<li>If an 'ember-build-cli.js' dynamically adds new projects to the cache,
-we will not necessarily get called again to redo the loading of those
-projects.
-The solution, implemented here:</li>
-<li>Keep track of the Project objects whose packages are loaded into the cache.</li>
-<li>If a project is reloaded, flush the cache, then do loadPackage again
-for all the known Projects.</li>
-</ul>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-description"><p>null</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item public">
-    <div id="method_showErrors" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l65"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:65</code></a></span>
-        <h3 class="">
-            public
-            showErrors( )
-        </h3>
-    </div>
-    <div class="method-description"><p>Gather all the errors in the PIC and any cached objects, then dump them
-out to the ui-console.</p>
-</div>
-</div>
-  </div>
-    <div id="methods private">
-        <h2 id="private-methods">Private Methods</h2>
-<div class="method item private">
-    <div id="method__addEntry" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l299"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:299</code></a></span>
-        <h3 class="">
-            private
-            _addEntry( )
-        </h3>
-    </div>
-    <div class="method-description"><p>Add an entry to the cache.</p>
-</div>
-</div>
-<div class="method item private">
-    <div id="method__clear" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l36"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:36</code></a></span>
-        <h3 class="">
-            private
-            _clear( )
-        </h3>
-    </div>
-    <div class="method-description"><p>Clear the cache information.</p>
-</div>
-</div>
-<div class="method item private">
-    <div id="method__readModulesList" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l585"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:585</code></a></span>
-        <h3 class="">
-            private
-            _readModulesList(nodeModulesDir)
-        </h3>
-    </div>
-    <div class="method-description"><p>Process a directory of modules in a given package directory.</p>
-<p>We will allow cache entries for node_modules that actually
-have no contents, just so we don't have to hit the file system more
-often than necessary--it's much quicker to check an in-memory object.
-object.</p>
-<p>Note: only a NodeModulesList or null is returned.</p>
-</div>
-      <div class="params">
-        <h4>Parameters:</h4>
-        <table>
-          <thead>
-          <tr>
-            <th>Name</th>
-            <th>Type</th>
-            <th>Attribute</th>
-            <th>Description</th>
-          </tr>
-          </thead>
-          <tbody>
-            <tr>
-              <td>nodeModulesDir</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String" class="crosslink external" target="_blank">String</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the path of the node_modules directory
-to read the package.json from and process the contents and create a
-new cache entry or entries.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item private">
-    <div id="method__readPackage" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l395"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:395</code></a></span>
-        <h3 class="">
-            private
-            _readPackage(pkgDir, isRoot,)
-        </h3>
-    </div>
-    <div class="method-description"><p>Given a directory that supposedly contains a package, create a PackageInfo
-object and try to fill it out, EVEN IF the package.json is not readable.
-Errors will then be stored in the PackageInfo for anything with the package
-that might be wrong.
-Because it's possible that the path given to the packageDir is not actually valid,
-we'll just use the path.resolve() version of that path to search for the
-path in the cache, before trying to get the 'real' path (which also then
-resolves links). The cache itself is keyed on either the realPath, if the
-packageDir is actually a real valid directory path, or the normalized path (before
-path.resolve()), if it is not.</p>
-<p>NOTE: the cache is also used to store the NULL_PROJECT project object,
-which actually has no package.json or other files, but does have an empty
-package object. Because of that, and to speed up processing, loadProject()
-will pass in both the package root directory path and the project's package
-object, if there is one. If the package object is present, we will use that
-in preference to trying to find a package.json file.</p>
-<p>If there is no package object, and there is no package.json or the package.json
-is bad or the package is an addon with
-no main, the only thing we can do is return an ErrorEntry to the caller.
-Once past all those problems, if any error occurs with any of the contents
-of the package, they'll be cached in the PackageInfo itself.</p>
-<p>In summary, only PackageInfo or ErrorEntry will be returned.</p>
-</div>
-      <div class="params">
-        <h4>Parameters:</h4>
-        <table>
-          <thead>
-          <tr>
-            <th>Name</th>
-            <th>Type</th>
-            <th>Attribute</th>
-            <th>Description</th>
-          </tr>
-          </thead>
-          <tbody>
-            <tr>
-              <td>pkgDir</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String" class="crosslink external" target="_blank">String</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the path of the directory to read the package.json from and
-process the contents and create a new cache entry or entries.</p>
-</td>
-            </tr>
-            <tr>
-              <td>isRoot,</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>for when this is to be considered the root
-package, whose dependencies we must all consider for discovery.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item private">
-    <div id="method__resolveDependencies" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l262"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:262</code></a></span>
-        <h3 class="">
-            private
-            _resolveDependencies( )
-        </h3>
-    </div>
-    <div class="method-description"><p>Resolve the node_module dependencies across all packages after they have
-been loaded into the cache, because we don't know when a particular package
-will enter the cache.</p>
-<p>Since loadProject can be called multiple times for different projects,
-we don't want to reprocess any packages that happen to be common
-between them. We'll handle this by marking any packageInfo once it
-has been processed here, then ignore it in any later processing.</p>
-</div>
-</div>
-<div class="method item private">
-    <div id="method__showObjErrors" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_index.js.html#l80"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;index.js:80</code></a></span>
-        <h3 class="">
-            private
-            _showObjErrors( )
-        </h3>
-    </div>
-    <div class="method-description"><p>Dump all the errors for a single object in the cache out to the ui-console.</p>
-<p>Special case: because package-info-cache also creates PackageInfo objects for entries
-that do not actually exist (to allow simplifying the code), if there's a case where
-an object has only the single error ERROR_PACKAGE_DIR_MISSING, do not print
-anything. The package will have been found as a reference from some other
-addon or the root project, and we'll print a reference error there. Having
-both is just confusing to users.</p>
-</div>
-</div>
-    </div>
-</div>
-        </div>
-    </div>
-</div>
-<script src="../assets/vendor/prettify/prettify-min.js"></script>
-<script>prettyPrint();</script>
-<script src="../assets/js/yui-prettify.js"></script>
-</body>
-</html>