ember-source 3.28.4 → 3.28.8

package/docs/data.json

@@ -3,7 +3,7 @@
     "name": "The Ember API",
     "description": "The Ember API: a framework for building ambitious web applications",
     "url": "https://emberjs.com/",
-    "version": "3.28.4"
+    "version": "3.28.8"
   },
   "files": {
     "node_modules/rsvp/lib/rsvp/promise/all.js": {
@@ -2458,7 +2458,7 @@
       "module": "ember",
       "namespace": "Ember",
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 59,
+      "line": 62,
       "description": "A container used to instantiate and cache objects.\n\nEvery `Container` must be associated with a `Registry`, which is referenced\nto determine the factory and options that should be used to instantiate\nobjects.\n\nThe public API for `Container` is still in flux and should not be considered\nstable.",
       "access": "private",
       "tagname": ""
@@ -3139,7 +3139,7 @@
       "module": "@ember/routing",
       "namespace": "",
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 87,
+      "line": 86,
       "description": "The `Route` class is used to define individual routes. Refer to\nthe [routing guide](https://guides.emberjs.com/release/routing/) for documentation.",
       "extends": "EmberObject",
       "uses": [
@@ -4839,7 +4839,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 99,
+      "line": 102,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -4852,7 +4852,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 106,
+      "line": 109,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -4864,7 +4864,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 112,
+      "line": 115,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -4876,7 +4876,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 118,
+      "line": 121,
       "description": "Given a fullName return a corresponding instance.\n The default behavior is for lookup to return a singleton instance.\nThe singleton is scoped to the container, allowing multiple containers\nto all have their own locally scoped singletons.\n ```javascript\nlet registry = new Registry();\nlet container = registry.container();\n registry.register('api:twitter', Twitter);\n let twitter = container.lookup('api:twitter');\n twitter instanceof Twitter; // => true\n // by default the container will return singletons\nlet twitter2 = container.lookup('api:twitter');\ntwitter2 instanceof Twitter; // => true\n twitter === twitter2; //=> true\n```\n If singletons are not wanted, an optional flag can be provided at lookup.\n ```javascript\nlet registry = new Registry();\nlet container = registry.container();\n registry.register('api:twitter', Twitter);\n let twitter = container.lookup('api:twitter', { singleton: false });\nlet twitter2 = container.lookup('api:twitter', { singleton: false });\n twitter === twitter2; //=> false\n```",
       "access": "private",
       "tagname": "",
@@ -4913,7 +4913,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 158,
+      "line": 161,
       "description": "A depth first traversal, destroying the container, its descendant containers and all\ntheir managed objects.",
       "access": "private",
       "tagname": "",
@@ -4925,7 +4925,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 175,
+      "line": 178,
       "description": "Clear either the entire cache or just the cache for a particular key.",
       "access": "private",
       "tagname": "",
@@ -4944,7 +4944,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 192,
+      "line": 195,
       "description": "Returns an object that can be used to provide an owner to a\nmanually created instance.",
       "access": "private",
       "tagname": "",
@@ -4960,7 +4960,7 @@
     },
     {
       "file": "packages/@ember/-internals/container/lib/container.ts",
-      "line": 205,
+      "line": 208,
       "description": "Given a fullName, return the corresponding factory. The consumer of the factory\nis responsible for the destruction of any factory instances, as there is no\nway for the container to ensure instances are destroyed when it itself is\ndestroyed.",
       "access": "public",
       "tagname": "",
@@ -9948,7 +9948,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 139,
+      "line": 138,
       "description": "The name of the route, dot-delimited.\n\nFor example, a route found at `app/routes/posts/post.js` will have\na `routeName` of `posts.post`.",
       "itemtype": "property",
       "name": "routeName",
@@ -9961,7 +9961,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 152,
+      "line": 151,
       "description": "The name of the route, dot-delimited, including the engine prefix\nif applicable.\n\nFor example, a route found at `addon/routes/posts/post.js` within an\nengine named `admin` will have a `fullRouteName` of `admin.posts.post`.",
       "itemtype": "property",
       "name": "fullRouteName",
@@ -9974,7 +9974,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 166,
+      "line": 165,
       "description": "Sets the name for this route, including a fully resolved name for routes\ninside engines.",
       "access": "private",
       "tagname": "",
@@ -9992,7 +9992,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 179,
+      "line": 178,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -10002,7 +10002,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 210,
+      "line": 209,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -10012,7 +10012,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 219,
+      "line": 218,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -10022,7 +10022,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 227,
+      "line": 226,
       "description": "Returns a hash containing the parameters of an ancestor route.\n\nYou may notice that `this.paramsFor` sometimes works when referring to a\nchild route, but this behavior should not be relied upon as only ancestor\nroutes are certain to be loaded in time.\n\nExample\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('member', { path: ':name' }, function() {\n    this.route('interest', { path: ':interest' });\n  });\n});\n```\n\n```app/routes/member.js\nimport Route from '@ember/routing/route';\n\nexport default class MemberRoute extends Route {\n  queryParams = {\n    memberQp: { refreshModel: true }\n  }\n}\n```\n\n```app/routes/member/interest.js\nimport Route from '@ember/routing/route';\n\nexport default class MemberInterestRoute extends Route {\n  queryParams = {\n    interestQp: { refreshModel: true }\n  }\n\n  model() {\n    return this.paramsFor('member');\n  }\n}\n```\n\nIf we visit `/turing/maths?memberQp=member&interestQp=interest` the model for\nthe `member.interest` route is a hash with:\n\n* `name`: `turing`\n* `memberQp`: `member`",
       "itemtype": "method",
       "name": "paramsFor",
@@ -10045,7 +10045,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 306,
+      "line": 305,
       "description": "Serializes the query parameter key",
       "itemtype": "method",
       "name": "serializeQueryParamKey",
@@ -10063,7 +10063,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 317,
+      "line": 316,
       "description": "Serializes value of the query parameter based on defaultValueType",
       "itemtype": "method",
       "name": "serializeQueryParam",
@@ -10091,7 +10091,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 333,
+      "line": 332,
       "description": "Deserializes value of the query parameter based on defaultValueType",
       "itemtype": "method",
       "name": "deserializeQueryParam",
@@ -10119,7 +10119,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 349,
+      "line": 348,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -10129,7 +10129,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 358,
+      "line": 357,
       "description": "A hook you can use to reset controller values either when the model\nchanges or the route is exiting.\n\n```app/routes/articles.js\nimport Route from '@ember/routing/route';\n\nexport default class ArticlesRoute extends Route {\n  resetController(controller, isExiting, transition) {\n    if (isExiting && transition.targetName !== 'error') {\n      controller.set('page', 1);\n    }\n  }\n}\n```",
       "itemtype": "method",
       "name": "resetController",
@@ -10158,7 +10158,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 385,
+      "line": 384,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -10168,7 +10168,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 396,
+      "line": 395,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -10179,7 +10179,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 409,
+      "line": 408,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -10189,7 +10189,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 420,
+      "line": 419,
       "description": "The `willTransition` action is fired at the beginning of any\nattempted transition with a `Transition` object as the sole\nargument. This action can be used for aborting, redirecting,\nor decorating the transition from the currently active routes.\n\nA good example is preventing navigation when a form is\nhalf-filled out:\n\n```app/routes/contact-form.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class ContactFormRoute extends Route {\n  @action\n  willTransition(transition) {\n    if (this.controller.get('userHasEnteredData')) {\n      this.controller.displayNavigationConfirm();\n      transition.abort();\n    }\n  }\n}\n```\n\nYou can also redirect elsewhere by calling\n`this.transitionTo('elsewhere')` from within `willTransition`.\nNote that `willTransition` will not be fired for the\nredirecting `transitionTo`, since `willTransition` doesn't\nfire when there is already a transition underway. If you want\nsubsequent `willTransition` actions to fire for the redirecting\ntransition, you must first explicitly call\n`transition.abort()`.\n\nTo allow the `willTransition` event to continue bubbling to the parent\nroute, use `return true;`. When the `willTransition` method has a\nreturn value of `true` then the parent route's `willTransition` method\nwill be fired, enabling \"bubbling\" behavior for the event.",
       "itemtype": "event",
       "name": "willTransition",
@@ -10208,7 +10208,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 464,
+      "line": 463,
       "description": "The `didTransition` action is fired after a transition has\nsuccessfully been completed. This occurs after the normal model\nhooks (`beforeModel`, `model`, `afterModel`, `setupController`)\nhave resolved. The `didTransition` action has no arguments,\nhowever, it can be useful for tracking page views or resetting\nstate on the controller.\n\n```app/routes/login.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class LoginRoute extends Route {\n  @action\n  didTransition() {\n    this.controller.get('errors.base').clear();\n    return true; // Bubble the didTransition event\n  }\n}\n```",
       "itemtype": "event",
       "name": "didTransition",
@@ -10220,7 +10220,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 490,
+      "line": 489,
       "description": "The `loading` action is fired on the route when a route's `model`\nhook returns a promise that is not already resolved. The current\n`Transition` object is the first parameter and the route that\ntriggered the loading event is the second parameter.\n\n```app/routes/application.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class ApplicationRoute extends Route {\n  @action\n  loading(transition, route) {\n    let controller = this.controllerFor('foo');\n\n    // The controller may not be instantiated when initially loading\n    if (controller) {\n      controller.currentlyLoading = true;\n\n      transition.finally(function() {\n        controller.currentlyLoading = false;\n      });\n    }\n  }\n}\n```",
       "itemtype": "event",
       "name": "loading",
@@ -10244,7 +10244,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 524,
+      "line": 523,
       "description": "When attempting to transition into a route, any of the hooks\nmay return a promise that rejects, at which point an `error`\naction will be fired on the partially-entered routes, allowing\nfor per-route error handling logic, or shared error handling\nlogic defined on a parent route.\n\nHere is an example of an error handler that will be invoked\nfor rejected promises from the various hooks on the route,\nas well as any unhandled errors from child routes:\n\n```app/routes/admin.js\nimport { reject } from 'rsvp';\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class AdminRoute extends Route {\n  beforeModel() {\n    return reject('bad things!');\n  }\n\n  @action\n  error(error, transition) {\n    // Assuming we got here due to the error in `beforeModel`,\n    // we can expect that error === \"bad things!\",\n    // but a promise model rejecting would also\n    // call this hook, as would any errors encountered\n    // in `afterModel`.\n\n    // The `error` hook is also provided the failed\n    // `transition`, which can be stored and later\n    // `.retry()`d if desired.\n\n    this.transitionTo('login');\n  }\n}\n```\n\n`error` actions that bubble up all the way to `ApplicationRoute`\nwill fire a default error handler that logs the error. You can\nspecify your own global default error handler by overriding the\n`error` handler on `ApplicationRoute`:\n\n```app/routes/application.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class ApplicationRoute extends Route {\n  @action\n  error(error, transition) {\n    this.controllerFor('banner').displayError(error.message);\n  }\n}\n```",
       "itemtype": "event",
       "name": "error",
@@ -10268,7 +10268,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 585,
+      "line": 584,
       "description": "This event is triggered when the router enters the route. It is\nnot executed when the model for the route changes.\n\n```app/routes/application.js\nimport { on } from '@ember/object/evented';\nimport Route from '@ember/routing/route';\n\nexport default Route.extend({\n  collectAnalytics: on('activate', function(){\n    collectAnalytics();\n  })\n});\n```",
       "itemtype": "event",
       "name": "activate",
@@ -10280,7 +10280,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 605,
+      "line": 604,
       "description": "This event is triggered when the router completely exits this\nroute. It is not executed when the model for the route changes.\n\n```app/routes/index.js\nimport { on } from '@ember/object/evented';\nimport Route from '@ember/routing/route';\n\nexport default Route.extend({\n  trackPageLeaveAnalytics: on('deactivate', function(){\n    trackPageLeaveAnalytics();\n  })\n});\n```",
       "itemtype": "event",
       "name": "deactivate",
@@ -10292,7 +10292,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 625,
+      "line": 624,
       "description": "This hook is executed when the router completely exits this route. It is\nnot executed when the model for the route changes.",
       "itemtype": "method",
       "name": "deactivate",
@@ -10311,7 +10311,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 636,
+      "line": 635,
       "description": "This hook is executed when the router enters the route. It is not executed\nwhen the model for the route changes.",
       "itemtype": "method",
       "name": "activate",
@@ -10330,7 +10330,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 647,
+      "line": 646,
       "description": "Transition the application into another route. The route may\nbe either a single route or route path:\n\n```javascript\nthis.transitionTo('blogPosts');\nthis.transitionTo('blogPosts.recentEntries');\n```\n\nOptionally supply a model for the route in question. The model\nwill be serialized into the URL using the `serialize` hook of\nthe route:\n\n```javascript\nthis.transitionTo('blogPost', aPost);\n```\n\nIf a literal is passed (such as a number or a string), it will\nbe treated as an identifier instead. In this case, the `model`\nhook of the route will be triggered:\n\n```javascript\nthis.transitionTo('blogPost', 1);\n```\n\nMultiple models will be applied last to first recursively up the\nroute tree.\n\n```app/routes.js\n// ...\n\nRouter.map(function() {\n  this.route('blogPost', { path:':blogPostId' }, function() {\n    this.route('blogComment', { path: ':blogCommentId' });\n  });\n});\n\nexport default Router;\n```\n\n```javascript\nthis.transitionTo('blogComment', aPost, aComment);\nthis.transitionTo('blogComment', 1, 13);\n```\n\nIt is also possible to pass a URL (a string that starts with a\n`/`).\n\n```javascript\nthis.transitionTo('/');\nthis.transitionTo('/blog/post/1/comment/13');\nthis.transitionTo('/blog/posts?sort=title');\n```\n\nAn options hash with a `queryParams` property may be provided as\nthe final argument to add query parameters to the destination URL.\n\n```javascript\nthis.transitionTo('blogPost', 1, {\n  queryParams: { showComments: 'true' }\n});\n\n// if you just want to transition the query parameters without changing the route\nthis.transitionTo({ queryParams: { sort: 'date' } });\n```\n\nSee also [replaceWith](#method_replaceWith).\n\nSimple Transition Example\n\n```app/routes.js\n// ...\n\nRouter.map(function() {\n  this.route('index');\n  this.route('secret');\n  this.route('fourOhFour', { path: '*:' });\n});\n\nexport default Router;\n```\n\n```app/routes/index.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class IndexRoute extends Route {\n  @action\n  moveToSecret(context) {\n    if (authorized()) {\n      this.transitionTo('secret', context);\n    } else {\n      this.transitionTo('fourOhFour');\n    }\n  }\n}\n```\n\nTransition to a nested route\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('articles', { path: '/articles' }, function() {\n    this.route('new');\n  });\n});\n\nexport default Router;\n```\n\n```app/routes/index.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class IndexRoute extends Route {\n  @action\n  transitionToNewArticle() {\n    this.transitionTo('articles.new');\n  }\n}\n```\n\nMultiple Models Example\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('index');\n\n  this.route('breakfast', { path: ':breakfastId' }, function() {\n    this.route('cereal', { path: ':cerealId' });\n  });\n});\n\nexport default Router;\n```\n\n```app/routes/index.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class IndexRoute extends Route {\n  @action\n  moveToChocolateCereal() {\n    let cereal = { cerealId: 'ChocolateYumminess' };\n    let breakfast = { breakfastId: 'CerealAndMilk' };\n\n    this.transitionTo('breakfast.cereal', breakfast, cereal);\n  }\n}\n```\n\nNested Route with Query String Example\n\n```app/routes.js\n// ...\n\nRouter.map(function() {\n  this.route('fruits', function() {\n    this.route('apples');\n  });\n});\n\nexport default Router;\n```\n\n```app/routes/index.js\nimport Route from '@ember/routing/route';\n\nexport default class IndexRoute extends Route {\n  @action\n  transitionToApples() {\n    this.transitionTo('fruits.apples', { queryParams: { color: 'red' } });\n  }\n}\n```",
       "itemtype": "method",
       "name": "transitionTo",
@@ -10368,7 +10368,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 845,
+      "line": 844,
       "description": "Perform a synchronous transition into another route without attempting\nto resolve promises, update the URL, or abort any currently active\nasynchronous transitions (i.e. regular transitions caused by\n`transitionTo` or URL changes).\n\nThis method is handy for performing intermediate transitions on the\nway to a final destination route, and is called internally by the\ndefault implementations of the `error` and `loading` handlers.",
       "itemtype": "method",
       "name": "intermediateTransitionTo",
@@ -10392,7 +10392,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 867,
+      "line": 866,
       "description": "Refresh the model on this route and any child routes, firing the\n`beforeModel`, `model`, and `afterModel` hooks in a similar fashion\nto how routes are entered when transitioning in from other route.\nThe current route params (e.g. `article_id`) will be passed in\nto the respective model hooks, and if a different model is returned,\n`setupController` and associated route hooks will re-fire as well.\n\nAn example usage of this method is re-querying the server for the\nlatest information using the same parameters as when the route\nwas first entered.\n\nNote that this will cause `model` hooks to fire even on routes\nthat were provided a model object when the route was initially\nentered.",
       "itemtype": "method",
       "name": "refresh",
@@ -10408,7 +10408,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 893,
+      "line": 892,
       "description": "Transition into another route while replacing the current URL, if possible.\nThis will replace the current history entry instead of adding a new one.\nBeside that, it is identical to `transitionTo` in all other respects. See\n'transitionTo' for additional information regarding multiple models.\n\nExample\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('index');\n  this.route('secret');\n});\n\nexport default Router;\n```\n\n```app/routes/secret.js\nimport Route from '@ember/routing/route';\n\nexport default class SecretRoute Route {\n  afterModel() {\n    if (!authorized()){\n      this.replaceWith('index');\n    }\n  }\n}\n```",
       "itemtype": "method",
       "name": "replaceWith",
@@ -10442,7 +10442,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 940,
+      "line": 939,
       "description": "This hook is the entry point for router.js",
       "access": "private",
       "tagname": "",
@@ -10453,7 +10453,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1033,
+      "line": 1032,
       "description": "This hook is the first of the route entry validation hooks\ncalled when an attempt is made to transition into a route\nor one of its children. It is called before `model` and\n`afterModel`, and is appropriate for cases when:\n\n1) A decision can be made to redirect elsewhere without\n   needing to resolve the model first.\n2) Any async operations need to occur first before the\n   model is attempted to be resolved.\n\nThis hook is provided the current `transition` attempt\nas a parameter, which can be used to `.abort()` the transition,\nsave it for a later `.retry()`, or retrieve values set\non it from a previous hook. You can also just call\n`this.transitionTo` to another route to implicitly\nabort the `transition`.\n\nYou can return a promise from this hook to pause the\ntransition until the promise resolves (or rejects). This could\nbe useful, for instance, for retrieving async code from\nthe server that is required to enter a route.",
       "itemtype": "method",
       "name": "beforeModel",
@@ -10476,7 +10476,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1067,
+      "line": 1066,
       "description": "This hook is called after this route's model has resolved.\nIt follows identical async/promise semantics to `beforeModel`\nbut is provided the route's resolved model in addition to\nthe `transition`, and is therefore suited to performing\nlogic that can only take place after the model has already\nresolved.\n\n```app/routes/posts.js\nimport Route from '@ember/routing/route';\n\nexport default class PostsRoute extends Route {\n  afterModel(posts, transition) {\n    if (posts.get('length') === 1) {\n      this.transitionTo('post.show', posts.get('firstObject'));\n    }\n  }\n}\n```\n\nRefer to documentation for `beforeModel` for a description\nof transition-pausing semantics when a promise is returned\nfrom this hook.",
       "itemtype": "method",
       "name": "afterModel",
@@ -10504,7 +10504,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1104,
+      "line": 1103,
       "description": "A hook you can implement to optionally redirect to another route.\n\nCalling `this.transitionTo` from inside of the `redirect` hook will\nabort the current transition (into the route that has implemented `redirect`).\n\n`redirect` and `afterModel` behave very similarly and are\ncalled almost at the same time, but they have an important\ndistinction when calling `this.transitionTo` to a child route\nof the current route. From `afterModel`, this new transition\ninvalidates the current transition, causing `beforeModel`,\n`model`, and `afterModel` hooks to be called again. But the\nsame transition started from `redirect` does _not_ invalidate\nthe current transition. In other words, by the time the `redirect`\nhook has been called, both the resolved model and the attempted\nentry into this route are considered fully validated.",
       "itemtype": "method",
       "name": "redirect",
@@ -10528,7 +10528,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1129,
+      "line": 1128,
       "description": "Called when the context is changed by router.js.",
       "access": "private",
       "tagname": "",
@@ -10539,7 +10539,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1139,
+      "line": 1138,
       "description": "A hook you can implement to convert the URL into the model for\nthis route.\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('post', { path: '/posts/:post_id' });\n});\n\nexport default Router;\n```\n\nThe model for the `post` route is `store.findRecord('post', params.post_id)`.\n\nBy default, if your route has a dynamic segment ending in `_id`:\n\n* The model class is determined from the segment (`post_id`'s\n  class is `App.Post`)\n* The find method is called on the model class with the value of\n  the dynamic segment.\n\nNote that for routes with dynamic segments, this hook is not always\nexecuted. If the route is entered through a transition (e.g. when\nusing the `link-to` Handlebars helper or the `transitionTo` method\nof routes), and a model context is already provided this hook\nis not called.\n\nA model context does not include a primitive string or number,\nwhich does cause the model hook to be called.\n\nRoutes without dynamic segments will always execute the model hook.\n\n```javascript\n// no dynamic segment, model hook always called\nthis.transitionTo('posts');\n\n// model passed in, so model hook not called\nthePost = store.findRecord('post', 1);\nthis.transitionTo('post', thePost);\n\n// integer passed in, model hook is called\nthis.transitionTo('post', 1);\n\n// model id passed in, model hook is called\n// useful for forcing the hook to execute\nthePost = store.findRecord('post', 1);\nthis.transitionTo('post', thePost.id);\n```\n\nThis hook follows the asynchronous/promise semantics\ndescribed in the documentation for `beforeModel`. In particular,\nif a promise returned from `model` fails, the error will be\nhandled by the `error` hook on `Route`.\n\nExample\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\n\nexport default class PostRoute extends Route {\n  model(params) {\n    return this.store.findRecord('post', params.post_id);\n  }\n}\n```",
       "itemtype": "method",
       "name": "model",
@@ -10567,7 +10567,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1248,
+      "line": 1247,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -10593,7 +10593,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1261,
+      "line": 1260,
       "itemtype": "method",
       "name": "findModel",
       "params": [
@@ -10615,7 +10615,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1272,
+      "line": 1271,
       "description": "A hook you can use to setup the controller for the current route.\n\nThis method is called with the controller for the current route and the\nmodel supplied by the `model` hook.\n\nBy default, the `setupController` hook sets the `model` property of\nthe controller to the specified `model` when it is not `undefined`.\n\nIf you implement the `setupController` hook in your Route, it will\nprevent this default behavior. If you want to preserve that behavior\nwhen implementing your `setupController` function, make sure to call\n`super`:\n\n```app/routes/photos.js\nimport Route from '@ember/routing/route';\n\nexport default class PhotosRoute extends Route {\n  model() {\n    return this.store.findAll('photo');\n  }\n\n  setupController(controller, model) {\n    super.setupController(controller, model);\n\n    this.controllerFor('application').set('showingPhotos', true);\n  }\n}\n```\n\nThe provided controller will be one resolved based on the name\nof this route.\n\nIf no explicit controller is defined, Ember will automatically create one.\n\nAs an example, consider the router:\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('post', { path: '/posts/:post_id' });\n});\n\nexport default Router;\n```\n\nIf you have defined a file for the post controller,\nthe framework will use it.\nIf it is not defined, a basic `Controller` instance would be used.",
       "example": [
         " Behavior of a basic Controller\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\n\nexport default class PostRoute extends Route {\n  setupController(controller, model) {\n    controller.set('model', model);\n  }\n});\n```"
@@ -10647,7 +10647,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1349,
+      "line": 1348,
       "description": "Returns the controller of the current route, or a parent (or any ancestor)\nroute in a route hierarchy.\n\nThe controller instance must already have been created, either through entering the\nassociated route or using `generateController`.\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\n\nexport default class PostRoute extends Route {\n  setupController(controller, post) {\n    super.setupController(controller, post);\n\n    this.controllerFor('posts').set('currentPost', post);\n  }\n}\n```",
       "itemtype": "method",
       "name": "controllerFor",
@@ -10670,7 +10670,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1395,
+      "line": 1394,
       "description": "Generates a controller for a route.\n\nExample\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\n\nexport default class Post extends Route {\n  setupController(controller, post) {\n    super.setupController(controller, post);\n\n    this.generateController('posts');\n  }\n}\n```",
       "itemtype": "method",
       "name": "generateController",
@@ -10688,7 +10688,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1422,
+      "line": 1421,
       "description": "Returns the resolved model of a parent (or any ancestor) route\nin a route hierarchy.  During a transition, all routes\nmust resolve a model object, and if a route\nneeds access to a parent route's model in order to\nresolve a model (or just reuse the model from a parent),\nit can call `this.modelFor(theNameOfParentRoute)` to\nretrieve it. If the ancestor route's model was a promise,\nits resolved result is returned.\n\nExample\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('post', { path: '/posts/:post_id' }, function() {\n    this.route('comments');\n  });\n});\n\nexport default Router;\n```\n\n```app/routes/post/comments.js\nimport Route from '@ember/routing/route';\n\nexport default class PostCommentsRoute extends Route {\n  model() {\n    let post = this.modelFor('post');\n\n    return post.comments;\n  }\n}\n```",
       "itemtype": "method",
       "name": "modelFor",
@@ -10711,7 +10711,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1493,
+      "line": 1492,
       "description": "`this[RENDER]` is used to render a template into a region of another template\n(indicated by an `{{outlet}}`).",
       "itemtype": "method",
       "name": "this[RENDER]",
@@ -10761,7 +10761,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1516,
+      "line": 1515,
       "description": "A hook you can use to render the template for the current route.\n\nThis method is called with the controller for the current route and the\nmodel supplied by the `model` hook. By default, it renders the route's\ntemplate, configured with the controller for the route.\n\nThis method can be overridden to set up and render additional or\nalternative templates.\n\n```app/routes/posts.js\nimport Route from '@ember/routing/route';\n\nexport default class PostsRoute extends Route {\n  renderTemplate(controller, model) {\n    let favController = this.controllerFor('favoritePost');\n\n    // Render the `favoritePost` template into\n    // the outlet `posts`, and display the `favoritePost`\n    // controller.\n    this.render('favoritePost', {\n      outlet: 'posts',\n      controller: favController\n    });\n  }\n}\n```",
       "itemtype": "method",
       "name": "renderTemplate",
@@ -10785,7 +10785,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1555,
+      "line": 1554,
       "description": "`render` is used to render a template into a region of another template\n(indicated by an `{{outlet}}`). `render` is used both during the entry\nphase of routing (via the `renderTemplate` hook) and later in response to\nuser interaction.\n\nFor example, given the following minimal router and templates:\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('photos');\n});\n\nexport default Router;\n```\n\n```handlebars\n<!-- application.hbs -->\n<div class='something-in-the-app-hbs'>\n  {{outlet \"anOutletName\"}}\n</div>\n```\n\n```handlebars\n<!-- photos.hbs -->\n<h1>Photos</h1>\n```\n\nYou can render `photos.hbs` into the `\"anOutletName\"` outlet of\n`application.hbs` by calling `render`:\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\n\nexport default class PostRoute extends Route {\n  renderTemplate() {\n    this.render('photos', {\n      into: 'application',\n      outlet: 'anOutletName'\n    })\n  }\n}\n```\n\n`render` additionally allows you to supply which `controller` and\n`model` objects should be loaded and associated with the rendered template.\n\n```app/routes/posts.js\nimport Route from '@ember/routing/route';\n\nexport default class PostsRoute extends Route {\n  renderTemplate(controller, model) {\n    this.render('posts', {    // the template to render, referenced by name\n      into: 'application',    // the template to render into, referenced by name\n      outlet: 'anOutletName', // the outlet inside `options.into` to render into.\n      controller: 'someControllerName', // the controller to use for this template, referenced by name\n      model: model            // the model to set on `options.controller`.\n    })\n  }\n}\n```\n\nThe string values provided for the template name, and controller\nwill eventually pass through to the resolver for lookup. See\nResolver for how these are mapped to JavaScript objects in your\napplication. The template to render into needs to be related to  either the\ncurrent route or one of its ancestors.\n\nNot all options need to be passed to `render`. Default values will be used\nbased on the name of the route specified in the router or the Route's\n`controllerName` and `templateName` properties.\n\nFor example:\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('index');\n  this.route('post', { path: '/posts/:post_id' });\n});\n\nexport default Router;\n```\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\n\nexport default class PostRoute extends Route {\n  renderTemplate() {\n    this.render(); // all defaults apply\n  }\n}\n```\n\nThe name of the route, defined by the router, is `post`.\n\nThe following equivalent default options will be applied when\nthe Route calls `render`:\n\n```javascript\nthis.render('post', {  // the template name associated with 'post' Route\n  into: 'application', // the parent route to 'post' Route\n  outlet: 'main',      // {{outlet}} and {{outlet 'main'}} are synonymous,\n  controller: 'post',  // the controller associated with the 'post' Route\n})\n```\n\nBy default the controller's `model` will be the route's model, so it does not\nneed to be passed unless you wish to change which model is being used.",
       "itemtype": "method",
       "name": "render",
@@ -10836,7 +10836,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1695,
+      "line": 1694,
       "description": "Disconnects a view that has been rendered into an outlet.\n\nYou may pass any or all of the following options to `disconnectOutlet`:\n\n* `outlet`: the name of the outlet to clear (default: 'main')\n* `parentView`: the name of the view containing the outlet to clear\n   (default: the view rendered by the parent route)\n\nExample:\n\n```app/routes/application.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class ApplicationRoute extends Route {\n  @action\n  showModal(evt) {\n    this.render(evt.modalName, {\n      outlet: 'modal',\n      into: 'application'\n    });\n  }\n\n  @action\n  hideModal() {\n    this.disconnectOutlet({\n      outlet: 'modal',\n      parentView: 'application'\n    });\n  }\n}\n```\n\nAlternatively, you can pass the `outlet` name directly as a string.\n\nExample:\n\n```app/routes/application.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class ApplicationRoute extends Route {\n  @action\n  showModal(evt) {\n    // ...\n  }\n\n  @action\n  hideModal(evt) {\n    this.disconnectOutlet('modal');\n  }\n}\n```",
       "itemtype": "method",
       "name": "disconnectOutlet",
@@ -10855,7 +10855,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1826,
+      "line": 1825,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -10865,7 +10865,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 1839,
+      "line": 1838,
       "description": "Allows you to produce custom metadata for the route.\nThe return value of this method will be attached to\nits corresponding RouteInfoWithAttributes object.\n\nExample\n\n```app/routes/posts/index.js\nimport Route from '@ember/routing/route';\n\nexport default class PostsIndexRoute extends Route {\n  buildRouteInfoMetadata() {\n    return { title: 'Posts Page' }\n  }\n}\n```\n\n```app/routes/application.js\nimport Route from '@ember/routing/route';\nimport { inject as service } from '@ember/service';\n\nexport default class ApplicationRoute extends Route {\n  @service router\n\n  constructor() {\n    super(...arguments);\n\n    this.router.on('routeDidChange', transition => {\n      document.title = transition.to.metadata.title;\n      // would update document's title to \"Posts Page\"\n    });\n  }\n}\n```",
       "itemtype": "method",
       "name": "buildRouteInfoMetadata",
@@ -10880,7 +10880,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2163,
+      "line": 2162,
       "description": "A hook you can implement to convert the route's model into parameters\nfor the URL.\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('post', { path: '/posts/:post_id' });\n});\n\n```\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\n\nexport default class PostRoute extends Route {\n  model({ post_id }) {\n    // the server returns `{ id: 12 }`\n    return fetch(`/posts/${post_id}`;\n  }\n\n  serialize(model) {\n    // this will make the URL `/posts/12`\n    return { post_id: model.id };\n  }\n}\n```\n\nThe default `serialize` method will insert the model's `id` into the\nroute's dynamic segment (in this case, `:post_id`) if the segment contains '_id'.\nIf the route has multiple dynamic segments or does not contain '_id', `serialize`\nwill return `getProperties(model, params)`\n\nThis method is called when `transitionTo` is called with a context\nin order to populate the URL.",
       "itemtype": "method",
       "name": "serialize",
@@ -10908,7 +10908,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2213,
+      "line": 2212,
       "description": "Configuration hash for this route's queryParams. The possible\nconfiguration options and their defaults are as follows\n(assuming a query param whose controller property is `page`):\n\n```javascript\nqueryParams: {\n  page: {\n    // By default, controller query param properties don't\n    // cause a full transition when they are changed, but\n    // rather only cause the URL to update. Setting\n    // `refreshModel` to true will cause an \"in-place\"\n    // transition to occur, whereby the model hooks for\n    // this route (and any child routes) will re-fire, allowing\n    // you to reload models (e.g., from the server) using the\n    // updated query param values.\n    refreshModel: false,\n\n    // By default, changes to controller query param properties\n    // cause the URL to update via `pushState`, which means an\n    // item will be added to the browser's history, allowing\n    // you to use the back button to restore the app to the\n    // previous state before the query param property was changed.\n    // Setting `replace` to true will use `replaceState` (or its\n    // hash location equivalent), which causes no browser history\n    // item to be added. This options name and default value are\n    // the same as the `link-to` helper's `replace` option.\n    replace: false,\n\n    // By default, the query param URL key is the same name as\n    // the controller property name. Use `as` to specify a\n    // different URL key.\n    as: 'page'\n  }\n}\n```",
       "itemtype": "property",
       "name": "queryParams",
@@ -10921,7 +10921,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2258,
+      "line": 2257,
       "description": "The name of the template to use by default when rendering this routes\ntemplate.\n\n```app/routes/posts/list.js\nimport Route from '@ember/routing/route';\n\nexport default class extends Route {\n  templateName = 'posts/list'\n});\n```\n\n```app/routes/posts/index.js\nimport PostsList from '../posts/list';\n\nexport default class extends PostsList {};\n```\n\n```app/routes/posts/archived.js\nimport PostsList from '../posts/list';\n\nexport default class extends PostsList {};\n```",
       "itemtype": "property",
       "name": "templateName",
@@ -10935,7 +10935,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2290,
+      "line": 2289,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -10945,7 +10945,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2297,
+      "line": 2296,
       "description": "The name of the controller to associate with this route.\n\nBy default, Ember will lookup a route's controller that matches the name\nof the route (i.e. `posts.new`). However,\nif you would like to define a specific controller to use, you can do so\nusing this property.\n\nThis is useful in many ways, as the controller specified will be:\n\n* passed to the `setupController` method.\n* used as the controller for the template being rendered by the route.\n* returned from a call to `controllerFor` for the route.",
       "itemtype": "property",
       "name": "controllerName",
@@ -10959,7 +10959,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2319,
+      "line": 2318,
       "description": "Store property provides a hook for data persistence libraries to inject themselves.\n\nBy default, this store property provides the exact same functionality previously\nin the model hook.\n\nCurrently, the required interface is:\n\n`store.find(modelName, findArguments)`",
       "itemtype": "property",
       "name": "store",
@@ -10971,7 +10971,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2371,
+      "line": 2407,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -10981,7 +10981,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2498,
+      "line": 2534,
       "description": "Sends an action to the router, which will delegate it to the currently\nactive route hierarchy per the bubbling rules explained under `actions`.\n\nExample\n\n```app/router.js\n// ...\n\nRouter.map(function() {\n  this.route('index');\n});\n\nexport default Router;\n```\n\n```app/routes/application.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class ApplicationRoute extends Route {\n  @action\n  track(arg) {\n    console.log(arg, 'was clicked');\n  }\n}\n```\n\n```app/routes/index.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class IndexRoute extends Route {\n  @action\n  trackIfDebug(arg) {\n    if (debug) {\n      this.send('track', arg);\n    }\n  }\n}\n```",
       "itemtype": "method",
       "name": "send",
@@ -11005,7 +11005,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2561,
+      "line": 2597,
       "description": "The controller associated with this route.\n\nExample\n\n```app/routes/form.js\nimport Route from '@ember/routing/route';\nimport { action } from '@ember/object';\n\nexport default class FormRoute extends Route {\n  @action\n  willTransition(transition) {\n    if (this.controller.get('userHasEnteredData') &&\n        !confirm('Are you sure you want to abandon progress?')) {\n      transition.abort();\n    } else {\n      // Bubble the `willTransition` action so that\n      // parent routes can decide whether or not to abort.\n      return true;\n    }\n  }\n}\n```",
       "itemtype": "property",
       "name": "controller",
@@ -11018,7 +11018,7 @@
     },
     {
       "file": "packages/@ember/-internals/routing/lib/system/route.ts",
-      "line": 2592,
+      "line": 2628,
       "description": "This action is called when one or more query params have changed. Bubbles.",
       "itemtype": "method",
       "name": "queryParamsDidChange",
@@ -20119,7 +20119,7 @@
   "warnings": [
     {
       "message": "replacing incorrect tag: returns with return",
-      "line": " packages/@ember/-internals/container/lib/container.ts:192"
+      "line": " packages/@ember/-internals/container/lib/container.ts:195"
     },
     {
       "message": "unknown tag: decorator",
@@ -20135,7 +20135,7 @@
     },
     {
       "message": "replacing incorrect tag: returns with return",
-      "line": " packages/@ember/-internals/routing/lib/system/route.ts:2592"
+      "line": " packages/@ember/-internals/routing/lib/system/route.ts:2628"
     },
     {
       "message": "replacing incorrect tag: function with method",