@acontplus/ng-components 2.1.9 → 2.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acontplus/ng-components",
-  "version": "2.1.9",
+  "version": "2.1.11",
   "description": "Comprehensive Angular Material UI component library featuring dynamic Tabulator tables, theme toggle with dark mode, dialog wrappers, autocomplete components, cards, buttons, icons, input chips, spinners, directives, pipes, and SCSS styling utilities.",
   "peerDependencies": {
     "@acontplus/ui-kit": "^1.0.2",

package/types/acontplus-ng-components.d.ts

@@ -1,9 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { Type, AfterViewInit, OnDestroy, ViewContainerRef, ElementRef, OnInit, TemplateRef, OnChanges, SimpleChanges, InjectionToken, QueryList, TrackByFunction, KeyValueChangeRecord, EventEmitter, ComponentRef, AfterContentInit, PipeTransform } from '@angular/core';
+import { Type, AfterViewInit, OnDestroy, ViewContainerRef, ElementRef, OnInit, TemplateRef, OnChanges, SimpleChanges, InjectionToken, QueryList, TrackByFunction, KeyValueChangeRecord, OutputEmitterRef, WritableSignal, EventEmitter, ComponentRef, AfterContentInit, PipeTransform } from '@angular/core';
 import { MatDialogRef } from '@angular/material/dialog';
 import { ScrollStrategy } from '@angular/cdk/overlay';
 import { FormControl, ControlValueAccessor } from '@angular/forms';
-import { SelectOption, IconDefinition, ButtonVariant, ButtonType, MaterialButtonStyle, REPORT_FORMAT } from '@acontplus/ui-kit';
+import { ButtonVariant, MaterialButtonStyle, SelectOption, IconDefinition, ButtonType as ButtonType$1, REPORT_FORMAT } from '@acontplus/ui-kit';
 import { SafeHtml } from '@angular/platform-browser';
 import { MatChipInputEvent, MatChipEditedEvent } from '@angular/material/chips';
 import { LiveAnnouncer, FocusOrigin } from '@angular/cdk/a11y';
@@ -18,9 +18,8 @@ import { MatBadgePosition, MatBadgeSize } from '@angular/material/badge';
 import { MatButtonAppearance } from '@angular/material/button';
 import { ThemePalette } from '@angular/material/core';
 import { TooltipPosition, TooltipTouchGestures } from '@angular/material/tooltip';
-import { MatFormFieldControl } from '@angular/material/form-field';
-import { DatexOptions } from 'datex-ui';
-export { BOOTSTRAP_THEME, DEFAULT_THEME, Datex, DatexCallback, DatexLocale, DatexOptions, DatexTheme, MATERIAL_THEME, SPANISH_LOCALE, SPANISH_LOCALE_WITH_TIME } from 'datex-ui';
+import { NgxDatexLocale, NgxDatexTheme, NgxDatexValue } from 'ngx-datex';
+export { MATERIAL_LIGHT_THEME, NgxDatex, NgxDatexConfig, NgxDatexLocale, NgxDatexRange, NgxDatexTheme, NgxDatexValue, SPANISH_LOCALE } from 'ngx-datex';
 import { ComponentType } from '@angular/cdk/portal';
 import { Direction } from '@angular/cdk/bidi';
 import { DialogRole, CdkDialogContainer, DialogRef } from '@angular/cdk/dialog';
@@ -434,6 +433,160 @@ declare class AutocompleteWrapperService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AutocompleteWrapperService>;
 }
 
+type AlertType = 'success' | 'error' | 'warning' | 'info' | 'question';
+type AlertPosition = 'top' | 'top-start' | 'top-end' | 'center' | 'center-start' | 'center-end' | 'bottom' | 'bottom-start' | 'bottom-end';
+interface AlertDialogOptions {
+    title?: string;
+    message?: string;
+    html?: string;
+    icon?: string;
+    iconColor?: string;
+    type?: AlertType;
+    width?: string;
+    minWidth?: string;
+    maxWidth?: string;
+    height?: string;
+    position?: AlertPosition;
+    customClass?: string;
+    panelClass?: string | string[];
+    backdropClass?: string;
+    component?: Type<any>;
+    componentProps?: {
+        [key: string]: any;
+    };
+    verticalButtons?: boolean;
+    fullWidthButtons?: boolean;
+    reverseButtons?: boolean;
+    timer?: number;
+    timerProgressBar?: boolean;
+    disableClose?: boolean;
+    closeOnBackdropClick?: boolean;
+    allowEscapeKey?: boolean;
+    allowEnterKey?: boolean;
+    scrollbarPadding?: boolean;
+    showConfirmButton?: boolean;
+    showCancelButton?: boolean;
+    showDenyButton?: boolean;
+    confirmText?: string;
+    cancelText?: string;
+    denyText?: string;
+    confirmButtonIcon?: string;
+    cancelButtonIcon?: string;
+    denyButtonIcon?: string;
+    confirmButtonVariant?: ButtonVariant;
+    cancelButtonVariant?: ButtonVariant;
+    denyButtonVariant?: ButtonVariant;
+    confirmButtonStyle?: MaterialButtonStyle;
+    cancelButtonStyle?: MaterialButtonStyle;
+    denyButtonStyle?: MaterialButtonStyle;
+    confirmButtonColor?: ThemePalette | string;
+    cancelButtonColor?: ThemePalette | string;
+    denyButtonColor?: ThemePalette | string;
+    disableConfirmButton?: boolean;
+    disableCancelButton?: boolean;
+    disableDenyButton?: boolean;
+    focusConfirm?: boolean;
+    focusCancel?: boolean;
+    focusDeny?: boolean;
+    processing?: boolean;
+    processingButton?: 'confirm' | 'cancel' | 'deny';
+    input?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'textarea';
+    inputLabel?: string;
+    inputPlaceholder?: string;
+    inputValue?: string;
+    inputValidator?: (value: string) => string | null | Promise<string | null>;
+    inputAttributes?: {
+        [key: string]: string;
+    };
+    imageUrl?: string;
+    imageWidth?: string;
+    imageHeight?: string;
+    imageAlt?: string;
+    footer?: string;
+    footerHtml?: string;
+    willOpen?: () => void;
+    didOpen?: () => void;
+    willClose?: () => void;
+    didClose?: () => void;
+    preConfirm?: (value?: string) => Promise<any> | any;
+    preDeny?: (value?: string) => Promise<any> | any;
+    showClass?: {
+        backdrop?: string;
+        popup?: string;
+    };
+    hideClass?: {
+        backdrop?: string;
+        popup?: string;
+    };
+    ariaLabel?: string;
+    ariaDescribedBy?: string;
+}
+interface AlertDialogResult<T = any> {
+    isConfirmed: boolean;
+    isDismissed: boolean;
+    isDenied: boolean;
+    value?: T;
+    dismiss?: 'backdrop' | 'cancel' | 'esc' | 'close' | 'timer';
+}
+declare class AlertDialogService {
+    private dialog;
+    private defaultOptions;
+    /**
+     * Configurar opciones por defecto para todos los diálogos
+     */
+    setDefaults(options: Partial<AlertDialogOptions>): void;
+    /**
+     * Obtener opciones por defecto actuales
+     */
+    getDefaults(): Partial<AlertDialogOptions>;
+    /**
+     * Resetear a opciones por defecto originales
+     */
+    resetDefaults(): void;
+    /**
+     * Muestra un diálogo de alerta con todas las opciones configurables
+     */
+    fire(options: AlertDialogOptions): Promise<AlertDialogResult>;
+    /**
+     * Alerta de éxito
+     */
+    success(options: string | Omit<AlertDialogOptions, 'type'>): Promise<AlertDialogResult>;
+    /**
+     * Alerta de error
+     */
+    error(options: string | Omit<AlertDialogOptions, 'type'>): Promise<AlertDialogResult>;
+    /**
+     * Alerta de advertencia
+     */
+    warning(options: string | Omit<AlertDialogOptions, 'type'>): Promise<AlertDialogResult>;
+    /**
+     * Alerta de información
+     */
+    info(options: string | Omit<AlertDialogOptions, 'type'>): Promise<AlertDialogResult>;
+    /**
+     * Diálogo de confirmación
+     */
+    confirm(options: string | Omit<AlertDialogOptions, 'type' | 'showCancelButton'>): Promise<AlertDialogResult>;
+    /**
+     * Prompt para capturar input del usuario
+     */
+    prompt(options: Omit<AlertDialogOptions, 'input'> & {
+        input?: AlertDialogOptions['input'];
+    }): Promise<AlertDialogResult<string>>;
+    /**
+     * Toast notification (auto-cierre, posición personalizada)
+     */
+    toast(options: string | AlertDialogOptions): Promise<AlertDialogResult>;
+    /**
+     * Cerrar todos los diálogos abiertos
+     */
+    closeAll(): void;
+    private getDialogPosition;
+    private getPanelClasses;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertDialogService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AlertDialogService>;
+}
+
 /**
  * A wrapper component for Angular Material dialogs that provides a consistent look and feel,
  * including a draggable header and the ability to dynamically create components inside the dialog.
@@ -503,7 +656,7 @@ declare class DynamicSelect implements OnInit, OnDestroy {
     clearable: _angular_core.InputSignal<boolean>;
     searchable: _angular_core.InputSignal<boolean>;
     virtualScroll: _angular_core.InputSignal<boolean>;
-    dropdownPosition: _angular_core.InputSignal<"auto" | "bottom" | "top">;
+    dropdownPosition: _angular_core.InputSignal<"auto" | "top" | "bottom">;
     closeOnSelect: _angular_core.InputSignal<boolean>;
     hideSelected: _angular_core.InputSignal<boolean>;
     multiple: _angular_core.InputSignal<boolean>;
@@ -674,7 +827,7 @@ declare class Button {
     text: _angular_core.InputSignal<string>;
     icon: _angular_core.InputSignal<string>;
     disabled: _angular_core.InputSignal<boolean>;
-    type: _angular_core.InputSignal<ButtonType>;
+    type: _angular_core.InputSignal<ButtonType$1>;
     matStyle: _angular_core.InputSignal<MaterialButtonStyle>;
     customClass: _angular_core.InputSignal<string | undefined>;
     reportFormat: _angular_core.InputSignal<REPORT_FORMAT | undefined>;
@@ -1224,7 +1377,7 @@ declare class DataGrid<T = any> implements AfterViewInit, OnDestroy, OnChanges {
     noResultTemplate: _angular_core.InputSignal<TemplateRef<any> | undefined>;
     paginationTemplate: _angular_core.InputSignal<TemplateRef<any> | undefined>;
     summaryTemplate: _angular_core.InputSignal<TemplateRef<any> | DataGridCellTemplate | undefined>;
-    size: _angular_core.InputSignal<"small" | "medium" | "normal">;
+    size: _angular_core.InputSignal<"medium" | "small" | "normal">;
     headerCellTemplate: _angular_core.InputSignal<TemplateRef<any> | DataGridCellTemplate | undefined>;
     expandable: _angular_core.InputSignal<boolean>;
     expansionTemplate: _angular_core.InputSignal<TemplateRef<any> | null>;
@@ -1412,8 +1565,22 @@ declare class KeyboardNavigationService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<KeyboardNavigationService>;
 }
 
-interface DateRangePickerOptions extends DatexOptions {
+interface DateRangePickerOptions {
     presetTheme?: 'default' | 'bootstrap' | 'material' | 'custom';
+    locale?: NgxDatexLocale;
+    theme?: NgxDatexTheme;
+    ranges?: Record<string, [Date, Date]>;
+    minDate?: Date | null;
+    maxDate?: Date | null;
+    singleDatePicker?: boolean;
+    timePicker?: boolean;
+    timePicker24Hour?: boolean;
+    timePickerSeconds?: boolean;
+    timePickerIncrement?: number;
+    autoApply?: boolean;
+    showDropdowns?: boolean;
+    linkedCalendars?: boolean;
+    alwaysShowCalendars?: boolean;
 }
 type DateValue<AsString extends boolean> = AsString extends true ? string : Date;
 interface DateRangeValue<AsString extends boolean> {
@@ -1421,76 +1588,73 @@ interface DateRangeValue<AsString extends boolean> {
     to: DateValue<AsString>;
     label?: string;
 }
-declare class DateRangePicker<AsString extends boolean = true> implements OnInit, OnChanges, OnDestroy, ControlValueAccessor, MatFormFieldControl<any> {
-    static nextId: number;
-    readonly id: string;
-    readonly controlType = "acp-date-range-picker";
-    readonly stateChanges: Subject<void>;
-    readonly autofilled = false;
-    dateInput: ElementRef<HTMLInputElement>;
-    private _focused;
-    private _required;
-    private _value;
-    get focused(): boolean;
-    get empty(): boolean;
-    get shouldLabelFloat(): boolean;
-    get required(): boolean;
-    private readonly _errorState;
-    get errorState(): boolean;
-    get value(): any;
-    set value(val: any);
-    get placeholder(): string;
-    get disabled(): boolean;
-    ngControl: any;
-    setDescribedByIds(_ids: string[]): void;
-    onContainerClick(): void;
-    focus(): void;
+declare class DateRangePicker<AsString extends boolean = true> implements OnInit, OnChanges, OnDestroy, ControlValueAccessor {
     options: _angular_core.InputSignal<DateRangePickerOptions>;
     placeholderText: _angular_core.InputSignal<string>;
     isDisabled: _angular_core.InputSignal<boolean>;
     inputReadonly: _angular_core.InputSignal<boolean>;
-    label: _angular_core.InputSignal<string | undefined>;
-    hint: _angular_core.InputSignal<string | undefined>;
-    errorMessage: _angular_core.InputSignal<string | undefined>;
+    label: _angular_core.InputSignal<string>;
     appearance: _angular_core.InputSignal<"fill" | "outline">;
     formatOutputAsString: _angular_core.InputSignal<AsString>;
     calendarIcon: _angular_core.InputSignal<string>;
     showCalendarButton: _angular_core.InputSignal<boolean>;
     showCheckbox: _angular_core.InputSignal<boolean>;
     checkboxChecked: _angular_core.ModelSignal<boolean>;
-    checkboxReadonly: _angular_core.InputSignal<boolean>;
-    checkboxAriaLabel: _angular_core.InputSignal<string>;
     checkboxPosition: _angular_core.InputSignal<"prefix" | "suffix">;
-    dateRangeSelected: _angular_core.OutputEmitterRef<DateRangeValue<AsString>>;
-    pickerShow: _angular_core.OutputEmitterRef<void>;
-    pickerHide: _angular_core.OutputEmitterRef<void>;
-    pickerApply: _angular_core.OutputEmitterRef<void>;
-    pickerCancel: _angular_core.OutputEmitterRef<void>;
-    checkboxChange: _angular_core.OutputEmitterRef<boolean>;
-    private picker?;
+    singleDatePicker: _angular_core.InputSignal<boolean>;
+    timePicker: _angular_core.InputSignal<boolean>;
+    timePicker24Hour: _angular_core.InputSignal<boolean>;
+    timePickerSeconds: _angular_core.InputSignal<boolean>;
+    timePickerIncrement: _angular_core.InputSignal<number>;
+    autoApply: _angular_core.InputSignal<boolean>;
+    showDropdowns: _angular_core.InputSignal<boolean>;
+    linkedCalendars: _angular_core.InputSignal<boolean>;
+    alwaysShowCalendars: _angular_core.InputSignal<boolean>;
+    minDate: _angular_core.InputSignal<Date | null>;
+    maxDate: _angular_core.InputSignal<Date | null>;
+    dateRangeSelected: OutputEmitterRef<DateRangeValue<AsString>>;
+    pickerShow: OutputEmitterRef<void>;
+    pickerHide: OutputEmitterRef<void>;
+    pickerApply: OutputEmitterRef<void>;
+    pickerCancel: OutputEmitterRef<void>;
+    checkboxChange: OutputEmitterRef<boolean>;
+    dateRangeValue: NgxDatexValue | null;
+    predefinedRanges: Record<string, [Date, Date]>;
+    locale: NgxDatexLocale;
+    theme: NgxDatexTheme;
     private currentDate;
+    private readonly stateChanges;
     private onChange;
     private onTouched;
+    effectiveMinDate: WritableSignal<Date | null>;
+    effectiveMaxDate: WritableSignal<Date | null>;
+    get minDateForTemplate(): any;
+    get maxDateForTemplate(): any;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     private mapDate;
-    private initializePicker;
-    private reinitializePicker;
-    private buildDatexOptions;
+    private initializeConfiguration;
     private getDefaultRanges;
+    private getLocale;
     private getTheme;
-    private setupEventListeners;
+    onDateChange(value: NgxDatexValue | null): void;
+    onRangeChange(range: {
+        startDate: Date;
+        endDate: Date | null;
+    }): void;
+    onPickerShow(): void;
+    onPickerHide(): void;
+    onCheckboxToggle(checked: boolean): void;
     writeValue(value: any): void;
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
-    setDisabledState(isDisabled: boolean): void;
+    setDisabledState(_isDisabled: boolean): void;
     show(): void;
     hide(): void;
     toggle(): void;
-    onCheckboxToggle(event: any): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DateRangePicker<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateRangePicker<any>, "acp-date-range-picker", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholderText": { "alias": "placeholderText"; "required": false; "isSignal": true; }; "isDisabled": { "alias": "isDisabled"; "required": false; "isSignal": true; }; "inputReadonly": { "alias": "inputReadonly"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "formatOutputAsString": { "alias": "formatOutputAsString"; "required": false; "isSignal": true; }; "calendarIcon": { "alias": "calendarIcon"; "required": false; "isSignal": true; }; "showCalendarButton": { "alias": "showCalendarButton"; "required": false; "isSignal": true; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; "checkboxChecked": { "alias": "checkboxChecked"; "required": false; "isSignal": true; }; "checkboxReadonly": { "alias": "checkboxReadonly"; "required": false; "isSignal": true; }; "checkboxAriaLabel": { "alias": "checkboxAriaLabel"; "required": false; "isSignal": true; }; "checkboxPosition": { "alias": "checkboxPosition"; "required": false; "isSignal": true; }; }, { "checkboxChecked": "checkboxCheckedChange"; "dateRangeSelected": "dateRangeSelected"; "pickerShow": "pickerShow"; "pickerHide": "pickerHide"; "pickerApply": "pickerApply"; "pickerCancel": "pickerCancel"; "checkboxChange": "checkboxChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateRangePicker<any>, "acp-date-range-picker", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholderText": { "alias": "placeholderText"; "required": false; "isSignal": true; }; "isDisabled": { "alias": "isDisabled"; "required": false; "isSignal": true; }; "inputReadonly": { "alias": "inputReadonly"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "formatOutputAsString": { "alias": "formatOutputAsString"; "required": false; "isSignal": true; }; "calendarIcon": { "alias": "calendarIcon"; "required": false; "isSignal": true; }; "showCalendarButton": { "alias": "showCalendarButton"; "required": false; "isSignal": true; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; "checkboxChecked": { "alias": "checkboxChecked"; "required": false; "isSignal": true; }; "checkboxPosition": { "alias": "checkboxPosition"; "required": false; "isSignal": true; }; "singleDatePicker": { "alias": "singleDatePicker"; "required": false; "isSignal": true; }; "timePicker": { "alias": "timePicker"; "required": false; "isSignal": true; }; "timePicker24Hour": { "alias": "timePicker24Hour"; "required": false; "isSignal": true; }; "timePickerSeconds": { "alias": "timePickerSeconds"; "required": false; "isSignal": true; }; "timePickerIncrement": { "alias": "timePickerIncrement"; "required": false; "isSignal": true; }; "autoApply": { "alias": "autoApply"; "required": false; "isSignal": true; }; "showDropdowns": { "alias": "showDropdowns"; "required": false; "isSignal": true; }; "linkedCalendars": { "alias": "linkedCalendars"; "required": false; "isSignal": true; }; "alwaysShowCalendars": { "alias": "alwaysShowCalendars"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; }, { "checkboxChecked": "checkboxCheckedChange"; "dateRangeSelected": "dateRangeSelected"; "pickerShow": "pickerShow"; "pickerHide": "pickerHide"; "pickerApply": "pickerApply"; "pickerCancel": "pickerCancel"; "checkboxChange": "checkboxChange"; }, never, never, true, never>;
 }
 
 /** Options for where to set focus to automatically on dialog open. */
@@ -1899,7 +2063,7 @@ type AcpPopoverPosition = [AcpPopoverPositionStart, AcpPopoverPositionEnd];
 /** Popover's trigger event. */
 type AcpPopoverTriggerEvent = 'click' | 'hover' | 'none';
 /** Reason why the popover was closed. */
-type PopoverCloseReason = void | 'click' | 'keydown' | 'tab';
+type PopoverCloseReason = void | 'click' | 'keydown' | 'tab' | 'programmatic';
 
 /**
  * Interface for a custom popover panel that can be used with `acpPopoverTriggerFor`.
@@ -1958,6 +2122,7 @@ declare const ACP_POPOVER_DEFAULT_OPTIONS: InjectionToken<AcpPopoverDefaultOptio
  * various positioning options. It's built on top of Angular CDK Overlay
  * and provides a flexible way to display contextual information.
  *
+ * ## Basic Usage
  * @example
  * ```html
  * <acp-popover #popover="acpPopover" [position]="['below', 'after']">
@@ -1966,6 +2131,62 @@ declare const ACP_POPOVER_DEFAULT_OPTIONS: InjectionToken<AcpPopoverDefaultOptio
  *
  * <button [acpPopoverTriggerFor]="popover">Show popover</button>
  * ```
+ *
+ * ## Closing Explicitly
+ *
+ * ### 1. Close from within popover content:
+ * @example
+ * ```html
+ * <acp-popover #popover="acpPopover">
+ *   <div>
+ *     <p>Popover content</p>
+ *     <button (click)="popover.close()">Close</button>
+ *     <button (click)="popover.close('user-action')">Close with reason</button>
+ *   </div>
+ * </acp-popover>
+ * ```
+ *
+ * ### 2. Close from component using ViewChild:
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <acp-popover #popover="acpPopover">
+ *       <div>Content with external close</div>
+ *     </acp-popover>
+ *     <button [acpPopoverTriggerFor]="popover">Open</button>
+ *     <button (click)="closePopover()">Close from outside</button>
+ *   `
+ * })
+ * export class MyComponent {
+ *   @ViewChild('popover') popover!: AcpPopover;
+ *
+ *   closePopover() {
+ *     this.popover.close('programmatic');
+ *   }
+ * }
+ * ```
+ *
+ * ### 3. Close using trigger reference:
+ * @example
+ * ```html
+ * <acp-popover #popover="acpPopover">
+ *   <div>Popover content</div>
+ * </acp-popover>
+ *
+ * <button [acpPopoverTriggerFor]="popover" #trigger="acpPopoverTrigger">
+ *   Show popover
+ * </button>
+ * <button (click)="trigger.closePopover()">Close via trigger</button>
+ * <button (click)="trigger.closePopoverWithReason('external')">Close with reason</button>
+ * ```
+ *
+ * ## Automatic Closing
+ * The popover automatically closes on:
+ * - ESC key press
+ * - Click outside (backdrop) when `closeOnBackdropClick` is true
+ * - Mouse leave after delay when `triggerEvent` is 'hover'
+ * - Click on panel when `closeOnPanelClick` is true
  */
 declare class AcpPopover implements AcpPopoverPanel, OnInit, OnDestroy {
     private _changeDetectorRef;
@@ -2056,6 +2277,11 @@ declare class AcpPopover implements AcpPopoverPanel, OnInit, OnDestroy {
     set classList(classes: string);
     /** Event emitted when the popover is closed. */
     closed: EventEmitter<PopoverCloseReason>;
+    /**
+     * Programmatically closes the popover.
+     * @param reason Optional reason for closing
+     */
+    close(reason?: PopoverCloseReason): void;
     /** @docs-private */
     templateRef: TemplateRef<any>;
     /**
@@ -2163,6 +2389,7 @@ declare const ACP_POPOVER_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
  * The trigger handles various events (click, hover) and manages the popover's lifecycle,
  * including opening, closing, positioning, and focus management.
  *
+ * ## Basic Usage
  * @example
  * ```html
  * <acp-popover #popover="acpPopover">
@@ -2173,6 +2400,33 @@ declare const ACP_POPOVER_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
  *   Show popover
  * </button>
  * ```
+ *
+ * ## Programmatic Control
+ * @example
+ * ```html
+ * <acp-popover #popover="acpPopover">
+ *   <div>Popover content</div>
+ * </acp-popover>
+ *
+ * <button [acpPopoverTriggerFor]="popover" #trigger="acpPopoverTrigger">
+ *   Toggle popover
+ * </button>
+ *
+ * <!-- Programmatic control -->
+ * <button (click)="trigger.openPopover()">Open</button>
+ * <button (click)="trigger.closePopover()">Close</button>
+ * <button (click)="trigger.closePopoverWithReason('manual')">Close with reason</button>
+ * <button (click)="trigger.togglePopover()">Toggle</button>
+ * ```
+ *
+ * ## Custom Target
+ * @example
+ * ```html
+ * <div acpPopoverTarget #target="acpPopoverTarget">Target element</div>
+ * <button [acpPopoverTriggerFor]="popover" [targetElement]="target">
+ *   Trigger (popover appears at target)
+ * </button>
+ * ```
  */
 declare class AcpPopoverTrigger implements AfterContentInit, OnDestroy {
     private _overlay;
@@ -2251,6 +2505,11 @@ declare class AcpPopoverTrigger implements AfterContentInit, OnDestroy {
     openPopover(): void;
     /** Closes the popover. */
     closePopover(): void;
+    /**
+     * Programmatically closes the popover with a specific reason.
+     * @param reason The reason for closing
+     */
+    closePopoverWithReason(reason: PopoverCloseReason): void;
     /**
      * Focuses the popover trigger.
      * @param origin Source of the popover trigger's focus.
@@ -2314,6 +2573,45 @@ declare function throwAcpPopoverInvalidPositionStart(): void;
  */
 declare function throwAcpPopoverInvalidPositionEnd(): void;
 
+type ButtonType = 'confirm' | 'cancel' | 'deny';
+declare class AlertDialog implements OnInit, OnDestroy {
+    inputField?: ElementRef<HTMLInputElement | HTMLTextAreaElement>;
+    private container;
+    private componentRef;
+    inputValue: string;
+    validationError: string | null;
+    timerProgress: number;
+    private timerInterval;
+    sanitizedHtml: SafeHtml;
+    sanitizedFooter: SafeHtml | null;
+    dialogRef: MatDialogRef<any, any>;
+    data: AlertDialogOptions;
+    private sanitizer;
+    private environmentInjector;
+    constructor();
+    ngOnDestroy(): void;
+    private startTimer;
+    private loadComponent;
+    ngOnInit(): void;
+    getIconName(): string;
+    getButtonVariant(buttonType: ButtonType): ButtonVariant;
+    getButtonIcon(buttonType: ButtonType): string;
+    getButtonStyle(buttonType: ButtonType): MaterialButtonStyle;
+    onConfirm(): Promise<void>;
+    onCancel(): void;
+    onDeny(): void;
+    onInputEnter(): void;
+    private closeWithResult;
+    getConfirmColor(): any;
+    getCancelColor(): any;
+    getDenyColor(): any;
+    getConfirmBackgroundColor(): string | undefined;
+    getCancelBackgroundColor(): string | undefined;
+    getDenyBackgroundColor(): string | undefined;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertDialog, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertDialog, "acp-alert-dialog", never, {}, {}, never, never, true, never>;
+}
+
 declare class ToUpperCase implements ControlValueAccessor {
     private el;
     private renderer;
@@ -2357,5 +2655,5 @@ declare class StatusDisplayPipe implements PipeTransform {
     static ɵpipe: _angular_core.ɵɵPipeDeclaration<StatusDisplayPipe, "statusDisplay", true>;
 }
 
-export { ACP_DRAWER_DATA, ACP_DRAWER_DEFAULT_OPTIONS, ACP_POPOVER_CONTENT, ACP_POPOVER_DEFAULT_OPTIONS, ACP_POPOVER_SCROLL_STRATEGY, AUTOCOMPLETE_WRAPPER_CUSTOMER_CONFIG, AUTOCOMPLETE_WRAPPER_DEFAULT_CONFIG, AUTOCOMPLETE_WRAPPER_LOCAL_CONFIG, AUTOCOMPLETE_WRAPPER_PAGINATED_CONFIG, AUTOCOMPLETE_WRAPPER_PRODUCT_CONFIG, AUTOCOMPLETE_WRAPPER_SIMPLE_CONFIG, AcpDrawer, AcpDrawerConfig, AcpDrawerContainer, AcpDrawerRef, AcpPopover, AcpPopoverContent, AcpPopoverTarget, AcpPopoverTrigger, AdvancedDialogService, AutocompleteWrapperService, Button, DATA_GRID_DEFAULT_OPTIONS, DataGrid, DateRangePicker, DialogWrapper, DynamicCard, DynamicSelect, GetTotalPipe, IconRegistryService, InputChip, KeyboardNavigationService, OverlayService, Pagination, ReusableAutocompleteComponent, Spinner, StatusDisplayPipe, SvgIcon, TabulatorTable, ThemeSwitcher, ThemeToggle, ToUpperCase, UserIcon, _AcpPopoverContentBase, createAutocompleteWrapperConfig, throwAcpPopoverInvalidPositionEnd, throwAcpPopoverInvalidPositionStart, throwAcpPopoverMissingError };
-export type { AcpPopoverDefaultOptions, AcpPopoverPanel, AcpPopoverPosition, AcpPopoverPositionEnd, AcpPopoverPositionStart, AcpPopoverTriggerEvent, AutoFocusTarget, AutocompleteWrapperActions, AutocompleteWrapperConfig, AutocompleteWrapperEventHandler, AutocompleteWrapperEvents, AutocompleteWrapperFilters, AutocompleteWrapperItem, AutocompleteWrapperItemProperty, AutocompleteWrapperPaginationInfo, AutocompleteWrapperSearchField, AutocompleteWrapperSearchFunction, AutocompleteWrapperSearchMode, AutocompleteWrapperSearchResult, AutocompleteWrapperState, AutocompleteWrapperStockOption, DataGridButtonType, DataGridCellTemplate, DataGridColumn, DataGridColumnButton, DataGridColumnButtonBadge, DataGridColumnButtonPop, DataGridColumnButtonTooltip, DataGridColumnPinOption, DataGridColumnPinValue, DataGridColumnTag, DataGridColumnTagValue, DataGridColumnType, DataGridColumnTypeParameter, DataGridDefaultOptions, DataGridMenuItem, DataGridRowClassFormatter, DataGridRowSelectionFormatter, DataGridSortProp, DateRangePickerOptions, DateRangeValue, DialogSize, DialogWrapperConfig, DrawerPosition, FocusableElement, IconRegistryConfig, MatCustomDialogConfig, PopoverCloseReason, ReusableAutocompleteWrapperComponent, TabulatorColumn, TabulatorConfig, TabulatorEventHandlers, TabulatorTheme };
+export { ACP_DRAWER_DATA, ACP_DRAWER_DEFAULT_OPTIONS, ACP_POPOVER_CONTENT, ACP_POPOVER_DEFAULT_OPTIONS, ACP_POPOVER_SCROLL_STRATEGY, AUTOCOMPLETE_WRAPPER_CUSTOMER_CONFIG, AUTOCOMPLETE_WRAPPER_DEFAULT_CONFIG, AUTOCOMPLETE_WRAPPER_LOCAL_CONFIG, AUTOCOMPLETE_WRAPPER_PAGINATED_CONFIG, AUTOCOMPLETE_WRAPPER_PRODUCT_CONFIG, AUTOCOMPLETE_WRAPPER_SIMPLE_CONFIG, AcpDrawer, AcpDrawerConfig, AcpDrawerContainer, AcpDrawerRef, AcpPopover, AcpPopoverContent, AcpPopoverTarget, AcpPopoverTrigger, AdvancedDialogService, AlertDialog, AlertDialogService, AutocompleteWrapperService, Button, DATA_GRID_DEFAULT_OPTIONS, DataGrid, DateRangePicker, DialogWrapper, DynamicCard, DynamicSelect, GetTotalPipe, IconRegistryService, InputChip, KeyboardNavigationService, OverlayService, Pagination, ReusableAutocompleteComponent, Spinner, StatusDisplayPipe, SvgIcon, TabulatorTable, ThemeSwitcher, ThemeToggle, ToUpperCase, UserIcon, _AcpPopoverContentBase, createAutocompleteWrapperConfig, throwAcpPopoverInvalidPositionEnd, throwAcpPopoverInvalidPositionStart, throwAcpPopoverMissingError };
+export type { AcpPopoverDefaultOptions, AcpPopoverPanel, AcpPopoverPosition, AcpPopoverPositionEnd, AcpPopoverPositionStart, AcpPopoverTriggerEvent, AlertDialogOptions, AlertDialogResult, AlertPosition, AlertType, AutoFocusTarget, AutocompleteWrapperActions, AutocompleteWrapperConfig, AutocompleteWrapperEventHandler, AutocompleteWrapperEvents, AutocompleteWrapperFilters, AutocompleteWrapperItem, AutocompleteWrapperItemProperty, AutocompleteWrapperPaginationInfo, AutocompleteWrapperSearchField, AutocompleteWrapperSearchFunction, AutocompleteWrapperSearchMode, AutocompleteWrapperSearchResult, AutocompleteWrapperState, AutocompleteWrapperStockOption, DataGridButtonType, DataGridCellTemplate, DataGridColumn, DataGridColumnButton, DataGridColumnButtonBadge, DataGridColumnButtonPop, DataGridColumnButtonTooltip, DataGridColumnPinOption, DataGridColumnPinValue, DataGridColumnTag, DataGridColumnTagValue, DataGridColumnType, DataGridColumnTypeParameter, DataGridDefaultOptions, DataGridMenuItem, DataGridRowClassFormatter, DataGridRowSelectionFormatter, DataGridSortProp, DateRangePickerOptions, DateRangeValue, DialogSize, DialogWrapperConfig, DrawerPosition, FocusableElement, IconRegistryConfig, MatCustomDialogConfig, PopoverCloseReason, ReusableAutocompleteWrapperComponent, TabulatorColumn, TabulatorConfig, TabulatorEventHandlers, TabulatorTheme };