@angular/common 15.0.0-next.4 → 15.0.0-next.6

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.0.0-next.4
+ * @license Angular v15.0.0-next.6
  * (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
     }
 }
@@ -999,7 +1056,7 @@ export declare class I18nPluralPipe implements PipeTransform {
     /**
      * @param value the number to be formatted
      * @param pluralMap an object that mimics the ICU format, see
-     * http://userguide.icu-project.org/formatparse/messages.
+     * https://unicode-org.github.io/icu/userguide/format_parse/messages/.
      * @param locale a `string` defining the locale to use (uses the current {@link LOCALE_ID} by
      * default).
      */
@@ -2018,6 +2075,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
@@ -2107,9 +2165,12 @@ export declare abstract class NgLocalization {
  */
 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.
@@ -2147,6 +2208,11 @@ export declare class NgOptimizedImage implements OnInit, OnChanges, OnDestroy {
      * ```
      */
     ngSrcset: string;
+    /**
+     * The base `sizes` attribute passed through to the `<img>` element.
+     * Providing sizes causes the image to create an automatic responsive srcset.
+     */
+    sizes?: string;
     /**
      * The intrinsic width of the image in pixels.
      */
@@ -2172,6 +2238,19 @@ 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.
+     */
+    set fill(value: string | boolean | undefined);
+    get fill(): boolean;
+    private _fill;
     ngOnInit(): void;
     private setHostAttributes;
     ngOnChanges(changes: SimpleChanges): void;
@@ -2179,10 +2258,13 @@ export declare class NgOptimizedImage implements OnInit, OnChanges, OnDestroy {
     private getFetchPriority;
     private getRewrittenSrc;
     private getRewrittenSrcset;
+    private getAutomaticSrcset;
+    private getResponsiveSrcset;
+    private getFixedSrcset;
     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],img[rawSrc]", never, { "rawSrc": "rawSrc"; "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>;
 }
 
 /**
@@ -2765,18 +2847,18 @@ declare interface PopStateEvent_2 {
 export { PopStateEvent_2 as PopStateEvent }
 
 /**
- * Multi-provider injection token to configure which origins should be excluded
+ * Injection token to configure which origins should be excluded
  * from the preconnect checks. It can either be a single string or an array of strings
  * to represent a group of origins, for example:
  *
  * ```typescript
- *  {provide: PRECONNECT_CHECK_BLOCKLIST, multi: true, useValue: 'https://your-domain.com'}
+ *  {provide: PRECONNECT_CHECK_BLOCKLIST, useValue: 'https://your-domain.com'}
  * ```
  *
  * or:
  *
  * ```typescript
- *  {provide: PRECONNECT_CHECK_BLOCKLIST, multi: true,
+ *  {provide: PRECONNECT_CHECK_BLOCKLIST,
  *   useValue: ['https://your-domain-1.com', 'https://your-domain-2.com']}
  * ```
  *
@@ -2792,18 +2874,12 @@ export declare const PRECONNECT_CHECK_BLOCKLIST: InjectionToken<(string | string
  * Cloudflare Image Resizing; it will not work with Cloudflare Images or Cloudflare Polish.
  *
  * @param path Your domain name, e.g. https://mysite.com
- * @param options An object with extra configuration:
- * - `ensurePreconnect`: boolean flag indicating whether the NgOptimizedImage directive
- *                       should verify that there is a corresponding `<link rel="preconnect">`
- *                       present in the document's `<head>`.
  * @returns Provider that provides an ImageLoader function
  *
  * @publicApi
  * @developerPreview
  */
-export declare const provideCloudflareLoader: (path: string, options?: {
-    ensurePreconnect?: boolean | undefined;
-}) => Provider[];
+export declare const provideCloudflareLoader: (path: string) => Provider[];
 
 /**
  * Function that generates an ImageLoader for Cloudinary and turns it into an Angular provider.
@@ -2813,18 +2889,12 @@ export declare const provideCloudflareLoader: (path: string, options?: {
  * https://res.cloudinary.com/mysite
  * https://mysite.cloudinary.com
  * https://subdomain.mysite.com
- * @param options An object with extra configuration:
- * - `ensurePreconnect`: boolean flag indicating whether the NgOptimizedImage directive
- *                       should verify that there is a corresponding `<link rel="preconnect">`
- *                       present in the document's `<head>`.
  * @returns Set of providers to configure the Cloudinary loader.
  *
  * @publicApi
  * @developerPreview
  */
-export declare const provideCloudinaryLoader: (path: string, options?: {
-    ensurePreconnect?: boolean | undefined;
-}) => Provider[];
+export declare const provideCloudinaryLoader: (path: string) => Provider[];
 
 /**
  * Function that generates an ImageLoader for ImageKit and turns it into an Angular provider.
@@ -2833,36 +2903,24 @@ export declare const provideCloudinaryLoader: (path: string, options?: {
  * This URL should match one of the following formats:
  * https://ik.imagekit.io/myaccount
  * https://subdomain.mysite.com
- * @param options An object with extra configuration:
- * - `ensurePreconnect`: boolean flag indicating whether the NgOptimizedImage directive
- *                       should verify that there is a corresponding `<link rel="preconnect">`
- *                       present in the document's `<head>`.
  * @returns Set of providers to configure the ImageKit loader.
  *
  * @publicApi
  * @developerPreview
  */
-export declare const provideImageKitLoader: (path: string, options?: {
-    ensurePreconnect?: boolean | undefined;
-}) => Provider[];
+export declare const provideImageKitLoader: (path: string) => Provider[];
 
 /**
  * Function that generates an ImageLoader for Imgix and turns it into an Angular provider.
  *
  * @param path path to the desired Imgix origin,
  * e.g. https://somepath.imgix.net or https://images.mysite.com
- * @param options An object with extra configuration:
- * - `ensurePreconnect`: boolean flag indicating whether the NgOptimizedImage directive
- *                       should verify that there is a corresponding `<link rel="preconnect">`
- *                       present in the document's `<head>`.
  * @returns Set of providers to configure the Imgix loader.
  *
  * @publicApi
  * @developerPreview
  */
-export declare const provideImgixLoader: (path: string, options?: {
-    ensurePreconnect?: boolean | undefined;
-}) => Provider[];
+export declare const provideImgixLoader: (path: string) => Provider[];
 
 
 /**

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@angular/common",
-  "version": "15.0.0-next.4",
+  "version": "15.0.0-next.6",
   "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.4",
+    "@angular/core": "15.0.0-next.6",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {

package/testing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.0.0-next.4
+ * @license Angular v15.0.0-next.6
  * (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,15 @@ 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.
+ *
+ * @developerPreview
+ * @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.4
+ * @license Angular v15.0.0-next.6
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */