design-angular-kit 1.2.1 → 1.2.2

package/{src/lib/interfaces/core.ts → lib/interfaces/core.d.ts}

@@ -1,119 +1,77 @@
 import { IconName } from './icon';
-
 export type AlertColor = 'primary' | 'info' | 'success' | 'warning' | 'danger';
-
-export type ButtonColor =
-  | 'primary'
-  | 'outline-primary'
-  | 'secondary'
-  | 'outline-secondary'
-  | 'success'
-  | 'outline-success'
-  | 'danger'
-  | 'outline-danger'
-  | 'warning'
-  | 'outline-warning'
-  | 'info'
-  | 'outline-info'
-  | 'light'
-  | 'outline-light'
-  | 'dark'
-  | 'outline-dark'
-  | 'link';
-
+export type ButtonColor = 'primary' | 'outline-primary' | 'secondary' | 'outline-secondary' | 'success' | 'outline-success' | 'danger' | 'outline-danger' | 'warning' | 'outline-warning' | 'info' | 'outline-info' | 'light' | 'outline-light' | 'dark' | 'outline-dark' | 'link';
 export type ButtonSize = 'lg' | 'sm' | 'xs';
 export type ButtonType = 'submit' | 'button';
-
 export type CalloutColor = 'success' | 'warning' | 'danger' | 'important' | 'note';
 export type CalloutAppearance = 'default' | 'highlight' | 'more';
-
 export type ChipColor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning';
-
 export type ElementPlacement = 'top' | 'bottom' | 'left' | 'right';
-
 export type ProgressBarColor = 'primary' | 'success' | 'warning' | 'danger' | 'info';
-
 export type BadgeColor = 'primary' | 'secondary' | 'success' | 'warning' | 'danger';
-
 export type TableColor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'light' | 'dark';
-
 export type TableHeadColor = 'light' | 'dark';
-
 export type TableResponsive = 'responsive' | 'responsive-sm' | 'responsive-md' | 'responsive-lg' | 'responsive-xl' | 'responsive-xxl';
-
 export type VerticalAlignment = 'align-baseline' | 'align-top' | 'align-middle' | 'align-bottom' | 'align-text-bottom' | 'align-text-top';
-
 export type DropdownDirection = 'dropup' | 'dropend' | 'dropstart';
-
 export type CarouselType = 'default' | 'three-cols' | 'three-cols-arrow-visible';
-
 export type TimelinePINType = 'default' | 'evidence' | 'now';
-
 export interface TimelineElement {
-  pin: {
-    type?: TimelinePINType;
-    icon?: IconName;
-    text: string;
-  };
-  category?: {
+    pin: {
+        type?: TimelinePINType;
+        icon?: IconName;
+        text: string;
+    };
+    category?: {
+        title: string;
+        link: string;
+    };
     title: string;
-    link: string;
-  };
-  title: string;
-  text: string;
-  signature?: string;
-  eventDate?: Date;
-  link?: string;
+    text: string;
+    signature?: string;
+    eventDate?: Date;
+    link?: string;
 }
-
 export interface Notification {
-  /**
-   * Notification type
-   */
-  type: NotificationType;
-
-  /**
-   * Notification title
-   */
-  title: string;
-
-  /**
-   * Notification message / text
-   */
-  message?: string;
-
-  /**
-   * Custom duration of notification
-   */
-  duration?: number;
-
-  /**
-   * The close notification button appears
-   */
-  dismissible?: boolean;
-
-  /**
-   * Custom position of notification
-   */
-  position?: NotificationPosition;
-
-  /**
-   * Custom icon of notification
-   */
-  icon?: IconName;
+    /**
+     * Notification type
+     */
+    type: NotificationType;
+    /**
+     * Notification title
+     */
+    title: string;
+    /**
+     * Notification message / text
+     */
+    message?: string;
+    /**
+     * Custom duration of notification
+     */
+    duration?: number;
+    /**
+     * The close notification button appears
+     */
+    dismissible?: boolean;
+    /**
+     * Custom position of notification
+     */
+    position?: NotificationPosition;
+    /**
+     * Custom icon of notification
+     */
+    icon?: IconName;
 }
-
-export enum NotificationType {
-  Standard = 'standard',
-  Success = 'success',
-  Error = 'error',
-  Info = 'info',
-  Warning = 'warning',
+export declare enum NotificationType {
+    Standard = "standard",
+    Success = "success",
+    Error = "error",
+    Info = "info",
+    Warning = "warning"
 }
-
-export enum NotificationPosition {
-  Top = 'top-fix mt-3',
-  Bottom = 'bottom-fix mb-3',
-  Left = 'left-fix ms-3',
-  Right = 'right-fix me-3',
+export declare enum NotificationPosition {
+    Top = "top-fix mt-3",
+    Bottom = "bottom-fix mb-3",
+    Left = "left-fix ms-3",
+    Right = "right-fix me-3"
 }

package/lib/interfaces/design-angular-kit-config.d.ts

@@ -0,0 +1,30 @@
+import { InjectionToken, Provider } from '@angular/core';
+/**
+ * The bootstrap-italia asset folder path
+ * @default ./bootstrap-italia
+ */
+export declare const IT_ASSET_BASE_PATH: InjectionToken<string>;
+export interface DesignAngularKitConfig {
+    /**
+     * The bootstrap-italia asset folder path
+     * @default ./bootstrap-italia
+     */
+    assetBasePath?: string;
+    /**
+     * Load the <a href="https://italia.github.io/bootstrap-italia/docs/come-iniziare/introduzione/#fonts">bootstrap-italia fonts</a>
+     * @default true
+     */
+    loadFont?: boolean;
+    /**
+     * The TranslateModule loader
+     * @param itPrefix the design-angular-kit i18n path
+     * @param itSuffix the design-angular-kit i18n suffix
+     * @default
+     * {
+     *   provide: TranslateLoader,
+     *   useFactory: (http: HttpClient) => new TranslateHttpLoader(http, `${assetBasePath}/i18n/`, `.json?v${version}`),
+     *   deps: [HttpClient],
+     * }
+     */
+    translateLoader?: (itPrefix: string, itSuffix: string) => Provider;
+}

package/lib/interfaces/form.d.ts

@@ -0,0 +1,67 @@
+import { IconName } from './icon';
+export type InputControlType = 'text' | 'email' | 'number' | 'date' | 'time' | 'tel' | 'color' | 'url';
+export interface SelectControlOption<T = any> {
+    value: T;
+    text?: string;
+    selected?: boolean | ((value: T) => boolean);
+    disabled?: boolean | ((value: T) => boolean);
+}
+export interface SelectControlGroup<T = any> {
+    label: string;
+    options: Array<SelectControlOption<T>>;
+    dragdrop?: boolean;
+}
+export interface UploadFileListItem {
+    /**
+     * The item id
+     */
+    id: number;
+    /**
+     * The uploaded file
+     */
+    file: File;
+    /**
+     * Show progress bar
+     *
+     * The status of the item changes based on the value:
+     * - <b>uploading</b>: if value is between 0 and 100 (exclusive 0 < value < 100)
+     * - <b>success</b>: if value is greater than 100
+     */
+    progress?: number;
+    /**
+     * Show the ability to delete item
+     * @default false
+     */
+    removable?: boolean;
+    /**
+     * Set the status of the item as 'error'
+     */
+    error?: boolean;
+    /**
+     * Add tooltip on file item name
+     * @example It can be used to show the error message or additional information about the file
+     */
+    tooltip?: string;
+}
+/**
+ * Elemento disponibile per l'autocompletamento del it-form-input
+ */
+export interface AutocompleteItem<T = any> {
+    /** Valore voce di autocompletamento */
+    value: string;
+    /** Opzionale. Path in cui ricercare l'immagine dell'avatar da posizionare a sinistra della voce di autocompletamento */
+    avatarSrcPath?: string;
+    /** Opzionale. Testo in alternativa dell'avatar per accessibilità */
+    avatarAltText?: string;
+    /** Opzionale. Icona posizionata a sinistra della voce di autocompletamento */
+    icon?: IconName;
+    /** Opzionale. Label posizionata a destra della voce di autocompletamento */
+    label?: string;
+    /** Opzionale. Link relativo all'elemento */
+    link?: string;
+    /**
+     * Attribute not used for autocomplete rendering.
+     * It can be useful to retrieve some extra information when selecting the autocomplete item
+     */
+    additionalData?: T;
+}

package/lib/interfaces/icon.d.ts

@@ -0,0 +1,4 @@
+export type IconSize = 'xs' | 'sm' | 'lg' | 'xl';
+export type IconColor = 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'light' | 'white';
+export type IconName = (typeof IconNameArray)[number];
+export declare const IconNameArray: readonly ["arrow-down", "arrow-down-circle", "arrow-down-triangle", "arrow-left", "arrow-left-circle", "arrow-left-triangle", "arrow-right", "arrow-right-circle", "arrow-right-triangle", "arrow-up", "arrow-up-circle", "arrow-up-triangle", "ban", "bookmark", "box", "burger", "calendar", "camera", "card", "chart-line", "check", "check-circle", "chevron-left", "chevron-right", "clip", "clock", "close", "close-big", "close-circle", "code-circle", "comment", "copy", "delete", "download", "error", "exchange-circle", "expand", "external-link", "flag", "folder", "fullscreen", "funnel", "hearing", "help", "help-circle", "horn", "inbox", "info-circle", "key", "link", "list", "locked", "logout", "mail", "mail-open", "map-marker", "map-marker-circle", "map-marker-minus", "map-marker-plus", "maximize", "maximize-alt", "minimize", "minus", "minus-circle", "more-actions", "more-items", "note", "pa", "password-invisible", "password-visible", "pencil", "piattaforme", "pin", "plug", "plus", "plus-circle", "presentation", "print", "refresh", "restore", "rss", "rss-square", "search", "settings", "share", "software", "star-full", "star-outline", "telephone", "tool", "unlocked", "upload", "user", "video", "warning", "warning-circle", "wifi", "zoom-in", "zoom-out", "file", "files", "file-audio", "file-compressed", "file-csv", "file-json", "file-odp", "file-ods", "file-odt", "file-pdf", "file-pdf-ext", "file-sheet", "file-slides", "file-ppt", "file-txt", "file-video", "file-xml", "behance", "facebook", "facebook-square", "figma", "figma-square", "flickr", "flickr-square", "github", "instagram", "linkedin", "linkedin-square", "mastodon", "mastodon-square", "medium", "medium-square", "moodle", "moodle-square", "pinterest", "pinterest-square", "quora", "quora-square", "reddit", "reddit-square", "slack", "slack-square", "snapchat", "snapchat-square", "stackexchange", "stackexchange-square", "stackoverflow", "stackoverflow-square", "telegram", "threads", "threads-square", "tiktok", "tiktok-square", "twitter", "twitter-square", "vimeo", "vimeo-square", "whatsapp", "whatsapp-square", "youtube", "google", "designers-italia", "team-digitale"];

package/lib/interfaces/sortable-table.d.ts

@@ -0,0 +1,33 @@
+import { InjectionToken } from '@angular/core';
+export type SortDirection = 'asc' | 'desc' | undefined;
+/** Position of the arrow that displays when sorted. */
+export type SortHeaderArrowPosition = 'before' | 'after';
+/** Interface for a directive that holds sorting state consumed by `ItSortHeader`. */
+export interface ItSortable {
+    /** The id of the column being sorted. */
+    id: string;
+    /** Starting sort direction. */
+    start?: SortDirection;
+    /** Whether to disable clearing the sorting state. */
+    disableSortClear?: boolean;
+}
+/** The current sort state. */
+export interface ItSortEvent {
+    /** The id of the column being sorted. */
+    active: string;
+    /** The sort direction. */
+    direction: SortDirection;
+}
+/**
+ * Default options for `it-sort`.
+ */
+export interface ItSortDefaultOptions {
+    /** Whether to disable clearing the sorting state. */
+    disableClear?: boolean;
+    /** Position of the arrow that displays when sorted. */
+    arrowPosition?: SortHeaderArrowPosition;
+}
+/**
+ * Injection token to be used to override the default options for `it-sort`.
+ */
+export declare const IT_SORT_DEFAULT_OPTIONS: InjectionToken<ItSortDefaultOptions>;

package/lib/interfaces/utils.d.ts

@@ -0,0 +1,10 @@
+export interface AvailableLanguage {
+    /**
+     * The language code
+     */
+    code: string;
+    /**
+     * Label to show
+     */
+    label: string;
+}

package/lib/pipes/date-ago.pipe.d.ts

@@ -0,0 +1,17 @@
+import { PipeTransform } from '@angular/core';
+import { TranslatePipe } from '@ngx-translate/core';
+import * as i0 from "@angular/core";
+/**
+ * Indicates in a textual way how much time has passed since the indicated date
+ * @example 2 hours ago
+ */
+export declare class ItDateAgoPipe extends TranslatePipe implements PipeTransform {
+    /**
+     * Indicates in a textual way how much time has passed since the indicated date
+     * @example 2 hours ago
+     * @param value the Date or date string
+     */
+    transform(value: string | Date): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ItDateAgoPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ItDateAgoPipe, "itDateAgo", true>;
+}

package/lib/pipes/duration.pipe.d.ts

@@ -0,0 +1,35 @@
+import { PipeTransform } from '@angular/core';
+import { TranslatePipe } from '@ngx-translate/core';
+import * as i0 from "@angular/core";
+export type ItDurationPipeType = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
+/**
+ * Transform a number into a duration.
+ * Is necessary indicate the value expressed by the number, for example 'day'.
+ * @example
+ *  - 1, 'day' -> 1 day
+ *  - 5, 'day' -> 5 days
+ *  - 7, 'day' -> 1 week
+ *  - 365, 'day' -> 1 year
+ *  - 2, 'week' -> 2 weeks
+ *  ...
+ */
+export declare class ItDurationPipe extends TranslatePipe implements PipeTransform {
+    /**
+     * Transform a number into a duration.
+     * Is necessary indicate the value expressed by the number, for example 'day'.
+     * @example
+     *  - 1, 'day' -> 1 day
+     *  - 5, 'day' -> 5 days
+     *  - 7, 'day' -> 1 week
+     *  - 8, 'day' -> 1 week
+     *  - 365, 'day' -> 1 year
+     *  - 2, 'week' -> 2 weeks
+     *  - 24, 'month' -> 1 year
+     *  ...
+     * @param value the number
+     * @param type the number expressed type
+     */
+    transform(value: string | number | undefined, type: ItDurationPipeType): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ItDurationPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ItDurationPipe, "itDuration", true>;
+}

package/lib/pipes/mark-matching-text.pipe.d.ts

@@ -0,0 +1,18 @@
+import { PipeTransform } from '@angular/core';
+import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
+import * as i0 from "@angular/core";
+/**
+ * Allows you to highlight text with the <mark> tag
+ */
+export declare class ItMarkMatchingTextPipe implements PipeTransform {
+    private readonly domSanitizer;
+    constructor(domSanitizer: DomSanitizer);
+    /**
+     * Allows you to highlight text with the <mark> tag
+     * @param allString the full text to search from
+     * @param searchString the string to search
+     */
+    transform(allString: string | undefined, searchString: string | number | null | undefined): SafeHtml | string | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ItMarkMatchingTextPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ItMarkMatchingTextPipe, "itMarkMatchingText", true>;
+}

package/lib/provide-design-angular-kit.d.ts

@@ -0,0 +1,7 @@
+import { EnvironmentProviders } from '@angular/core';
+import { DesignAngularKitConfig } from './interfaces/design-angular-kit-config';
+/**
+ * Configures DesignAngularKit library
+ * @param config the DesignAngularKit config
+ */
+export declare function provideDesignAngularKit(config?: DesignAngularKitConfig): EnvironmentProviders;

package/lib/services/notification/notification.service.d.ts

@@ -0,0 +1,63 @@
+import { Observable } from 'rxjs';
+import { Notification, NotificationPosition, NotificationType } from '../../interfaces/core';
+import * as i0 from "@angular/core";
+export declare class ItNotificationService {
+    private subject;
+    /**
+     * Listen on notification arrived
+     * @param filterType filter type of notification
+     */
+    onNotification(filterType?: NotificationType): Observable<Notification>;
+    /**
+     * Show new notification
+     * @param notification notification
+     */
+    addNotification(notification: Notification): void;
+    /**
+     * Create new Standard notification
+     * @param title notification title
+     * @param message notification message
+     * @param dismissible notification dismissible
+     * @param duration notification duration (milliseconds)
+     * @param position notification position
+     */
+    standard(title: string, message?: string, dismissible?: boolean, duration?: number, position?: NotificationPosition): void;
+    /**
+     * Create new Success notification
+     * @param title notification title
+     * @param message notification message
+     * @param dismissible notification dismissible
+     * @param duration notification duration (milliseconds)
+     * @param position notification position
+     */
+    success(title: string, message?: string, dismissible?: boolean, duration?: number, position?: NotificationPosition): void;
+    /**
+     * Create new Error notification
+     * @param title notification title
+     * @param message notification message
+     * @param dismissible notification dismissible
+     * @param duration notification duration (milliseconds)
+     * @param position notification position
+     */
+    error(title: string, message?: string, dismissible?: boolean, duration?: number, position?: NotificationPosition): void;
+    /**
+     * Create new Warning notification
+     * @param title notification title
+     * @param message notification message
+     * @param dismissible notification dismissible
+     * @param duration notification duration (milliseconds)
+     * @param position notification position
+     */
+    warning(title: string, message?: string, dismissible?: boolean, duration?: number, position?: NotificationPosition): void;
+    /**
+     * Create new Info notification
+     * @param title notification title
+     * @param message notification message
+     * @param dismissible notification dismissible
+     * @param duration notification duration (milliseconds)
+     * @param position notification position
+     */
+    info(title: string, message?: string, dismissible?: boolean, duration?: number, position?: NotificationPosition): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ItNotificationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ItNotificationService>;
+}

package/{src/lib/utils/coercion.ts → lib/utils/coercion.d.ts}

@@ -1,7 +1,4 @@
-import { booleanAttribute } from '@angular/core';
-
 export type BooleanInput = 'false' | 'true' | boolean | undefined;
-
 /**
  * Transforms a value (typically a string) to a boolean.
  * Intended to be used as a transform function of an input.
@@ -14,7 +11,4 @@ export type BooleanInput = 'false' | 'true' | boolean | undefined;
  *
  * @publicApi
  */
-export function inputToBoolean(value: BooleanInput): boolean {
-  // Wrap `@angular/core` function to force value type, for ide hits
-  return booleanAttribute(value);
-}
+export declare function inputToBoolean(value: BooleanInput): boolean;

package/lib/utils/date-utils.d.ts

@@ -0,0 +1,79 @@
+import { Observable } from 'rxjs';
+export declare class ItDateUtils {
+    /**
+     * Add seconds to date
+     * @param date the date
+     * @param seconds seconds to add
+     */
+    static addSeconds(date: Date, seconds: number): Date;
+    /**
+     * Add minutes to date
+     * @param date the date
+     * @param minutes minutes to add
+     */
+    static addMinutes(date: Date, minutes: number): Date;
+    /**
+     * Add hours to date
+     * @param date the date
+     * @param hours hours to add
+     */
+    static addHours(date: Date, hours: number): Date;
+    /**
+     * Add days to date
+     * @param date the date
+     * @param days days to add
+     */
+    static addDays(date: Date, days: number): Date;
+    /**
+     * Add years to date
+     * @param date the date
+     * @param months months to add
+     */
+    static addMonths(date: Date, months: number): Date;
+    /**
+     * Add years to date
+     * @param date the date
+     * @param years years to add
+     */
+    static addYears(date: Date, years: number): Date;
+    /**
+     * Calculate number of days between two date
+     * @param startDate
+     * @param endDate
+     * @param absolute return unsigned result
+     */
+    static countDays(startDate: Date, endDate: Date, absolute?: boolean): number;
+    /**
+     * Check if string is a date with iso format
+     * @param value the string
+     */
+    static isIsoString(value: string | null): boolean;
+    /**
+     * Convert iso string to Date
+     * @param isoString the iso string
+     */
+    static isoStringToDate(isoString: string | null): Date | null;
+    /**
+     * Remove time from an iso date string
+     * @param isoString the iso string
+     */
+    static isoStringRemoveTime(isoString: string): string;
+    /**
+     * Set iso string hours to 0 and format correctly the date (consider timezone offset)
+     * @example '2024-03-04T23:00:00.000Z' -> '2024-03-05T00:00:00.000Z'
+     * @param isoString the iso string
+     */
+    static isoStringSetZeroTime(isoString: string): string;
+    /**
+     * Calculate the date time left and return the string format [d h m s]
+     * @param endDate
+     */
+    static timeLeftString(endDate: Date): Observable<string>;
+    /**
+     * Calculate the next day of week
+     * @param dayOfWeek Day of week 0=Sunday, 1=Monday...4=Thursday...
+     * @param hour the specif hour
+     * @param minute the specific minute
+     */
+    static nextWeekDayAndTime(dayOfWeek: number, hour?: number, minute?: number): Date;
+}

package/lib/utils/file-utils.d.ts

@@ -0,0 +1,32 @@
+import { Observable } from 'rxjs';
+export declare class ItFileUtils {
+    /**
+     * Return the file size string
+     * @param file the file
+     * @param decimals decimal to show
+     */
+    static getFileSizeString(file: File, decimals?: number): string;
+    /**
+     * Convert a file to base64 string
+     * @param file the base64 string
+     */
+    static fileToBase64(file: File): Observable<string>;
+    /**
+     * Convert base64 to Blob
+     * @param base64 the base64 string
+     * @param mimeType the <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types">MIME type</a> (example 'application/pdf')
+     */
+    static base64ToBlob(base64: string, mimeType: string): Blob;
+    /**
+     * Convert base64 to File
+     * @param base64 the base64 string
+     * @param mimeType the <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types">MIME type</a> (example 'application/pdf')
+     * @param filename the file name
+     */
+    static base64ToFile(base64: string, mimeType: string, filename: string): File;
+    /**
+     * Extract the MIME type from base64 string
+     * @param base64 the base64 string
+     */
+    static getMimeTypeFromBase64(base64: string): string | undefined;
+}

package/lib/utils/regex.d.ts

@@ -0,0 +1,34 @@
+/**
+ * General Email Regex (RFC 5322 Official Standard)
+ * http://emailregex.com/
+ */
+export declare const EMAIL_REGEX: RegExp;
+/**
+ * Phone number Regex
+ */
+export declare const PHONE_NUMBER_REGEX: RegExp;
+/**
+ * URL Regex
+ */
+export declare const URL_REGEX: RegExp;
+/**
+ * The italian tax code Regex (Codice Fiscale)
+ */
+export declare const ITALIAN_TAX_CODE_REGEX: RegExp;
+/**
+ * The VAT number Regex (Partita iva)
+ */
+export declare const VAT_NUMBER_REGEX: RegExp;
+/**
+ * Italian CAP Regex
+ */
+export declare const CAP_REGEX: RegExp;
+/**
+ * Italian Plate Regex
+ */
+export declare const PLATE_REGEX: RegExp;
+/**
+ * IBAN Regex
+ * https://blog.marketto.it/en/2018/06/validate-any-country-iban/
+ */
+export declare const IBAN_REGEX: RegExp;