@angular/core 15.0.0-next.3 → 15.0.0-next.5

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.0.0-next.3
+ * @license Angular v15.0.0-next.5
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -1029,10 +1029,10 @@ export declare interface Component extends Directive {
     preserveWhitespaces?: boolean;
     /**
      * Angular components marked as `standalone` do not need to be declared in an NgModule. Such
-     * components directly manage their own template dependencies (components, directives and pipes
+     * components directly manage their own template dependencies (components, directives, and pipes
      * used in a template) via the imports property.
      *
-     * More information about standalone components, directives and pipes can be found in [this
+     * More information about standalone components, directives, and pipes can be found in [this
      * guide](guide/standalone-components).
      *
      * @developerPreview
@@ -1041,12 +1041,12 @@ export declare interface Component extends Directive {
     /**
      * The imports property specifies the standalone component's template dependencies — those
      * directives, components, and pipes that can be used within its template. Standalone components
-     * can import other standalone components, directives and pipes as well as existing NgModules.
+     * can import other standalone components, directives, and pipes as well as existing NgModules.
      *
      * This property is only available for standalone components - specifying it for components
      * declared in an NgModule generates a compilation error.
      *
-     * More information about standalone components, directives and pipes can be found in [this
+     * More information about standalone components, directives, and pipes can be found in [this
      * guide](guide/standalone-components).
      *
      * @developerPreview
@@ -1059,7 +1059,7 @@ export declare interface Component extends Directive {
      * This property is only available for standalone components - specifying it for components
      * declared in an NgModule generates a compilation error.
      *
-     * More information about standalone components, directives and pipes can be found in [this
+     * More information about standalone components, directives, and pipes can be found in [this
      * guide](guide/standalone-components).
      */
     schemas?: SchemaMetadata[];
@@ -2384,7 +2384,7 @@ export declare interface Directive {
      * directives don't depend on any "intermediate context" of an NgModule (ex. configured
      * providers).
      *
-     * More information about standalone components, directives and pipes can be found in [this
+     * More information about standalone components, directives, and pipes can be found in [this
      * guide](guide/standalone-components).
      *
      * @developerPreview
@@ -2698,6 +2698,10 @@ export declare abstract class EmbeddedViewRef<C> extends ViewRef {
  * does not result in additional changes to any bindings (also known as
  * unidirectional data flow).
  *
+ * Using this method is discouraged as the Angular CLI will set production mode when using the
+ * `optimization` option.
+ * @see {@link cli/build ng build}
+ *
  * @publicApi
  */
 export declare function enableProdMode(): void;
@@ -2722,6 +2726,27 @@ export declare abstract class EnvironmentInjector implements Injector {
      * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
      * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
      */
+    abstract get<T>(token: ProviderToken<T>, notFoundValue: undefined, options: InjectOptions & {
+        optional?: false;
+    }): T;
+    /**
+     * Retrieves an instance from the injector based on the provided token.
+     * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
+     * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
+     */
+    abstract get<T>(token: ProviderToken<T>, notFoundValue: null | undefined, options: InjectOptions): T | null;
+    /**
+     * Retrieves an instance from the injector based on the provided token.
+     * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
+     * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
+     */
+    abstract get<T>(token: ProviderToken<T>, notFoundValue?: T, options?: InjectOptions): T;
+    /**
+     * Retrieves an instance from the injector based on the provided token.
+     * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
+     * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
+     * @deprecated use object-based flags (`InjectOptions`) instead.
+     */
     abstract get<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
     /**
      * @deprecated from v4.0.0 use ProviderToken<T>
@@ -3256,6 +3281,15 @@ export declare interface HostDecorator {
     new (): Host;
 }
 
+/**
+ * Mapping between the public aliases of directive bindings and the underlying inputs/outputs that
+ * they represent. Also serves as an allowlist of the inputs/outputs from the host directive that
+ * the author has decided to expose.
+ */
+declare type HostDirectiveBindingMap = {
+    [publicName: string]: string;
+};
+
 /** Values that can be used to define a host directive through the `HostDirectivesFeature`. */
 declare type HostDirectiveConfig = Type<unknown> | {
     directive: Type<unknown>;
@@ -3268,15 +3302,17 @@ declare interface HostDirectiveDef<T = unknown> {
     /** Class representing the host directive. */
     directive: Type<T>;
     /** Directive inputs that have been exposed. */
-    inputs: {
-        [publicName: string]: string;
-    };
+    inputs: HostDirectiveBindingMap;
     /** Directive outputs that have been exposed. */
-    outputs: {
-        [publicName: string]: string;
-    };
+    outputs: HostDirectiveBindingMap;
 }
 
+/**
+ * Mapping between a directive that was used as a host directive
+ * and the configuration that was used to define it as such.
+ */
+declare type HostDirectiveDefs = Map<ɵDirectiveDef<unknown>, HostDirectiveDef>;
+
 /**
  * Type of the HostListener metadata.
  *
@@ -3781,7 +3817,8 @@ export declare interface Injectable {
     /**
      * Determines which injectors will provide the injectable.
      *
-     * - `Type<any>` - associates the injectable with an `@NgModule` or other `InjectorType`,
+     * - `Type<any>` - associates the injectable with an `@NgModule` or other `InjectorType`. This
+     * option is DEPRECATED.
      * - 'null' : Equivalent to `undefined`. The injectable is not provided in any scope automatically
      * and must be added to a `providers` array of an [@NgModule](api/core/NgModule#providers),
      * [@Component](api/core/Directive#providers) or [@Directive](api/core/Directive#providers).
@@ -3792,7 +3829,7 @@ export declare interface Injectable {
      * - 'platform' : A special singleton platform injector shared by all
      * applications on the page.
      * - 'any' : Provides a unique instance in each lazy loaded module while all eagerly loaded
-     * modules share one instance.
+     * modules share one instance. This option is DEPRECATED.
      *
      */
     providedIn?: Type<any> | 'root' | 'platform' | 'any' | null;
@@ -3937,8 +3974,11 @@ export declare enum InjectFlags {
  * As you can see in the Tree-shakable InjectionToken example below.
  *
  * Additionally, if a `factory` is specified you can also specify the `providedIn` option, which
- * overrides the above behavior and marks the token as belonging to a particular `@NgModule`. As
- * mentioned above, `'root'` is the default value for `providedIn`.
+ * overrides the above behavior and marks the token as belonging to a particular `@NgModule` (note:
+ * this option is now deprecated). As mentioned above, `'root'` is the default value for
+ * `providedIn`.
+ *
+ * The `providedIn: NgModule` and `providedIn: 'any'` options are deprecated.
  *
  * @usageNotes
  * ### Basic Examples
@@ -4033,11 +4073,38 @@ export declare const INJECTOR: InjectionToken<Injector>;
 export declare abstract class Injector {
     static THROW_IF_NOT_FOUND: {};
     static NULL: Injector;
+    /**
+     * Internal note on the `options?: InjectOptions|InjectFlags` override of the `get`
+     * method: consider dropping the `InjectFlags` part in one of the major versions.
+     * It can **not** be done in minor/patch, since it's breaking for custom injectors
+     * that only implement the old `InjectorFlags` interface.
+     */
+    /**
+     * Retrieves an instance from the injector based on the provided token.
+     * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
+     * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
+     */
+    abstract get<T>(token: ProviderToken<T>, notFoundValue: undefined, options: InjectOptions & {
+        optional?: false;
+    }): T;
     /**
      * Retrieves an instance from the injector based on the provided token.
      * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
      * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
      */
+    abstract get<T>(token: ProviderToken<T>, notFoundValue: null | undefined, options: InjectOptions): T | null;
+    /**
+     * Retrieves an instance from the injector based on the provided token.
+     * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
+     * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
+     */
+    abstract get<T>(token: ProviderToken<T>, notFoundValue?: T, options?: InjectOptions | InjectFlags): T;
+    /**
+     * Retrieves an instance from the injector based on the provided token.
+     * @returns The instance from the injector if defined, otherwise the `notFoundValue`.
+     * @throws When the `notFoundValue` is `undefined` or `Injector.THROW_IF_NOT_FOUND`.
+     * @deprecated use object-based flags (`InjectOptions`) instead.
+     */
     abstract get<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
     /**
      * @deprecated from v4.0.0 use ProviderToken<T>
@@ -4188,10 +4255,11 @@ declare interface InternalViewRef extends ViewRef {
 
 
 /**
- * Returns whether Angular is in development mode. After called once,
- * the value is locked and won't change any more.
+ * Returns whether Angular is in development mode.
  *
- * By default, this is true, unless a user calls `enableProdMode` before calling this.
+ * By default, this is true, unless `enableProdMode` is invoked prior to calling this method or the
+ * application is built using the Angular CLI with the `optimization` option.
+ * @see {@link cli/build ng build}
  *
  * @publicApi
  */
@@ -5824,7 +5892,7 @@ export declare interface Pipe {
      * Angular pipes marked as `standalone` do not need to be declared in an NgModule. Such
      * pipes don't depend on any "intermediate context" of an NgModule (ex. configured providers).
      *
-     * More information about standalone components, directives and pipes can be found in [this
+     * More information about standalone components, directives, and pipes can be found in [this
      * guide](guide/standalone-components).
      */
     standalone?: boolean;
@@ -6447,7 +6515,7 @@ declare class R3Injector extends EnvironmentInjector {
     destroy(): void;
     onDestroy(callback: () => void): void;
     runInContext<ReturnT>(fn: () => ReturnT): ReturnT;
-    get<T>(token: ProviderToken<T>, notFoundValue?: any, flags?: InjectFlags): T;
+    get<T>(token: ProviderToken<T>, notFoundValue?: any, flags?: InjectFlags | InjectOptions): T;
     toString(): string;
     private assertNotDestroyed;
     /**
@@ -7262,6 +7330,12 @@ declare const enum RuntimeErrorCode {
     UNKNOWN_ELEMENT = 304,
     TEMPLATE_STRUCTURE_ERROR = 305,
     INVALID_EVENT_BINDING = 306,
+    HOST_DIRECTIVE_UNRESOLVABLE = 307,
+    HOST_DIRECTIVE_NOT_STANDALONE = 308,
+    DUPLICATE_DIRECTITVE = 309,
+    HOST_DIRECTIVE_COMPONENT = 310,
+    HOST_DIRECTIVE_UNDEFINED_BINDING = 311,
+    HOST_DIRECTIVE_CONFLICTING_ALIAS = 312,
     MULTIPLE_PLATFORMS = 400,
     PLATFORM_NOT_FOUND = 401,
     ERROR_HANDLER_NOT_FOUND = 402,
@@ -10018,6 +10092,8 @@ export declare class ɵConsole {
     static ɵprov: i0.ɵɵInjectableDeclaration<ɵConsole>;
 }
 
+export declare function ɵconvertToBitFlags(flags: InjectOptions | InjectFlags | undefined): InjectFlags | undefined;
+
 /**
  * Create a new `Injector` which is configured using a `defType` of `InjectorType<any>`s.
  *
@@ -10183,8 +10259,13 @@ export declare interface ɵDirectiveDef<T> {
     /**
      * Function that will add the host directives to the list of matches during directive matching.
      * Patched onto the definition by the `HostDirectivesFeature`.
+     * @param currentDef Definition that has been matched.
+     * @param matchedDefs List of all matches for a specified node. Will be mutated to include the
+     * host directives.
+     * @param hostDirectiveDefs Mapping of directive definitions to their host directive
+     * configuration. Host directives will be added to the map as they're being matched to the node.
      */
-    findHostDirectiveDefs: ((matches: ɵDirectiveDef<unknown>[], def: ɵDirectiveDef<unknown>, tView: TView, lView: LView, tNode: TElementNode | TContainerNode | TElementContainerNode) => void) | null;
+    findHostDirectiveDefs: ((currentDef: ɵDirectiveDef<unknown>, matchedDefs: ɵDirectiveDef<unknown>[], hostDirectiveDefs: HostDirectiveDefs) => void) | null;
     /** Additional directives to be applied whenever the directive has been matched. */
     hostDirectives: HostDirectiveDef[] | null;
     setInput: (<U extends T>(this: ɵDirectiveDef<U>, instance: U, value: any, publicName: string, privateName: string) => void) | null;
@@ -12631,7 +12712,7 @@ export declare function ɵɵgetCurrentView(): OpaqueViewState;
 export declare function ɵɵgetInheritedFactory<T>(type: Type<any>): (type: Type<T>) => T;
 
 /**
- * This feature add the host directives behavior to a directive definition by patching a
+ * This feature adds the host directives behavior to a directive definition by patching a
  * function onto it. The expectation is that the runtime will invoke the function during
  * directive matching.
  *

package/package.json

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

package/testing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.0.0-next.3
+ * @license Angular v15.0.0-next.5
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -13,6 +13,7 @@ import { Directive } from '@angular/core';
 import { ElementRef } from '@angular/core';
 import { InjectFlags } from '@angular/core';
 import { InjectionToken } from '@angular/core';
+import { InjectOptions } from '@angular/core';
 import { NgModule } from '@angular/core';
 import { NgZone } from '@angular/core';
 import { Pipe } from '@angular/core';
@@ -278,7 +279,14 @@ export declare interface TestBed {
     }): void;
     configureTestingModule(moduleDef: TestModuleMetadata): TestBed;
     compileComponents(): Promise<any>;
+    inject<T>(token: ProviderToken<T>, notFoundValue: undefined, options: InjectOptions & {
+        optional?: false;
+    }): T;
+    inject<T>(token: ProviderToken<T>, notFoundValue: null | undefined, options: InjectOptions): T | null;
+    inject<T>(token: ProviderToken<T>, notFoundValue?: T, options?: InjectOptions): T;
+    /** @deprecated use object-based flags (`InjectOptions`) instead. */
     inject<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
+    /** @deprecated use object-based flags (`InjectOptions`) instead. */
     inject<T>(token: ProviderToken<T>, notFoundValue: null, flags?: InjectFlags): T | null;
     /** @deprecated from v9.0.0 use TestBed.inject */
     get<T>(token: ProviderToken<T>, notFoundValue?: T, flags?: InjectFlags): any;