@ieeesa-npm/presentation 0.33.14 → 0.33.15

package/lib/components/dynamic-form/dynamic-form.component.d.ts

@@ -124,6 +124,40 @@ export declare class DynamicFormComponent implements OnInit, AfterContentInit, A
      * @memberof DynamicFormComponent
      */
     createFormGroupArray(): void;
+    /**
+     * Incrementally adds a single control to an existing form group at the given
+     * group index WITHOUT rebuilding the whole form. This preserves every other
+     * live control (including controls that are not part of the static config,
+     * e.g. dynamically-populated dropdowns) along with their current values and
+     * options.
+     * @param {number} groupIndex - Index of the target form group.
+     * @param {FieldConfig} control - Field configuration of the control to add.
+     * @param {number} [position] - Optional position within the group's controls;
+     * defaults to appending at the end.
+     * @return {void}
+     * @memberof DynamicFormComponent
+     */
+    addControlToGroup(groupIndex: number, control: FieldConfig, position?: number): void;
+    /**
+     * Incrementally removes a single control from an existing form group by its
+     * control name WITHOUT rebuilding the whole form. Other live controls and
+     * their values/options are left untouched.
+     * @param {number} groupIndex - Index of the target form group.
+     * @param {string} controlName - Name of the control to remove.
+     * @return {void}
+     * @memberof DynamicFormComponent
+     */
+    removeControlFromGroup(groupIndex: number, controlName: string): void;
+    /**
+     * Returns true when the live form group at the given index currently contains
+     * a control with the given name. Reflects the rendered form state (including
+     * controls added/removed incrementally), not the static config.
+     * @param {number} groupIndex - Index of the target form group.
+     * @param {string} controlName - Name of the control to look for.
+     * @return {boolean} Whether the control exists in the rendered group.
+     * @memberof DynamicFormComponent
+     */
+    hasControlInGroup(groupIndex: number, controlName: string): boolean;
     /**
      * Creates form group using form builder
      * @param {any[]} controls

package/lib/components/home-group-selection/home-group-selection.component.d.ts

@@ -0,0 +1,63 @@
+import { OnInit } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { HomeGroupSelectionData, QualifyingGroup } from '../../models/home-group-selection.model';
+import * as i0 from "@angular/core";
+/**
+ * HomeGroupSelectionComponent is a generic, reusable dialog for selecting a
+ * home Working Group to receive reciprocal attendance credit (SP3M-18).
+ *
+ * It is shown when an attendee (or an admin acting on their behalf) qualifies
+ * for reciprocal credit in more than one home Working Group and must choose
+ * which one should receive the credit. The first qualifying group is
+ * pre-selected so Submit is enabled immediately; Submit is disabled only if no
+ * group is selected.
+ *
+ * This component is feature-agnostic — all display text is supplied by the
+ * caller via MAT_DIALOG_DATA (HomeGroupSelectionData). It performs no API calls;
+ * it collects the selection and returns it so the caller can re-submit.
+ *
+ * Footer:
+ * - Submit → closes with { homeGroupId }
+ * - Cancel → closes with null (caller aborts)
+ *
+ * @export
+ * @class HomeGroupSelectionComponent
+ * @implements {OnInit}
+ */
+export declare class HomeGroupSelectionComponent implements OnInit {
+    data: HomeGroupSelectionData;
+    private dialogRef;
+    /** Qualifying home groups the user must choose between. */
+    qualifyingGroups: QualifyingGroup[];
+    /** The currently selected home group id. */
+    selectedGroupId: string;
+    constructor(data: HomeGroupSelectionData, dialogRef: MatDialogRef<HomeGroupSelectionComponent>);
+    ngOnInit(): void;
+    /**
+     * trackBy for the qualifying groups list.
+     * @param {number} _index
+     * @param {QualifyingGroup} group
+     * @return {string}
+     * @memberof HomeGroupSelectionComponent
+     */
+    trackByGroupId(_index: number, group: QualifyingGroup): string;
+    /**
+     * Whether Submit should be enabled — true once a group is selected.
+     * @return {boolean}
+     * @memberof HomeGroupSelectionComponent
+     */
+    get canSubmit(): boolean;
+    /**
+     * Cancel handler — closes with null so the caller aborts.
+     * @memberof HomeGroupSelectionComponent
+     */
+    onCancel(): void;
+    /**
+     * Submit handler — closes with the selected home group id.
+     * No-ops if no group is selected.
+     * @memberof HomeGroupSelectionComponent
+     */
+    onSubmit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HomeGroupSelectionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<HomeGroupSelectionComponent, "ieeesa-home-group-selection", never, {}, {}, never, never, true, never>;
+}

package/lib/models/home-group-selection.model.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared models for the reusable Home Group Selection dialog (SP3M-18).
+ *
+ * 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 Working Group in the home-group selection dialog.
+ * Mirrors the backend HomeGroupOption ({ groupId, groupName }).
+ */
+export interface QualifyingGroup {
+    groupId: string;
+    groupName: string;
+}
+/**
+ * The homeGroupSelectionPrompt object returned by the attendance log-in APIs
+ * when the user qualifies for reciprocal credit in more than one home group.
+ * Mirrors HomeGroupSelectionPromptResponse from the attendee-api.
+ */
+export interface HomeGroupSelectionPrompt {
+    eventId: string;
+    qualifyingGroups: QualifyingGroup[];
+}
+/**
+ * Data passed to the HomeGroupSelectionComponent via MAT_DIALOG_DATA.
+ * All text is provided by the caller so the component stays generic.
+ */
+export interface HomeGroupSelectionData {
+    /** Qualifying home groups the user must choose between. */
+    qualifyingGroups: QualifyingGroup[];
+    /** Dialog title. */
+    title: string;
+    /** First instruction paragraph (context). */
+    messageLine1: string;
+    /** Second instruction paragraph (the "please select" prompt). */
+    messageLine2: string;
+    /** Informational note shown in the footer banner. */
+    infoText: string;
+    /** Submit button label. */
+    submitLabel: string;
+    /** Cancel button label. */
+    cancelLabel: string;
+    /** Accessibility label for the radio group. */
+    groupOptionAriaLabel: string;
+}
+/**
+ * Result returned by HomeGroupSelectionComponent when the user clicks Submit.
+ * `null` is returned when the user cancels.
+ */
+export interface HomeGroupSelectionResult {
+    homeGroupId: string;
+}

package/package.json

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

package/public-api.d.ts

@@ -45,6 +45,7 @@ export * from './lib/components/export-format-popover/export-format-popover.comp
 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/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';
@@ -105,6 +106,7 @@ export * from './lib/models/export-format-popover.model';
 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/services/datepicker.service';
 export * from './lib/services/form-utility.service';
 export * from './lib/services/file-upload.service';