@angular/core 12.2.7 → 12.2.11

package/core.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v12.2.7
+ * @license Angular v12.2.11
  * (c) 2010-2021 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -1895,7 +1895,7 @@ declare const DECLARATION_VIEW = 15;
  * CurrencyPipe when there is no currency code passed into it. This is only used by
  * CurrencyPipe and has no relation to locale currency. Defaults to USD if not configured.
  *
- * See the [i18n guide](guide/i18n#setting-up-locale) for more information.
+ * See the [i18n guide](guide/i18n-common-locale-id) for more information.
  *
  * <div class="alert is-helpful">
  *
@@ -3568,11 +3568,11 @@ export declare enum InjectFlags {
  * parameterized type.
  *
  * `InjectionToken` is parameterized on `T` which is the type of object which will be returned by
- * the `Injector`. This provides additional level of type safety.
+ * the `Injector`. This provides an additional level of type safety.
  *
  * ```
  * interface MyInterface {...}
- * var myInterface = injector.get(new InjectionToken<MyInterface>('SomeToken'));
+ * const myInterface = injector.get(new InjectionToken<MyInterface>('SomeToken'));
  * // myInterface is inferred to be MyInterface.
  * ```
  *
@@ -3580,14 +3580,15 @@ export declare enum InjectFlags {
  * (possibly by creating) a default value of the parameterized type `T`. This sets up the
  * `InjectionToken` using this factory as a provider as if it was defined explicitly in the
  * application's root injector. If the factory function, which takes zero arguments, needs to inject
- * dependencies, it can do so using the `inject` function. See below for an example.
+ * dependencies, it can do so using the `inject` function.
+ * 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`.
  *
  * @usageNotes
- * ### Basic Example
+ * ### Basic Examples
  *
  * ### Plain InjectionToken
  *
@@ -3603,6 +3604,12 @@ export declare enum InjectFlags {
 export declare class InjectionToken<T> {
     protected _desc: string;
     readonly ɵprov: unknown;
+    /**
+     * @param _desc   Description for the token,
+     *                used only for debugging purposes,
+     *                it should but does not need to be unique
+     * @param options Options for the token's usage, as described above
+     */
     constructor(_desc: string, options?: {
         providedIn?: Type<any> | 'root' | 'platform' | 'any' | null;
         factory: () => T;
@@ -4187,7 +4194,7 @@ declare interface LContainerDebug {
  * It is used for i18n extraction, by i18n pipes (DatePipe, I18nPluralPipe, CurrencyPipe,
  * DecimalPipe and PercentPipe) and by ICU expressions.
  *
- * See the [i18n guide](guide/i18n#setting-up-locale) for more information.
+ * See the [i18n guide](guide/i18n-common-locale-id) for more information.
  *
  * @usageNotes
  * ### Example
@@ -4462,7 +4469,7 @@ declare const enum LViewFlags {
  * - Warning (default): show a warning in the console and/or shell.
  * - Ignore: do nothing.
  *
- * See the [i18n guide](guide/i18n#missing-translation) for more information.
+ * See the [i18n guide](guide/i18n-common-merge#report-missing-translations) for more information.
  *
  * @usageNotes
  * ### Example
@@ -5916,7 +5923,7 @@ declare interface R3DeclareDirectiveFacade {
 
 declare interface R3DeclareFactoryFacade {
     type: Type_2;
-    deps: R3DeclareDependencyMetadataFacade[] | null;
+    deps: R3DeclareDependencyMetadataFacade[] | 'invalid' | null;
     target: ɵɵFactoryTarget;
 }
 
@@ -8076,7 +8083,7 @@ export declare interface TrackByFunction<T> {
  * Use this token at bootstrap to provide the content of your translation file (`xtb`,
  * `xlf` or `xlf2`) when you want to translate your application in another language.
  *
- * See the [i18n guide](guide/i18n#merge) for more information.
+ * See the [i18n guide](guide/i18n-common-merge) for more information.
  *
  * @usageNotes
  * ### Example
@@ -8102,7 +8109,7 @@ export declare const TRANSLATIONS: InjectionToken<string>;
  * Provide this token at bootstrap to set the format of your {@link TRANSLATIONS}: `xtb`,
  * `xlf` or `xlf2`.
  *
- * See the [i18n guide](guide/i18n#merge) for more information.
+ * See the [i18n guide](guide/i18n-common-merge) for more information.
  *
  * @usageNotes
  * ### Example
@@ -10748,7 +10755,7 @@ export declare const enum ɵExtraLocaleDataIndex {
  *
  * @param locale The locale code.
  * @returns The locale data.
- * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n)
+ * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
  */
 export declare function ɵfindLocaleData(locale: string): any;
 
@@ -10856,7 +10863,7 @@ export declare function ɵgetLocaleCurrencyCode(locale: string): string | null;
  * @param locale A locale code for the locale format rules to use.
  * @returns The plural function for the locale.
  * @see `NgPlural`
- * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n)
+ * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
  */
 export declare function ɵgetLocalePluralCase(locale: string): (value: number) => number;
 
@@ -11446,7 +11453,8 @@ export declare class ɵReflectionCapabilities implements PlatformReflectionCapab
 
 /**
  * Register locale data to be used internally by Angular. See the
- * ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale data.
+ * ["I18n guide"](guide/i18n-common-format-data-locale) to know how to import additional locale
+ * data.
  *
  * The signature `registerLocaleData(data: any, extraData?: any)` is deprecated since v5.1
  */