@angular/common 15.0.0-next.5 → 15.0.0-rc.0

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.0.0-next.5
+ * @license Angular v15.0.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -168,9 +168,44 @@ export declare class CurrencyPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<CurrencyPipe, "currency", true>;
 }
 
+/**
+ * DI token that allows to provide default configuration for the `DatePipe` instances in an
+ * application. The value is an object which can include the following fields:
+ * - `dateFormat`: configures the default date format. If not provided, the `DatePipe`
+ * will use the 'mediumDate' as a value.
+ * - `timezone`: configures the default timezone. If not provided, the `DatePipe` will
+ * use the end-user's local system timezone.
+ *
+ * @see `DatePipeConfig`
+ *
+ * @usageNotes
+ *
+ * Various date pipe default values can be overwritten by providing this token with
+ * the value that has this interface.
+ *
+ * For example:
+ *
+ * Override the default date format by providing a value using the token:
+ * ```typescript
+ * providers: [
+ *   {provide: DATE_PIPE_DEFAULT_OPTIONS, useValue: {dateFormat: 'shortDate'}}
+ * ]
+ * ```
+ *
+ * Override the default timezone by providing a value using the token:
+ * ```typescript
+ * providers: [
+ *   {provide: DATE_PIPE_DEFAULT_OPTIONS, useValue: {timezone: '-1200'}}
+ * ]
+ * ```
+ */
+export declare const DATE_PIPE_DEFAULT_OPTIONS: InjectionToken<DatePipeConfig>;
+
 /**
  * Optionally-provided default timezone to use for all instances of `DatePipe` (such as `'+0430'`).
  * If the value isn't provided, the `DatePipe` will use the end-user's local system timezone.
+ *
+ * @deprecated use DATE_PIPE_DEFAULT_OPTIONS token to configure DatePipe
  */
 export declare const DATE_PIPE_DEFAULT_TIMEZONE: InjectionToken<string>;
 
@@ -334,27 +369,48 @@ export declare const DATE_PIPE_DEFAULT_TIMEZONE: InjectionToken<string>;
 export declare class DatePipe implements PipeTransform {
     private locale;
     private defaultTimezone?;
-    constructor(locale: string, defaultTimezone?: string | null | undefined);
+    private defaultOptions?;
+    constructor(locale: string, defaultTimezone?: string | null | undefined, defaultOptions?: DatePipeConfig | null | undefined);
     /**
      * @param value The date expression: a `Date` object,  a number
      * (milliseconds since UTC epoch), or an ISO string (https://www.w3.org/TR/NOTE-datetime).
      * @param format The date/time components to include, using predefined options or a
-     * custom format string.
+     * custom format string.  When not provided, the `DatePipe` looks for the value using the
+     * `DATE_PIPE_DEFAULT_OPTIONS` injection token (and reads the `dateFormat` property).
+     * If the token is not configured, the `mediumDate` is used as a value.
      * @param timezone A timezone offset (such as `'+0430'`), or a standard UTC/GMT, or continental US
-     * timezone abbreviation. When not supplied, either the value of the `DATE_PIPE_DEFAULT_TIMEZONE`
-     * injection token is used or the end-user's local system timezone.
+     * timezone abbreviation. When not provided, the `DatePipe` looks for the value using the
+     * `DATE_PIPE_DEFAULT_OPTIONS` injection token (and reads the `timezone` property). If the token
+     * is not configured, the end-user's local system timezone is used as a value.
      * @param locale A locale code for the locale format rules to use.
      * When not supplied, uses the value of `LOCALE_ID`, which is `en-US` by default.
      * See [Setting your app locale](guide/i18n-common-locale-id).
+     *
+     * @see `DATE_PIPE_DEFAULT_OPTIONS`
+     *
      * @returns A date string in the desired format.
      */
     transform(value: Date | string | number, format?: string, timezone?: string, locale?: string): string | null;
     transform(value: null | undefined, format?: string, timezone?: string, locale?: string): null;
     transform(value: Date | string | number | null | undefined, format?: string, timezone?: string, locale?: string): string | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DatePipe, [null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DatePipe, [null, { optional: true; }, { optional: true; }]>;
     static ɵpipe: i0.ɵɵPipeDeclaration<DatePipe, "date", true>;
 }
 
+
+/**
+ * An interface that describes the date pipe configuration, which can be provided using the
+ * `DATE_PIPE_DEFAULT_OPTIONS` token.
+ *
+ * @see `DATE_PIPE_DEFAULT_OPTIONS`
+ *
+ * @publicApi
+ */
+export declare interface DatePipeConfig {
+    dateFormat: string;
+    timezone: string;
+}
+
 /**
  * @ngModule CommonModule
  * @description
@@ -955,6 +1011,7 @@ declare namespace i13 {
 declare namespace i14 {
     export {
         DATE_PIPE_DEFAULT_TIMEZONE,
+        DATE_PIPE_DEFAULT_OPTIONS,
         DatePipe
     }
 }
@@ -1101,7 +1158,6 @@ declare namespace i9 {
  * @see `ImageLoader`
  * @see `NgOptimizedImage`
  * @publicApi
- * @developerPreview
  */
 export declare const IMAGE_LOADER: InjectionToken<ImageLoader>;
 
@@ -1110,7 +1166,6 @@ export declare const IMAGE_LOADER: InjectionToken<ImageLoader>;
  * NgOptimizedImage directive to produce full image URL based on the image name and its width.
  *
  * @publicApi
- * @developerPreview
  */
 export declare type ImageLoader = (config: ImageLoaderConfig) => string;
 
@@ -1120,7 +1175,6 @@ export declare type ImageLoader = (config: ImageLoaderConfig) => string;
  * @see `ImageLoader`
  * @see `NgOptimizedImage`
  * @publicApi
- * @developerPreview
  */
 export declare interface ImageLoaderConfig {
     /**
@@ -2018,6 +2072,7 @@ export declare abstract class NgLocalization {
  *
  * In addition, the directive:
  * - Generates appropriate asset URLs if a corresponding `ImageLoader` function is provided
+ * - Automatically generates a srcset
  * - Requires that `width` and `height` are set
  * - Warns if `width` or `height` have been set incorrectly
  * - Warns if the image will be visually distorted when rendered
@@ -2103,13 +2158,15 @@ export declare abstract class NgLocalization {
  * ```
  *
  * @publicApi
- * @developerPreview
  */
 export declare class NgOptimizedImage implements OnInit, OnChanges, OnDestroy {
     private imageLoader;
+    private config;
     private renderer;
     private imgElement;
     private injector;
+    private readonly isServer;
+    private readonly preloadLinkChecker;
     private lcpObserver;
     /**
      * Calculate the rewritten `src` once and store it.
@@ -2118,17 +2175,6 @@ export declare class NgOptimizedImage implements OnInit, OnChanges, OnDestroy {
      * instance that might be already destroyed).
      */
     private _renderedSrc;
-    /**
-     * Previously, the `rawSrc` attribute was used to activate the directive.
-     * The attribute was renamed to `ngSrc` and this input just produces an error,
-     * suggesting to switch to `ngSrc` instead.
-     *
-     * This error should be removed in v15.
-     *
-     * @nodoc
-     * @deprecated Use `ngSrc` instead.
-     */
-    set rawSrc(value: string);
     /**
      * Name of the source image.
      * Image name will be processed by the image loader and the final URL will be applied as the `src`
@@ -2148,13 +2194,21 @@ export declare class NgOptimizedImage implements OnInit, OnChanges, OnDestroy {
      */
     ngSrcset: string;
     /**
-     * The intrinsic width of the image in pixels.
+     * The base `sizes` attribute passed through to the `<img>` element.
+     * Providing sizes causes the image to create an automatic responsive srcset.
+     */
+    sizes?: string;
+    /**
+     * For responsive images: the intrinsic width of the image in pixels.
+     * For fixed size images: the desired rendered width of the image in pixels.
      */
     set width(value: string | number | undefined);
     get width(): number | undefined;
     private _width?;
     /**
-     * The intrinsic height of the image in pixels.
+     * For responsive images: the intrinsic height of the image in pixels.
+     * For fixed size images: the desired rendered height of the image in pixels.* The intrinsic
+     * height of the image in pixels.
      */
     set height(value: string | number | undefined);
     get height(): number | undefined;
@@ -2172,17 +2226,38 @@ export declare class NgOptimizedImage implements OnInit, OnChanges, OnDestroy {
     set priority(value: string | boolean | undefined);
     get priority(): boolean;
     private _priority;
+    /**
+     * Disables automatic srcset generation for this image.
+     */
+    set disableOptimizedSrcset(value: string | boolean | undefined);
+    get disableOptimizedSrcset(): boolean;
+    private _disableOptimizedSrcset;
+    /**
+     * Sets the image to "fill mode", which eliminates the height/width requirement and adds
+     * styles such that the image fills its containing element.
+     *
+     * @developerPreview
+     */
+    set fill(value: string | boolean | undefined);
+    get fill(): boolean;
+    private _fill;
+    /** @nodoc */
     ngOnInit(): void;
     private setHostAttributes;
+    /** @nodoc */
     ngOnChanges(changes: SimpleChanges): void;
     private getLoadingBehavior;
     private getFetchPriority;
     private getRewrittenSrc;
     private getRewrittenSrcset;
+    private getAutomaticSrcset;
+    private getResponsiveSrcset;
+    private getFixedSrcset;
+    /** @nodoc */
     ngOnDestroy(): void;
     private setHostAttribute;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgOptimizedImage, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NgOptimizedImage, "img[ngSrc],img[rawSrc]", never, { "rawSrc": "rawSrc"; "ngSrc": "ngSrc"; "ngSrcset": "ngSrcset"; "width": "width"; "height": "height"; "loading": "loading"; "priority": "priority"; "src": "src"; "srcset": "srcset"; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgOptimizedImage, "img[ngSrc]", never, { "ngSrc": "ngSrc"; "ngSrcset": "ngSrcset"; "sizes": "sizes"; "width": "width"; "height": "height"; "loading": "loading"; "priority": "priority"; "disableOptimizedSrcset": "disableOptimizedSrcset"; "fill": "fill"; "src": "src"; "srcset": "srcset"; }, {}, never, never, true, never>;
 }
 
 /**
@@ -2781,7 +2856,6 @@ export { PopStateEvent_2 as PopStateEvent }
  * ```
  *
  * @publicApi
- * @developerPreview
  */
 export declare const PRECONNECT_CHECK_BLOCKLIST: InjectionToken<(string | string[])[]>;
 
@@ -2795,7 +2869,6 @@ export declare const PRECONNECT_CHECK_BLOCKLIST: InjectionToken<(string | string
  * @returns Provider that provides an ImageLoader function
  *
  * @publicApi
- * @developerPreview
  */
 export declare const provideCloudflareLoader: (path: string) => Provider[];
 
@@ -2810,7 +2883,6 @@ export declare const provideCloudflareLoader: (path: string) => Provider[];
  * @returns Set of providers to configure the Cloudinary loader.
  *
  * @publicApi
- * @developerPreview
  */
 export declare const provideCloudinaryLoader: (path: string) => Provider[];
 
@@ -2824,7 +2896,6 @@ export declare const provideCloudinaryLoader: (path: string) => Provider[];
  * @returns Set of providers to configure the ImageKit loader.
  *
  * @publicApi
- * @developerPreview
  */
 export declare const provideImageKitLoader: (path: string) => Provider[];
 
@@ -2836,7 +2907,6 @@ export declare const provideImageKitLoader: (path: string) => Provider[];
  * @returns Set of providers to configure the Imgix loader.
  *
  * @publicApi
- * @developerPreview
  */
 export declare const provideImgixLoader: (path: string) => Provider[];
 

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@angular/common",
-  "version": "15.0.0-next.5",
+  "version": "15.0.0-rc.0",
   "description": "Angular - commonly needed directives and services",
   "author": "angular",
   "license": "MIT",
   "engines": {
-    "node": "^14.15.0 || >=16.10.0"
+    "node": "^14.20.0 || ^16.13.0 || >=18.10.0"
   },
   "locales": "locales",
   "dependencies": {
@@ -63,7 +63,7 @@
     }
   },
   "peerDependencies": {
-    "@angular/core": "15.0.0-next.5",
+    "@angular/core": "15.0.0-rc.0",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {

package/testing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.0.0-next.5
+ * @license Angular v15.0.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -11,6 +11,7 @@ import { Location as Location_2 } from '@angular/common';
 import { LocationChangeListener } from '@angular/common';
 import { LocationStrategy } from '@angular/common';
 import { PlatformLocation } from '@angular/common';
+import { Provider } from '@angular/core';
 import { SubscriptionLike } from 'rxjs';
 
 /**
@@ -92,6 +93,14 @@ export declare interface MockPlatformLocationConfig {
     appBaseHref?: string;
 }
 
+/**
+ * Returns mock providers for the `Location` and `LocationStrategy` classes.
+ * The mocks are helpful in tests to fire simulated location events.
+ *
+ * @publicApi
+ */
+export declare function provideLocationMocks(): Provider[];
+
 /**
  * A spy for {@link Location} that allows tests to fire simulated location events.
  *

package/upgrade/index.d.ts

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