@ieeesa-npm/presentation 0.31.0 → 0.31.1

package/lib/components/export-format-popover/export-format-popover.component.d.ts

@@ -0,0 +1,91 @@
+import { ElementRef, EventEmitter, OnChanges, OnDestroy, OnInit, SimpleChanges, TemplateRef, ViewContainerRef } from '@angular/core';
+import { Overlay, OverlayPositionBuilder } from '@angular/cdk/overlay';
+import { Subject } from 'rxjs';
+import { ExportFormat, ExportFormatOption } from '../../models/export-format-popover.model';
+import * as i0 from "@angular/core";
+/**
+ * ExportFormatPopoverComponent renders a CDK Overlay popover anchored below
+ * a trigger element, presenting format selection cards (CSV / Excel).
+ * The popover supports keyboard navigation (Tab between options, Enter to select,
+ * Escape to close) and emits the selected format or a close event.
+ *
+ * @export
+ * @class ExportFormatPopoverComponent
+ * @implements {OnInit}
+ * @implements {OnChanges}
+ * @implements {OnDestroy}
+ */
+export declare class ExportFormatPopoverComponent implements OnInit, OnChanges, OnDestroy {
+    private overlay;
+    private overlayPositionBuilder;
+    private viewContainerRef;
+    /** Array of format options to display in the popover */
+    formatOptions: ExportFormatOption[];
+    /** The element the popover attaches to (anchor point) */
+    origin: ElementRef;
+    /** Controls overlay visibility */
+    isOpen: boolean;
+    /** Title text displayed at the top of the popover */
+    popoverTitle: string;
+    /** Subtitle map for format options (keyed by ExportFormat value) */
+    formatSubtitles: Record<string, string>;
+    /** Tracks the currently selected format for visual highlight */
+    selectedFormat: ExportFormat | null;
+    /** Emits when user selects a format */
+    formatSelected: EventEmitter<ExportFormat>;
+    /** Emits when popover closes without selection */
+    closed: EventEmitter<void>;
+    popoverTemplate: TemplateRef<unknown>;
+    private overlayRef;
+    private portal;
+    destroy$: Subject<boolean>;
+    constructor(overlay: Overlay, overlayPositionBuilder: OverlayPositionBuilder, viewContainerRef: ViewContainerRef);
+    /**
+     * Lifecycle hook — initial setup.
+     * @memberof ExportFormatPopoverComponent
+     */
+    ngOnInit(): void;
+    /**
+     * Responds to input changes — opens or closes the overlay when `isOpen` changes.
+     * @param {SimpleChanges} changes
+     * @memberof ExportFormatPopoverComponent
+     */
+    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Creates and opens the CDK overlay positioned below the origin element.
+     * @memberof ExportFormatPopoverComponent
+     */
+    private openOverlay;
+    /**
+     * Detaches and disposes the overlay.
+     * @memberof ExportFormatPopoverComponent
+     */
+    private closeOverlay;
+    /**
+     * Closes the popover and emits the `closed` event.
+     * @memberof ExportFormatPopoverComponent
+     */
+    private close;
+    /**
+     * Handles format option selection via click or Enter key.
+     * Emits the selected format and closes the overlay.
+     * @param {ExportFormat} format - The selected export format value
+     * @memberof ExportFormatPopoverComponent
+     */
+    onFormatSelect(format: ExportFormat): void;
+    /**
+     * TrackBy function for *ngFor on format options.
+     * @param {number} index
+     * @param {ExportFormatOption} option
+     * @return {string}
+     * @memberof ExportFormatPopoverComponent
+     */
+    trackByFormat(index: number, option: ExportFormatOption): string;
+    /**
+     * Cleans up overlay and subscriptions on component destroy.
+     * @memberof ExportFormatPopoverComponent
+     */
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExportFormatPopoverComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ExportFormatPopoverComponent, "ieeesa-export-format-popover", never, { "formatOptions": { "alias": "formatOptions"; "required": false; }; "origin": { "alias": "origin"; "required": false; }; "isOpen": { "alias": "isOpen"; "required": false; }; "popoverTitle": { "alias": "popoverTitle"; "required": false; }; "formatSubtitles": { "alias": "formatSubtitles"; "required": false; }; }, { "formatSelected": "formatSelected"; "closed": "closed"; }, never, never, true, never>;
+}

package/lib/components/export-success-dialog/export-success-dialog.component.d.ts

@@ -0,0 +1,24 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { ExportSuccessDialogData } from '../../models/export-success-dialog.model';
+import * as i0 from "@angular/core";
+/**
+ * ExportSuccessDialogComponent displays a centered success message after
+ * a file export completes. Shows the filename in bold and a single "Close" button.
+ *
+ * Opens via `MatDialog.open(ExportSuccessDialogComponent, { data: ExportSuccessDialogData })`.
+ *
+ * @export
+ * @class ExportSuccessDialogComponent
+ */
+export declare class ExportSuccessDialogComponent {
+    data: ExportSuccessDialogData;
+    private dialogRef;
+    constructor(data: ExportSuccessDialogData, dialogRef: MatDialogRef<ExportSuccessDialogComponent>);
+    /**
+     * Handles the Close button click — closes the dialog.
+     * @memberof ExportSuccessDialogComponent
+     */
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExportSuccessDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ExportSuccessDialogComponent, "ieeesa-export-success-dialog", never, {}, {}, never, never, true, never>;
+}

package/lib/components/modal-info/modal-info.component.d.ts

@@ -0,0 +1,23 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { InfoModalData } from '@ieeesa-npm/models';
+import * as i0 from "@angular/core";
+/**
+ * ModalInfoComponent is a simple informational dialog that displays a centered message
+ * with a single dismissal button.
+ *
+ * @usageNotes - Pass ModalInfoComponent and data options as parameters to MatDialog open method:
+ * this.dialog.open(ModalInfoComponent, { data: { message: '...', buttonLabel: 'OK' } })
+ * @class ModalInfoComponent
+ */
+export declare class ModalInfoComponent {
+    data: InfoModalData;
+    private dialogRef;
+    constructor(data: InfoModalData, dialogRef: MatDialogRef<ModalInfoComponent>);
+    /**
+     * Closes the info dialog.
+     * @memberof ModalInfoComponent
+     */
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ModalInfoComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ModalInfoComponent, "ieeesa-modal-info", never, {}, {}, never, never, true, never>;
+}

package/lib/components/policy-confirmation-dialog/policy-confirmation-dialog.component.d.ts

@@ -0,0 +1,36 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { PolicyConfirmationDialogData } from '../../models/policy-confirmation-dialog.model';
+import * as i0 from "@angular/core";
+/**
+ * PolicyConfirmationDialogComponent is a reusable confirmation dialog that displays
+ * a configurable title, body text, and Cancel/Confirm action buttons.
+ * Used for the IEEE Data Access and Use Policy confirmation in the attendance export flow.
+ *
+ * Opens via `MatDialog.open(PolicyConfirmationDialogComponent, { data: PolicyConfirmationDialogData })`.
+ * Returns `true` on confirm, `false` on cancel or close.
+ *
+ * @export
+ * @class PolicyConfirmationDialogComponent
+ */
+export declare class PolicyConfirmationDialogComponent {
+    data: PolicyConfirmationDialogData;
+    private dialogRef;
+    constructor(data: PolicyConfirmationDialogData, dialogRef: MatDialogRef<PolicyConfirmationDialogComponent>);
+    /**
+     * Handles the Confirm button click — closes the dialog returning `true`.
+     * @memberof PolicyConfirmationDialogComponent
+     */
+    onConfirm(): void;
+    /**
+     * Handles the Cancel button click — closes the dialog returning `false`.
+     * @memberof PolicyConfirmationDialogComponent
+     */
+    onCancel(): void;
+    /**
+     * Handles the X (close) button click — closes the dialog returning `false`.
+     * @memberof PolicyConfirmationDialogComponent
+     */
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PolicyConfirmationDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PolicyConfirmationDialogComponent, "ieeesa-policy-confirmation-dialog", never, {}, {}, never, never, true, never>;
+}

package/lib/models/export-format-popover.model.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Available export file formats for attendance data
+ */
+export declare enum ExportFormat {
+    CSV = "csv",
+    EXCEL = "xls"
+}
+/**
+ * Configuration option for a format selection card in the export format popover
+ */
+export interface ExportFormatOption {
+    label: string;
+    value: ExportFormat;
+    ariaLabel: string;
+}

package/lib/models/export-success-dialog.model.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Data passed to the ExportSuccessDialogComponent via MAT_DIALOG_DATA
+ */
+export interface ExportSuccessDialogData {
+    message: string;
+    filename: string;
+    closeLabel: string;
+}

package/lib/models/policy-confirmation-dialog.model.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Data passed to the PolicyConfirmationDialogComponent via MAT_DIALOG_DATA
+ */
+export interface PolicyConfirmationDialogData {
+    title: string;
+    bodyText: string;
+    cancelLabel: string;
+    confirmLabel: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ieeesa-npm/presentation",
-  "version": "0.31.0",
+  "version": "0.31.1",
   "peerDependencies": {
     "@angular/common": "^16.1.0",
     "@angular/core": "^16.1.0",

package/public-api.d.ts

@@ -14,6 +14,7 @@ export * from './lib/components/list/list.component';
 export * from './lib/components/menu/menu.component';
 export * from './lib/components/modal/modal.component';
 export * from './lib/components/modal-confirmation/modal-confirmation.component';
+export * from './lib/components/modal-info/modal-info.component';
 export * from './lib/components/navigation-menu/navigation-menu.component';
 export * from './lib/components/notification/notification.component';
 export * from './lib/components/radio/radio.component';
@@ -40,6 +41,9 @@ export * from './lib/components/inactive-tenant/inactive-tenant.component';
 export * from './lib/components/image-preview/image-preview.component';
 export * from './lib/components/rich-text-editor/rich-text-editor.component';
 export * from './lib/components/multi-select-autocomplete/multi-select-autocomplete.component';
+export * from './lib/components/export-format-popover/export-format-popover.component';
+export * from './lib/components/policy-confirmation-dialog/policy-confirmation-dialog.component';
+export * from './lib/components/export-success-dialog/export-success-dialog.component';
 export * from './lib/directives/dynamic-form-field/dynamic-form-field.directive';
 export * from './lib/directives/set-background/set-background.directive';
 export * from './lib/directives/text-truncated/text-truncated.directive';
@@ -96,10 +100,13 @@ export * from './lib/models/file-upload-presigned-url-res.model';
 export * from './lib/models/file-upload-response.model';
 export * from './lib/models/inactive-tenant.model';
 export * from './lib/models/table-column-menu-info.model';
+export * from './lib/models/export-format-popover.model';
+export * from './lib/models/policy-confirmation-dialog.model';
+export * from './lib/models/export-success-dialog.model';
 export * from './lib/services/datepicker.service';
 export * from './lib/services/form-utility.service';
 export * from './lib/services/file-upload.service';
 export * from './lib/services/break-point-observer.service';
 export * from './lib/pipes/safe.pipe';
 export * from './lib/presentation.module';
-export { SelectOption, CheckboxOption, IconButton, AlignType, ConfirmationModalData, MessagePart } from '@ieeesa-npm/models';
+export { SelectOption, CheckboxOption, IconButton, AlignType, ConfirmationModalData, MessagePart, InfoModalData } from '@ieeesa-npm/models';