@entake/particle 17.0.0

package/app/modules/date-picker/date-picker.component.d.ts

@@ -0,0 +1,259 @@
+import { ChangeDetectorRef, ElementRef, EventEmitter, OnDestroy, OnInit, Renderer2 } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { DatePickerText } from '../../shared/models/particle-component-text.model';
+import { PopoverComponent } from '../popover/popover.component';
+import * as i0 from "@angular/core";
+/**
+ * Component to allow a user to input/select a date
+ */
+export declare class DatePickerComponent implements ControlValueAccessor, OnDestroy, OnInit {
+    private renderer;
+    private changeDetectorRef;
+    /**
+     * Allowed keys for date input
+     */
+    private static readonly ALLOWED_KEYS;
+    /**
+     * Matches YYYY-MM-DD
+     * @private
+     */
+    private static readonly BROWSER_DATE_PICKER_FORMAT;
+    /**
+     * Matches MM/DD/YYYY
+     * @private
+     */
+    private static readonly FULL_DATE_FORMAT;
+    /**
+     * Matches M/D/YYYY
+     * @private
+     */
+    private static readonly SHORT_DATE_FORMAT;
+    /**
+     * Matches M/DD/YYYY
+     * @private
+     */
+    private static readonly SHORT_MONTH_DATE_FORMAT;
+    /**
+     * Matches MM/D/YYYY
+     * @private
+     */
+    private static readonly SHORT_DAY_DATE_FORMAT;
+    /**
+     * A reference date with all fields set to 0
+     * @private
+     */
+    private static readonly referenceDate;
+    /**
+     * Value input setter
+     */
+    set value(value: Date);
+    set disabled(disabled: boolean);
+    set dateRange(dateRange: {
+        minDate: Date;
+        maxDate: Date;
+    });
+    /**
+     * The ID to set on the input
+     */
+    inputId: string;
+    /**
+     * Value to use as the date picker input's aria label
+     */
+    ariaLabel: string;
+    /**
+     * Optional class-list to add to the date picker input
+     */
+    inputClassList: any;
+    /**
+     * Optional class-list to add to the calendar button
+     */
+    calendarButtonClassList: string;
+    /**
+     * Close the picker when a selection is made
+     */
+    closeOnSelect: boolean;
+    /**
+     * Placeholder override
+     */
+    placeholder: string;
+    inputOnly: boolean;
+    private _text;
+    set text(text: DatePickerText);
+    get text(): DatePickerText;
+    /**
+     * Event emitted on date picker input
+     */
+    input: EventEmitter<void>;
+    /**
+     * Event emitted on valid date selection/input
+     */
+    dateSelected: EventEmitter<Date>;
+    /**
+     * ViewChild of the date picker div
+     */
+    datePickerDiv: ElementRef<HTMLDivElement>;
+    /**
+     * ViewChild of the calendar div
+     */
+    calendarDiv: ElementRef<HTMLDivElement>;
+    calendarPopover: PopoverComponent;
+    /**
+     * The current date
+     */
+    private readonly currentDate;
+    /**
+     * The fixed height of the calendar widget
+     */
+    private readonly calendarHeight;
+    /**
+     * The fixed width of the calendar widget
+     */
+    private readonly calendarWidth;
+    /**
+     * The amount of padding to apply between the date picker input and the calendar widget
+     */
+    private readonly calendarPadding;
+    /**
+     * String tracking date picker input
+     */
+    dateString: string;
+    mobileDateString: string;
+    /**
+     * Whether to show the calendar
+     */
+    showCalendar: {
+        currentValue: Date;
+    };
+    /**
+     * In mobile (screen width is less than 768), swap to a native input
+     */
+    isMobile: boolean;
+    /**
+     * The valid selection interval
+     * @private
+     */
+    validSelectionInterval: {
+        start: Date;
+        end: Date;
+    };
+    /**
+     * The internal control accessor value
+     * @private
+     */
+    private _value;
+    /**
+     * The internal disabled state
+     * @private
+     */
+    private _disabled;
+    /**
+     * Window resize unlisten function
+     */
+    private resizeListener;
+    /**
+     * Parse the input Date value into a string
+     * @param value the value to parse
+     * @private
+     */
+    private static parseDate;
+    /**
+     * Parse the input date string into a Date
+     * @param dateString the string to parse
+     * @private
+     */
+    private static parseDateString;
+    /**
+     * Get the date format that matches the input date string, null if no match
+     * @param dateString the string to test
+     * @private
+     */
+    private static getDateFormat;
+    /**
+     * Function to call on change
+     */
+    onChange: (value: any) => void;
+    /**
+     * Function to call on touch
+     */
+    onTouched: () => any;
+    /**
+     * Dependency injection site
+     * @param renderer the Angular renderer
+     * @param changeDetectorRef the Angular change detector
+     */
+    constructor(renderer: Renderer2, changeDetectorRef: ChangeDetectorRef);
+    /**
+     * Value getter
+     */
+    get value(): Date;
+    /**
+     * Disabled getter
+     */
+    get disabled(): boolean;
+    onWindowResize(event: any): void;
+    /**
+     * Init component, set up window resize listener
+     */
+    ngOnInit(): void;
+    /**
+     * Destroy component, invoke window resize unlisten function
+     */
+    ngOnDestroy(): void;
+    /**
+     * Write value
+     * @param value the value to write
+     */
+    writeValue(value: Date): void;
+    /**
+     * Register control value accessor change function
+     * @param fn the function to register
+     */
+    registerOnChange(fn: (value: any) => void): void;
+    /**
+     * Register touch handler
+     * @param fn the touch handler to register
+     */
+    registerOnTouched(fn: any): void;
+    /**
+     * Set the disabled state
+     * @param isDisabled whether or not the component should be disabled
+     */
+    setDisabledState?(isDisabled: boolean): void;
+    /**
+     * Only allow input from digits, forward slashes, and navigation keys
+     */
+    filterInput(event: KeyboardEvent): void;
+    /**
+     * Clear value if no input, write parsed date if input requirements fulfilled
+     */
+    handleBlur(): void;
+    /**
+     * Write on input if valid date within interval
+     */
+    handleInput(): void;
+    handleMobileInput(): void;
+    setMobileValue(): void;
+    /**
+     * Update the model value
+     * @param value the value to update the model to
+     */
+    updateModel(value: Date): void;
+    /**
+     * Open the calendar widget
+     * @param event the click MouseEvent
+     */
+    openCalendar(event?: MouseEvent): void;
+    /**
+     * Hide calendar overlay and remove calendar from the DOM
+     */
+    handleCalendarClose(): void;
+    /**
+     * Calculate and set the calendar's position based on the screen height.
+     * Positioning prefers to open at the bottom, if not enough room on bottom,
+     * positioning is attempted at the top, otherwise it attempts to vertically
+     * center
+     */
+    private setCalendarPosition;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerComponent, "particle-date-picker", never, { "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "dateRange": { "alias": "dateRange"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "inputClassList": { "alias": "inputClassList"; "required": false; }; "calendarButtonClassList": { "alias": "calendarButtonClassList"; "required": false; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "inputOnly": { "alias": "inputOnly"; "required": false; }; "text": { "alias": "text"; "required": false; }; }, { "input": "input"; "dateSelected": "dateSelected"; }, never, never, false, never>;
+}

package/app/modules/date-picker/date-picker.module.d.ts

@@ -0,0 +1,15 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./date-picker.component";
+import * as i2 from "./components/calendar/calendar.component";
+import * as i3 from "./components/date-range-picker/date-range-picker.component";
+import * as i4 from "@angular/cdk/a11y";
+import * as i5 from "@angular/platform-browser/animations";
+import * as i6 from "@angular/common";
+import * as i7 from "@angular/forms";
+import * as i8 from "../ordinal-number-pipe/ordinal-number-pipe.module";
+import * as i9 from "../popover/popover.module";
+export declare class ParticleDatePickerModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ParticleDatePickerModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ParticleDatePickerModule, [typeof i1.DatePickerComponent, typeof i2.CalendarComponent, typeof i3.DateRangePickerComponent], [typeof i4.A11yModule, typeof i5.BrowserAnimationsModule, typeof i6.CommonModule, typeof i7.FormsModule, typeof i8.ParticleOrdinalNumberPipeModule, typeof i9.ParticlePopoverModule], [typeof i1.DatePickerComponent, typeof i2.CalendarComponent, typeof i3.DateRangePickerComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ParticleDatePickerModule>;
+}

package/app/modules/dialog/dialog.component.d.ts

@@ -0,0 +1,87 @@
+import { ElementRef, EventEmitter } from '@angular/core';
+import { DialogService } from '../../shared/services/dialog.service';
+import { Observable } from 'rxjs';
+import { AnimationEvent } from '@angular/animations';
+import { DialogText } from '../../shared/models/particle-component-text.model';
+import * as i0 from "@angular/core";
+/**
+ * Component to display a dialog with dynamic content
+ */
+export declare class DialogComponent {
+    private dialogService;
+    /**
+     * Element reference to the dialog close button
+     */
+    closeButton: ElementRef<HTMLButtonElement>;
+    /**
+     * Observable to update the effective width of the dialog on screen resize
+     */
+    effectiveWidth$: Observable<string>;
+    /**
+     * Object to operate whether the dialog is open/closed
+     */
+    private _object;
+    /**
+     * Object to operate whether the dialog is open/closed
+     */
+    set object(value: any);
+    get object(): any;
+    /**
+     * Title to show at the top of the dialog
+     */
+    title: string;
+    /**
+     * Class to apply to the title of the dialog
+     */
+    titleClass: string;
+    /**
+     * Show or hide the title bar
+     */
+    showTitle: boolean;
+    /**
+     * Whether to show close button and allow escape to close
+     */
+    allowClose: boolean;
+    /**
+     * Class to apply to the body of the dialog
+     */
+    bodyClass: string;
+    /**
+     * Height of the dialog (can use any height measurement)
+     */
+    height: string;
+    /**
+     * Width of the dialog (can use any width measurement)
+     */
+    width: string;
+    borderRadius: string;
+    text: DialogText;
+    /**
+     * Event Emitter for when the dialog is closed
+     */
+    closed: EventEmitter<any>;
+    /**
+     * Event emitted when dialog has finished opening
+     */
+    opened: EventEmitter<void>;
+    /**
+     * Dependency injection site
+     * @param dialogService the dialog service
+     */
+    constructor(dialogService: DialogService);
+    /**
+     * Null the object to close the dialog, emit the close event.
+     */
+    close(): void;
+    /**
+     * Method for compatibility with legacy dialog API. Method does nothing.
+     */
+    open(): void;
+    /**
+     * Emit closed/opened events based on state when dialog animation ends
+     * @param event
+     */
+    onAnimationDone(event: AnimationEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DialogComponent, "particle-dialog", never, { "object": { "alias": "object"; "required": false; }; "title": { "alias": "title"; "required": false; }; "titleClass": { "alias": "titleClass"; "required": false; }; "showTitle": { "alias": "showTitle"; "required": false; }; "allowClose": { "alias": "allowClose"; "required": false; }; "bodyClass": { "alias": "bodyClass"; "required": false; }; "height": { "alias": "height"; "required": false; }; "width": { "alias": "width"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "text": { "alias": "text"; "required": false; }; }, { "closed": "closed"; "opened": "opened"; }, never, ["*"], false, never>;
+}

package/app/modules/dialog/dialog.module.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./dialog.component";
+import * as i2 from "@angular/common";
+import * as i3 from "@angular/cdk/a11y";
+export declare class ParticleDialogModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ParticleDialogModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ParticleDialogModule, [typeof i1.DialogComponent], [typeof i2.CommonModule, typeof i3.A11yModule], [typeof i1.DialogComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ParticleDialogModule>;
+}

package/app/modules/dropdown/dropdown.component.d.ts

@@ -0,0 +1,288 @@
+import { AnimationEvent } from '@angular/animations';
+import { ChangeDetectorRef, ElementRef, EventEmitter, QueryList, Renderer2, TemplateRef } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { BehaviorSubject, Observable } from 'rxjs';
+import { DropdownOption } from './models/dropdown-option.model';
+import { DropdownOptionGroup } from './models/dropdown-option-group.model';
+import { DropdownText } from '../../shared/models/particle-component-text.model';
+import * as i0 from "@angular/core";
+/**
+ * Type representing the dropdown component option input
+ */
+declare type DropdownOptionInput = Array<DropdownOption | DropdownOptionGroup>;
+/**
+ * Dropdown component
+ */
+export declare class DropdownComponent implements ControlValueAccessor {
+    private renderer;
+    private changeDetectorRef;
+    /**
+     * Set the value of the dropdown
+     * @param value the value to set
+     */
+    set value(value: string | number);
+    get value(): string | number;
+    /**
+     * The dropdown options/option groups
+     */
+    set options(options: DropdownOptionInput);
+    /**
+     * Dependency injection site
+     * @param renderer the Angular renderer
+     * @param changeDetectorRef reference to the Angular change detector
+     */
+    constructor(renderer: Renderer2, changeDetectorRef: ChangeDetectorRef);
+    /**
+     * The amount of offset (in pixels) to place between the dropdown
+     * and its list overlay
+     * @private
+     */
+    private static readonly DROPDOWN_LIST_OFFSET;
+    /**
+     * List of arrow key keycodes
+     * @private
+     */
+    private static readonly ARROW_KEYS;
+    /**
+     * ViewChild of the dropdown
+     */
+    dropdown: ElementRef<HTMLDivElement>;
+    /**
+     * ViewChild of the dropdown button
+     */
+    dropdownButton: ElementRef<HTMLButtonElement>;
+    /**
+     * ViewChild of the dropdown list
+     */
+    dropdownList: ElementRef<HTMLDivElement>;
+    /**
+     * QueryList of dropdown option ViewChildren
+     */
+    dropdownOptions: QueryList<ElementRef<HTMLButtonElement>>;
+    /**
+     * ContentChild of the dropdown option template
+     */
+    template: TemplateRef<HTMLElement>;
+    /**
+     * Whether the dropdown should be disabled
+     */
+    disabled: boolean;
+    text: DropdownText;
+    /**
+     * Class list to assign to the dropdown
+     */
+    classList: string;
+    buttonClassList: string;
+    /**
+     * Event emitted on value change, emits the new value
+     */
+    change: EventEmitter<string | number>;
+    /**
+     * BehaviorSubject tracking the input dropdown options/option groups
+     */
+    readonly _options: BehaviorSubject<DropdownOptionInput>;
+    /**
+     * Full list of all active options, whether they are in a group or not
+     * @private
+     */
+    private _allOptions;
+    /**
+     * Typeahead string while users are typing into the input field
+     * @private
+     */
+    private _fullPredictiveTextString;
+    /**
+     * Timeout to clear the _fullPredictiveTextString after a user stops typing for a certain amount of time
+     * @private
+     */
+    private _timeout;
+    /**
+     * BehaviorSubject tracking the current value of the dropdown
+     */
+    readonly _internalValue: BehaviorSubject<string | number>;
+    /**
+     * Observable map of option value (stringified if a number) to data context
+     */
+    private readonly dataContextMap$;
+    /**
+     * The data context of the selected option as an Observable
+     */
+    readonly selectedDataContext$: Observable<{
+        [key: string]: unknown;
+    }>;
+    private static getAllOptions;
+    /**
+     * Unique ID to assign to the dropdown
+     */
+    readonly dropdownId: any;
+    /**
+     * Whether the dropdown should be rendered
+     */
+    render: boolean;
+    /**
+     * Whether the dropdown is open
+     */
+    opened: boolean;
+    /**
+     * The index of the focused option in the dropdown list
+     */
+    selectionIndex: number;
+    /**
+     * In mobile (screen width is less than 768), swap to a native input
+     */
+    isMobile: boolean;
+    /**
+     * The current value of the dropdown
+     * @private
+     */
+    private _value;
+    /**
+     * Removes options that do not have both a label and a value,
+     * also removes empty groups (or groups that have no valid options)
+     * @param options the options to sanitize
+     * @private
+     */
+    private static sanitizeOptionInput;
+    /**
+     * Add option label to data context if not present. If $implicit
+     * value is not present, it will be added with the label as its value.
+     * If $implicit is already present, it will add a label key to the context
+     * @param label the option label
+     * @param dataContext the option data context
+     * @private
+     */
+    private static addLabelToDataContext;
+    /**
+     * Function to call on change
+     */
+    onChange: (value: any) => void;
+    /**
+     * Function to call on touch
+     */
+    onTouched: () => any;
+    /**
+     * Write value
+     * @param value the value to write
+     */
+    writeValue(value: string | number): void;
+    /**
+     * Register function on change
+     * @param fn the function to register
+     */
+    registerOnChange(fn: any): void;
+    /**
+     * Register function on touch
+     * @param fn the function to register
+     */
+    registerOnTouched(fn: any): void;
+    /**
+     * Set the disabled state
+     * @param isDisabled disabled or not
+     */
+    setDisabledState?(isDisabled: boolean): void;
+    /**
+     * Reposition and resize the dropdown on window resize
+     */
+    onWindowResize(event: any): void;
+    /**
+     * Prevent default behavior for arrow key keydown event
+     * @param event the keydown KeyboardEvent
+     */
+    onKeyDown(event: KeyboardEvent): void;
+    /**
+     * Close the dropdown list on tab and handle arrow key navigation
+     * @param event the keyup KeyboardEvent
+     */
+    onKeyUp(event: KeyboardEvent): void;
+    /**
+     * Close the dropdown list (if opened) on click if outside the list
+     * @param event the click MouseEvent
+     */
+    onClick(event: MouseEvent): void;
+    /**
+     * Close dropdown on escape keyup and focus on dropdown button
+     * @param event the keyup KeyboardEvent
+     */
+    onEscapeKeyUp(event: Event): void;
+    /**
+     * Set focus to dropdown option on mouse enter and update selected index
+     * @param option the dropdown option to focus
+     * @param index the index of the option to focus
+     */
+    onDropdownOptionMouseEnter(option: HTMLButtonElement, index: number): void;
+    /**
+     * Set focus to dropdown option on mouse move and update selected index
+     * @param option the dropdown option to focus
+     * @param index the index of the option to focus
+     */
+    onDropdownOptionMouseMove(option: HTMLButtonElement, index: number): void;
+    /**
+     * Write value and close dropdown on option select
+     * @param value the value to write
+     * @param disabled whether or not the selected option is disabled
+     */
+    onDropdownOptionSelect(value: string | number, disabled: boolean): void;
+    /**
+     * Open the dropdown list and align it
+     * @param event the click MouseEvent
+     */
+    openDropdown(event: MouseEvent): void;
+    /**
+     * Close the dropdown list
+     */
+    closeDropdown(): void;
+    /**
+     * Position and resize dropdown list on animation start if toState is open
+     * @param event the Angular AnimationEvent
+     */
+    onAnimationStart(event: AnimationEvent): void;
+    /**
+     * Stop rendering dropdown list on animation done if toState is close
+     * @param event the Angular AnimationEvent
+     */
+    onAnimationDone(event: AnimationEvent): void;
+    /**
+     * Focus on the selected dropdown option on dropdown open
+     * @private
+     */
+    setSelectionIndex(): void;
+    /**
+     * Update internal value and emit change events if input value differs from current value
+     * @param value the selected value
+     * @private
+     */
+    private handleDropdownOptionSelect;
+    onModelChangeMobile(value: any): void;
+    /**
+     * Align the dropdown list with the dropdown
+     * @private
+     */
+    private positionDropdownList;
+    /**
+     * Match the dropdown list width to the dropdown's width
+     * @private
+     */
+    private resizeDropdownList;
+    /**
+     * Handle arrow keyup event
+     * @param key the arrow key
+     */
+    private onArrowKeyUp;
+    /**
+     * Get the next enabled dropdown option (relative to the current selection index).
+     * If the currently selected option is the final available option, it is
+     * returned. If no selection has been made, the first available option is returned
+     * @private
+     */
+    private getNextOption;
+    /**
+     * Get the previous enabled dropdown option (relative to the current selection index).
+     * If the currently selected option is the first available option, it is
+     * returned
+     * @private
+     */
+    private getPreviousOption;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "particle-dropdown", never, { "value": { "alias": "value"; "required": false; }; "options": { "alias": "options"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "text": { "alias": "text"; "required": false; }; "classList": { "alias": "classList"; "required": false; }; "buttonClassList": { "alias": "buttonClassList"; "required": false; }; }, { "change": "change"; }, ["template"], ["template"], false, never>;
+}
+export {};

package/app/modules/dropdown/dropdown.module.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./dropdown.component";
+import * as i2 from "@angular/common";
+import * as i3 from "@angular/forms";
+export declare class ParticleDropdownModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ParticleDropdownModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ParticleDropdownModule, [typeof i1.DropdownComponent], [typeof i2.CommonModule, typeof i3.FormsModule], [typeof i1.DropdownComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ParticleDropdownModule>;
+}

package/app/modules/dropdown/models/dropdown-option-group.model.d.ts

@@ -0,0 +1,16 @@
+import { DropdownOption } from './dropdown-option.model';
+/**
+ * Interface representing an array of dropdown options
+ * grouped under a label
+ */
+export interface DropdownOptionGroup {
+    type?: 'group';
+    /**
+     * The option group label
+     */
+    groupLabel: string;
+    /**
+     * The group options
+     */
+    options: Array<DropdownOption>;
+}