ember-source 4.1.0-alpha.3 → 4.1.0-alpha.7

package/dist/packages/@ember/-internals/metal/index.js

@@ -4,7 +4,7 @@ import { assert, deprecate, debug, warn } from '@ember/debug';
 import { ENV, context } from '@ember/-internals/environment';
 import { schedule } from '@ember/runloop';
 import { registerDestructor, isDestroyed } from '@glimmer/destroyable';
-import { CURRENT_TAG, tagMetaFor, validateTag, valueForTag, CONSTANT_TAG, dirtyTagFor, tagFor, combine, createUpdatableTag, updateTag, ALLOW_CYCLES, consumeTag, track, untrack, deprecateMutationsInTrackingTransaction, isTracking, trackedData } from '@glimmer/validator';
+import { CURRENT_TAG, tagMetaFor, validateTag, valueForTag, CONSTANT_TAG, dirtyTagFor, tagFor, combine, createUpdatableTag, updateTag, ALLOW_CYCLES, consumeTag, track, untrack, isTracking, trackedData, createCache, getValue } from '@glimmer/validator';
 export { createCache, getValue, isConst } from '@glimmer/validator';
 import { DEBUG } from '@glimmer/env';
 import { getCustomTagFor } from '@glimmer/manager';
@@ -1842,13 +1842,7 @@ function _getProp(obj, keyName) {
     }
 
     if (value === undefined && isObject$$1 && !(keyName in obj) && typeof obj.unknownProperty === 'function') {
-      if (DEBUG) {
-        deprecateMutationsInTrackingTransaction(() => {
-          value = obj.unknownProperty(keyName);
-        });
-      } else {
-        value = obj.unknownProperty(keyName);
-      }
+      value = obj.unknownProperty(keyName);
     }
 
     if (isTracking()) {
@@ -2241,7 +2235,7 @@ function isEmpty(obj) {
     return none;
   }
 
-  if (typeof obj.size === 'number') {
+  if (typeof obj.unknownProperty !== 'function' && typeof obj.size === 'number') {
     return !obj.size;
   }
 
@@ -3115,9 +3109,7 @@ class Mixin {
 
       guidFor(this);
 
-      if (true
-      /* EMBER_MODERNIZED_BUILT_IN_COMPONENTS */
-      && Mixin._disableDebugSeal !== true) {
+      if (Mixin._disableDebugSeal !== true) {
         Object.seal(this);
       }
     }
@@ -3240,9 +3232,7 @@ class Mixin {
 
 }
 
-if (DEBUG && true
-/* EMBER_MODERNIZED_BUILT_IN_COMPONENTS */
-) {
+if (DEBUG) {
   Object.defineProperty(Mixin, '_disableDebugSeal', {
     configurable: true,
     enumerable: false,
@@ -3479,68 +3469,46 @@ class TrackedDescriptor {
 }
 
 // NOTE: copied from: https://github.com/glimmerjs/glimmer.js/pull/358
-/**
- * @decorator
- *
- * The `@cached` decorator can be used on getters in order to cache the return
- * value of the getter. This is useful when a getter is expensive and used very
- * often.
- *
- *
- * @example
- *
- * in this guest list class, we have the `sortedGuests`
- * getter that sorts the guests alphabetically:
- *
- * ```js
- * import { tracked } from '@glimmer/tracking';
- *
- * class GuestList {
- *   @tracked guests = ['Zoey', 'Tomster'];
- *
- *   get sortedGuests() {
- *     return this.guests.slice().sort()
- *   }
- * }
- * ```
- *
- * Every time `sortedGuests` is accessed, a new array will be created and sorted,
- * because JavaScript getters do not cache by default. When the guest list is
- * small, like the one in the example, this is not a problem. However, if the guest
- * list were to grow very large, it would mean that we would be doing a large
- * amount of work each time we accessed `sortedGetters`. With `@cached`, we can
- * cache the value instead:
- *
- * ```js
- * import { tracked, cached } from '@glimmer/tracking';
- *
- * class GuestList {
- *   @tracked guests = ['Zoey', 'Tomster'];
- *
- *   @cached
- *   get sortedGuests() {
- *     return this.guests.slice().sort()
- *   }
- * }
- * ```
- *
- * Now the `sortedGuests` getter will be cached based on _autotracking_. It will
- * only rerun and create a new sorted array when the `guests` tracked property is
- * updated.
- *
- * In general, you should avoid using `@cached` unless you have confirmed that the
- * getter you are decorating is computationally expensive. `@cached` adds a small
- * amount of overhead to the getter, making it more expensive. While this overhead
- * is small, if `@cached` is overused it can add up to a large impact overall in
- * your app. Many getters and tracked properties are only accessed once, rendered,
- * and then never rerendered, so adding `@cached` when it is unnecessary can
- * negatively impact performance.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 
 const cached = (...args) => {
+  {
+    const [target, key, descriptor] = args; // Error on `@cached()`, `@cached(...args)`, and `@cached propName = value;`
+
+    if (DEBUG && target === undefined) throwCachedExtraneousParens();
+
+    if (DEBUG && (typeof target !== 'object' || typeof key !== 'string' || typeof descriptor !== 'object' || args.length !== 3)) {
+      throwCachedInvalidArgsError(args);
+    }
+
+    if (DEBUG && (!('get' in descriptor) || typeof descriptor.get !== 'function')) {
+      throwCachedGetterOnlyError(key);
+    }
+
+    const caches = new WeakMap();
+    const getter = descriptor.get;
+
+    descriptor.get = function () {
+      if (!caches.has(this)) {
+        caches.set(this, createCache(getter.bind(this)));
+      }
+
+      return getValue(caches.get(this));
+    };
+  }
 };
 
+function throwCachedExtraneousParens() {
+  throw new Error('You attempted to use @cached(), which is not necessary nor supported. Remove the parentheses and you will be good to go!');
+}
+
+function throwCachedGetterOnlyError(key) {
+  throw new Error(`The @cached decorator must be applied to getters. '${key}' is not a getter.`);
+}
+
+function throwCachedInvalidArgsError(args = []) {
+  throw new Error(`You attempted to use @cached on with ${args.length > 1 ? 'arguments' : 'an argument'} ( @cached(${args.map(d => `'${d}'`).join(', ')}), which is not supported. Dependencies are automatically tracked, so you can just use ${'`@cached`'}`);
+}
+
 /**
   Ember uses caching based on trackable values to avoid updating large portions
   of the application. This caching is exposed via a cache primitive that can be

package/dist/packages/@ember/-internals/routing/lib/ext/controller.js

@@ -197,6 +197,7 @@ ControllerMixin.reopen({
     @method replaceRoute
     @return {Transition} the transition object associated with this
       attempted transition
+    @deprecated Use replaceWith from the Router service instead.
     @public
   */
   replaceRoute(...args) {

package/dist/packages/@ember/-internals/routing/lib/location/api.js

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert, deprecate } from '@ember/debug';
 /**
 @module @ember/routing
 */
@@ -87,6 +87,15 @@ export default {
     assert("Location.create: you must specify a 'implementation' option", Boolean(implementation));
     let implementationClass = this.implementations[implementation];
     assert(`Location.create: ${implementation} is not a valid implementation`, Boolean(implementationClass));
+    deprecate("Calling `create` on Location class is deprecated. Instead, use `container.lookup('location:my-location')` to lookup the location you need.", false, {
+      id: 'deprecate-auto-location',
+      until: '5.0.0',
+      url: 'https://emberjs.com/deprecations/v3.x#toc_deprecate-auto-location',
+      for: 'ember-source',
+      since: {
+        enabled: '4.1.0'
+      }
+    });
     return implementationClass.create(...arguments);
   },
 

package/dist/packages/@ember/-internals/routing/lib/location/none_location.js

@@ -26,10 +26,15 @@ export default class NoneLocation extends EmberObject {
     this.implementation = 'none';
   }
 
-  detect() {
+  initState() {
+    this._super(...arguments);
+
     let {
       rootURL
-    } = this;
+    } = this; // This assert doesn't have anything to do with state initialization,
+    // but we're hijacking this method since it's called after the route has
+    // set the rootURL property on its Location instance.
+
     assert('rootURL must end with a trailing forward slash e.g. "/app/"', rootURL.charAt(rootURL.length - 1) === '/');
   }
   /**

package/dist/packages/@ember/-internals/routing/lib/services/router.js

@@ -28,7 +28,7 @@ function cleanURL(url, rootURL) {
    ```app/components/example.js
    import Component from '@glimmer/component';
    import { action } from '@ember/object';
-   import { inject as service } from '@ember/service';
+   import { service } from '@ember/service';
 
    export default class ExampleComponent extends Component {
      @service router;
@@ -78,7 +78,7 @@ export default class RouterService extends Service {
         ```app/components/example.js
      import Component from '@glimmer/component';
      import { action } from '@ember/object';
-     import { inject as service } from '@ember/service';
+     import { service } from '@ember/service';
         export default class extends Component {
        @service router;
           @action
@@ -172,7 +172,7 @@ export default class RouterService extends Service {
     ```
        ```app/components/copy-link.js
     import Component from '@glimmer/component';
-    import { inject as service } from '@ember/service';
+    import { service } from '@ember/service';
     import { action } from '@ember/object';
        export default class CopyLinkComponent extends Component {
       @service router;
@@ -194,7 +194,7 @@ export default class RouterService extends Service {
     ```
        ```app/components/copy-link.js
     import Component from '@glimmer/component';
-    import { inject as service } from '@ember/service';
+    import { service } from '@ember/service';
     import { action } from '@ember/object';
        export default class CopyLinkComponent extends Component {
       @service router;
@@ -234,7 +234,7 @@ export default class RouterService extends Service {
         In the following example, `isActive` will return `true` if the current route is `/posts`.
         ```app/components/posts.js
      import Component from '@glimmer/component';
-     import { inject as service } from '@ember/service';
+     import { service } from '@ember/service';
         export default class extends Component {
        @service router;
           displayComments() {
@@ -246,7 +246,7 @@ export default class RouterService extends Service {
      assuming the post has an id of 1:
         ```app/components/posts.js
      import Component from '@glimmer/component';
-     import { inject as service } from '@ember/service';
+     import { service } from '@ember/service';
         export default class extends Component {
        @service router;
           displayComments(post) {
@@ -325,7 +325,7 @@ export default class RouterService extends Service {
      application before transitioning to it.
         ```
      import Component from '@ember/component';
-     import { inject as service } from '@ember/service';
+     import { service } from '@ember/service';
         export default class extends Component {
        @service router;
        path = '/';
@@ -520,7 +520,7 @@ RouterService.reopen(Evented, {
        Usage example:
     ```app/components/header.js
       import Component from '@glimmer/component';
-      import { inject as service } from '@ember/service';
+      import { service } from '@ember/service';
       import { notEmpty } from '@ember/object/computed';
          export default class extends Component {
         @service router;

package/dist/packages/@ember/-internals/routing/lib/services/routing.js

@@ -7,7 +7,7 @@ import { readOnly } from '@ember/object/computed';
 import Service from '@ember/service';
 const ROUTER = symbol('ROUTER');
 /**
-  The Routing service is used by LinkComponent, and provides facilities for
+  The Routing service is used by LinkTo, and provides facilities for
   the component/view layer to interact with the router.
 
   This is a private service for internal usage only. For public usage,

package/dist/packages/@ember/-internals/routing/lib/system/route.js

@@ -11,8 +11,7 @@ import { addObserver, computed, defineProperty, descriptorForProperty, flushAsyn
 import { getOwner } from '@ember/-internals/owner';
 import { A as emberA, ActionHandler, Evented, Object as EmberObject, typeOf } from '@ember/-internals/runtime';
 import { isProxy, lookupDescriptor, symbol } from '@ember/-internals/utils';
-import { assert, deprecate, info, isTesting } from '@ember/debug';
-import { ROUTER_EVENTS } from '@ember/deprecated-features';
+import { assert, info, isTesting } from '@ember/debug';
 import { dependentKeyCompat } from '@ember/object/compat';
 import { once } from '@ember/runloop';
 import { classify } from '@ember/string';
@@ -750,6 +749,7 @@ class Route extends EmberObject.extend(ActionHandler, Evented) {
     @return {Transition} the transition object associated with this
       attempted transition
     @since 1.0.0
+    @deprecated Use replaceWith from the Router service instead.
     @public
   */
 
@@ -1286,7 +1286,7 @@ class Route extends EmberObject.extend(ActionHandler, Evented) {
     ```
        ```app/routes/application.js
     import Route from '@ember/routing/route';
-    import { inject as service } from '@ember/service';
+    import { service } from '@ember/service';
        export default class ApplicationRoute extends Route {
       @service router
          constructor() {
@@ -1945,43 +1945,4 @@ Route.reopen({
 
   }
 });
-export let ROUTER_EVENT_DEPRECATIONS;
-
-if (ROUTER_EVENTS) {
-  ROUTER_EVENT_DEPRECATIONS = {
-    on(name) {
-      this._super(...arguments);
-
-      let hasDidTransition = name === 'didTransition';
-      let hasWillTransition = name === 'willTransition';
-
-      if (hasDidTransition) {
-        deprecate('You attempted to listen to the "didTransition" event which is deprecated. Please inject the router service and listen to the "routeDidChange" event.', false, {
-          id: 'deprecate-router-events',
-          until: '4.0.0',
-          url: 'https://deprecations.emberjs.com/v3.x#toc_deprecate-router-events',
-          for: 'ember-source',
-          since: {
-            enabled: '3.11.0'
-          }
-        });
-      }
-
-      if (hasWillTransition) {
-        deprecate('You attempted to listen to the "willTransition" event which is deprecated. Please inject the router service and listen to the "routeWillChange" event.', false, {
-          id: 'deprecate-router-events',
-          until: '4.0.0',
-          url: 'https://deprecations.emberjs.com/v3.x#toc_deprecate-router-events',
-          for: 'ember-source',
-          since: {
-            enabled: '3.11.0'
-          }
-        });
-      }
-    }
-
-  };
-  Route.reopen(ROUTER_EVENT_DEPRECATIONS);
-}
-
 export default Route;

package/dist/packages/@ember/-internals/routing/lib/system/router.js

@@ -3,14 +3,13 @@ import { computed, get, set } from '@ember/-internals/metal';
 import { getOwner } from '@ember/-internals/owner';
 import { A as emberA, Evented, Object as EmberObject, typeOf } from '@ember/-internals/runtime';
 import { assert, deprecate, info } from '@ember/debug';
-import { ROUTER_EVENTS } from '@ember/deprecated-features';
 import EmberError from '@ember/error';
 import { cancel, once, run, scheduleOnce } from '@ember/runloop';
 import { DEBUG } from '@glimmer/env';
 import EmberLocation from '../location/api';
 import { calculateCacheKey, extractRouteArgs, getActiveTargetName, resemblesURL } from '../utils';
 import DSL from './dsl';
-import { defaultSerialize, getFullQueryParams, hasDefaultSerialize, ROUTE_CONNECTIONS, ROUTER_EVENT_DEPRECATIONS } from './route';
+import { defaultSerialize, getFullQueryParams, hasDefaultSerialize, ROUTE_CONNECTIONS } from './route';
 import RouterState from './router_state';
 import Router, { logAbort, STATE_SYMBOL } from 'router_js';
 
@@ -20,10 +19,7 @@ function defaultDidTransition(infos) {
   this._cancelSlowTransitionTimer();
 
   this.notifyPropertyChange('url');
-  this.set('currentState', this.targetState); // Put this in the runloop so url will be accurate. Seems
-  // less surprising than didTransition being out of sync.
-
-  once(this, this.trigger, 'didTransition');
+  this.set('currentState', this.targetState);
 
   if (DEBUG) {
     // @ts-expect-error namespace isn't public
@@ -34,9 +30,7 @@ function defaultDidTransition(infos) {
   }
 }
 
-function defaultWillTransition(oldInfos, newInfos, transition) {
-  once(this, this.trigger, 'willTransition', transition);
-
+function defaultWillTransition(oldInfos, newInfos) {
   if (DEBUG) {
     // @ts-expect-error namespace isn't public
     if (this.namespace.LOG_TRANSITIONS) {
@@ -256,42 +250,18 @@ class EmberRouter extends EmberObject.extend(Evented) {
           location.setURL(path);
           set(router, 'currentURL', path);
         });
-      }
+      } // TODO: merge into routeDidChange
 
-      didTransition(infos) {
-        if (ROUTER_EVENTS) {
-          if (router.didTransition !== defaultDidTransition) {
-            deprecate('You attempted to override the "didTransition" method which is deprecated. Please inject the router service and listen to the "routeDidChange" event.', false, {
-              id: 'deprecate-router-events',
-              until: '4.0.0',
-              url: 'https://deprecations.emberjs.com/v3.x#toc_deprecate-router-events',
-              for: 'ember-source',
-              since: {
-                enabled: '3.11.0'
-              }
-            });
-          }
-        }
 
+      didTransition(infos) {
+        assert('You attempted to override the "didTransition" method which has been deprecated. Please inject the router service and listen to the "routeDidChange" event.', router.didTransition === defaultDidTransition);
         router.didTransition(infos);
-      }
+      } // TODO: merge into routeWillChange
 
-      willTransition(oldInfos, newInfos, transition) {
-        if (ROUTER_EVENTS) {
-          if (router.willTransition !== defaultWillTransition) {
-            deprecate('You attempted to override the "willTransition" method which is deprecated. Please inject the router service and listen to the "routeWillChange" event.', false, {
-              id: 'deprecate-router-events',
-              until: '4.0.0',
-              url: 'https://deprecations.emberjs.com/v3.x#toc_deprecate-router-events',
-              for: 'ember-source',
-              since: {
-                enabled: '3.11.0'
-              }
-            });
-          }
-        }
 
-        router.willTransition(oldInfos, newInfos, transition);
+      willTransition(oldInfos, newInfos) {
+        assert('You attempted to override the "willTransition" method which has been deprecated. Please inject the router service and listen to the "routeWillChange" event.', router.willTransition === defaultWillTransition);
+        router.willTransition(oldInfos, newInfos);
       }
 
       triggerEvent(routeInfos, ignoreFailure, name, args) {
@@ -752,6 +722,18 @@ class EmberRouter extends EmberObject.extend(Evented) {
     if ('string' === typeof location) {
       let resolvedLocation = owner.lookup(`location:${location}`);
 
+      if (location === 'auto') {
+        deprecate("Router location 'auto' is deprecated. Most users will want to set `locationType` to 'history' in config/environment.js for no change in behavior. See deprecation docs for details.", false, {
+          id: 'deprecate-auto-location',
+          until: '5.0.0',
+          url: 'https://emberjs.com/deprecations/v3.x#toc_deprecate-auto-location',
+          for: 'ember-source',
+          since: {
+            enabled: '4.1.0'
+          }
+        });
+      }
+
       if (resolvedLocation !== undefined) {
         location = set(this, 'location', resolvedLocation);
       } else {
@@ -772,6 +754,18 @@ class EmberRouter extends EmberObject.extend(Evented) {
 
 
       if (typeof location.detect === 'function') {
+        if (this.location !== 'auto') {
+          deprecate('The `detect` method on the Location object is deprecated. If you need detection you can run your detection code in app.js, before setting the location type.', false, {
+            id: 'deprecate-auto-location',
+            until: '5.0.0',
+            url: 'https://emberjs.com/deprecations/v3.x#toc_deprecate-auto-location',
+            for: 'ember-source',
+            since: {
+              enabled: '4.1.0'
+            }
+          });
+        }
+
         location.detect();
       } // ensure that initState is called AFTER the rootURL is set on
       // the location instance
@@ -1415,7 +1409,8 @@ export function triggerEvent(routeInfos, ignoreFailure, name, args) {
   if (!routeInfos) {
     if (ignoreFailure) {
       return;
-    }
+    } // TODO: update?
+
 
     throw new EmberError(`Can't trigger action '${name}' because your app hasn't finished transitioning into its first route. To trigger an action on destination routes during a transition, you can call \`.send()\` on the \`Transition\` object passed to the \`model/beforeModel/afterModel\` hooks.`);
   }
@@ -1624,9 +1619,4 @@ EmberRouter.reopen({
     return location.getURL();
   })
 });
-
-if (ROUTER_EVENTS) {
-  EmberRouter.reopen(ROUTER_EVENT_DEPRECATIONS);
-}
-
 export default EmberRouter;

package/dist/packages/@ember/-internals/runtime/lib/mixins/target_action_support.js

@@ -3,14 +3,8 @@
 */
 import { context } from '@ember/-internals/environment';
 import { get, Mixin, computed } from '@ember/-internals/metal';
-import { assert, deprecate } from '@ember/debug';
+import { assert } from '@ember/debug';
 import { DEBUG } from '@glimmer/env';
-
-if (DEBUG && true
-/* EMBER_MODERNIZED_BUILT_IN_COMPONENTS */
-) {
-  Mixin._disableDebugSeal = true;
-}
 /**
 `Ember.TargetActionSupport` is a mixin that can be included in a class
 to add a `triggerAction` method with semantics similar to the Handlebars
@@ -24,7 +18,6 @@ doing more complex event handling in Components.
 @private
 */
 
-
 const TargetActionSupport = Mixin.create({
   target: null,
   action: null,
@@ -151,41 +144,8 @@ function getTarget(instance) {
   return null;
 }
 
-if (true
-/* EMBER_MODERNIZED_BUILT_IN_COMPONENTS */
-) {
-  Object.defineProperty(TargetActionSupport, '_wasReopened', {
-    configurable: true,
-    enumerable: false,
-    writable: true,
-    value: false
-  });
-  Object.defineProperty(TargetActionSupport, 'reopen', {
-    configurable: true,
-    enumerable: false,
-    writable: true,
-    value: function reopen(...args) {
-      if (this === TargetActionSupport) {
-        deprecate('Reopening Ember.TargetActionSupport is deprecated.', false, {
-          id: 'ember.built-in-components.reopen',
-          for: 'ember-source',
-          since: {
-            enabled: '3.27.0'
-          },
-          until: '4.0.0',
-          url: 'https://deprecations.emberjs.com/v3.x#toc_ember-built-in-components-reopen'
-        });
-        TargetActionSupport._wasReopened = true;
-      }
-
-      return Mixin.prototype.reopen.call(this, ...args);
-    }
-  });
-
-  if (DEBUG) {
-    Object.seal(TargetActionSupport);
-    Mixin._disableDebugSeal = false;
-  }
+if (DEBUG) {
+  Object.seal(TargetActionSupport);
 }
 
 export default TargetActionSupport;

package/dist/packages/@ember/-internals/utils/index.js

@@ -74,9 +74,6 @@ function isObject(value) {
 */
 
 /**
- Previously we used `Ember.$.uuid`, however `$.uuid` has been removed from
- jQuery master. We'll just bootstrap our own uuid now.
-
  @private
  @return {Number} the uuid
  */

package/dist/packages/@ember/-internals/views/index.js

@@ -1,7 +1,6 @@
 export { addChildView, isSimpleClick, getViewBounds, getViewClientRects, getViewBoundingClientRect, getRootViews, getChildViews, getViewId, getElementView, getViewElement, setElementView, setViewElement, clearElementView, clearViewElement, constructStyleDeprecationMessage } from './lib/system/utils';
 export { default as EventDispatcher } from './lib/system/event_dispatcher';
 export { default as ComponentLookup } from './lib/component_lookup';
-export { default as TextSupport } from './lib/mixins/text_support';
 export { default as CoreView } from './lib/views/core_view';
 export { default as ClassNamesSupport } from './lib/mixins/class_names_support';
 export { default as ChildViewsSupport } from './lib/mixins/child_views_support';

package/dist/packages/@ember/-internals/views/lib/mixins/view_support.js

@@ -146,7 +146,7 @@ let mixin = {
    the target element you are providing is associated with an `Application`
    and does not have an ancestor element that is associated with an Ember view.
     @method appendTo
-   @param {String|DOMElement|jQuery} A selector, element, HTML string, or jQuery object
+   @param {String|DOMElement} A selector, element, HTML string
    @return {Ember.View} receiver
    @private
    */
@@ -172,8 +172,8 @@ let mixin = {
       })());
     } else {
       target = selector;
-      assert(`You tried to append to a selector string (${selector}) in an environment without jQuery`, typeof target !== 'string');
-      assert(`You tried to append to a non-Element (${selector}) in an environment without jQuery`, typeof selector.appendChild === 'function');
+      assert(`You tried to append to a selector string (${selector}) in an environment without a DOM`, typeof target !== 'string');
+      assert(`You tried to append to a non-Element (${selector}) in an environment without a DOM`, typeof selector.appendChild === 'function');
     }
 
     this.renderer.appendTo(this, target);
@@ -303,7 +303,7 @@ let mixin = {
    Component properties that depend on the presence of an outer element, such
    as `classNameBindings` and `attributeBindings`, do not work with tagless
    components. Tagless components cannot implement methods to handle events,
-   and have no associated jQuery object to return with `$()`.
+   and their `element` property has a `null` value.
     @property tagName
    @type String
    @default null

package/dist/packages/@ember/application/lib/application.js

@@ -110,7 +110,7 @@ import { RouterService } from '@ember/-internals/routing';
   });
   ```
 
-  The `rootElement` can be either a DOM element or a jQuery-compatible selector
+  The `rootElement` can be either a DOM element or a CSS selector
   string. Note that *views appended to the DOM outside the root element will
   not receive events.* If you specify a custom root element, make sure you only
   append views inside it!
@@ -174,8 +174,7 @@ import { RouterService } from '@ember/-internals/routing';
 const Application = Engine.extend({
   /**
     The root DOM element of the Application. This can be specified as an
-    element or a
-    [jQuery-compatible selector string](http://api.jquery.com/category/selectors/).
+    element or a [selector string](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors#reference_table_of_selectors).
      This is the element that will be passed to the Application's,
     `eventDispatcher`, which sets up the listeners for event delegation. Every
     view in your application should be a child of the element you specify here.
@@ -481,10 +480,10 @@ const Application = Engine.extend({
     import Application from '@ember/application';
      let App = Application.create();
      App.deferReadiness();
-     // $ is a reference to the jQuery object/function
-    import $ from 'jquery;
-     $.getJSON('/auth-token', function(token) {
-      App.token = token;
+     fetch('/auth-token')
+    .then(response => response.json())
+    .then(data => {
+      App.token = data.token;
       App.advanceReadiness();
     });
     ```
@@ -831,7 +830,7 @@ const Application = Engine.extend({
     in the non-browser environment, the stand-in `document` object only needs to
     implement a limited subset of the full DOM API. The `SimpleDOM` library is known
     to work.
-     Since there is no access to jQuery in the non-browser environment, you must also
+     Since there is no DOM access in the non-browser environment, you must also
     specify a DOM `Element` object in the same `document` for the `rootElement` option
     (as opposed to a selector string like `"body"`).
      See the documentation on the `isBrowser`, `document` and `rootElement` properties
@@ -862,7 +861,7 @@ const Application = Engine.extend({
     ```
      ```app/routes/post.js
     import Route from '@ember/routing/route';
-    import { inject as service } from '@ember/service';
+    import { service } from '@ember/service';
      // An example of how the (hypothetical) service is used in routes.
      export default class IndexRoute extends Route {
       @service network;