monkey-style-guide 21.2.20 → 21.2.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monkey-style-guide",
-  "version": "21.2.20",
+  "version": "21.2.22",
   "peerDependencies": {
     "@angular/animations": "^21.2.4",
     "@angular/cdk": "^21.2.2",
@@ -30,5 +30,6 @@
       "types": "./types/monkey-style-guide.d.ts",
       "default": "./fesm2022/monkey-style-guide.mjs"
     }
-  }
+  },
+  "type": "module"
 }

package/types/monkey-style-guide.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { TemplateRef, EventEmitter, ElementRef, ComponentRef, InputSignal, OutputEmitterRef, AfterContentInit, AfterContentChecked, OnDestroy, ChangeDetectorRef, OnChanges, OnInit, InputSignalWithTransform, AfterViewInit, SimpleChanges, Renderer2, QueryList, StaticProvider, Injector, InjectionToken, ViewContainerRef, ApplicationRef } from '@angular/core';
+import { TemplateRef, EventEmitter, ElementRef, Signal, ComponentRef, InputSignal, OutputEmitterRef, AfterContentInit, AfterContentChecked, OnDestroy, ChangeDetectorRef, OnChanges, OnInit, InputSignalWithTransform, WritableSignal, AfterViewInit, SimpleChanges, Renderer2, QueryList, StaticProvider, Injector, InjectionToken, ViewContainerRef, ApplicationRef } from '@angular/core';
 import { NgControl, AbstractControlDirective, ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 import * as rxjs from 'rxjs';
 import { Observable, Subject, BehaviorSubject } from 'rxjs';
@@ -185,6 +185,12 @@ type ToastConfig = {
     action?: () => void;
     closeOnAction?: boolean;
 };
+type DownloadToastConfig = Pick<ToastConfig, 'message' | 'position' | 'duration' | 'keepOpen'> & {
+    id?: string;
+    progress?: number | Signal<number>;
+    onCancel?: () => void;
+    onDownload?: () => void;
+};
 
 /** ************************
  * Copyright Monkey Exchange. All Rights Reserved
@@ -671,6 +677,117 @@ declare class MonkeyDownloadButtonComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<MonkeyDownloadButtonComponent, "monkey-download-button", never, { "progress": { "alias": "progress"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "color": { "alias": "color"; "required": false; }; "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "id": { "alias": "id"; "required": false; }; }, { "onChange": "onChange"; }, never, ["[first]", "*", "[last]"], true, never>;
 }
 
+/** ************************
+ * Copyright Monkey Exchange. All Rights Reserved
+ * This style guide was developed by Monkey Exchange Team
+ * MIT Licence
+ ************************* */
+declare const DOWNLOAD_TOAST_EXIT_MS = 200;
+interface DownloadToastDictionary {
+    singular: string;
+    plural: string;
+    expand: string;
+    defaultMessage: string;
+    cancel: string;
+    close: string;
+    download: string;
+}
+
+/** ************************
+ * Copyright Monkey Exchange. All Rights Reserved
+ * This style guide was developed by Monkey Exchange Team
+ * MIT Licence
+ ************************* */
+
+declare class MonkeyDownloadToastComponent {
+    protected readonly host: ElementRef<HTMLElement>;
+    readonly message: InputSignal<string>;
+    readonly progress: InputSignal<number>;
+    readonly id: InputSignal<string>;
+    readonly onCancel: OutputEmitterRef<void>;
+    readonly onClose: OutputEmitterRef<string>;
+    readonly onDownload: OutputEmitterRef<void>;
+    protected readonly dict: Signal<DownloadToastDictionary>;
+    protected readonly displayMessage: Signal<string>;
+    protected readonly safeProgress: Signal<number>;
+    protected readonly isBusy: Signal<boolean>;
+    protected readonly isComplete: Signal<boolean>;
+    constructor(host: ElementRef<HTMLElement>);
+    protected handleEscape(): void;
+    protected onCancelPressed(): void;
+    protected onDownloadPressed(): void;
+    close(): void;
+    protected onAnimationEnd(event: AnimationEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MonkeyDownloadToastComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MonkeyDownloadToastComponent, "monkey-download-toast", never, { "message": { "alias": "message"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "onCancel": "onCancel"; "onClose": "onClose"; "onDownload": "onDownload"; }, never, never, true, never>;
+}
+
+/** ************************
+ * Copyright Monkey Exchange. All Rights Reserved
+ * This style guide was developed by Monkey Exchange Team
+ * MIT Licence
+ ************************* */
+
+interface DownloadStackItem {
+    id: string;
+    message: string;
+    progress: number | Signal<number>;
+    onCancel?: () => void;
+    onDownload?: () => void;
+}
+type DownloadStackItemUpdate = Partial<Pick<DownloadStackItem, 'message' | 'progress'>>;
+interface DownloadStackRow {
+    item: DownloadStackItem;
+    depth: number;
+    leaving: boolean;
+}
+declare class MonkeyDownloadToastStackComponent {
+    protected readonly position: InputSignal<string>;
+    readonly items: WritableSignal<DownloadStackItem[]>;
+    readonly expanded: WritableSignal<boolean>;
+    readonly isMobile: WritableSignal<boolean>;
+    protected readonly dict: Signal<DownloadToastDictionary>;
+    protected readonly maxVisible: number;
+    private readonly cardEl;
+    private readonly cardHeight;
+    private readonly rendered;
+    private readonly leavingDepth;
+    private readonly exitTimers;
+    private readonly count;
+    private collapseTimer?;
+    private readonly mobileMediaQuery;
+    constructor();
+    protected readonly listId: string;
+    protected readonly hasItems: Signal<boolean>;
+    protected readonly isCollapsible: Signal<boolean>;
+    protected readonly isCollapsed: Signal<boolean>;
+    protected readonly showCounter: Signal<boolean>;
+    protected readonly rows: Signal<DownloadStackRow[]>;
+    protected readonly stackStyle: Signal<Record<string, string>>;
+    protected readonly headerLabel: Signal<string>;
+    protected readonly expandLabel: Signal<string>;
+    private supportsHover;
+    private cancelExits;
+    private cancelAutoCollapse;
+    private scheduleAutoCollapse;
+    protected open(): void;
+    protected onHoverIntent(): void;
+    protected onHoverMove(): void;
+    protected onHoverLeave(): void;
+    protected toggleExpanded(): void;
+    add(item: DownloadStackItem): void;
+    update(id: string, changes: DownloadStackItemUpdate): void;
+    remove(id: string): void;
+    private unmount;
+    private clearExit;
+    protected getProgress(item: DownloadStackItem): number;
+    protected handleCancel(item: DownloadStackItem): void;
+    protected handleDownload(item: DownloadStackItem): void;
+    protected handleClose(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MonkeyDownloadToastStackComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MonkeyDownloadToastStackComponent, "monkey-download-toast-stack", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /** ************************
  * Copyright Monkey Exchange. All Rights Reserved
  * This style guide was developed by Monkey Exchange Team
@@ -934,6 +1051,7 @@ declare class MonkeyFilterBarComponent {
     private readonly _localeId;
     private readonly _currencyPipe;
     private readonly _scrollbar;
+    private readonly _rowEl;
     private readonly _text;
     private _commitTimer;
     private readonly _reported;
@@ -950,6 +1068,7 @@ declare class MonkeyFilterBarComponent {
     protected readonly calendarOpen: i0.WritableSignal<string | null>;
     protected readonly categorySearch: i0.WritableSignal<string>;
     protected readonly immediateTriggerExit: i0.WritableSignal<boolean>;
+    protected readonly scrollVisible: i0.WritableSignal<boolean>;
     protected textValue: string;
     protected textValue2: string;
     protected currencyValue: number | null;
@@ -980,7 +1099,7 @@ declare class MonkeyFilterBarComponent {
     protected readonly addOptions: i0.Signal<MonkeyFilterBarOption[]>;
     protected readonly canAddFilter: i0.Signal<boolean>;
     protected readonly changeOptions: i0.Signal<MonkeyFilterBarOption[]>;
-    protected readonly triggerVariant: i0.Signal<"text" | "icon">;
+    protected readonly triggerVariant: i0.Signal<"icon" | "text">;
     protected readonly triggerIcon: i0.Signal<"filter" | "add-plus">;
     protected readonly triggerFlipId: i0.Signal<"trigger-text" | "trigger-icon">;
     constructor();
@@ -1003,6 +1122,8 @@ declare class MonkeyFilterBarComponent {
     private lastMovingSlot;
     private withFlip;
     private scheduleRemeasure;
+    private rowOverflows;
+    private syncScrollbar;
     protected onSlotSettled(event: Event): void;
     protected operatorLabel(operator: MonkeyFilterCondition): string;
     protected isOpen(rowKey: string, part: OpenPanel['part']): boolean;
@@ -2506,7 +2627,7 @@ declare class MonkeyTooltipComponent {
  ************************* */
 
 type Position = 'top' | 'bottom' | 'left' | 'right' | undefined;
-declare class MonkeyTooltipDirective {
+declare class MonkeyTooltipDirective implements OnDestroy {
     private viewContainerRef;
     private elementRef;
     private appRef;
@@ -2519,6 +2640,12 @@ declare class MonkeyTooltipDirective {
     private bounds;
     constructor(viewContainerRef: ViewContainerRef, elementRef: ElementRef, appRef: ApplicationRef, document: Document);
     private setBounds;
+    /**
+     * The top layer paints above every stacking context and ignores z-index entirely, so the
+     * tooltip cannot be covered by an overlay, a modal or application chrome. Browsers without
+     * the popover API fall back to the z-index in the component styles.
+     */
+    private raiseToTopLayer;
     private createTooltip;
     private positionTooltip;
     private isOutOfBounds;
@@ -2529,6 +2656,7 @@ declare class MonkeyTooltipDirective {
     show(): void;
     hide(): void;
     onScroll(): void;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MonkeyTooltipDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<MonkeyTooltipDirective, "[monkeyTooltip]", never, { "tooltipText": { "alias": "monkeyTooltip"; "required": false; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; }; "enabled": { "alias": "enabled"; "required": false; }; }, {}, never, never, true, never>;
     static ngAcceptInputType_enabled: unknown;
@@ -2757,6 +2885,47 @@ declare class MonkeyDictionaryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<MonkeyDictionaryService>;
 }
 
+declare class MonkeyDownloadToastService {
+    private overlay;
+    private injector;
+    private downloadStacks;
+    private effectHolders;
+    private handleStates;
+    private disposeTimers;
+    private closeTimers;
+    constructor();
+    private teardown;
+    private getStackKey;
+    private cancelPendingDispose;
+    private scheduleDispose;
+    private getOrCreateDownloadStack;
+    private buildDownloadItem;
+    private releaseEffect;
+    private tryDisposeEmptyStack;
+    private buildDoRemove;
+    private shouldAutoCloseOnComplete;
+    private cancelPendingClose;
+    private scheduleClose;
+    private setupSignalAutoClose;
+    private scheduleNumberAutoClose;
+    private getEffectHolder;
+    private getHandleState;
+    private invalidateHandleStates;
+    private findStackWithId;
+    private disposeStackIfEmpty;
+    private removeById;
+    show(config: DownloadToastConfig): {
+        id: string;
+        close: () => void;
+        update: (partial: DownloadStackItemUpdate) => void;
+    };
+    close(id: string): void;
+    update(id: string, partial: DownloadStackItemUpdate): void;
+    closeAll(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MonkeyDownloadToastService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MonkeyDownloadToastService>;
+}
+
 declare class MonkeyStepperService {
     private _steppers;
     currentStep(id: string): i0.Signal<string | undefined>;
@@ -2766,9 +2935,19 @@ declare class MonkeyStepperService {
 }
 
 declare class MonkeyToastService {
-    private lastToast?;
     private overlay;
-    private getPositionStrategy;
+    private current?;
+    private activeToasts;
+    constructor();
+    private teardown;
+    private release;
+    private requestClose;
+    private closePreviousToastIfNeeded;
+    private configureToastInstance;
+    private bindToastAction;
+    private closeToastIfNeeded;
+    private bindToastRelease;
+    private scheduleToastAutoClose;
     show(toastConfig: ToastConfig): MonkeyToastComponent;
     static ɵfac: i0.ɵɵFactoryDeclaration<MonkeyToastService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MonkeyToastService>;
@@ -2787,5 +2966,5 @@ declare const MECX_GOOGLE_API_KEY: InjectionToken<string>;
 declare const MECX_I18N_LANG: InjectionToken<BehaviorSubject<string>>;
 declare function injectTokenWithWarning<T>(token: InjectionToken<T>, name?: string): T | null;
 
-export { MECX_COUNTRY_ISO_CODE, MECX_GOOGLE_API_KEY, MECX_I18N_LANG, MECX_I18N_WRAPPER, MECX_MODAL_DATA, MECX_MODAL_DEFAULT_CONFIG, MECX_POPOVER_OPTIONS, MonkeyAccordionComponent, MonkeyActionBarComponent, MonkeyAlertComponent, MonkeyAutocompleteAddressComponent, MonkeyAutocompleteComponent, MonkeyAvatarComponent, MonkeyBadgeComponent, MonkeyBadgeDirective, MonkeyBreadcrumbComponent, MonkeyButtonComponent, MonkeyCheckboxComponent, MonkeyComplexFilterBarComponent, MonkeyDateRangeComponent, MonkeyDictionaryService, MonkeyDisplayDirective, MonkeyDividerComponent, MonkeyDownloadButtonComponent, MonkeyEcxAddressService, MonkeyErrorDirective, MonkeyFilterBarComponent, MonkeyFilterBarService, MonkeyFilterChipComponent, MonkeyFilterMenuComponent, MonkeyFilterMenuItemComponent, MonkeyFilterSegmentComponent, MonkeyFilterTriggerComponent, MonkeyFormDirective, MonkeyFormFieldComponent, MonkeyFormFieldControl, MonkeyFormFieldModule, MonkeyHelperDirective, MonkeyIconButtonComponent, MonkeyInfoDirective, MonkeyInputCodeComponent, MonkeyInputCurrencyDirective, MonkeyInputDateRangeComponent, MonkeyInputDirective, MonkeyInputModule, MonkeyInputPhoneComponent, MonkeyInputUploadComponent, MonkeyLabelDirective, MonkeyModalActionsDirective, MonkeyModalComponent, MonkeyModalConfig, MonkeyModalContentDirective, MonkeyModalModule, MonkeyModalRef, MonkeyModalService, MonkeyModalSubtitleDirective, MonkeyModalTitleDirective, MonkeyOptionComponent, MonkeyPaginationActionComponent, MonkeyPaginationLabelComponent, MonkeyPaginationSizeComponent, MonkeyPassNumberComponent, MonkeyPassSecretNumberComponent, MonkeyPopoverContentComponent, MonkeyPopoverDirective, MonkeyPrefixDirective, MonkeyRadioButtonComponent, MonkeyScrollbarComponent, MonkeySecurityLevelComponent, MonkeySelectComponent, MonkeyStatusComponent, MonkeyStepComponent, MonkeyStepperComponent, MonkeyStepperModule, MonkeyStepperService, MonkeySuffixDirective, MonkeyTabComponent, MonkeyTabLinkDirective, MonkeyTableCellDirective, MonkeyTableColumnDirective, MonkeyTableComponent, MonkeyTableEmptyDirective, MonkeyTableHeaderCellDirective, MonkeyTableLoadingDirective, MonkeyTableRowDetailDirective, MonkeyTabsComponent, MonkeyTabsModule, MonkeyToastComponent, MonkeyToastRef, MonkeyToastService, MonkeyToggleComponent, MonkeyToggleLineButtonComponent, MonkeyToggleLineComponent, MonkeyTooltipComponent, MonkeyTooltipDirective, MonkeyUserProfileButtonComponent, MonkeyUserProfileComponent, addKeys, appliedFrom, ariaSortOf, arityOf, conditionsOf, getCurrencySymbol, indexAtOffset, injectTokenWithWarning, interpolate, isComplete, mergeOrder, offsetOfIndex, panelOf, removeKeys, sameColumnState, selectionState, sortByOrder, toPx, toggleKey, totalHeight, withCondition, withType };
-export type { ActiveFilter, AutocompleteSuggestion, AutocompleteSuggestionType, ColumnAlign, ColumnPinned, ComplexFilterCondition, ComplexFilterGroup, ComplexFilterOperator, ComplexFilterResult, FilterBarConfig, FilterBarState, FilterOption, FilterType, GoogleApiPlaces, GoogleApiPlacesAddressComponents, GoogleApiPlacesResponse, MonkeyAlertType, MonkeyAppliedFilter, MonkeyAutocompleteData, MonkeyAutocompleteResponse, MonkeyBreadcrumb, MonkeyButtonColor, MonkeyButtonType, MonkeyDownloadButtonChangeEvent, MonkeyFilterArity, MonkeyFilterBarConfig, MonkeyFilterBarOption, MonkeyFilterBarStatusOption, MonkeyFilterBarType, MonkeyFilterCondition, MonkeyFilterMenuItemProperty, MonkeyFilterOperand, MonkeyFilterOperator, MonkeyFilterPanel, MonkeyFilterRow, MonkeyFilterTriggerVariant, MonkeyInputUploadChangeEvent, MonkeyModalConfirmationConfig, MonkeyModalDefaultConfig, MonkeyPopoverDir, MonkeyPopoverOptions, MonkeyScrollbarOrientation, MonkeyScrollbarSize, MonkeySize, MonkeyTableCellContext, MonkeyTableColumnState, MonkeyTableScrollConfig, MonkeyTableSortKind, MonkeyToastPosition, MonkeyToastType, RowMetrics, SelectionState, SortDirection, SortState, StatusOption, ToastConfig };
+export { DOWNLOAD_TOAST_EXIT_MS, MECX_COUNTRY_ISO_CODE, MECX_GOOGLE_API_KEY, MECX_I18N_LANG, MECX_I18N_WRAPPER, MECX_MODAL_DATA, MECX_MODAL_DEFAULT_CONFIG, MECX_POPOVER_OPTIONS, MonkeyAccordionComponent, MonkeyActionBarComponent, MonkeyAlertComponent, MonkeyAutocompleteAddressComponent, MonkeyAutocompleteComponent, MonkeyAvatarComponent, MonkeyBadgeComponent, MonkeyBadgeDirective, MonkeyBreadcrumbComponent, MonkeyButtonComponent, MonkeyCheckboxComponent, MonkeyComplexFilterBarComponent, MonkeyDateRangeComponent, MonkeyDictionaryService, MonkeyDisplayDirective, MonkeyDividerComponent, MonkeyDownloadButtonComponent, MonkeyDownloadToastComponent, MonkeyDownloadToastService, MonkeyDownloadToastStackComponent, MonkeyEcxAddressService, MonkeyErrorDirective, MonkeyFilterBarComponent, MonkeyFilterBarService, MonkeyFilterChipComponent, MonkeyFilterMenuComponent, MonkeyFilterMenuItemComponent, MonkeyFilterSegmentComponent, MonkeyFilterTriggerComponent, MonkeyFormDirective, MonkeyFormFieldComponent, MonkeyFormFieldControl, MonkeyFormFieldModule, MonkeyHelperDirective, MonkeyIconButtonComponent, MonkeyInfoDirective, MonkeyInputCodeComponent, MonkeyInputCurrencyDirective, MonkeyInputDateRangeComponent, MonkeyInputDirective, MonkeyInputModule, MonkeyInputPhoneComponent, MonkeyInputUploadComponent, MonkeyLabelDirective, MonkeyModalActionsDirective, MonkeyModalComponent, MonkeyModalConfig, MonkeyModalContentDirective, MonkeyModalModule, MonkeyModalRef, MonkeyModalService, MonkeyModalSubtitleDirective, MonkeyModalTitleDirective, MonkeyOptionComponent, MonkeyPaginationActionComponent, MonkeyPaginationLabelComponent, MonkeyPaginationSizeComponent, MonkeyPassNumberComponent, MonkeyPassSecretNumberComponent, MonkeyPopoverContentComponent, MonkeyPopoverDirective, MonkeyPrefixDirective, MonkeyRadioButtonComponent, MonkeyScrollbarComponent, MonkeySecurityLevelComponent, MonkeySelectComponent, MonkeyStatusComponent, MonkeyStepComponent, MonkeyStepperComponent, MonkeyStepperModule, MonkeyStepperService, MonkeySuffixDirective, MonkeyTabComponent, MonkeyTabLinkDirective, MonkeyTableCellDirective, MonkeyTableColumnDirective, MonkeyTableComponent, MonkeyTableEmptyDirective, MonkeyTableHeaderCellDirective, MonkeyTableLoadingDirective, MonkeyTableRowDetailDirective, MonkeyTabsComponent, MonkeyTabsModule, MonkeyToastComponent, MonkeyToastRef, MonkeyToastService, MonkeyToggleComponent, MonkeyToggleLineButtonComponent, MonkeyToggleLineComponent, MonkeyTooltipComponent, MonkeyTooltipDirective, MonkeyUserProfileButtonComponent, MonkeyUserProfileComponent, addKeys, appliedFrom, ariaSortOf, arityOf, conditionsOf, getCurrencySymbol, indexAtOffset, injectTokenWithWarning, interpolate, isComplete, mergeOrder, offsetOfIndex, panelOf, removeKeys, sameColumnState, selectionState, sortByOrder, toPx, toggleKey, totalHeight, withCondition, withType };
+export type { ActiveFilter, AutocompleteSuggestion, AutocompleteSuggestionType, ColumnAlign, ColumnPinned, ComplexFilterCondition, ComplexFilterGroup, ComplexFilterOperator, ComplexFilterResult, DownloadStackItem, DownloadStackItemUpdate, DownloadToastConfig, DownloadToastDictionary, FilterBarConfig, FilterBarState, FilterOption, FilterType, GoogleApiPlaces, GoogleApiPlacesAddressComponents, GoogleApiPlacesResponse, MonkeyAlertType, MonkeyAppliedFilter, MonkeyAutocompleteData, MonkeyAutocompleteResponse, MonkeyBreadcrumb, MonkeyButtonColor, MonkeyButtonType, MonkeyDownloadButtonChangeEvent, MonkeyFilterArity, MonkeyFilterBarConfig, MonkeyFilterBarOption, MonkeyFilterBarStatusOption, MonkeyFilterBarType, MonkeyFilterCondition, MonkeyFilterMenuItemProperty, MonkeyFilterOperand, MonkeyFilterOperator, MonkeyFilterPanel, MonkeyFilterRow, MonkeyFilterTriggerVariant, MonkeyInputUploadChangeEvent, MonkeyModalConfirmationConfig, MonkeyModalDefaultConfig, MonkeyPopoverDir, MonkeyPopoverOptions, MonkeyScrollbarOrientation, MonkeyScrollbarSize, MonkeySize, MonkeyTableCellContext, MonkeyTableColumnState, MonkeyTableScrollConfig, MonkeyTableSortKind, MonkeyToastPosition, MonkeyToastType, RowMetrics, SelectionState, SortDirection, SortState, StatusOption, ToastConfig };