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/files/lib_models_package-info-cache_package-info.js.html DELETED Viewed

@@ -1,661 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8">
-    <title>lib/models/package-info-cache/package-info.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-release-b4cbb1029f
-            </div>
-        </div>
-        <div id="main" class="yui3-u">
-            <div class="content"><div class="title">
-  <h1 class="file-name">lib/models/package-info-cache/package-info.js</h1>
-</div>
-<pre class="code prettyprint linenums">
-&#x27;use strict&#x27;;
-const path = require(&#x27;path&#x27;);
-const ErrorList = require(&#x27;./error-list&#x27;);
-const Errors = require(&#x27;./errors&#x27;);
-const AddonInfo = require(&#x27;../addon-info&#x27;);
-const isAddon = require(&#x27;../../utilities/is-addon&#x27;);
-const isEngine = require(&#x27;../../utilities/is-engine&#x27;);
-const isLazyEngine = require(&#x27;../../utilities/is-lazy-engine&#x27;);
-const logger = require(&#x27;heimdalljs-logger&#x27;)(&#x27;ember-cli:package-info-cache:package-info&#x27;);
-const PerBundleAddonCache = require(&#x27;../per-bundle-addon-cache&#x27;);
-function lexicographically(a, b) {
-  const aIsString = typeof a.name === &#x27;string&#x27;;
-  const bIsString = typeof b.name === &#x27;string&#x27;;
-  if (aIsString &amp;&amp; bIsString) {
-    return a.name.localeCompare(b.name);
-  } else if (aIsString) {
-    return -1;
-  } else if (bIsString) {
-    return 1;
-  } else {
-    return 0;
-  }
-}
-function pushUnique(array, entry) {
-  const index = array.indexOf(entry);
-  if (index &gt; -1) {
-    // the entry already exists in the array, but since the presedence between
-    // addons is &quot;last right wins&quot;. We first remove the duplicate entry, and
-    // append it to the end of the array.
-    array.splice(index, 1);
-  }
-  // At this point, the entry is not in the array. So we must append it.
-  array.push(entry);
-  // All this ensures:
-  // pushUnique([a1,a2,a3], a1)
-  // results in:
-  //
-  // [a2, a3, a1]
-  //
-  // which results in the most &quot;least surprising&quot; addon ordering.
-}
-/**
- * Class that stores information about a single package (directory tree with
- * a package.json and other data, like and Addon or Project.) It is one of the
- * two types of entries in a PackageInfoCache. It is only created by the
- * PackageInfoCache.
- *
- * @public
- * @class PackageInfo
- */
-class PackageInfo {
-  constructor(pkgObj, realPath, cache, isRoot = false) {
-    this.pkg = pkgObj;
-    this.pkg[&#x27;ember-addon&#x27;] = this.pkg[&#x27;ember-addon&#x27;] || {};
-    this.realPath = realPath;
-    this.cache = cache;
-    this.errors = new ErrorList();
-    // other fields that will be set as needed. For JIT we&#x27;ll define
-    // them here.
-    this.addonMainPath = undefined; // addons only
-    this.inRepoAddons = undefined; // (list of PackageInfo - both)
-    this.internalAddons = undefined; // (list of PackageInfo - project only)
-    this.cliInfo = undefined; // (PackageInfo - project only)
-    this.dependencyPackages = undefined; // (obj keyed by dependency name: PackageInfo)
-    // NOTE: ALL dependencies, not just addons
-    this.devDependencyPackages = undefined; // (obj keyed by devDependency name: PackageInfo)
-    // NOTE: these are ALL dependencies, not just addons
-    this.nodeModules = undefined; // (NodeModulesList, set only if pkg contains node_modules)
-    // flag indicating that the packageInfo is considered valid. This will
-    // be true as long as we have a valid directory and our package.json file
-    // is okay and, if we&#x27;re an ember addon, that we have a valid &#x27;main&#x27; file.
-    // Missing dependencies will not be considered an error, since they may
-    // not actually be used.
-    this.valid = true;
-    this.mayHaveAddons = isRoot || this.isForAddon(); // mayHaveAddons used in index.js
-    this._hasDumpedInvalidAddonPackages = false;
-  }
-  // Make various fields of the pkg object available.
-  get name() {
-    return this.pkg.name;
-  }
-  /**
-   * Given error data, add an ErrorEntry to the ErrorList for this object.
-   * This is used by the _readPackage and _readNodeModulesList methods. It
-   * should not be called otherwise.
-   *
-   * @protected
-   * @method addError
-   * @param {String} errorType one of the Errors.ERROR_* constants.
-   * @param {Object} errorData any error data relevant to the type of error
-   * being created. See showErrors().
-   */
-  addError(errorType, errorData) {
-    this.errors.addError(errorType, errorData);
-  }
-  /**
-   * Indicate if there are any errors in the ErrorList for this package. Note that this does
-   * NOT indicate if there are any errors in the objects referred to by this package (e.g.,
-   * internal addons or dependencies).
-   *
-   * @public
-   * @method hasErrors
-   * @param {boolean} true if there are errors in the ErrorList, else false.
-   */
-  hasErrors() {
-    return this.errors.hasErrors();
-  }
-  /**
-   * Add a reference to an in-repo addon PackageInfo object.
-   *
-   * @protected
-   * @method addInRepoAddon
-   * @param {PackageInfo} inRepoAddonPkg the PackageInfo for the in-repo addon
-   * @return null
-   */
-  addInRepoAddon(inRepoAddonPkg) {
-    if (!this.inRepoAddons) {
-      this.inRepoAddons = [];
-    }
-    this.inRepoAddons.push(inRepoAddonPkg);
-  }
-  /**
-   * Add a reference to an internal addon PackageInfo object.
-   * &quot;internal&quot; addons (note: not in-repo addons) only exist in
-   * Projects, not other packages. Since the cache is loaded from
-   * &#x27;loadProject&#x27;, this can be done appropriately.
-   *
-   * @protected
-   * @method addInternalAddon
-   * @param {PackageInfo} internalAddonPkg the PackageInfo for the internal addon
-   * @return null
-   */
-  addInternalAddon(internalAddonPkg) {
-    if (!this.internalAddons) {
-      this.internalAddons = [];
-    }
-    this.internalAddons.push(internalAddonPkg);
-  }
-  /**
-   * For each dependency in the given list, find the corresponding
-   * PackageInfo object in the cache (going up the file tree if
-   * necessary, as in the node resolution algorithm). Return a map
-   * of the dependencyName to PackageInfo object. Caller can then
-   * store it wherever they like.
-   *
-   * Note: this is not to be  called until all packages that can be have
-   * been added to the cache.
-   *
-   * Note: this is for ALL dependencies, not just addons. To get just
-   * addons, filter the result by calling pkgInfo.isForAddon().
-   *
-   * Note: this is only intended for use from PackageInfoCache._resolveDependencies.
-   * It is not to be called directly by anything else.
-   *
-   * @protected
-   * @method addDependencies
-   * @param {PackageInfo} dependencies value of &#x27;dependencies&#x27; or &#x27;devDependencies&#x27;
-   *        attributes of a package.json.
-   * @return {Object} a JavaScript object keyed on dependency name/path with
-   *    values the corresponding PackageInfo object from the cache.
-   */
-  addDependencies(dependencies) {
-    if (!dependencies) {
-      return null;
-    }
-    let dependencyNames = Object.keys(dependencies);
-    if (dependencyNames.length === 0) {
-      return null;
-    }
-    let packages = Object.create(null);
-    let missingDependencies = [];
-    dependencyNames.forEach((dependencyName) =&gt; {
-      logger.info(&#x27;%s: Trying to find dependency %o&#x27;, this.pkg.name, dependencyName);
-      let dependencyPackage;
-      // much of the time the package will have dependencies in
-      // a node_modules inside it, so check there first because it&#x27;s
-      // quicker since we have the reference. Only check externally
-      // if we don&#x27;t find it there.
-      if (this.nodeModules) {
-        dependencyPackage = this.nodeModules.findPackage(dependencyName);
-      }
-      if (!dependencyPackage) {
-        dependencyPackage = this.cache._findPackage(dependencyName, path.dirname(this.realPath));
-      }
-      if (dependencyPackage) {
-        packages[dependencyName] = dependencyPackage;
-      } else {
-        missingDependencies.push(dependencyName);
-      }
-    });
-    if (missingDependencies.length &gt; 0) {
-      this.addError(Errors.ERROR_DEPENDENCIES_MISSING, missingDependencies);
-    }
-    return packages;
-  }
-  /**
-   * Indicate if this packageInfo is for a project. Should be called only after the project
-   * has been loaded (see {@link PackageInfoCache#loadProject} for details).
-   *
-   * @method isForProject
-   * @return {Boolean} true if this packageInfo is for a Project, false otherwise.
-   */
-  isForProject() {
-    return !!this.project &amp;&amp; this.project.isEmberCLIProject &amp;&amp; this.project.isEmberCLIProject();
-  }
-  /**
-   * Indicate if this packageInfo is for an Addon.
-   *
-   * @method isForAddon
-   * @return {Boolean} true if this packageInfo is for an Addon, false otherwise.
-   */
-  isForAddon() {
-    return isAddon(this.pkg.keywords);
-  }
-  /**
-   * Indicate if this packageInfo represents an engine.
-   *
-   * @method isForEngine
-   * @return {Boolean} true if this pkgInfo is configured as an engine &amp; false otherwise
-   */
-  isForEngine() {
-    return isEngine(this.pkg.keywords);
-  }
-  /**
-   * Indicate if this packageInfo represents a lazy engine.
-   *
-   * @method isForLazyEngine
-   * @return {Boolean} true if this pkgInfo is configured as an engine and the
-   * module this represents has lazyLoading enabled, false otherwise.
-   */
-  isForLazyEngine() {
-    return this.isForEngine() &amp;&amp; isLazyEngine(this._getAddonEntryPoint());
-  }
-  /**
-   * For use with the PerBundleAddonCache, is this packageInfo representing a
-   * bundle host (for now, a Project or a lazy engine).
-   *
-   * @method isForBundleHost
-   * @return {Boolean} true if this pkgInfo is for a bundle host, false otherwise.
-   */
-  isForBundleHost() {
-    return this.isForProject() || this.isForLazyEngine();
-  }
-  /**
-   * Add to a list of child addon PackageInfos for this packageInfo.
-   *
-   * @method addPackages
-   * @param {Array} addonPackageList the list of child addon PackageInfos being constructed from various
-   * sources in this packageInfo.
-   * @param {Array | Object} packageInfoList a list or map of PackageInfos being considered
-   * (e.g., pkgInfo.dependencyPackages) for inclusion in the addonPackageList.
-   * @param {Function} excludeFn an optional function. If passed in, each child PackageInfo
-   * will be tested against the function and only included in the package map if the function
-   * returns a truthy value.
-   */
-  addPackages(addonPackageList, packageInfoList, excludeFn) {
-    if (!packageInfoList) {
-      return;
-    }
-    let result = [];
-    if (Array.isArray(packageInfoList)) {
-      if (excludeFn) {
-        packageInfoList = packageInfoList.filter((pkgInfo) =&gt; !excludeFn(pkgInfo));
-      }
-      packageInfoList.forEach((pkgInfo) =&gt; result.push(pkgInfo));
-    } else {
-      // We&#x27;re going to assume we have a map of name to packageInfo
-      Object.keys(packageInfoList).forEach((name) =&gt; {
-        let pkgInfo = packageInfoList[name];
-        if (!excludeFn || !excludeFn(pkgInfo)) {
-          result.push(pkgInfo);
-        }
-      });
-    }
-    result.sort(lexicographically).forEach((pkgInfo) =&gt; pushUnique(addonPackageList, pkgInfo));
-    return addonPackageList;
-  }
-  /**
-   * Discover the child addons for this packageInfo, which corresponds to an Addon.
-   *
-   * @method discoverAddonAddons
-   */
-  discoverAddonAddons() {
-    let addonPackageList = [];
-    this.addPackages(
-      addonPackageList,
-      this.dependencyPackages,
-      (pkgInfo) =&gt; !pkgInfo.isForAddon() || pkgInfo.name === &#x27;ember-cli&#x27;
-    );
-    this.addPackages(addonPackageList, this.inRepoAddons);
-    return addonPackageList;
-  }
-  /**
-   * Discover the child addons for this packageInfo, which corresponds to a Project.
-   *
-   * @method discoverProjectAddons
-   */
-  discoverProjectAddons() {
-    let project = this.project;
-    let addonPackageList = [];
-    this.addPackages(addonPackageList, project.isEmberCLIAddon() ? [this] : null);
-    this.addPackages(addonPackageList, this.cliInfo ? this.cliInfo.inRepoAddons : null);
-    this.addPackages(addonPackageList, this.internalAddons);
-    this.addPackages(addonPackageList, this.devDependencyPackages, (pkgInfo) =&gt; !pkgInfo.isForAddon());
-    this.addPackages(addonPackageList, this.dependencyPackages, (pkgInfo) =&gt; !pkgInfo.isForAddon());
-    this.addPackages(addonPackageList, this.inRepoAddons);
-    return addonPackageList;
-  }
-  /**
-   * Given a list of PackageInfo objects, generate the &#x27;addonPackages&#x27; object (keyed by
-   * name, value = AddonInfo instance, for all packages marked &#x27;valid&#x27;). This is stored in
-   * both Addon and Project instances.
-   *
-   * @method generateAddonPackages
-   * @param {Array} addonPackageList the list of child addon PackageInfos to work from
-   * @param {Function} excludeFn an optional function. If passed in, each child PackageInfo
-   * will be tested against the function and only included in the package map if the function
-   * returns a truthy value.
-   */
-  generateAddonPackages(addonPackageList, excludeFn) {
-    let validPackages = this.getValidPackages(addonPackageList);
-    let packageMap = Object.create(null);
-    validPackages.forEach((pkgInfo) =&gt; {
-      let addonInfo = new AddonInfo(pkgInfo.name, pkgInfo.realPath, pkgInfo.pkg);
-      if (!excludeFn || !excludeFn(addonInfo)) {
-        packageMap[pkgInfo.name] = addonInfo;
-      }
-    });
-    return packageMap;
-  }
-  getValidPackages(addonPackageList) {
-    return addonPackageList.filter((pkgInfo) =&gt; pkgInfo.valid);
-  }
-  getInvalidPackages(addonPackageList) {
-    return addonPackageList.filter((pkgInfo) =&gt; !pkgInfo.valid);
-  }
-  dumpInvalidAddonPackages(addonPackageList) {
-    if (this._hasDumpedInvalidAddonPackages) {
-      return;
-    }
-    this._hasDumpedInvalidAddonPackages = true;
-    let invalidPackages = this.getInvalidPackages(addonPackageList);
-    if (invalidPackages.length &gt; 0) {
-      let typeName = this.project ? &#x27;project&#x27; : &#x27;addon&#x27;;
-      let msg = &#x60;The &#x27;package.json&#x27; file for the ${typeName} at ${this.realPath}&#x60;;
-      let relativePath;
-      if (invalidPackages.length === 1) {
-        relativePath = path.relative(this.realPath, invalidPackages[0].realPath);
-        msg = &#x60;${msg}\n  specifies an invalid, malformed or missing addon at relative path &#x27;${relativePath}&#x27;&#x60;;
-      } else {
-        msg = &#x60;${msg}\n  specifies invalid, malformed or missing addons at relative paths&#x60;;
-        invalidPackages.forEach((packageInfo) =&gt; {
-          let relativePath = path.relative(this.realPath, packageInfo.realPath);
-          msg = &#x60;${msg}\n    &#x27;${relativePath}&#x27;&#x60;;
-        });
-      }
-      if (process.env.EMBER_CLI_ERROR_ON_INVALID_ADDON) {
-        throw msg;
-      } else {
-        this.cache.ui.writeWarnLine(msg);
-      }
-    }
-  }
-  /**
-   * This is only supposed to be called by the addon instantiation code.
-   * Also, the assumption here is that this PackageInfo really is for an
-   * Addon, so we don&#x27;t need to check each time.
-   *
-   * @private
-   * @method getAddonConstructor
-   * @return {AddonConstructor} an instance of a constructor function for the Addon class
-   * whose package information is stored in this object.
-   */
-  getAddonConstructor() {
-    if (this.addonConstructor) {
-      return this.addonConstructor;
-    }
-    let module = this._getAddonEntryPoint();
-    let mainDir = path.dirname(this.addonMainPath);
-    let ctor;
-    if (typeof module === &#x27;function&#x27;) {
-      ctor = module;
-      ctor.prototype.root = ctor.prototype.root || mainDir;
-      ctor.prototype.packageRoot = ctor.prototype.packageRoot || this.realPath;
-      ctor.prototype.pkg = ctor.prototype.pkg || this.pkg;
-    } else {
-      const Addon = require(&#x27;../addon&#x27;); // done here because of circular dependency
-      ctor = Addon.extend(Object.assign({ root: mainDir, packageRoot: this.realPath, pkg: this.pkg }, module));
-    }
-    ctor._meta_ = {
-      modulePath: this.addonMainPath,
-    };
-    return (this.addonConstructor = ctor);
-  }
-  /**
-   * Construct an addon instance.
-   *
-   * NOTE: this does NOT call constructors for the child addons. That is left to
-   * the caller to do, so they can insert any other logic they want.
-   *
-   * @private
-   * @method constructAddonInstance
-   * @param {Project|Addon} parent the parent that directly contains this addon
-   * @param {Project} project the project that is/contains this addon
-   */
-  constructAddonInstance(parent, project) {
-    let start = Date.now();
-    let AddonConstructor = this.getAddonConstructor();
-    let addonInstance;
-    try {
-      addonInstance = new AddonConstructor(parent, project);
-    } catch (e) {
-      if (parent &amp;&amp; parent.ui) {
-        parent.ui.writeError(e);
-      }
-      const SilentError = require(&#x27;silent-error&#x27;);
-      throw new SilentError(&#x60;An error occurred in the constructor for ${this.name} at ${this.realPath}&#x60;);
-    }
-    AddonConstructor._meta_.initializeIn = Date.now() - start;
-    addonInstance.constructor = AddonConstructor;
-    return addonInstance;
-  }
-  /**
-   * Create an instance of the addon represented by this packageInfo or (if we
-   * are supporting per-bundle caching and this is an allow-caching-per-bundle addon)
-   * check if we should be creating a proxy instead.
-   *
-   * NOTE: we assume that the value of &#x27;allowCachingPerBundle&#x27; does not change between
-   * calls to the constructor! A given addon is either allowing or not allowing caching
-   * for an entire run.
-   *
-   * @method getAddonInstance
-   * @param {} parent the addon/project that is to be the direct parent of the
-   * addon instance created here
-   * @param {*} project the project that is to contain this addon instance
-   * @return {Object} the constructed instance of the addon
-   */
-  getAddonInstance(parent, project) {
-    let addonEntryPointModule = this._getAddonEntryPoint();
-    let addonInstance;
-    if (
-      PerBundleAddonCache.isEnabled() &amp;&amp;
-      project &amp;&amp;
-      project.perBundleAddonCache.allowCachingPerBundle(addonEntryPointModule)
-    ) {
-      addonInstance = project.perBundleAddonCache.getAddonInstance(parent, this);
-    } else {
-      addonInstance = this.constructAddonInstance(parent, project);
-      this.initChildAddons(addonInstance);
-    }
-    return addonInstance;
-  }
-  /**
-   * Initialize the child addons array of a newly-created addon instance. Normally when
-   * an addon derives from Addon, child addons will be created during &#x27;setupRegistry&#x27; and
-   * this code is essentially unnecessary. But if an addon is created with custom constructors
-   * that don&#x27;t call &#x27;setupRegistry&#x27;, any child addons may not yet be initialized.
-   *
-   * @method initChildAddons
-   * @param {Addon} addonInstance
-   */
-  initChildAddons(addonInstance) {
-    if (addonInstance.initializeAddons) {
-      addonInstance.initializeAddons();
-    } else {
-      addonInstance.addons = [];
-    }
-  }
-  /**
-   * Gets the addon entry point
-   *
-   * @method _getAddonEntryPoint
-   * @return {Object|Function} The exported addon entry point
-   * @private
-   */
-  _getAddonEntryPoint() {
-    if (!this.addonMainPath) {
-      throw new Error(&#x60;${this.pkg.name} at ${this.realPath} is missing its addon main file&#x60;);
-    }
-    // Load the addon.
-    // TODO: Future work - allow a time budget for loading each addon and warn
-    // or error for those that take too long.
-    return require(this.addonMainPath);
-  }
-}
-module.exports = PackageInfo;
-module.exports.lexicographically = lexicographically;
-module.exports.pushUnique = pushUnique;
-</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>