@cute-widgets/base 20.0.1

package/collapse/index.d.ts

@@ -0,0 +1,97 @@
+import * as i0 from '@angular/core';
+import { OnDestroy, EventEmitter } from '@angular/core';
+import { CuteBaseControl, Expandable } from '@cute-widgets/base/abstract';
+import { Subject } from 'rxjs';
+import { AnimationEvent, AnimationTriggerMetadata } from '@angular/animations';
+import * as i1 from '@angular/common';
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+/** Animation states */
+type CuteCollapseState = 'expanded' | 'collapsed';
+/**
+ * This collapse component is used to show and hide content.
+ * Buttons or anchors are used as triggers that are mapped to specific elements you toggle.
+ */
+declare class CuteCollapse extends CuteBaseControl implements Expandable, OnDestroy {
+    /** Sets the element's current state to _collapsed_ or _expanded_ value. */
+    get collapsed(): boolean;
+    set collapsed(value: boolean);
+    private _collapsed;
+    /** Expanding/Collapsing directionality, _horizontal_ or _vertical_. Default is _vertical_. */
+    horizontal: boolean;
+    /** Whether the animation while collapsing/expanding should be disabled */
+    disableAnimation: boolean;
+    /** Event emitting before expand element */
+    readonly beforeExpand: EventEmitter<void>;
+    /** Event emitting before collapse element */
+    readonly beforeCollapse: EventEmitter<void>;
+    /** Event emitting after expand element */
+    readonly afterExpand: EventEmitter<void>;
+    /** Event emitting after collapse element */
+    readonly afterCollapse: EventEmitter<void>;
+    /** Weather the current state is _collapsed_ or _expanded_. Part of `Expandable` interface. */
+    get expanded(): boolean;
+    /** Stream of body animation events. */
+    protected readonly _bodyAnimation$: Subject<AnimationEvent>;
+    constructor();
+    protected onAnimationEvent(event: AnimationEvent): void;
+    protected generateId(): string;
+    /** Gets the expanded state string. */
+    getState(): CuteCollapseState;
+    /** Part of `Expandable` interface */
+    toggle(): void;
+    /** Part of `Expandable` interface */
+    open(): void;
+    /** Part of `Expandable` interface */
+    close(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCollapse, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCollapse, "cute-collapse", ["cuteCollapse"], { "collapsed": { "alias": "collapsed"; "required": false; }; "horizontal": { "alias": "horizontal"; "required": false; }; "disableAnimation": { "alias": "disableAnimation"; "required": false; }; }, { "beforeExpand": "beforeExpand"; "beforeCollapse": "beforeCollapse"; "afterExpand": "afterExpand"; "afterCollapse": "afterCollapse"; }, never, ["*"], true, never>;
+    static ngAcceptInputType_collapsed: unknown;
+    static ngAcceptInputType_horizontal: unknown;
+    static ngAcceptInputType_disableAnimation: unknown;
+}
+
+declare class CuteCollapseTrigger {
+    /** Reference to the `cute-collapse` component to toggle its visibility */
+    get collapseControl(): CuteCollapse | null;
+    set collapseControl(collapse: CuteCollapse | null);
+    private _collapseControl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCollapseTrigger, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCollapseTrigger, "[cuteCollapseTriggerFor]", ["cuteCollapseTrigger"], { "collapseControl": { "alias": "cuteCollapseTriggerFor"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+/** Time and timing curve for **collapse** animations. */
+declare const CUTE_COLLAPSE_ANIMATION_TIMING = "225ms cubic-bezier(0.4,0.0,0.2,1)";
+/**
+ * Animations used by the CuteWidgets` collapse element.
+ */
+declare const cuteCollapseAnimations: {
+    readonly bodyExpansion: AnimationTriggerMetadata;
+};
+
+declare class CuteCollapseModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCollapseModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CuteCollapseModule, never, [typeof i1.CommonModule, typeof CuteCollapse, typeof CuteCollapseTrigger], [typeof CuteCollapse, typeof CuteCollapseTrigger]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<CuteCollapseModule>;
+}
+
+export { CUTE_COLLAPSE_ANIMATION_TIMING, CuteCollapse, CuteCollapseModule, CuteCollapseTrigger, cuteCollapseAnimations };
+export type { CuteCollapseState };

package/core/animation/index.d.ts

@@ -0,0 +1,43 @@
+import { InjectionToken } from '@angular/core';
+
+/** Object used to configure the animation in Angular Material. */
+interface AnimationsConfig {
+    /** Whether all animations should be disabled. */
+    animationsDisabled?: boolean;
+}
+/** Injection token used to configure the animations in CuteWidgets. */
+declare const CUTE_WIDGETS_ANIMATIONS: InjectionToken<AnimationsConfig>;
+/**
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ * @docs-private
+ */
+declare class AnimationCurves {
+    static STANDARD_CURVE: string;
+    static DECELERATION_CURVE: string;
+    static ACCELERATION_CURVE: string;
+    static SHARP_CURVE: string;
+}
+/**
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ * @docs-private
+ */
+declare class AnimationDurations {
+    static COMPLEX: string;
+    static ENTERING: string;
+    static EXITING: string;
+}
+/**
+ * Gets the configured animations state.
+ * @docs-private
+ */
+declare function _getAnimationsState(): 'enabled' | 'di-disabled' | 'reduced-motion';
+/**
+ * Returns whether animations have been disabled by DI. Must be called in a DI context.
+ * @docs-private
+ */
+declare function _animationsDisabled(): boolean;
+
+export { AnimationCurves, AnimationDurations, CUTE_WIDGETS_ANIMATIONS, _animationsDisabled, _getAnimationsState };
+export type { AnimationsConfig };

package/core/datetime/index.d.ts

@@ -0,0 +1,404 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, Provider } from '@angular/core';
+import { Subject, Observable } from 'rxjs';
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+/** InjectionToken for datepicker that can be used to override default locale code. */
+declare const CUTE_DATE_LOCALE: InjectionToken<{}>;
+/**
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare function CUTE_DATE_LOCALE_FACTORY(): {};
+/** Adapts type `D` to be usable as a date by cdk-based components that work with dates. */
+declare abstract class DateAdapter<D, L = any> {
+    /** The locale to use for all dates. */
+    protected locale: L | undefined;
+    protected readonly _localeChanges: Subject<void>;
+    /** A stream that emits when the locale changes. */
+    readonly localeChanges: Observable<void>;
+    /**
+     * Gets the year component of the given date.
+     * @param date The date to extract the year from.
+     * @returns The year component.
+     */
+    abstract getYear(date: D): number;
+    /**
+     * Gets the month component of the given date.
+     * @param date The date to extract the month from.
+     * @returns The month component (0-indexed, 0 = January).
+     */
+    abstract getMonth(date: D): number;
+    /**
+     * Gets the date of the month component of the given date.
+     * @param date The date to extract the date of the month from.
+     * @returns The month component (1-indexed, 1 = first of month).
+     */
+    abstract getDate(date: D): number;
+    /**
+     * Gets the day of the week component of the given date.
+     * @param date The date to extract the day of the week from.
+     * @returns The month component (0-indexed, 0 = Sunday).
+     */
+    abstract getDayOfWeek(date: D): number;
+    /**
+     * Gets a list of names for the months.
+     * @param style The naming style (e.g. long = 'January', short = 'Jan', narrow = 'J').
+     * @returns An ordered list of all month names, starting with January.
+     */
+    abstract getMonthNames(style: 'long' | 'short' | 'narrow'): string[];
+    /**
+     * Gets a list of names for the dates of the month.
+     * @returns An ordered list of all date of the month names, starting with '1'.
+     */
+    abstract getDateNames(): string[];
+    /**
+     * Gets a list of names for the days of the week.
+     * @param style The naming style (e.g., long = 'Sunday', short = 'Sun', narrow = 'S').
+     * @returns An ordered list of all weekday names, starting with Sunday.
+     */
+    abstract getDayOfWeekNames(style: 'long' | 'short' | 'narrow'): string[];
+    /**
+     * Gets the name for the year of the given date.
+     * @param date The date to get the year name for.
+     * @returns The name of the given year (e.g. '2017').
+     */
+    abstract getYearName(date: D): string;
+    /**
+     * Gets the first day of the week.
+     * @returns The first day of the week (0-indexed, 0 = Sunday).
+     */
+    abstract getFirstDayOfWeek(): number;
+    /**
+     * Gets the number of days in the month of the given date.
+     * @param date The date whose month should be checked.
+     * @returns The number of days in the month of the given date.
+     */
+    abstract getNumDaysInMonth(date: D): number;
+    /**
+     * Clones the given date.
+     * @param date The date to clone
+     * @returns A new date equal to the given date.
+     */
+    abstract clone(date: D): D;
+    /**
+     * Creates a date with the given year, month, and date. Does not allow over/under-flow of the
+     * month and date.
+     * @param year The full year of the date. (e.g. 89 means the year 89, not the year 1989).
+     * @param month The month of the date (0-indexed, 0 = January). Must be an integer 0 - 11.
+     * @param date The date of month of the date. Must be an integer 1 - length of the given month.
+     * @returns The new date, or null if invalid.
+     */
+    abstract createDate(year: number, month: number, date: number): D;
+    /**
+     * Gets today's date.
+     * @returns Today's date.
+     */
+    abstract today(): D;
+    /**
+     * Parses a date from a user-provided value.
+     * @param value The value to parse.
+     * @param parseFormat The expected format of the value being parsed
+     *     (type is implementation-dependent).
+     * @returns The parsed date.
+     */
+    abstract parse(value: any, parseFormat: any): D | null;
+    /**
+     * Formats a date as a string according to the given format.
+     * @param date The value to format.
+     * @param displayFormat The format to use to display the date as a string.
+     * @returns The formatted date string.
+     */
+    abstract format(date: D, displayFormat: any): string;
+    /**
+     * Adds the given number of years to the date. Years are counted as if flipping 12 pages on the
+     * calendar for each year and then finding the closest date in the new month. For example when
+     * adding 1 year to Feb 29, 2016, the resulting date will be Feb 28, 2017.
+     * @param date The date to add years to.
+     * @param years The number of years to add (maybe negative).
+     * @returns A new date equal to the given one with the specified number of years added.
+     */
+    abstract addCalendarYears(date: D, years: number): D;
+    /**
+     * Adds the given number of months to the date. Months are counted as if flipping a page on the
+     * calendar for each month and then finding the closest date in the new month. For example when
+     * adding 1 month to Jan 31, 2017, the resulting date will be Feb 28, 2017.
+     * @param date The date to add months to.
+     * @param months The number of months to add (maybe negative).
+     * @returns A new date equal to the given one with the specified number of months added.
+     */
+    abstract addCalendarMonths(date: D, months: number): D;
+    /**
+     * Adds the given number of days to the date. Days are counted as if moving one cell on the
+     * calendar for each day.
+     * @param date The date to add days to.
+     * @param days The number of days to add (maybe negative).
+     * @returns A new date equal to the given one with the specified number of days added.
+     */
+    abstract addCalendarDays(date: D, days: number): D;
+    /**
+     * Gets the RFC 3339 compatible string (https://tools.ietf.org/html/rfc3339) for the given date.
+     * This method is used to generate date strings that are compatible with native HTML attributes
+     * such as the `min` or `max` attribute of an `<input>`.
+     * @param date The date to get the ISO date string for.
+     * @returns The ISO date string date string.
+     */
+    abstract toIso8601(date: D): string;
+    /**
+     * Checks whether the given object is considered a date instance by this DateAdapter.
+     * @param obj The object to check
+     * @returns Whether the object is a date instance.
+     */
+    abstract isDateInstance(obj: any): boolean;
+    /**
+     * Checks whether the given date is valid.
+     * @param date The date to check.
+     * @returns Whether the date is valid.
+     */
+    abstract isValid(date: D): boolean;
+    /**
+     * Gets date instance that is not valid.
+     * @returns An invalid date.
+     */
+    abstract invalid(): D;
+    /**
+     * Sets the time of one date to the time of another.
+     * @param target Date whose time will be set.
+     * @param hours New hours to set on the date object.
+     * @param minutes New minutes to set on the date object.
+     * @param seconds New seconds to set on the date object.
+     */
+    setTime(target: D, hours: number, minutes: number, seconds: number): D;
+    /**
+     * Gets the hours component of the given date.
+     * @param date The date to extract the hours from.
+     */
+    getHours(date: D): number;
+    /**
+     * Gets the minutes component of the given date.
+     * @param date The date to extract the minutes from.
+     */
+    getMinutes(date: D): number;
+    /**
+     * Gets the seconds component of the given date.
+     * @param date The date to extract the seconds from.
+     */
+    getSeconds(date: D): number;
+    /**
+     * Parses a date with a specific time from a user-provided value.
+     * @param value The value to parse.
+     * @param parseFormat The expected format of the value being parsed
+     *     (type is implementation-dependent).
+     */
+    parseTime(value: any, parseFormat: any): D | null;
+    /**
+     * Adds an amount of seconds to the specified date.
+     * @param date Date to which to add the seconds.
+     * @param amount Amount of seconds to add to the date.
+     */
+    addSeconds(date: D, amount: number): D;
+    /**
+     * Given a potential date object, returns that same date object if it is
+     * a valid date, or `null` if it's not a valid date.
+     * @param obj The object to check.
+     * @returns A date or `null`.
+     */
+    getValidDateOrNull(obj: unknown): D | null;
+    /**
+     * Attempts to deserialize a value to a valid date object. This is different from parsing in that
+     * deserialize should only accept non-ambiguous, locale-independent formats (e.g. a ISO 8601
+     * string). The default implementation does not allow any deserialization, it simply checks that
+     * the given value is already a valid date object or null. The `<mat-datepicker>` will call this
+     * method on all of its `@Input()` properties that accept dates. It is therefore possible to
+     * support passing values from your backend directly to these properties by overriding this method
+     * to also deserialize the format used by your backend.
+     * @param value The value to be deserialized into a date object.
+     * @returns The deserialized date object, either a valid date, null if the value can be
+     *     deserialized into a null date (e.g. the empty string), or an invalid date.
+     */
+    deserialize(value: any): D | null;
+    /**
+     * Sets the locale used for all dates.
+     * @param locale The new locale.
+     */
+    setLocale(locale: L): void;
+    /**
+     * Compares two dates.
+     * @param first The first date to compare.
+     * @param second The second date to compare.
+     * @returns 0 if the dates are equal, a number less than 0 if the first date is earlier,
+     *     a number greater than 0 if the first date is later.
+     */
+    compareDate(first: D, second: D): number;
+    /**
+     * Compares the time values of two dates.
+     * @param first First date to compare.
+     * @param second Second date to compare.
+     * @returns 0 if the times are equal, a number less than 0 if the first time is earlier,
+     *     a number greater than 0 if the first time is later.
+     */
+    compareTime(first: D, second: D): number;
+    /**
+     * Checks if two dates are equal.
+     * @param first The first date to check.
+     * @param second The second date to check.
+     * @returns Whether the two dates are equal.
+     *     Null dates are considered equal to other null dates.
+     */
+    sameDate(first: D | null, second: D | null): boolean;
+    /**
+     * Checks if the times of two dates are equal.
+     * @param first The first date to check.
+     * @param second The second date to check.
+     * @returns Whether the times of the two dates are equal.
+     *     Null dates are considered equal to other null dates.
+     */
+    sameTime(first: D | null, second: D | null): boolean;
+    /**
+     * Clamp the given date between min and max dates.
+     * @param date The date to clamp.
+     * @param min The minimum value to allow. If null or omitted, no min is enforced.
+     * @param max The maximum value to allow. If null or omitted, no max is enforced.
+     * @returns `min` if `date` is less than `min`, `max` if date is greater than `max`,
+     *     otherwise `date`.
+     */
+    clampDate(date: D, min?: D | null, max?: D | null): D;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+type CuteDateFormats = {
+    parse: {
+        dateInput: any;
+        timeInput?: any;
+    };
+    display: {
+        dateInput: any;
+        monthLabel?: any;
+        monthYearLabel: any;
+        dateA11yLabel: any;
+        monthYearA11yLabel: any;
+        timeInput?: any;
+        timeOptionLabel?: any;
+    };
+};
+declare const CUTE_DATE_FORMATS: InjectionToken<CuteDateFormats>;
+
+/** Adapts the native JS Date for use with cdk-based components that work with dates. */
+declare class NativeDateAdapter extends DateAdapter<Date> {
+    /** The injected locale. */
+    private readonly _cuteDateLocale;
+    constructor(...args: unknown[]);
+    getYear(date: Date): number;
+    getMonth(date: Date): number;
+    getDate(date: Date): number;
+    getDayOfWeek(date: Date): number;
+    getMonthNames(style: 'long' | 'short' | 'narrow'): string[];
+    getDateNames(): string[];
+    getDayOfWeekNames(style: 'long' | 'short' | 'narrow'): string[];
+    getYearName(date: Date): string;
+    getFirstDayOfWeek(): number;
+    getNumDaysInMonth(date: Date): number;
+    clone(date: Date): Date;
+    createDate(year: number, month: number, date: number): Date;
+    today(): Date;
+    parse(value: any, parseFormat?: any): Date | null;
+    format(date: Date, displayFormat: Object): string;
+    addCalendarYears(date: Date, years: number): Date;
+    addCalendarMonths(date: Date, months: number): Date;
+    addCalendarDays(date: Date, days: number): Date;
+    toIso8601(date: Date): string;
+    /**
+     * Returns the given value if given a valid Date or null. Deserializes valid ISO 8601 strings
+     * (https://www.ietf.org/rfc/rfc3339.txt) into valid Dates and empty string into null. Returns an
+     * invalid date for all other values.
+     */
+    deserialize(value: any): Date | null;
+    isDateInstance(obj: any): obj is Date;
+    isValid(date: Date): boolean;
+    invalid(): Date;
+    setTime(target: Date, hours: number, minutes: number, seconds: number): Date;
+    getHours(date: Date): number;
+    getMinutes(date: Date): number;
+    getSeconds(date: Date): number;
+    parseTime(userValue: any, parseFormat?: any): Date | null;
+    addSeconds(date: Date, amount: number): Date;
+    /** Creates a date but allows the month and date to overflow. */
+    private _createDateWithOverflow;
+    /**
+     * Pads a number to make it two digits.
+     * @param n The number to pad.
+     * @returns The padded number.
+     */
+    private _2digit;
+    /**
+     * When converting a Date object to string, javascript built-in functions may return wrong
+     * results because it applies its internal DST rules. The DST rules around the world change
+     * very frequently, and the current valid rule is not always valid in previous years though.
+     * We work around this problem building a new Date object which has its internal UTC
+     * representation with the local date and time.
+     * @param dtf Intl.DateTimeFormat object, containing the desired string format. It must have
+     *    timeZone set to 'utc' to work fine.
+     * @param date Date from which we want to get the string representation according to dtf
+     * @returns A Date object with its UTC representation based on the passed in date info
+     */
+    private _format;
+    /**
+     * Attempts to parse a time string into a date object. Returns null if it cannot be parsed.
+     * @param value Time string to parse.
+     */
+    private _parseTimeString;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NativeDateAdapter>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+declare const CUTE_NATIVE_DATE_FORMATS: CuteDateFormats;
+
+declare class NativeDateModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<NativeDateModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<NativeDateModule>;
+}
+declare class CuteNativeDateModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteNativeDateModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CuteNativeDateModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<CuteNativeDateModule>;
+}
+declare function provideNativeDateAdapter(formats?: CuteDateFormats): Provider[];
+
+export { CUTE_DATE_FORMATS, CUTE_DATE_LOCALE, CUTE_DATE_LOCALE_FACTORY, CUTE_NATIVE_DATE_FORMATS, CuteNativeDateModule, DateAdapter, NativeDateAdapter, NativeDateModule, provideNativeDateAdapter };
+export type { CuteDateFormats };