npm - ember-cli - Versions diffs - 4.0.0-beta.4 → 4.1.0 - Mend

ember-cli 4.0.0-beta.4 → 4.1.0

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 (118) hide show

package/.github/workflows/ci.yml +4 -4
package/CHANGELOG.md +28 -17
package/bin/ember +0 -0
package/blueprints/addon/additional-dev-dependencies.json +1 -1
package/blueprints/addon/files/.github/workflows/ci.yml +5 -1
package/blueprints/addon/files/.travis.yml +1 -1
package/blueprints/addon/files/README.md +2 -2
package/blueprints/addon/files/addon-config/ember-try.js +4 -4
package/blueprints/app/files/.github/workflows/ci.yml +4 -0
package/blueprints/app/files/package.json +8 -8
package/blueprints/in-repo-addon/files/__root__/__name__/index.js +0 -0
package/blueprints/in-repo-addon/index.js +0 -0
package/blueprints/lib/index.js +0 -0
package/docs/build/data.json +413 -413
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/.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/files/lib_models_package-info-cache_index.js.html DELETED Viewed

@@ -1,793 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8">
-    <title>lib/models/package-info-cache/index.js - 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 class="version-info">
-              Version: 4.0.0-beta.4-beta-724190cca6
-            </div>
-        </div>
-        <div id="main" class="yui3-u">
-            <div class="content"><div class="title">
-  <h1 class="file-name">lib/models/package-info-cache/index.js</h1>
-</div>
-<pre class="code prettyprint linenums">
-&#x27;use strict&#x27;;
-/*
- * Performance cache for information about packages (projects/addons/&quot;apps&quot;/modules)
- * under an initial root directory and resolving addon/dependency links to other packages.
- */
-const fs = require(&#x27;fs-extra&#x27;);
-const path = require(&#x27;path&#x27;);
-const ErrorList = require(&#x27;./error-list&#x27;);
-const Errors = require(&#x27;./errors&#x27;);
-const PackageInfo = require(&#x27;./package-info&#x27;);
-const NodeModulesList = require(&#x27;./node-modules-list&#x27;);
-const logger = require(&#x27;heimdalljs-logger&#x27;)(&#x27;ember-cli:package-info-cache&#x27;);
-const resolvePackagePath = require(&#x27;resolve-package-path&#x27;);
-const getRealFilePath = resolvePackagePath.getRealFilePath;
-const getRealDirectoryPath = resolvePackagePath.getRealDirectoryPath;
-const _resetCache = resolvePackagePath._resetCache;
-const PACKAGE_JSON = &#x27;package.json&#x27;;
-/**
- * Class that stores entries that are either PackageInfo or NodeModulesList objects.
- * The entries are stored in a map keyed by real directory path.
- *
- * @public
- * @class PackageInfoCache
- */
-class PackageInfoCache {
-  constructor(ui) {
-    this.ui = ui; // a console-ui instance
-    this._clear();
-  }
-  /**
-   * Clear the cache information.
-   *
-   * @private
-   * @method _clear
-   */
-  _clear() {
-    this.entries = Object.create(null);
-    this.projects = [];
-    _resetCache();
-  }
-  /**
-   * Indicates if there is at least one error in any object in the cache.
-   *
-   * @public
-   * @method hasErrors
-   * @return true if there are any errors in the cache, for any entries, else false.
-   */
-  hasErrors() {
-    let paths = Object.keys(this.entries);
-    if (paths.find((entryPath) =&gt; this.getEntry(entryPath).hasErrors())) {
-      return true;
-    }
-    return false;
-  }
-  /**
-   * Gather all the errors in the PIC and any cached objects, then dump them
-   * out to the ui-console.
-   *
-   * @public
-   * @method showErrors
-   */
-  showErrors() {
-    let paths = Object.keys(this.entries).sort();
-    paths.forEach((entryPath) =&gt; {
-      this._showObjErrors(this.getEntry(entryPath));
-    });
-  }
-  /**
-   * Dump all the errors for a single object in the cache out to the ui-console.
-   *
-   * Special case: because package-info-cache also creates PackageInfo objects for entries
-   * that do not actually exist (to allow simplifying the code), if there&#x27;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&#x27;ll print a reference error there. Having
-   * both is just confusing to users.
-   *
-   * @private
-   * @method _showObjErrors
-   */
-  _showObjErrors(obj) {
-    let errorEntries = obj.hasErrors() ? obj.errors.getErrors() : null;
-    if (!errorEntries || (errorEntries.length === 1 &amp;&amp; errorEntries[0].type === Errors.ERROR_PACKAGE_DIR_MISSING)) {
-      return;
-    }
-    logger.info(&#x27;&#x27;);
-    let rootPath;
-    if (obj instanceof PackageInfoCache) {
-      logger.info(&#x27;Top level errors:&#x27;);
-      rootPath = this.realPath || &#x27;&#x27;;
-    } else {
-      let typeName = obj.project ? &#x27;project&#x27; : &#x27;addon&#x27;;
-      logger.info(&#x60;The &#x27;package.json&#x27; file for the ${typeName} at ${obj.realPath}&#x60;);
-      rootPath = obj.realPath;
-    }
-    errorEntries.forEach((errorEntry) =&gt; {
-      switch (errorEntry.type) {
-        case Errors.ERROR_PACKAGE_JSON_MISSING:
-          logger.info(&#x60;  does not exist&#x60;);
-          break;
-        case Errors.ERROR_PACKAGE_JSON_PARSE:
-          logger.info(&#x60;  could not be parsed&#x60;);
-          break;
-        case Errors.ERROR_EMBER_ADDON_MAIN_MISSING:
-          logger.info(
-            &#x60;  specifies a missing ember-addon &#x27;main&#x27; file at relative path &#x27;${path.relative(
-              rootPath,
-              errorEntry.data
-            )}&#x27;&#x60;
-          );
-          break;
-        case Errors.ERROR_DEPENDENCIES_MISSING:
-          if (errorEntry.data.length === 1) {
-            logger.info(&#x60;  specifies a missing dependency &#x27;${errorEntry.data[0]}&#x27;&#x60;);
-          } else {
-            logger.info(&#x60;  specifies some missing dependencies:&#x60;);
-            errorEntry.data.forEach((dependencyName) =&gt; {
-              logger.info(&#x60;    ${dependencyName}&#x60;);
-            });
-          }
-          break;
-        case Errors.ERROR_NODEMODULES_ENTRY_MISSING:
-          logger.info(&#x60;  specifies a missing &#x27;node_modules/${errorEntry.data}&#x27; directory&#x60;);
-          break;
-      }
-    });
-  }
-  /**
-   * 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).
-   *
-   * Once all the project processing is done, go back through all cache entries
-   * to create references between the packageInfo objects.
-   *
-   * @public
-   * @method loadProject
-   * @param projectInstance the instance of the Project object to load package data
-   * about into the cache.
-   * @return {PackageInfo} 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.
-   */
-  loadProject(projectInstance) {
-    logger.info(&#x27;Loading project at %o...&#x27;, projectInstance.root);
-    let pkgInfo = this._readPackage(projectInstance.root, projectInstance.pkg, true);
-    // NOTE: the returned val may contain errors, or may contain
-    // other packages that have errors. We will try to process
-    // things anyway.
-    if (!pkgInfo.processed) {
-      this.projects.push(projectInstance);
-      // projects are a bit different than standard addons, in that they have
-      // possibly a CLI addon and internal addons. Add those now.
-      pkgInfo.project = projectInstance;
-      if (projectInstance.cli &amp;&amp; projectInstance.cli.root) {
-        logger.info(&#x27;Reading package for &quot;ember-cli&quot;: %o&#x27;, projectInstance.cli.root);
-        pkgInfo.cliInfo = this._readPackage(projectInstance.cli.root);
-      }
-      // add any internal addons in the project. Since internal addons are
-      // optional (and only used some of the time anyway), we don&#x27;t want to
-      // create a PackageInfo unless there is really a directory at the
-      // suggested location. The created addon may internally have errors,
-      // as with any other PackageInfo.
-      projectInstance.supportedInternalAddonPaths().forEach((internalAddonPath) =&gt; {
-        if (getRealDirectoryPath(internalAddonPath)) {
-          logger.info(&#x27;Reading package for internal addon: %o&#x27;, internalAddonPath);
-          pkgInfo.addInternalAddon(this._readPackage(internalAddonPath));
-        }
-      });
-      this._resolveDependencies();
-    }
-    return pkgInfo;
-  }
-  /**
-   * 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:
-   *   - Because of the possible relationship between projects and their addons
-   *     due to symlinks, it&#x27;s not trivial to flush only the data related to a
-   *     given project.
-   *   - If an &#x27;ember-build-cli.js&#x27; 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:
-   *   - Keep track of the Project objects whose packages are loaded into the cache.
-   *   - If a project is reloaded, flush the cache, then do loadPackage again
-   *     for all the known Projects.
-   *
-   * @public
-   * @method reloadProjects
-   * @return null
-   */
-  reloadProjects() {
-    let projects = this.projects.slice();
-    this._clear();
-    projects.forEach((project) =&gt; this.loadProject(project));
-  }
-  /**
-   * 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.
-   *
-   * Once all the addon processing is done, go back through all cache entries
-   * to create references between the packageInfo objects.
-   *
-   * @public
-   * @method loadAddon
-   * @param addonInstance the instance of the Addon object to load package data
-   * about into the cache.
-   * @return {PackageInfo} 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.
-   */
-  loadAddon(addonInstance) {
-    // to maintain backwards compatibility for consumers who create a new instance
-    // of the base addon model class directly and don&#x27;t set &#x60;packageRoot&#x60;
-    let pkgInfo = this._readPackage(addonInstance.packageRoot || addonInstance.root, addonInstance.pkg);
-    // NOTE: the returned pkgInfo may contain errors, or may contain
-    // other packages that have errors. We will try to process
-    // things anyway.
-    if (!pkgInfo.processed) {
-      pkgInfo.addon = addonInstance;
-      this._resolveDependencies();
-    }
-    return pkgInfo;
-  }
-  /**
-   * Resolve the node_module dependencies across all packages after they have
-   * been loaded into the cache, because we don&#x27;t know when a particular package
-   * will enter the cache.
-   *
-   * Since loadProject can be called multiple times for different projects,
-   * we don&#x27;t want to reprocess any packages that happen to be common
-   * between them. We&#x27;ll handle this by marking any packageInfo once it
-   * has been processed here, then ignore it in any later processing.
-   *
-   * @private
-   * @method _resolveDependencies
-   */
-  _resolveDependencies() {
-    logger.info(&#x27;Resolving dependencies...&#x27;);
-    let packageInfos = this._getPackageInfos();
-    packageInfos.forEach((pkgInfo) =&gt; {
-      if (!pkgInfo.processed) {
-        let pkgs = pkgInfo.addDependencies(pkgInfo.pkg.dependencies);
-        if (pkgs) {
-          pkgInfo.dependencyPackages = pkgs;
-        }
-        // for Projects only, we also add the devDependencies
-        if (pkgInfo.project) {
-          pkgs = pkgInfo.addDependencies(pkgInfo.pkg.devDependencies);
-          if (pkgs) {
-            pkgInfo.devDependencyPackages = pkgs;
-          }
-        }
-        pkgInfo.processed = true;
-      }
-    });
-  }
-  /**
-   * Add an entry to the cache.
-   *
-   * @private
-   * @method _addEntry
-   */
-  _addEntry(path, entry) {
-    this.entries[path] = entry;
-  }
-  /**
-   * Retrieve an entry from the cache.
-   *
-   * @public
-   * @method getEntry
-   * @param {String} path the real path whose PackageInfo or NodeModulesList is desired.
-   * @return {PackageInfo} or {NodeModulesList} the desired entry.
-   */
-  getEntry(path) {
-    return this.entries[path];
-  }
-  /**
-   * Indicate if an entry for a given path exists in the cache.
-   *
-   * @public
-   * @method contains
-   * @param {String} path the real path to check for in the cache.
-   * @return true if the entry is present for the given path, false otherwise.
-   */
-  contains(path) {
-    return this.entries[path] !== undefined;
-  }
-  _getPackageInfos() {
-    let result = [];
-    Object.keys(this.entries).forEach((path) =&gt; {
-      let entry = this.entries[path];
-      if (entry instanceof PackageInfo) {
-        result.push(entry);
-      }
-    });
-    return result;
-  }
-  /*
-   * Find a PackageInfo cache entry with the given path. If there is
-   * no entry in the startPath, do as done in resolve.sync() - travel up
-   * the directory hierarchy, attaching &#x27;node_modules&#x27; to each directory and
-   * seeing if the directory exists and has the relevant entry.
-   *
-   * We&#x27;ll do things a little differently, though, for speed.
-   *
-   * If there is no cache entry, we&#x27;ll try to use _readNodeModulesList to create
-   * a new cache entry and its contents. If the directory does not exist,
-   * We&#x27;ll create a NodeModulesList cache entry anyway, just so we don&#x27;t have
-   * to check with the file system more than once for that directory (we
-   * waste a bit of space, but gain speed by not hitting the file system
-   * again for that path).
-   * Once we have a NodeModulesList, check for the package name, and continue
-   * up the path until we hit the root or the PackageInfo is found.
-   *
-   * @private
-   * @method _findPackage
-   * @param {String} packageName the name/path of the package to search for
-   * @param {String} the path of the directory to start searching from
-   */
-  _findPackage(packageName, startPath) {
-    let parsedPath = path.parse(startPath);
-    let root = parsedPath.root;
-    let currPath = startPath;
-    while (currPath !== root) {
-      let endsWithNodeModules = path.basename(currPath) === &#x27;node_modules&#x27;;
-      let nodeModulesPath = endsWithNodeModules ? currPath : &#x60;${currPath}${path.sep}node_modules&#x60;;
-      let nodeModulesList = this._readNodeModulesList(nodeModulesPath);
-      // _readNodeModulesList only returns a NodeModulesList or null
-      if (nodeModulesList) {
-        let pkg = nodeModulesList.findPackage(packageName);
-        if (pkg) {
-          return pkg;
-        }
-      }
-      currPath = path.dirname(currPath);
-    }
-    return null;
-  }
-  /**
-   * 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&#x27;s possible that the path given to the packageDir is not actually valid,
-   * we&#x27;ll just use the path.resolve() version of that path to search for the
-   * path in the cache, before trying to get the &#x27;real&#x27; 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.
-   *
-   * 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&#x27;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.
-   *
-   * 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&#x27;ll be cached in the PackageInfo itself.
-   *
-   * In summary, only PackageInfo or ErrorEntry will be returned.
-   *
-   * @private
-   * @method _readPackage
-   * @param {String} pkgDir the path of the directory to read the package.json from and
-   *  process the contents and create a new cache entry or entries.
-   * @param {Boolean} isRoot, for when this is to be considered the root
-   * package, whose dependencies we must all consider for discovery.
-   */
-  _readPackage(packageDir, pkg, isRoot) {
-    let normalizedPackageDir = path.normalize(packageDir);
-    // Most of the time, normalizedPackageDir is already a real path (i.e. fs.realpathSync
-    // will return the same value as normalizedPackageDir if the dir actually exists).
-    // Because of that, we&#x27;ll assume we can test for normalizedPackageDir first and return
-    // if we find it.
-    let pkgInfo = this.getEntry(normalizedPackageDir);
-    if (pkgInfo) {
-      return pkgInfo;
-    }
-    // collect errors we hit while trying to create the PackageInfo object.
-    // We&#x27;ll load these into the object once it&#x27;s created.
-    let setupErrors = new ErrorList();
-    // We don&#x27;t already have an entry (bad or otherwise) at normalizedPackageDir. See if
-    // we can actually find a real path (including resolving links if needed).
-    let pathFailed = false;
-    let realPath = getRealDirectoryPath(normalizedPackageDir);
-    if (realPath) {
-      if (realPath !== normalizedPackageDir) {
-        // getRealDirectoryPath actually changed something in the path (e.g.
-        // by resolving a symlink), so see if we have this entry.
-        pkgInfo = this.getEntry(realPath);
-        if (pkgInfo) {
-          return pkgInfo;
-        }
-      } else {
-        // getRealDirectoryPath is same as normalizedPackageDir, and we know already we
-        // don&#x27;t have an entry there, so we need to create one.
-      }
-    } else {
-      // no realPath, so either nothing is at the path or it&#x27;s not a directory.
-      // We need to use normalizedPackageDir as the real path.
-      pathFailed = true;
-      setupErrors.addError(Errors.ERROR_PACKAGE_DIR_MISSING, normalizedPackageDir);
-      realPath = normalizedPackageDir;
-    }
-    // at this point we have realPath set, we don&#x27;t already have a PackageInfo
-    // for the path, and the path may or may not actually correspond to a
-    // valid directory (pathFailed tells us which). If we don&#x27;t have a pkg
-    // object already, we need to be able to read one, unless we also don&#x27;t
-    // have a path.
-    if (!pkg) {
-      if (!pathFailed) {
-        // we have a valid realPath
-        let packageJsonPath = path.join(realPath, PACKAGE_JSON);
-        let pkgfile = getRealFilePath(packageJsonPath);
-        if (pkgfile) {
-          try {
-            pkg = fs.readJsonSync(pkgfile);
-          } catch (e) {
-            setupErrors.addError(Errors.ERROR_PACKAGE_JSON_PARSE, pkgfile);
-          }
-        } else {
-          setupErrors.addError(Errors.ERROR_PACKAGE_JSON_MISSING, packageJsonPath);
-        }
-      }
-      // Some error has occurred resulting in no pkg object, so just
-      // create an empty one so we have something to use below.
-      if (!pkg) {
-        pkg = Object.create(null);
-      }
-    }
-    // For storage, force the pkg.root to the calculated path. This will
-    // save us from issues where we have a package for a non-existing
-    // path and other stuff.
-    pkg.root = realPath;
-    // Create a new PackageInfo and load any errors as needed.
-    // Note that pkg may be an empty object here.
-    logger.info(&#x27;Creating new PackageInfo instance for %o at %o&#x27;, pkg.name, realPath);
-    pkgInfo = new PackageInfo(pkg, realPath, this, isRoot);
-    if (setupErrors.hasErrors()) {
-      pkgInfo.errors = setupErrors;
-      pkgInfo.valid = false;
-    }
-    // If we have an ember-addon, check that the main exists and points
-    // to a valid file.
-    if (pkgInfo.isForAddon()) {
-      logger.info(&#x27;%s is an addon&#x27;, pkg.name);
-      // Note: when we have both &#x27;main&#x27; and ember-addon:main, the latter takes precedence
-      let main = (pkg[&#x27;ember-addon&#x27;] &amp;&amp; pkg[&#x27;ember-addon&#x27;].main) || pkg[&#x27;main&#x27;];
-      if (!main || main === &#x27;.&#x27; || main === &#x27;./&#x27;) {
-        main = &#x27;index.js&#x27;;
-      } else if (!path.extname(main)) {
-        main = &#x60;${main}.js&#x60;;
-      }
-      logger.info(&#x27;Addon entry point is %o&#x27;, main);
-      pkg.main = main;
-      let mainPath = path.join(realPath, main);
-      let mainRealPath = getRealFilePath(mainPath);
-      if (mainRealPath) {
-        pkgInfo.addonMainPath = mainRealPath;
-      } else {
-        pkgInfo.addError(Errors.ERROR_EMBER_ADDON_MAIN_MISSING, mainPath);
-        this.valid = false;
-      }
-    }
-    // The packageInfo itself is now &quot;complete&quot;, though we have not
-    // yet dealt with any of its &quot;child&quot; packages. Add it to the
-    // cache
-    this._addEntry(realPath, pkgInfo);
-    let emberAddonInfo = pkg[&#x27;ember-addon&#x27;];
-    // Set up packageInfos for any in-repo addons
-    if (emberAddonInfo) {
-      let paths = emberAddonInfo.paths;
-      if (paths) {
-        paths.forEach((p) =&gt; {
-          let addonPath = path.join(realPath, p); // real path, though may not exist.
-          logger.info(&#x27;Adding in-repo-addon at %o&#x27;, addonPath);
-          let addonPkgInfo = this._readPackage(addonPath); // may have errors in the addon package.
-          pkgInfo.addInRepoAddon(addonPkgInfo);
-        });
-      }
-    }
-    if (pkgInfo.mayHaveAddons) {
-      logger.info(&#x27;Reading &quot;node_modules&quot; for %o&#x27;, realPath);
-      // read addon modules from node_modules. We read the whole directory
-      // because it&#x27;s assumed that npm/yarn may have placed addons in the
-      // directory from lower down in the project tree, and we want to get
-      // the data into the cache ASAP. It may not necessarily be a &#x27;real&#x27; error
-      // if we find an issue, if nobody below is actually invoking the addon.
-      let nodeModules = this._readNodeModulesList(path.join(realPath, &#x27;node_modules&#x27;));
-      if (nodeModules) {
-        pkgInfo.nodeModules = nodeModules;
-      }
-    } else {
-      // will not have addons, so even if there are node_modules here, we can
-      // simply pretend there are none.
-      pkgInfo.nodeModules = NodeModulesList.NULL;
-    }
-    return pkgInfo;
-  }
-  /**
-   * Process a directory of modules in a given package directory.
-   *
-   * We will allow cache entries for node_modules that actually
-   * have no contents, just so we don&#x27;t have to hit the file system more
-   * often than necessary--it&#x27;s much quicker to check an in-memory object.
-   * object.
-   *
-   * Note: only a NodeModulesList or null is returned.
-   *
-   * @private
-   * @method _readModulesList
-   * @param {String} nodeModulesDir 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.
-   */
-  _readNodeModulesList(nodeModulesDir) {
-    let normalizedNodeModulesDir = path.normalize(nodeModulesDir);
-    // Much of the time, normalizedNodeModulesDir is already a real path (i.e.
-    // fs.realpathSync will return the same value as normalizedNodeModulesDir, if
-    // the directory actually exists). Because of that, we&#x27;ll assume
-    // we can test for normalizedNodeModulesDir first and return if we find it.
-    let nodeModulesList = this.getEntry(normalizedNodeModulesDir);
-    if (nodeModulesList) {
-      return nodeModulesList;
-    }
-    // NOTE: because we call this when searching for objects in node_modules
-    // directories that may not exist, we&#x27;ll just return null here if the
-    // directory is not real. If it actually is an error in some case,
-    // the caller can create the error there.
-    let realPath = getRealDirectoryPath(normalizedNodeModulesDir);
-    if (!realPath) {
-      return null;
-    }
-    // realPath may be different than the original normalizedNodeModulesDir, so
-    // we need to check the cache again.
-    if (realPath !== normalizedNodeModulesDir) {
-      nodeModulesList = this.getEntry(realPath);
-      if (nodeModulesList) {
-        return nodeModulesList;
-      }
-    } else {
-      // getRealDirectoryPath is same as normalizedPackageDir, and we know already we
-      // don&#x27;t have an entry there, so we need to create one.
-    }
-    // At this point we know the directory node_modules exists and we can
-    // process it. Further errors will be recorded here, or in the objects
-    // that correspond to the node_modules entries.
-    logger.info(&#x27;Creating new NodeModulesList instance for %o&#x27;, realPath);
-    nodeModulesList = new NodeModulesList(realPath, this);
-    const entries = fs.readdirSync(realPath).filter((fileName) =&gt; {
-      if (fileName.startsWith(&#x27;.&#x27;) || fileName.startsWith(&#x27;_&#x27;)) {
-        // we explicitly want to ignore these, according to the
-        // definition of a valid package name.
-        return false;
-      } else if (fileName.startsWith(&#x27;@&#x27;)) {
-        return true;
-      } else if (!fs.existsSync(&#x60;${realPath}/${fileName}/package.json&#x60;)) {
-        // a node_module is only valid if it contains a package.json
-        return false;
-      } else {
-        return true;
-      }
-    }); // should not fail because getRealDirectoryPath passed
-    entries.forEach((entryName) =&gt; {
-      // entries should be either a package or a scoping directory. I think
-      // there can also be files, but we&#x27;ll ignore those.
-      let entryPath = path.join(realPath, entryName);
-      if (getRealFilePath(entryPath)) {
-        // we explicitly want to ignore valid regular files in node_modules.
-        // This is a bit slower than just checking for directories, but we need to be sure.
-        return;
-      }
-      // At this point we have an entry name that should correspond to
-      // a directory, which should turn into either a NodeModulesList or
-      // PackageInfo. If not, it&#x27;s an error on this NodeModulesList.
-      let entryVal;
-      if (entryName.startsWith(&#x27;@&#x27;)) {
-        // we should have a scoping directory.
-        entryVal = this._readNodeModulesList(entryPath);
-        // readModulesDir only returns NodeModulesList or null
-        if (entryVal instanceof NodeModulesList) {
-          nodeModulesList.addEntry(entryName, entryVal);
-        } else {
-          // This (null return) really should not occur, unless somehow the
-          // dir disappears between the time of fs.readdirSync and now.
-          nodeModulesList.addError(Errors.ERROR_NODEMODULES_ENTRY_MISSING, entryName);
-        }
-      } else {
-        // we should have a package. We will always get a PackageInfo
-        // back, though it may contain errors.
-        entryVal = this._readPackage(entryPath);
-        nodeModulesList.addEntry(entryName, entryVal);
-      }
-    });
-    this._addEntry(realPath, nodeModulesList);
-    return nodeModulesList;
-  }
-}
-module.exports = PackageInfoCache;
-</pre>
-</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>