@ieeesa-npm/groups 0.15.8 → 0.15.10

package/lib/components/add-user-roster/add-user-roster.component.d.ts

@@ -45,6 +45,25 @@ export declare class AddUserRosterComponent implements OnInit, OnDestroy {
     isUserExist: boolean;
     selectedOrganizations: AutoCompleteOption[];
     timeOutId: ReturnType<typeof setTimeout>;
+    /**
+     * True when the selected group's roster type is INDIVIDUAL (the only roster
+     * type that shows the Representing Organization field).
+     * @readonly
+     * @memberof AddUserRosterComponent
+     */
+    get isIndividualRoster(): boolean;
+    /**
+     * True when the org field holds an uncommitted, invalid free-text token. Used
+     * to keep Save disabled even when a valid chip already exists.
+     */
+    hasInvalidOrgFreeText: boolean;
+    /**
+     * Handles the org field's invalid-free-text state and recomputes Save-button
+     * state so the form cannot be submitted while an invalid token remains.
+     * @param {boolean} isInvalid -whether an uncommitted invalid token is present.
+     * @memberof AddUserRosterComponent
+     */
+    onOrgInvalidFreeText(isInvalid: boolean): void;
     dynamicFormComponent: DynamicFormComponent;
     submitFormResponse: EventEmitter<any>;
     formCancel: EventEmitter<any>;
@@ -132,6 +151,17 @@ export declare class AddUserRosterComponent implements OnInit, OnDestroy {
      * @memberof AddUserRosterComponent
      */
     getAddUserFormGroupRef(form: FormGroup[]): void;
+    /**
+     * Registers the `representingOrg` reactive control on the dynamic form's
+     * FormGroup for INDIVIDUAL rosters. The field itself is rendered by the custom
+     * OrgMultiSelectComponent (not the dynamic form), but keeping this control on
+     * the same FormGroup — with the original validators — means all existing
+     * submit/Save-button logic that reads `form.get('representingOrg')` keeps
+     * working unchanged. Its value is the selected-organizations array, kept in
+     * sync by getSelectedOrganizations().
+     * @memberof AddUserRosterComponent
+     */
+    registerRepresentingOrgControl(): void;
     /**
      * Handles user role selection in add user form.
      * @param {CheckboxOption} event

package/lib/components/edit-user-roles/edit-user-roles.component.d.ts

@@ -40,6 +40,18 @@ export declare class EditUserRolesComponent implements OnInit, OnDestroy {
     groupRosterType: GroupRosterType;
     representingOrganizations: SelectOption[];
     orgSearchValue: string;
+    /**
+     * True when the selected group's roster type is INDIVIDUAL (the only roster
+     * type that shows the Representing Organization field).
+     * @readonly
+     * @memberof EditUserRolesComponent
+     */
+    get isIndividualRoster(): boolean;
+    /**
+     * True when the org field holds an uncommitted, invalid free-text token. Used
+     * to keep Save disabled even when a valid chip already exists.
+     */
+    hasInvalidOrgFreeText: boolean;
     dynamicFormComponent: DynamicFormComponent;
     submitFormResponse: EventEmitter<any>;
     formCancel: EventEmitter<any>;
@@ -66,6 +78,13 @@ export declare class EditUserRolesComponent implements OnInit, OnDestroy {
      * @memberof EditUserRolesComponent
      */
     getSelectedOrganizations(selectedOrg: AutoCompleteOption[]): void;
+    /**
+     * Handles the org field's invalid-free-text state. Disables Save while an
+     * uncommitted invalid token remains; re-evaluates when it clears.
+     * @param {boolean} isInvalid -whether an uncommitted invalid token is present.
+     * @memberof EditUserRolesComponent
+     */
+    onOrgInvalidFreeText(isInvalid: boolean): void;
     /**
      * Updates the edit user form group controls by adding fieldConfig at required index.
      * @param {number} indexPosition
@@ -103,6 +122,18 @@ export declare class EditUserRolesComponent implements OnInit, OnDestroy {
      * @memberof EditUserRolesComponent
      */
     getFormGroupReference(form: FormGroup[]): void;
+    /**
+     * Registers the `representingOrg` reactive control on the dynamic form's
+     * FormGroup for INDIVIDUAL rosters. The field itself is rendered by the custom
+     * OrgMultiSelectComponent (not the dynamic form), but keeping this control on
+     * the same FormGroup — with the original validators — means all existing
+     * submit/Save-button logic that reads `form.get('representingOrg')` keeps
+     * working unchanged. Its value is the selected-organizations array, kept in
+     * sync by getSelectedOrganizations(). Prefilled with the user's existing
+     * organizations on edit.
+     * @memberof EditUserRolesComponent
+     */
+    registerRepresentingOrgControl(): void;
     /**
      * Handles edit user role form change event.
      * @param {FormGroup[]} form

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

@@ -0,0 +1,75 @@
+import { OnInit } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { RadioOption, SlideToggleOption } from '@ieeesa-npm/presentation';
+import * as i0 from "@angular/core";
+/**
+ * Standard (locked) question row shown in the Interest Form tab.
+ * @export
+ * @interface StandardQuestionRow
+ */
+export interface StandardQuestionRow {
+    id: number;
+    label: string;
+    tag: string;
+}
+/**
+ * "Interest Form" tab content of the Roster Interests dialog (SP3M-317). The
+ * group admin configures the interest form here: enable/disable the form, view
+ * the locked standard questions, choose the default membership level and manage
+ * custom questions. Interactive controls reuse the shared presentation
+ * components (slide toggle, radio). Persistence via a mocked service and the
+ * custom-question builder will be added in subsequent increments.
+ * @export
+ * @class InterestFormComponent
+ */
+export declare class InterestFormComponent implements OnInit {
+    private dialogRef;
+    constants: any;
+    interestFormTexts: any;
+    changesNotice: any;
+    sectionTitle: any;
+    sectionDescription: any;
+    standardQuestionsTitle: any;
+    standardQuestionsHint: any;
+    defaultMembershipTitle: any;
+    defaultMembershipDescription: any;
+    customQuestionsTitle: any;
+    addQuestionLabel: any;
+    standardTag: any;
+    cancelLabel: any;
+    previewLabel: any;
+    enableFormToggle: SlideToggleOption;
+    standardQuestions: StandardQuestionRow[];
+    membershipLevels: RadioOption[];
+    isFormEnabled: boolean;
+    constructor(dialogRef: MatDialogRef<unknown>);
+    /**
+     * Initializes the toggle, locked standard questions and default membership
+     * level options from constants.
+     * @memberof InterestFormComponent
+     */
+    ngOnInit(): void;
+    /**
+     * Updates the form-enabled state when the toggle changes so the dependent
+     * sections show or hide accordingly.
+     * @param {SlideToggleOption} toggle
+     * @memberof InterestFormComponent
+     */
+    onEnableFormToggle(toggle: SlideToggleOption): void;
+    /**
+     * Closes the Roster Interests dialog (Cancel action).
+     * @memberof InterestFormComponent
+     */
+    onCancel(): void;
+    /**
+     * Returns the unique identifier for a standard question row for ngFor
+     * tracking.
+     * @param {number} index
+     * @param {StandardQuestionRow} question
+     * @return {number}
+     * @memberof InterestFormComponent
+     */
+    trackByFn(index: number, question: StandardQuestionRow): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormComponent, [{ optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestFormComponent, "ieeesa-interest-form", never, {}, {}, never, never, true, never>;
+}

package/lib/components/interest-form-management/interest-form-management.component.d.ts

@@ -0,0 +1,31 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { Tab } from '@ieeesa-npm/presentation';
+import { GroupInfo } from '../../models/group-info.model';
+import * as i0 from "@angular/core";
+/**
+ * Roster Interests dialog host (SP3M-317). Opened from the "Manage Interest
+ * Form" action on a group row. Renders a two-tab layout using the shared
+ * TabsComponent: "Interested Rosters" (submissions list) and "Interest Form"
+ * (admin configuration). The group being managed is provided via the dialog
+ * data. The tab content components are rendered dynamically by TabsComponent
+ * through each tab's componentRef.
+ * @export
+ * @class InterestFormManagementComponent
+ */
+export declare class InterestFormManagementComponent {
+    dialogRef: MatDialogRef<InterestFormManagementComponent>;
+    group: GroupInfo;
+    constants: any;
+    rosterInterestsTexts: any;
+    heading: any;
+    closeAriaLabel: any;
+    tabs: Tab[];
+    constructor(dialogRef: MatDialogRef<InterestFormManagementComponent>, group: GroupInfo);
+    /**
+     * Closes the Roster Interests dialog.
+     * @memberof InterestFormManagementComponent
+     */
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormManagementComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestFormManagementComponent, "ieeesa-interest-form-management", never, {}, {}, never, never, true, never>;
+}

package/lib/components/interested-rosters/interested-rosters.component.d.ts

@@ -0,0 +1,17 @@
+import * as i0 from "@angular/core";
+/**
+ * "Interested Rosters" tab content of the Roster Interests dialog (SP3M-317).
+ * Displays the list of users who expressed interest in the group. This is a
+ * placeholder shell for now; the submissions table will be implemented in a
+ * later increment once the backend is available (data will be mocked in the
+ * service layer meanwhile).
+ * @export
+ * @class InterestedRostersComponent
+ */
+export declare class InterestedRostersComponent {
+    constants: any;
+    interestedRostersTexts: any;
+    placeholderMessage: any;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestedRostersComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestedRostersComponent, "ieeesa-interested-rosters", never, {}, {}, never, never, true, never>;
+}

package/lib/components/org-multi-select/org-multi-select.component.d.ts

@@ -0,0 +1,212 @@
+import { ElementRef, EventEmitter, OnDestroy, OnInit } from '@angular/core';
+import { SelectOption } from '@ieeesa-npm/presentation';
+import * as i0 from "@angular/core";
+/**
+ * A self-contained multi-select organization field used inside the Add/Edit
+ * roster popups.
+ *
+ * It intentionally does NOT reuse the shared MultiSelectAutocompleteComponent
+ * (which is built on mat-autocomplete). Material's autocomplete closes its panel
+ * and overwrites the input on every option pick, which made multi-selection
+ * feel single-select and cleared the user's typed text. This component uses a
+ * fully-owned custom dropdown (<div> + checkboxes) so:
+ *  - the panel stays open while the user ticks several results,
+ *  - the typed search text is never overwritten by a pick,
+ *  - pressing Enter adds the typed value as a free-text chip,
+ *  - clicking outside clears any leftover typed text (old behavior),
+ *  - selected values render as removable chips (old behavior).
+ *
+ * The parent supplies search results via {@link options} and reacts to
+ * {@link search} (debounced typed term) and {@link selectionChange}.
+ * @export
+ * @class OrgMultiSelectComponent
+ */
+export declare class OrgMultiSelectComponent implements OnInit, OnDestroy {
+    /** Field label (e.g. "Representing Organization *"). */
+    label: string;
+    /** Placeholder for the input. */
+    placeholder: string;
+    /** Support/help text shown below the field. */
+    supportMessage: string;
+    /** aria-label for the input. */
+    ariaLabel: string;
+    /** Search results supplied by the parent (repopulated on each search). */
+    set options(value: SelectOption[]);
+    get options(): SelectOption[];
+    private _options;
+    /** Pre-selected options (edit prefill). Rendered as chips. */
+    set selectedOptions(value: SelectOption[]);
+    get selectedOptions(): SelectOption[];
+    private _selectedOptions;
+    /** Marks the field required (drives the required message + error border). */
+    required: boolean;
+    /**
+     * Icon URLs (same sprite refs the shared multi-select field used). Defaulted
+     * so the popups don't need to pass them; overridable via input if needed.
+     */
+    removeIconURL: string;
+    clearAllIconURL: string;
+    /** Emits the trimmed typed term (debounced) so the parent can call the API. */
+    search: EventEmitter<string>;
+    /** Emits the current selection array whenever it changes. */
+    selectionChange: EventEmitter<SelectOption[]>;
+    /** Emitted when the field is blurred (parent can re-evaluate validation). */
+    fieldBlur: EventEmitter<void>;
+    /**
+     * Emits true when the input holds an uncommitted free-text token that fails
+     * validation (too short / too long / invalid pattern), and false when the
+     * input is empty or the token is valid. The parent uses this to keep the Save
+     * button disabled while an invalid token remains — otherwise a previously
+     * added valid chip would keep the parent control valid and let the form submit
+     * with an invalid token still in the input.
+     */
+    invalidFreeText: EventEmitter<boolean>;
+    /** Tracks the last emitted invalid-token state to avoid duplicate emits. */
+    private hasInvalidFreeText;
+    searchInput: ElementRef<HTMLInputElement>;
+    constants: any;
+    addUserRosterTexts: any;
+    /** Whether the results dropdown is open. */
+    isDropdownOpen: boolean;
+    /** The current typed search text. */
+    searchText: string;
+    /** Inline validation message for the free-text (Enter) path. */
+    errorMessage: string;
+    /** Whether the field has been touched (to show required error after blur). */
+    isTouched: boolean;
+    /**
+     * Index of the keyboard-highlighted result row (-1 = none). Enables arrow-key
+     * navigation and Enter-to-toggle for keyboard users, mirroring the mat-option
+     * behavior this custom dropdown replaces.
+     */
+    activeOptionIndex: number;
+    /** Stable id prefix for option rows (used for aria-activedescendant). */
+    readonly optionIdPrefix = "ieeesa-org-option-";
+    private destroy$;
+    private searchDebounce?;
+    private blurTimer?;
+    private readonly debounceMs;
+    private readonly minCharToSearch;
+    private separatorKeys;
+    ngOnInit(): void;
+    /**
+     * Handles typing in the search input: tracks the text, opens/closes the
+     * dropdown and debounces the search emit to the parent.
+     * @param {Event} event -input event.
+     * @memberof OrgMultiSelectComponent
+     */
+    onInput(event: Event): void;
+    /**
+     * Emits the invalid-free-text state to the parent (deduped). True means an
+     * uncommitted token is present and Save should stay disabled.
+     * @param {boolean} isInvalid -whether an uncommitted token is present.
+     * @memberof OrgMultiSelectComponent
+     */
+    private emitInvalidState;
+    /**
+     * Opens the dropdown on focus only when there are results AND the input still
+     * holds a valid search term (at or above minCharToSearch). This prevents
+     * re-opening stale results — e.g. a late API response that populated options
+     * after the input was cleared — when the user simply refocuses the field.
+     * @memberof OrgMultiSelectComponent
+     */
+    onFocus(): void;
+    /**
+     * Called by the parent (via a setter re-assign) or internally after new
+     * options arrive so the dropdown opens to show them.
+     * @memberof OrgMultiSelectComponent
+     */
+    showResults(): void;
+    /**
+     * Handles keydown for the Enter/comma "add typed value" path.
+     * @param {KeyboardEvent} event -keyboard event.
+     * @memberof OrgMultiSelectComponent
+     */
+    onKeydown(event: KeyboardEvent): void;
+    /**
+     * Moves the keyboard highlight up/down the results list, wrapping at the ends.
+     * @param {number} delta -+1 to move down, -1 to move up.
+     * @memberof OrgMultiSelectComponent
+     */
+    private moveActiveOption;
+    /**
+     * Whether the given result index is the keyboard-highlighted row.
+     * @param {number} index -the option's index.
+     * @return {boolean}
+     * @memberof OrgMultiSelectComponent
+     */
+    isActiveOption(index: number): boolean;
+    /**
+     * Adds the typed free-text value as a selection (chip) after validating its
+     * length and pattern (parity with the previous chip-input behavior).
+     * @memberof OrgMultiSelectComponent
+     */
+    addTypedValue(): void;
+    /**
+     * Validates a free-text organization value against the shared min/max/pattern
+     * rules. Returns an error message when invalid, otherwise an empty string.
+     * @param {string} value -the typed value.
+     * @return {string}
+     * @memberof OrgMultiSelectComponent
+     */
+    validateFreeText(value: string): string;
+    /**
+     * Toggles selection of a result option. Keeps the dropdown open and the typed
+     * text intact so the user can keep selecting.
+     * @param {SelectOption} option -the clicked result option.
+     * @memberof OrgMultiSelectComponent
+     */
+    toggleOption(option: SelectOption): void;
+    /**
+     * Whether an option is currently selected (drives the checkbox checked state).
+     * @param {SelectOption} option -option to test.
+     * @return {boolean}
+     * @memberof OrgMultiSelectComponent
+     */
+    isSelected(option: SelectOption): boolean;
+    /**
+     * Removes a selected chip.
+     * @param {SelectOption} option -the option to remove.
+     * @memberof OrgMultiSelectComponent
+     */
+    removeOption(option: SelectOption): void;
+    /**
+     * Clears all selected chips.
+     * @memberof OrgMultiSelectComponent
+     */
+    clearAll(): void;
+    /**
+     * Clears the leftover typed text on blur (old behavior) and closes the
+     * dropdown. Deferred so a click on a dropdown option (which also blurs the
+     * input) is handled first.
+     * @memberof OrgMultiSelectComponent
+     */
+    onBlur(): void;
+    /**
+     * Whether the required error should show (touched, no selection).
+     * @return {boolean}
+     * @memberof OrgMultiSelectComponent
+     */
+    get showRequiredError(): boolean;
+    /**
+     * Clears the typed search text and hides the results.
+     * @memberof OrgMultiSelectComponent
+     */
+    private clearSearchText;
+    /**
+     * Emits the current selection to the parent.
+     * @memberof OrgMultiSelectComponent
+     */
+    private emitSelection;
+    /**
+     * TrackBy for both result and chip lists.
+     * @param {number} index -list index.
+     * @param {SelectOption} option -the option.
+     * @return {(string | number)}
+     * @memberof OrgMultiSelectComponent
+     */
+    trackByFn(index: number, option: SelectOption): string | number;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<OrgMultiSelectComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<OrgMultiSelectComponent, "ieeesa-org-multi-select", never, { "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "supportMessage": { "alias": "supportMessage"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "options": { "alias": "options"; "required": false; }; "selectedOptions": { "alias": "selectedOptions"; "required": false; }; "required": { "alias": "required"; "required": false; }; "removeIconURL": { "alias": "removeIconURL"; "required": false; }; "clearAllIconURL": { "alias": "clearAllIconURL"; "required": false; }; }, { "search": "search"; "selectionChange": "selectionChange"; "fieldBlur": "fieldBlur"; "invalidFreeText": "invalidFreeText"; }, never, never, true, never>;
+}

package/lib/components/roster-import/roster-import.component.d.ts

@@ -1,22 +1,46 @@
-import { EventEmitter, OnDestroy } from '@angular/core';
+import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
 import { Subject } from 'rxjs';
-import { RosterUploadError, RosterUploadResponse } from '../../models/roster-import.model';
+import { RosterImportJob } from '../../models/roster-import.model';
+import { RosterImportApiService } from '../../services/roster-import-api.service';
+import { GroupsService } from '../../services/groups.service';
 import * as i0 from "@angular/core";
 /** States of the roster import flow. */
 type RosterImportState = 'upload' | 'processing' | 'result';
 /**
- * Roster Import dialog (MOCK data phase).
+ * View-model for the result screen. Populated from the confirmed
+ * {@link RosterImportJob} returned by the backend.
+ */
+interface RosterImportResult {
+    totalRecords: number;
+    successCount: number;
+    failureCount: number;
+}
+/** Row error shown on the result screen (mapped from the BE error report). */
+interface RosterImportRowError {
+    rowNumber: number;
+    field?: string;
+    errorMessage: string;
+}
+/**
+ * Roster Import dialog.
  *
- * Lets an admin upload a CSV/XLS/XLSX roster file, shows a processing progress
+ * Lets an admin upload a CSV/XLSX roster file, shows a processing progress
  * bar, then a result summary (added / skipped) with per-row errors and an
- * error-log download. Mirrors the events-and-meetings bulk-import-participants
- * flow. The real backend is not wired yet — {@link onImport} resolves a mock
- * response after a short delay so every Figma state can be exercised.
+ * error-log download.
+ *
+ * Wired to the real backend roster-import state machine
+ * (sa-saapps-groups-api `RosterImportController`) via
+ * {@link RosterImportApiService}: on Import it runs
+ * upload → validate → confirm and renders the confirmed job's terminal counts
+ * and per-row errors. Server-side validation errors (1072 unsupported format,
+ * 1073 too large, 1074 row limit, 1075 invalid status) are surfaced inline.
  *
  * @export
  * @class RosterImportComponent
  */
-export declare class RosterImportComponent implements OnDestroy {
+export declare class RosterImportComponent implements OnInit, OnDestroy {
+    private rosterImportApiService;
+    private groupService;
     /** Carries the { groupId, groupName } payload from the opening dialog. */
     componentData: any;
     /** Emitted after an import that added at least one row (parent refreshes). */
@@ -32,12 +56,10 @@ export declare class RosterImportComponent implements OnDestroy {
     selectedFile: File | null;
     /** File drag-over state. */
     isDragOver: boolean;
-    /** Processing progress percentage (0–100) shown next to the progress bar. */
-    progressValue: number;
-    /** Terminal upload result (mock). */
-    uploadResult: RosterUploadResponse | null;
+    /** Terminal upload result. */
+    uploadResult: RosterImportResult | null;
     /** Row-level errors for the completed job. */
-    jobErrors: RosterUploadError[];
+    jobErrors: RosterImportRowError[];
     /** Inline validation / API error message. */
     errorMessage: string | null;
     /**
@@ -45,21 +67,24 @@ export declare class RosterImportComponent implements OnDestroy {
      * (Figma: "No roster data found...").
      */
     noDataMessage: string | null;
-    /** Maximum file size in bytes (5 MB). */
-    readonly MAX_FILE_SIZE = 5242880;
-    /** Accepted file extensions. */
+    /** The import job id returned by upload (kept so cancel can clean it up). */
+    private importId;
+    /** Maximum file size in bytes (10 MB) — matches the BE 10MB limit. */
+    readonly MAX_FILE_SIZE = 10485760;
+    /** Accepted file extensions (must match the BE contract: only .csv / .xlsx). */
     readonly ACCEPTED_EXTENSIONS: string[];
-    /**
-     * MOCK ONLY: which scenario the next import simulates. Cycles through the
-     * scenarios so QA can see every result state by importing repeatedly. Remove
-     * when the real API is wired in.
-     */
-    private mockScenarios;
-    private mockScenarioIndex;
+    constructor(rosterImportApiService: RosterImportApiService, groupService: GroupsService);
     /** Required column headers for display. */
     get requiredColumns(): string[];
     /** Comma-separated accepted file types for the input element. */
     get acceptedFileTypes(): string;
+    /** The target group id from the dialog payload (falls back to selection). */
+    private get groupId();
+    /**
+     * Sets the API base URL on the import service.
+     * @memberof RosterImportComponent
+     */
+    ngOnInit(): void;
     /**
      * Cleans up subscriptions when the component is destroyed.
      * @memberof RosterImportComponent
@@ -106,20 +131,41 @@ export declare class RosterImportComponent implements OnDestroy {
      */
     onRemoveFile(): void;
     /**
-     * MOCK: "uploads" the file by simulating a short processing delay, then
-     * resolves the next mock scenario. Replace the timer + mock lookup with the
-     * real service call once the API is available.
+     * Runs the real import: upload → validate → confirm. The progress bar is
+     * shown in indeterminate mode while the chain is in flight, then the
+     * confirmed job's terminal counts + per-row errors drive the result screen.
      * @memberof RosterImportComponent
      */
     onImport(): void;
     /**
-     * Stores the terminal result and moves to the result state. When the file
-     * had no data rows, shows the "no roster data" info banner instead of the
-     * summary cards.
-     * @param {RosterUploadResponse} body - The terminal (mock) result.
+     * Maps a failed import call to an inline error message and returns the UI to
+     * the upload state so the user can retry. Known BE error codes (1072–1075)
+     * are mapped via constants; anything else uses the generic message.
+     * @param {*} error - The HttpErrorResponse.
      * @memberof RosterImportComponent
      */
-    finalizeResult(body: RosterUploadResponse): void;
+    private handleImportError;
+    /**
+     * Stores the terminal result and moves to the result state. When the job had
+     * no data rows, shows the "no roster data" info banner instead of the summary
+     * cards.
+     * @param {RosterImportJob} job - The confirmed import job.
+     * @memberof RosterImportComponent
+     */
+    finalizeResult(job: RosterImportJob): void;
+    /**
+     * Parses the BE `errorReport` raw JSON string into row-error view models.
+     *
+     * The BE stores the report as a JSONB document wrapping the per-row entries:
+     * `{ "rows": [ { "row": 2, "field": "Email", "message": "..." } ] }`
+     * (serialized by its `ErrorReportWrapper`) and returns it verbatim via
+     * `@JsonRawValue`. So we read `parsed.rows`. A bare top-level array is also
+     * accepted as a fallback in case the contract is ever flattened.
+     * @param {(string | undefined)} errorReport - Raw JSON error report string.
+     * @return {RosterImportRowError[]}
+     * @memberof RosterImportComponent
+     */
+    private parseErrorReport;
     /**
      * Whether the result state should show the summary cards (added / skipped).
      * Hidden for the "no data records" case.
@@ -166,13 +212,6 @@ export declare class RosterImportComponent implements OnDestroy {
      * @memberof RosterImportComponent
      */
     private triggerDownload;
-    /**
-     * MOCK ONLY: returns the next scenario in the cycle so repeated imports show
-     * every result state.
-     * @return {RosterImportMockScenario}
-     * @memberof RosterImportComponent
-     */
-    private nextMockScenario;
     static ɵfac: i0.ɵɵFactoryDeclaration<RosterImportComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RosterImportComponent, "ieeesa-roster-import", never, { "componentData": { "alias": "componentData"; "required": false; }; }, { "submitFormResponse": "submitFormResponse"; "formCancel": "formCancel"; }, never, never, true, never>;
 }