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

ember-cli 4.0.0 → 4.2.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 (115) hide show

package/.github/workflows/ci.yml +8 -4
package/CHANGELOG.md +43 -2
package/README.md +1 -1
package/blueprints/addon/additional-dev-dependencies.json +1 -1
package/blueprints/addon/files/CONTRIBUTING.md +1 -1
package/blueprints/app/files/README.md +2 -2
package/blueprints/app/files/package.json +8 -8
package/docs/build/data.json +64 -3
package/lib/debug/assert.js +37 -0
package/lib/debug/deprecate.js +111 -0
package/lib/debug/index.js +6 -0
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 +31 -31
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_per-bundle-addon-cache_index.js.html DELETED Viewed

@@ -1,485 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8">
-    <title>lib/models/per-bundle-addon-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-release-b4cbb1029f
-            </div>
-        </div>
-        <div id="main" class="yui3-u">
-            <div class="content"><div class="title">
-  <h1 class="file-name">lib/models/per-bundle-addon-cache/index.js</h1>
-</div>
-<pre class="code prettyprint linenums">
-&#x27;use strict&#x27;;
-const fs = require(&#x27;fs&#x27;);
-const path = require(&#x27;path&#x27;);
-const isLazyEngine = require(&#x27;../../utilities/is-lazy-engine&#x27;);
-const { getAddonProxy } = require(&#x27;./addon-proxy&#x27;);
-const logger = require(&#x27;heimdalljs-logger&#x27;)(&#x27;ember-cli:per-bundle-addon-cache&#x27;);
-const { TARGET_INSTANCE } = require(&#x27;./target-instance&#x27;);
-function defaultAllowCachingPerBundle({ addonEntryPointModule }) {
-  return (
-    addonEntryPointModule.allowCachingPerBundle ||
-    (addonEntryPointModule.prototype &amp;&amp; addonEntryPointModule.prototype.allowCachingPerBundle)
-  );
-}
-/**
- * Resolves the perBundleAddonCacheUtil; this prefers the custom provided version by
- * the consuming application, and defaults to an internal implementation here.
- *
- * @method resolvePerBundleAddonCacheUtil
- * @param {Project} project
- * @return {{allowCachingPerBundle: Function}}
- */
-function resolvePerBundleAddonCacheUtil(project) {
-  const relativePathToUtil =
-    project.pkg &amp;&amp; project.pkg[&#x27;ember-addon&#x27;] &amp;&amp; project.pkg[&#x27;ember-addon&#x27;].perBundleAddonCacheUtil;
-  if (typeof relativePathToUtil === &#x27;string&#x27;) {
-    const absolutePathToUtil = path.resolve(project.root, relativePathToUtil);
-    if (!fs.existsSync(absolutePathToUtil)) {
-      throw new Error(
-        &#x60;[ember-cli] the provided \&#x60;${relativePathToUtil}\&#x60; for \&#x60;ember-addon.perBundleAddonCacheUtil\&#x60; does not exist&#x60;
-      );
-    }
-    return require(absolutePathToUtil);
-  }
-  return {
-    allowCachingPerBundle: defaultAllowCachingPerBundle,
-  };
-}
-/**
- * For large applications with many addons (and many instances of each, resulting in
- * potentially many millions of addon instances during a build), the build can become
- * very, very slow (tens of minutes) partially due to the sheer number of addon instances.
- * The PerBundleAddonCache deals with this slowness by doing 3 things:
- *
- * (1) Making only a single copy of each of certain addons and their dependent addons
- * (2) Replacing any other instances of those addons with Proxy copies to the single instance
- * (3) Having the Proxies return an empty array for their dependent addons, rather
- *     than proxying to the contents of the single addon instance. This gives up the
- *     ability of the Proxies to traverse downward into their child addons,
- *     something that many addons do not do anyway, for the huge reduction in duplications
- *     of those child addons. For applications that enable &#x60;ember-engines&#x60; dedupe logic,
- *     that logic is stateful, and having the Proxies allow access to the child addons array
- *     just breaks everything, because that logic will try multiple times to remove items
- *     it thinks are duplicated, messing up the single copy of the child addon array.
- *     See the explanation of the dedupe logic in
- *    {@link https://github.com/ember-engines/ember-engines/blob/master/packages/ember-engines/lib/utils/deeply-non-duplicated-addon.js}
- *
- * What follows are the more technical details of how the PerBundleAddonCache implements
- * the above 3 behaviors.
- *
- * This class supports per-bundle-host (bundle host = project or lazy engine)
- * caching of addon instances. During addon initialization we cannot add a
- * cache to each bundle host object AFTER it is instantiated because running the
- * addon constructor ultimately causes Addon class &#x60;setupRegistry&#x60; code to
- * run which instantiates child addons, which need the cache to already be
- * in place for the parent bundle host.
- * We handle this by providing a global cache that exists independent of the
- * bundle host objects. That is this object.
- *
- * There are a number of &quot;behaviors&quot; being implemented by this object and
- * its contents. They are:
- * (1) Any addon that is a lazy engine has only a single real instance per
- * project - all other references to the lazy engine are to be proxies. These
- * lazy engines are compared by name, not by packageInfo.realPath.
- * (2) Any addon that is not a lazy engine, there is only a single real instance
- * of the addon per &quot;bundle host&quot; (i.e. lazy engine or project).
- * (3) An optimization - any addon that is in a lazy engine but that is also
- * in bundled by its LCA host - the single instance is the one bundled by this
- * host. All other instances (in any lazy engine) are proxies.
- *
- * NOTE: the optimization is only enabled if the environment variable that controls
- * &#x60;ember-engines&#x60; transitive deduplication (process.env.EMBER_ENGINES_ADDON_DEDUPE)
- * is set to a truthy value. For more info, see:
- * https://github.com/ember-engines/ember-engines/blob/master/packages/ember-engines/lib/engine-addon.js#L396
- *
- * @public
- * @class PerBundleAddonCache {
- */
-class PerBundleAddonCache {
-  constructor(project) {
-    this.project = project;
-    // The cache of bundle-host package infos and their individual addon caches.
-    // The cache is keyed by package info (representing a bundle host (project or
-    // lazy engine)) and an addon instance cache to bundle with that bundle host.
-    this.bundleHostCache = new Map();
-    // Indicate if ember-engines transitive dedupe is enabled.
-    this.engineAddonTransitiveDedupeEnabled = !!process.env.EMBER_ENGINES_ADDON_DEDUPE;
-    this._perBundleAddonCacheUtil = resolvePerBundleAddonCacheUtil(this.project);
-    // For stats purposes, counts on the # addons and proxies created. Addons we
-    // can compare against the bundleHostCache addon caches. Proxies, not so much,
-    // but we&#x27;ll count them here.
-    this.numAddonInstances = 0;
-    this.numProxies = 0;
-  }
-  /**
-   * The default implementation here is to indicate if the original addon entry point has
-   * the &#x60;allowCachingPerBundle&#x60; flag set either on itself or on its prototype.
-   *
-   * If a consuming application specifies a relative path to a custom utility via the
-   * &#x60;ember-addon.perBundleAddonCacheUtil&#x60; configuration, we prefer the custom implementation
-   * provided by the consumer.
-   *
-   * @method allowCachingPerBundle
-   * @param {Object|Function} addonEntryPointModule
-   * @return {Boolean} true if the given constructor function or class supports caching per bundle, false otherwise
-   */
-  allowCachingPerBundle(addonEntryPointModule) {
-    return this._perBundleAddonCacheUtil.allowCachingPerBundle({ addonEntryPointModule });
-  }
-  /**
-   * Creates a cache entry for the bundleHostCache. Because we want to use the same sort of proxy
-   * for both bundle hosts and for &#x27;regular&#x27; addon instances (though their cache entries have
-   * slightly different structures) we&#x27;ll use the Symbol from getAddonProxy.
-   *
-   * @method createBundleHostCacheEntry
-   * @param {PackageInfo} bundleHostPkgInfo bundle host&#x27;s pkgInfo.realPath
-   * @return {Object} an object in the form of a bundle-host cache entry
-   */
-  createBundleHostCacheEntry(bundleHostPkgInfo) {
-    return { [TARGET_INSTANCE]: null, realPath: bundleHostPkgInfo.realPath, addonInstanceCache: new Map() };
-  }
-  /**
-   * Create a cache entry object for a given (non-bundle-host) addon to put into
-   * an addon cache.
-   *
-   * @method createAddonCacheEntry
-   * @param {Addon} addonInstance the addon instance to cache
-   * @param {String} addonRealPath the addon&#x27;s pkgInfo.realPath
-   * @return {Object} an object in the form of an addon-cache entry
-   */
-  createAddonCacheEntry(addonInstance, addonRealPath) {
-    return { [TARGET_INSTANCE]: addonInstance, realPath: addonRealPath };
-  }
-  /**
-   * Given a parent object of a potential addon (another addon or the project),
-   * go up the &#x27;parent&#x27; chain to find the potential addon&#x27;s bundle host object
-   * (i.e. lazy engine or project.) Because Projects are always bundle hosts,
-   * this should always pass, but we&#x27;ll throw if somehow it doesn&#x27;t work.
-   *
-   * @method findBundleHost
-   * @param {Project|Addon} addonParent the direct parent object of a (potential or real) addon.
-   * @param {PackageInfo} addonPkgInfo the PackageInfo for an addon being instantiated. This is only
-   * used for information if an error is going to be thrown.
-   * @return {Object} the object in the &#x27;parent&#x27; chain that is a bundle host.
-   * @throws {Error} if there is not bundle host
-   */
-  findBundleHost(addonParent, addonPkgInfo) {
-    let curr = addonParent;
-    while (curr) {
-      if (curr === this.project) {
-        return curr;
-      }
-      if (isLazyEngine(curr)) {
-        // if we&#x27;re building a lazy engine in isolation, prefer that the bundle host is
-        // the project, not the lazy engine addon instance
-        if (curr.parent === this.project &amp;&amp; curr._packageInfo === this.project._packageInfo) {
-          return this.project;
-        }
-        return curr;
-      }
-      curr = curr.parent;
-    }
-    // the following should not be able to happen given that Projects are always
-    // bundle hosts, but just in case, throw an error if we didn&#x27;t find one.
-    throw new Error(&#x60;Addon at path\n  ${addonPkgInfo.realPath}\n has &#x27;allowCachingPerBundle&#x27; but has no bundleHost&#x60;);
-  }
-  /**
-   * An optimization we support from lazy engines is the following:
-   *
-   * If an addon instance is supposed to be bundled with a particular lazy engine, and
-   * same addon is also to be bundled by a common LCA host, prefer the one bundled by the
-   * host (since it&#x27;s ultimately going to be deduped later by &#x60;ember-engines&#x60;).
-   *
-   * NOTE: this only applies if this.engineAddonTransitiveDedupeEnabled is truthy. If it is not,
-   * the bundle host always &quot;owns&quot; the addon instance.
-   *
-   * If deduping is enabled and the LCA host also depends on the same addon,
-   * the lazy-engine instances of the addon will all be proxies to the one in
-   * the LCA host. This function indicates whether the bundle host passed in
-   * (either the project or a lazy engine) is really the bundle host to &quot;own&quot; the
-   * new addon.
-   *
-   * @method bundleHostOwnsInstance
-   * @param (Object} bundleHost the project or lazy engine that is trying to &quot;own&quot;
-   * the new addon instance specified by addonPkgInfo
-   * @param {PackageInfo} addonPkgInfo the PackageInfo of the potential new addon instance
-   * @return {Boolean} true if the bundle host is to &quot;own&quot; the instance, false otherwise.
-   */
-  bundleHostOwnsInstance(bundleHost, addonPkgInfo) {
-    if (isLazyEngine(bundleHost)) {
-      return (
-        !this.engineAddonTransitiveDedupeEnabled ||
-        !this.project.hostInfoCache
-          .getHostAddonInfo(bundleHost._packageInfo)
-          .hostAndAncestorBundledPackageInfos.has(addonPkgInfo)
-      );
-    }
-    return true;
-  }
-  findBundleOwner(bundleHost, addonPkgInfo) {
-    if (bundleHost === this.project._packageInfo) {
-      return bundleHost;
-    }
-    let { hostPackageInfo, hostAndAncestorBundledPackageInfos } = this.project.hostInfoCache.getHostAddonInfo(
-      bundleHost
-    );
-    if (!hostAndAncestorBundledPackageInfos.has(addonPkgInfo)) {
-      return bundleHost;
-    }
-    return this.findBundleOwner(hostPackageInfo, addonPkgInfo);
-  }
-  /**
-   * Called from PackageInfo.getAddonInstance(), return an instance of the requested
-   * addon or a Proxy, based on the type of addon and its bundle host.
-   *
-   * @method getAddonInstance
-   * @param {Addon|Project} parent the parent Addon or Project this addon instance is
-   * a child of.
-   * @param {*} addonPkgInfo the PackageInfo for the addon being created.
-   * @return {Addon|Proxy} An addon instance (for the first copy of the addon) or a Proxy.
-   * An addon that is a lazy engine will only ever have a single copy in the cache.
-   * An addon that is not will have 1 copy per bundle host (Project or lazy engine),
-   * except if it is an addon that&#x27;s also owned by a given LCA host and transitive
-   * dedupe is enabled (&#x60;engineAddonTransitiveDedupeEnabled&#x60;), in which case it will
-   * only have a single copy in the project&#x27;s addon cache.
-   */
-  getAddonInstance(parent, addonPkgInfo) {
-    // If the new addon is itself a bundle host (i.e. lazy engine), there is only one
-    // instance of the bundle host, and it&#x27;s in the entries of the bundleHostCache, outside
-    // of the &#x27;regular&#x27; addon caches. Because &#x27;setupBundleHostCache&#x27; ran during construction,
-    // we know that an entry is in the cache with this engine name.
-    if (addonPkgInfo.isForBundleHost()) {
-      let cacheEntry = this._getBundleHostCacheEntry(addonPkgInfo);
-      if (cacheEntry[TARGET_INSTANCE]) {
-        logger.debug(&#x60;About to construct BR PROXY to cache entry for addon at: ${addonPkgInfo.realPath}&#x60;);
-        this.numProxies++;
-        return getAddonProxy(cacheEntry, parent);
-      } else {
-        // create an instance, put it in the pre-existing cache entry, then
-        // return it (as the first instance of the lazy engine.)
-        logger.debug(&#x60;About to fill in BR EXISTING cache entry for addon at: ${addonPkgInfo.realPath}&#x60;);
-        this.numAddonInstances++;
-        let addon = addonPkgInfo.constructAddonInstance(parent, this.project);
-        cacheEntry[TARGET_INSTANCE] = addon; // cache BEFORE initializing child addons
-        addonPkgInfo.initChildAddons(addon);
-        return addon;
-      }
-    }
-    // We know now we&#x27;re asking for a &#x27;regular&#x27; (non-bundle-host) addon instance.
-    let bundleHost = this.findBundleHost(parent, addonPkgInfo);
-    // if the bundle host &quot;owns&quot; the new addon instance
-    //   * Do we already have an instance of the addon cached?
-    //     * If so, make a proxy for it.
-    //     * If not, make a new instance of the addon and cache it in the
-    //       bundle host&#x27;s addon cache.
-    // If not, it means the bundle host is a lazy engine but the LCA host also uses
-    // the addon and deduping is enabled
-    //   * If the LCA host already has a cached entry, return a proxy to that
-    //   * If it does not, create a &#x27;blank&#x27; cache entry and return a proxy to that.
-    //     When the addon is encountered later when processing the LCA host&#x27;s addons,
-    //     fill in the instance.
-    if (this.bundleHostOwnsInstance(bundleHost, addonPkgInfo)) {
-      let bundleHostCacheEntry = this._getBundleHostCacheEntry(bundleHost._packageInfo);
-      let addonInstanceCache = bundleHostCacheEntry.addonInstanceCache;
-      let addonCacheEntry = addonInstanceCache.get(addonPkgInfo.realPath);
-      let addonInstance;
-      if (addonCacheEntry) {
-        if (addonCacheEntry[TARGET_INSTANCE]) {
-          logger.debug(&#x60;About to construct REGULAR ADDON PROXY for addon at: ${addonPkgInfo.realPath}&#x60;);
-          this.numProxies++;
-          return getAddonProxy(addonCacheEntry, parent);
-        } else {
-          // the cache entry was created &#x27;empty&#x27; by an earlier call, indicating
-          // an addon that is used in a lazy engine but also used by its LCA host,
-          // and we&#x27;re now creating the instance for the LCA host.
-          // Fill in the entry and return the new instance.
-          logger.debug(&#x60;About to fill in REGULAR ADDON EXISTING cache entry for addon at: ${addonPkgInfo.realPath}&#x60;);
-          this.numAddonInstances++;
-          addonInstance = addonPkgInfo.constructAddonInstance(parent, this.project);
-          addonCacheEntry[TARGET_INSTANCE] = addonInstance; // cache BEFORE initializing child addons
-          addonPkgInfo.initChildAddons(addonInstance);
-          return addonInstance;
-        }
-      }
-      // There is no entry for this addon in the bundleHost&#x27;s addon cache. Create a new
-      // instance, cache it in the addon cache, and return it.
-      logger.debug(&#x60;About to construct REGULAR ADDON NEW cache entry for addon at: ${addonPkgInfo.realPath}&#x60;);
-      this.numAddonInstances++;
-      addonInstance = addonPkgInfo.constructAddonInstance(parent, this.project);
-      addonCacheEntry = this.createAddonCacheEntry(addonInstance, addonPkgInfo.realPath);
-      addonInstanceCache.set(addonPkgInfo.realPath, addonCacheEntry); // cache BEFORE initializing child addons
-      addonPkgInfo.initChildAddons(addonInstance);
-      return addonInstance;
-    } else {
-      // The bundleHost is not the project but the some ancestor bundles the addon and
-      // deduping is enabled, so the cache entry needs to go in the bundle owner&#x27;s cache.
-      // Get/create an empty cache entry and return a proxy to it. The bundle owner will
-      // set the instance later (see above).
-      let bundleHostCacheEntry = this._getBundleHostCacheEntry(
-        this.findBundleOwner(bundleHost._packageInfo, addonPkgInfo)
-      );
-      let addonCacheEntry = bundleHostCacheEntry.addonInstanceCache.get(addonPkgInfo.realPath);
-      if (!addonCacheEntry) {
-        logger.debug(&#x60;About to construct REGULAR ADDON EMPTY cache entry for addon at: ${addonPkgInfo.realPath}&#x60;);
-        addonCacheEntry = this.createAddonCacheEntry(null, addonPkgInfo.realPath);
-        bundleHostCacheEntry.addonInstanceCache.set(addonPkgInfo.realPath, addonCacheEntry);
-      }
-      logger.debug(&#x60;About to construct REGULAR ADDON PROXY for EMPTY addon at: ${addonPkgInfo.realPath}&#x60;);
-      this.numProxies++;
-      return getAddonProxy(addonCacheEntry, parent);
-    }
-  }
-  getPathsToAddonsOptedIn() {
-    const addonSet = new Set();
-    for (const [, { addonInstanceCache }] of this.bundleHostCache) {
-      Array.from(addonInstanceCache.keys()).forEach((realPath) =&gt; {
-        addonSet.add(realPath);
-      });
-    }
-    return Array.from(addonSet);
-  }
-  _getBundleHostCacheEntry(pkgInfo) {
-    let cacheEntry = this.bundleHostCache.get(pkgInfo);
-    if (!cacheEntry) {
-      cacheEntry = this.createBundleHostCacheEntry(pkgInfo);
-      this.bundleHostCache.set(pkgInfo, cacheEntry);
-    }
-    return cacheEntry;
-  }
-  // Support for per-bundle addon caching is GLOBAL opt OUT (unless you explicitly set
-  // EMBER_CLI_ADDON_INSTANCE_CACHING to false, it will be enabled.) If you opt out, that
-  // overrides setting &#x60;allowCachingPerBundle&#x60; for any particular addon type to true.
-  // To help make testing easier, we&#x27;ll expose the setting as a function so it can be
-  // called multiple times and evaluate each time.
-  static isEnabled() {
-    return process.env.EMBER_CLI_ADDON_INSTANCE_CACHING !== &#x27;false&#x27;;
-  }
-}
-module.exports = PerBundleAddonCache;
-</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>

package/docs/build/files/lib_models_per-bundle-addon-cache_target-instance.js.html DELETED Viewed

@@ -1,108 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8">
-    <title>lib/models/per-bundle-addon-cache/target-instance.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/per-bundle-addon-cache/target-instance.js</h1>
-</div>
-<pre class="code prettyprint linenums">
-&#x27;use strict&#x27;;
-/**
- * A Symbol constant for sharing between index.js and addon-proxy.js rather than
- * putting the symbol into the Symbol global cache. The symbol is used in per-bundle
- * cache entries to refer to the field that points at the real instance that a Proxy
- * refers to.
- * @property
- * @type Symbol
- * @final
- */
-const TARGET_INSTANCE = Symbol(&#x27;_targetInstance_&#x27;);
-module.exports.TARGET_INSTANCE = TARGET_INSTANCE;
-</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>