@taiga-ui/cdk 3.49.1 → 3.491.1-canary.5e01f6f

package/constants/matcher.d.ts

@@ -1,23 +1,4 @@
 import { TuiHandler, TuiIdentityMatcher } from '@taiga-ui/cdk/types';
-/**
- * Default handler for matching stringified version of an item and a search query
- * @param item arbitrary element to match with a string
- * @param search search query
- * @param stringify handler to turn item into a string
- */
 export declare const TUI_DEFAULT_MATCHER: <T>(item: T, search: string, stringify?: TuiHandler<T, string>) => boolean;
-/**
- * Default handler for strict matching stringified version of an item and a search query
- * @param item arbitrary element to match with a string
- * @param search search query
- * @param stringify handler to turn item into a string
- */
 export declare const TUI_STRICT_MATCHER: <T>(item: T, search: string, stringify?: TuiHandler<T, string>) => boolean;
-/**
- * Default handler to match equality of two elements
- * ATTENTION: considers two empty arrays equal
- *
- * @param item1 first element
- * @param item2 second element
- */
 export declare const TUI_DEFAULT_IDENTITY_MATCHER: TuiIdentityMatcher<unknown>;

package/constants/parent-animation.d.ts

@@ -1,8 +1,2 @@
-/**
- * Add to enable child :leave animation (fixes https://github.com/angular/angular/issues/15753)
- */
 export declare const TUI_PARENT_ANIMATION: import("@angular/animations").AnimationTriggerMetadata;
-/**
- * Add on parent to stop initial :enter animation for children
- */
 export declare const TUI_PARENT_STOP: import("@angular/animations").AnimationTriggerMetadata;

package/constants/stringify.d.ts

@@ -1,5 +1,2 @@
 import { TuiStringHandler } from '@taiga-ui/cdk/types';
-/**
- * Default method to turn arbitrary object into string
- */
 export declare const TUI_DEFAULT_STRINGIFY: TuiStringHandler<unknown>;

package/constants/taiga-ui-cdk-constants.d.ts

@@ -1,5 +1,2 @@
-/**
- * Generated bundle index. Do not edit.
- */
 /// <amd-module name="@taiga-ui/cdk/constants" />
 export * from './index';

package/constants/unicode-chars.d.ts

@@ -1,63 +1,12 @@
-/**
- * {@link https://unicode-table.com/en/00A0/ Non-breaking space}.
- */
 export declare const CHAR_NO_BREAK_SPACE = "\u00A0";
-/**
- * {@link https://unicode-table.com/en/2013/ EN dash}
- * is used to indicate a range of numbers or a span of time.
- * @example 2006–2022
- * ___
- * Don't confuse with {@link CHAR_EM_DASH} or {@link CHAR_HYPHEN}!
- */
 export declare const CHAR_EN_DASH = "\u2013";
-/**
- * {@link https://unicode-table.com/en/2014/ EM dash}
- * is used to mark a break in a sentence.
- * @example Taiga UI — powerful set of open source components for Angular
- * ___
- * Don't confuse with {@link CHAR_EN_DASH} or {@link CHAR_HYPHEN}!
- */
 export declare const CHAR_EM_DASH = "\u2014";
-/**
- * {@link https://unicode-table.com/en/00AB/ Left-Pointing Double Angle Quotation Mark}
- */
 export declare const CHAR_LAQUO = "\u00AB";
-/**
- * {@link https://unicode-table.com/en/00BB/ Right-Pointing Double Angle Quotation Mark}
- */
 export declare const CHAR_RAQUO = "\u00BB";
-/**
- * {@link https://unicode-table.com/en/002D/ Hyphen (minus sign)}
- * is used to combine words.
- * @example well-behaved
- * ___
- * Don't confuse with {@link CHAR_EN_DASH} or {@link CHAR_EM_DASH}!
- */
 export declare const CHAR_HYPHEN = "-";
-/**
- * {@link https://unicode-table.com/en/2212/ Minus}
- * is used as math operator symbol or before negative digits.
- * ---
- * Can be used as `−`. Don't confuse with {@link CHAR_HYPHEN}
- */
 export declare const CHAR_MINUS = "\u2212";
-/**
- * {@link https://unicode-table.com/en/002B/ Plus}
- */
 export declare const CHAR_PLUS = "+";
-/**
- * {@link https://unicode-table.com/en/2022/ Bullet}.
- */
 export declare const CHAR_BULLET = "\u2022";
-/**
- * {@link https://unicode-table.com/en/2026/ Suspension points}.
- */
 export declare const CHAR_ELLIPSIS = "\u2026";
-/**
- * {@link https://unicode-table.com/en/00A4/ Suspension points}.
- */
 export declare const CHAR_CURRENCY_SIGN = "\u00A4";
-/**
- * {@link https://unicode-table.com/en/200b/ Suspension points}.
- */
 export declare const CHAR_ZERO_WIDTH_SPACE = "\u200B";

package/constants/used-icons.d.ts

@@ -1,7 +1 @@
-/**
- * @description:
- * AUTOGENERATED
- *
- * Array of icons used in taiga-ui components
- */
 export declare const TUI_USED_ICONS: string[];

package/date-time/date-fillers.d.ts

@@ -1,13 +1,2 @@
-/**
- * @internal 'dd.mm.yyyy'.length
- * Used in:
- * - {@link TuiInputDateComponent}
- * - {@link TuiInputDateRangeComponent}
- * - {@link TuiInputDateTimeComponent}
- */
 export declare const DATE_FILLER_LENGTH = 10;
-/**
- * @internal
- * Used in {@link TuiInputDateRangeComponent}
- */
 export declare const DATE_RANGE_FILLER_LENGTH: number;

package/date-time/date-format.d.ts

@@ -1,5 +1,2 @@
 import { TuiDateMode } from '@taiga-ui/cdk/types';
-/**
- * Active date format for Taiga UI
- */
 export declare const TUI_DATE_FORMAT: import("@angular/core").InjectionToken<TuiDateMode>;

package/date-time/date-separator.d.ts

@@ -1,5 +1,2 @@
-/**
- * Date separator for Taiga UI components
- */
 export declare const TUI_DATE_SEPARATOR: import("@angular/core").InjectionToken<string>;
 export declare const changeDateSeparator: (dateString: string, newDateSeparator: string) => string;

package/date-time/day-range.d.ts

@@ -1,48 +1,15 @@
 import { TuiDateMode } from '@taiga-ui/cdk/types';
 import { TuiDay } from './day';
 import { TuiMonthRange } from './month-range';
-/**
- * An immutable range of two {@link TuiDay} objects
- */
 export declare class TuiDayRange extends TuiMonthRange {
     readonly from: TuiDay;
     readonly to: TuiDay;
     constructor(from: TuiDay, to: TuiDay);
-    /**
-     * Creates range from two days after sorting them
-     *
-     * @param day1
-     * @param day2
-     * @return new range with sorted days
-     */
     static sort(day1: TuiDay, day2: TuiDay): TuiDayRange;
-    /**
-     * Parse and correct a day range in string format
-     *
-     * @param rangeString a string of dates in a format dd.mm.yyyy - dd.mm.yyyy
-     * @param dateMode {@link TuiDateMode}
-     * @return normalized day range object
-     */
     static normalizeParse(rangeString: string, dateMode?: TuiDateMode): TuiDayRange;
     get isSingleDay(): boolean;
-    /**
-     * Tests ranges for identity
-     *
-     * @param another second range to test against current
-     * @return `true` if days are identical
-     */
     daySame(another: TuiDayRange): boolean;
-    /**
-     * Locks range between two days included, or limits from one side if the other is null
-     *
-     * @param min
-     * @param max
-     * @return range — clamped range
-     */
     dayLimit(min: TuiDay | null, max: TuiDay | null): TuiDayRange;
-    /**
-     * Human readable format.
-     */
     getFormattedDayRange(dateFormat: TuiDateMode, dateSeparator: string): string;
     toString(dateFormat?: TuiDateMode, dateSeparator?: string): string;
 }

package/date-time/day.d.ts

@@ -1,45 +1,14 @@
 import { TuiDayLike } from '@taiga-ui/cdk/interfaces';
 import { TuiDateMode } from '@taiga-ui/cdk/types';
 import { TuiMonth } from './month';
-/**
- * Immutable date object, consisting of day, month and year
- */
 export declare class TuiDay extends TuiMonth {
     readonly day: number;
     constructor(year: number, month: number, day: number);
-    /**
-     * Creates {@link TuiDay} from native {@link Date} based on local time zone
-     */
     static fromLocalNativeDate(date: Date): TuiDay;
-    /**
-     * Creates {@link TuiDay} from native {@link Date} using UTC
-     */
     static fromUtcNativeDate(date: Date): TuiDay;
-    /**
-     * Check validity of year, month and day
-     *
-     * @param year
-     * @param month
-     * @param day
-     * @return boolean validity
-     */
     static isValidDay(year: number, month: number, day: number): boolean;
-    /**
-     * Current day based on local time zone
-     */
     static currentLocal(): TuiDay;
-    /**
-     * Returns current day based on UTC
-     */
     static currentUtc(): TuiDay;
-    /**
-     * Calculates {@link TuiDay} normalizing year, month and day. {@link NaN} is turned into minimal value.
-     *
-     * @param year any year value, including invalid
-     * @param month any month value, including invalid (months start with 0)
-     * @param day any day value, including invalid
-     * @return normalized date
-     */
     static normalizeOf(year: number, month: number, day: number): TuiDay;
     static lengthBetween(from: TuiDay, to: TuiDay): number;
     static parseRawDateString(date: string, dateMode?: TuiDateMode): {
@@ -47,82 +16,22 @@ export declare class TuiDay extends TuiMonth {
         month: number;
         year: number;
     };
-    /**
-     * Parsing a string with date with normalization
-     *
-     * @param rawDate date string
-     * @param dateMode date format of the date string (DMY | MDY | YMD)
-     * @return normalized date
-     */
     static normalizeParse(rawDate: string, dateMode?: TuiDateMode): TuiDay;
-    /**
-     * Parsing a date stringified in a toJSON format
-     * @param yearMonthDayString date string in format of YYYY-MM-DD
-     * @return date
-     * @throws exceptions if any part of the date is invalid
-     */
     static jsonParse(yearMonthDayString: string): TuiDay;
     protected static normalizeDayPart(day: number, month: number, year: number): number;
     get formattedDayPart(): string;
     get isWeekend(): boolean;
-    /**
-     * Returns day of week
-     *
-     * @param startFromMonday whether week starts from Monday and not from Sunday
-     * @return day of week (from 0 to 6)
-     */
     dayOfWeek(startFromMonday?: boolean): number;
-    /**
-     * Passed date is after current
-     */
     dayBefore(another: TuiDay): boolean;
-    /**
-     * Passed date is after or equals to current
-     */
     daySameOrBefore(another: TuiDay): boolean;
-    /**
-     * Passed date is the same as current
-     */
     daySame(another: TuiDay): boolean;
-    /**
-     * Passed date is either before or the same as current
-     */
     daySameOrAfter(another: TuiDay): boolean;
-    /**
-     * Passed date is before current
-     */
     dayAfter(another: TuiDay): boolean;
-    /**
-     * Clamping date between two limits
-     *
-     * @param min
-     * @param max
-     * @return clamped date
-     */
     dayLimit(min: TuiDay | null, max: TuiDay | null): TuiDay;
-    /**
-     * Immutably alters current day by passed offset
-     *
-     * If resulting month has more days than original one, date is rounded to the maximum day
-     * in the resulting month. Offset of days will be calculated based on the resulted year and month
-     * to not interfere with parent classes methods
-     *
-     * @param offset
-     * @return new date object as a result of offsetting current
-     */
     append({ year, month, day }: TuiDayLike): TuiDay;
-    /**
-     * Returns formatted whole date
-     */
     getFormattedDay(dateFormat: TuiDateMode, separator: string): string;
     toString(dateFormat?: TuiDateMode, separator?: string): string;
     toJSON(): string;
-    /**
-     * Returns native {@link Date} based on local time zone
-     */
     toLocalNativeDate(): Date;
-    /**
-     * Returns native {@link Date} based on UTC
-     */
     toUtcNativeDate(): Date;
 }

package/date-time/month-range.d.ts

@@ -1,7 +1,4 @@
 import { TuiMonth } from './month';
-/**
- * An immutable range of two {@link TuiMonth} objects
- */
 export declare class TuiMonthRange {
     readonly from: TuiMonth;
     readonly to: TuiMonth;

package/date-time/month.d.ts

@@ -1,82 +1,26 @@
 import { TuiMonthLike } from '@taiga-ui/cdk/interfaces';
 import { TuiYear } from './year';
-/**
- * Immutable object consisting of year and month
- */
 export declare class TuiMonth extends TuiYear implements TuiMonthLike {
     readonly month: number;
-    /**
-     * @param year
-     * @param month (starting with 0)
-     */
     constructor(year: number, month: number);
-    /**
-     * Tests month and year for validity
-     */
     static isValidMonth(year: number, month: number): boolean;
-    /**
-     * Returns number of days in a month
-     */
     static getMonthDaysCount(month: number, isLeapYear: boolean): number;
-    /**
-     * Returns current month and year based on local time zone
-     * @nosideeffects
-     */
     static currentLocal(): TuiMonth;
-    /**
-     * Returns current month and year based on UTC
-     */
     static currentUtc(): TuiMonth;
     static lengthBetween(from: TuiMonth, to: TuiMonth): number;
-    /**
-     * Normalizes number by clamping it between min and max month
-     */
     protected static normalizeMonthPart(month: number): number;
-    /**
-     * Tests month for validity
-     */
     private static isValidMonthPart;
     get formattedMonthPart(): string;
-    /**
-     * Returns days in a month
-     */
     get daysCount(): number;
-    /**
-     * Passed month and year are after current
-     */
     monthBefore(another: TuiMonth): boolean;
-    /**
-     * Passed month and year are after or the same as current
-     */
     monthSameOrBefore(another: TuiMonth): boolean;
-    /**
-     * Passed month and year are the same as current
-     */
     monthSame(another: TuiMonth): boolean;
-    /**
-     * Passed month and year are either before or equal to current
-     */
     monthSameOrAfter(another: TuiMonth): boolean;
-    /**
-     * Passed month and year are before current
-     */
     monthAfter(another: TuiMonth): boolean;
-    /**
-     * Immutably alters current month and year by passed offset
-     *
-     * @param offset
-     * @return new month and year object as a result of offsetting current
-     */
     append({ year, month }: TuiMonthLike): TuiMonth;
     toString(): string;
     valueOf(): number;
     toJSON(): string;
-    /**
-     * Returns native {@link Date} based on local time zone
-     */
     toLocalNativeDate(): Date;
-    /**
-     * Returns native {@link Date} based on UTC
-     */
     toUtcNativeDate(): Date;
 }

package/date-time/taiga-ui-cdk-date-time.d.ts

@@ -1,5 +1,2 @@
-/**
- * Generated bundle index. Do not edit.
- */
 /// <amd-module name="@taiga-ui/cdk/date-time" />
 export * from './index';

package/date-time/time.d.ts

@@ -1,57 +1,21 @@
 import { TuiTimeLike } from '@taiga-ui/cdk/interfaces';
 import { TuiTimeMode } from '@taiga-ui/cdk/types';
-/**
- * Immutable time object with hours, minutes, seconds and ms
- */
 export declare class TuiTime implements TuiTimeLike {
     readonly hours: number;
     readonly minutes: number;
     readonly seconds: number;
     readonly ms: number;
     constructor(hours: number, minutes: number, seconds?: number, ms?: number);
-    /**
-     * Checks if time is valid
-     */
     static isValidTime(hours: number, minutes: number, seconds?: number, ms?: number): boolean;
-    /**
-     * Current UTC time.
-     */
     static current(): TuiTime;
-    /**
-     * Current time in local timezone
-     */
     static currentLocal(): TuiTime;
-    /**
-     * Calculates TuiTime from milliseconds
-     */
     static fromAbsoluteMilliseconds(milliseconds: number): TuiTime;
-    /**
-     * Parses string into TuiTime object
-     */
     static fromString(time: string): TuiTime;
-    /**
-     * Converts Date object into TuiTime
-     * @param date
-     */
     static fromLocalNativeDate(date: Date): TuiTime;
-    /**
-     * Shifts time by hours and minutes
-     */
     shift({ hours, minutes, seconds, ms }: TuiTimeLike): TuiTime;
-    /**
-     * Converts TuiTime to string
-     */
     toString(mode?: TuiTimeMode): string;
     valueOf(): number;
-    /**
-     * Returns the primitive value of the given Date object.
-     * Depending on the argument, the method can return either a string or a number.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/@@toPrimitive
-     */
     [Symbol.toPrimitive](hint: string): number | string;
-    /**
-     * Converts TuiTime to milliseconds
-     */
     toAbsoluteMilliseconds(): number;
     private formatTime;
 }

package/date-time/year.d.ts

@@ -1,65 +1,23 @@
 import { TuiYearLike } from '@taiga-ui/cdk/interfaces';
-/**
- * Immutable year object
- * @nosideeffects
- */
 export declare class TuiYear implements TuiYearLike {
     readonly year: number;
     constructor(year: number);
-    /**
-     * Checks year for validity
-     */
     static isValidYear(year: number): boolean;
-    /**
-     * Check if passed year is a leap year
-     */
     static isLeapYear(year: number): boolean;
-    /**
-     * Returns amount of leap years from year 0 to the passed one
-     */
     static getAbsoluteLeapYears(year: number): number;
     static lengthBetween(from: TuiYear, to: TuiYear): number;
-    /**
-     * Normalizes year by clamping it between min and max years
-     */
     protected static normalizeYearPart(year: number): number;
     get formattedYear(): string;
     get isLeapYear(): boolean;
-    /**
-     * Returns amount of leap years from year 0 to current
-     */
     get absoluteLeapYears(): number;
-    /**
-     * Passed year is after current
-     */
     yearBefore({ year }: TuiYear): boolean;
-    /**
-     * Passed year is the same or after current
-     */
     yearSameOrBefore({ year }: TuiYear): boolean;
-    /**
-     * Passed year is the same as current
-     */
     yearSame({ year }: TuiYear): boolean;
-    /**
-     * Passed year is either the same of before the current
-     */
     yearSameOrAfter({ year }: TuiYear): boolean;
-    /**
-     * Passed year is before current
-     */
     yearAfter({ year }: TuiYear): boolean;
-    /**
-     * Immutably offsets year
-     */
     append({ year }: TuiYearLike): TuiYear;
     toString(): string;
     valueOf(): number;
-    /**
-     * Returns the primitive value of the given Date object.
-     * Depending on the argument, the method can return either a string or a number.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/@@toPrimitive
-     */
     [Symbol.toPrimitive](hint: string): number | string;
     toJSON(): string;
 }

package/decorators/debounce.d.ts

@@ -1,5 +1 @@
-/**
- * @deprecated:
- * not compatible with TypeScript 5
- */
 export declare function tuiDebounce(timeout: number): MethodDecorator;

package/decorators/default-prop.d.ts

@@ -1,11 +1,2 @@
 import { TuiBooleanHandler } from '@taiga-ui/cdk/types';
-/**
- * @deprecated:
- * not compatible with TypeScript 5
- *
- * Decorator for checking input values for undefined. You can also pass
- * optional assertion to check input against.
- *
- * CAUTION: This decorator overwrites other getters and setters.
- */
 export declare function tuiDefaultProp<T extends Record<string, any>, K extends keyof T>(assertion?: TuiBooleanHandler<T[K]>, ...args: unknown[]): PropertyDecorator;

package/decorators/pure.d.ts

@@ -1,29 +1,11 @@
-/** TODO Delete after updating typescript to version 5 and when backward compatibility will not be required */
 interface ClassGetterDecoratorContext {
     kind: 'getter';
     name: string;
 }
-/** TODO Delete after updating typescript to version 5 and when backward compatibility will not be required */
 interface ClassMethodDecoratorContext {
     kind: 'method';
     name: string;
 }
-/**
- * Implements lazy initialization for getter or memoization of a function call similar to pure {@link: Pipe}.
- * Replaces getter with its calculated value upon first call or keeps track of last call arguments and returned
- * value for function, skipping calculation when arguments are strictly the same.
- *
- * @throws error if used not on getter or function
- *
- * CAUTION: they must be pure.
- */
 export declare function tuiPure<T>(target: object, propertyKey: string, { get, enumerable, value }: TypedPropertyDescriptor<T>): TypedPropertyDescriptor<T>;
-/**
- * Implements lazy initialization for getter or memoization of a function call similar to pure {@link: Pipe}.
- * Replaces getter with its calculated value upon first call or keeps track of last call arguments and returned
- * value for function, skipping calculation when arguments are strictly the same.
- *
- * CAUTION: they must be pure.
- */
 export declare function tuiPure<A extends unknown[], R>(target: (...args: A) => R, context: ClassGetterDecoratorContext | ClassMethodDecoratorContext): (...args: A) => R;
 export {};

package/decorators/required-setter.d.ts

@@ -1,11 +1,2 @@
 import { TuiBooleanHandler } from '@taiga-ui/cdk/types';
-/**
- * @deprecated:
- * not compatible with TypeScript 5
- *
- * Decorator for checking input setter values against a custom assertion which
- * takes value passed to input setter and component instance as arguments.
- * It specifically checks for undefined values and prevents calls to the
- * original setter in this case.
- */
 export declare function tuiRequiredSetter<T extends Record<string, any>, K extends keyof T>(assertion?: TuiBooleanHandler<T[K]>, ...args: any[]): MethodDecorator;

package/decorators/taiga-ui-cdk-decorators.d.ts

@@ -1,5 +1,2 @@
-/**
- * Generated bundle index. Do not edit.
- */
 /// <amd-module name="@taiga-ui/cdk/decorators" />
 export * from './index';

package/directives/active-zone/taiga-ui-cdk-directives-active-zone.d.ts

@@ -1,5 +1,2 @@
-/**
- * Generated bundle index. Do not edit.
- */
 /// <amd-module name="@taiga-ui/cdk/directives/active-zone" />
 export * from './index';

package/directives/auto-focus/handlers/ios.handler.d.ts

@@ -9,49 +9,10 @@ export declare class TuiIosAutofocusHandler extends AbstractTuiAutofocusHandler
     constructor(focusable: TuiFocusableElementAccessor | null, el: ElementRef<HTMLElement>, renderer: Renderer2, zone: NgZone, win: Window);
     setFocus(): void;
     private iosWebkitAutofocus;
-    /**
-     * @note:
-     * emulate textfield position in layout with cursor
-     * before focus to real textfield element
-     *
-     * required note:
-     * [fakeInput.readOnly = true] ~
-     * don't use {readOnly: true} value, it's doesn't work for emulate autofill
-     *
-     * [fakeInput.style.opacity = 0] ~
-     * don't use {opacity: 0}, sometimes it's doesn't work for emulate real input
-     *
-     * [fakeInput.style.fontSize = 16px] ~
-     * disable possible auto zoom
-     *
-     * [fakeInput.style.top/left] ~
-     * emulate position cursor before focus to real textfield element
-     */
     private makeFakeInput;
     private getDurationTimeBeforeFocus;
-    /**
-     * @note:
-     * unfortunately, in older versions of iOS
-     * there is a bug that the fake input cursor
-     * will move along with the dialog animation
-     * and then that dialog will be shaking
-     */
     private insideDialog;
-    /**
-     * @note:
-     * This is necessary so that the viewport isn't recalculated
-     * and then the dialogs don't shake.
-     *
-     * Also, we need to fixed height viewport,
-     * so that when focusing the dialogs don't shake
-     */
     private patchCssStyles;
-    /**
-     * @note:
-     * inherit basic attributes values from real input
-     * for help iOS detect what do you want see on keyboard,
-     * for example [inputMode=numeric, autocomplete=cc-number]
-     */
     private patchFakeInputFromFocusableElement;
     static ɵfac: i0.ɵɵFactoryDeclaration<TuiIosAutofocusHandler, [{ optional: true; self: true; }, null, null, null, null]>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<TuiIosAutofocusHandler, never, never, {}, {}, never>;