source: trip-planner-front/node_modules/@angular/common/common.d.ts@ 188ee53

Last change on this file since 188ee53 was 6a3a178, checked in by Ema <ema_spirova@…>, 3 years ago

initial commit

  • Property mode set to 100644
File size: 107.1 KB
Line 
1/**
2 * @license Angular v12.2.9
3 * (c) 2010-2021 Google LLC. https://angular.io/
4 * License: MIT
5 */
6
7import { ChangeDetectorRef } from '@angular/core';
8import { DoCheck } from '@angular/core';
9import { ElementRef } from '@angular/core';
10import { InjectionToken } from '@angular/core';
11import { Injector } from '@angular/core';
12import { IterableDiffers } from '@angular/core';
13import { KeyValueDiffers } from '@angular/core';
14import { NgIterable } from '@angular/core';
15import { NgModuleFactory } from '@angular/core';
16import { Observable } from 'rxjs';
17import { OnChanges } from '@angular/core';
18import { OnDestroy } from '@angular/core';
19import { PipeTransform } from '@angular/core';
20import { Provider } from '@angular/core';
21import { Renderer2 } from '@angular/core';
22import { SimpleChanges } from '@angular/core';
23import { Subscribable } from 'rxjs';
24import { SubscriptionLike } from 'rxjs';
25import { TemplateRef } from '@angular/core';
26import { TrackByFunction } from '@angular/core';
27import { Type } from '@angular/core';
28import { Version } from '@angular/core';
29import { ViewContainerRef } from '@angular/core';
30
31/**
32 * A predefined [DI token](guide/glossary#di-token) for the base href
33 * to be used with the `PathLocationStrategy`.
34 * The base href is the URL prefix that should be preserved when generating
35 * and recognizing URLs.
36 *
37 * @usageNotes
38 *
39 * The following example shows how to use this token to configure the root app injector
40 * with a base href value, so that the DI framework can supply the dependency anywhere in the app.
41 *
42 * ```typescript
43 * import {Component, NgModule} from '@angular/core';
44 * import {APP_BASE_HREF} from '@angular/common';
45 *
46 * @NgModule({
47 * providers: [{provide: APP_BASE_HREF, useValue: '/my/app'}]
48 * })
49 * class AppModule {}
50 * ```
51 *
52 * @publicApi
53 */
54import * as ɵngcc0 from '@angular/core';
55export declare const APP_BASE_HREF: InjectionToken<string>;
56
57/**
58 * @ngModule CommonModule
59 * @description
60 *
61 * Unwraps a value from an asynchronous primitive.
62 *
63 * The `async` pipe subscribes to an `Observable` or `Promise` and returns the latest value it has
64 * emitted. When a new value is emitted, the `async` pipe marks the component to be checked for
65 * changes. When the component gets destroyed, the `async` pipe unsubscribes automatically to avoid
66 * potential memory leaks.
67 *
68 * @usageNotes
69 *
70 * ### Examples
71 *
72 * This example binds a `Promise` to the view. Clicking the `Resolve` button resolves the
73 * promise.
74 *
75 * {@example common/pipes/ts/async_pipe.ts region='AsyncPipePromise'}
76 *
77 * It's also possible to use `async` with Observables. The example below binds the `time` Observable
78 * to the view. The Observable continuously updates the view with the current time.
79 *
80 * {@example common/pipes/ts/async_pipe.ts region='AsyncPipeObservable'}
81 *
82 * @publicApi
83 */
84export declare class AsyncPipe implements OnDestroy, PipeTransform {
85 private _ref;
86 private _latestValue;
87 private _subscription;
88 private _obj;
89 private _strategy;
90 constructor(_ref: ChangeDetectorRef);
91 ngOnDestroy(): void;
92 transform<T>(obj: Observable<T> | Subscribable<T> | Promise<T>): T | null;
93 transform<T>(obj: null | undefined): null;
94 transform<T>(obj: Observable<T> | Subscribable<T> | Promise<T> | null | undefined): T | null;
95 private _subscribe;
96 private _selectStrategy;
97 private _dispose;
98 private _updateLatestValue;
99 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<AsyncPipe, never>;
100 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<AsyncPipe, "async">;
101}
102
103
104/**
105 * Exports all the basic Angular directives and pipes,
106 * such as `NgIf`, `NgForOf`, `DecimalPipe`, and so on.
107 * Re-exported by `BrowserModule`, which is included automatically in the root
108 * `AppModule` when you create a new app with the CLI `new` command.
109 *
110 * * The `providers` options configure the NgModule's injector to provide
111 * localization dependencies to members.
112 * * The `exports` options make the declared directives and pipes available for import
113 * by other NgModules.
114 *
115 * @publicApi
116 */
117export declare class CommonModule {
118 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<CommonModule, never>;
119 static ɵmod: ɵngcc0.ɵɵNgModuleDeclaration<CommonModule, [typeof NgClass, typeof NgComponentOutlet, typeof NgForOf, typeof NgIf, typeof NgTemplateOutlet, typeof NgStyle, typeof NgSwitch, typeof NgSwitchCase, typeof NgSwitchDefault, typeof NgPlural, typeof NgPluralCase, typeof AsyncPipe, typeof UpperCasePipe, typeof LowerCasePipe, typeof JsonPipe, typeof SlicePipe, typeof DecimalPipe, typeof PercentPipe, typeof TitleCasePipe, typeof CurrencyPipe, typeof DatePipe, typeof I18nPluralPipe, typeof I18nSelectPipe, typeof KeyValuePipe], never, [typeof NgClass, typeof NgComponentOutlet, typeof NgForOf, typeof NgIf, typeof NgTemplateOutlet, typeof NgStyle, typeof NgSwitch, typeof NgSwitchCase, typeof NgSwitchDefault, typeof NgPlural, typeof NgPluralCase, typeof AsyncPipe, typeof UpperCasePipe, typeof LowerCasePipe, typeof JsonPipe, typeof SlicePipe, typeof DecimalPipe, typeof PercentPipe, typeof TitleCasePipe, typeof CurrencyPipe, typeof DatePipe, typeof I18nPluralPipe, typeof I18nSelectPipe, typeof KeyValuePipe]>;
120 static ɵinj: ɵngcc0.ɵɵInjectorDeclaration<CommonModule>;
121}
122
123/**
124 * @ngModule CommonModule
125 * @description
126 *
127 * Transforms a number to a currency string, formatted according to locale rules
128 * that determine group sizing and separator, decimal-point character,
129 * and other locale-specific configurations.
130 *
131 * {@a currency-code-deprecation}
132 * <div class="alert is-helpful">
133 *
134 * **Deprecation notice:**
135 *
136 * The default currency code is currently always `USD` but this is deprecated from v9.
137 *
138 * **In v11 the default currency code will be taken from the current locale identified by
139 * the `LOCALE_ID` token. See the [i18n guide](guide/i18n-common-locale-id) for
140 * more information.**
141 *
142 * If you need the previous behavior then set it by creating a `DEFAULT_CURRENCY_CODE` provider in
143 * your application `NgModule`:
144 *
145 * ```ts
146 * {provide: DEFAULT_CURRENCY_CODE, useValue: 'USD'}
147 * ```
148 *
149 * </div>
150 *
151 * @see `getCurrencySymbol()`
152 * @see `formatCurrency()`
153 *
154 * @usageNotes
155 * The following code shows how the pipe transforms numbers
156 * into text strings, according to various format specifications,
157 * where the caller's default locale is `en-US`.
158 *
159 * <code-example path="common/pipes/ts/currency_pipe.ts" region='CurrencyPipe'></code-example>
160 *
161 * @publicApi
162 */
163export declare class CurrencyPipe implements PipeTransform {
164 private _locale;
165 private _defaultCurrencyCode;
166 constructor(_locale: string, _defaultCurrencyCode?: string);
167 transform(value: number | string, currencyCode?: string, display?: 'code' | 'symbol' | 'symbol-narrow' | string | boolean, digitsInfo?: string, locale?: string): string | null;
168 transform(value: null | undefined, currencyCode?: string, display?: 'code' | 'symbol' | 'symbol-narrow' | string | boolean, digitsInfo?: string, locale?: string): null;
169 transform(value: number | string | null | undefined, currencyCode?: string, display?: 'code' | 'symbol' | 'symbol-narrow' | string | boolean, digitsInfo?: string, locale?: string): string | null;
170 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<CurrencyPipe, never>;
171 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<CurrencyPipe, "currency">;
172}
173
174/**
175 * @ngModule CommonModule
176 * @description
177 *
178 * Formats a date value according to locale rules.
179 *
180 * `DatePipe` is executed only when it detects a pure change to the input value.
181 * A pure change is either a change to a primitive input value
182 * (such as `String`, `Number`, `Boolean`, or `Symbol`),
183 * or a changed object reference (such as `Date`, `Array`, `Function`, or `Object`).
184 *
185 * Note that mutating a `Date` object does not cause the pipe to be rendered again.
186 * To ensure that the pipe is executed, you must create a new `Date` object.
187 *
188 * Only the `en-US` locale data comes with Angular. To localize dates
189 * in another language, you must import the corresponding locale data.
190 * See the [I18n guide](guide/i18n-common-format-data-locale) for more information.
191 *
192 * @see `formatDate()`
193 *
194 *
195 * @usageNotes
196 *
197 * The result of this pipe is not reevaluated when the input is mutated. To avoid the need to
198 * reformat the date on every change-detection cycle, treat the date as an immutable object
199 * and change the reference when the pipe needs to run again.
200 *
201 * ### Pre-defined format options
202 *
203 * | Option | Equivalent to | Examples (given in `en-US` locale) |
204 * |---------------|-------------------------------------|-------------------------------------------------|
205 * | `'short'` | `'M/d/yy, h:mm a'` | `6/15/15, 9:03 AM` |
206 * | `'medium'` | `'MMM d, y, h:mm:ss a'` | `Jun 15, 2015, 9:03:01 AM` |
207 * | `'long'` | `'MMMM d, y, h:mm:ss a z'` | `June 15, 2015 at 9:03:01 AM GMT+1` |
208 * | `'full'` | `'EEEE, MMMM d, y, h:mm:ss a zzzz'` | `Monday, June 15, 2015 at 9:03:01 AM GMT+01:00` |
209 * | `'shortDate'` | `'M/d/yy'` | `6/15/15` |
210 * | `'mediumDate'`| `'MMM d, y'` | `Jun 15, 2015` |
211 * | `'longDate'` | `'MMMM d, y'` | `June 15, 2015` |
212 * | `'fullDate'` | `'EEEE, MMMM d, y'` | `Monday, June 15, 2015` |
213 * | `'shortTime'` | `'h:mm a'` | `9:03 AM` |
214 * | `'mediumTime'`| `'h:mm:ss a'` | `9:03:01 AM` |
215 * | `'longTime'` | `'h:mm:ss a z'` | `9:03:01 AM GMT+1` |
216 * | `'fullTime'` | `'h:mm:ss a zzzz'` | `9:03:01 AM GMT+01:00` |
217 *
218 * ### Custom format options
219 *
220 * You can construct a format string using symbols to specify the components
221 * of a date-time value, as described in the following table.
222 * Format details depend on the locale.
223 * Fields marked with (*) are only available in the extra data set for the given locale.
224 *
225 * | Field type | Format | Description | Example Value |
226 * |-------------------- |-------------|---------------------------------------------------------------|------------------------------------------------------------|
227 * | Era | G, GG & GGG | Abbreviated | AD |
228 * | | GGGG | Wide | Anno Domini |
229 * | | GGGGG | Narrow | A |
230 * | Year | y | Numeric: minimum digits | 2, 20, 201, 2017, 20173 |
231 * | | yy | Numeric: 2 digits + zero padded | 02, 20, 01, 17, 73 |
232 * | | yyy | Numeric: 3 digits + zero padded | 002, 020, 201, 2017, 20173 |
233 * | | yyyy | Numeric: 4 digits or more + zero padded | 0002, 0020, 0201, 2017, 20173 |
234 * | Week-numbering year | Y | Numeric: minimum digits | 2, 20, 201, 2017, 20173 |
235 * | | YY | Numeric: 2 digits + zero padded | 02, 20, 01, 17, 73 |
236 * | | YYY | Numeric: 3 digits + zero padded | 002, 020, 201, 2017, 20173 |
237 * | | YYYY | Numeric: 4 digits or more + zero padded | 0002, 0020, 0201, 2017, 20173 |
238 * | Month | M | Numeric: 1 digit | 9, 12 |
239 * | | MM | Numeric: 2 digits + zero padded | 09, 12 |
240 * | | MMM | Abbreviated | Sep |
241 * | | MMMM | Wide | September |
242 * | | MMMMM | Narrow | S |
243 * | Month standalone | L | Numeric: 1 digit | 9, 12 |
244 * | | LL | Numeric: 2 digits + zero padded | 09, 12 |
245 * | | LLL | Abbreviated | Sep |
246 * | | LLLL | Wide | September |
247 * | | LLLLL | Narrow | S |
248 * | Week of year | w | Numeric: minimum digits | 1... 53 |
249 * | | ww | Numeric: 2 digits + zero padded | 01... 53 |
250 * | Week of month | W | Numeric: 1 digit | 1... 5 |
251 * | Day of month | d | Numeric: minimum digits | 1 |
252 * | | dd | Numeric: 2 digits + zero padded | 01 |
253 * | Week day | E, EE & EEE | Abbreviated | Tue |
254 * | | EEEE | Wide | Tuesday |
255 * | | EEEEE | Narrow | T |
256 * | | EEEEEE | Short | Tu |
257 * | Week day standalone | c, cc | Numeric: 1 digit | 2 |
258 * | | ccc | Abbreviated | Tue |
259 * | | cccc | Wide | Tuesday |
260 * | | ccccc | Narrow | T |
261 * | | cccccc | Short | Tu |
262 * | Period | a, aa & aaa | Abbreviated | am/pm or AM/PM |
263 * | | aaaa | Wide (fallback to `a` when missing) | ante meridiem/post meridiem |
264 * | | aaaaa | Narrow | a/p |
265 * | Period* | B, BB & BBB | Abbreviated | mid. |
266 * | | BBBB | Wide | am, pm, midnight, noon, morning, afternoon, evening, night |
267 * | | BBBBB | Narrow | md |
268 * | Period standalone* | b, bb & bbb | Abbreviated | mid. |
269 * | | bbbb | Wide | am, pm, midnight, noon, morning, afternoon, evening, night |
270 * | | bbbbb | Narrow | md |
271 * | Hour 1-12 | h | Numeric: minimum digits | 1, 12 |
272 * | | hh | Numeric: 2 digits + zero padded | 01, 12 |
273 * | Hour 0-23 | H | Numeric: minimum digits | 0, 23 |
274 * | | HH | Numeric: 2 digits + zero padded | 00, 23 |
275 * | Minute | m | Numeric: minimum digits | 8, 59 |
276 * | | mm | Numeric: 2 digits + zero padded | 08, 59 |
277 * | Second | s | Numeric: minimum digits | 0... 59 |
278 * | | ss | Numeric: 2 digits + zero padded | 00... 59 |
279 * | Fractional seconds | S | Numeric: 1 digit | 0... 9 |
280 * | | SS | Numeric: 2 digits + zero padded | 00... 99 |
281 * | | SSS | Numeric: 3 digits + zero padded (= milliseconds) | 000... 999 |
282 * | Zone | z, zz & zzz | Short specific non location format (fallback to O) | GMT-8 |
283 * | | zzzz | Long specific non location format (fallback to OOOO) | GMT-08:00 |
284 * | | Z, ZZ & ZZZ | ISO8601 basic format | -0800 |
285 * | | ZZZZ | Long localized GMT format | GMT-8:00 |
286 * | | ZZZZZ | ISO8601 extended format + Z indicator for offset 0 (= XXXXX) | -08:00 |
287 * | | O, OO & OOO | Short localized GMT format | GMT-8 |
288 * | | OOOO | Long localized GMT format | GMT-08:00 |
289 *
290 *
291 * ### Format examples
292 *
293 * These examples transform a date into various formats,
294 * assuming that `dateObj` is a JavaScript `Date` object for
295 * year: 2015, month: 6, day: 15, hour: 21, minute: 43, second: 11,
296 * given in the local time for the `en-US` locale.
297 *
298 * ```
299 * {{ dateObj | date }} // output is 'Jun 15, 2015'
300 * {{ dateObj | date:'medium' }} // output is 'Jun 15, 2015, 9:43:11 PM'
301 * {{ dateObj | date:'shortTime' }} // output is '9:43 PM'
302 * {{ dateObj | date:'mm:ss' }} // output is '43:11'
303 * ```
304 *
305 * ### Usage example
306 *
307 * The following component uses a date pipe to display the current date in different formats.
308 *
309 * ```
310 * @Component({
311 * selector: 'date-pipe',
312 * template: `<div>
313 * <p>Today is {{today | date}}</p>
314 * <p>Or if you prefer, {{today | date:'fullDate'}}</p>
315 * <p>The time is {{today | date:'h:mm a z'}}</p>
316 * </div>`
317 * })
318 * // Get the current date and time as a date-time value.
319 * export class DatePipeComponent {
320 * today: number = Date.now();
321 * }
322 * ```
323 *
324 * @publicApi
325 */
326export declare class DatePipe implements PipeTransform {
327 private locale;
328 constructor(locale: string);
329 /**
330 * @param value The date expression: a `Date` object, a number
331 * (milliseconds since UTC epoch), or an ISO string (https://www.w3.org/TR/NOTE-datetime).
332 * @param format The date/time components to include, using predefined options or a
333 * custom format string.
334 * @param timezone A timezone offset (such as `'+0430'`), or a standard
335 * UTC/GMT or continental US timezone abbreviation.
336 * When not supplied, uses the end-user's local system timezone.
337 * @param locale A locale code for the locale format rules to use.
338 * When not supplied, uses the value of `LOCALE_ID`, which is `en-US` by default.
339 * See [Setting your app locale](guide/i18n-common-locale-id).
340 * @returns A date string in the desired format.
341 */
342 transform(value: Date | string | number, format?: string, timezone?: string, locale?: string): string | null;
343 transform(value: null | undefined, format?: string, timezone?: string, locale?: string): null;
344 transform(value: Date | string | number | null | undefined, format?: string, timezone?: string, locale?: string): string | null;
345 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<DatePipe, never>;
346 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<DatePipe, "date">;
347}
348
349/**
350 * @ngModule CommonModule
351 * @description
352 *
353 * Formats a value according to digit options and locale rules.
354 * Locale determines group sizing and separator,
355 * decimal point character, and other locale-specific configurations.
356 *
357 * @see `formatNumber()`
358 *
359 * @usageNotes
360 *
361 * ### digitsInfo
362 *
363 * The value's decimal representation is specified by the `digitsInfo`
364 * parameter, written in the following format:<br>
365 *
366 * ```
367 * {minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}
368 * ```
369 *
370 * - `minIntegerDigits`:
371 * The minimum number of integer digits before the decimal point.
372 * Default is 1.
373 *
374 * - `minFractionDigits`:
375 * The minimum number of digits after the decimal point.
376 * Default is 0.
377 *
378 * - `maxFractionDigits`:
379 * The maximum number of digits after the decimal point.
380 * Default is 3.
381 *
382 * If the formatted value is truncated it will be rounded using the "to-nearest" method:
383 *
384 * ```
385 * {{3.6 | number: '1.0-0'}}
386 * <!--will output '4'-->
387 *
388 * {{-3.6 | number:'1.0-0'}}
389 * <!--will output '-4'-->
390 * ```
391 *
392 * ### locale
393 *
394 * `locale` will format a value according to locale rules.
395 * Locale determines group sizing and separator,
396 * decimal point character, and other locale-specific configurations.
397 *
398 * When not supplied, uses the value of `LOCALE_ID`, which is `en-US` by default.
399 *
400 * See [Setting your app locale](guide/i18n-common-locale-id).
401 *
402 * ### Example
403 *
404 * The following code shows how the pipe transforms values
405 * according to various format specifications,
406 * where the caller's default locale is `en-US`.
407 *
408 * <code-example path="common/pipes/ts/number_pipe.ts" region='NumberPipe'></code-example>
409 *
410 * @publicApi
411 */
412export declare class DecimalPipe implements PipeTransform {
413 private _locale;
414 constructor(_locale: string);
415 transform(value: number | string, digitsInfo?: string, locale?: string): string | null;
416 transform(value: null | undefined, digitsInfo?: string, locale?: string): null;
417 transform(value: number | string | null | undefined, digitsInfo?: string, locale?: string): string | null;
418 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<DecimalPipe, never>;
419 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<DecimalPipe, "number">;
420}
421
422/**
423 * A DI Token representing the main rendering context. In a browser this is the DOM Document.
424 *
425 * Note: Document might not be available in the Application Context when Application and Rendering
426 * Contexts are not the same (e.g. when running the application in a Web Worker).
427 *
428 * @publicApi
429 */
430export declare const DOCUMENT: InjectionToken<Document>;
431
432/**
433 * @ngModule CommonModule
434 * @description
435 *
436 * Formats a number as currency using locale rules.
437 *
438 * @param value The number to format.
439 * @param locale A locale code for the locale format rules to use.
440 * @param currency A string containing the currency symbol or its name,
441 * such as "$" or "Canadian Dollar". Used in output string, but does not affect the operation
442 * of the function.
443 * @param currencyCode The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
444 * currency code, such as `USD` for the US dollar and `EUR` for the euro.
445 * Used to determine the number of digits in the decimal part.
446 * @param digitsInfo Decimal representation options, specified by a string in the following format:
447 * `{minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}`. See `DecimalPipe` for more details.
448 *
449 * @returns The formatted currency value.
450 *
451 * @see `formatNumber()`
452 * @see `DecimalPipe`
453 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
454 *
455 * @publicApi
456 */
457export declare function formatCurrency(value: number, locale: string, currency: string, currencyCode?: string, digitsInfo?: string): string;
458
459/**
460 * @ngModule CommonModule
461 * @description
462 *
463 * Formats a date according to locale rules.
464 *
465 * @param value The date to format, as a Date, or a number (milliseconds since UTC epoch)
466 * or an [ISO date-time string](https://www.w3.org/TR/NOTE-datetime).
467 * @param format The date-time components to include. See `DatePipe` for details.
468 * @param locale A locale code for the locale format rules to use.
469 * @param timezone The time zone. A time zone offset from GMT (such as `'+0430'`),
470 * or a standard UTC/GMT or continental US time zone abbreviation.
471 * If not specified, uses host system settings.
472 *
473 * @returns The formatted date string.
474 *
475 * @see `DatePipe`
476 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
477 *
478 * @publicApi
479 */
480export declare function formatDate(value: string | number | Date, format: string, locale: string, timezone?: string): string;
481
482/**
483 * @ngModule CommonModule
484 * @description
485 *
486 * Formats a number as text, with group sizing, separator, and other
487 * parameters based on the locale.
488 *
489 * @param value The number to format.
490 * @param locale A locale code for the locale format rules to use.
491 * @param digitsInfo Decimal representation options, specified by a string in the following format:
492 * `{minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}`. See `DecimalPipe` for more details.
493 *
494 * @returns The formatted text string.
495 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
496 *
497 * @publicApi
498 */
499export declare function formatNumber(value: number, locale: string, digitsInfo?: string): string;
500
501/**
502 * @ngModule CommonModule
503 * @description
504 *
505 * Formats a number as a percentage according to locale rules.
506 *
507 * @param value The number to format.
508 * @param locale A locale code for the locale format rules to use.
509 * @param digitsInfo Decimal representation options, specified by a string in the following format:
510 * `{minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}`. See `DecimalPipe` for more details.
511 *
512 * @returns The formatted percentage value.
513 *
514 * @see `formatNumber()`
515 * @see `DecimalPipe`
516 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
517 * @publicApi
518 *
519 */
520export declare function formatPercent(value: number, locale: string, digitsInfo?: string): string;
521
522/**
523 * String widths available for date-time formats.
524 * The specific character widths are locale-specific.
525 * Examples are given for `en-US`.
526 *
527 * @see `getLocaleDateFormat()`
528 * @see `getLocaleTimeFormat()`
529 * @see `getLocaleDateTimeFormat()`
530 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
531 * @publicApi
532 */
533export declare enum FormatWidth {
534 /**
535 * For `en-US`, 'M/d/yy, h:mm a'`
536 * (Example: `6/15/15, 9:03 AM`)
537 */
538 Short = 0,
539 /**
540 * For `en-US`, `'MMM d, y, h:mm:ss a'`
541 * (Example: `Jun 15, 2015, 9:03:01 AM`)
542 */
543 Medium = 1,
544 /**
545 * For `en-US`, `'MMMM d, y, h:mm:ss a z'`
546 * (Example: `June 15, 2015 at 9:03:01 AM GMT+1`)
547 */
548 Long = 2,
549 /**
550 * For `en-US`, `'EEEE, MMMM d, y, h:mm:ss a zzzz'`
551 * (Example: `Monday, June 15, 2015 at 9:03:01 AM GMT+01:00`)
552 */
553 Full = 3
554}
555
556/**
557 * Context-dependant translation forms for strings.
558 * Typically the standalone version is for the nominative form of the word,
559 * and the format version is used for the genitive case.
560 * @see [CLDR website](http://cldr.unicode.org/translation/date-time-1/date-time#TOC-Standalone-vs.-Format-Styles)
561 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
562 *
563 * @publicApi
564 */
565export declare enum FormStyle {
566 Format = 0,
567 Standalone = 1
568}
569
570/**
571 * Retrieves the currency symbol for a given currency code.
572 *
573 * For example, for the default `en-US` locale, the code `USD` can
574 * be represented by the narrow symbol `$` or the wide symbol `US$`.
575 *
576 * @param code The currency code.
577 * @param format The format, `wide` or `narrow`.
578 * @param locale A locale code for the locale format rules to use.
579 *
580 * @returns The symbol, or the currency code if no symbol is available.
581 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
582 *
583 * @publicApi
584 */
585export declare function getCurrencySymbol(code: string, format: 'wide' | 'narrow', locale?: string): string;
586
587/**
588 * Retrieves the default currency code for the given locale.
589 *
590 * The default is defined as the first currency which is still in use.
591 *
592 * @param locale The code of the locale whose currency code we want.
593 * @returns The code of the default currency for the given locale.
594 *
595 * @publicApi
596 */
597export declare function getLocaleCurrencyCode(locale: string): string | null;
598
599/**
600 * Retrieves the name of the currency for the main country corresponding
601 * to a given locale. For example, 'US Dollar' for `en-US`.
602 * @param locale A locale code for the locale format rules to use.
603 * @returns The currency name,
604 * or `null` if the main country cannot be determined.
605 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
606 *
607 * @publicApi
608 */
609export declare function getLocaleCurrencyName(locale: string): string | null;
610
611/**
612 * Retrieves the symbol used to represent the currency for the main country
613 * corresponding to a given locale. For example, '$' for `en-US`.
614 *
615 * @param locale A locale code for the locale format rules to use.
616 * @returns The localized symbol character,
617 * or `null` if the main country cannot be determined.
618 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
619 *
620 * @publicApi
621 */
622export declare function getLocaleCurrencySymbol(locale: string): string | null;
623
624/**
625 * Retrieves a localized date-value formating string.
626 *
627 * @param locale A locale code for the locale format rules to use.
628 * @param width The format type.
629 * @returns The localized formating string.
630 * @see `FormatWidth`
631 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
632 *
633 * @publicApi
634 */
635export declare function getLocaleDateFormat(locale: string, width: FormatWidth): string;
636
637/**
638 * Retrieves a localized date-time formatting string.
639 *
640 * @param locale A locale code for the locale format rules to use.
641 * @param width The format type.
642 * @returns The localized formatting string.
643 * @see `FormatWidth`
644 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
645 *
646 * @publicApi
647 */
648export declare function getLocaleDateTimeFormat(locale: string, width: FormatWidth): string;
649
650/**
651 * Retrieves days of the week for the given locale, using the Gregorian calendar.
652 *
653 * @param locale A locale code for the locale format rules to use.
654 * @param formStyle The required grammatical form.
655 * @param width The required character width.
656 * @returns An array of localized name strings.
657 * For example,`[Sunday, Monday, ... Saturday]` for `en-US`.
658 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
659 *
660 * @publicApi
661 */
662export declare function getLocaleDayNames(locale: string, formStyle: FormStyle, width: TranslationWidth): ReadonlyArray<string>;
663
664/**
665 * Retrieves day period strings for the given locale.
666 *
667 * @param locale A locale code for the locale format rules to use.
668 * @param formStyle The required grammatical form.
669 * @param width The required character width.
670 * @returns An array of localized period strings. For example, `[AM, PM]` for `en-US`.
671 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
672 *
673 * @publicApi
674 */
675export declare function getLocaleDayPeriods(locale: string, formStyle: FormStyle, width: TranslationWidth): Readonly<[string, string]>;
676
677/**
678 * Retrieves the writing direction of a specified locale
679 * @param locale A locale code for the locale format rules to use.
680 * @publicApi
681 * @returns 'rtl' or 'ltr'
682 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
683 */
684export declare function getLocaleDirection(locale: string): 'ltr' | 'rtl';
685
686/**
687 * Retrieves Gregorian-calendar eras for the given locale.
688 * @param locale A locale code for the locale format rules to use.
689 * @param width The required character width.
690
691 * @returns An array of localized era strings.
692 * For example, `[AD, BC]` for `en-US`.
693 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
694 *
695 * @publicApi
696 */
697export declare function getLocaleEraNames(locale: string, width: TranslationWidth): Readonly<[string, string]>;
698
699/**
700 * Retrieves locale-specific rules used to determine which day period to use
701 * when more than one period is defined for a locale.
702 *
703 * There is a rule for each defined day period. The
704 * first rule is applied to the first day period and so on.
705 * Fall back to AM/PM when no rules are available.
706 *
707 * A rule can specify a period as time range, or as a single time value.
708 *
709 * This functionality is only available when you have loaded the full locale data.
710 * See the ["I18n guide"](guide/i18n-common-format-data-locale).
711 *
712 * @param locale A locale code for the locale format rules to use.
713 * @returns The rules for the locale, a single time value or array of *from-time, to-time*,
714 * or null if no periods are available.
715 *
716 * @see `getLocaleExtraDayPeriods()`
717 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
718 *
719 * @publicApi
720 */
721export declare function getLocaleExtraDayPeriodRules(locale: string): (Time | [Time, Time])[];
722
723/**
724 * Retrieves locale-specific day periods, which indicate roughly how a day is broken up
725 * in different languages.
726 * For example, for `en-US`, periods are morning, noon, afternoon, evening, and midnight.
727 *
728 * This functionality is only available when you have loaded the full locale data.
729 * See the ["I18n guide"](guide/i18n-common-format-data-locale).
730 *
731 * @param locale A locale code for the locale format rules to use.
732 * @param formStyle The required grammatical form.
733 * @param width The required character width.
734 * @returns The translated day-period strings.
735 * @see `getLocaleExtraDayPeriodRules()`
736 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
737 *
738 * @publicApi
739 */
740export declare function getLocaleExtraDayPeriods(locale: string, formStyle: FormStyle, width: TranslationWidth): string[];
741
742/**
743 * Retrieves the first day of the week for the given locale.
744 *
745 * @param locale A locale code for the locale format rules to use.
746 * @returns A day index number, using the 0-based week-day index for `en-US`
747 * (Sunday = 0, Monday = 1, ...).
748 * For example, for `fr-FR`, returns 1 to indicate that the first day is Monday.
749 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
750 *
751 * @publicApi
752 */
753export declare function getLocaleFirstDayOfWeek(locale: string): WeekDay;
754
755/**
756 * Retrieves the locale ID from the currently loaded locale.
757 * The loaded locale could be, for example, a global one rather than a regional one.
758 * @param locale A locale code, such as `fr-FR`.
759 * @returns The locale code. For example, `fr`.
760 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
761 *
762 * @publicApi
763 */
764export declare function getLocaleId(locale: string): string;
765
766/**
767 * Retrieves months of the year for the given locale, using the Gregorian calendar.
768 *
769 * @param locale A locale code for the locale format rules to use.
770 * @param formStyle The required grammatical form.
771 * @param width The required character width.
772 * @returns An array of localized name strings.
773 * For example, `[January, February, ...]` for `en-US`.
774 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
775 *
776 * @publicApi
777 */
778export declare function getLocaleMonthNames(locale: string, formStyle: FormStyle, width: TranslationWidth): ReadonlyArray<string>;
779
780/**
781 * Retrieves a number format for a given locale.
782 *
783 * Numbers are formatted using patterns, like `#,###.00`. For example, the pattern `#,###.00`
784 * when used to format the number 12345.678 could result in "12'345,678". That would happen if the
785 * grouping separator for your language is an apostrophe, and the decimal separator is a comma.
786 *
787 * <b>Important:</b> The characters `.` `,` `0` `#` (and others below) are special placeholders
788 * that stand for the decimal separator, and so on, and are NOT real characters.
789 * You must NOT "translate" the placeholders. For example, don't change `.` to `,` even though in
790 * your language the decimal point is written with a comma. The symbols should be replaced by the
791 * local equivalents, using the appropriate `NumberSymbol` for your language.
792 *
793 * Here are the special characters used in number patterns:
794 *
795 * | Symbol | Meaning |
796 * |--------|---------|
797 * | . | Replaced automatically by the character used for the decimal point. |
798 * | , | Replaced by the "grouping" (thousands) separator. |
799 * | 0 | Replaced by a digit (or zero if there aren't enough digits). |
800 * | # | Replaced by a digit (or nothing if there aren't enough). |
801 * | ¤ | Replaced by a currency symbol, such as $ or USD. |
802 * | % | Marks a percent format. The % symbol may change position, but must be retained. |
803 * | E | Marks a scientific format. The E symbol may change position, but must be retained. |
804 * | ' | Special characters used as literal characters are quoted with ASCII single quotes. |
805 *
806 * @param locale A locale code for the locale format rules to use.
807 * @param type The type of numeric value to be formatted (such as `Decimal` or `Currency`.)
808 * @returns The localized format string.
809 * @see `NumberFormatStyle`
810 * @see [CLDR website](http://cldr.unicode.org/translation/number-patterns)
811 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
812 *
813 * @publicApi
814 */
815export declare function getLocaleNumberFormat(locale: string, type: NumberFormatStyle): string;
816
817/**
818 * Retrieves a localized number symbol that can be used to replace placeholders in number formats.
819 * @param locale The locale code.
820 * @param symbol The symbol to localize.
821 * @returns The character for the localized symbol.
822 * @see `NumberSymbol`
823 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
824 *
825 * @publicApi
826 */
827export declare function getLocaleNumberSymbol(locale: string, symbol: NumberSymbol): string;
828
829/**
830 * @alias core/ɵgetLocalePluralCase
831 * @publicApi
832 */
833export declare const getLocalePluralCase: (locale: string) => ((value: number) => Plural);
834
835/**
836 * Retrieves a localized time-value formatting string.
837 *
838 * @param locale A locale code for the locale format rules to use.
839 * @param width The format type.
840 * @returns The localized formatting string.
841 * @see `FormatWidth`
842 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
843
844 * @publicApi
845 */
846export declare function getLocaleTimeFormat(locale: string, width: FormatWidth): string;
847
848/**
849 * Range of week days that are considered the week-end for the given locale.
850 *
851 * @param locale A locale code for the locale format rules to use.
852 * @returns The range of day values, `[startDay, endDay]`.
853 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
854 *
855 * @publicApi
856 */
857export declare function getLocaleWeekEndRange(locale: string): [WeekDay, WeekDay];
858
859/**
860 * Reports the number of decimal digits for a given currency.
861 * The value depends upon the presence of cents in that particular currency.
862 *
863 * @param code The currency code.
864 * @returns The number of decimal digits, typically 0 or 2.
865 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
866 *
867 * @publicApi
868 */
869export declare function getNumberOfCurrencyDigits(code: string): number;
870
871/**
872 * @description
873 * A {@link LocationStrategy} used to configure the {@link Location} service to
874 * represent its state in the
875 * [hash fragment](https://en.wikipedia.org/wiki/Uniform_Resource_Locator#Syntax)
876 * of the browser's URL.
877 *
878 * For instance, if you call `location.go('/foo')`, the browser's URL will become
879 * `example.com#/foo`.
880 *
881 * @usageNotes
882 *
883 * ### Example
884 *
885 * {@example common/location/ts/hash_location_component.ts region='LocationComponent'}
886 *
887 * @publicApi
888 */
889export declare class HashLocationStrategy extends LocationStrategy implements OnDestroy {
890 private _platformLocation;
891 private _baseHref;
892 private _removeListenerFns;
893 constructor(_platformLocation: PlatformLocation, _baseHref?: string);
894 ngOnDestroy(): void;
895 onPopState(fn: LocationChangeListener): void;
896 getBaseHref(): string;
897 path(includeHash?: boolean): string;
898 prepareExternalUrl(internal: string): string;
899 pushState(state: any, title: string, path: string, queryParams: string): void;
900 replaceState(state: any, title: string, path: string, queryParams: string): void;
901 forward(): void;
902 back(): void;
903 historyGo(relativePosition?: number): void;
904 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<HashLocationStrategy, [null, { optional: true; }]>;
905 static ɵprov: ɵngcc0.ɵɵInjectableDeclaration<HashLocationStrategy>;
906}
907
908/**
909 * @ngModule CommonModule
910 * @description
911 *
912 * Maps a value to a string that pluralizes the value according to locale rules.
913 *
914 * @usageNotes
915 *
916 * ### Example
917 *
918 * {@example common/pipes/ts/i18n_pipe.ts region='I18nPluralPipeComponent'}
919 *
920 * @publicApi
921 */
922export declare class I18nPluralPipe implements PipeTransform {
923 private _localization;
924 constructor(_localization: NgLocalization);
925 /**
926 * @param value the number to be formatted
927 * @param pluralMap an object that mimics the ICU format, see
928 * http://userguide.icu-project.org/formatparse/messages.
929 * @param locale a `string` defining the locale to use (uses the current {@link LOCALE_ID} by
930 * default).
931 */
932 transform(value: number | null | undefined, pluralMap: {
933 [count: string]: string;
934 }, locale?: string): string;
935 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<I18nPluralPipe, never>;
936 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<I18nPluralPipe, "i18nPlural">;
937}
938
939/**
940 * @ngModule CommonModule
941 * @description
942 *
943 * Generic selector that displays the string that matches the current value.
944 *
945 * If none of the keys of the `mapping` match the `value`, then the content
946 * of the `other` key is returned when present, otherwise an empty string is returned.
947 *
948 * @usageNotes
949 *
950 * ### Example
951 *
952 * {@example common/pipes/ts/i18n_pipe.ts region='I18nSelectPipeComponent'}
953 *
954 * @publicApi
955 */
956export declare class I18nSelectPipe implements PipeTransform {
957 /**
958 * @param value a string to be internationalized.
959 * @param mapping an object that indicates the text that should be displayed
960 * for different values of the provided `value`.
961 */
962 transform(value: string | null | undefined, mapping: {
963 [key: string]: string;
964 }): string;
965 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<I18nSelectPipe, never>;
966 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<I18nSelectPipe, "i18nSelect">;
967}
968
969/**
970 * Returns whether a platform id represents a browser platform.
971 * @publicApi
972 */
973export declare function isPlatformBrowser(platformId: Object): boolean;
974
975/**
976 * Returns whether a platform id represents a server platform.
977 * @publicApi
978 */
979export declare function isPlatformServer(platformId: Object): boolean;
980
981/**
982 * Returns whether a platform id represents a web worker app platform.
983 * @publicApi
984 */
985export declare function isPlatformWorkerApp(platformId: Object): boolean;
986
987/**
988 * Returns whether a platform id represents a web worker UI platform.
989 * @publicApi
990 */
991export declare function isPlatformWorkerUi(platformId: Object): boolean;
992
993/**
994 * @ngModule CommonModule
995 * @description
996 *
997 * Converts a value into its JSON-format representation. Useful for debugging.
998 *
999 * @usageNotes
1000 *
1001 * The following component uses a JSON pipe to convert an object
1002 * to JSON format, and displays the string in both formats for comparison.
1003 *
1004 * {@example common/pipes/ts/json_pipe.ts region='JsonPipe'}
1005 *
1006 * @publicApi
1007 */
1008export declare class JsonPipe implements PipeTransform {
1009 /**
1010 * @param value A value of any type to convert into a JSON-format string.
1011 */
1012 transform(value: any): string;
1013 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<JsonPipe, never>;
1014 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<JsonPipe, "json">;
1015}
1016
1017/**
1018 * A key value pair.
1019 * Usually used to represent the key value pairs from a Map or Object.
1020 *
1021 * @publicApi
1022 */
1023export declare interface KeyValue<K, V> {
1024 key: K;
1025 value: V;
1026}
1027
1028/**
1029 * @ngModule CommonModule
1030 * @description
1031 *
1032 * Transforms Object or Map into an array of key value pairs.
1033 *
1034 * The output array will be ordered by keys.
1035 * By default the comparator will be by Unicode point value.
1036 * You can optionally pass a compareFn if your keys are complex types.
1037 *
1038 * @usageNotes
1039 * ### Examples
1040 *
1041 * This examples show how an Object or a Map can be iterated by ngFor with the use of this
1042 * keyvalue pipe.
1043 *
1044 * {@example common/pipes/ts/keyvalue_pipe.ts region='KeyValuePipe'}
1045 *
1046 * @publicApi
1047 */
1048export declare class KeyValuePipe implements PipeTransform {
1049 private readonly differs;
1050 constructor(differs: KeyValueDiffers);
1051 private differ;
1052 private keyValues;
1053 private compareFn;
1054 transform<K, V>(input: ReadonlyMap<K, V>, compareFn?: (a: KeyValue<K, V>, b: KeyValue<K, V>) => number): Array<KeyValue<K, V>>;
1055 transform<K extends number, V>(input: Record<K, V>, compareFn?: (a: KeyValue<string, V>, b: KeyValue<string, V>) => number): Array<KeyValue<string, V>>;
1056 transform<K extends string, V>(input: Record<K, V> | ReadonlyMap<K, V>, compareFn?: (a: KeyValue<K, V>, b: KeyValue<K, V>) => number): Array<KeyValue<K, V>>;
1057 transform(input: null | undefined, compareFn?: (a: KeyValue<unknown, unknown>, b: KeyValue<unknown, unknown>) => number): null;
1058 transform<K, V>(input: ReadonlyMap<K, V> | null | undefined, compareFn?: (a: KeyValue<K, V>, b: KeyValue<K, V>) => number): Array<KeyValue<K, V>> | null;
1059 transform<K extends number, V>(input: Record<K, V> | null | undefined, compareFn?: (a: KeyValue<string, V>, b: KeyValue<string, V>) => number): Array<KeyValue<string, V>> | null;
1060 transform<K extends string, V>(input: Record<K, V> | ReadonlyMap<K, V> | null | undefined, compareFn?: (a: KeyValue<K, V>, b: KeyValue<K, V>) => number): Array<KeyValue<K, V>> | null;
1061 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<KeyValuePipe, never>;
1062 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<KeyValuePipe, "keyvalue">;
1063}
1064
1065/**
1066 * @description
1067 *
1068 * A service that applications can use to interact with a browser's URL.
1069 *
1070 * Depending on the `LocationStrategy` used, `Location` persists
1071 * to the URL's path or the URL's hash segment.
1072 *
1073 * @usageNotes
1074 *
1075 * It's better to use the `Router.navigate()` service to trigger route changes. Use
1076 * `Location` only if you need to interact with or create normalized URLs outside of
1077 * routing.
1078 *
1079 * `Location` is responsible for normalizing the URL against the application's base href.
1080 * A normalized URL is absolute from the URL host, includes the application's base href, and has no
1081 * trailing slash:
1082 * - `/my/app/user/123` is normalized
1083 * - `my/app/user/123` **is not** normalized
1084 * - `/my/app/user/123/` **is not** normalized
1085 *
1086 * ### Example
1087 *
1088 * <code-example path='common/location/ts/path_location_component.ts'
1089 * region='LocationComponent'></code-example>
1090 *
1091 * @publicApi
1092 */
1093declare class Location_2 {
1094 constructor(platformStrategy: LocationStrategy, platformLocation: PlatformLocation);
1095 /**
1096 * Normalizes the URL path for this location.
1097 *
1098 * @param includeHash True to include an anchor fragment in the path.
1099 *
1100 * @returns The normalized URL path.
1101 */
1102 path(includeHash?: boolean): string;
1103 /**
1104 * Reports the current state of the location history.
1105 * @returns The current value of the `history.state` object.
1106 */
1107 getState(): unknown;
1108 /**
1109 * Normalizes the given path and compares to the current normalized path.
1110 *
1111 * @param path The given URL path.
1112 * @param query Query parameters.
1113 *
1114 * @returns True if the given URL path is equal to the current normalized path, false
1115 * otherwise.
1116 */
1117 isCurrentPathEqualTo(path: string, query?: string): boolean;
1118 /**
1119 * Normalizes a URL path by stripping any trailing slashes.
1120 *
1121 * @param url String representing a URL.
1122 *
1123 * @returns The normalized URL string.
1124 */
1125 normalize(url: string): string;
1126 /**
1127 * Normalizes an external URL path.
1128 * If the given URL doesn't begin with a leading slash (`'/'`), adds one
1129 * before normalizing. Adds a hash if `HashLocationStrategy` is
1130 * in use, or the `APP_BASE_HREF` if the `PathLocationStrategy` is in use.
1131 *
1132 * @param url String representing a URL.
1133 *
1134 * @returns A normalized platform-specific URL.
1135 */
1136 prepareExternalUrl(url: string): string;
1137 /**
1138 * Changes the browser's URL to a normalized version of a given URL, and pushes a
1139 * new item onto the platform's history.
1140 *
1141 * @param path URL path to normalize.
1142 * @param query Query parameters.
1143 * @param state Location history state.
1144 *
1145 */
1146 go(path: string, query?: string, state?: any): void;
1147 /**
1148 * Changes the browser's URL to a normalized version of the given URL, and replaces
1149 * the top item on the platform's history stack.
1150 *
1151 * @param path URL path to normalize.
1152 * @param query Query parameters.
1153 * @param state Location history state.
1154 */
1155 replaceState(path: string, query?: string, state?: any): void;
1156 /**
1157 * Navigates forward in the platform's history.
1158 */
1159 forward(): void;
1160 /**
1161 * Navigates back in the platform's history.
1162 */
1163 back(): void;
1164 /**
1165 * Navigate to a specific page from session history, identified by its relative position to the
1166 * current page.
1167 *
1168 * @param relativePosition Position of the target page in the history relative to the current
1169 * page.
1170 * A negative value moves backwards, a positive value moves forwards, e.g. `location.historyGo(2)`
1171 * moves forward two pages and `location.historyGo(-2)` moves back two pages. When we try to go
1172 * beyond what's stored in the history session, we stay in the current page. Same behaviour occurs
1173 * when `relativePosition` equals 0.
1174 * @see https://developer.mozilla.org/en-US/docs/Web/API/History_API#Moving_to_a_specific_point_in_history
1175 */
1176 historyGo(relativePosition?: number): void;
1177 /**
1178 * Registers a URL change listener. Use to catch updates performed by the Angular
1179 * framework that are not detectible through "popstate" or "hashchange" events.
1180 *
1181 * @param fn The change handler function, which take a URL and a location history state.
1182 */
1183 onUrlChange(fn: (url: string, state: unknown) => void): void;
1184 /**
1185 * Subscribes to the platform's `popState` events.
1186 *
1187 * Note: `Location.go()` does not trigger the `popState` event in the browser. Use
1188 * `Location.onUrlChange()` to subscribe to URL changes instead.
1189 *
1190 * @param value Event that is triggered when the state history changes.
1191 * @param exception The exception to throw.
1192 *
1193 * @see [onpopstate](https://developer.mozilla.org/en-US/docs/Web/API/WindowEventHandlers/onpopstate)
1194 *
1195 * @returns Subscribed events.
1196 */
1197 subscribe(onNext: (value: PopStateEvent_2) => void, onThrow?: ((exception: any) => void) | null, onReturn?: (() => void) | null): SubscriptionLike;
1198 /**
1199 * Normalizes URL parameters by prepending with `?` if needed.
1200 *
1201 * @param params String of URL parameters.
1202 *
1203 * @returns The normalized URL parameters string.
1204 */
1205 static normalizeQueryParams: (params: string) => string;
1206 /**
1207 * Joins two parts of a URL with a slash if needed.
1208 *
1209 * @param start URL string
1210 * @param end URL string
1211 *
1212 *
1213 * @returns The joined URL string.
1214 */
1215 static joinWithSlash: (start: string, end: string) => string;
1216 /**
1217 * Removes a trailing slash from a URL string if needed.
1218 * Looks for the first occurrence of either `#`, `?`, or the end of the
1219 * line as `/` characters and removes the trailing slash if one exists.
1220 *
1221 * @param url URL string.
1222 *
1223 * @returns The URL string, modified if needed.
1224 */
1225 static stripTrailingSlash: (url: string) => string;
1226 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<Location_2, never>;
1227}
1228export { Location_2 as Location }
1229
1230/**
1231 * @description
1232 * Indicates when a location is initialized.
1233 *
1234 * @publicApi
1235 */
1236export declare const LOCATION_INITIALIZED: InjectionToken<Promise<any>>;
1237
1238/**
1239 * @description
1240 * A serializable version of the event from `onPopState` or `onHashChange`
1241 *
1242 * @publicApi
1243 */
1244export declare interface LocationChangeEvent {
1245 type: string;
1246 state: any;
1247}
1248
1249/**
1250 * @publicApi
1251 */
1252export declare interface LocationChangeListener {
1253 (event: LocationChangeEvent): any;
1254}
1255
1256/**
1257 * Enables the `Location` service to read route state from the browser's URL.
1258 * Angular provides two strategies:
1259 * `HashLocationStrategy` and `PathLocationStrategy`.
1260 *
1261 * Applications should use the `Router` or `Location` services to
1262 * interact with application route state.
1263 *
1264 * For instance, `HashLocationStrategy` produces URLs like
1265 * <code class="no-auto-link">http://example.com#/foo</code>,
1266 * and `PathLocationStrategy` produces
1267 * <code class="no-auto-link">http://example.com/foo</code> as an equivalent URL.
1268 *
1269 * See these two classes for more.
1270 *
1271 * @publicApi
1272 */
1273export declare abstract class LocationStrategy {
1274 abstract path(includeHash?: boolean): string;
1275 abstract prepareExternalUrl(internal: string): string;
1276 abstract pushState(state: any, title: string, url: string, queryParams: string): void;
1277 abstract replaceState(state: any, title: string, url: string, queryParams: string): void;
1278 abstract forward(): void;
1279 abstract back(): void;
1280 historyGo?(relativePosition: number): void;
1281 abstract onPopState(fn: LocationChangeListener): void;
1282 abstract getBaseHref(): string;
1283 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<LocationStrategy, never>;
1284}
1285
1286/**
1287 * Transforms text to all lower case.
1288 *
1289 * @see `UpperCasePipe`
1290 * @see `TitleCasePipe`
1291 * @usageNotes
1292 *
1293 * The following example defines a view that allows the user to enter
1294 * text, and then uses the pipe to convert the input text to all lower case.
1295 *
1296 * <code-example path="common/pipes/ts/lowerupper_pipe.ts" region='LowerUpperPipe'></code-example>
1297 *
1298 * @ngModule CommonModule
1299 * @publicApi
1300 */
1301export declare class LowerCasePipe implements PipeTransform {
1302 /**
1303 * @param value The string to transform to lower case.
1304 */
1305 transform(value: string): string;
1306 transform(value: null | undefined): null;
1307 transform(value: string | null | undefined): string | null;
1308 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<LowerCasePipe, never>;
1309 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<LowerCasePipe, "lowercase">;
1310}
1311
1312/**
1313 * @ngModule CommonModule
1314 *
1315 * @usageNotes
1316 * ```
1317 * <some-element [ngClass]="'first second'">...</some-element>
1318 *
1319 * <some-element [ngClass]="['first', 'second']">...</some-element>
1320 *
1321 * <some-element [ngClass]="{'first': true, 'second': true, 'third': false}">...</some-element>
1322 *
1323 * <some-element [ngClass]="stringExp|arrayExp|objExp">...</some-element>
1324 *
1325 * <some-element [ngClass]="{'class1 class2 class3' : true}">...</some-element>
1326 * ```
1327 *
1328 * @description
1329 *
1330 * Adds and removes CSS classes on an HTML element.
1331 *
1332 * The CSS classes are updated as follows, depending on the type of the expression evaluation:
1333 * - `string` - the CSS classes listed in the string (space delimited) are added,
1334 * - `Array` - the CSS classes declared as Array elements are added,
1335 * - `Object` - keys are CSS classes that get added when the expression given in the value
1336 * evaluates to a truthy value, otherwise they are removed.
1337 *
1338 * @publicApi
1339 */
1340export declare class NgClass implements DoCheck {
1341 private _iterableDiffers;
1342 private _keyValueDiffers;
1343 private _ngEl;
1344 private _renderer;
1345 private _iterableDiffer;
1346 private _keyValueDiffer;
1347 private _initialClasses;
1348 private _rawClass;
1349 constructor(_iterableDiffers: IterableDiffers, _keyValueDiffers: KeyValueDiffers, _ngEl: ElementRef, _renderer: Renderer2);
1350 set klass(value: string);
1351 set ngClass(value: string | string[] | Set<string> | {
1352 [klass: string]: any;
1353 });
1354 ngDoCheck(): void;
1355 private _applyKeyValueChanges;
1356 private _applyIterableChanges;
1357 /**
1358 * Applies a collection of CSS classes to the DOM element.
1359 *
1360 * For argument of type Set and Array CSS class names contained in those collections are always
1361 * added.
1362 * For argument of type Map CSS class name in the map's key is toggled based on the value (added
1363 * for truthy and removed for falsy).
1364 */
1365 private _applyClasses;
1366 /**
1367 * Removes a collection of CSS classes from the DOM element. This is mostly useful for cleanup
1368 * purposes.
1369 */
1370 private _removeClasses;
1371 private _toggleClass;
1372 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgClass, never>;
1373 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgClass, "[ngClass]", never, { "klass": "class"; "ngClass": "ngClass"; }, {}, never>;
1374}
1375
1376/**
1377 * Instantiates a {@link Component} type and inserts its Host View into the current View.
1378 * `NgComponentOutlet` provides a declarative approach for dynamic component creation.
1379 *
1380 * `NgComponentOutlet` requires a component type, if a falsy value is set the view will clear and
1381 * any existing component will be destroyed.
1382 *
1383 * @usageNotes
1384 *
1385 * ### Fine tune control
1386 *
1387 * You can control the component creation process by using the following optional attributes:
1388 *
1389 * * `ngComponentOutletInjector`: Optional custom {@link Injector} that will be used as parent for
1390 * the Component. Defaults to the injector of the current view container.
1391 *
1392 * * `ngComponentOutletContent`: Optional list of projectable nodes to insert into the content
1393 * section of the component, if it exists.
1394 *
1395 * * `ngComponentOutletNgModuleFactory`: Optional module factory to allow loading another
1396 * module dynamically, then loading a component from that module.
1397 *
1398 * ### Syntax
1399 *
1400 * Simple
1401 * ```
1402 * <ng-container *ngComponentOutlet="componentTypeExpression"></ng-container>
1403 * ```
1404 *
1405 * Customized injector/content
1406 * ```
1407 * <ng-container *ngComponentOutlet="componentTypeExpression;
1408 * injector: injectorExpression;
1409 * content: contentNodesExpression;">
1410 * </ng-container>
1411 * ```
1412 *
1413 * Customized ngModuleFactory
1414 * ```
1415 * <ng-container *ngComponentOutlet="componentTypeExpression;
1416 * ngModuleFactory: moduleFactory;">
1417 * </ng-container>
1418 * ```
1419 *
1420 * ### A simple example
1421 *
1422 * {@example common/ngComponentOutlet/ts/module.ts region='SimpleExample'}
1423 *
1424 * A more complete example with additional options:
1425 *
1426 * {@example common/ngComponentOutlet/ts/module.ts region='CompleteExample'}
1427 *
1428 * @publicApi
1429 * @ngModule CommonModule
1430 */
1431export declare class NgComponentOutlet implements OnChanges, OnDestroy {
1432 private _viewContainerRef;
1433 ngComponentOutlet: Type<any>;
1434 ngComponentOutletInjector: Injector;
1435 ngComponentOutletContent: any[][];
1436 ngComponentOutletNgModuleFactory: NgModuleFactory<any>;
1437 private _componentRef;
1438 private _moduleRef;
1439 constructor(_viewContainerRef: ViewContainerRef);
1440 ngOnChanges(changes: SimpleChanges): void;
1441 ngOnDestroy(): void;
1442 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgComponentOutlet, never>;
1443 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgComponentOutlet, "[ngComponentOutlet]", never, { "ngComponentOutlet": "ngComponentOutlet"; "ngComponentOutletInjector": "ngComponentOutletInjector"; "ngComponentOutletContent": "ngComponentOutletContent"; "ngComponentOutletNgModuleFactory": "ngComponentOutletNgModuleFactory"; }, {}, never>;
1444}
1445
1446/**
1447 * A [structural directive](guide/structural-directives) that renders
1448 * a template for each item in a collection.
1449 * The directive is placed on an element, which becomes the parent
1450 * of the cloned templates.
1451 *
1452 * The `ngForOf` directive is generally used in the
1453 * [shorthand form](guide/structural-directives#asterisk) `*ngFor`.
1454 * In this form, the template to be rendered for each iteration is the content
1455 * of an anchor element containing the directive.
1456 *
1457 * The following example shows the shorthand syntax with some options,
1458 * contained in an `<li>` element.
1459 *
1460 * ```
1461 * <li *ngFor="let item of items; index as i; trackBy: trackByFn">...</li>
1462 * ```
1463 *
1464 * The shorthand form expands into a long form that uses the `ngForOf` selector
1465 * on an `<ng-template>` element.
1466 * The content of the `<ng-template>` element is the `<li>` element that held the
1467 * short-form directive.
1468 *
1469 * Here is the expanded version of the short-form example.
1470 *
1471 * ```
1472 * <ng-template ngFor let-item [ngForOf]="items" let-i="index" [ngForTrackBy]="trackByFn">
1473 * <li>...</li>
1474 * </ng-template>
1475 * ```
1476 *
1477 * Angular automatically expands the shorthand syntax as it compiles the template.
1478 * The context for each embedded view is logically merged to the current component
1479 * context according to its lexical position.
1480 *
1481 * When using the shorthand syntax, Angular allows only [one structural directive
1482 * on an element](guide/built-in-directives#one-per-element).
1483 * If you want to iterate conditionally, for example,
1484 * put the `*ngIf` on a container element that wraps the `*ngFor` element.
1485 * For futher discussion, see
1486 * [Structural Directives](guide/built-in-directives#one-per-element).
1487 *
1488 * @usageNotes
1489 *
1490 * ### Local variables
1491 *
1492 * `NgForOf` provides exported values that can be aliased to local variables.
1493 * For example:
1494 *
1495 * ```
1496 * <li *ngFor="let user of users; index as i; first as isFirst">
1497 * {{i}}/{{users.length}}. {{user}} <span *ngIf="isFirst">default</span>
1498 * </li>
1499 * ```
1500 *
1501 * The following exported values can be aliased to local variables:
1502 *
1503 * - `$implicit: T`: The value of the individual items in the iterable (`ngForOf`).
1504 * - `ngForOf: NgIterable<T>`: The value of the iterable expression. Useful when the expression is
1505 * more complex then a property access, for example when using the async pipe (`userStreams |
1506 * async`).
1507 * - `index: number`: The index of the current item in the iterable.
1508 * - `count: number`: The length of the iterable.
1509 * - `first: boolean`: True when the item is the first item in the iterable.
1510 * - `last: boolean`: True when the item is the last item in the iterable.
1511 * - `even: boolean`: True when the item has an even index in the iterable.
1512 * - `odd: boolean`: True when the item has an odd index in the iterable.
1513 *
1514 * ### Change propagation
1515 *
1516 * When the contents of the iterator changes, `NgForOf` makes the corresponding changes to the DOM:
1517 *
1518 * * When an item is added, a new instance of the template is added to the DOM.
1519 * * When an item is removed, its template instance is removed from the DOM.
1520 * * When items are reordered, their respective templates are reordered in the DOM.
1521 *
1522 * Angular uses object identity to track insertions and deletions within the iterator and reproduce
1523 * those changes in the DOM. This has important implications for animations and any stateful
1524 * controls that are present, such as `<input>` elements that accept user input. Inserted rows can
1525 * be animated in, deleted rows can be animated out, and unchanged rows retain any unsaved state
1526 * such as user input.
1527 * For more on animations, see [Transitions and Triggers](guide/transition-and-triggers).
1528 *
1529 * The identities of elements in the iterator can change while the data does not.
1530 * This can happen, for example, if the iterator is produced from an RPC to the server, and that
1531 * RPC is re-run. Even if the data hasn't changed, the second response produces objects with
1532 * different identities, and Angular must tear down the entire DOM and rebuild it (as if all old
1533 * elements were deleted and all new elements inserted).
1534 *
1535 * To avoid this expensive operation, you can customize the default tracking algorithm.
1536 * by supplying the `trackBy` option to `NgForOf`.
1537 * `trackBy` takes a function that has two arguments: `index` and `item`.
1538 * If `trackBy` is given, Angular tracks changes by the return value of the function.
1539 *
1540 * @see [Structural Directives](guide/structural-directives)
1541 * @ngModule CommonModule
1542 * @publicApi
1543 */
1544export declare class NgForOf<T, U extends NgIterable<T> = NgIterable<T>> implements DoCheck {
1545 private _viewContainer;
1546 private _template;
1547 private _differs;
1548 /**
1549 * The value of the iterable expression, which can be used as a
1550 * [template input variable](guide/structural-directives#shorthand).
1551 */
1552 set ngForOf(ngForOf: U & NgIterable<T> | undefined | null);
1553 /**
1554 * Specifies a custom `TrackByFunction` to compute the identity of items in an iterable.
1555 *
1556 * If a custom `TrackByFunction` is not provided, `NgForOf` will use the item's [object
1557 * identity](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is)
1558 * as the key.
1559 *
1560 * `NgForOf` uses the computed key to associate items in an iterable with DOM elements
1561 * it produces for these items.
1562 *
1563 * A custom `TrackByFunction` is useful to provide good user experience in cases when items in an
1564 * iterable rendered using `NgForOf` have a natural identifier (for example, custom ID or a
1565 * primary key), and this iterable could be updated with new object instances that still
1566 * represent the same underlying entity (for example, when data is re-fetched from the server,
1567 * and the iterable is recreated and re-rendered, but most of the data is still the same).
1568 *
1569 * @see `TrackByFunction`
1570 */
1571 set ngForTrackBy(fn: TrackByFunction<T>);
1572 get ngForTrackBy(): TrackByFunction<T>;
1573 private _ngForOf;
1574 private _ngForOfDirty;
1575 private _differ;
1576 private _trackByFn;
1577 constructor(_viewContainer: ViewContainerRef, _template: TemplateRef<NgForOfContext<T, U>>, _differs: IterableDiffers);
1578 /**
1579 * A reference to the template that is stamped out for each item in the iterable.
1580 * @see [template reference variable](guide/template-reference-variables)
1581 */
1582 set ngForTemplate(value: TemplateRef<NgForOfContext<T, U>>);
1583 /**
1584 * Applies the changes when needed.
1585 */
1586 ngDoCheck(): void;
1587 private _applyChanges;
1588 private _perViewChange;
1589 /**
1590 * Asserts the correct type of the context for the template that `NgForOf` will render.
1591 *
1592 * The presence of this method is a signal to the Ivy template type-check compiler that the
1593 * `NgForOf` structural directive renders its template with a specific context type.
1594 */
1595 static ngTemplateContextGuard<T, U extends NgIterable<T>>(dir: NgForOf<T, U>, ctx: any): ctx is NgForOfContext<T, U>;
1596 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgForOf<any, any>, never>;
1597 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgForOf<any, any>, "[ngFor][ngForOf]", never, { "ngForOf": "ngForOf"; "ngForTrackBy": "ngForTrackBy"; "ngForTemplate": "ngForTemplate"; }, {}, never>;
1598}
1599
1600/**
1601 * @publicApi
1602 */
1603export declare class NgForOfContext<T, U extends NgIterable<T> = NgIterable<T>> {
1604 $implicit: T;
1605 ngForOf: U;
1606 index: number;
1607 count: number;
1608 constructor($implicit: T, ngForOf: U, index: number, count: number);
1609 get first(): boolean;
1610 get last(): boolean;
1611 get even(): boolean;
1612 get odd(): boolean;
1613}
1614
1615/**
1616 * A structural directive that conditionally includes a template based on the value of
1617 * an expression coerced to Boolean.
1618 * When the expression evaluates to true, Angular renders the template
1619 * provided in a `then` clause, and when false or null,
1620 * Angular renders the template provided in an optional `else` clause. The default
1621 * template for the `else` clause is blank.
1622 *
1623 * A [shorthand form](guide/structural-directives#asterisk) of the directive,
1624 * `*ngIf="condition"`, is generally used, provided
1625 * as an attribute of the anchor element for the inserted template.
1626 * Angular expands this into a more explicit version, in which the anchor element
1627 * is contained in an `<ng-template>` element.
1628 *
1629 * Simple form with shorthand syntax:
1630 *
1631 * ```
1632 * <div *ngIf="condition">Content to render when condition is true.</div>
1633 * ```
1634 *
1635 * Simple form with expanded syntax:
1636 *
1637 * ```
1638 * <ng-template [ngIf]="condition"><div>Content to render when condition is
1639 * true.</div></ng-template>
1640 * ```
1641 *
1642 * Form with an "else" block:
1643 *
1644 * ```
1645 * <div *ngIf="condition; else elseBlock">Content to render when condition is true.</div>
1646 * <ng-template #elseBlock>Content to render when condition is false.</ng-template>
1647 * ```
1648 *
1649 * Shorthand form with "then" and "else" blocks:
1650 *
1651 * ```
1652 * <div *ngIf="condition; then thenBlock else elseBlock"></div>
1653 * <ng-template #thenBlock>Content to render when condition is true.</ng-template>
1654 * <ng-template #elseBlock>Content to render when condition is false.</ng-template>
1655 * ```
1656 *
1657 * Form with storing the value locally:
1658 *
1659 * ```
1660 * <div *ngIf="condition as value; else elseBlock">{{value}}</div>
1661 * <ng-template #elseBlock>Content to render when value is null.</ng-template>
1662 * ```
1663 *
1664 * @usageNotes
1665 *
1666 * The `*ngIf` directive is most commonly used to conditionally show an inline template,
1667 * as seen in the following example.
1668 * The default `else` template is blank.
1669 *
1670 * {@example common/ngIf/ts/module.ts region='NgIfSimple'}
1671 *
1672 * ### Showing an alternative template using `else`
1673 *
1674 * To display a template when `expression` evaluates to false, use an `else` template
1675 * binding as shown in the following example.
1676 * The `else` binding points to an `<ng-template>` element labeled `#elseBlock`.
1677 * The template can be defined anywhere in the component view, but is typically placed right after
1678 * `ngIf` for readability.
1679 *
1680 * {@example common/ngIf/ts/module.ts region='NgIfElse'}
1681 *
1682 * ### Using an external `then` template
1683 *
1684 * In the previous example, the then-clause template is specified inline, as the content of the
1685 * tag that contains the `ngIf` directive. You can also specify a template that is defined
1686 * externally, by referencing a labeled `<ng-template>` element. When you do this, you can
1687 * change which template to use at runtime, as shown in the following example.
1688 *
1689 * {@example common/ngIf/ts/module.ts region='NgIfThenElse'}
1690 *
1691 * ### Storing a conditional result in a variable
1692 *
1693 * You might want to show a set of properties from the same object. If you are waiting
1694 * for asynchronous data, the object can be undefined.
1695 * In this case, you can use `ngIf` and store the result of the condition in a local
1696 * variable as shown in the following example.
1697 *
1698 * {@example common/ngIf/ts/module.ts region='NgIfAs'}
1699 *
1700 * This code uses only one `AsyncPipe`, so only one subscription is created.
1701 * The conditional statement stores the result of `userStream|async` in the local variable `user`.
1702 * You can then bind the local `user` repeatedly.
1703 *
1704 * The conditional displays the data only if `userStream` returns a value,
1705 * so you don't need to use the
1706 * safe-navigation-operator (`?.`)
1707 * to guard against null values when accessing properties.
1708 * You can display an alternative template while waiting for the data.
1709 *
1710 * ### Shorthand syntax
1711 *
1712 * The shorthand syntax `*ngIf` expands into two separate template specifications
1713 * for the "then" and "else" clauses. For example, consider the following shorthand statement,
1714 * that is meant to show a loading page while waiting for data to be loaded.
1715 *
1716 * ```
1717 * <div class="hero-list" *ngIf="heroes else loading">
1718 * ...
1719 * </div>
1720 *
1721 * <ng-template #loading>
1722 * <div>Loading...</div>
1723 * </ng-template>
1724 * ```
1725 *
1726 * You can see that the "else" clause references the `<ng-template>`
1727 * with the `#loading` label, and the template for the "then" clause
1728 * is provided as the content of the anchor element.
1729 *
1730 * However, when Angular expands the shorthand syntax, it creates
1731 * another `<ng-template>` tag, with `ngIf` and `ngIfElse` directives.
1732 * The anchor element containing the template for the "then" clause becomes
1733 * the content of this unlabeled `<ng-template>` tag.
1734 *
1735 * ```
1736 * <ng-template [ngIf]="heroes" [ngIfElse]="loading">
1737 * <div class="hero-list">
1738 * ...
1739 * </div>
1740 * </ng-template>
1741 *
1742 * <ng-template #loading>
1743 * <div>Loading...</div>
1744 * </ng-template>
1745 * ```
1746 *
1747 * The presence of the implicit template object has implications for the nesting of
1748 * structural directives. For more on this subject, see
1749 * [Structural Directives](https://angular.io/guide/built-in-directives#one-per-element).
1750 *
1751 * @ngModule CommonModule
1752 * @publicApi
1753 */
1754export declare class NgIf<T = unknown> {
1755 private _viewContainer;
1756 private _context;
1757 private _thenTemplateRef;
1758 private _elseTemplateRef;
1759 private _thenViewRef;
1760 private _elseViewRef;
1761 constructor(_viewContainer: ViewContainerRef, templateRef: TemplateRef<NgIfContext<T>>);
1762 /**
1763 * The Boolean expression to evaluate as the condition for showing a template.
1764 */
1765 set ngIf(condition: T);
1766 /**
1767 * A template to show if the condition expression evaluates to true.
1768 */
1769 set ngIfThen(templateRef: TemplateRef<NgIfContext<T>> | null);
1770 /**
1771 * A template to show if the condition expression evaluates to false.
1772 */
1773 set ngIfElse(templateRef: TemplateRef<NgIfContext<T>> | null);
1774 private _updateView;
1775 /**
1776 * Assert the correct type of the expression bound to the `ngIf` input within the template.
1777 *
1778 * The presence of this static field is a signal to the Ivy template type check compiler that
1779 * when the `NgIf` structural directive renders its template, the type of the expression bound
1780 * to `ngIf` should be narrowed in some way. For `NgIf`, the binding expression itself is used to
1781 * narrow its type, which allows the strictNullChecks feature of TypeScript to work with `NgIf`.
1782 */
1783 static ngTemplateGuard_ngIf: 'binding';
1784 /**
1785 * Asserts the correct type of the context for the template that `NgIf` will render.
1786 *
1787 * The presence of this method is a signal to the Ivy template type-check compiler that the
1788 * `NgIf` structural directive renders its template with a specific context type.
1789 */
1790 static ngTemplateContextGuard<T>(dir: NgIf<T>, ctx: any): ctx is NgIfContext<Exclude<T, false | 0 | '' | null | undefined>>;
1791 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgIf<any>, never>;
1792 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgIf<any>, "[ngIf]", never, { "ngIf": "ngIf"; "ngIfThen": "ngIfThen"; "ngIfElse": "ngIfElse"; }, {}, never>;
1793}
1794
1795/**
1796 * @publicApi
1797 */
1798export declare class NgIfContext<T = unknown> {
1799 $implicit: T;
1800 ngIf: T;
1801}
1802
1803/**
1804 * Returns the plural case based on the locale
1805 *
1806 * @publicApi
1807 */
1808export declare class NgLocaleLocalization extends NgLocalization {
1809 protected locale: string;
1810 constructor(locale: string);
1811 getPluralCategory(value: any, locale?: string): string;
1812 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgLocaleLocalization, never>;
1813 static ɵprov: ɵngcc0.ɵɵInjectableDeclaration<NgLocaleLocalization>;
1814}
1815
1816
1817/**
1818 * @publicApi
1819 */
1820export declare abstract class NgLocalization {
1821 abstract getPluralCategory(value: any, locale?: string): string;
1822}
1823
1824/**
1825 * @ngModule CommonModule
1826 *
1827 * @usageNotes
1828 * ```
1829 * <some-element [ngPlural]="value">
1830 * <ng-template ngPluralCase="=0">there is nothing</ng-template>
1831 * <ng-template ngPluralCase="=1">there is one</ng-template>
1832 * <ng-template ngPluralCase="few">there are a few</ng-template>
1833 * </some-element>
1834 * ```
1835 *
1836 * @description
1837 *
1838 * Adds / removes DOM sub-trees based on a numeric value. Tailored for pluralization.
1839 *
1840 * Displays DOM sub-trees that match the switch expression value, or failing that, DOM sub-trees
1841 * that match the switch expression's pluralization category.
1842 *
1843 * To use this directive you must provide a container element that sets the `[ngPlural]` attribute
1844 * to a switch expression. Inner elements with a `[ngPluralCase]` will display based on their
1845 * expression:
1846 * - if `[ngPluralCase]` is set to a value starting with `=`, it will only display if the value
1847 * matches the switch expression exactly,
1848 * - otherwise, the view will be treated as a "category match", and will only display if exact
1849 * value matches aren't found and the value maps to its category for the defined locale.
1850 *
1851 * See http://cldr.unicode.org/index/cldr-spec/plural-rules
1852 *
1853 * @publicApi
1854 */
1855export declare class NgPlural {
1856 private _localization;
1857 private _switchValue;
1858 private _activeView;
1859 private _caseViews;
1860 constructor(_localization: NgLocalization);
1861 set ngPlural(value: number);
1862 addCase(value: string, switchView: SwitchView): void;
1863 private _updateView;
1864 private _clearViews;
1865 private _activateView;
1866 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgPlural, never>;
1867 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgPlural, "[ngPlural]", never, { "ngPlural": "ngPlural"; }, {}, never>;
1868}
1869
1870/**
1871 * @ngModule CommonModule
1872 *
1873 * @description
1874 *
1875 * Creates a view that will be added/removed from the parent {@link NgPlural} when the
1876 * given expression matches the plural expression according to CLDR rules.
1877 *
1878 * @usageNotes
1879 * ```
1880 * <some-element [ngPlural]="value">
1881 * <ng-template ngPluralCase="=0">...</ng-template>
1882 * <ng-template ngPluralCase="other">...</ng-template>
1883 * </some-element>
1884 *```
1885 *
1886 * See {@link NgPlural} for more details and example.
1887 *
1888 * @publicApi
1889 */
1890export declare class NgPluralCase {
1891 value: string;
1892 constructor(value: string, template: TemplateRef<Object>, viewContainer: ViewContainerRef, ngPlural: NgPlural);
1893 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgPluralCase, [{ attribute: "ngPluralCase"; }, null, null, { host: true; }]>;
1894 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgPluralCase, "[ngPluralCase]", never, {}, {}, never>;
1895}
1896
1897/**
1898 * @ngModule CommonModule
1899 *
1900 * @usageNotes
1901 *
1902 * Set the font of the containing element to the result of an expression.
1903 *
1904 * ```
1905 * <some-element [ngStyle]="{'font-style': styleExp}">...</some-element>
1906 * ```
1907 *
1908 * Set the width of the containing element to a pixel value returned by an expression.
1909 *
1910 * ```
1911 * <some-element [ngStyle]="{'max-width.px': widthExp}">...</some-element>
1912 * ```
1913 *
1914 * Set a collection of style values using an expression that returns key-value pairs.
1915 *
1916 * ```
1917 * <some-element [ngStyle]="objExp">...</some-element>
1918 * ```
1919 *
1920 * @description
1921 *
1922 * An attribute directive that updates styles for the containing HTML element.
1923 * Sets one or more style properties, specified as colon-separated key-value pairs.
1924 * The key is a style name, with an optional `.<unit>` suffix
1925 * (such as 'top.px', 'font-style.em').
1926 * The value is an expression to be evaluated.
1927 * The resulting non-null value, expressed in the given unit,
1928 * is assigned to the given style property.
1929 * If the result of evaluation is null, the corresponding style is removed.
1930 *
1931 * @publicApi
1932 */
1933export declare class NgStyle implements DoCheck {
1934 private _ngEl;
1935 private _differs;
1936 private _renderer;
1937 private _ngStyle;
1938 private _differ;
1939 constructor(_ngEl: ElementRef, _differs: KeyValueDiffers, _renderer: Renderer2);
1940 set ngStyle(values: {
1941 [klass: string]: any;
1942 } | null);
1943 ngDoCheck(): void;
1944 private _setStyle;
1945 private _applyChanges;
1946 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgStyle, never>;
1947 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgStyle, "[ngStyle]", never, { "ngStyle": "ngStyle"; }, {}, never>;
1948}
1949
1950/**
1951 * @ngModule CommonModule
1952 *
1953 * @description
1954 * The `[ngSwitch]` directive on a container specifies an expression to match against.
1955 * The expressions to match are provided by `ngSwitchCase` directives on views within the container.
1956 * - Every view that matches is rendered.
1957 * - If there are no matches, a view with the `ngSwitchDefault` directive is rendered.
1958 * - Elements within the `[NgSwitch]` statement but outside of any `NgSwitchCase`
1959 * or `ngSwitchDefault` directive are preserved at the location.
1960 *
1961 * @usageNotes
1962 * Define a container element for the directive, and specify the switch expression
1963 * to match against as an attribute:
1964 *
1965 * ```
1966 * <container-element [ngSwitch]="switch_expression">
1967 * ```
1968 *
1969 * Within the container, `*ngSwitchCase` statements specify the match expressions
1970 * as attributes. Include `*ngSwitchDefault` as the final case.
1971 *
1972 * ```
1973 * <container-element [ngSwitch]="switch_expression">
1974 * <some-element *ngSwitchCase="match_expression_1">...</some-element>
1975 * ...
1976 * <some-element *ngSwitchDefault>...</some-element>
1977 * </container-element>
1978 * ```
1979 *
1980 * ### Usage Examples
1981 *
1982 * The following example shows how to use more than one case to display the same view:
1983 *
1984 * ```
1985 * <container-element [ngSwitch]="switch_expression">
1986 * <!-- the same view can be shown in more than one case -->
1987 * <some-element *ngSwitchCase="match_expression_1">...</some-element>
1988 * <some-element *ngSwitchCase="match_expression_2">...</some-element>
1989 * <some-other-element *ngSwitchCase="match_expression_3">...</some-other-element>
1990 * <!--default case when there are no matches -->
1991 * <some-element *ngSwitchDefault>...</some-element>
1992 * </container-element>
1993 * ```
1994 *
1995 * The following example shows how cases can be nested:
1996 * ```
1997 * <container-element [ngSwitch]="switch_expression">
1998 * <some-element *ngSwitchCase="match_expression_1">...</some-element>
1999 * <some-element *ngSwitchCase="match_expression_2">...</some-element>
2000 * <some-other-element *ngSwitchCase="match_expression_3">...</some-other-element>
2001 * <ng-container *ngSwitchCase="match_expression_3">
2002 * <!-- use a ng-container to group multiple root nodes -->
2003 * <inner-element></inner-element>
2004 * <inner-other-element></inner-other-element>
2005 * </ng-container>
2006 * <some-element *ngSwitchDefault>...</some-element>
2007 * </container-element>
2008 * ```
2009 *
2010 * @publicApi
2011 * @see `NgSwitchCase`
2012 * @see `NgSwitchDefault`
2013 * @see [Structural Directives](guide/structural-directives)
2014 *
2015 */
2016export declare class NgSwitch {
2017 private _defaultViews;
2018 private _defaultUsed;
2019 private _caseCount;
2020 private _lastCaseCheckIndex;
2021 private _lastCasesMatched;
2022 private _ngSwitch;
2023 set ngSwitch(newValue: any);
2024 private _updateDefaultCases;
2025 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgSwitch, never>;
2026 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgSwitch, "[ngSwitch]", never, { "ngSwitch": "ngSwitch"; }, {}, never>;
2027}
2028
2029/**
2030 * @ngModule CommonModule
2031 *
2032 * @description
2033 * Provides a switch case expression to match against an enclosing `ngSwitch` expression.
2034 * When the expressions match, the given `NgSwitchCase` template is rendered.
2035 * If multiple match expressions match the switch expression value, all of them are displayed.
2036 *
2037 * @usageNotes
2038 *
2039 * Within a switch container, `*ngSwitchCase` statements specify the match expressions
2040 * as attributes. Include `*ngSwitchDefault` as the final case.
2041 *
2042 * ```
2043 * <container-element [ngSwitch]="switch_expression">
2044 * <some-element *ngSwitchCase="match_expression_1">...</some-element>
2045 * ...
2046 * <some-element *ngSwitchDefault>...</some-element>
2047 * </container-element>
2048 * ```
2049 *
2050 * Each switch-case statement contains an in-line HTML template or template reference
2051 * that defines the subtree to be selected if the value of the match expression
2052 * matches the value of the switch expression.
2053 *
2054 * Unlike JavaScript, which uses strict equality, Angular uses loose equality.
2055 * This means that the empty string, `""` matches 0.
2056 *
2057 * @publicApi
2058 * @see `NgSwitch`
2059 * @see `NgSwitchDefault`
2060 *
2061 */
2062export declare class NgSwitchCase implements DoCheck {
2063 private ngSwitch;
2064 private _view;
2065 /**
2066 * Stores the HTML template to be selected on match.
2067 */
2068 ngSwitchCase: any;
2069 constructor(viewContainer: ViewContainerRef, templateRef: TemplateRef<Object>, ngSwitch: NgSwitch);
2070 /**
2071 * Performs case matching. For internal use only.
2072 */
2073 ngDoCheck(): void;
2074 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgSwitchCase, [null, null, { optional: true; host: true; }]>;
2075 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgSwitchCase, "[ngSwitchCase]", never, { "ngSwitchCase": "ngSwitchCase"; }, {}, never>;
2076}
2077
2078/**
2079 * @ngModule CommonModule
2080 *
2081 * @description
2082 *
2083 * Creates a view that is rendered when no `NgSwitchCase` expressions
2084 * match the `NgSwitch` expression.
2085 * This statement should be the final case in an `NgSwitch`.
2086 *
2087 * @publicApi
2088 * @see `NgSwitch`
2089 * @see `NgSwitchCase`
2090 *
2091 */
2092export declare class NgSwitchDefault {
2093 constructor(viewContainer: ViewContainerRef, templateRef: TemplateRef<Object>, ngSwitch: NgSwitch);
2094 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgSwitchDefault, [null, null, { optional: true; host: true; }]>;
2095 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgSwitchDefault, "[ngSwitchDefault]", never, {}, {}, never>;
2096}
2097
2098/**
2099 * @ngModule CommonModule
2100 *
2101 * @description
2102 *
2103 * Inserts an embedded view from a prepared `TemplateRef`.
2104 *
2105 * You can attach a context object to the `EmbeddedViewRef` by setting `[ngTemplateOutletContext]`.
2106 * `[ngTemplateOutletContext]` should be an object, the object's keys will be available for binding
2107 * by the local template `let` declarations.
2108 *
2109 * @usageNotes
2110 * ```
2111 * <ng-container *ngTemplateOutlet="templateRefExp; context: contextExp"></ng-container>
2112 * ```
2113 *
2114 * Using the key `$implicit` in the context object will set its value as default.
2115 *
2116 * ### Example
2117 *
2118 * {@example common/ngTemplateOutlet/ts/module.ts region='NgTemplateOutlet'}
2119 *
2120 * @publicApi
2121 */
2122export declare class NgTemplateOutlet implements OnChanges {
2123 private _viewContainerRef;
2124 private _viewRef;
2125 /**
2126 * A context object to attach to the {@link EmbeddedViewRef}. This should be an
2127 * object, the object's keys will be available for binding by the local template `let`
2128 * declarations.
2129 * Using the key `$implicit` in the context object will set its value as default.
2130 */
2131 ngTemplateOutletContext: Object | null;
2132 /**
2133 * A string defining the template reference and optionally the context object for the template.
2134 */
2135 ngTemplateOutlet: TemplateRef<any> | null;
2136 constructor(_viewContainerRef: ViewContainerRef);
2137 ngOnChanges(changes: SimpleChanges): void;
2138 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<NgTemplateOutlet, never>;
2139 static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<NgTemplateOutlet, "[ngTemplateOutlet]", never, { "ngTemplateOutletContext": "ngTemplateOutletContext"; "ngTemplateOutlet": "ngTemplateOutlet"; }, {}, never>;
2140}
2141
2142
2143/**
2144 * Format styles that can be used to represent numbers.
2145 * @see `getLocaleNumberFormat()`.
2146 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
2147 *
2148 * @publicApi
2149 */
2150export declare enum NumberFormatStyle {
2151 Decimal = 0,
2152 Percent = 1,
2153 Currency = 2,
2154 Scientific = 3
2155}
2156
2157/**
2158 * Symbols that can be used to replace placeholders in number patterns.
2159 * Examples are based on `en-US` values.
2160 *
2161 * @see `getLocaleNumberSymbol()`
2162 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
2163 *
2164 * @publicApi
2165 */
2166export declare enum NumberSymbol {
2167 /**
2168 * Decimal separator.
2169 * For `en-US`, the dot character.
2170 * Example: 2,345`.`67
2171 */
2172 Decimal = 0,
2173 /**
2174 * Grouping separator, typically for thousands.
2175 * For `en-US`, the comma character.
2176 * Example: 2`,`345.67
2177 */
2178 Group = 1,
2179 /**
2180 * List-item separator.
2181 * Example: "one, two, and three"
2182 */
2183 List = 2,
2184 /**
2185 * Sign for percentage (out of 100).
2186 * Example: 23.4%
2187 */
2188 PercentSign = 3,
2189 /**
2190 * Sign for positive numbers.
2191 * Example: +23
2192 */
2193 PlusSign = 4,
2194 /**
2195 * Sign for negative numbers.
2196 * Example: -23
2197 */
2198 MinusSign = 5,
2199 /**
2200 * Computer notation for exponential value (n times a power of 10).
2201 * Example: 1.2E3
2202 */
2203 Exponential = 6,
2204 /**
2205 * Human-readable format of exponential.
2206 * Example: 1.2x103
2207 */
2208 SuperscriptingExponent = 7,
2209 /**
2210 * Sign for permille (out of 1000).
2211 * Example: 23.4‰
2212 */
2213 PerMille = 8,
2214 /**
2215 * Infinity, can be used with plus and minus.
2216 * Example: ∞, +∞, -∞
2217 */
2218 Infinity = 9,
2219 /**
2220 * Not a number.
2221 * Example: NaN
2222 */
2223 NaN = 10,
2224 /**
2225 * Symbol used between time units.
2226 * Example: 10:52
2227 */
2228 TimeSeparator = 11,
2229 /**
2230 * Decimal separator for currency values (fallback to `Decimal`).
2231 * Example: $2,345.67
2232 */
2233 CurrencyDecimal = 12,
2234 /**
2235 * Group separator for currency values (fallback to `Group`).
2236 * Example: $2,345.67
2237 */
2238 CurrencyGroup = 13
2239}
2240
2241/**
2242 * @description
2243 * A {@link LocationStrategy} used to configure the {@link Location} service to
2244 * represent its state in the
2245 * [path](https://en.wikipedia.org/wiki/Uniform_Resource_Locator#Syntax) of the
2246 * browser's URL.
2247 *
2248 * If you're using `PathLocationStrategy`, you must provide a {@link APP_BASE_HREF}
2249 * or add a `<base href>` element to the document.
2250 *
2251 * For instance, if you provide an `APP_BASE_HREF` of `'/my/app/'` and call
2252 * `location.go('/foo')`, the browser's URL will become
2253 * `example.com/my/app/foo`. To ensure all relative URIs resolve correctly,
2254 * the `<base href>` and/or `APP_BASE_HREF` should end with a `/`.
2255 *
2256 * Similarly, if you add `<base href='/my/app/'/>` to the document and call
2257 * `location.go('/foo')`, the browser's URL will become
2258 * `example.com/my/app/foo`.
2259 *
2260 * Note that when using `PathLocationStrategy`, neither the query nor
2261 * the fragment in the `<base href>` will be preserved, as outlined
2262 * by the [RFC](https://tools.ietf.org/html/rfc3986#section-5.2.2).
2263 *
2264 * @usageNotes
2265 *
2266 * ### Example
2267 *
2268 * {@example common/location/ts/path_location_component.ts region='LocationComponent'}
2269 *
2270 * @publicApi
2271 */
2272export declare class PathLocationStrategy extends LocationStrategy implements OnDestroy {
2273 private _platformLocation;
2274 private _baseHref;
2275 private _removeListenerFns;
2276 constructor(_platformLocation: PlatformLocation, href?: string);
2277 ngOnDestroy(): void;
2278 onPopState(fn: LocationChangeListener): void;
2279 getBaseHref(): string;
2280 prepareExternalUrl(internal: string): string;
2281 path(includeHash?: boolean): string;
2282 pushState(state: any, title: string, url: string, queryParams: string): void;
2283 replaceState(state: any, title: string, url: string, queryParams: string): void;
2284 forward(): void;
2285 back(): void;
2286 historyGo(relativePosition?: number): void;
2287 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<PathLocationStrategy, [null, { optional: true; }]>;
2288 static ɵprov: ɵngcc0.ɵɵInjectableDeclaration<PathLocationStrategy>;
2289}
2290
2291/**
2292 * @ngModule CommonModule
2293 * @description
2294 *
2295 * Transforms a number to a percentage
2296 * string, formatted according to locale rules that determine group sizing and
2297 * separator, decimal-point character, and other locale-specific
2298 * configurations.
2299 *
2300 * @see `formatPercent()`
2301 *
2302 * @usageNotes
2303 * The following code shows how the pipe transforms numbers
2304 * into text strings, according to various format specifications,
2305 * where the caller's default locale is `en-US`.
2306 *
2307 * <code-example path="common/pipes/ts/percent_pipe.ts" region='PercentPipe'></code-example>
2308 *
2309 * @publicApi
2310 */
2311export declare class PercentPipe implements PipeTransform {
2312 private _locale;
2313 constructor(_locale: string);
2314 transform(value: number | string, digitsInfo?: string, locale?: string): string | null;
2315 transform(value: null | undefined, digitsInfo?: string, locale?: string): null;
2316 transform(value: number | string | null | undefined, digitsInfo?: string, locale?: string): string | null;
2317 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<PercentPipe, never>;
2318 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<PercentPipe, "percent">;
2319}
2320
2321/**
2322 * This class should not be used directly by an application developer. Instead, use
2323 * {@link Location}.
2324 *
2325 * `PlatformLocation` encapsulates all calls to DOM APIs, which allows the Router to be
2326 * platform-agnostic.
2327 * This means that we can have different implementation of `PlatformLocation` for the different
2328 * platforms that Angular supports. For example, `@angular/platform-browser` provides an
2329 * implementation specific to the browser environment, while `@angular/platform-server` provides
2330 * one suitable for use with server-side rendering.
2331 *
2332 * The `PlatformLocation` class is used directly by all implementations of {@link LocationStrategy}
2333 * when they need to interact with the DOM APIs like pushState, popState, etc.
2334 *
2335 * {@link LocationStrategy} in turn is used by the {@link Location} service which is used directly
2336 * by the {@link Router} in order to navigate between routes. Since all interactions between {@link
2337 * Router} /
2338 * {@link Location} / {@link LocationStrategy} and DOM APIs flow through the `PlatformLocation`
2339 * class, they are all platform-agnostic.
2340 *
2341 * @publicApi
2342 */
2343export declare abstract class PlatformLocation {
2344 abstract getBaseHrefFromDOM(): string;
2345 abstract getState(): unknown;
2346 /**
2347 * Returns a function that, when executed, removes the `popstate` event handler.
2348 */
2349 abstract onPopState(fn: LocationChangeListener): VoidFunction;
2350 /**
2351 * Returns a function that, when executed, removes the `hashchange` event handler.
2352 */
2353 abstract onHashChange(fn: LocationChangeListener): VoidFunction;
2354 abstract get href(): string;
2355 abstract get protocol(): string;
2356 abstract get hostname(): string;
2357 abstract get port(): string;
2358 abstract get pathname(): string;
2359 abstract get search(): string;
2360 abstract get hash(): string;
2361 abstract replaceState(state: any, title: string, url: string): void;
2362 abstract pushState(state: any, title: string, url: string): void;
2363 abstract forward(): void;
2364 abstract back(): void;
2365 historyGo?(relativePosition: number): void;
2366 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<PlatformLocation, never>;
2367}
2368
2369/**
2370 * Plurality cases used for translating plurals to different languages.
2371 *
2372 * @see `NgPlural`
2373 * @see `NgPluralCase`
2374 * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
2375 *
2376 * @publicApi
2377 */
2378export declare enum Plural {
2379 Zero = 0,
2380 One = 1,
2381 Two = 2,
2382 Few = 3,
2383 Many = 4,
2384 Other = 5
2385}
2386
2387/** @publicApi */
2388declare interface PopStateEvent_2 {
2389 pop?: boolean;
2390 state?: any;
2391 type?: string;
2392 url?: string;
2393}
2394export { PopStateEvent_2 as PopStateEvent }
2395
2396
2397/**
2398 * Register global data to be used internally by Angular. See the
2399 * ["I18n guide"](guide/i18n-common-format-data-locale) to know how to import additional locale
2400 * data.
2401 *
2402 * The signature registerLocaleData(data: any, extraData?: any) is deprecated since v5.1
2403 *
2404 * @publicApi
2405 */
2406export declare function registerLocaleData(data: any, localeId?: string | any, extraData?: any): void;
2407
2408/**
2409 * @ngModule CommonModule
2410 * @description
2411 *
2412 * Creates a new `Array` or `String` containing a subset (slice) of the elements.
2413 *
2414 * @usageNotes
2415 *
2416 * All behavior is based on the expected behavior of the JavaScript API `Array.prototype.slice()`
2417 * and `String.prototype.slice()`.
2418 *
2419 * When operating on an `Array`, the returned `Array` is always a copy even when all
2420 * the elements are being returned.
2421 *
2422 * When operating on a blank value, the pipe returns the blank value.
2423 *
2424 * ### List Example
2425 *
2426 * This `ngFor` example:
2427 *
2428 * {@example common/pipes/ts/slice_pipe.ts region='SlicePipe_list'}
2429 *
2430 * produces the following:
2431 *
2432 * ```html
2433 * <li>b</li>
2434 * <li>c</li>
2435 * ```
2436 *
2437 * ### String Examples
2438 *
2439 * {@example common/pipes/ts/slice_pipe.ts region='SlicePipe_string'}
2440 *
2441 * @publicApi
2442 */
2443export declare class SlicePipe implements PipeTransform {
2444 /**
2445 * @param value a list or a string to be sliced.
2446 * @param start the starting index of the subset to return:
2447 * - **a positive integer**: return the item at `start` index and all items after
2448 * in the list or string expression.
2449 * - **a negative integer**: return the item at `start` index from the end and all items after
2450 * in the list or string expression.
2451 * - **if positive and greater than the size of the expression**: return an empty list or
2452 * string.
2453 * - **if negative and greater than the size of the expression**: return entire list or string.
2454 * @param end the ending index of the subset to return:
2455 * - **omitted**: return all items until the end.
2456 * - **if positive**: return all items before `end` index of the list or string.
2457 * - **if negative**: return all items before `end` index from the end of the list or string.
2458 */
2459 transform<T>(value: ReadonlyArray<T>, start: number, end?: number): Array<T>;
2460 transform(value: null | undefined, start: number, end?: number): null;
2461 transform<T>(value: ReadonlyArray<T> | null | undefined, start: number, end?: number): Array<T> | null;
2462 transform(value: string, start: number, end?: number): string;
2463 transform(value: string | null | undefined, start: number, end?: number): string | null;
2464 private supports;
2465 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<SlicePipe, never>;
2466 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<SlicePipe, "slice">;
2467}
2468
2469declare class SwitchView {
2470 private _viewContainerRef;
2471 private _templateRef;
2472 private _created;
2473 constructor(_viewContainerRef: ViewContainerRef, _templateRef: TemplateRef<Object>);
2474 create(): void;
2475 destroy(): void;
2476 enforceState(created: boolean): void;
2477}
2478
2479/**
2480 * Represents a time value with hours and minutes.
2481 *
2482 * @publicApi
2483 */
2484export declare type Time = {
2485 hours: number;
2486 minutes: number;
2487};
2488
2489/**
2490 * Transforms text to title case.
2491 * Capitalizes the first letter of each word and transforms the
2492 * rest of the word to lower case.
2493 * Words are delimited by any whitespace character, such as a space, tab, or line-feed character.
2494 *
2495 * @see `LowerCasePipe`
2496 * @see `UpperCasePipe`
2497 *
2498 * @usageNotes
2499 * The following example shows the result of transforming various strings into title case.
2500 *
2501 * <code-example path="common/pipes/ts/titlecase_pipe.ts" region='TitleCasePipe'></code-example>
2502 *
2503 * @ngModule CommonModule
2504 * @publicApi
2505 */
2506export declare class TitleCasePipe implements PipeTransform {
2507 /**
2508 * @param value The string to transform to title case.
2509 */
2510 transform(value: string): string;
2511 transform(value: null | undefined): null;
2512 transform(value: string | null | undefined): string | null;
2513 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<TitleCasePipe, never>;
2514 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<TitleCasePipe, "titlecase">;
2515}
2516
2517/**
2518 * String widths available for translations.
2519 * The specific character widths are locale-specific.
2520 * Examples are given for the word "Sunday" in English.
2521 *
2522 * @publicApi
2523 */
2524export declare enum TranslationWidth {
2525 /** 1 character for `en-US`. For example: 'S' */
2526 Narrow = 0,
2527 /** 3 characters for `en-US`. For example: 'Sun' */
2528 Abbreviated = 1,
2529 /** Full length for `en-US`. For example: "Sunday" */
2530 Wide = 2,
2531 /** 2 characters for `en-US`, For example: "Su" */
2532 Short = 3
2533}
2534
2535/**
2536 * Transforms text to all upper case.
2537 * @see `LowerCasePipe`
2538 * @see `TitleCasePipe`
2539 *
2540 * @ngModule CommonModule
2541 * @publicApi
2542 */
2543export declare class UpperCasePipe implements PipeTransform {
2544 /**
2545 * @param value The string to transform to upper case.
2546 */
2547 transform(value: string): string;
2548 transform(value: null | undefined): null;
2549 transform(value: string | null | undefined): string | null;
2550 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<UpperCasePipe, never>;
2551 static ɵpipe: ɵngcc0.ɵɵPipeDeclaration<UpperCasePipe, "uppercase">;
2552}
2553
2554/**
2555 * @publicApi
2556 */
2557export declare const VERSION: Version;
2558
2559
2560/**
2561 * Defines a scroll position manager. Implemented by `BrowserViewportScroller`.
2562 *
2563 * @publicApi
2564 */
2565export declare abstract class ViewportScroller {
2566 /** @nocollapse */
2567 static ɵprov: unknown;
2568 /**
2569 * Configures the top offset used when scrolling to an anchor.
2570 * @param offset A position in screen coordinates (a tuple with x and y values)
2571 * or a function that returns the top offset position.
2572 *
2573 */
2574 abstract setOffset(offset: [number, number] | (() => [number, number])): void;
2575 /**
2576 * Retrieves the current scroll position.
2577 * @returns A position in screen coordinates (a tuple with x and y values).
2578 */
2579 abstract getScrollPosition(): [number, number];
2580 /**
2581 * Scrolls to a specified position.
2582 * @param position A position in screen coordinates (a tuple with x and y values).
2583 */
2584 abstract scrollToPosition(position: [number, number]): void;
2585 /**
2586 * Scrolls to an anchor element.
2587 * @param anchor The ID of the anchor element.
2588 */
2589 abstract scrollToAnchor(anchor: string): void;
2590 /**
2591 * Disables automatic scroll restoration provided by the browser.
2592 * See also [window.history.scrollRestoration
2593 * info](https://developers.google.com/web/updates/2015/09/history-api-scroll-restoration).
2594 */
2595 abstract setHistoryScrollRestoration(scrollRestoration: 'auto' | 'manual'): void;
2596}
2597
2598/**
2599 * The value for each day of the week, based on the `en-US` locale
2600 *
2601 * @publicApi
2602 */
2603export declare enum WeekDay {
2604 Sunday = 0,
2605 Monday = 1,
2606 Tuesday = 2,
2607 Wednesday = 3,
2608 Thursday = 4,
2609 Friday = 5,
2610 Saturday = 6
2611}
2612
2613
2614/**
2615 * A wrapper around the `XMLHttpRequest` constructor.
2616 *
2617 * @publicApi
2618 */
2619export declare abstract class XhrFactory {
2620 abstract build(): XMLHttpRequest;
2621}
2622
2623export declare function ɵangular_packages_common_common_a(): ɵBrowserPlatformLocation;
2624
2625export declare function ɵangular_packages_common_common_b(): ɵBrowserPlatformLocation;
2626
2627export declare function ɵangular_packages_common_common_c(): Location_2;
2628
2629export declare function ɵangular_packages_common_common_d(platformLocation: PlatformLocation): PathLocationStrategy;
2630
2631/**
2632 * A collection of Angular directives that are likely to be used in each and every Angular
2633 * application.
2634 */
2635export declare const ɵangular_packages_common_common_e: Provider[];
2636
2637/**
2638 * A collection of Angular pipes that are likely to be used in each and every application.
2639 */
2640export declare const ɵangular_packages_common_common_f: (typeof AsyncPipe | typeof SlicePipe | typeof DecimalPipe | typeof PercentPipe | typeof CurrencyPipe | typeof DatePipe | typeof I18nPluralPipe | typeof I18nSelectPipe | typeof KeyValuePipe)[];
2641
2642/**
2643 * `PlatformLocation` encapsulates all of the direct calls to platform APIs.
2644 * This class should not be used directly by an application developer. Instead, use
2645 * {@link Location}.
2646 */
2647export declare class ɵBrowserPlatformLocation extends PlatformLocation {
2648 private _doc;
2649 readonly location: Location;
2650 private _history;
2651 constructor(_doc: any);
2652 getBaseHrefFromDOM(): string;
2653 onPopState(fn: LocationChangeListener): VoidFunction;
2654 onHashChange(fn: LocationChangeListener): VoidFunction;
2655 get href(): string;
2656 get protocol(): string;
2657 get hostname(): string;
2658 get port(): string;
2659 get pathname(): string;
2660 get search(): string;
2661 get hash(): string;
2662 set pathname(newPath: string);
2663 pushState(state: any, title: string, url: string): void;
2664 replaceState(state: any, title: string, url: string): void;
2665 forward(): void;
2666 back(): void;
2667 historyGo(relativePosition?: number): void;
2668 getState(): unknown;
2669 static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<ɵBrowserPlatformLocation, never>;
2670}
2671
2672/**
2673 * Provides DOM operations in an environment-agnostic way.
2674 *
2675 * @security Tread carefully! Interacting with the DOM directly is dangerous and
2676 * can introduce XSS risks.
2677 */
2678export declare abstract class ɵDomAdapter {
2679 abstract dispatchEvent(el: any, evt: any): any;
2680 abstract readonly supportsDOMEvents: boolean;
2681 abstract remove(el: any): void;
2682 abstract createElement(tagName: any, doc?: any): HTMLElement;
2683 abstract createHtmlDocument(): HTMLDocument;
2684 abstract getDefaultDocument(): Document;
2685 abstract isElementNode(node: any): boolean;
2686 abstract isShadowRoot(node: any): boolean;
2687 abstract onAndCancel(el: any, evt: any, listener: any): Function;
2688 abstract getGlobalEventTarget(doc: Document, target: string): any;
2689 abstract getBaseHref(doc: Document): string | null;
2690 abstract resetBaseElement(): void;
2691 abstract getUserAgent(): string;
2692 abstract getCookie(name: string): string | null;
2693}
2694
2695
2696export declare function ɵgetDOM(): ɵDomAdapter;
2697
2698/**
2699 * Provides an empty implementation of the viewport scroller.
2700 */
2701export declare class ɵNullViewportScroller implements ViewportScroller {
2702 /**
2703 * Empty implementation
2704 */
2705 setOffset(offset: [number, number] | (() => [number, number])): void;
2706 /**
2707 * Empty implementation
2708 */
2709 getScrollPosition(): [number, number];
2710 /**
2711 * Empty implementation
2712 */
2713 scrollToPosition(position: [number, number]): void;
2714 /**
2715 * Empty implementation
2716 */
2717 scrollToAnchor(anchor: string): void;
2718 /**
2719 * Empty implementation
2720 */
2721 setHistoryScrollRestoration(scrollRestoration: 'auto' | 'manual'): void;
2722}
2723
2724
2725export declare function ɵparseCookieValue(cookieStr: string, name: string): string | null;
2726
2727
2728export declare const ɵPLATFORM_BROWSER_ID = "browser";
2729
2730export declare const ɵPLATFORM_SERVER_ID = "server";
2731
2732export declare const ɵPLATFORM_WORKER_APP_ID = "browserWorkerApp";
2733
2734export declare const ɵPLATFORM_WORKER_UI_ID = "browserWorkerUi";
2735
2736export declare function ɵsetRootDomAdapter(adapter: ɵDomAdapter): void;
2737
2738export { }
2739
2740//# sourceMappingURL=common.d.ts.map
Note: See TracBrowser for help on using the repository browser.