ember-source 5.4.0-alpha.2 → 5.4.0-alpha.4

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": "5.4.0-alpha.2"
+    "version": "5.4.0-alpha.4"
   },
   "files": {
     "node_modules/rsvp/lib/rsvp/promise/all.js": {
@@ -229,9 +229,7 @@
     },
     "packages/@ember/-internals/glimmer/lib/components/link-to.ts": {
       "name": "packages/@ember/-internals/glimmer/lib/components/link-to.ts",
-      "modules": {
-        "@ember/routing": 1
-      },
+      "modules": {},
       "classes": {},
       "fors": {
         "Ember.Templates.components": 1,
@@ -1382,7 +1380,7 @@
     "packages/@ember/routing/lib/controller_for.ts": {
       "name": "packages/@ember/routing/lib/controller_for.ts",
       "modules": {
-        "ember/routing": 1
+        "@ember/routing": 1
       },
       "classes": {},
       "fors": {
@@ -1798,12 +1796,13 @@
       },
       "fors": {
         "Ember.Templates.helpers": 1,
-        "@ember/routing": 1
+        "@ember/routing": 1,
+        "Ember": 1
       },
       "namespaces": {},
       "tag": "module",
-      "file": "packages/@ember/-internals/glimmer/lib/components/link-to.ts",
-      "line": 251
+      "file": "packages/@ember/routing/lib/controller_for.ts",
+      "line": 5
     },
     "ember": {
       "name": "ember",
@@ -2337,19 +2336,6 @@
       "access": "public",
       "tagname": ""
     },
-    "ember/routing": {
-      "name": "ember/routing",
-      "submodules": {},
-      "elements": {},
-      "classes": {},
-      "fors": {
-        "Ember": 1
-      },
-      "namespaces": {},
-      "tag": "module",
-      "file": "packages/@ember/routing/lib/controller_for.ts",
-      "line": 5
-    },
     "@ember/routing/hash-location": {
       "name": "@ember/routing/hash-location",
       "submodules": {},
@@ -15034,7 +15020,7 @@
     {
       "file": "packages/@ember/renderer/index.ts",
       "line": 11,
-      "description": "Returns a promise which will resolve when rendering has completed. In\nthis context, rendering is completed when all auto-tracked state that is\nconsumed in the template (including any tracked state in models, services,\netc. that are then used in a template) has been updated in the DOM.\n\nFor example, in a test you might want to update some tracked state and\nthen run some assertions after rendering has completed. You _could_ use\n`await settled()` in that location, but in some contexts you don't want to\nwait for full settledness (which includes test waiters, pending AJAX/fetch,\nrun loops, etc) but instead only want to know when that updated value has\nbeen rendered in the DOM. **THAT** is what `await renderSettled()` is\n_perfect_ for.\n\n```js\nimport { renderSettled } from '@ember/renderer';\nimport { render } from '@ember/test-helpers';\nimport { tracked } from '@glimmer/tracking';\nimport { hbs } from 'ember-cli-htmlbars';\nimport { setupRenderingTest } from 'my-app/tests/helpers';\nimport { module, test } from 'qunit';\n\nmodule('Integration | Component | profile-card', function (hooks) {\n  setupRenderingTest(hooks);\n\n  test(\"it renders the person's name\", async function (assert) {\n    class Person {\n      @tracked name = '';\n    }\n\n    this.person = new Person();\n    this.person.name = 'John';\n\n    await render(hbs`\n      <ProfileCard @name={{this.person.name}} />\n    `);\n\n    assert.dom(this.element).hasText('John');\n\n    this.person.name = 'Jane';\n\n    await renderSettled(); // Wait until rendering has completed.\n\n    assert.dom(this.element).hasText('Jane');\n  });\n});\n```",
+      "description": "Returns a promise which will resolve when rendering has completed. In\nthis context, rendering is completed when all auto-tracked state that is\nconsumed in the template (including any tracked state in models, services,\netc. that are then used in a template) has been updated in the DOM.\n\nFor example, in a test you might want to update some tracked state and\nthen run some assertions after rendering has completed. You _could_ use\n`await settled()` in that location, but in some contexts you don't want to\nwait for full settledness (which includes test waiters, pending AJAX/fetch,\nrun loops, etc) but instead only want to know when that updated value has\nbeen rendered in the DOM. **THAT** is what `await renderSettled()` is\n_perfect_ for.\n\n```js\nimport { renderSettled } from '@ember/renderer';\nimport { render } from '@ember/test-helpers';\nimport { tracked } from '@glimmer/tracking';\nimport { hbs } from 'ember-cli-htmlbars';\nimport { setupRenderingTest } from 'my-app/tests/helpers';\nimport { module, test } from 'qunit';\n\nmodule('Integration | Component | profile-card', function (hooks) {\n  setupRenderingTest(hooks);\n\n  test(\"it renders the person's name\", async function (assert) {\n    class Person {\n      @tracked name = '';\n    }\n\n    this.person = new Person();\n    this.person.name = 'John';\n\n    await render(hbs`\n      <ProfileCard @name={{this.person.name}} />\n    `);\n\n    assert.dom().hasText('John');\n\n    this.person.name = 'Jane';\n\n    await renderSettled(); // Wait until rendering has completed.\n\n    assert.dom().hasText('Jane');\n  });\n});\n```",
       "itemtype": "method",
       "name": "renderSettled",
       "return": {
@@ -15055,7 +15041,7 @@
       "access": "private",
       "tagname": "",
       "class": "Ember",
-      "module": "ember/routing"
+      "module": "@ember/routing"
     },
     {
       "file": "packages/@ember/routing/lib/generate_controller.ts",
@@ -15066,7 +15052,7 @@
       "access": "private",
       "tagname": "",
       "class": "Ember",
-      "module": "ember/routing"
+      "module": "@ember/routing"
     },
     {
       "file": "packages/@ember/routing/lib/generate_controller.ts",
@@ -15078,7 +15064,7 @@
       "tagname": "",
       "since": "1.3.0",
       "class": "Ember",
-      "module": "ember/routing"
+      "module": "@ember/routing"
     },
     {
       "file": "packages/@ember/routing/lib/location-utils.ts",
@@ -15086,7 +15072,7 @@
       "access": "private",
       "tagname": "Returns the current `location.pathname`, normalized for IE inconsistencies.",
       "class": "RoutingService",
-      "module": "ember/routing"
+      "module": "@ember/routing"
     },
     {
       "file": "packages/@ember/routing/lib/location-utils.ts",
@@ -15094,7 +15080,7 @@
       "access": "private",
       "tagname": "Returns the current `location.search`.",
       "class": "RoutingService",
-      "module": "ember/routing"
+      "module": "@ember/routing"
     },
     {
       "file": "packages/@ember/routing/lib/location-utils.ts",
@@ -15102,7 +15088,7 @@
       "access": "private",
       "tagname": "Returns the hash or empty string",
       "class": "RoutingService",
-      "module": "ember/routing"
+      "module": "@ember/routing"
     },
     {
       "file": "packages/@ember/routing/lib/location-utils.ts",
@@ -15111,7 +15097,7 @@
       "access": "private",
       "tagname": "",
       "class": "RoutingService",
-      "module": "ember/routing"
+      "module": "@ember/routing"
     },
     {
       "file": "packages/@ember/routing/hash-location.ts",
@@ -15725,7 +15711,7 @@
     {
       "file": "packages/@ember/routing/route.ts",
       "line": 91,
-      "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.",
+      "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.router.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",
       "params": [
@@ -15780,7 +15766,7 @@
     {
       "file": "packages/@ember/routing/route.ts",
       "line": 198,
-      "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```",
+      "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';\nimport { service } from '@ember/service';\n\nexport default class AdminRoute extends Route {\n  @service router;\n\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.router.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",
       "params": [
@@ -15803,31 +15789,31 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 268,
+      "line": 271,
       "class": "Route",
       "module": "@ember/routing/route"
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 270,
+      "line": 273,
       "class": "Route",
       "module": "@ember/routing/route"
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 273,
+      "line": 276,
       "class": "Route",
       "module": "@ember/routing/route"
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 275,
+      "line": 278,
       "class": "Route",
       "module": "@ember/routing/route"
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 303,
+      "line": 306,
       "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",
@@ -15855,7 +15841,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 371,
+      "line": 374,
       "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",
@@ -15868,7 +15854,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 424,
+      "line": 427,
       "description": "The name of the template to use by default when rendering this route's\ntemplate.\n\n```app/routes/posts/list.js\nimport Route from '@ember/routing/route';\n\nexport default class PostsListRoute extends Route {\n  templateName = 'posts/list';\n}\n```\n\n```app/routes/posts/index.js\nimport PostsListRoute from '../posts/list';\n\nexport default class PostsIndexRoute extends PostsListRoute {};\n```\n\n```app/routes/posts/archived.js\nimport PostsListRoute from '../posts/list';\n\nexport default class PostsArchivedRoute extends PostsListRoute {};\n```",
       "itemtype": "property",
       "name": "templateName",
@@ -15882,7 +15868,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 457,
+      "line": 460,
       "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",
@@ -15896,7 +15882,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 480,
+      "line": 483,
       "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",
@@ -15909,7 +15895,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 511,
+      "line": 514,
       "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",
@@ -15922,7 +15908,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 525,
+      "line": 528,
       "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",
@@ -15935,7 +15921,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 540,
+      "line": 543,
       "description": "Sets the name for this route, including a fully resolved name for routes\ninside engines.",
       "access": "private",
       "tagname": "",
@@ -15953,7 +15939,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 555,
+      "line": 558,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -15963,7 +15949,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 589,
+      "line": 592,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -15973,7 +15959,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 598,
+      "line": 601,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -15983,7 +15969,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 606,
+      "line": 609,
       "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",
@@ -16006,7 +15992,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 687,
+      "line": 690,
       "description": "Serializes the query parameter key",
       "itemtype": "method",
       "name": "serializeQueryParamKey",
@@ -16024,7 +16010,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 698,
+      "line": 701,
       "description": "Serializes value of the query parameter based on defaultValueType",
       "itemtype": "method",
       "name": "serializeQueryParam",
@@ -16052,7 +16038,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 714,
+      "line": 717,
       "description": "Deserializes value of the query parameter based on defaultValueType",
       "itemtype": "method",
       "name": "deserializeQueryParam",
@@ -16080,7 +16066,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 730,
+      "line": 733,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -16090,7 +16076,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 746,
+      "line": 749,
       "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",
@@ -16119,7 +16105,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 776,
+      "line": 779,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -16129,7 +16115,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 787,
+      "line": 790,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -16140,7 +16126,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 801,
+      "line": 804,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -16150,7 +16136,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 812,
+      "line": 815,
       "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",
@@ -16162,7 +16148,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 832,
+      "line": 835,
       "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",
@@ -16174,7 +16160,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 852,
+      "line": 855,
       "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",
@@ -16193,7 +16179,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 863,
+      "line": 866,
       "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",
@@ -16212,7 +16198,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 874,
+      "line": 877,
       "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",
@@ -16236,7 +16222,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 896,
+      "line": 899,
       "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",
@@ -16252,7 +16238,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 922,
+      "line": 925,
       "description": "This hook is the entry point for router.js",
       "access": "private",
       "tagname": "",
@@ -16263,8 +16249,8 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 997,
-      "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.",
+      "line": 1000,
+      "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`router.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",
       "params": [
@@ -16286,8 +16272,8 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1032,
-      "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.",
+      "line": 1035,
+      "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';\nimport { service } from '@ember/service';\n\nexport default class PostsRoute extends Route {\n  @service router;\n\n  afterModel(posts, transition) {\n    if (posts.get('length') === 1) {\n      this.router.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",
       "params": [
@@ -16314,8 +16300,8 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1073,
-      "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.",
+      "line": 1079,
+      "description": "A hook you can implement to optionally redirect to another route.\n\nCalling `this.router.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.router.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",
       "params": [
@@ -16338,7 +16324,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1098,
+      "line": 1104,
       "description": "Called when the context is changed by router.js.",
       "access": "private",
       "tagname": "",
@@ -16349,8 +16335,8 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1108,
-      "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\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\nNote that the legacy behavior of automatically defining a model\nhook when a dynamic segment ending in `_id` is present is\n[deprecated](https://deprecations.emberjs.com/v5.x#toc_deprecate-implicit-route-model).\nYou should explicitly define a model hook whenever any segments are\npresent.\n\nExample\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\nimport { service } from '@ember/service';\n\nexport default class PostRoute extends Route {\n  @service store;\n\n  model(params) {\n    return this.store.findRecord('post', params.post_id);\n  }\n}\n```",
+      "line": 1114,
+      "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\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.router.transitionTo('posts');\n\n// model passed in, so model hook not called\nthePost = store.findRecord('post', 1);\nthis.router.transitionTo('post', thePost);\n\n// integer passed in, model hook is called\nthis.router.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.router.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\nNote that the legacy behavior of automatically defining a model\nhook when a dynamic segment ending in `_id` is present is\n[deprecated](https://deprecations.emberjs.com/v5.x#toc_deprecate-implicit-route-model).\nYou should explicitly define a model hook whenever any segments are\npresent.\n\nExample\n\n```app/routes/post.js\nimport Route from '@ember/routing/route';\nimport { service } from '@ember/service';\n\nexport default class PostRoute extends Route {\n  @service store;\n\n  model(params) {\n    return this.store.findRecord('post', params.post_id);\n  }\n}\n```",
       "itemtype": "method",
       "name": "model",
       "params": [
@@ -16377,7 +16363,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1226,
+      "line": 1232,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -16403,7 +16389,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1239,
+      "line": 1245,
       "itemtype": "method",
       "name": "findModel",
       "params": [
@@ -16425,7 +16411,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1266,
+      "line": 1273,
       "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';\nimport { service } from '@ember/service';\n\nexport default class PhotosRoute extends Route {\n  @service store;\n\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```"
@@ -16458,7 +16444,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1345,
+      "line": 1352,
       "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",
@@ -16481,7 +16467,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1399,
+      "line": 1406,
       "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",
@@ -16499,7 +16485,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1427,
+      "line": 1434,
       "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",
@@ -16522,7 +16508,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1499,
+      "line": 1506,
       "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]",
@@ -16572,7 +16558,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1526,
+      "line": 1533,
       "access": "private",
       "tagname": "",
       "itemtype": "method",
@@ -16582,7 +16568,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1539,
+      "line": 1546,
       "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 { 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",
@@ -16597,13 +16583,13 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1590,
+      "line": 1597,
       "class": "Route",
       "module": "@ember/routing/route"
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1639,
+      "line": 1646,
       "access": "private",
       "tagname": "",
       "itemtype": "property",
@@ -16613,7 +16599,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 1778,
+      "line": 1785,
       "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",
@@ -16637,7 +16623,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 2161,
+      "line": 2168,
       "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",
@@ -16650,7 +16636,7 @@
     },
     {
       "file": "packages/@ember/routing/route.ts",
-      "line": 2192,
+      "line": 2199,
       "description": "This action is called when one or more query params have changed. Bubbles.",
       "itemtype": "method",
       "name": "queryParamsDidChange",
@@ -19125,7 +19111,7 @@
     },
     {
       "message": "replacing incorrect tag: returns with return",
-      "line": " packages/@ember/routing/route.ts:2192"
+      "line": " packages/@ember/routing/route.ts:2199"
     },
     {
       "message": "unknown tag: internal",
@@ -19709,23 +19695,23 @@
     },
     {
       "message": "Missing item type",
-      "line": " packages/@ember/routing/route.ts:268"
+      "line": " packages/@ember/routing/route.ts:271"
     },
     {
       "message": "Missing item type",
-      "line": " packages/@ember/routing/route.ts:270"
+      "line": " packages/@ember/routing/route.ts:273"
     },
     {
       "message": "Missing item type",
-      "line": " packages/@ember/routing/route.ts:273"
+      "line": " packages/@ember/routing/route.ts:276"
     },
     {
       "message": "Missing item type",
-      "line": " packages/@ember/routing/route.ts:275"
+      "line": " packages/@ember/routing/route.ts:278"
     },
     {
       "message": "Missing item type",
-      "line": " packages/@ember/routing/route.ts:1590"
+      "line": " packages/@ember/routing/route.ts:1597"
     },
     {
       "message": "Missing item type\nFinds the name of the substate route if it exists for the given route. A\nsubstate route is of the form `route_state`, such as `foo_loading`.",