ember-source 7.3.0-beta.1 → 7.4.0-alpha.1

package/build-metadata.json

@@ -1,6 +1,6 @@
 {
-  "version": "7.3.0-beta.1",
+  "version": "7.4.0-alpha.1",
   "buildType": "tag",
-  "SHA": "af217de50750d379c8839dbc3ece21b7ec33c4e5",
-  "assetPath": "/tag/shas/af217de50750d379c8839dbc3ece21b7ec33c4e5.tgz"
+  "SHA": "bb24a186bb850fd38035f4b6975bc7a979c17761",
+  "assetPath": "/tag/shas/bb24a186bb850fd38035f4b6975bc7a979c17761.tgz"
 }

package/dist/dev/packages/@ember/-internals/glimmer/index.js

@@ -1,5 +1,5 @@
 export { t as template, a as templateCacheCounters } from '../../../shared-chunks/index-BYUSIu_W.js';
-export { O as OutletView, R as Renderer, a as RootTemplate, s as setupApplicationRegistry, b as setupEngineRegistry } from '../../../shared-chunks/setup-registry-Dp5dtaLa.js';
+export { O as OutletView, R as Renderer, a as RootTemplate, s as setupApplicationRegistry, b as setupEngineRegistry } from '../../../shared-chunks/setup-registry-Ci8Af2Bz.js';
 export { I as Input, T as Textarea } from '../../../shared-chunks/textarea-DvS6Xmdh.js';
 export { LinkTo } from '../../routing/index.js';
 export { default as Component, setComponentManager } from '../../component/index.js';
@@ -12,7 +12,7 @@ export { i as isSerializationFirstNode } from '../../../shared-chunks/rehydrate-
 export { NodeDOMTreeConstruction } from '../../../@glimmer/node/index.js';
 export { e as element } from '../../../shared-chunks/element-Cgoi4ldD.js';
 export { u as uniqueId } from '../../../shared-chunks/unique-id-Csxuh1I7.js';
-export { _ as _resetRenderers, r as renderComponent, a as renderSettled } from '../../../shared-chunks/index-B5gBbO_p.js';
+export { _ as _resetRenderers, r as renderComponent, a as renderSettled } from '../../../shared-chunks/index-Bv9SQpEx.js';
 export { c as componentCapabilities, m as modifierCapabilities } from '../../../shared-chunks/api-BlZDPg1n.js';
 
 // STATE within a module is frowned upon, this exists

package/dist/dev/packages/@ember/application/index.js

@@ -23,7 +23,7 @@ import BucketCache from '../routing/lib/cache.js';
 import ApplicationInstance from './instance.js';
 import Engine, { buildInitializerMethod } from '../engine/index.js';
 import { privatize } from '../-internals/container/index.js';
-import { s as setupApplicationRegistry } from '../../shared-chunks/setup-registry-Dp5dtaLa.js';
+import { s as setupApplicationRegistry } from '../../shared-chunks/setup-registry-Ci8Af2Bz.js';
 import RouterService from '../routing/router-service.js';
 import { assert } from '../debug/lib/assert.js';
 

package/dist/dev/packages/@ember/application/instance.js

@@ -21,7 +21,7 @@ import '../../shared-chunks/hash-BFu91gtE.js';
 import '../../shared-chunks/get-zsePWrJL.js';
 import '../../shared-chunks/on-CVIjn2C-.js';
 import '../../shared-chunks/template-only-Cu639ICT.js';
-import { a as renderSettled } from '../../shared-chunks/index-B5gBbO_p.js';
+import { a as renderSettled } from '../../shared-chunks/index-Bv9SQpEx.js';
 import '../../shared-chunks/unique-id-Csxuh1I7.js';
 import '../runloop/index.js';
 import EmberRouter from '../routing/router.js';

package/dist/dev/packages/@ember/engine/index.js

@@ -13,7 +13,7 @@ import '../../route-recognizer/index.js';
 import '../../shared-chunks/rsvp-aLN_pQtn.js';
 import '../../shared-chunks/unrecognized-url-error-cXUp-SK3.js';
 import RoutingService from '../routing/lib/routing-service.js';
-import { b as setupEngineRegistry } from '../../shared-chunks/setup-registry-Dp5dtaLa.js';
+import { b as setupEngineRegistry } from '../../shared-chunks/setup-registry-Ci8Af2Bz.js';
 import RegistryProxyMixin from '../-internals/runtime/lib/mixins/registry_proxy.js';
 import { StrictResolver } from './lib/strict-resolver.js';
 import { assert } from '../debug/lib/assert.js';

package/dist/dev/packages/@ember/renderer/index.js

@@ -1 +1 @@
-export { r as renderComponent, a as renderSettled } from '../../shared-chunks/index-B5gBbO_p.js';
+export { r as renderComponent, a as renderSettled } from '../../shared-chunks/index-Bv9SQpEx.js';

package/dist/dev/packages/ember/version.js

@@ -1,4 +1,4 @@
 // this file gets replaced with the real value during the build
-const VERSION = '7.3.0-beta.1';
+const VERSION = '7.4.0-alpha.1';
 
 export { VERSION as default };

package/dist/dev/packages/shared-chunks/{index-B5gBbO_p.js → index-Bv9SQpEx.js}

@@ -296,8 +296,8 @@ const trackArray = internalHelper(({
 
   There are two special values for `key`:
 
+    * `@identity` - The item in the array itself. This is the default.
     * `@index` - The index of the item in the array.
-    * `@identity` - The item in the array itself.
 
   ### {{else}} condition
 
@@ -410,6 +410,30 @@ const trackArray = internalHelper(({
 
   `#each-in` is a keyword and does not need to be imported.
 
+  ### Specifying Keys
+
+  Like `{{#each}}`, `{{#each-in}}` accepts a `key` option to decide which DOM
+  elements can be reused between renders. Since `{{#each-in}}` yields two block
+  params, the special values pick which one is used:
+
+    * `@identity` - The second block param: the property's value. This is the
+      default. Changing a value replaces that entry's DOM instead of updating it
+      in place.
+    * `@key` - The first block param: the property name, or for a `Map`, its key.
+
+  Any other string is a path, looked up on the value: `key="id"` keys each entry
+  by its `value.id`.
+
+  For example, `@key` keeps each entry's DOM as its score changes, so anything
+  stateful inside it — focus, a running transition, a component instance — survives
+  the update:
+
+  ```handlebars
+  {{#each-in this.scores key="@key" as |player score|}}
+    <PlayerScore @name={{player}} @score={{score}} />
+  {{/each-in}}
+  ```
+
   @method each-in
   @static
   @noimport

package/dist/dev/packages/shared-chunks/{setup-registry-Dp5dtaLa.js → setup-registry-Ci8Af2Bz.js}

@@ -20,7 +20,7 @@ import { _instrumentStart } from '../@ember/instrumentation/index.js';
 import { c as capabilityFlagsFrom } from './capabilities-CajW4QjE.js';
 import { C as CONSTANT_TAG, c as consumeTag, D as DIRTY_TAG$1, r as createTag } from './cache-DGDPVCpC.js';
 import { assert } from '../@ember/debug/lib/assert.js';
-import { R as ResolverImpl, B as BaseRenderer, e as errorLoopTransaction } from './index-B5gBbO_p.js';
+import { R as ResolverImpl, B as BaseRenderer, e as errorLoopTransaction } from './index-Bv9SQpEx.js';
 import { generateControllerFactory } from '../@ember/routing/lib/generate_controller.js';
 import { i as internalHelper } from './internal-helper-CKrni0b_.js';
 import { c as hasInternalComponentManager } from './api-DuLOZMO_.js';

package/dist/prod/packages/@ember/-internals/glimmer/index.js

@@ -1,5 +1,5 @@
 export { t as template, a as templateCacheCounters } from '../../../shared-chunks/index-kwuZeaNz.js';
-export { O as OutletView, R as Renderer, a as RootTemplate, s as setupApplicationRegistry, b as setupEngineRegistry } from '../../../shared-chunks/setup-registry-DI1Agp-0.js';
+export { O as OutletView, R as Renderer, a as RootTemplate, s as setupApplicationRegistry, b as setupEngineRegistry } from '../../../shared-chunks/setup-registry-DeyoFe6Q.js';
 export { I as Input, T as Textarea } from '../../../shared-chunks/textarea-B-sssXGa.js';
 export { LinkTo } from '../../routing/index.js';
 export { default as Component, setComponentManager } from '../../component/index.js';
@@ -11,7 +11,7 @@ export { i as isSerializationFirstNode } from '../../../shared-chunks/rehydrate-
 export { NodeDOMTreeConstruction } from '../../../@glimmer/node/index.js';
 export { e as element } from '../../../shared-chunks/element-BmBjPjkQ.js';
 export { u as uniqueId } from '../../../shared-chunks/unique-id-BJb1p8EG.js';
-export { _ as _resetRenderers, r as renderComponent, a as renderSettled } from '../../../shared-chunks/index-C4VEqlp7.js';
+export { _ as _resetRenderers, r as renderComponent, a as renderSettled } from '../../../shared-chunks/index-D8cl-pfl.js';
 export { c as componentCapabilities, m as modifierCapabilities } from '../../../shared-chunks/api-B_poQGXS.js';
 
 // STATE within a module is frowned upon, this exists

package/dist/prod/packages/@ember/application/index.js

@@ -23,7 +23,7 @@ import BucketCache from '../routing/lib/cache.js';
 import ApplicationInstance from './instance.js';
 import Engine, { buildInitializerMethod } from '../engine/index.js';
 import { privatize } from '../-internals/container/index.js';
-import { s as setupApplicationRegistry } from '../../shared-chunks/setup-registry-DI1Agp-0.js';
+import { s as setupApplicationRegistry } from '../../shared-chunks/setup-registry-DeyoFe6Q.js';
 import RouterService from '../routing/router-service.js';
 
 /**

package/dist/prod/packages/@ember/application/instance.js

@@ -16,7 +16,7 @@ import '../../shared-chunks/hash-BitfXhCx.js';
 import '../../shared-chunks/get-CEjFJzGs.js';
 import '../../shared-chunks/on-ov4KAucw.js';
 import '../../shared-chunks/template-only-DKNcKM5b.js';
-import { a as renderSettled } from '../../shared-chunks/index-C4VEqlp7.js';
+import { a as renderSettled } from '../../shared-chunks/index-D8cl-pfl.js';
 import '../../shared-chunks/unique-id-BJb1p8EG.js';
 import '../runloop/index.js';
 import '../routing/router.js';

package/dist/prod/packages/@ember/engine/index.js

@@ -11,7 +11,7 @@ import '../../route-recognizer/index.js';
 import '../../shared-chunks/rsvp-aLN_pQtn.js';
 import '../../shared-chunks/unrecognized-url-error-xC654tCo.js';
 import RoutingService from '../routing/lib/routing-service.js';
-import { b as setupEngineRegistry } from '../../shared-chunks/setup-registry-DI1Agp-0.js';
+import { b as setupEngineRegistry } from '../../shared-chunks/setup-registry-DeyoFe6Q.js';
 import RegistryProxyMixin from '../-internals/runtime/lib/mixins/registry_proxy.js';
 import { StrictResolver } from './lib/strict-resolver.js';
 

package/dist/prod/packages/@ember/renderer/index.js

@@ -1 +1 @@
-export { r as renderComponent, a as renderSettled } from '../../shared-chunks/index-C4VEqlp7.js';
+export { r as renderComponent, a as renderSettled } from '../../shared-chunks/index-D8cl-pfl.js';

package/dist/prod/packages/ember/version.js

@@ -1,4 +1,4 @@
 // this file gets replaced with the real value during the build
-const VERSION = '7.3.0-beta.1';
+const VERSION = '7.4.0-alpha.1';
 
 export { VERSION as default };

package/dist/prod/packages/shared-chunks/{index-C4VEqlp7.js → index-D8cl-pfl.js}

@@ -268,8 +268,8 @@ const trackArray = internalHelper(({
 
   There are two special values for `key`:
 
+    * `@identity` - The item in the array itself. This is the default.
     * `@index` - The index of the item in the array.
-    * `@identity` - The item in the array itself.
 
   ### {{else}} condition
 
@@ -382,6 +382,30 @@ const trackArray = internalHelper(({
 
   `#each-in` is a keyword and does not need to be imported.
 
+  ### Specifying Keys
+
+  Like `{{#each}}`, `{{#each-in}}` accepts a `key` option to decide which DOM
+  elements can be reused between renders. Since `{{#each-in}}` yields two block
+  params, the special values pick which one is used:
+
+    * `@identity` - The second block param: the property's value. This is the
+      default. Changing a value replaces that entry's DOM instead of updating it
+      in place.
+    * `@key` - The first block param: the property name, or for a `Map`, its key.
+
+  Any other string is a path, looked up on the value: `key="id"` keys each entry
+  by its `value.id`.
+
+  For example, `@key` keeps each entry's DOM as its score changes, so anything
+  stateful inside it — focus, a running transition, a component instance — survives
+  the update:
+
+  ```handlebars
+  {{#each-in this.scores key="@key" as |player score|}}
+    <PlayerScore @name={{player}} @score={{score}} />
+  {{/each-in}}
+  ```
+
   @method each-in
   @static
   @noimport

package/dist/prod/packages/shared-chunks/{setup-registry-DI1Agp-0.js → setup-registry-DeyoFe6Q.js}

@@ -18,7 +18,7 @@ import { g as getFactoryFor } from './container-BYOnjnwz.js';
 import { _instrumentStart } from '../@ember/instrumentation/index.js';
 import { c as capabilityFlagsFrom } from './capabilities-BuVYh-vx.js';
 import { C as CONSTANT_TAG, c as consumeTag, D as DIRTY_TAG$1, r as createTag } from './cache-CofLhaS4.js';
-import { R as ResolverImpl, B as BaseRenderer, e as errorLoopTransaction } from './index-C4VEqlp7.js';
+import { R as ResolverImpl, B as BaseRenderer, e as errorLoopTransaction } from './index-D8cl-pfl.js';
 import { generateControllerFactory } from '../@ember/routing/lib/generate_controller.js';
 import { i as internalHelper } from './internal-helper-Bz1lpDXr.js';
 import { c as hasInternalComponentManager } from './api-DlJKfm_f.js';

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": "7.3.0-beta.1"
+    "version": "7.4.0-alpha.1"
   },
   "files": {
     "node_modules/rsvp/lib/rsvp/promise/all.js": {
@@ -6428,7 +6428,7 @@
     {
       "file": "packages/@ember/-internals/glimmer/lib/helpers/each-in.ts",
       "line": 13,
-      "description": "The `{{#each}}` keyword loops over elements in a collection. It is an extension\nof the base Handlebars `{{#each}}` helper.\n\nThe default behavior of `{{#each}}` is to yield its inner block once for every\nitem in an array passing the item as the first block parameter.\n\n```gjs {data-filename=\"app/components/developer-list.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperList extends Component {\n  developers = [\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ];\n\n  <template>\n    <ul>\n      {{#each this.developers as |person|}}\n        <li>Hello, {{person.name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\nThe same rules apply to arrays of primitives:\n\n```gjs {data-filename=\"app/components/developer-names.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperNames extends Component {\n  developerNames = ['Yehuda', 'Tom', 'Paul'];\n\n  <template>\n    <ul>\n      {{#each this.developerNames as |name|}}\n        <li>Hello, {{name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\n`{{#each}}` also supports native JavaScript [`Set`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set)\nvalues and other iterables:\n\n```gjs {data-filename=\"app/components/developer-set.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperSet extends Component {\n  developers = new Set([\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ]);\n\n  <template>\n    <ul>\n      {{#each this.developers as |person|}}\n        <li>Hello, {{person.name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\nDuring iteration, the index of each item in the array is provided as a second\nblock parameter:\n\n```gjs {data-filename=\"app/components/developer-list-with-index.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperListWithIndex extends Component {\n  developers = [\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ];\n\n  <template>\n    <ul>\n      {{#each this.developers as |person index|}}\n        <li>Hello, {{person.name}}! You're number {{index}} in line</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\n`#each` is a keyword and does not need to be imported.\n\n### Specifying Keys\n\nIn order to improve rendering speed, Ember will try to reuse the DOM elements\nwhere possible. Specifically, if the same item is present in the array both\nbefore and after the change, its DOM output will be reused.\n\nThe `key` option is used to tell Ember how to determine if the items in the\narray being iterated over with `{{#each}}` has changed between renders. By\ndefault the item's object identity is used.\n\nThis is usually sufficient, so in most cases, the `key` option is simply not\nneeded. However, in some rare cases, the objects' identities may change even\nthough they represent the same underlying data.\n\nFor example, mapping over `people` produces a new array of new objects on each\nrender. Use `key` so Ember can match items across those renders:\n\n```gjs {data-filename=\"app/components/mapped-developers.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class MappedDevelopers extends Component {\n  people = [\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ];\n\n  get developers() {\n    return this.people.map((person) => {\n      return { ...person, type: 'developer' };\n    });\n  }\n\n  <template>\n    <ul>\n      {{#each this.developers key=\"name\" as |person|}}\n        <li>Hello, {{person.name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\nBy doing so, Ember will use the value of the property specified (`person.name`\nin the example) to find a \"match\" from the previous render. That is, if Ember\nhas previously seen an object from the `developers` array with a matching\nname, its DOM elements will be re-used.\n\nThere are two special values for `key`:\n\n  * `@index` - The index of the item in the array.\n  * `@identity` - The item in the array itself.\n\n### {{else}} condition\n\n`{{#each}}` can have a matching `{{else}}`. The contents of this block will render\nif the collection is empty.\n\n```gjs {data-filename=\"app/components/available-developers.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class AvailableDevelopers extends Component {\n  developers = [];\n\n  <template>\n    <ul>\n      {{#each this.developers as |person|}}\n        <li>{{person.name}} is available!</li>\n      {{else}}\n        <li>Sorry, nobody is available for this task.</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```",
+      "description": "The `{{#each}}` keyword loops over elements in a collection. It is an extension\nof the base Handlebars `{{#each}}` helper.\n\nThe default behavior of `{{#each}}` is to yield its inner block once for every\nitem in an array passing the item as the first block parameter.\n\n```gjs {data-filename=\"app/components/developer-list.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperList extends Component {\n  developers = [\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ];\n\n  <template>\n    <ul>\n      {{#each this.developers as |person|}}\n        <li>Hello, {{person.name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\nThe same rules apply to arrays of primitives:\n\n```gjs {data-filename=\"app/components/developer-names.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperNames extends Component {\n  developerNames = ['Yehuda', 'Tom', 'Paul'];\n\n  <template>\n    <ul>\n      {{#each this.developerNames as |name|}}\n        <li>Hello, {{name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\n`{{#each}}` also supports native JavaScript [`Set`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set)\nvalues and other iterables:\n\n```gjs {data-filename=\"app/components/developer-set.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperSet extends Component {\n  developers = new Set([\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ]);\n\n  <template>\n    <ul>\n      {{#each this.developers as |person|}}\n        <li>Hello, {{person.name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\nDuring iteration, the index of each item in the array is provided as a second\nblock parameter:\n\n```gjs {data-filename=\"app/components/developer-list-with-index.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperListWithIndex extends Component {\n  developers = [\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ];\n\n  <template>\n    <ul>\n      {{#each this.developers as |person index|}}\n        <li>Hello, {{person.name}}! You're number {{index}} in line</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\n`#each` is a keyword and does not need to be imported.\n\n### Specifying Keys\n\nIn order to improve rendering speed, Ember will try to reuse the DOM elements\nwhere possible. Specifically, if the same item is present in the array both\nbefore and after the change, its DOM output will be reused.\n\nThe `key` option is used to tell Ember how to determine if the items in the\narray being iterated over with `{{#each}}` has changed between renders. By\ndefault the item's object identity is used.\n\nThis is usually sufficient, so in most cases, the `key` option is simply not\nneeded. However, in some rare cases, the objects' identities may change even\nthough they represent the same underlying data.\n\nFor example, mapping over `people` produces a new array of new objects on each\nrender. Use `key` so Ember can match items across those renders:\n\n```gjs {data-filename=\"app/components/mapped-developers.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class MappedDevelopers extends Component {\n  people = [\n    { name: 'Yehuda' },\n    { name: 'Tom' },\n    { name: 'Paul' },\n  ];\n\n  get developers() {\n    return this.people.map((person) => {\n      return { ...person, type: 'developer' };\n    });\n  }\n\n  <template>\n    <ul>\n      {{#each this.developers key=\"name\" as |person|}}\n        <li>Hello, {{person.name}}!</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```\n\nBy doing so, Ember will use the value of the property specified (`person.name`\nin the example) to find a \"match\" from the previous render. That is, if Ember\nhas previously seen an object from the `developers` array with a matching\nname, its DOM elements will be re-used.\n\nThere are two special values for `key`:\n\n  * `@identity` - The item in the array itself. This is the default.\n  * `@index` - The index of the item in the array.\n\n### {{else}} condition\n\n`{{#each}}` can have a matching `{{else}}`. The contents of this block will render\nif the collection is empty.\n\n```gjs {data-filename=\"app/components/available-developers.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class AvailableDevelopers extends Component {\n  developers = [];\n\n  <template>\n    <ul>\n      {{#each this.developers as |person|}}\n        <li>{{person.name}} is available!</li>\n      {{else}}\n        <li>Sorry, nobody is available for this task.</li>\n      {{/each}}\n    </ul>\n  </template>\n}\n```",
       "itemtype": "method",
       "name": "each",
       "static": 1,
@@ -6441,7 +6441,7 @@
     {
       "file": "packages/@ember/-internals/glimmer/lib/helpers/each-in.ts",
       "line": 189,
-      "description": "The `{{#each-in}}` keyword loops over properties on an object, or entries in a\nnative JavaScript [`Map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map).\n\nFor example, given this component definition:\n\n```gjs {data-filename=\"app/components/developer-details.gjs\"}\nimport Component from '@glimmer/component';\nimport { tracked } from '@glimmer/tracking';\n\nexport default class DeveloperDetails extends Component {\n  @tracked developer = {\n    name: 'Shelly Sails',\n    age: 42,\n  };\n\n  <template>\n    <ul>\n      {{#each-in this.developer as |key value|}}\n        <li>{{key}}: {{value}}</li>\n      {{/each-in}}\n    </ul>\n  </template>\n}\n```\n\nThis template would display all properties on the `developer`\nobject in a list, outputting their name and age:\n\n```html\n<ul>\n  <li>name: Shelly Sails</li>\n  <li>age: 42</li>\n</ul>\n```\n\nThe same pattern works with a `Map`:\n\n```gjs {data-filename=\"app/components/developer-map.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperMap extends Component {\n  map = new Map([\n    ['name', 'Shelly Sails'],\n    ['age', 42],\n  ]);\n\n  <template>\n    <ul>\n      {{#each-in this.map as |key value|}}\n        <li>{{key}}: {{value}}</li>\n      {{/each-in}}\n    </ul>\n  </template>\n}\n```\n\nWhen a `Map` uses object keys, you can pass `key=\"@identity\"` to explicitly\ntrack entries across re-renders using the JavaScript identity of each key:\n\n```gjs {data-filename=\"app/components/object-keyed-map.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class ObjectKeyedMap extends Component {\n  map = new Map([\n    [{ name: 'one' }, 'foo'],\n    [{ name: 'two' }, 'bar'],\n  ]);\n\n  <template>\n    <ul>\n      {{#each-in this.map key=\"@identity\" as |key value|}}\n        <li>{{key.name}}: {{value}}</li>\n      {{/each-in}}\n    </ul>\n  </template>\n}\n```\n\n`#each-in` is a keyword and does not need to be imported.",
+      "description": "The `{{#each-in}}` keyword loops over properties on an object, or entries in a\nnative JavaScript [`Map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map).\n\nFor example, given this component definition:\n\n```gjs {data-filename=\"app/components/developer-details.gjs\"}\nimport Component from '@glimmer/component';\nimport { tracked } from '@glimmer/tracking';\n\nexport default class DeveloperDetails extends Component {\n  @tracked developer = {\n    name: 'Shelly Sails',\n    age: 42,\n  };\n\n  <template>\n    <ul>\n      {{#each-in this.developer as |key value|}}\n        <li>{{key}}: {{value}}</li>\n      {{/each-in}}\n    </ul>\n  </template>\n}\n```\n\nThis template would display all properties on the `developer`\nobject in a list, outputting their name and age:\n\n```html\n<ul>\n  <li>name: Shelly Sails</li>\n  <li>age: 42</li>\n</ul>\n```\n\nThe same pattern works with a `Map`:\n\n```gjs {data-filename=\"app/components/developer-map.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class DeveloperMap extends Component {\n  map = new Map([\n    ['name', 'Shelly Sails'],\n    ['age', 42],\n  ]);\n\n  <template>\n    <ul>\n      {{#each-in this.map as |key value|}}\n        <li>{{key}}: {{value}}</li>\n      {{/each-in}}\n    </ul>\n  </template>\n}\n```\n\nWhen a `Map` uses object keys, you can pass `key=\"@identity\"` to explicitly\ntrack entries across re-renders using the JavaScript identity of each key:\n\n```gjs {data-filename=\"app/components/object-keyed-map.gjs\"}\nimport Component from '@glimmer/component';\n\nexport default class ObjectKeyedMap extends Component {\n  map = new Map([\n    [{ name: 'one' }, 'foo'],\n    [{ name: 'two' }, 'bar'],\n  ]);\n\n  <template>\n    <ul>\n      {{#each-in this.map key=\"@identity\" as |key value|}}\n        <li>{{key.name}}: {{value}}</li>\n      {{/each-in}}\n    </ul>\n  </template>\n}\n```\n\n`#each-in` is a keyword and does not need to be imported.\n\n### Specifying Keys\n\nLike `{{#each}}`, `{{#each-in}}` accepts a `key` option to decide which DOM\nelements can be reused between renders. Since `{{#each-in}}` yields two block\nparams, the special values pick which one is used:\n\n  * `@identity` - The second block param: the property's value. This is the\n    default. Changing a value replaces that entry's DOM instead of updating it\n    in place.\n  * `@key` - The first block param: the property name, or for a `Map`, its key.\n\nAny other string is a path, looked up on the value: `key=\"id\"` keys each entry\nby its `value.id`.\n\nFor example, `@key` keeps each entry's DOM as its score changes, so anything\nstateful inside it — focus, a running transition, a component instance — survives\nthe update:\n\n```handlebars\n{{#each-in this.scores key=\"@key\" as |player score|}}\n  <PlayerScore @name={{player}} @score={{score}} />\n{{/each-in}}\n```",
       "itemtype": "method",
       "name": "each-in",
       "static": 1,

package/package.json

@@ -1,15 +1,24 @@
 {
   "name": "ember-source",
-  "version": "7.3.0-beta.1",
+  "version": "7.4.0-alpha.1",
   "description": "A JavaScript framework for creating ambitious web applications",
-  "type": "module",
+  "keywords": [
+    "ember-addon"
+  ],
+  "homepage": "https://emberjs.com/",
+  "bugs": {
+    "url": "https://github.com/emberjs/ember.js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emberjs/ember.js.git"
+  },
+  "license": "MIT",
   "sideEffects": [
     "./dist/*/packages/ember-testing/index.js",
     "./dist/*/packages/@ember/-internals/runtime/lib/ext/rsvp.js"
   ],
-  "keywords": [
-    "ember-addon"
-  ],
+  "type": "module",
   "exports": {
     "./*": {
       "development": "./dist/dev/packages/*",
@@ -21,12 +30,17 @@
     },
     "./package.json": "./package.json"
   },
-  "homepage": "https://emberjs.com/",
-  "bugs": {
-    "url": "https://github.com/emberjs/ember.js/issues"
-  },
-  "license": "MIT",
   "main": "lib/index.cjs",
+  "typesVersions": {
+    "*": {
+      "types": [
+        "types/stable"
+      ],
+      "types/preview": [
+        "types/preview"
+      ]
+    }
+  },
   "files": [
     "build-metadata.json",
     "blueprints",
@@ -35,19 +49,14 @@
     "lib",
     "types/stable"
   ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/emberjs/ember.js.git"
-  },
   "scripts": {
     "actions-up": "pnpm dlx actions-up",
     "bench": "node ./bin/benchmark.mjs",
     "bench:precompile": "node --expose-gc bin/precompile.bench.mjs",
+    "build": "npm-run-all build:*",
     "build:js": "rollup --config",
     "build:types": "node types/publish.mjs",
-    "build": "npm-run-all build:*",
     "docs": "ember ember-cli-yuidoc",
-    "start": "vite dev",
     "lint": "npm-run-all --continue-on-error --aggregate-output --parallel \"lint:!(fix)\"",
     "lint:docs": "qunit tests/docs/coverage-test.cjs",
     "lint:eslint": "eslint --report-unused-disable-directives --cache .",
@@ -55,16 +64,20 @@
     "lint:fix": "npm-run-all lint:*:fix",
     "lint:format": "prettier --check .",
     "lint:format:fix": "prettier --write .",
+    "start": "vite dev",
     "test": "testem ci -f testem.cjs --host 127.0.0.1 --port 13141",
     "test:blueprints": "pnpm --filter ember-test-node-blueprints test:node",
+    "test:browserstack": "node bin/run-browserstack-tests.cjs",
     "test:node": "qunit tests/node/**/*-test.cjs",
     "test:node:vitest": "pnpm --filter ember-test-node-vitest test:node",
-    "test:browserstack": "node bin/run-browserstack-tests.cjs",
     "test:wip": "vite build --mode development --minify false && testem ci",
-    "type-check:internals": "tsc --noEmit",
+    "type-check": "npm-run-all type-check:*",
     "type-check:handlebars": "tsc --noEmit --project packages/@handlebars/parser/tsconfig.json",
-    "type-check:types": "tsc --noEmit --project type-tests",
-    "type-check": "npm-run-all type-check:*"
+    "type-check:internals": "tsc --noEmit",
+    "type-check:types": "tsc --noEmit --project type-tests"
+  },
+  "resolutions": {
+    "socket.io": "^4.7.0"
   },
   "dependencies": {
     "@babel/core": "^7.24.4",
@@ -135,6 +148,7 @@
     "prettier": "^3.5.3",
     "qunit": "^2.19.4",
     "recast": "^0.22.0",
+    "release-plan": "^0.19.0",
     "resolve.exports": "^2.0.3",
     "rollup": "^4.57.1",
     "router_js": "workspace:*",
@@ -147,33 +161,34 @@
     "typescript-eslint": "^8.59.2",
     "vite": "^7.0.0"
   },
-  "resolutions": {
-    "socket.io": "^4.7.0"
+  "peerDependencies": {
+    "@glimmer/component": ">= 1.1.2"
+  },
+  "packageManager": "pnpm@10.33.2",
+  "engines": {
+    "node": ">= 20.19"
+  },
+  "release-plan": {
+    "ignore": true
   },
   "pnpm": {
-    "overrides": {
-      "rollup": "^4.2.0",
-      "ember-cli-htmlbars": "^7.0.0",
-      "babel-plugin-ember-template-compilation": "^4.0.0",
-      "ember-cli-babel": "^8.3.1",
-      "testem": "^3.20.1"
-    },
     "onlyBuiltDependencies": [
       "@swc/core",
       "core-js",
       "esbuild"
     ],
+    "overrides": {
+      "babel-plugin-ember-template-compilation": "^4.0.0",
+      "ember-cli-babel": "^8.3.1",
+      "ember-cli-htmlbars": "^7.0.0",
+      "rollup": "^4.2.0",
+      "testem": "^3.20.1"
+    },
     "patchedDependencies": {
       "@tracerbench/core@8.0.1": "patches/@tracerbench__core@8.0.1.patch",
       "agadoo": "patches/agadoo.patch"
     }
   },
-  "peerDependencies": {
-    "@glimmer/component": ">= 1.1.2"
-  },
-  "engines": {
-    "node": ">= 20.19"
-  },
   "ember-addon": {
     "after": "ember-cli-legacy-blueprints",
     "type": "addon",
@@ -359,20 +374,9 @@
       "rsvp/index.js": "ember-source/rsvp/index.js"
     }
   },
-  "typesVersions": {
-    "*": {
-      "types": [
-        "types/stable"
-      ],
-      "types/preview": [
-        "types/preview"
-      ]
-    }
-  },
-  "packageManager": "pnpm@10.33.2",
-  "_originalVersion": "7.3.0-beta.1",
+  "_originalVersion": "7.4.0-alpha.1",
   "_versionPreviouslyCalculated": true,
   "publishConfig": {
-    "tag": "beta"
+    "tag": "alpha"
   }
 }

package/types/stable/@ember/-internals/glimmer/lib/helpers/each-in.d.ts

@@ -142,8 +142,8 @@ declare module '@ember/-internals/glimmer/lib/helpers/each-in' {
 
       There are two special values for `key`:
 
+        * `@identity` - The item in the array itself. This is the default.
         * `@index` - The index of the item in the array.
-        * `@identity` - The item in the array itself.
 
       ### {{else}} condition
 
@@ -255,6 +255,30 @@ declare module '@ember/-internals/glimmer/lib/helpers/each-in' {
 
       `#each-in` is a keyword and does not need to be imported.
 
+      ### Specifying Keys
+
+      Like `{{#each}}`, `{{#each-in}}` accepts a `key` option to decide which DOM
+      elements can be reused between renders. Since `{{#each-in}}` yields two block
+      params, the special values pick which one is used:
+
+        * `@identity` - The second block param: the property's value. This is the
+          default. Changing a value replaces that entry's DOM instead of updating it
+          in place.
+        * `@key` - The first block param: the property name, or for a `Map`, its key.
+
+      Any other string is a path, looked up on the value: `key="id"` keys each entry
+      by its `value.id`.
+
+      For example, `@key` keeps each entry's DOM as its score changes, so anything
+      stateful inside it — focus, a running transition, a component instance — survives
+      the update:
+
+      ```handlebars
+      {{#each-in this.scores key="@key" as |player score|}}
+        <PlayerScore @name={{player}} @score={{score}} />
+      {{/each-in}}
+      ```
+
       @method each-in
       @static
       @noimport