ember-source 7.2.0-alpha.3 → 7.2.0-beta.1

package/types/stable/@ember/controller/index.d.ts

@@ -25,7 +25,7 @@ declare module '@ember/controller' {
         /**
           The object to which actions from the view should be sent.
       
-          For example, when a Handlebars template uses the `{{action}}` helper,
+          For example, when a template uses the `{{action}}` helper,
           it will attempt to send the action to the view's controller's `target`.
       
           By default, the value of the target property is set to the router, and

package/types/stable/@ember/helper/index.d.ts

@@ -322,18 +322,12 @@ declare module '@ember/helper' {
      * 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).
      */
     export const hash: HashHelper;
     export interface HashHelper extends Opaque<"helper:hash"> {
@@ -343,7 +337,6 @@ declare module '@ember/helper' {
      * as an argument to your components.
      *
      * ```js
-     * import { array } from '@ember/helper';
      *
      * <template>
      *   <ul>
@@ -352,10 +345,6 @@ declare module '@ember/helper' {
      *   {{/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).
      * ```
      */
     export const array: ArrayHelper;
@@ -378,10 +367,6 @@ declare module '@ember/helper' {
      *
      * 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).
      */
     export const concat: ConcatHelper;
     export interface ConcatHelper extends Opaque<"helper:concat"> {
@@ -423,10 +408,6 @@ declare module '@ember/helper' {
      *
      * 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).
      */
     export const get: GetHelper;
     export interface GetHelper extends Opaque<"helper:get"> {

package/types/stable/@ember/object/index.d.ts

@@ -55,9 +55,10 @@ declare module '@ember/object' {
       });
       ```
 
-      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/types/stable/@ember/object/observable.d.ts

@@ -307,6 +307,10 @@ declare module '@ember/object/observable' {
           only a sender and key value as parameters or, if you aren't interested in
           any of these values, to write an observer that has no parameters at all.
       
+          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 addObserver
           @param {String} key The key to observe
           @param {Object} target The target object to invoke

package/types/stable/@ember/reactive/collections.d.ts

@@ -16,7 +16,6 @@ declare module '@ember/reactive/collections' {
      *
      * See [MDN for more information](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
      *
-     * @example
      * ```javascript
      * import { trackedArray } from '@ember/reactive/collections';
      * import { on } from '@ember/modifier';
@@ -58,7 +57,6 @@ declare module '@ember/reactive/collections' {
      *
      * See [MDN for more information](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
      *
-     * @example
      * ```gjs
      * import { trackedObject } from '@ember/reactive/collections';
      * import { on } from '@ember/modifier';
@@ -100,7 +98,6 @@ declare module '@ember/reactive/collections' {
      *
      * See [MDN for more information](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set)
      *
-     * @example
      * ```gjs
      * import { trackedSet } from '@ember/reactive/collections';
      * import { on } from '@ember/modifier';
@@ -146,7 +143,6 @@ declare module '@ember/reactive/collections' {
      *
      * See [MDN for more information](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet)
      *
-     * @example
      * ```gjs
      * import { trackedWeakSet } from '@ember/reactive/collections';
      * import { on } from '@ember/modifier';
@@ -183,7 +179,6 @@ declare module '@ember/reactive/collections' {
      *
      * See [MDN for more information](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map)
      *
-     * @example
      * ```gjs
      * import { trackedMap } from '@ember/reactive/collections';
      * import { on } from '@ember/modifier';
@@ -229,7 +224,6 @@ declare module '@ember/reactive/collections' {
      *
      * See [MDN for more information](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)
      *
-     * @example
      * ```gjs
      * import { trackedWeakMap } from '@ember/reactive/collections';
      * import { on } from '@ember/modifier';

package/types/stable/@ember/routing/lib/generate_controller.d.ts

@@ -1,6 +1,6 @@
 declare module '@ember/routing/lib/generate_controller' {
     import type { InternalFactory, default as Owner } from "@ember/-internals/owner";
-    import Controller from "@ember/controller";
+    import type Controller from "@ember/controller";
     /**
      @module @ember/routing
     */

package/types/stable/@ember/routing/route.d.ts

@@ -821,7 +821,7 @@ declare module '@ember/routing/route' {
       
           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.
       
@@ -948,7 +948,7 @@ declare module '@ember/routing/route' {
           the framework will use it.
           If it is not defined, a basic `Controller` instance would be used.
       
-          @example Behavior of a basic Controller
+          Example Behavior of a basic Controller
       
           ```app/routes/post.js
           import Route from '@ember/routing/route';

package/types/stable/@ember/routing/router-service.d.ts

@@ -17,7 +17,7 @@ declare module '@ember/routing/router-service' {
        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';
@@ -58,7 +58,7 @@ declare module '@ember/routing/router-service' {
            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';
@@ -137,11 +137,15 @@ declare module '@ember/routing/router-service' {
           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';
@@ -164,11 +168,15 @@ declare module '@ember/routing/router-service' {
           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';
@@ -206,7 +214,7 @@ declare module '@ember/routing/router-service' {
       
            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';
       
@@ -222,7 +230,7 @@ declare module '@ember/routing/router-service' {
            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';
       
@@ -257,7 +265,7 @@ declare module '@ember/routing/router-service' {
            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';
       
@@ -568,7 +576,7 @@ declare module '@ember/routing/router-service' {
           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/types/stable/@glimmer/runtime/lib/component/template-only.d.ts

@@ -25,8 +25,6 @@ declare module '@glimmer/runtime/lib/component/template-only' {
       to use these semantics for its templates but cannot be certain it will only be consumed by applications that have enabled the
       `template-only-glimmer-components` optional feature.
 
-      @example
-
       ```js
       import { templateOnlyComponent } from '@glimmer/runtime';
 

package/types/stable/@glimmer/runtime/lib/dom/sanitized-values.d.ts

@@ -1,5 +1,5 @@
 declare module '@glimmer/runtime/lib/dom/sanitized-values' {
-    import type { SimpleElement } from "@glimmer/interfaces";
-    export function requiresSanitization(tagName: string, attribute: string): boolean;
+    import type { Nullable, SimpleElement } from "@glimmer/interfaces";
+    export function requiresSanitization(tagName: Nullable<string>, attribute: string): boolean;
     export function sanitizeAttributeValue(element: SimpleElement, attribute: string, value: unknown): unknown;
 }

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

@@ -12,7 +12,7 @@ declare module '@glimmer/runtime/lib/helpers/array' {
        ```
         or
        ```handlebars
-       {{my-component people=(array
+       {{yield people=(array
          'Tom Dale'
          'Yehuda Katz'
          this.myOtherPerson)

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

@@ -4,10 +4,15 @@ declare module '@glimmer/runtime/lib/helpers/concat' {
 
       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.

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

@@ -9,13 +9,17 @@ declare module '@glimmer/runtime/lib/helpers/fn' {
       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';
 
@@ -26,7 +30,7 @@ declare module '@glimmer/runtime/lib/helpers/fn' {
       }
       ```
 
-      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.
@@ -43,7 +47,7 @@ declare module '@glimmer/runtime/lib/helpers/fn' {
       `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 {
@@ -60,6 +64,8 @@ declare module '@glimmer/runtime/lib/helpers/fn' {
 
       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
     */

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';
 

package/types/stable/index.d.ts

@@ -187,6 +187,7 @@
 /// <reference path="./@ember/application/namespace.d.ts" />
 /// <reference path="./@ember/array/-internals.d.ts" />
 /// <reference path="./@ember/array/index.d.ts" />
+/// <reference path="./@ember/array/lib/is-array.d.ts" />
 /// <reference path="./@ember/array/lib/make-array.d.ts" />
 /// <reference path="./@ember/array/make.d.ts" />
 /// <reference path="./@ember/array/mutable.d.ts" />

package/dist/prod/packages/shared-chunks/{collections-C3Y8z_9v.js → collections-GpG8lT2g.js}

@@ -1,3 +1,12 @@
+function unwrap(val) {
+  return val;
+}
+function expect(val, message) {
+  return val;
+}
+function exhausted(value) {
+}
+
 function isPresentArray(list) {
   return list ? list.length > 0 : false;
 }
@@ -21,15 +30,6 @@ function mapPresentArray(list, mapper) {
   return out;
 }
 
-function unwrap(val) {
-  return val;
-}
-function expect(val, message) {
-  return val;
-}
-function exhausted(value) {
-}
-
 function dict() {
   return Object.create(null);
 }