ember-source 7.1.0-beta.1 → 7.1.0

package/build-metadata.json

@@ -1,6 +1,6 @@
 {
-  "version": "7.1.0-beta.1",
+  "version": "7.1.0",
   "buildType": "tag",
-  "SHA": "053de89db6f65ee7709846f588c0cf3b9597c4ad",
-  "assetPath": "/tag/shas/053de89db6f65ee7709846f588c0cf3b9597c4ad.tgz"
+  "SHA": "7c6f1709c1844fd40dc725150a67c9b0653d3492",
+  "assetPath": "/tag/shas/7c6f1709c1844fd40dc725150a67c9b0653d3492.tgz"
 }

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

@@ -1,17 +1,17 @@
 export { t as template, a as templateCacheCounters } from '../../../shared-chunks/index-CyZiGiEI.js';
-export { R as RootTemplate, s as setupApplicationRegistry, a as setupEngineRegistry } from '../../../shared-chunks/setup-registry-BC5VMvei.js';
-export { I as Input, T as Textarea } from '../../../shared-chunks/textarea-WSlUEr0y.js';
+export { R as RootTemplate, s as setupApplicationRegistry, a as setupEngineRegistry } from '../../../shared-chunks/setup-registry-BQZJfq-Y.js';
+export { I as Input, T as Textarea } from '../../../shared-chunks/textarea-lD4apgrP.js';
 export { LinkTo } from '../../routing/index.js';
 export { default as Component, setComponentManager } from '../../component/index.js';
-export { H as Helper, h as helper } from '../../../shared-chunks/helper-Do7NCZHI.js';
+export { H as Helper, h as helper } from '../../../shared-chunks/helper-BubrhyuN.js';
 export { S as SafeString, T as TrustedHTML, h as htmlSafe, i as isHTMLSafe, a as isTrustedHTML, t as trustHTML } from '../../../shared-chunks/index-D-xTBV4B.js';
-export { O as OutletView, R as Renderer, _ as _resetRenderers, a as renderComponent, r as renderSettled } from '../../../shared-chunks/index-CwnQYqK5.js';
+export { O as OutletView, R as Renderer, _ as _resetRenderers, a as renderComponent, r as renderSettled } from '../../../shared-chunks/index-CL1zjHwo.js';
 export { D as DOMChanges } from '../../../shared-chunks/render-CpKaO-BO.js';
 export { D as DOMTreeConstruction } from '../../../shared-chunks/element-builder--iTIJyCB.js';
 import '../../../@glimmer/destroyable/index.js';
 export { i as isSerializationFirstNode } from '../../../shared-chunks/rehydrate-builder-DCyIgnCR.js';
 export { NodeDOMTreeConstruction } from '../../../@glimmer/node/index.js';
-export { e as element } from '../../../shared-chunks/element-DQJOvSlQ.js';
+export { e as element } from '../../../shared-chunks/element-Cf3hqNOD.js';
 export { u as uniqueId } from '../../../shared-chunks/unique-id-CgmHQiwi.js';
 export { c as componentCapabilities, m as modifierCapabilities } from '../../../shared-chunks/api-BAmlf_CN.js';
 

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

@@ -12,7 +12,7 @@ import { assert } from '../../../../debug/lib/assert.js';
 
 /**
 `TargetActionSupport` is a mixin that can be included in a class
-to add a `triggerAction` method with semantics similar to the Handlebars
+to add a `triggerAction` method with semantics similar to the
 `{{action}}` helper. In normal Ember usage, the `{{action}}` helper is
 usually the best choice. This mixin is most often useful when you are
 doing more complex event handling in Components.

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

@@ -24,7 +24,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-BC5VMvei.js';
+import { s as setupApplicationRegistry } from '../../shared-chunks/setup-registry-BQZJfq-Y.js';
 import RouterService from '../routing/router-service.js';
 import { assert } from '../debug/lib/assert.js';
 

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

@@ -2,7 +2,7 @@ import { g as get } from '../../shared-chunks/property_get-CIBS9umw.js';
 import { s as set } from '../../shared-chunks/property_set-D3PKyisF.js';
 import { h as hasDOM, e as environment } from '../../shared-chunks/index-BGP1rw3B.js';
 import EngineInstance from '../engine/instance.js';
-import { r as renderSettled } from '../../shared-chunks/index-CwnQYqK5.js';
+import { r as renderSettled } from '../../shared-chunks/index-CL1zjHwo.js';
 import '../debug/index.js';
 import EmberRouter from '../routing/router.js';
 import EventDispatcher from '../-internals/views/lib/system/event_dispatcher.js';

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

@@ -514,6 +514,10 @@ const MutableArray = Mixin.create(EmberArray, MutableEnumerable, {
 /**
   Creates an `NativeArray` from an Array-like object.
   Does not modify the original object's contents.
+    
+  This exists primarily for historic reasons and should not be used
+  in new code. Prefer native [Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
+  or [trackedArray](/ember/release/functions/@ember%2Freactive%2Fcollections/trackedArray).
 
   Example
 

package/dist/dev/packages/@ember/component/helper.js

@@ -1 +1 @@
-export { H as default, h as helper } from '../../shared-chunks/helper-Do7NCZHI.js';
+export { H as default, h as helper } from '../../shared-chunks/helper-BubrhyuN.js';

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

@@ -18,7 +18,7 @@ import { I as IS_DISPATCHING_ATTRS, D as DIRTY_TAG, B as BOUNDS, g as getCompone
 import { h as hasDOM } from '../../shared-chunks/index-BGP1rw3B.js';
 import { a as decorateMethodV2 } from '../../shared-chunks/runtime-CYyqkz5q-BOdRhmsS.js';
 import { assert } from '../debug/lib/assert.js';
-export { I as Input, T as Textarea } from '../../shared-chunks/textarea-WSlUEr0y.js';
+export { I as Input, T as Textarea } from '../../shared-chunks/textarea-lD4apgrP.js';
 import { s as setComponentManager$1 } from '../../shared-chunks/api-BAmlf_CN.js';
 export { c as capabilities } from '../../shared-chunks/api-BAmlf_CN.js';
 import '../../@glimmer/destroyable/index.js';
@@ -73,6 +73,12 @@ function matches(el, selector) {
   API documentation for Template-only or Glimmer components, it is [available
   here](/ember/release/modules/@glimmer%2Fcomponent).
 
+  Note: Prior to Ember 6.8, by default, components were authored in paired `.hbs` and `.js`
+  files. This is still supported, but the default authoring format is now `.gjs` or "template tag".
+  The documentation for `@ember/component` still refers to the older authoring format. To read about
+  the new authoring format, see the 
+  [Glimmer Component API documentation](/ember/release/modules/@glimmer%2Fcomponent).
+    
   ## Defining a Classic Component
 
   If you want to customize the component in order to handle events, transform
@@ -99,7 +105,7 @@ function matches(el, selector) {
 
   And then use it in the component's template:
 
-  ```app/templates/components/person-profile.hbs
+  ```app/components/person-profile.hbs
   <h1>{{this.displayName}}</h1>
   {{yield}}
   ```
@@ -487,7 +493,7 @@ function matches(el, selector) {
   The `layout` property should be set to the default export of a template
   module, which is the name of a template file without the `.hbs` extension.
 
-  ```app/templates/components/person-profile.hbs
+  ```app/components/person-profile.hbs
   <h1>Person's Title</h1>
   <div class='details'>{{yield}}</div>
   ```

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

@@ -13,7 +13,7 @@ import '../../route-recognizer/index.js';
 import '../../shared-chunks/rsvp-CnCSY930.js';
 import '../../shared-chunks/unrecognized-url-error-B3wUTorp.js';
 import RoutingService from '../routing/lib/routing-service.js';
-import { a as setupEngineRegistry } from '../../shared-chunks/setup-registry-BC5VMvei.js';
+import { a as setupEngineRegistry } from '../../shared-chunks/setup-registry-BQZJfq-Y.js';
 import RegistryProxyMixin from '../-internals/runtime/lib/mixins/registry_proxy.js';
 import { assert } from '../debug/lib/assert.js';
 

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

@@ -1,10 +1,10 @@
 import { b as setHelperManager$1 } from '../../shared-chunks/api-BAmlf_CN.js';
 import { i as helperCapabilities } from '../../shared-chunks/api-BawZUDYD.js';
 import { i as invokeHelper$1 } from '../../shared-chunks/invoke-B8M5fQQS.js';
-import { a as array$1, f as fn$1, h as hash$1 } from '../../shared-chunks/hash-BRRFQJ99.js';
-import { c as concat$1, g as get$1 } from '../../shared-chunks/get-D5b5QlqE.js';
-import { a as and$1, e as eq$1, g as gt$1, b as gte$1, l as lt$1, c as lte$1, n as neq$1, d as not$1, o as or$1 } from '../../shared-chunks/or-O0eJQ4K-.js';
-import { e as element$1 } from '../../shared-chunks/element-DQJOvSlQ.js';
+import { a as array$1, f as fn$1, h as hash$1 } from '../../shared-chunks/hash-BTwOuDGQ.js';
+import { c as concat$1, g as get$1 } from '../../shared-chunks/get-BehtPmsu.js';
+import { a as and$1, e as eq$1, g as gt$1, b as gte$1, l as lt$1, c as lte$1, n as neq$1, d as not$1, o as or$1 } from '../../shared-chunks/or-BTH3yuFG.js';
+import { e as element$1 } from '../../shared-chunks/element-Cf3hqNOD.js';
 import { u as uniqueId$1 } from '../../shared-chunks/unique-id-CgmHQiwi.js';
 
 /**
@@ -336,18 +336,12 @@ const invokeHelper = invokeHelper$1;
  * as an argument to your components.
  *
  * ```
- * import { hash } from '@ember/helper';
- *
  * <template>
  *   {{#each-in (hash givenName='Jen' familyName='Weber') as |key value|}}
  *     <p>{{key}}: {{value}}</p>
  *   {{/each-in}}
  * </template>
  * ```
- *
- * **NOTE:** this example uses the experimental `<template>` feature, which is
- * the only place you need to import `hash` to use it (it is a built-in when
- * writing standalone `.hbs` files).
  */
 const hash = hash$1;
 /**
@@ -355,7 +349,6 @@ const hash = hash$1;
  * as an argument to your components.
  *
  * ```js
- * import { array } from '@ember/helper';
  *
  * <template>
  *   <ul>
@@ -364,10 +357,6 @@ const hash = hash$1;
  *   {{/each}}
  *   </ul>
  * </template>
- *
- * **NOTE:** this example uses the experimental `<template>` feature, which is
- * the only place you need to import `array` to use it (it is a built-in when
- * writing standalone `.hbs` files).
  * ```
  */
 const array = array$1;
@@ -388,10 +377,6 @@ const array = array$1;
  *
  * This will display the result of `@foo.item1` when `index` is `1`, and
  * `this.foo.item2` when `index` is `2`, etc.
- *
- * **NOTE:** this example uses the experimental `<template>` feature, which is
- * the only place you need to import `concat` to use it (it is a built-in when
- * writing standalone `.hbs` files).
  */
 const concat = concat$1;
 /**
@@ -431,10 +416,6 @@ const concat = concat$1;
  *
  * This will display the result of `@foo.item1` when `index` is `1`, and
  * `this.foo.item2` when `index` is `2`, etc.
- *
- * **NOTE:** this example uses the experimental `<template>` feature, which is
- * the only place you need to import `concat` to use it (it is a built-in when
- * writing standalone `.hbs` files).
  */
 const get = get$1;
 /**

package/dist/dev/packages/@ember/modifier/on.js

@@ -1,4 +1,4 @@
-import { o as on$1 } from '../../shared-chunks/on-BueSMv9L.js';
+import { o as on$1 } from '../../shared-chunks/on-BQii6ILK.js';
 
 // In normal TypeScript, this modifier is essentially an opaque token that just
 // needs to be importable. Declaring it with a unique interface like this,

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

@@ -40,8 +40,8 @@ class EmberObject extends CoreObject.extend(Observable) {
   Decorator that turns the target function into an Action which can be accessed
   directly by reference.
 
-  ```js
-  import Component from '@ember/component';
+  ```gjs
+  import Component from '@glimmer/component';
   import { tracked } from '@glimmer/tracking';
   import { action } from '@ember/object';
 
@@ -52,24 +52,24 @@ class EmberObject extends CoreObject.extend(Observable) {
     toggleShowing() {
       this.isShowing = !this.isShowing;
     }
+    
+    <template>
+      <button {{on "click" this.toggleShowing}}>Show tooltip</button>
+    
+      {{#if isShowing}}
+        <div class="tooltip">
+          I'm a tooltip!
+        </div>
+      {{/if}}
+    </template>
   }
   ```
-  ```hbs
-  <!-- template.hbs -->
-  <button {{on "click" this.toggleShowing}}>Show tooltip</button>
-
-  {{#if isShowing}}
-    <div class="tooltip">
-      I'm a tooltip!
-    </div>
-  {{/if}}
-  ```
 
   It also binds the function directly to the instance, so it can be used in any
   context and will correctly refer to the class it came from:
 
-  ```js
-  import Component from '@ember/component';
+  ```gjs
+  import Component from '@glimmer/component';
   import { tracked } from '@glimmer/tracking';
   import { action } from '@ember/object';
 
@@ -88,6 +88,10 @@ class EmberObject extends CoreObject.extend(Observable) {
     toggleShowing() {
       this.isShowing = !this.isShowing;
     }
+    
+    <template>
+      {{!-- ...--}}
+    </template>
   }
   ```
 
@@ -170,9 +174,10 @@ setClassicDecorator(action);
   });
   ```
 
-  Also available as `Function.prototype.observes` if prototype extensions are
-  enabled.
-
+  While observers are still supported, there are [plans to deprecate them](https://github.com/emberjs/rfcs/pull/1115)
+  See the [in-progress deprecation guide](https://github.com/ember-learn/deprecation-app/pull/1407) 
+  for guidance on how to avoid using observers.
+ 
   @method observer
   @for @ember/object
   @param {String} propertyNames*

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

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

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

@@ -63,10 +63,14 @@ function isQueryParams(value) {
   supplied model to the route as its `model` context of the route. The block for `LinkTo`
   becomes the contents of the rendered element:
 
-  ```handlebars
-  <LinkTo @route='photoGallery'>
-    Great Hamster Photos
-  </LinkTo>
+  ```gjs
+  import { LinkTo } from '@ember/routing';
+    
+  <template>
+    <LinkTo @route='photoGallery'>
+      Great Hamster Photos
+    </LinkTo>
+  </template>
   ```
 
   This will result in:

package/dist/dev/packages/@ember/routing/route.js

@@ -769,7 +769,7 @@ class Route extends EmberObject.extend(ActionHandler, Evented) {
     ```
      Note that for routes with dynamic segments, this hook is not always
     executed. If the route is entered through a transition (e.g. when
-    using the `link-to` Handlebars helper or the `transitionTo` method
+    using the `link-to` helper or the `transitionTo` method
     of routes), and a model context is already provided this hook
     is not called.
      A model context does not include a primitive string or number,

package/dist/dev/packages/@ember/routing/router-service.js

@@ -41,7 +41,7 @@ function cleanURL(url, rootURL) {
    In this example, the Router service is injected into a component to initiate a transition
    to a dedicated route:
 
-   ```app/components/example.js
+   ```app/components/example.gjs
    import Component from '@glimmer/component';
    import { action } from '@ember/object';
    import { service } from '@ember/service';
@@ -90,7 +90,7 @@ class RouterService extends Service.extend(Evented) {
       In the following example we use the Router service to navigate to a route with a
      specific model from a Component in the first action, and in the second we trigger
      a query-params only transition.
-      ```app/components/example.js
+      ```app/components/example.gjs
      import Component from '@glimmer/component';
      import { action } from '@ember/object';
      import { service } from '@ember/service';
@@ -175,10 +175,14 @@ class RouterService extends Service.extend(Evented) {
     URL is returned as a string that can be used for any purpose.
      In this example, the URL for the `author.books` route for a given author
     is copied to the clipboard.
-     ```app/templates/application.hbs
-    <CopyLink @author={{hash id="tomster" name="Tomster"}} />
+     ```app/templates/application.gjs
+    import CopyLink from '../components/copy-link';
+      
+    <template>
+      <CopyLink @author={{hash id="tomster" name="Tomster"}} />
+    </template>
     ```
-     ```app/components/copy-link.js
+     ```app/components/copy-link.gjs
     import Component from '@glimmer/component';
     import { service } from '@ember/service';
     import { action } from '@ember/object';
@@ -197,10 +201,13 @@ class RouterService extends Service.extend(Evented) {
     ```
      Just like with `transitionTo` and `replaceWith`, `urlFor` can also handle
     query parameters.
-     ```app/templates/application.hbs
-    <CopyLink @author={{hash id="tomster" name="Tomster"}} />
+     ```app/templates/application.gjs
+    import CopyLink from '../components/copy-link';
+     <template>
+      <CopyLink @author={{hash id="tomster" name="Tomster"}} />
+    </template>
     ```
-     ```app/components/copy-link.js
+     ```app/components/copy-link.gjs
     import Component from '@glimmer/component';
     import { service } from '@ember/service';
     import { action } from '@ember/object';
@@ -237,7 +244,7 @@ class RouterService extends Service.extend(Evented) {
      See [model](api/ember/release/classes/Route/methods/model?anchor=model) and
      [queryParams](/api/ember/3.7/classes/Route/properties/queryParams?anchor=queryParams) for more information about these arguments.
       In the following example, `isActive` will return `true` if the current route is `/posts`.
-      ```app/components/posts.js
+      ```app/components/posts.gjs
      import Component from '@glimmer/component';
      import { service } from '@ember/service';
       export default class extends Component {
@@ -249,7 +256,7 @@ class RouterService extends Service.extend(Evented) {
      ```
       The next example includes a dynamic segment, and will return `true` if the current route is `/posts/1`,
      assuming the post has an id of 1:
-      ```app/components/posts.js
+      ```app/components/posts.gjs
      import Component from '@glimmer/component';
      import { service } from '@ember/service';
       export default class extends Component {
@@ -323,7 +330,7 @@ class RouterService extends Service.extend(Evented) {
       See [RouteInfo](/ember/release/classes/RouteInfo) for more info.
       In the following example `recognize` is used to verify if a path belongs to our
      application before transitioning to it.
-      ```
+      ```js
      import Component from '@ember/component';
      import { service } from '@ember/service';
       export default class extends Component {
@@ -626,7 +633,7 @@ class RouterService extends Service.extend(Evented) {
     happens (even when that transition only changes parameters
     and doesn't change the active route).
      Usage example:
-    ```app/components/header.js
+    ```app/components/header.gjs
       import Component from '@glimmer/component';
       import { service } from '@ember/service';
       import { notEmpty } from '@ember/object/computed';

package/dist/dev/packages/@ember/template-compiler/lib/compile-options.js

@@ -1,6 +1,6 @@
-import { o as or, d as not, c as lte, l as lt, b as gte, g as gt, n as neq, a as and, e as eq } from '../../../shared-chunks/or-O0eJQ4K-.js';
-import { h as hash, f as fn, a as array } from '../../../shared-chunks/hash-BRRFQJ99.js';
-import { e as element } from '../../../shared-chunks/element-DQJOvSlQ.js';
+import { o as or, d as not, c as lte, l as lt, b as gte, g as gt, n as neq, a as and, e as eq } from '../../../shared-chunks/or-BTH3yuFG.js';
+import { h as hash, f as fn, a as array } from '../../../shared-chunks/hash-BTwOuDGQ.js';
+import { e as element } from '../../../shared-chunks/element-Cf3hqNOD.js';
 import { on } from '../../modifier/on.js';
 import '../../debug/index.js';
 import { STRICT_MODE_KEYWORDS, STRICT_MODE_TRANSFORMS, RESOLUTION_MODE_TRANSFORMS } from './plugins/index.js';

package/dist/dev/packages/@glimmer/runtime/index.js

@@ -3,11 +3,11 @@ export { D as DOMChanges, a as DynamicScopeImpl, E as EnvironmentImpl, b as IDOM
 export { T as TEMPLATE_ONLY_COMPONENT_MANAGER, a as TemplateOnlyComponent, b as TemplateOnlyComponentManager, t as templateOnlyComponent } from '../../shared-chunks/template-only-BqOt8bDl.js';
 export { C as CurriedValue, E as EMPTY_ARGS, a as EMPTY_NAMED, b as EMPTY_POSITIONAL, c as createCapturedArgs, d as curry, r as reifyArgs, e as reifyNamed, f as reifyPositional } from '../../shared-chunks/untouchable-this-B3DVwpHS.js';
 export { n as normalizeProperty } from '../../shared-chunks/props-fiqxqhAH.js';
-export { a as and, e as eq, g as gt, b as gte, l as lt, c as lte, n as neq, d as not, o as or } from '../../shared-chunks/or-O0eJQ4K-.js';
-export { a as array, f as fn, h as hash } from '../../shared-chunks/hash-BRRFQJ99.js';
-export { c as concat, g as get } from '../../shared-chunks/get-D5b5QlqE.js';
+export { a as and, e as eq, g as gt, b as gte, l as lt, c as lte, n as neq, d as not, o as or } from '../../shared-chunks/or-BTH3yuFG.js';
+export { a as array, f as fn, h as hash } from '../../shared-chunks/hash-BTwOuDGQ.js';
+export { c as concat, g as get } from '../../shared-chunks/get-BehtPmsu.js';
 export { i as invokeHelper } from '../../shared-chunks/invoke-B8M5fQQS.js';
-export { o as on } from '../../shared-chunks/on-BueSMv9L.js';
+export { o as on } from '../../shared-chunks/on-BQii6ILK.js';
 export { destroy, isDestroyed, isDestroying, registerDestructor } from '../destroyable/index.js';
 import '../global-context/index.js';
 import '../../shared-chunks/cache-B7dqAS38.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.1.0-beta.1';
+const VERSION = '7.1.0';
 
 export { VERSION as default };

package/dist/dev/packages/shared-chunks/{element-DQJOvSlQ.js → element-Cf3hqNOD.js}

@@ -84,6 +84,8 @@ function getElementDefinition(tagName) {
   Passing `null`, `undefined`, or non-string values will throw an assertion error.
 
   Changing the tag name will tear down and recreate the element and its contents.
+ 
+  The `element` helper is built-in and does not need to be imported.
 
   @method element
   @for Ember.Templates.helpers

package/dist/dev/packages/shared-chunks/{get-D5b5QlqE.js → get-BehtPmsu.js}

@@ -1,6 +1,6 @@
 import { a as createComputeRef, U as UNDEFINED_REFERENCE, v as valueForRef } from './reference-BoPB2LfI.js';
 import { f as reifyPositional } from './untouchable-this-B3DVwpHS.js';
-import { i as internalHelper } from './hash-BRRFQJ99.js';
+import { i as internalHelper } from './hash-BTwOuDGQ.js';
 import { setPath, getPath } from '../@glimmer/global-context/index.js';
 import { i as isDict } from './collections-DPkjqeA3.js';
 
@@ -19,10 +19,15 @@ const normalizeTextValue = value => {
 
   Example:
 
-  ```handlebars
-  {{some-component name=(concat firstName " " lastName)}}
 
-  {{! would pass name="<first name value> <last name value>" to the component}}
+  ```gjs
+  import { concat } from '@ember/helper';
+
+  <template>
+  {{yield (concat firstName " " lastName)}}
+
+  {{! would yield name="<first name value> <last name value>" to the component}}
+  </template>
   ```
 
   or for angle bracket invocation, you actually don't need concat at all.
@@ -46,28 +51,31 @@ const concat = internalHelper(({
 
   For example, these two usages are equivalent:
 
-  ```app/components/developer-detail.js
+  ```app/components/developer-detail.gjs
   import Component from '@glimmer/component';
   import { tracked } from '@glimmer/tracking';
+  import { get } from '@ember/object';
 
   export default class extends Component {
     @tracked developer = {
       name: "Sandi Metz",
       language: "Ruby"
     }
+    
+    <template>
+      {{this.developer.name}}
+      {{get this.developer "name"}}
+    </template>
   }
   ```
 
-  ```handlebars
-  {{this.developer.name}}
-  {{get this.developer "name"}}
-  ```
-
   If there were several facts about a person, the `{{get}}` helper can dynamically
   pick one:
 
-  ```app/templates/application.hbs
-  <DeveloperDetail @factName="language" />
+  ```app/templates/application.gjs
+  <template>
+    <DeveloperDetail @factName="language" />
+  </template>
   ```
 
   ```handlebars
@@ -77,10 +85,11 @@ const concat = internalHelper(({
   For a more complex example, this template would allow the user to switch
   between showing the user's height and weight with a click:
 
-  ```app/components/developer-detail.js
+  ```app/components/developer-detail.gjs
   import Component from '@glimmer/component';
   import { tracked } from '@glimmer/tracking';
-
+  import { get } from '@ember/object';
+    
   export default class extends Component {
     @tracked developer = {
       name: "Sandi Metz",
@@ -92,28 +101,16 @@ const concat = internalHelper(({
     showFact = (fact) => {
       this.currentFact = fact;
     }
-  }
-  ```
-
-  ```app/components/developer-detail.js
-  {{get this.developer this.currentFact}}
-
-  <button {{on 'click' (fn this.showFact "name")}}>Show name</button>
-  <button {{on 'click' (fn this.showFact "language")}}>Show language</button>
-  ```
+    
+    <template>
+      {{get this.developer this.currentFact}}
 
-  The `{{get}}` helper can also respect mutable values itself. For example:
-
-  ```app/components/developer-detail.js
-  <Input @value={{mut (get this.person this.currentFact)}} />
-
-  <button {{on 'click' (fn this.showFact "name")}}>Show name</button>
-  <button {{on 'click' (fn this.showFact "language")}}>Show language</button>
+      <button {{on 'click' (fn this.showFact "name")}}>Show name</button>
+      <button {{on 'click' (fn this.showFact "language")}}>Show language</button>
+    </template>
+  }
   ```
 
-  Would allow the user to swap what fact is being displayed, and also edit
-  that fact via a two-way mutable binding.
-
   @public
   @method get
  */

package/dist/dev/packages/shared-chunks/{hash-BRRFQJ99.js → hash-BTwOuDGQ.js}

@@ -19,7 +19,7 @@ function internalHelper(helper) {
    ```
     or
    ```handlebars
-   {{my-component people=(array
+   {{yield people=(array
      'Tom Dale'
      'Yehuda Katz'
      this.myOtherPerson)
@@ -58,13 +58,17 @@ const context = buildUntouchableThis('`fn` helper');
   to a component invoked within the loop. Here's how you could use the `fn`
   helper to pass both the function and its arguments together:
 
-    ```app/templates/components/items-listing.hbs
-  {{#each @items as |item|}}
-    <DisplayItem @item=item @select={{fn this.handleSelected item}} />
-  {{/each}}
+  ```app/components/items-listing.gjs
+  import DisplayItem from './display-item';
+    
+  <template>
+    {{#each @items as |item|}}
+      <DisplayItem @item=item @select={{fn this.handleSelected item}} />
+    {{/each}}
+  </template>
   ```
 
-  ```app/components/items-list.js
+  ```app/components/items-list.gjs
   import Component from '@glimmer/component';
   import { action } from '@ember/object';
 
@@ -75,7 +79,7 @@ const context = buildUntouchableThis('`fn` helper');
   }
   ```
 
-  In this case the `display-item` component will receive a normal function
+  In this case the `DisplayItem` component will receive a normal function
   that it can invoke. When it invokes the function, the `handleSelected`
   function will receive the `item` and any arguments passed, thanks to the
   `fn` helper.
@@ -92,7 +96,7 @@ const context = buildUntouchableThis('`fn` helper');
   `handleSelected` is properly bound to the `items-list`, but let's explore what
   happens if we left out the arrow function:
 
-  ```app/components/items-list.js
+  ```app/components/items-list.gjs
   import Component from '@glimmer/component';
 
   export default class ItemsList extends Component {
@@ -109,6 +113,8 @@ const context = buildUntouchableThis('`fn` helper');
 
   See also [partial application](https://en.wikipedia.org/wiki/Partial_application).
 
+  `fn` is built-in and does not require any additional imports.
+ 
   @method fn
   @public
 */
@@ -138,7 +144,7 @@ function assertCallbackIsFn(callbackRef) {
 
 /**
    Use the `{{hash}}` helper to create a hash to pass as an option to your
-   components. This is specially useful for contextual components where you can
+   components. This is especially useful for contextual components where you can
    just yield a hash:
 
    ```handlebars