@angular/core 16.2.2 → 17.0.0-next.1

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v16.2.2
+ * @license Angular v17.0.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -270,7 +270,7 @@ export declare const ANIMATION_MODULE_TYPE: InjectionToken<"NoopAnimations" | "B
  *
  * @publicApi
  */
-export declare const APP_BOOTSTRAP_LISTENER: InjectionToken<((compRef: ComponentRef<any>) => void)[]>;
+export declare const APP_BOOTSTRAP_LISTENER: InjectionToken<readonly ((compRef: ComponentRef<any>) => void)[]>;
 
 /**
  * A [DI token](guide/glossary#di-token "DI token definition") representing a string ID, used
@@ -1738,8 +1738,6 @@ export declare interface ContentChildDecorator {
      * If the content DOM changes, and a new child matches the selector,
      * the property will be updated.
      *
-     * Content queries are set before the `ngAfterContentInit` callback is called.
-     *
      * Does not retrieve elements or directives that are in other components' templates,
      * since a component's template is always a black box to its ancestors.
      *
@@ -1770,6 +1768,17 @@ export declare interface ContentChildDecorator {
      *   * Any provider defined through a string token (e.g. `{provide: 'token', useValue: 'val'}`)
      *   * `TemplateRef`, `ElementRef`, and `ViewContainerRef`
      *
+     * Difference between dynamic and static queries:
+     *
+     * | Queries                             | Details |
+     * |:---                                 |:---     |
+     * | Dynamic queries \(`static: false`\) | The query resolves before the `ngAfterContentInit()`
+     * callback is called. The result will be updated for changes to your view, such as changes to
+     * `ngIf` and `ngFor` blocks. | | Static queries \(`static: true`\)   | The query resolves once
+     * the view has been created, but before change detection runs (before the `ngOnInit()` callback
+     * is called). The result, though, will never be updated to reflect changes to your view, such as
+     * changes to `ngIf` and `ngFor` blocks.  |
+     *
      * @usageNotes
      *
      * {@example core/di/ts/contentChild/content_child_howto.ts region='HowTo'}
@@ -4053,6 +4062,7 @@ declare namespace i0 {
         ɵɵInjectorDeclaration,
         ɵɵNgModuleDeclaration,
         ɵsetClassMetadata as setClassMetadata,
+        ɵsetClassMetadataAsync as setClassMetadataAsync,
         ɵNgModuleFactory as NgModuleFactory,
         ɵnoSideEffects,
         ITS_JUST_ANGULAR
@@ -6058,18 +6068,26 @@ export declare abstract class NgModuleRef<T> {
 }
 
 /**
- * NgModule scope info as provided by NgModule decorator.
+ * NgModule scope info as provided by AoT compiler
+ *
+ * In full compilation Ivy resolved all the "module with providers" and forward refs the whole array
+ * if at least one element is forward refed. So we end up with type `Type<any>[]|(() =>
+ * Type<any>[])`.
+ *
+ * In local mode the compiler passes the raw info as they are to the runtime functions as it is not
+ * possible to resolve them any further due to limited info at compile time. So we end up with type
+ * `RawScopeInfoFromDecorator[]`.
  */
 declare interface NgModuleScopeInfoFromDecorator {
     /** List of components, directives, and pipes declared by this module. */
-    declarations?: Type<any>[] | (() => Type<any>[]);
-    /** List of modules or `ModuleWithProviders` imported by this module. */
-    imports?: Type<any>[] | (() => Type<any>[]);
+    declarations?: Type<any>[] | (() => Type<any>[]) | RawScopeInfoFromDecorator[];
+    /** List of modules or `ModuleWithProviders` or standalone components imported by this module. */
+    imports?: Type<any>[] | (() => Type<any>[]) | RawScopeInfoFromDecorator[];
     /**
      * List of modules, `ModuleWithProviders`, components, directives, or pipes exported by this
      * module.
      */
-    exports?: Type<any>[] | (() => Type<any>[]);
+    exports?: Type<any>[] | (() => Type<any>[]) | RawScopeInfoFromDecorator[];
 }
 
 /**
@@ -6640,7 +6658,7 @@ export declare const PLATFORM_ID: InjectionToken<Object>;
  * A function that is executed when a platform is initialized.
  * @publicApi
  */
-export declare const PLATFORM_INITIALIZER: InjectionToken<(() => void)[]>;
+export declare const PLATFORM_INITIALIZER: InjectionToken<readonly (() => void)[]>;
 
 /**
  * This platform has to be included in any other platform
@@ -7202,6 +7220,13 @@ declare class R3Injector extends EnvironmentInjector {
     private removeOnDestroy;
 }
 
+/**
+ * The array element type passed to:
+ *  - NgModule's annotation imports/exports/declarations fields
+ *  - standalone component annotation imports field
+ */
+declare type RawScopeInfoFromDecorator = Type<any> | ModuleWithProviders<any> | (() => Type<any>) | (() => ModuleWithProviders<any>);
+
 declare interface RComment extends RNode {
     textContent: string | null;
 }
@@ -9965,14 +9990,12 @@ export declare interface ViewChildDecorator {
      * in the view DOM. If the view DOM changes, and a new child matches the selector,
      * the property is updated.
      *
-     * View queries are set before the `ngAfterViewInit` callback is called.
-     *
      * **Metadata Properties**:
      *
      * * **selector** - The directive type or the name used for querying.
      * * **read** - Used to read a different token from the queried elements.
-     * * **static** - True to resolve query results before change detection runs,
-     * false to resolve after change detection. Defaults to false.
+     * * **static** - `true` to resolve query results before change detection runs,
+     * `false` to resolve after change detection. Defaults to `false`.
      *
      *
      * The following selectors are supported.
@@ -9993,6 +10016,17 @@ export declare interface ViewChildDecorator {
      *   * Any provider defined through a string token (e.g. `{provide: 'token', useValue: 'val'}`)
      *   * `TemplateRef`, `ElementRef`, and `ViewContainerRef`
      *
+     * Difference between dynamic and static queries**:
+     *
+     * | Queries                             | Details |
+     * |:---                                 |:---     |
+     * | Dynamic queries \(`static: false`\) | The query resolves before the `ngAfterViewInit()`
+     * callback is called. The result will be updated for changes to your view, such as changes to
+     * `ngIf` and `ngFor` blocks. | | Static queries \(`static: true`\)   | The query resolves once
+     * the view has been created, but before change detection runs (before the `ngOnInit()` callback
+     * is called). The result, though, will never be updated to reflect changes to your view, such as
+     * changes to `ngIf` and `ngFor` blocks. |
+     *
      * @usageNotes
      *
      * {@example core/di/ts/viewChild/view_child_example.ts region='Component'}
@@ -11828,6 +11862,16 @@ export declare function ɵsetClassMetadata(type: Type<any>, decorators: any[] |
     [field: string]: any;
 } | null): void;
 
+/**
+ * Handles the process of applying metadata info to a component class in case
+ * component template had `{#defer}` blocks (thus some dependencies became deferrable).
+ *
+ * @param type Component class where metadata should be added
+ * @param dependencyLoaderFn Function that loads dependencies
+ * @param metadataSetterFn Function that forms a scope in which the `setClassMetadata` is invoked
+ */
+export declare function ɵsetClassMetadataAsync(type: Type<any>, dependencyLoaderFn: () => Array<Promise<Type<unknown>>>, metadataSetterFn: (...types: Type<unknown>[]) => void): Promise<Array<Type<unknown>>>;
+
 export declare function ɵsetCurrentInjector(injector: Injector | null | undefined): Injector | undefined | null;
 
 
@@ -12799,6 +12843,20 @@ export declare type ɵɵComponentDeclaration<T, Selector extends String, ExportA
     [key: string]: string;
 }, QueryFields extends string[], NgContentSelectors extends string[], IsStandalone extends boolean = false, HostDirectives = never, IsSignal extends boolean = false> = unknown;
 
+
+/**
+ * The conditional instruction represents the basic building block on the runtime side to support
+ * built-in "if" and "switch". On the high level this instruction is responsible for adding and
+ * removing views selected by a conditional expression.
+ *
+ * @param containerIndex index of a container in a host view (indexed from HEADER_OFFSET) where
+ *     conditional views should be inserted.
+ * @param matchingTemplateIndex index of a template TNode representing a conditional view to be
+ *     inserted; -1 represents a special case when there is no view to insert.
+ * @codeGenApi
+ */
+export declare function ɵɵconditional<T>(containerIndex: number, matchingTemplateIndex: number, value?: T): void;
+
 /**
  * Registers a QueryList, associated with a content query, for later refresh (part of a view
  * refresh).
@@ -12834,12 +12892,110 @@ export declare function ɵɵCopyDefinitionFeature(definition: ɵDirectiveDef<any
 /**
  * Creates runtime data structures for `{#defer}` blocks.
  *
- * @param index The index of the defer block in the data array
+ * @param deferIndex Index of the underlying deferred block data structure.
+ * @param primaryTemplateIndex Index of the template function with the block's content.
  * @param deferredDepsFn Function that contains dependencies for this defer block
+ * @param loadingIndex Index of the template with the `{:loading}` block content.
+ * @param placeholderIndex Index of the template with the `{:placeholder}` block content.
+ * @param error Index of the template with the `{:error}` block content.
+ * @param loadingConfigIndex Index in the constants array of the configuration of the `{:loading}`
+ *     block.
+ * @param placeholderConfigIndexIndex in the constants array of the configuration of the
+ *     `{:placeholder}` block.
  *
  * @codeGenApi
  */
-export declare function ɵɵdefer(index: number, deferredDepsFn: DeferredDepsFn | null): void;
+export declare function ɵɵdefer(deferIndex: number, primaryTemplateIndex: number, deferredDepsFn?: DeferredDepsFn | null, loadingIndex?: number | null, placeholderIndex?: number | null, errorIndex?: number | null, loadingConfigIndex?: number | null, placeholderConfigIndex?: number | null): void;
+
+/**
+ * Creates runtime data structures for the `on hover` deferred trigger.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferOnHover(): void;
+
+/**
+ * Creates runtime data structures for the `on idle` deferred trigger.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferOnIdle(): void;
+
+/**
+ * Creates runtime data structures for the `on immediate` deferred trigger.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferOnImmediate(): void;
+
+/**
+ * Creates runtime data structures for the `on interaction` deferred trigger.
+ * @param target Optional element on which to listen for hover events.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferOnInteraction(target?: unknown): void;
+
+/**
+ * Creates runtime data structures for the `on timer` deferred trigger.
+ * @param delay Amount of time to wait before loading the content.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferOnTimer(delay: number): void;
+
+/**
+ * Creates runtime data structures for the `on viewport` deferred trigger.
+ * @param target Optional element on which to listen for hover events.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferOnViewport(target?: unknown): void;
+
+/**
+ * Creates runtime data structures for the `prefetech on hover` deferred trigger.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferPrefetchOnHover(): void;
+
+/**
+ * Creates runtime data structures for the `prefetech on idle` deferred trigger.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferPrefetchOnIdle(): void;
+
+/**
+ * Creates runtime data structures for the `prefetech on immediate` deferred trigger.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferPrefetchOnImmediate(): void;
+
+/**
+ * Creates runtime data structures for the `prefetch on interaction` deferred trigger.
+ * @param target Optional element on which to listen for hover events.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferPrefetchOnInteraction(target?: unknown): void;
+
+/**
+ * Creates runtime data structures for the `prefetch on timer` deferred trigger.
+ * @param delay Amount of time to wait before prefetching the content.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferPrefetchOnTimer(delay: number): void;
+
+/**
+ * Creates runtime data structures for the `prefetch on viewport` deferred trigger.
+ * @param target Optional element on which to listen for hover events.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferPrefetchOnViewport(target?: unknown): void;
+
+/**
+ * Prefetches the deferred content when a value becomes truthy.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferPrefetchWhen(value: unknown): void;
+
+/**
+ * Loads the deferred content when a value becomes truthy.
+ * @codeGenApi
+ */
+export declare function ɵɵdeferWhen(value: unknown): void;
 
 /**
  * Create a component definition object.
@@ -13148,6 +13304,8 @@ export declare enum ɵɵFactoryTarget {
     NgModule = 4
 }
 
+export declare function ɵɵgetComponentDepsFactory(type: ɵComponentType<any>, rawImports?: RawScopeInfoFromDecorator[]): () => DependencyTypeList;
+
 /**
  * Returns the current OpaqueViewState instance.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "16.2.2",
+  "version": "17.0.0-next.1",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",

package/rxjs-interop/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v16.2.2
+ * @license Angular v17.0.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */