ember-source 7.1.0-alpha.5 → 7.1.0

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"> {
@@ -472,7 +453,6 @@ declare module '@ember/helper' {
      * @param {number} left
      * @param {number} right
      * @return {boolean}
-     * @private
      */
     export const gt: GtHelper;
     export interface GtHelper extends Opaque<"helper:gt"> {
@@ -496,7 +476,6 @@ declare module '@ember/helper' {
      * @param {number} left
      * @param {number} right
      * @return {boolean}
-     * @private
      */
     export const gte: GteHelper;
     export interface GteHelper extends Opaque<"helper:gte"> {
@@ -520,7 +499,6 @@ declare module '@ember/helper' {
      * @param {number} left
      * @param {number} right
      * @return {boolean}
-     * @private
      */
     export const lt: LtHelper;
     export interface LtHelper extends Opaque<"helper:lt"> {
@@ -544,7 +522,6 @@ declare module '@ember/helper' {
      * @param {number} left
      * @param {number} right
      * @return {boolean}
-     * @private
      */
     export const lte: LteHelper;
     export interface LteHelper extends Opaque<"helper:lte"> {
@@ -568,7 +545,6 @@ declare module '@ember/helper' {
      *
      * @method element
      * @param {string} tagName
-     * @private
      */
     export const element: ElementHelper;
     export interface ElementHelper extends Opaque<"helper:element"> {
@@ -612,7 +588,6 @@ declare module '@ember/helper' {
      * @param {unknown} left
      * @param {unknown} right
      * @return {boolean}
-     * @private
      */
     export const eq: EqHelper;
     export interface EqHelper extends Opaque<"helper:eq"> {
@@ -636,7 +611,6 @@ declare module '@ember/helper' {
      * @param {unknown} left
      * @param {unknown} right
      * @return {boolean}
-     * @private
      */
     export const neq: NeqHelper;
     export interface NeqHelper extends Opaque<"helper:neq"> {
@@ -660,7 +634,6 @@ declare module '@ember/helper' {
      * @method and
      * @param {unknown} args Two or more values to evaluate
      * @return {unknown} The first falsy value or the last value
-     * @private
      */
     export const and: AndHelper;
     export interface AndHelper extends Opaque<"helper:and"> {
@@ -684,7 +657,6 @@ declare module '@ember/helper' {
      * @method or
      * @param {unknown} args Two or more values to evaluate
      * @return {unknown} The first truthy value or the last value
-     * @private
      */
     export const or: OrHelper;
     export interface OrHelper extends Opaque<"helper:or"> {
@@ -707,7 +679,6 @@ declare module '@ember/helper' {
      * @method not
      * @param {unknown} value The value to negate
      * @return {boolean}
-     * @private
      */
     export const not: NotHelper;
     export interface NotHelper extends Opaque<"helper:not"> {

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/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.
       

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/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

@@ -177,7 +177,6 @@
 /// <reference path="./@ember/-internals/views/index.d.ts" />
 /// <reference path="./@ember/-internals/views/lib/compat/attrs.d.ts" />
 /// <reference path="./@ember/-internals/views/lib/compat/fallback-view-registry.d.ts" />
-/// <reference path="./@ember/-internals/views/lib/component_lookup.d.ts" />
 /// <reference path="./@ember/-internals/views/lib/mixins/action_support.d.ts" />
 /// <reference path="./@ember/-internals/views/lib/system/event_dispatcher.d.ts" />
 /// <reference path="./@ember/-internals/views/lib/system/utils.d.ts" />

package/dist/dev/packages/@ember/-internals/views/lib/component_lookup.js

@@ -1,14 +0,0 @@
-import EmberObject from '../../../object/index.js';
-
-class ComponentLookup extends EmberObject {
-  componentFor(name, owner) {
-    let fullName = `component:${name}`;
-    return owner.factoryFor(fullName);
-  }
-  layoutFor(name, owner, options) {
-    let templateFullName = `template:components/${name}`;
-    return owner.lookup(templateFullName, options);
-  }
-}
-
-export { ComponentLookup as default };

package/dist/dev/packages/shared-chunks/assert-CUCJBR2C.js

@@ -1,19 +0,0 @@
-// import Logger from './logger';
-
-function assert(test, msg) {
-}
-
-/**
- * This constant exists to make it easier to differentiate normal logs from
- * errant console.logs. LOGGER can be used outside of LOCAL_TRACE_LOGGING checks,
- * and is meant to be used in the rare situation where a console.* call is
- * actually appropriate.
- */
-const LOGGER = console;
-function assertNever(value, desc = 'unexpected unreachable branch') {
-  LOGGER.log('unreachable', value);
-  LOGGER.log(`${desc} :: ${JSON.stringify(value)} (${value})`);
-  throw new Error(`code reached unreachable`);
-}
-
-export { assert as a, assertNever as b };