ember-source 5.6.0-alpha.6 → 5.6.0-beta.2

package/types/stable/@ember/-internals/glimmer/lib/helpers/page-title.d.ts

@@ -1 +1,20 @@
-declare module '@ember/-internals/glimmer/lib/helpers/page-title' {}
+declare module '@ember/-internals/glimmer/lib/helpers/page-title' {
+  /**
+    @module ember
+    */
+  /**
+      `page-title` allows you to set the title of any page in your application and
+      append additional titles for each route. For complete documentation, see
+      https://github.com/ember-cli/ember-page-title.
+
+      ```handlebars
+      {{page-title "My Page Title" }}
+      ```
+
+      @method page-title
+      @for Ember.Templates.helpers
+      @param {String} param
+      @public
+    */
+  export {};
+}

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

@@ -1 +1,95 @@
-declare module '@ember/-internals/glimmer/lib/modifiers/on' {}
+declare module '@ember/-internals/glimmer/lib/modifiers/on' {
+  /**
+    @module ember
+    */
+  /**
+      The `{{on}}` modifier lets you easily add event listeners (it uses
+      [EventTarget.addEventListener](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)
+      internally).
+
+      For example, if you'd like to run a function on your component when a `<button>`
+      in the components template is clicked you might do something like:
+
+      ```app/components/like-post.hbs
+      <button {{on 'click' this.saveLike}}>Like this post!</button>
+      ```
+
+      ```app/components/like-post.js
+      import Component from '@glimmer/component';
+      import { action } from '@ember/object';
+
+      export default class LikePostComponent extends Component {
+        @action
+        saveLike() {
+          // someone likes your post!
+          // better send a request off to your server...
+        }
+      }
+      ```
+
+      ### Arguments
+
+      `{{on}}` accepts two positional arguments, and a few named arguments.
+
+      The positional arguments are:
+
+      - `event` -- the name to use when calling `addEventListener`
+      - `callback` -- the function to be passed to `addEventListener`
+
+      The named arguments are:
+
+      - capture -- a `true` value indicates that events of this type will be dispatched
+        to the registered listener before being dispatched to any EventTarget beneath it
+        in the DOM tree.
+      - once -- indicates that the listener should be invoked at most once after being
+        added. If true, the listener would be automatically removed when invoked.
+      - passive -- if `true`, indicates that the function specified by listener will never
+        call preventDefault(). If a passive listener does call preventDefault(), the user
+        agent will do nothing other than generate a console warning. See
+        [Improving scrolling performance with passive listeners](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#Improving_scrolling_performance_with_passive_listeners)
+        to learn more.
+
+      The callback function passed to `{{on}}` will receive any arguments that are passed
+      to the event handler. Most commonly this would be the `event` itself.
+
+      If you would like to pass additional arguments to the function you should use
+      the `{{fn}}` helper.
+
+      For example, in our example case above if you'd like to pass in the post that
+      was being liked when the button is clicked you could do something like:
+
+      ```app/components/like-post.hbs
+      <button {{on 'click' (fn this.saveLike @post)}}>Like this post!</button>
+      ```
+
+      In this case, the `saveLike` function will receive two arguments: the click event
+      and the value of `@post`.
+
+      ### Function Context
+
+      In the example above, we used `@action` to ensure that `likePost` is
+      properly bound to the `items-list`, but let's explore what happens if we
+      left out `@action`:
+
+      ```app/components/like-post.js
+      import Component from '@glimmer/component';
+
+      export default class LikePostComponent extends Component {
+        saveLike() {
+          // ...snip...
+        }
+      }
+      ```
+
+      In this example, when the button is clicked `saveLike` will be invoked,
+      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 `@action` or other means) before passing into `on`!
+
+      @method on
+      @for Ember.Templates.helpers
+      @public
+      @since 3.11.0
+    */
+  export {};
+}

package/types/stable/@ember/-internals/glimmer/lib/syntax/in-element.d.ts

@@ -1 +1,47 @@
-declare module '@ember/-internals/glimmer/lib/syntax/in-element' {}
+declare module '@ember/-internals/glimmer/lib/syntax/in-element' {
+  /**
+     @module ember
+     */
+  /**
+     The `in-element` helper renders its block content outside of the regular flow,
+     into a DOM element given by its `destinationElement` positional argument.
+
+     Common use cases - often referred to as "portals" or "wormholes" - are rendering
+     dropdowns, modals or tooltips close to the root of the page to bypass CSS overflow
+     rules, or to render content to parts of the page that are outside of the control
+     of the Ember app itself (e.g. embedded into a static or server rendered HTML page).
+
+     ```handlebars
+     {{#in-element this.destinationElement}}
+       <div>Some content</div>
+     {{/in-element}}
+     ```
+
+     ### Arguments
+
+     `{{in-element}}` requires a single positional argument:
+
+     - `destinationElement` -- the DOM element to render into. It must exist at the time
+     of rendering.
+
+     It also supports an optional named argument:
+
+     - `insertBefore` -- by default the DOM element's content is replaced when used as
+     `destinationElement`. Passing `null` to `insertBefore` changes the behaviour to
+     append the block content to the end of any existing content. Any other value than
+     `null` is currently not supported.
+
+         For example:
+
+         ```handlebars
+         {{#in-element this.destinationElement insertBefore=null}}
+           <div>Some content</div>
+         {{/in-element}}
+         ```
+
+     @method in-element
+     @for Ember.Templates.helpers
+     @public
+     */
+  export {};
+}

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

@@ -1 +1,55 @@
-declare module '@ember/-internals/glimmer/lib/syntax/let' {}
+declare module '@ember/-internals/glimmer/lib/syntax/let' {
+  /**
+    @module ember
+    */
+  /**
+        The `let` helper receives one or more positional arguments and yields
+        them out as block params.
+
+        This allows the developer to introduce shorter names for certain computations
+        in the template.
+
+        This is especially useful if you are passing properties to a component
+        that receives a lot of options and you want to clean up the invocation.
+
+        For the following example, the template receives a `post` object with
+        `content` and `title` properties.
+
+        We are going to call the `my-post` component, passing a title which is
+        the title of the post suffixed with the name of the blog, the content
+        of the post, and a series of options defined in-place.
+
+        ```handlebars
+        {{#let
+            (concat post.title ' | The Ember.js Blog')
+            post.content
+            (hash
+              theme="high-contrast"
+              enableComments=true
+            )
+            as |title content options|
+        }}
+          <MyPost @title={{title}} @content={{content}} @options={{options}} />
+        {{/let}}
+      ```
+     or
+      ```handlebars
+        {{#let
+            (concat post.title ' | The Ember.js Blog')
+            post.content
+            (hash
+              theme="high-contrast"
+              enableComments=true
+            )
+            as |title content options|
+        }}
+          {{my-post title=title content=content options=options}}
+        {{/let}}
+      ```
+
+      @method let
+      @for Ember.Templates.helpers
+      @public
+    */
+  export {};
+}

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

@@ -1,5 +1,4 @@
 declare module '@ember/-internals/glimmer/lib/templates/empty' {
-  import type { TemplateFactory } from '@glimmer/interfaces';
-  const TEMPLATE: TemplateFactory;
-  export default TEMPLATE;
+  const _default: import('@glimmer/interfaces').TemplateFactory;
+  export default _default;
 }

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

@@ -1,5 +1,4 @@
 declare module '@ember/-internals/glimmer/lib/templates/input' {
-  import type { TemplateFactory } from '@glimmer/interfaces';
-  const TEMPLATE: TemplateFactory;
-  export default TEMPLATE;
+  const _default: import('@glimmer/interfaces').TemplateFactory;
+  export default _default;
 }

package/types/stable/@ember/-internals/glimmer/lib/templates/link-to.d.ts

@@ -1,5 +1,4 @@
 declare module '@ember/-internals/glimmer/lib/templates/link-to' {
-  import type { TemplateFactory } from '@glimmer/interfaces';
-  const TEMPLATE: TemplateFactory;
-  export default TEMPLATE;
+  const _default: import('@glimmer/interfaces').TemplateFactory;
+  export default _default;
 }

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

@@ -1,5 +1,4 @@
 declare module '@ember/-internals/glimmer/lib/templates/outlet' {
-  import type { TemplateFactory } from '@glimmer/interfaces';
-  const TEMPLATE: TemplateFactory;
-  export default TEMPLATE;
+  const _default: import('@glimmer/interfaces').TemplateFactory;
+  export default _default;
 }

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

@@ -1,5 +1,4 @@
 declare module '@ember/-internals/glimmer/lib/templates/root' {
-  import type { TemplateFactory } from '@glimmer/interfaces';
-  const TEMPLATE: TemplateFactory;
-  export default TEMPLATE;
+  const _default: import('@glimmer/interfaces').TemplateFactory;
+  export default _default;
 }

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

@@ -1,5 +1,4 @@
 declare module '@ember/-internals/glimmer/lib/templates/textarea' {
-  import type { TemplateFactory } from '@glimmer/interfaces';
-  const TEMPLATE: TemplateFactory;
-  export default TEMPLATE;
+  const _default: import('@glimmer/interfaces').TemplateFactory;
+  export default _default;
 }

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

@@ -3,7 +3,7 @@ declare module '@ember/-internals/meta' {
     counters,
     Meta,
     meta,
-    MetaCounters,
+    type MetaCounters,
     peekMeta,
     setMeta,
     UNDEFINED,

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

@@ -4,11 +4,11 @@ declare module '@ember/-internals/metal' {
     autoComputed,
     isComputed,
     ComputedProperty,
-    ComputedDecorator,
-    ComputedPropertyGetter,
-    ComputedPropertyObj,
-    ComputedPropertySetter,
-    ComputedPropertyCallback,
+    type ComputedDecorator,
+    type ComputedPropertyGetter,
+    type ComputedPropertyObj,
+    type ComputedPropertySetter,
+    type ComputedPropertyCallback,
   } from '@ember/-internals/metal/lib/computed';
   export { getCachedValueFor } from '@ember/-internals/metal/lib/computed_cache';
   export { default as alias } from '@ember/-internals/metal/lib/alias';
@@ -18,7 +18,7 @@ declare module '@ember/-internals/metal' {
     _getPath,
     get,
     _getProp,
-    HasUnknownProperty,
+    type HasUnknownProperty,
     hasUnknownProperty,
   } from '@ember/-internals/metal/lib/property_get';
   export { set, _setProp, trySet } from '@ember/-internals/metal/lib/property_set';
@@ -49,7 +49,7 @@ declare module '@ember/-internals/metal' {
     changeProperties,
     endPropertyChanges,
     notifyPropertyChange,
-    PropertyDidChange,
+    type PropertyDidChange,
     PROPERTY_DID_CHANGE,
   } from '@ember/-internals/metal/lib/property_events';
   export {
@@ -58,10 +58,10 @@ declare module '@ember/-internals/metal' {
     defineValue,
   } from '@ember/-internals/metal/lib/properties';
   export {
-    ExtendedMethodDecorator,
-    DecoratorPropertyDescriptor,
+    type ExtendedMethodDecorator,
+    type DecoratorPropertyDescriptor,
     ComputedDescriptor,
-    ElementDescriptor,
+    type ElementDescriptor,
     isElementDescriptor,
     nativeDescDecorator,
     descriptorForDecorator,

package/types/stable/@ember/-internals/metal/lib/dependent_keys.d.ts

@@ -1 +1,3 @@
-declare module '@ember/-internals/metal/lib/dependent_keys' {}
+declare module '@ember/-internals/metal/lib/dependent_keys' {
+  export {};
+}

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

@@ -4,7 +4,7 @@ declare module '@ember/debug' {
   export { registerHandler as registerWarnHandler } from '@ember/debug/lib/warn';
   export {
     registerHandler as registerDeprecationHandler,
-    DeprecationOptions,
+    type DeprecationOptions,
   } from '@ember/debug/lib/deprecate';
   export { default as inspect } from '@ember/debug/lib/inspect';
   export { isTesting, setTesting } from '@ember/debug/lib/testing';

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

@@ -30,7 +30,7 @@ declare module '@ember/owner' {
       @module @ember/owner
       @public
     */
-  import Owner from '@ember/-internals/owner';
+  import { type default as Owner } from '@ember/-internals/owner';
   /**
       Framework objects in an Ember application (components, services, routes, etc.)
       are created via a factory and dependency injection system. Each of these
@@ -75,15 +75,15 @@ declare module '@ember/owner' {
     */
   const getOwner: (object: object) => Owner | undefined;
   export { getOwner };
-  export default Owner;
+  export type { Owner as default };
   export {
     setOwner,
-    FullName,
-    RegisterOptions,
-    Factory,
-    FactoryManager,
-    KnownForTypeResult,
-    Resolver,
-    DIRegistry,
+    type FullName,
+    type RegisterOptions,
+    type Factory,
+    type FactoryManager,
+    type KnownForTypeResult,
+    type Resolver,
+    type DIRegistry,
   } from '@ember/-internals/owner';
 }

package/types/stable/@ember/routing/-internals.d.ts

@@ -1,14 +1,14 @@
 declare module '@ember/routing/-internals' {
   export { default as RouterState } from '@ember/routing/lib/router_state';
   export { default as RoutingService } from '@ember/routing/lib/routing-service';
-  export { RouteArgs, prefixRouteNameArg } from '@ember/routing/lib/utils';
+  export { type RouteArgs, prefixRouteNameArg } from '@ember/routing/lib/utils';
   export {
     default as generateController,
     generateControllerFactory,
   } from '@ember/routing/lib/generate_controller';
   export { default as BucketCache } from '@ember/routing/lib/cache';
-  export { default as DSL, DSLCallback } from '@ember/routing/lib/dsl';
-  export { EngineRouteInfo } from '@ember/routing/lib/engines';
-  export { RouteInfo, RouteInfoWithAttributes } from '@ember/routing/lib/route-info';
+  export { default as DSL, type DSLCallback } from '@ember/routing/lib/dsl';
+  export type { EngineRouteInfo } from '@ember/routing/lib/engines';
+  export type { RouteInfo, RouteInfoWithAttributes } from '@ember/routing/lib/route-info';
   export { default as controllerFor } from '@ember/routing/lib/controller_for';
 }

package/types/stable/@ember/routing/lib/route-info.d.ts

@@ -1,3 +1,3 @@
 declare module '@ember/routing/lib/route-info' {
-  export { RouteInfo, RouteInfoWithAttributes } from 'router_js';
+  export type { RouteInfo, RouteInfoWithAttributes } from 'router_js';
 }

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

@@ -4,7 +4,7 @@ declare module '@ember/routing/router-service' {
   import type { ModelFor, Transition } from 'router_js';
   import type Route from '@ember/routing/route';
   import EmberRouter from '@ember/routing/router';
-  import { RouteInfo, RouteInfoWithAttributes } from '@ember/routing/-internals';
+  import type { RouteInfo, RouteInfoWithAttributes } from '@ember/routing/-internals';
   import type { RouteArgs, RouteOptions } from '@ember/routing/lib/utils';
   export const ROUTER: unique symbol;
   /**
@@ -594,5 +594,5 @@ declare module '@ember/routing/router-service' {
         */
     readonly currentRoute: this['_router']['currentRoute'];
   }
-  export { RouterService as default, RouteInfo, RouteInfoWithAttributes };
+  export { RouterService as default, type RouteInfo, type RouteInfoWithAttributes };
 }

package/types/stable/@ember/runloop/-private/backburner.d.ts

@@ -2,6 +2,6 @@ declare module '@ember/runloop/-private/backburner' {
   import type Backburner from 'backburner.js';
   export type { Backburner };
   export type DebugInfo = ReturnType<Backburner['getDebugInfo']>;
-  export { IQueueItem as QueueItem } from 'backburner.js/dist/backburner/interfaces';
-  export { DeferredActionQueues } from 'backburner.js';
+  export type { IQueueItem as QueueItem } from 'backburner.js/dist/backburner/interfaces';
+  export type { DeferredActionQueues } from 'backburner.js';
 }

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

@@ -1,7 +1,7 @@
 declare module '@ember/runloop' {
-  import Backburner, { Timer, type DeferredActionQueues } from 'backburner.js';
+  import Backburner, { type Timer, type DeferredActionQueues } from 'backburner.js';
   import type { AnyFn } from '@ember/-internals/utility-types';
-  export { Timer };
+  export type { Timer };
   type PartialParams<P extends any[]> = P extends [infer First, ...infer Rest]
     ? [] | [First] | [First, ...PartialParams<Rest>]
     : Required<P> extends [infer First, ...infer Rest]

package/types/stable/@ember/template-compilation/index.d.ts

@@ -1,19 +1,15 @@
 declare module '@ember/template-compilation' {
   import type { TemplateFactory } from '@glimmer/interfaces';
   import type * as ETC from 'ember-template-compiler';
-  interface CommonOptions {
-    moduleName?: string;
-  }
-  interface LooseModeOptions extends CommonOptions {
-    strictMode?: false;
-  }
-  interface StrictModeOptions extends CommonOptions {
-    strictMode: true;
-    scope: () => Record<string, unknown>;
-  }
   interface PrecompileTemplate {
-    (templateString: string, options?: LooseModeOptions): TemplateFactory;
-    (templateString: string, options: StrictModeOptions): TemplateFactory;
+    (
+      templateString: string,
+      options?: {
+        strictMode?: boolean;
+        scope?: () => Record<string, unknown>;
+        moduleName?: string;
+      }
+    ): TemplateFactory;
   }
   export let __emberTemplateCompiler: undefined | typeof ETC;
   export const compileTemplate: typeof ETC.compile;

package/types/stable/@ember/test/adapter.d.ts

@@ -1,4 +1,3 @@
 declare module '@ember/test/adapter' {
-  import { Adapter } from 'ember-testing';
-  export default Adapter;
+  export { Adapter as default } from 'ember-testing';
 }

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

@@ -6,5 +6,5 @@ declare module '@ember/test' {
   export let unregisterHelper: (typeof EmberTesting.Test)['unregisterHelper'];
   export let unregisterWaiter: (typeof EmberTesting.Test)['unregisterWaiter'];
   export let _impl: typeof EmberTesting | undefined;
-  export function registerTestImplementaiton(impl: typeof EmberTesting): void;
+  export function registerTestImplementation(impl: typeof EmberTesting): void;
 }

package/types/stable/ember/version.d.ts

@@ -1,4 +1,4 @@
 declare module 'ember/version' {
-  const VERSION: string;
-  export default VERSION;
+  const _default: string;
+  export default _default;
 }

package/types/stable/ember-template-compiler/lib/public-api.d.ts

@@ -13,7 +13,7 @@ declare module 'ember-template-compiler/lib/public-api' {
     RESOLUTION_MODE_TRANSFORMS,
     STRICT_MODE_TRANSFORMS,
   } from 'ember-template-compiler/lib/plugins';
-  export { EmberPrecompileOptions } from 'ember-template-compiler/lib/types';
+  export type { EmberPrecompileOptions } from 'ember-template-compiler/lib/types';
   export { preprocess as _preprocess, print as _print } from '@glimmer/syntax';
   export { precompile as _precompile } from '@glimmer/compiler';
   export { _GlimmerSyntax, VERSION };

package/types/stable/ember-template-compiler/minimal.d.ts

@@ -0,0 +1,5 @@
+declare module 'ember-template-compiler/minimal' {
+  export { default as precompile } from 'ember-template-compiler/lib/system/precompile';
+  export { buildCompileOptions as _buildCompileOptions } from 'ember-template-compiler/lib/system/compile-options';
+  export { preprocess as _preprocess, print as _print } from '@glimmer/syntax';
+}

package/types/stable/index.d.ts

@@ -313,6 +313,7 @@
 /// <reference path="./ember-template-compiler/lib/system/initializer.d.ts" />
 /// <reference path="./ember-template-compiler/lib/system/precompile.d.ts" />
 /// <reference path="./ember-template-compiler/lib/types.d.ts" />
+/// <reference path="./ember-template-compiler/minimal.d.ts" />
 /// <reference path="./ember-testing/index.d.ts" />
 /// <reference path="./ember-testing/lib/adapters/adapter.d.ts" />
 /// <reference path="./ember-testing/lib/adapters/qunit.d.ts" />