@angular/core 14.0.0-rc.1 → 14.0.0

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v14.0.0-rc.1
+ * @license Angular v14.0.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -1026,6 +1026,11 @@ export declare interface Component extends Directive {
      * 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
      * used in a template) via the imports property.
+     *
+     * More information about standalone components, directives and pipes can be found in [this
+     * guide](guide/standalone-components).
+     *
+     * @developerPreview
      */
     standalone?: boolean;
     /**
@@ -1035,6 +1040,11 @@ 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
+     * guide](guide/standalone-components).
+     *
+     * @developerPreview
      */
     imports?: (Type<any> | any[])[];
     /**
@@ -1043,6 +1053,9 @@ 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
+     * guide](guide/standalone-components).
      */
     schemas?: SchemaMetadata[];
 }
@@ -1634,6 +1647,7 @@ declare interface CreateComponentOptions {
  * Create a new environment injector.
  *
  * @publicApi
+ * @developerPreview
  */
 export declare function createEnvironmentInjector(providers: Array<Provider | ImportedNgModuleProviders>, parent?: EnvironmentInjector | null, debugName?: string | null): EnvironmentInjector;
 
@@ -2271,6 +2285,11 @@ export declare interface Directive {
      * Angular directives marked as `standalone` do not need to be declared in an NgModule. Such
      * 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
+     * guide](guide/standalone-components).
+     *
+     * @developerPreview
      */
     standalone?: boolean;
 }
@@ -2315,21 +2334,53 @@ export declare interface DirectiveDecorator {
      *
      * ### Declaring directives
      *
-     * Directives are [declarables](guide/glossary#declarable).
-     * They must be declared by an NgModule
-     * in order to be usable in an app.
+     * In order to make a directive available to other components in your application, you should do
+     * one of the following:
+     *  - either mark the directive as [standalone](guide/standalone-components),
+     *  - or declare it in an NgModule by adding it to the `declarations` and `exports` fields.
      *
-     * A directive must belong to exactly one NgModule. Do not re-declare
-     * a directive imported from another module.
-     * List the directive class in the `declarations` field of an NgModule.
+     * ** Marking a directive as standalone **
+     *
+     * You can add the `standalone: true` flag to the Directive decorator metadata to declare it as
+     * [standalone](guide/standalone-components):
      *
      * ```ts
-     * declarations: [
-     *  AppComponent,
-     *  MyDirective
-     * ],
+     * @Directive({
+     *   standalone: true,
+     *   selector: 'my-directive',
+     * })
+     * class MyDirective {}
      * ```
      *
+     * When marking a directive as standalone, please make sure that the directive is not already
+     * declared in an NgModule.
+     *
+     *
+     * ** Declaring a directive in an NgModule **
+     *
+     * Another approach is to declare a directive in an NgModule:
+     *
+     * ```ts
+     * @Directive({
+     *   selector: 'my-directive',
+     * })
+     * class MyDirective {}
+     *
+     * @NgModule({
+     *   declarations: [MyDirective, SomeComponent],
+     *   exports: [MyDirective], // making it available outside of this module
+     * })
+     * class SomeNgModule {}
+     * ```
+     *
+     * When declaring a directive in an NgModule, please make sure that:
+     *  - the directive is declared in exactly one NgModule.
+     *  - the directive is not standalone.
+     *  - you do not re-declare a directive imported from another module.
+     *  - the directive is included into the `exports` field as well if you want this directive to be
+     *    accessible for components outside of the NgModule.
+     *
+     *
      * @Annotation
      */
     (obj?: Directive): TypeDecorator;
@@ -2566,6 +2617,8 @@ export declare const ENVIRONMENT_INITIALIZER: InjectionToken<() => void>;
 /**
  * An `Injector` that's part of the environment injector hierarchy, which exists outside of the
  * component tree.
+ *
+ * @developerPreview
  */
 export declare abstract class EnvironmentInjector implements Injector {
     /**
@@ -3428,6 +3481,7 @@ declare const ID = 20;
  * @see `importProvidersFrom`
  *
  * @publicApi
+ * @developerPreview
  */
 export declare interface ImportedNgModuleProviders {
     ɵproviders: Provider[];
@@ -3441,8 +3495,38 @@ export declare interface ImportedNgModuleProviders {
  * another environment injector (such as a route injector). They should not be used in component
  * providers.
  *
- * @returns The collected providers from the specified list of types.
+ * More information about standalone components can be found in [this
+ * guide](guide/standalone-components).
+ *
+ * @usageNotes
+ * The results of the `importProvidersFrom` call can be used in the `bootstrapApplication` call:
+ *
+ * ```typescript
+ * await bootstrapApplication(RootComponent, {
+ *   providers: [
+ *     importProvidersFrom(NgModuleOne, NgModuleTwo)
+ *   ]
+ * });
+ * ```
+ *
+ * You can also use the `importProvidersFrom` results in the `providers` field of a route, when a
+ * standalone component is used:
+ *
+ * ```typescript
+ * export const ROUTES: Route[] = [
+ *   {
+ *     path: 'foo',
+ *     providers: [
+ *       importProvidersFrom(NgModuleOne, NgModuleTwo)
+ *     ],
+ *     component: YourStandaloneComponent
+ *   }
+ * ];
+ * ```
+ *
+ * @returns Collected providers from the specified list of types.
  * @publicApi
+ * @developerPreview
  */
 export declare function importProvidersFrom(...sources: ImportProvidersSource[]): ImportedNgModuleProviders;
 
@@ -3506,30 +3590,24 @@ export declare interface Inject {
 export declare const Inject: InjectDecorator;
 
 /**
- * Injects a token from the currently active injector.
- *
- * Must be used in the context of a factory function such as one defined for an
- * `InjectionToken`. Throws an error if not called from such a context.
+ * @param token A token that represents a dependency that should be injected.
+ * @returns the injected value if operation is successful, `null` otherwise.
+ * @throws if called outside of a supported context.
  *
- * Within such a factory function, using this function to request injection of a dependency
- * is faster and more type-safe than providing an additional array of dependencies
- * (as has been common with `useFactory` providers).
- *
- * @param token The injection token for the dependency to be injected.
- * @param flags Optional flags that control how injection is executed.
- * The flags correspond to injection strategies that can be specified with
- * parameter decorators `@Host`, `@Self`, `@SkipSef`, and `@Optional`.
- * @returns the injected value if injection is successful, `null` otherwise.
- *
- * @usageNotes
- *
- * ### Example
- *
- * {@example core/di/ts/injector_spec.ts region='ShakableInjectionToken'}
+ * @publicApi
+ */
+export declare function inject<T>(token: ProviderToken<T>): T;
+
+/**
+ * @param token A token that represents a dependency that should be injected.
+ * @param flags Control how injection is executed. The flags correspond to injection strategies that
+ *     can be specified with parameter decorators `@Host`, `@Self`, `@SkipSelf`, and `@Optional`.
+ * @returns the injected value if operation is successful, `null` otherwise.
+ * @throws if called outside of a supported context.
  *
  * @publicApi
  */
-export declare const inject: typeof ɵɵinject;
+export declare function inject<T>(token: ProviderToken<T>, flags?: InjectFlags): T | null;
 
 /**
  * Type of the Injectable metadata.
@@ -3611,7 +3689,7 @@ export declare type InjectableProvider = ValueSansProvider | ExistingSansProvide
  * A `Type` which has a `ɵprov: ɵɵInjectableDeclaration` static field.
  *
  * `InjectableType`s contain their own Dependency Injection metadata and are usable in an
- * `InjectorDef`-based `StaticInjector.
+ * `InjectorDef`-based `StaticInjector`.
  *
  * @publicApi
  */
@@ -5570,6 +5648,9 @@ 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
+     * guide](guide/standalone-components).
      */
     standalone?: boolean;
 }
@@ -6952,7 +7033,7 @@ declare const enum RuntimeErrorCode {
     CYCLIC_DI_DEPENDENCY = -200,
     PROVIDER_NOT_FOUND = -201,
     INVALID_FACTORY_DEPENDENCY = 202,
-    MISSING_INJECTION_CONTEXT = 203,
+    MISSING_INJECTION_CONTEXT = -203,
     INVALID_INJECTION_TOKEN = 204,
     INJECTOR_ALREADY_DESTROYED = 205,
     PROVIDER_IN_WRONG_CONTEXT = 207,
@@ -9693,7 +9774,8 @@ export declare interface ɵComponentDef<T> extends ɵDirectiveDef<T> {
      */
     tView: TView | null;
     /**
-     * A function added by the {@see ɵɵStandaloneFeature} and used by the framework to create standalone injectors.
+     * A function added by the {@link ɵɵStandaloneFeature} and used by the framework to create
+     * standalone injectors.
      */
     getStandaloneInjector: ((parentInjector: EnvironmentInjector) => EnvironmentInjector | null) | null;
     /**
@@ -12565,10 +12647,7 @@ export declare function ɵɵi18nStart(index: number, messageIndex: number, subTe
 export declare function ɵɵInheritDefinitionFeature(definition: ɵDirectiveDef<any> | ɵComponentDef<any>): void;
 
 /**
- * Generated instruction: Injects a token from the currently active injector.
- *
- * Must be used in the context of a factory function such as one defined for an
- * `InjectionToken`. Throws an error if not called from such a context.
+ * Generated instruction: injects a token from the currently active injector.
  *
  * (Additional documentation moved to `inject`, as it is the public API, and an alias for this
  * instruction)
@@ -13752,7 +13831,7 @@ export declare function ɵɵsanitizeUrlOrResourceUrl(unsafeUrl: any, tag: string
  *
  * @codeGenApi
  */
-export declare function ɵɵsetComponentScope(type: ɵComponentType<any>, directives: Type<any>[], pipes: Type<any>[]): void;
+export declare function ɵɵsetComponentScope(type: ɵComponentType<any>, directives: Type<any>[] | (() => Type<any>[]), pipes: Type<any>[] | (() => Type<any>[])): void;
 
 /**
  * Adds the module metadata that is necessary to compute the module's transitive scope to an
@@ -13777,7 +13856,7 @@ export declare function ɵɵsetNgModuleScope(type: any, scope: {
 }): unknown;
 
 /**
- * A feature that acts as a setup code for the {@see StandaloneService}.
+ * A feature that acts as a setup code for the {@link StandaloneService}.
  *
  * The most important responsaibility of this feature is to expose the "getStandaloneInjector"
  * function (an entry points to a standalone injector creation) on a component definition object. We

package/package.json

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

package/testing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v14.0.0-rc.1
+ * @license Angular v14.0.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -187,7 +187,10 @@ export declare function flushMicrotasks(): void;
 export declare const getTestBed: () => TestBed;
 
 /**
- * Allows injecting dependencies in `beforeEach()` and `it()`.
+ * Allows injecting dependencies in `beforeEach()` and `it()`. Note: this function
+ * (imported from the `@angular/core/testing` package) can **only** be used to inject dependencies
+ * in tests. To inject dependencies in your application code, use the [`inject`](api/core/inject)
+ * function from the `@angular/core` package instead.
  *
  * Example:
  *