@ieeesa-npm/presentation 0.33.18 → 0.33.19

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ieeesa-npm/presentation",
-  "version": "0.33.18",
+  "version": "0.33.19",
   "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,6 +108,7 @@ 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/file-upload.service';