ember-source 7.2.0-beta.1 → 7.2.0

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

@@ -36,38 +36,6 @@ declare module '@ember/object/compat' {
       }
       ```
 
-      Classic Example:
-
-      ```js
-      import { tracked } from '@glimmer/tracking';
-      import { dependentKeyCompat } from '@ember/object/compat';
-      import EmberObject, { computed, observer, set } from '@ember/object';
-
-      const Person = EmberObject.extend({
-        firstName: tracked(),
-        lastName: tracked(),
-
-        fullName: dependentKeyCompat(function() {
-          return `${this.firstName} ${this.lastName}`;
-        }),
-      });
-
-      const Profile = EmberObject.extend({
-        person: null,
-
-        helloMessage: computed('person.fullName', function() {
-          return `Hello, ${this.person.fullName}!`;
-        }),
-
-        onNameUpdated: observer('person.fullName', function() {
-          console.log('person name updated!');
-        }),
-      });
-      ```
-
-      `dependentKeyCompat()` can receive a getter function or an object containing
-      `get`/`set` methods when used in classic classes, like computed properties.
-
       In general, only properties which you _expect_ to be watched by older,
       untracked clases should be marked as dependency compatible. The decorator is
       meant as an interop layer for parts of Ember's older classic APIs, and should

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.gjs
+       ```gjs {data-filename="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.gjs
+           ```gjs {data-filename="app/components/example.gjs"}
            import Component from '@glimmer/component';
            import { action } from '@ember/object';
            import { service } from '@ember/service';
@@ -137,7 +137,7 @@ 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.gjs
+          ```gjs {data-filename="app/templates/application.gjs"}
           import CopyLink from '../components/copy-link';
             
           <template>
@@ -145,7 +145,7 @@ declare module '@ember/routing/router-service' {
           </template>
           ```
       
-          ```app/components/copy-link.gjs
+          ```gjs {data-filename="app/components/copy-link.gjs"}
           import Component from '@glimmer/component';
           import { service } from '@ember/service';
           import { action } from '@ember/object';
@@ -168,7 +168,7 @@ declare module '@ember/routing/router-service' {
           Just like with `transitionTo` and `replaceWith`, `urlFor` can also handle
           query parameters.
       
-          ```app/templates/application.gjs
+          ```gjs {data-filename="app/templates/application.gjs"}
           import CopyLink from '../components/copy-link';
       
           <template>
@@ -176,7 +176,7 @@ declare module '@ember/routing/router-service' {
           </template>
           ```
       
-          ```app/components/copy-link.gjs
+          ```gjs {data-filename="app/components/copy-link.gjs"}
           import Component from '@glimmer/component';
           import { service } from '@ember/service';
           import { action } from '@ember/object';
@@ -214,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.gjs
+           ```gjs {data-filename="app/components/posts.gjs"}
            import Component from '@glimmer/component';
            import { service } from '@ember/service';
       
@@ -230,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.gjs
+           ```gjs {data-filename="app/components/posts.gjs"}
            import Component from '@glimmer/component';
            import { service } from '@ember/service';
       
@@ -576,7 +576,7 @@ declare module '@ember/routing/router-service' {
           and doesn't change the active route).
       
           Usage example:
-          ```app/components/header.gjs
+          ```gjs {data-filename="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

@@ -1,36 +1,3 @@
 declare module '@glimmer/runtime/lib/helpers/array' {
-    /**
-       Use the `{{array}}` helper to create an array to pass as an option to your
-       components.
-
-       ```handlebars
-       <MyComponent @people={{array
-         'Tom Dale'
-         'Yehuda Katz'
-         this.myOtherPerson}}
-       />
-       ```
-        or
-       ```handlebars
-       {{yield people=(array
-         'Tom Dale'
-         'Yehuda Katz'
-         this.myOtherPerson)
-       }}
-       ```
-
-       Would result in an object such as:
-
-       ```js
-       ['Tom Dale', 'Yehuda Katz', this.get('myOtherPerson')]
-       ```
-
-       Where the 3rd item in the array is bound to updates of the `myOtherPerson` property.
-
-       @method array
-       @param {Array} options
-       @return {Array} Array
-       @public
-     */
     export const array: object;
 }

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

@@ -1,28 +1,3 @@
 declare module '@glimmer/runtime/lib/helpers/concat' {
-    /**
-      Concatenates the given arguments into a string.
-
-      Example:
-
-
-      ```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.
-
-      ```handlebars
-      <SomeComponent @name="{{firstName}} {{lastName}}" />
-      ```
-
-      @public
-      @method concat
-    */
     export const concat: object;
 }

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

@@ -1,73 +1,3 @@
 declare module '@glimmer/runtime/lib/helpers/fn' {
-    /**
-      The `fn` helper allows you to ensure a function that you are passing off
-      to another component, helper, or modifier has access to arguments that are
-      available in the template.
-
-      For example, if you have an `each` helper looping over a number of items, you
-      may need to pass a function that expects to receive the item as an argument
-      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/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.gjs
-      import Component from '@glimmer/component';
-      import { action } from '@ember/object';
-
-      export default class ItemsList extends Component {
-        handleSelected = (item) => {
-          // ...snip...
-        }
-      }
-      ```
-
-      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.
-
-      Let's take look at what that means in a couple circumstances:
-
-      - When invoked as `this.args.select()` the `handleSelected` function will
-        receive the `item` from the loop as its first and only argument.
-      - When invoked as `this.args.select('foo')` the `handleSelected` function
-        will receive the `item` from the loop as its first argument and the
-        string `'foo'` as its second argument.
-
-      In the example above, we used an arrow function to ensure that
-      `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.gjs
-      import Component from '@glimmer/component';
-
-      export default class ItemsList extends Component {
-        handleSelected(item) {
-          // ...snip...
-        }
-      }
-      ```
-
-      In this example, when `handleSelected` is invoked inside the `display-item`
-      component, it will **not** have access to the component instance. In other
-      words, it will have no `this` context, so please make sure your functions
-      are bound (via an arrow function or other means) before passing into `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
-    */
     export const fn: object;
 }

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

@@ -1,72 +1,3 @@
 declare module '@glimmer/runtime/lib/helpers/get' {
-    /**
-      Dynamically look up a property on an object. The second argument to `{{get}}`
-      should have a string value, although it can be bound.
-
-      For example, these two usages are equivalent:
-
-      ```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>
-      }
-      ```
-
-      If there were several facts about a person, the `{{get}}` helper can dynamically
-      pick one:
-
-      ```app/templates/application.gjs
-      <template>
-        <DeveloperDetail @factName="language" />
-      </template>
-      ```
-
-      ```handlebars
-      {{get this.developer @factName}}
-      ```
-
-      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.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"
-        }
-
-        @tracked currentFact = 'name'
-
-        showFact = (fact) => {
-          this.currentFact = fact;
-        }
-        
-        <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>
-        </template>
-      }
-      ```
-
-      @public
-      @method get
-     */
     export const get: object;
 }

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

@@ -1,39 +1,3 @@
 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 especially useful for contextual components where you can
-       just yield a hash:
-
-       ```handlebars
-       {{yield (hash
-          name='Sarah'
-          title=office
-       )}}
-       ```
-
-       Would result in an object such as:
-
-       ```js
-       { name: 'Sarah', title: this.get('office') }
-       ```
-
-       Where the `title` is bound to updates of the `office` property.
-
-       Note that the hash is an empty object with no prototype chain, therefore
-       common methods like `toString` are not available in the resulting hash.
-       If you need to use such a method, you can use the `call` or `apply`
-       approach:
-
-       ```js
-       function toString(obj) {
-         return Object.prototype.toString.apply(obj);
-       }
-       ```
-
-       @method hash
-       @param {Object} options
-       @return {Object} Hash
-       @public
-     */
     export const hash: object;
 }

package/types/stable/index.d.ts

@@ -74,30 +74,16 @@
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/-normalize-class.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/-resolve.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/-track-array.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/array.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/component.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/concat.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/each-in.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/element.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/fn.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/get.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/hash.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/helper.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/if-unless.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/internal-helper.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/log.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/modifier.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/mut.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/helpers/page-title.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/readonly.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/unbound.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/helpers/unique-id.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/modifiers/on.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/renderer.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/resolver.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/setup-registry.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/syntax/in-element.d.ts" />
-/// <reference path="./@ember/-internals/glimmer/lib/syntax/let.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/syntax/mount.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/syntax/outlet.d.ts" />
 /// <reference path="./@ember/-internals/glimmer/lib/template_registry.d.ts" />

package/dist/dev/packages/shared-chunks/get-6I3sjd-I.js

@@ -1,135 +0,0 @@
-import { c as createComputeRef, U as UNDEFINED_REFERENCE, v as valueForRef } from './reference-BqOLhKFy.js';
-import { f as reifyPositional } from './arguments-CDkbOqTS.js';
-import { i as internalHelper } from './hash-6NDs_5_f.js';
-import { setPath, getPath } from '../@glimmer/global-context/index.js';
-import { i as isDict } from './collections-DPkjqeA3.js';
-
-const isEmpty = value => {
-  return value === null || value === undefined || typeof value.toString !== 'function';
-};
-const normalizeTextValue = value => {
-  if (isEmpty(value)) {
-    return '';
-  }
-  return String(value);
-};
-
-/**
-  Concatenates the given arguments into a string.
-
-  Example:
-
-
-  ```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.
-
-  ```handlebars
-  <SomeComponent @name="{{firstName}} {{lastName}}" />
-  ```
-
-  @public
-  @method concat
-*/
-const concat = internalHelper(({
-  positional
-}) => {
-  return createComputeRef(() => reifyPositional(positional).map(normalizeTextValue).join(''), null, 'concat');
-});
-
-/**
-  Dynamically look up a property on an object. The second argument to `{{get}}`
-  should have a string value, although it can be bound.
-
-  For example, these two usages are equivalent:
-
-  ```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>
-  }
-  ```
-
-  If there were several facts about a person, the `{{get}}` helper can dynamically
-  pick one:
-
-  ```app/templates/application.gjs
-  <template>
-    <DeveloperDetail @factName="language" />
-  </template>
-  ```
-
-  ```handlebars
-  {{get this.developer @factName}}
-  ```
-
-  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.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"
-    }
-
-    @tracked currentFact = 'name'
-
-    showFact = (fact) => {
-      this.currentFact = fact;
-    }
-    
-    <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>
-    </template>
-  }
-  ```
-
-  @public
-  @method get
- */
-const get = internalHelper(({
-  positional
-}) => {
-  let sourceRef = positional[0] ?? UNDEFINED_REFERENCE;
-  let pathRef = positional[1] ?? UNDEFINED_REFERENCE;
-  return createComputeRef(() => {
-    let source = valueForRef(sourceRef);
-    if (isDict(source)) {
-      return getPath(source, String(valueForRef(pathRef)));
-    }
-  }, value => {
-    let source = valueForRef(sourceRef);
-    if (isDict(source)) {
-      return setPath(source, String(valueForRef(pathRef)), value);
-    }
-  }, 'get');
-});
-
-export { concat as c, get as g };