ember-source 7.2.0-alpha.4 → 7.3.0-alpha.1

package/types/stable/@glimmer/runtime/lib/helpers/get.d.ts

@@ -5,28 +5,31 @@ declare module '@glimmer/runtime/lib/helpers/get' {
 
       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
@@ -36,10 +39,11 @@ declare module '@glimmer/runtime/lib/helpers/get' {
       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",
@@ -51,28 +55,16 @@ declare module '@glimmer/runtime/lib/helpers/get' {
         showFact = (fact) => {
           this.currentFact = fact;
         }
-      }
-      ```
-
-      ```app/components/developer-detail.js
-      {{get this.developer this.currentFact}}
+        
+        <template>
+          {{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>
-      ```
-
-      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/types/stable/@glimmer/runtime/lib/helpers/hash.d.ts

@@ -1,7 +1,7 @@
 declare module '@glimmer/runtime/lib/helpers/hash' {
     /**
        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

package/types/stable/@glimmer/syntax/lib/get-template-locals.d.ts

@@ -4,7 +4,7 @@ declare module '@glimmer/syntax/lib/get-template-locals' {
         includeHtmlElements?: boolean;
     }
     /**
-     * Parses and traverses a given handlebars html template to extract all template locals
+     * Parses and traverses a given template to extract all template locals
      * referenced that could possible come from the parent scope. Can exclude known keywords
      * optionally.
      */

package/types/stable/@glimmer/tracking/index.d.ts

@@ -20,17 +20,7 @@ declare module '@glimmer/tracking' {
       property changes, any templates that used that property, directly or
       indirectly, will rerender. For instance, consider this component:
 
-      ```handlebars
-      <div>Count: {{this.count}}</div>
-      <div>Times Ten: {{this.timesTen}}</div>
-      <div>
-        <button {{on "click" this.plusOne}}>
-          Plus One
-        </button>
-      </div>
-      ```
-
-      ```javascript
+      ```gjs
       import Component from '@glimmer/component';
       import { tracked } from '@glimmer/tracking';
       import { action } from '@ember/object';
@@ -46,6 +36,16 @@ declare module '@glimmer/tracking' {
         plusOne() {
           this.count += 1;
         }
+        
+        <template>
+          <div>Count: {{this.count}}</div>
+          <div>Times Ten: {{this.timesTen}}</div>
+          <div>
+            <button {{on "click" this.plusOne}}>
+              Plus One
+            </button>
+          </div>
+        </template>
       }
       ```
 
@@ -55,7 +55,7 @@ declare module '@glimmer/tracking' {
       will cause a rerender when updated - this includes through method calls and
       other means:
 
-      ```javascript
+      ```gjs
       import Component from '@glimmer/component';
       import { tracked } from '@glimmer/tracking';