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

ember-cli 4.0.0 → 4.1.0-beta.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 (107) hide show

package/.github/workflows/ci.yml +4 -4
package/CHANGELOG.md +17 -2
package/blueprints/app/files/package.json +2 -2
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/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/classes/PackageInfo.html DELETED Viewed

@@ -1,1390 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8">
-    <title>PackageInfo - 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">PackageInfo</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_addPackages">addPackages</a></li>
-                      <li><a href="#method_discoverAddonAddons">discoverAddonAddons</a></li>
-                      <li><a href="#method_discoverProjectAddons">discoverProjectAddons</a></li>
-                      <li><a href="#method_generateAddonPackages">generateAddonPackages</a></li>
-                      <li><a href="#method_getAddonInstance">getAddonInstance</a></li>
-                      <li><a href="#method_hasErrors">hasErrors</a></li>
-                      <li><a href="#method_initChildAddons">initChildAddons</a></li>
-                      <li><a href="#method_isForAddon">isForAddon</a></li>
-                      <li><a href="#method_isForBundleHost">isForBundleHost</a></li>
-                      <li><a href="#method_isForEngine">isForEngine</a></li>
-                      <li><a href="#method_isForLazyEngine">isForLazyEngine</a></li>
-                      <li><a href="#method_isForProject">isForProject</a></li>
-                  </ul>
-                  <div><a href="#protected-methods">Protected Methods</a></div>
-                  <ul>
-                      <li><a href="#method_addDependencies">addDependencies</a></li>
-                      <li><a href="#method_addError">addError</a></li>
-                      <li><a href="#method_addInRepoAddon">addInRepoAddon</a></li>
-                      <li><a href="#method_addInternalAddon">addInternalAddon</a></li>
-                  </ul>
-                  <div><a href="#private-methods">Private Methods</a></div>
-                  <ul>
-                      <li><a href="#method__getAddonEntryPoint">_getAddonEntryPoint</a></li>
-                      <li><a href="#method_constructAddonInstance">constructAddonInstance</a></li>
-                      <li><a href="#method_getAddonConstructor">getAddonConstructor</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_package-info.js.html#l50"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:50</code></a></span>
-    <h1 class="class-name">PackageInfo</h1>
-</div>
-<div class="class-description"><p>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.</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_addPackages">addPackages</a>(addonPackageList, packageInfoList, excludeFn)
-            </div>
-            <div class="short-description">
-              <p>Add to a list of child addon PackageInfos for this packageInfo.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_discoverAddonAddons">discoverAddonAddons</a>( )
-            </div>
-            <div class="short-description">
-              <p>Discover the child addons for this packageInfo, which corresponds to an Addon.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_discoverProjectAddons">discoverProjectAddons</a>( )
-            </div>
-            <div class="short-description">
-              <p>Discover the child addons for this packageInfo, which corresponds to a Project.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_generateAddonPackages">generateAddonPackages</a>(addonPackageList, excludeFn)
-            </div>
-            <div class="short-description">
-              <p>Given a list of PackageInfo objects, generate the 'addonPackages' object (keyed by name, value = AddonInfo instance, for all packages marked 'valid'). This is stored in both Addon and Project instances.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_getAddonInstance">getAddonInstance</a>(parent, project): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a>
-            </div>
-            <div class="short-description">
-              <p>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.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_hasErrors">hasErrors</a>(true)
-            </div>
-            <div class="short-description">
-              <p>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).</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_initChildAddons">initChildAddons</a>(addonInstance)
-            </div>
-            <div class="short-description">
-              <p>Initialize the child addons array of a newly-created addon instance. Normally when an addon derives from Addon, child addons will be created during 'setupRegistry' and this code is essentially unnecessary. But if an addon is created with custom constructors that don't call 'setupRegistry', any child addons may not yet be initialized.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_isForAddon">isForAddon</a>( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-            </div>
-            <div class="short-description">
-              <p>Indicate if this packageInfo is for an Addon.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_isForBundleHost">isForBundleHost</a>( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-            </div>
-            <div class="short-description">
-              <p>For use with the PerBundleAddonCache, is this packageInfo representing a bundle host (for now, a Project or a lazy engine).</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_isForEngine">isForEngine</a>( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-            </div>
-            <div class="short-description">
-              <p>Indicate if this packageInfo represents an engine.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_isForLazyEngine">isForLazyEngine</a>( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-            </div>
-            <div class="short-description">
-              <p>Indicate if this packageInfo represents a lazy engine.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            public
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_isForProject">isForProject</a>( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-            </div>
-            <div class="short-description">
-              <p>Indicate if this packageInfo is for a project. Should be called only after the project has been loaded (see {@link PackageInfoCache#loadProject} for details).</p>
-            </div>
-          </td>
-        </tr>
-      </tbody>
-    </table>
-    <table class="summary">
-      <thead>
-      <tr>
-        <th colspan="2">Protected Methods</th>
-      </tr>
-      </thead>
-      <tbody>
-        <tr>
-          <td>
-            protected
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_addDependencies">addDependencies</a>(dependencies): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a>
-            </div>
-            <div class="short-description">
-              <p>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.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            protected
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_addError">addError</a>(errorType, errorData)
-            </div>
-            <div class="short-description">
-              <p>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.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            protected
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_addInRepoAddon">addInRepoAddon</a>(inRepoAddonPkg):
-            </div>
-            <div class="short-description">
-              <p>Add a reference to an in-repo addon PackageInfo object.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            protected
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_addInternalAddon">addInternalAddon</a>(internalAddonPkg):
-            </div>
-            <div class="short-description">
-              <p>Add a reference to an internal addon PackageInfo object. "internal" addons (note: not in-repo addons) only exist in Projects, not other packages. Since the cache is loaded from 'loadProject', this can be done appropriately.</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__getAddonEntryPoint">_getAddonEntryPoint</a>( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="crosslink external" target="_blank">Function</a>
-            </div>
-            <div class="short-description">
-              <p>Gets the addon entry point</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_constructAddonInstance">constructAddonInstance</a>(parent, project)
-            </div>
-            <div class="short-description">
-              <p>Construct an addon instance.</p>
-            </div>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            private
-          </td>
-          <td>
-            <div class="method-name ">
-              <a href="#method_getAddonConstructor">getAddonConstructor</a>( ): AddonConstructor
-            </div>
-            <div class="short-description">
-              <p>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't need to check each time.</p>
-            </div>
-          </td>
-        </tr>
-      </tbody>
-    </table>
-  <div id="methods public">
-    <h2 id="public-methods">Public Methods</h2>
-<div class="method item">
-    <div id="method_addPackages" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l279"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:279</code></a></span>
-        <h3 class="">
-            public
-            addPackages(addonPackageList, packageInfoList, excludeFn)
-        </h3>
-    </div>
-    <div class="method-description"><p>Add to a list of child addon PackageInfos for this packageInfo.</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>addonPackageList</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="crosslink external" target="_blank">Array</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the list of child addon PackageInfos being constructed from various
-sources in this packageInfo.</p>
-</td>
-            </tr>
-            <tr>
-              <td>packageInfoList</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="crosslink external" target="_blank">Array</a> | <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>a list or map of PackageInfos being considered
-(e.g., pkgInfo.dependencyPackages) for inclusion in the addonPackageList.</p>
-</td>
-            </tr>
-            <tr>
-              <td>excludeFn</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="crosslink external" target="_blank">Function</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>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.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_discoverAddonAddons" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l318"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:318</code></a></span>
-        <h3 class="">
-            public
-            discoverAddonAddons( )
-        </h3>
-    </div>
-    <div class="method-description"><p>Discover the child addons for this packageInfo, which corresponds to an Addon.</p>
-</div>
-</div>
-<div class="method item">
-    <div id="method_discoverProjectAddons" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l336"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:336</code></a></span>
-        <h3 class="">
-            public
-            discoverProjectAddons( )
-        </h3>
-    </div>
-    <div class="method-description"><p>Discover the child addons for this packageInfo, which corresponds to a Project.</p>
-</div>
-</div>
-<div class="method item">
-    <div id="method_generateAddonPackages" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l356"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:356</code></a></span>
-        <h3 class="">
-            public
-            generateAddonPackages(addonPackageList, excludeFn)
-        </h3>
-    </div>
-    <div class="method-description"><p>Given a list of PackageInfo objects, generate the 'addonPackages' object (keyed by
-name, value = AddonInfo instance, for all packages marked 'valid'). This is stored in
-both Addon and Project instances.</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>addonPackageList</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="crosslink external" target="_blank">Array</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the list of child addon PackageInfos to work from</p>
-</td>
-            </tr>
-            <tr>
-              <td>excludeFn</td>
-              <td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="crosslink external" target="_blank">Function</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>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.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_getAddonInstance" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l496"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:496</code></a></span>
-        <h3 class="">
-            public
-            getAddonInstance(parent, project): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>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.</p>
-<p>NOTE: we assume that the value of 'allowCachingPerBundle' does not change between
-calls to the constructor! A given addon is either allowing or not allowing caching
-for an entire run.</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>parent</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 addon/project that is to be the direct parent of the
-addon instance created here</p>
-</td>
-            </tr>
-            <tr>
-              <td>project</td>
-              <td></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the project that is to contain this addon instance</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a></span>
-          <span class="return-description"><p>the constructed instance of the addon</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_package-info.js.html#l111"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:111</code></a></span>
-        <h3 class="">
-            public
-            hasErrors(true)
-        </h3>
-    </div>
-    <div class="method-description"><p>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).</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>true</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>if there are errors in the ErrorList, else false.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_initChildAddons" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l529"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:529</code></a></span>
-        <h3 class="">
-            public
-            initChildAddons(addonInstance)
-        </h3>
-    </div>
-    <div class="method-description"><p>Initialize the child addons array of a newly-created addon instance. Normally when
-an addon derives from Addon, child addons will be created during 'setupRegistry' and
-this code is essentially unnecessary. But if an addon is created with custom constructors
-that don't call 'setupRegistry', any child addons may not yet be initialized.</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="../classes/Addon.html" class="crosslink">Addon</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td> </td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_isForAddon" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l237"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:237</code></a></span>
-        <h3 class="">
-            public
-            isForAddon( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Indicate if this packageInfo is for an Addon.</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a></span>
-          <span class="return-description"><p>true if this packageInfo is for an Addon, false otherwise.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_isForBundleHost" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l268"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:268</code></a></span>
-        <h3 class="">
-            public
-            isForBundleHost( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>For use with the PerBundleAddonCache, is this packageInfo representing a
-bundle host (for now, a Project or a lazy engine).</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a></span>
-          <span class="return-description"><p>true if this pkgInfo is for a bundle host, false otherwise.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_isForEngine" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l247"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:247</code></a></span>
-        <h3 class="">
-            public
-            isForEngine( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Indicate if this packageInfo represents an engine.</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a></span>
-          <span class="return-description"><p>true if this pkgInfo is configured as an engine &amp; false otherwise</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_isForLazyEngine" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l257"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:257</code></a></span>
-        <h3 class="">
-            public
-            isForLazyEngine( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Indicate if this packageInfo represents a lazy engine.</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a></span>
-          <span class="return-description"><p>true if this pkgInfo is configured as an engine and the
-module this represents has lazyLoading enabled, false otherwise.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item">
-    <div id="method_isForProject" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l226"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:226</code></a></span>
-        <h3 class="">
-            public
-            isForProject( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Indicate if this packageInfo is for a project. Should be called only after the project
-has been loaded (see {@link PackageInfoCache#loadProject} for details).</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" class="crosslink external" target="_blank">Boolean</a></span>
-          <span class="return-description"><p>true if this packageInfo is for a Project, false otherwise.</p>
-</span>
-        </div>
-      </div>
-</div>
-  </div>
-    <div id="methods protected">
-        <h2 id="protected-methods">Protected Methods</h2>
-<div class="method item protected">
-    <div id="method_addDependencies" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l157"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:157</code></a></span>
-        <h3 class="">
-            protected
-            addDependencies(dependencies): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>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.</p>
-<p>Note: this is not to be  called until all packages that can be have
-been added to the cache.</p>
-<p>Note: this is for ALL dependencies, not just addons. To get just
-addons, filter the result by calling pkgInfo.isForAddon().</p>
-<p>Note: this is only intended for use from PackageInfoCache._resolveDependencies.
-It is not to be called directly by anything else.</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>dependencies</td>
-              <td><a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>value of 'dependencies' or 'devDependencies'
-attributes of a package.json.</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a></span>
-          <span class="return-description"><p>a JavaScript object keyed on dependency name/path with
-values the corresponding PackageInfo object from the cache.</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item protected">
-    <div id="method_addError" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l96"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:96</code></a></span>
-        <h3 class="">
-            protected
-            addError(errorType, errorData)
-        </h3>
-    </div>
-    <div class="method-description"><p>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.</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>errorType</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>one of the Errors.ERROR_* constants.</p>
-</td>
-            </tr>
-            <tr>
-              <td>errorData</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>any error data relevant to the type of error
-being created. See showErrors().</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item protected">
-    <div id="method_addInRepoAddon" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l124"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:124</code></a></span>
-        <h3 class="">
-            protected
-            addInRepoAddon(inRepoAddonPkg):
-        </h3>
-    </div>
-    <div class="method-description"><p>Add a reference to an in-repo addon PackageInfo object.</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>inRepoAddonPkg</td>
-              <td><a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the PackageInfo for the in-repo addon</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-description"><p>null</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item protected">
-    <div id="method_addInternalAddon" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l139"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:139</code></a></span>
-        <h3 class="">
-            protected
-            addInternalAddon(internalAddonPkg):
-        </h3>
-    </div>
-    <div class="method-description"><p>Add a reference to an internal addon PackageInfo object.
-"internal" addons (note: not in-repo addons) only exist in
-Projects, not other packages. Since the cache is loaded from
-'loadProject', this can be done appropriately.</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>internalAddonPkg</td>
-              <td><a href="../classes/PackageInfo.html" class="crosslink">PackageInfo</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the PackageInfo for the internal addon</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-description"><p>null</p>
-</span>
-        </div>
-      </div>
-</div>
-    </div>
-    <div id="methods private">
-        <h2 id="private-methods">Private Methods</h2>
-<div class="method item private">
-    <div id="method__getAddonEntryPoint" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l546"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:546</code></a></span>
-        <h3 class="">
-            private
-            _getAddonEntryPoint( ): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="crosslink external" target="_blank">Function</a>
-        </h3>
-    </div>
-    <div class="method-description"><p>Gets the addon entry point</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="crosslink external" target="_blank">Object</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="crosslink external" target="_blank">Function</a></span>
-          <span class="return-description"><p>The exported addon entry point</p>
-</span>
-        </div>
-      </div>
-</div>
-<div class="method item private">
-    <div id="method_constructAddonInstance" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l461"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:461</code></a></span>
-        <h3 class="">
-            private
-            constructAddonInstance(parent, project)
-        </h3>
-    </div>
-    <div class="method-description"><p>Construct an addon instance.</p>
-<p>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.</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>parent</td>
-              <td><a href="../classes/Project.html" class="crosslink">Project</a> | <a href="../classes/Addon.html" class="crosslink">Addon</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the parent that directly contains this addon</p>
-</td>
-            </tr>
-            <tr>
-              <td>project</td>
-              <td><a href="../classes/Project.html" class="crosslink">Project</a></td>
-              <td>
-                <ul>
-                </ul>
-              </td>
-              <td><p>the project that is/contains this addon</p>
-</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-</div>
-<div class="method item private">
-    <div id="method_getAddonConstructor" class="title">
-        <span class="source-link"><a href="../files/lib_models_package-info-cache_package-info.js.html#l423"><code>lib&#x2F;models&#x2F;package-info-cache&#x2F;package-info.js:423</code></a></span>
-        <h3 class="">
-            private
-            getAddonConstructor( ): AddonConstructor
-        </h3>
-    </div>
-    <div class="method-description"><p>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't need to check each time.</p>
-</div>
-      <div class="return">
-        <h4>Return:</h4>
-        <div>
-          <span class="return-type">AddonConstructor</span>
-          <span class="return-description"><p>an instance of a constructor function for the Addon class
-whose package information is stored in this object.</p>
-</span>
-        </div>
-      </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>