ember-source 7.2.0-beta.1 → 7.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember-source",
-  "version": "7.2.0-beta.1",
+  "version": "7.2.1",
   "description": "A JavaScript framework for creating ambitious web applications",
   "type": "module",
   "keywords": [
@@ -367,9 +367,6 @@
     }
   },
   "packageManager": "pnpm@10.33.2",
-  "_originalVersion": "7.2.0-beta.1",
-  "_versionPreviouslyCalculated": true,
-  "publishConfig": {
-    "tag": "beta"
-  }
+  "_originalVersion": "7.2.1",
+  "_versionPreviouslyCalculated": true
 }

package/types/stable/@ember/-internals/glimmer/index.d.ts

@@ -82,8 +82,8 @@ declare module '@ember/-internals/glimmer' {
       )}}></span>
       ```
 
-      Ember's built-in helpers are described under the [Ember.Templates.helpers](/ember/release/classes/Ember.Templates.helpers)
-      namespace. Documentation on creating custom helpers can be found under
+      Ember's built-in and importable helpers are described under the [@ember/helper](../modules/@ember%2Fhelper).
+      module. Documentation on creating custom helpers can be found under
       [helper](/ember/release/functions/@ember%2Fcomponent%2Fhelper/helper) (or
       under [Helper](/ember/release/classes/Helper) if a helper requires access to
       dependency injection).
@@ -101,387 +101,14 @@ declare module '@ember/-internals/glimmer' {
      @module ember
      */
     /**
+
+     ## Looking for template keywords and helpers?
+       
+     See [@ember/helper](../modules/@ember%2Fhelper).
+     
      @class Ember.Templates.helpers
      @public
      */
-    /**
-      `{{yield}}` denotes an area of a template that will be rendered inside
-      of another template.
-
-      ### Use with `Component`
-
-      When designing components `{{yield}}` is used to denote where, inside the component's
-      template, an optional block passed to the component should render:
-
-      ```app/templates/application.gjs
-      import LabeledTextField from '../components/labeled-textfield';
-        
-      <template>
-        <LabeledTextField @value={{@model.name}}>
-          First name:
-        </LabeledTextField>
-      </template>
-      ```
-
-      ```app/components/labeled-textfield.gjs
-      import { Input } from '@ember/component';
-        
-      <template>
-        <label>
-          {{yield}} <Input @value={{@value}} />
-        </label>
-      </template>
-      ```
-
-      Result:
-
-      ```html
-      <label>
-        First name: <input type="text" />
-      </label>
-      ```
-
-      Additionally you can `yield` properties into the context for use by the consumer:
-
-      ```app/templates/application.gjs
-      import Component from '@glimmer/component';
-      import LabeledTextField from '../components/labeled-textfield';
-        
-      export default class Application extends Component {
-        firstNameValidator = (value) => {
-          // validates
-        }
-        
-        <template>
-          <LabeledTextField @value={{@model.validation}} @validator={{this.firstNameValidator}} as |validationError|>
-            {{#if validationError}}
-              <p class="error">{{validationError}}</p>
-            {{/if}}
-            First name:
-          </LabeledTextField>
-        </template>
-      }
-      ```
-
-      ```app/components/labeled-textfield.gjs
-      import { Input } from '@ember/component';
-        
-      <template>
-        <label>
-          {{yield this.validationError}} <Input @value={{@value}} />
-        </label>
-      </template>
-      ```
-
-      Result:
-
-      ```html
-      <label>
-        <p class="error">First Name must be at least 3 characters long.</p>
-        First name: <input type="text" />
-      </label>
-      ```
-
-      `yield` can also be used with the `hash` helper:
-
-      ```app/templates/application.gjs
-      import DateRanges from '../components/date-ranges';
-        
-      <template>
-        <DateRanges @value={{@model.date}} as |range|>
-          Start date: {{range.start}}
-          End date: {{range.end}}
-        </DateRanges>
-      </template>
-      ```
-
-      ```app/components/date-ranges.gjs
-      <template>
-        <div>
-          {{yield (hash start=@value.start end=@value.end)}}
-        </div>
-      </template>
-      ```
-
-      Result:
-
-      ```html
-      <div>
-        Start date: July 1st
-        End date: July 30th
-      </div>
-      ```
-
-      Multiple values can be yielded as block params:
-        
-      ```app/templates/application.gjs
-      import Banner from '../components/banner';
-        
-      <template>
-        <Banner @value={{@model}} as |title subtitle body|>
-          <h1>{{title}}</h1>
-          <h2>{{subtitle}}</h2>
-          {{body}}
-        </Banner>
-      </template>
-      ```
-
-      ```app/components/banner.gjs
-      <template>
-        <div>
-          {{yield "Hello title" "hello subtitle" "body text"}}
-        </div>
-      </template>
-      ```
-
-      Result:
-
-      ```html
-      <div>
-        <h1>Hello title</h1>
-        <h2>hello subtitle</h2>
-        body text
-      </div>
-      ```
-
-      However, it is preferred to use the hash helper, as this can prevent breaking changes to your component and also simplify the api for the component.
-
-      Multiple components can be yielded with the `hash` and `component` helper:
-
-      ```app/templates/application.gjs
-      import Banner from '../components/banner';
-
-      <template>
-        <Banner @value={{@model}} as |banner|>
-          <banner.Title>Banner title</banner.Title>
-          <banner.Subtitle>Banner subtitle</banner.Subtitle>
-          <banner.Body>A load of body text</banner.Body>
-        </Banner>
-      </template>
-      ```
-
-      ```app/components/banner.gjs
-      import Title from './banner/title';
-      import Subtitle from './banner/subtitle';
-      import Body from './banner/body';
-
-      export default class Banner extends Component {
-        Title = Title;
-        Subtitle = Subtitle;
-        Body = Body;
-        
-        <template>
-          <div>
-            {{yield (hash
-              Title=this.Title
-              Subtitle=this.Subtitle
-              Body=(component this.Body defaultArg="some value")
-            )}}
-          </div>
-        </template>
-      }
-      ```
-
-      Result:
-
-      ```html
-      <div>
-        <h1>Banner title</h1>
-        <h2>Banner subtitle</h2>
-        A load of body text
-      </div>
-      ```
-
-      A benefit of using this pattern is that the user of the component can change the order the components are displayed.
-
-      ```app/templates/application.gjs
-      import Banner from '../components/banner';
-
-      <template>
-        <Banner @value={{@model}} as |banner|>
-          <banner.Subtitle>Banner subtitle</banner.Subtitle>
-          <banner.Title>Banner title</banner.Title>
-          <banner.Body>A load of body text</banner.Body>
-        </Banner>
-      </template>
-      ```
-
-      Result:
-
-      ```html
-      <div>
-        <h2>Banner subtitle</h2>
-        <h1>Banner title</h1>
-        A load of body text
-      </div>
-      ```
-
-      Another benefit to using `yield` with the `hash` and `component` helper
-      is you can pass attributes and arguments to these components:
-
-      ```app/templates/application.gjs
-      import Banner from '../components/banner';
-
-      <template>
-        <Banner @value={{@model}} as |banner|>
-          <banner.Subtitle class="mb-1">Banner subtitle</banner.Subtitle>
-          <banner.Title @variant="loud">Banner title</banner.Title>
-          <banner.Body>A load of body text</banner.Body>
-        </Banner>
-      </template>
-      ```
-
-      ```app/components/banner/subtitle.gjs
-      {{!-- note the use of ..attributes --}}
-      <h2 ...attributes>
-        {{yield}}
-      </h2>
-      ```
-
-      ```app/components/banner/title.gjs
-      <template>
-        {{#if (eq @variant "loud")}}
-          <h1 class="loud">{{yield}}</h1>
-        {{else}}
-          <h1 class="quiet">{{yield}}</h1>
-        {{/if}}
-      </template>
-      ```
-
-      Result:
-
-      ```html
-      <div>
-        <h2 class="mb-1">Banner subtitle</h2>
-        <h1 class="loud">Banner title</h1>
-        A load of body text
-      </div>
-      ```
-
-      @method yield
-      @for Ember.Templates.helpers
-      @param {Hash} options
-      @return {String} HTML string
-      @public
-     */
-    /**
-      `{{(has-block)}}` indicates if the component was invoked with a block.
-
-      This component is invoked with a block:
-
-      ```handlebars
-      <MyComponent>
-        Hi Jen!
-      </MyComponent>
-      ```
-
-      This component is invoked without a block:
-
-      ```handlebars
-      <MyComponent />
-      ```
-
-      This is useful when you want to create a component that can optionally take a block
-      and then render a default template when it is not invoked with a block.
-
-      ```app/components/my-component.gjs
-      <template>
-        {{#if (has-block)}}
-          Welcome {{yield}}, we are happy you're here!
-        {{else}}
-          Hey you! You're great!
-        {{/if}}
-      </template>
-      ```
-
-      @method has-block
-      @for Ember.Templates.helpers
-      @param {String} the name of the block. The name (at the moment) is either "main" or "inverse" (though only curly components support inverse)
-      @return {Boolean} `true` if the component was invoked with a block
-      @public
-     */
-    /**
-      `{{(has-block-params)}}` indicates if the component was invoked with block params.
-
-      This component is invoked with block params:
-        
-      ```handlebars
-      <MyComponent as |favoriteFlavor|>
-      Hi Jen!
-      </MyComponent>
-      ```
-
-      And without block params:
-
-      ```handlebars
-      <MyComponent>
-      Hi Jen!
-      </MyComponent>
-      ```
-
-      This is useful when you want to create a component that can render itself
-      differently when it is not invoked with block params.
-
-      ```app/components/my-component.gjs
-      <template>
-        {{#if (has-block-params)}}
-          Welcome {{yield this.favoriteFlavor}}, we're happy you're here and hope you
-          enjoy your favorite ice cream flavor.
-        {{else}}
-          Welcome {{yield}}, we're happy you're here, but we're unsure what
-          flavor ice cream you would enjoy.
-        {{/if}}
-      </template>
-      ```
-
-      @method has-block-params
-      @for Ember.Templates.helpers
-      @param {String} the name of the block. The name (at the moment) is either "main" or "inverse" (though only curly components support inverse)
-      @return {Boolean} `true` if the component was invoked with block params
-      @public
-     */
-    /**
-      Execute the `debugger` statement in the current template's context.
-
-      ```handlebars
-      {{debugger}}
-      ```
-
-      When using the debugger helper you will have access to a `get` function. This
-      function retrieves values available in the context of the template.
-      For example, if you're wondering why a value `{{foo}}` isn't rendering as
-      expected within a template, you could place a `{{debugger}}` statement and,
-      when the `debugger;` breakpoint is hit, you can attempt to retrieve this value:
-
-      ```
-      > get('foo')
-      ```
-
-      `get` is also aware of keywords. So in this situation
-
-      ```handlebars
-      {{#each this.items as |item|}}
-        {{debugger}}
-      {{/each}}
-      ```
-
-      You'll be able to get values from the current item:
-
-      ```
-      > get('item.name')
-      ```
-
-      You can also access the context of the view to make sure it is the object that
-      you expect:
-
-      ```
-      > context
-      ```
-
-      @method debugger
-      @for Ember.Templates.helpers
-      @public
-     */
     export { default as template, templateCacheCounters } from "@glimmer/opcode-compiler/lib/template";
     export { default as RootTemplate } from "@ember/-internals/glimmer/lib/templates/root";
     export { default as Input } from "@ember/-internals/glimmer/lib/components/input";

package/types/stable/@ember/-internals/glimmer/lib/component.d.ts

@@ -657,7 +657,7 @@ declare module '@ember/-internals/glimmer/lib/component' {
 
       See the [Guide on Component event
       handlers](https://guides.emberjs.com/release/components/component-state-and-actions/#toc_html-modifiers-and-actions)
-      and the [API docs for `on`](../Ember.Templates.helpers/methods/on?anchor=on)
+      and the [API docs for `on`](../functions/Keywords/on)
       for more details.
 
       ### Event Handler Methods

package/types/stable/@ember/-internals/glimmer/lib/helper.d.ts

@@ -29,7 +29,7 @@ declare module '@ember/-internals/glimmer/lib/helper' {
       Ember Helpers are functions that can compute values, and are used in templates.
       For example, this code calls a helper named `format-currency`:
 
-      ```app/templates/application.gjs
+      ```gjs {data-filename="app/templates/application.gjs"}
       import Cost from '../components/cost';
         
       <template>
@@ -37,7 +37,7 @@ declare module '@ember/-internals/glimmer/lib/helper' {
       </template>
       ```
 
-      ```app/components/cost.gjs
+      ```gjs {data-filename="app/components/cost.gjs"}
       import formatCurrency from '../helpers/format-currency';
         
       <template>