@ieeesa-npm/presentation 0.33.18 → 0.33.20

package/lib/components/autocomplete/autocomplete.component.d.ts

@@ -6,6 +6,7 @@ import { FormField } from '../../models/form-field.model';
 import { AutoCompleteOption } from '../../models/autocomplete-option.model';
 import { SelectOption } from '@ieeesa-npm/models';
 import { FormUtilityService } from '../../services/form-utility.service';
+import { FormOverlayBoundsService } from '../../services/form-overlay-bounds.service';
 import * as i0 from "@angular/core";
 /**
  * Provides auto suggestion for the entered input by filtering the options from the given list of options.
@@ -17,6 +18,7 @@ import * as i0 from "@angular/core";
  */
 export declare class AutocompleteComponent implements OnInit, FormField, OnDestroy, AfterViewInit {
     private formUtilityService;
+    private formOverlayBounds;
     private elementRef;
     config: FieldConfig;
     group: FormGroup;
@@ -31,11 +33,10 @@ export declare class AutocompleteComponent implements OnInit, FormField, OnDestr
     autoComplete: ElementRef;
     destroy$: Subject<boolean>;
     autocompleteConstInfo: any;
-    constructor(formUtilityService: FormUtilityService, elementRef: ElementRef<HTMLElement>);
+    constructor(formUtilityService: FormUtilityService, formOverlayBounds: FormOverlayBoundsService, elementRef: ElementRef<HTMLElement>);
     private formOverlayScrollContainer?;
     private readonly preferredAutocompleteOverlayHeight;
     private readonly overlayWheelListener;
-    private readonly formScrollListener;
     /**
      * Implementation of ngOnInit lifecycle hook method to initialize components instance properties.
      * @memberof AutocompleteComponent
@@ -82,7 +83,6 @@ export declare class AutocompleteComponent implements OnInit, FormField, OnDestr
     onAutocompleteClose(): void;
     private setOverlayClipBounds;
     private getFormOverlayScrollContainer;
-    private updateOverlayClipBounds;
     private makeRoomForAutocompleteOverlay;
     private clearOverlayClipBounds;
     static ɵfac: i0.ɵɵFactoryDeclaration<AutocompleteComponent, never>;

package/lib/components/credit-selection/credit-selection.component.d.ts

@@ -0,0 +1,57 @@
+import { OnInit } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { CreditSelectionData, CreditSelectionTimeslotOption } from '../../models/credit-selection.model';
+import * as i0 from "@angular/core";
+/**
+ * CreditSelectionComponent is a generic, reusable dialog shown when the
+ * attendance log-in APIs (Pass 1) return a non-null creditSelectionPrompt.
+ *
+ * For each timeslot the user must choose which meeting receives attendance
+ * credit — the prior (credit-holding) meeting or the target meeting being
+ * attended. The prior meeting is pre-selected per timeslot. Save is enabled
+ * only when every timeslot has a selection (the backend rejects partial
+ * submissions).
+ *
+ * Footer (SP3M-677 — no Cancel button; the dialog is non-dismissable and a
+ * valid meeting is always pre-selected, so credit is resolved via Save):
+ * - Save → closes with { creditSelections: [{ timeslotId, creditedMeetingId }] }
+ *
+ * This component is feature-agnostic — all display text is supplied by the
+ * caller via MAT_DIALOG_DATA (CreditSelectionData). It performs no API calls;
+ * it collects selections and returns them so the caller can re-submit Pass 2.
+ * @export
+ * @class CreditSelectionComponent
+ * @implements {OnInit}
+ */
+export declare class CreditSelectionComponent implements OnInit {
+    data: CreditSelectionData;
+    private dialogRef;
+    /** Timeslots the user must resolve, each with prior/target meeting options. */
+    timeslotOptions: CreditSelectionTimeslotOption[];
+    /** Map of timeslotId → selected creditedMeetingId. */
+    selections: Record<string, string>;
+    constructor(data: CreditSelectionData, dialogRef: MatDialogRef<CreditSelectionComponent>);
+    ngOnInit(): void;
+    /**
+     * trackBy for the timeslot list.
+     * @param {number} _index
+     * @param {CreditSelectionTimeslotOption} timeslot
+     * @return {string}
+     * @memberof CreditSelectionComponent
+     */
+    trackByTimeslotId(_index: number, timeslot: CreditSelectionTimeslotOption): string;
+    /**
+     * Whether Save should be enabled — true once every timeslot has a selection.
+     * @return {boolean}
+     * @memberof CreditSelectionComponent
+     */
+    get canSave(): boolean;
+    /**
+     * Save handler — builds one entry per timeslot and closes with the result.
+     * No-ops if any timeslot is unselected (backend rejects partial submissions).
+     * @memberof CreditSelectionComponent
+     */
+    onSave(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CreditSelectionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CreditSelectionComponent, "ieeesa-credit-selection", never, {}, {}, never, never, true, never>;
+}

package/lib/components/date-picker/date-picker.component.d.ts

@@ -7,6 +7,7 @@ import { CalendarType } from '../../models/calendar.model';
 import { DatepickerService } from '../../services/datepicker.service';
 import { FormField } from '../../models/form-field.model';
 import { FormUtilityService } from '../../services/form-utility.service';
+import { FormOverlayBoundsService } from '../../services/form-overlay-bounds.service';
 import { SelectedDate } from '../../models/selected-date.model';
 import * as i0 from "@angular/core";
 export declare class CustomDateAdapter extends MomentDateAdapter {
@@ -32,6 +33,7 @@ export declare class DatePickerComponent implements FormField, OnInit, OnDestroy
     private changeDetectorRef;
     private datepickerService;
     private formUtilityService;
+    private formOverlayBounds;
     private elementRef;
     config: FieldConfig;
     group: FormGroup;
@@ -84,7 +86,7 @@ export declare class DatePickerComponent implements FormField, OnInit, OnDestroy
     buttonActionsInfo: any;
     private formOverlayScrollContainer?;
     private readonly overlayWheelListener;
-    constructor(fb: FormBuilder, changeDetectorRef: ChangeDetectorRef, datepickerService: DatepickerService, formUtilityService: FormUtilityService, elementRef: ElementRef<HTMLElement>);
+    constructor(fb: FormBuilder, changeDetectorRef: ChangeDetectorRef, datepickerService: DatepickerService, formUtilityService: FormUtilityService, formOverlayBounds: FormOverlayBoundsService, elementRef: ElementRef<HTMLElement>);
     /**
      * Implementation of  ngOnInit lifecycle hook method to creates config if its undefined and sets components instance variables if config is defined. Sets the form group value if form group is defined.
      * @memberof DatePickerComponent

package/lib/components/select/select.component.d.ts

@@ -5,6 +5,7 @@ import { FieldConfig } from '../../models/field-config.model';
 import { SearchType } from '../../models/search.model';
 import { SearchComponent } from '../../components/search/search.component';
 import { FormUtilityService } from '../../services/form-utility.service';
+import { FormOverlayBoundsService } from '../../services/form-overlay-bounds.service';
 import { SelectOpenedState } from '../../models/select-opened-state.model';
 import * as i0 from "@angular/core";
 /**
@@ -17,6 +18,7 @@ import * as i0 from "@angular/core";
  */
 export declare class SelectComponent implements OnInit, AfterViewInit, OnDestroy {
     private formUtilityService;
+    private formOverlayBounds;
     private elementRef;
     formFields: QueryList<SearchComponent>;
     group: FormGroup;
@@ -30,7 +32,10 @@ export declare class SelectComponent implements OnInit, AfterViewInit, OnDestroy
     private _isSortNeeded;
     private unsortedDropdownOptions;
     private formOverlayScrollContainer?;
+    private isTopSelectPanelPinned;
+    private pinnedPanelMaxHeight;
     private readonly overlayWheelListener;
+    private readonly repositionPinnedPanel;
     /**
      * Takes isSortNeeded as input to check if the passed options are sorted or not.
      * @memberof SelectComponent
@@ -60,7 +65,7 @@ export declare class SelectComponent implements OnInit, AfterViewInit, OnDestroy
     optionSelected: EventEmitter<SelectOption>;
     optionSearched: EventEmitter<string>;
     dropdownOpenedChange: EventEmitter<SelectOpenedState>;
-    constructor(formUtilityService: FormUtilityService, elementRef: ElementRef<HTMLElement>);
+    constructor(formUtilityService: FormUtilityService, formOverlayBounds: FormOverlayBoundsService, elementRef: ElementRef<HTMLElement>);
     /**
      * Initializes components instance properties from config if its defined otherwise creates form group and config.
      * @memberof SelectComponent
@@ -87,7 +92,21 @@ export declare class SelectComponent implements OnInit, AfterViewInit, OnDestroy
     private setOverlayClipBounds;
     private getFormOverlayScrollContainer;
     private clearOverlayClipBounds;
+    /**
+     * Material flips the panel above its field when it will not fit below. Inside a
+     * form that pushes the panel over the form's heading and pinned tab strip, so
+     * when the field is near the top of the usable band the panel is forced back
+     * below the field and capped to the space left inside the band.
+     * @memberof SelectComponent
+     */
     private keepTopSelectPanelInsideFormBody;
+    /**
+     * Positions the pinned panel just below its field, recomputed from the current
+     * trigger and band so it tracks the field as the page/form scrolls instead of
+     * staying at a stale fixed offset.
+     * @memberof SelectComponent
+     */
+    private pinTopSelectPanel;
     /**
      * Takes the index and the current option as arguments and needs to return the unique identifier for this option.
      * @param {number} index

package/lib/components/time-picker/time-picker.component.d.ts

@@ -2,8 +2,10 @@ import { ElementRef, EventEmitter, OnDestroy } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { FieldConfig } from '../../models/field-config.model';
 import { SelectedTime } from '../../models/selected-time.model';
+import { FormOverlayBoundsService } from '../../services/form-overlay-bounds.service';
 import * as i0 from "@angular/core";
 export declare class TimePickerComponent implements OnDestroy {
+    private formOverlayBounds;
     private elementRef;
     config: FieldConfig;
     group: FormGroup;
@@ -12,7 +14,7 @@ export declare class TimePickerComponent implements OnDestroy {
     picker: ElementRef;
     private formOverlayScrollContainer?;
     private readonly overlayWheelListener;
-    constructor(elementRef: ElementRef<HTMLElement>);
+    constructor(formOverlayBounds: FormOverlayBoundsService, elementRef: ElementRef<HTMLElement>);
     /**
      * Handles form time selection event
      * @type {void}

package/lib/models/credit-selection.model.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared models for the reusable Credit Selection dialog.
+ *
+ * The dialog is generic and feature-agnostic: all display text is supplied by
+ * the calling feature library (e.g. attendance, attendees) via MAT_DIALOG_DATA,
+ * so this presentation-layer component never depends on any feature's constants.
+ */
+/**
+ * A single selectable meeting option shown in the credit-selection dialog.
+ * Represents either the prior (credit-holding) meeting or the target meeting
+ * being attended, as returned per timeslot by the backend credit prompt.
+ */
+export interface CreditSelectionMeetingOption {
+    meetingId: string;
+    meetingName: string;
+}
+/**
+ * A single timeslot the user must resolve credit for. Contains the prior
+ * (credit-holding) meeting and the target meeting being attended. The user
+ * picks exactly one of these two per timeslot.
+ * Mirrors creditSelectionPrompt.timeslotOptions[] from the attendance log-in APIs.
+ */
+export interface CreditSelectionTimeslotOption {
+    timeslotId: string;
+    timeslotName: string;
+    priorMeeting: CreditSelectionMeetingOption;
+    targetMeeting: CreditSelectionMeetingOption;
+}
+/**
+ * The creditSelectionPrompt object returned by Pass 1 of the attendance log-in
+ * APIs. When present (non-null), the credit-selection dialog must be shown
+ * before the attendance can be finalized (Pass 2).
+ */
+export interface CreditSelectionPrompt {
+    eventId: string;
+    timeslotOptions: CreditSelectionTimeslotOption[];
+}
+/**
+ * Data passed to the CreditSelectionComponent via MAT_DIALOG_DATA.
+ * All text is provided by the caller so the component stays generic.
+ */
+export interface CreditSelectionData {
+    /** Timeslots the user must resolve, each with prior/target meeting options. */
+    timeslotOptions: CreditSelectionTimeslotOption[];
+    /** Dialog title. */
+    title: string;
+    /** First instruction paragraph (context — why credit must be chosen). */
+    messageLine1: string;
+    /** Second instruction paragraph (the actual "please select" prompt). */
+    messageLine2: string;
+    /** Save button label. */
+    saveLabel: string;
+    /** Accessibility label for each timeslot's radio group. */
+    meetingOptionAriaLabel: string;
+}
+/**
+ * One credit selection the user made — which meeting should receive credit for
+ * a given timeslot. Sent in Pass 2 as creditSelections[].
+ */
+export interface CreditSelectionEntry {
+    timeslotId: string;
+    creditedMeetingId: string;
+}
+/**
+ * Result returned by CreditSelectionComponent when the user clicks Save.
+ * Contains one entry per timeslot.
+ */
+export interface CreditSelectionResult {
+    creditSelections: CreditSelectionEntry[];
+}

package/lib/services/form-overlay-bounds.service.d.ts

@@ -0,0 +1,85 @@
+import * as i0 from "@angular/core";
+/**
+ * Keeps a field overlay — a select panel, autocomplete list, date picker or time
+ * picker — inside the bounds of the form it belongs to.
+ *
+ * Without this, the CDK positions these panels against the viewport, so a panel
+ * that cannot fit below its field flips upward and is drawn over the form's
+ * heading and pinned tab strip, visually escaping the form.
+ *
+ * Containment is expressed as a clip band published on the document element and
+ * consumed by each overlay's stylesheet:
+ *   --ieeesa-form-overlay-clip-top     distance from the viewport top to the band
+ *   --ieeesa-form-overlay-clip-bottom  distance from the band to the viewport bottom
+ * plus an `ieeesa-form-overlay-open` class that activates those rules.
+ *
+ * The band is the form's field area intersected with the space the form's own
+ * pinned chrome leaves free, so a panel never covers the tab strip / step header
+ * above it or the action bar below it. It is recalculated on scroll and resize:
+ * the form scrolls with the page, so a band measured only when the panel opened
+ * would drift and clip the panel away as the user scrolled.
+ * @export
+ * @class FormOverlayBoundsService
+ */
+export declare class FormOverlayBoundsService {
+    private static readonly OPEN_CLASS;
+    private static readonly CLIP_TOP_PROPERTY;
+    private static readonly CLIP_BOTTOM_PROPERTY;
+    /** Field areas an overlay can be contained within, most specific first. */
+    private static readonly FIELD_AREA_SELECTORS;
+    /** Chrome pinned above the field area, which a panel must not cover. */
+    private static readonly PINNED_ABOVE_SELECTORS;
+    /** Chrome pinned below the field area, which a panel must not cover. */
+    private static readonly PINNED_BELOW_SELECTORS;
+    private fieldArea?;
+    private updateBand?;
+    /**
+     * Returns the form field area the given host element sits in, or null when the
+     * host is not inside a form (a filter popover, a dialog) and so needs no
+     * containment.
+     * @param {HTMLElement} host
+     * @return {(HTMLElement | null)}
+     * @memberof FormOverlayBoundsService
+     */
+    getFieldArea(host: HTMLElement): HTMLElement | null;
+    /**
+     * Starts containing overlays to the form the host element belongs to, and keeps
+     * the band current until `release` is called.
+     * @param {HTMLElement} host
+     * @return {(HTMLElement | null)} the field area, or null when not in a form
+     * @memberof FormOverlayBoundsService
+     */
+    contain(host: HTMLElement): HTMLElement | null;
+    /**
+     * Returns the band an overlay is currently confined to, in viewport
+     * coordinates. Callers use it to position a panel inside the form.
+     * @return {({ top: number; bottom: number } | null)}
+     * @memberof FormOverlayBoundsService
+     */
+    getBand(): {
+        top: number;
+        bottom: number;
+    } | null;
+    /**
+     * Stops containing overlays and removes the published band, so unrelated
+     * overlays are positioned normally.
+     * @memberof FormOverlayBoundsService
+     */
+    release(): void;
+    /**
+     * Measures the usable band: the field area, trimmed by any of the form's own
+     * chrome that is currently pinned over it.
+     * @param {HTMLElement} fieldArea
+     * @return {{ top: number; bottom: number }}
+     * @memberof FormOverlayBoundsService
+     */
+    private measureBand;
+    /**
+     * Publishes the band as clip custom properties for the overlay stylesheets.
+     * @param {HTMLElement} fieldArea
+     * @memberof FormOverlayBoundsService
+     */
+    private publishBand;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormOverlayBoundsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FormOverlayBoundsService>;
+}

package/package.json

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

package/public-api.d.ts

@@ -46,6 +46,7 @@ export * from './lib/components/filter-popover/filter-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/components/home-group-selection/home-group-selection.component';
+export * from './lib/components/credit-selection/credit-selection.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';
@@ -107,8 +108,10 @@ export * from './lib/models/filter-popover.model';
 export * from './lib/models/policy-confirmation-dialog.model';
 export * from './lib/models/export-success-dialog.model';
 export * from './lib/models/home-group-selection.model';
+export * from './lib/models/credit-selection.model';
 export * from './lib/services/datepicker.service';
 export * from './lib/services/form-utility.service';
+export * from './lib/services/form-overlay-bounds.service';
 export * from './lib/services/file-upload.service';
 export * from './lib/services/break-point-observer.service';
 export * from './lib/pipes/safe.pipe';

package/src/lib/assets/constants.json

@@ -635,5 +635,5 @@
       }
     }
   },
-  "breakPointMaxWidth": "767px"
+  "breakPointMaxWidth": "900px"
 }