@ieeesa-npm/dashboard 0.0.0-stage → 0.0.1

package/lib/components/event-group-card/event-group-card.component.d.ts

@@ -0,0 +1,300 @@
+import { EventEmitter } from '@angular/core';
+import { PageEvent } from '@angular/material/paginator';
+import { AttendanceActionPermissions } from '../../models/attendance-action-permissions.model';
+import { AttendanceState } from '../../models/attendance-state.model';
+import { MeetingRow } from '../../models/meeting-row.model';
+import { PageChange } from '../../models/page-change.model';
+import { UpcomingEvent } from '../../models/upcoming-event.model';
+import * as i0 from "@angular/core";
+/**
+ * Event_Group_Card renders a single upcoming event as a card: the status badge,
+ * title, day indicator, meeting-count summary sub-line, start/end date, and
+ * timezone (all luxon-formatted). It exposes a "View Event" action, a
+ * show/hide toggle for the meeting list labeled with the open-for-attendance
+ * count, the per-event meeting rows (one {@link MeetingAttendanceRowComponent}
+ * per meeting on the current page), and a per-card paginator.
+ *
+ * The component is purely presentational — it emits navigation, attendance, and
+ * pagination intents via `@Output()` and never performs navigation or HTTP
+ * itself. Meeting-row outputs (`openMeeting`/`logAttendance`/`leaveMeeting`) are
+ * bubbled upward unchanged so the container can delegate to the service.
+ * @export
+ * @class EventGroupCardComponent
+ */
+export declare class EventGroupCardComponent {
+    /** User-facing strings sourced from `constants.json`. */
+    constants: {
+        welcomeHeader: {
+            greeting: string;
+            fallbackGreeting: string;
+            helperText: string;
+            jumpToLabel: string;
+            shortcuts: {
+                meetings: {
+                    label: string;
+                    iconUrl: string;
+                    ariaLabel: string;
+                };
+                groups: {
+                    label: string;
+                    iconUrl: string;
+                    ariaLabel: string;
+                };
+            };
+        };
+        upcomingSection: {
+            title: string;
+            viewAllLabel: string;
+            expandLabel: string;
+            collapseLabel: string;
+            ariaLabel: {
+                viewAll: string;
+                toggle: string;
+            };
+            emptyMessage: string;
+            errorMessage: string;
+        };
+        eventGroupCard: {
+            viewEventLabel: string;
+            meetingListToggle: {
+                showLabelPrefix: string;
+                showLabelSuffix: string;
+                hideLabel: string;
+            };
+            ariaLabel: {
+                viewEvent: string;
+                meetingListToggle: string;
+            };
+            paginator: {
+                rangeTemplate: string;
+                totalTemplate: string;
+            };
+        };
+        meetingRow: {
+            emptyFieldPlaceholder: string;
+            currentlyAttendingIndicator: string;
+            logAttendanceLabel: string;
+            leaveMeetingLabel: string;
+            ariaLabel: {
+                meetingNameLink: string;
+                logAttendance: string;
+                leaveMeeting: string;
+            };
+        };
+        groupsSection: {
+            title: string;
+            viewAllLabel: string;
+            expandLabel: string;
+            collapseLabel: string;
+            countSuffix: string;
+            emptyValue: string;
+            ariaLabel: {
+                viewAll: string;
+                toggle: string;
+                groupLink: string;
+            };
+            columns: {
+                group: string;
+                type: string;
+                officerRole: string;
+                affiliation: string;
+                memberLevel: string;
+            };
+            paginator: {
+                rangeTemplate: string;
+                totalTemplate: string;
+            };
+            /** Set of meeting ids with an attendance action awaiting resolution. */
+            memberLevelBadge: {
+                votingMember: string;
+                default: string;
+            };
+            /** Whether the host has determined the viewport is at/below the mobile breakpoint. */
+            emptyMessage: string;
+            errorMessage: string; /** Emits the event id when the "View Event" button is activated (Req 6.4). */
+        };
+        memberLevel: {
+            colorMap: {
+                "Voting Member": string;
+                Observer: string;
+                /** Bubbles the meeting id when a row's meeting-name link is activated (Req 6.7, 7.4). */
+                "Associate Member": string;
+                Member: string;
+                default: string;
+            };
+        };
+        /** Bubbles the meeting id when a row requests logging attendance (Req 6.7, 7.7). */
+        attendance: {
+            errorMessage: string;
+        };
+        footer: {
+            links: {
+                label: string;
+                target: string;
+            }[];
+            copyright: string;
+        };
+        defaultRouteConfig: {
+            eventDetail: string;
+            meetingDetail: string;
+            groupDetail: string;
+            viewAllEvents: string;
+            viewAllGroups: string;
+        };
+    };
+    /** The upcoming event rendered by this card. */
+    event: UpcomingEvent;
+    /** Host permissions gating the per-row log-attendance / leave-meeting buttons. */
+    permissions: AttendanceActionPermissions;
+    /** Map of meeting id to current attendance state, passed down to each row. */
+    attendanceStates: Record<string, AttendanceState>;
+    /** Set of meeting ids with an attendance action awaiting resolution. */
+    inFlightMeetingIds: ReadonlySet<string>;
+    /** Whether the host has determined the viewport is at/below the mobile breakpoint. */
+    isMobileView: boolean;
+    /** Emits the event id when the "View Event" button is activated (Req 6.4). */
+    viewEvent: EventEmitter<string>;
+    /** Bubbles the meeting id when a row's meeting-name link is activated (Req 6.7, 7.4). */
+    openMeeting: EventEmitter<string>;
+    /** Bubbles the meeting id when a row requests logging attendance (Req 6.7, 7.7). */
+    logAttendance: EventEmitter<string>;
+    /** Bubbles the meeting id when a row requests leaving the meeting (Req 6.7, 7.8). */
+    leaveMeeting: EventEmitter<string>;
+    /** Emits the requested page when the per-card paginator changes (Req 6.9, 3.3). */
+    pageChange: EventEmitter<PageChange>;
+    /** The default page size for the per-card meeting paginator. */
+    readonly defaultPageSize = 5;
+    /** The current zero-based page index of the meeting list. */
+    pageIndex: number;
+    /** The current page size of the meeting list. */
+    pageSize: number;
+    /** Whether the meeting list is currently shown (toggled open). */
+    isMeetingListOpen: boolean;
+    /**
+     * The full list of meetings for the event, defaulting to an empty list when
+     * the event has none.
+     * @return {MeetingRow[]} The event's meetings.
+     * @memberof EventGroupCardComponent
+     */
+    get meetings(): MeetingRow[];
+    /** The total number of meetings for the event (paginator length). */
+    get totalMeetings(): number;
+    /**
+     * The slice of meetings for the current page, used by the row `*ngFor`.
+     * @return {MeetingRow[]} The meetings on the current page.
+     * @memberof EventGroupCardComponent
+     */
+    get pagedMeetings(): MeetingRow[];
+    /**
+     * The one-based index of the first meeting shown on the current page, or 0
+     * when there are no meetings.
+     * @return {number} The start index for the range template.
+     * @memberof EventGroupCardComponent
+     */
+    get rangeStart(): number;
+    /**
+     * The one-based index of the last meeting shown on the current page, clamped
+     * to the total meeting count.
+     * @return {number} The end index for the range template.
+     * @memberof EventGroupCardComponent
+     */
+    get rangeEnd(): number;
+    /**
+     * The paginator range label (e.g. "Showing 1-5 of 12") built from the
+     * `constants.json` range template with the current start/end/total values.
+     * @return {string} The formatted range label.
+     * @memberof EventGroupCardComponent
+     */
+    get rangeLabel(): string;
+    /**
+     * The meeting-count summary sub-line (e.g. "12 meetings") built from the
+     * `constants.json` total template with the event's meeting count.
+     * @return {string} The formatted meeting-count summary.
+     * @memberof EventGroupCardComponent
+     */
+    get meetingCountSummary(): string;
+    /**
+     * The meeting-list show/hide toggle label. When the list is hidden the label
+     * reads "Show Meetings ({count} open for attendance)" built from the
+     * `constants.json` templates and the event's open-for-attendance count; when
+     * the list is shown the label reads the configured hide label (Req 6.5).
+     * @return {string} The toggle button label.
+     * @memberof EventGroupCardComponent
+     */
+    get meetingListToggleLabel(): string;
+    /** The luxon-formatted start date of the event (Req 6.2). */
+    get formattedStartDate(): string;
+    /** The luxon-formatted end date of the event (Req 6.2). */
+    get formattedEndDate(): string;
+    /**
+     * `trackBy` for the meeting-row `*ngFor`, keyed by the stable meeting id so
+     * Angular reuses row components across pagination/state changes (Req 6.7, 14.4).
+     * @param {number} _index - The iteration index (unused).
+     * @param {MeetingRow} meeting - The meeting for this row.
+     * @return {string} The stable track key (meeting id).
+     * @memberof EventGroupCardComponent
+     */
+    trackByMeetingId(_index: number, meeting: MeetingRow): string;
+    /**
+     * Resolves the attendance state for a meeting from the `attendanceStates` map,
+     * defaulting to `NOT_ATTENDING` when the map has no entry for it.
+     * @param {MeetingRow} meeting - The meeting to resolve state for.
+     * @return {AttendanceState} The attendance state passed to the row.
+     * @memberof EventGroupCardComponent
+     */
+    resolveAttendanceState(meeting: MeetingRow): AttendanceState;
+    /**
+     * Resolves whether a meeting has an attendance action in flight from the
+     * `inFlightMeetingIds` set.
+     * @param {MeetingRow} meeting - The meeting to check.
+     * @return {boolean} True when the meeting's action is awaiting resolution.
+     * @memberof EventGroupCardComponent
+     */
+    resolveIsInFlight(meeting: MeetingRow): boolean;
+    /**
+     * Toggles the meeting-list visibility (Req 6.6).
+     * @memberof EventGroupCardComponent
+     */
+    onToggleMeetingList(): void;
+    /**
+     * Handles the "View Event" button, emitting the event id to the host (Req 6.4).
+     * @memberof EventGroupCardComponent
+     */
+    onViewEvent(): void;
+    /**
+     * Bubbles a row's meeting-name link activation upward (Req 6.7, 7.4).
+     * @param {string} meetingId - The id emitted by the row.
+     * @memberof EventGroupCardComponent
+     */
+    onOpenMeeting(meetingId: string): void;
+    /**
+     * Bubbles a row's log-attendance request upward (Req 6.7, 7.7).
+     * @param {string} meetingId - The id emitted by the row.
+     * @memberof EventGroupCardComponent
+     */
+    onLogAttendance(meetingId: string): void;
+    /**
+     * Bubbles a row's leave-meeting request upward (Req 6.7, 7.8).
+     * @param {string} meetingId - The id emitted by the row.
+     * @memberof EventGroupCardComponent
+     */
+    onLeaveMeeting(meetingId: string): void;
+    /**
+     * Handles the per-card paginator change, updating the local page state and
+     * emitting the requested page as a {@link PageChange} (Req 6.9, 3.3).
+     * @param {PageEvent} event - The Material paginator page event.
+     * @memberof EventGroupCardComponent
+     */
+    onPageChange(event: PageEvent): void;
+    /**
+     * Parses an ISO string with luxon and formats it with the supplied token,
+     * returning the raw value unchanged when it is missing or unparseable.
+     * @param {string | undefined} isoValue - The ISO date/time string.
+     * @param {string} format - The luxon format token.
+     * @return {string} The formatted value or the raw/empty fallback.
+     * @memberof EventGroupCardComponent
+     */
+    private formatIso;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EventGroupCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EventGroupCardComponent, "ieeesa-event-group-card", never, { "event": { "alias": "event"; "required": false; }; "permissions": { "alias": "permissions"; "required": false; }; "attendanceStates": { "alias": "attendanceStates"; "required": false; }; "inFlightMeetingIds": { "alias": "inFlightMeetingIds"; "required": false; }; "isMobileView": { "alias": "isMobileView"; "required": false; }; }, { "viewEvent": "viewEvent"; "openMeeting": "openMeeting"; "logAttendance": "logAttendance"; "leaveMeeting": "leaveMeeting"; "pageChange": "pageChange"; }, never, never, true, never>;
+}

package/lib/components/meeting-attendance-row/meeting-attendance-row.component.d.ts

@@ -0,0 +1,239 @@
+import { EventEmitter } from '@angular/core';
+import { AttendanceActionPermissions } from '../../models/attendance-action-permissions.model';
+import { AttendanceState } from '../../models/attendance-state.model';
+import { MeetingRow } from '../../models/meeting-row.model';
+import * as i0 from "@angular/core";
+/**
+ * Meeting_Attendance_Row renders a single meeting within an event-group card:
+ * the meeting-name link, group/committee, room/location, date, and
+ * time+timezone (all luxon-formatted), together with the attendance action
+ * button that drives the per-meeting attendance state machine.
+ *
+ * The component is purely presentational — it emits navigation and attendance
+ * intents via `@Output()` and never performs navigation or HTTP itself. The
+ * action button delegates to the pure `resolveAttendanceAction` handler so the
+ * emit/guard logic is shared with the property-tested core (Property 1), and the
+ * displayed state only advances when the host updates `attendanceState`.
+ * @export
+ * @class MeetingAttendanceRowComponent
+ */
+export declare class MeetingAttendanceRowComponent {
+    constants: {
+        welcomeHeader: {
+            greeting: string;
+            fallbackGreeting: string;
+            helperText: string;
+            jumpToLabel: string;
+            shortcuts: {
+                meetings: {
+                    label: string;
+                    iconUrl: string;
+                    ariaLabel: string;
+                };
+                groups: {
+                    label: string;
+                    iconUrl: string;
+                    ariaLabel: string;
+                };
+            };
+        };
+        upcomingSection: {
+            title: string;
+            viewAllLabel: string;
+            expandLabel: string;
+            collapseLabel: string;
+            ariaLabel: {
+                viewAll: string;
+                toggle: string;
+            };
+            emptyMessage: string;
+            errorMessage: string;
+        };
+        eventGroupCard: {
+            viewEventLabel: string;
+            meetingListToggle: {
+                showLabelPrefix: string;
+                showLabelSuffix: string;
+                hideLabel: string;
+            };
+            ariaLabel: {
+                viewEvent: string;
+                meetingListToggle: string;
+            };
+            paginator: {
+                rangeTemplate: string;
+                totalTemplate: string;
+            };
+        };
+        meetingRow: {
+            emptyFieldPlaceholder: string;
+            currentlyAttendingIndicator: string;
+            logAttendanceLabel: string;
+            leaveMeetingLabel: string;
+            ariaLabel: {
+                meetingNameLink: string;
+                logAttendance: string;
+                leaveMeeting: string;
+            };
+        };
+        groupsSection: {
+            title: string;
+            viewAllLabel: string; /** Whether an attendance action for this meeting is awaiting resolution. */
+            expandLabel: string;
+            collapseLabel: string;
+            countSuffix: string;
+            emptyValue: string;
+            ariaLabel: {
+                viewAll: string;
+                toggle: string;
+                groupLink: string;
+            };
+            columns: {
+                group: string;
+                type: string;
+                officerRole: string;
+                affiliation: string;
+                memberLevel: string;
+            };
+            paginator: {
+                rangeTemplate: string;
+                totalTemplate: string; /** Emits the meeting id to request leaving the meeting (Req 7.8). */
+            };
+            memberLevelBadge: {
+                votingMember: string;
+                default: string;
+            };
+            emptyMessage: string;
+            errorMessage: string;
+        };
+        memberLevel: {
+            colorMap: {
+                "Voting Member": string;
+                Observer: string;
+                "Associate Member": string;
+                Member: string;
+                default: string;
+            };
+        };
+        attendance: {
+            errorMessage: string;
+        };
+        footer: {
+            links: {
+                label: string;
+                target: string;
+            }[];
+            copyright: string;
+        };
+        defaultRouteConfig: {
+            eventDetail: string;
+            meetingDetail: string;
+            groupDetail: string;
+            viewAllEvents: string; /**
+             * Resolves a group-or-committee / room-or-location field value, substituting
+             * the empty-field placeholder from `constants.json` when the value is empty or
+             * undefined (Req 7.2).
+             * @param {string | undefined} value - The raw field value from the meeting.
+             * @return {string} The value to display, or the empty-field placeholder.
+             * @memberof MeetingAttendanceRowComponent
+             */
+            viewAllGroups: string;
+        };
+    };
+    /** The meeting rendered by this row. */
+    meeting: MeetingRow;
+    /** The current attendance state controlling label/indicator and action. */
+    attendanceState: AttendanceState;
+    /** Whether an attendance action for this meeting is awaiting resolution. */
+    isInFlight: boolean;
+    /** Host permissions gating the log-attendance / leave-meeting buttons. */
+    permissions: AttendanceActionPermissions;
+    /** Emits the meeting id when the meeting-name link is activated (Req 7.4). */
+    openMeeting: EventEmitter<string>;
+    /** Emits the meeting id to request logging attendance (Req 7.7). */
+    logAttendance: EventEmitter<string>;
+    /** Emits the meeting id to request leaving the meeting (Req 7.8). */
+    leaveMeeting: EventEmitter<string>;
+    /** Expose the enum to the template for state comparisons. */
+    readonly AttendanceState: typeof AttendanceState;
+    /**
+     * Whether this row is actionable — a non-empty `meetingId` is required for the
+     * meeting-name link and action button to emit anything (Req 7.10).
+     * @return {boolean} True when the row has a usable meeting id.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    get isActionable(): boolean;
+    /**
+     * Whether the row is in the currently-attending state, which shows the
+     * currently-attending indicator and the leave-meeting action (Req 7.5).
+     * @return {boolean} True when the attendance state is `CURRENTLY_ATTENDING`.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    get isCurrentlyAttending(): boolean;
+    /**
+     * Whether the log-attendance button should be shown: only when the row is in
+     * the log state (not currently attending) and the host grants
+     * `canLogAttendance` (Req 7.6, 12.1).
+     * @return {boolean} True when the log-attendance button is visible.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    get showLogAttendanceButton(): boolean;
+    /**
+     * Whether the leave-meeting button should be shown: only when the row is in
+     * the currently-attending state and the host grants `canLeaveMeeting`
+     * (Req 7.5, 12.2).
+     * @return {boolean} True when the leave-meeting button is visible.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    get showLeaveMeetingButton(): boolean;
+    /**
+     * Resolves a group-or-committee / room-or-location field value, substituting
+     * the empty-field placeholder from `constants.json` when the value is empty or
+     * undefined (Req 7.2).
+     * @param {string | undefined} value - The raw field value from the meeting.
+     * @return {string} The value to display, or the empty-field placeholder.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    resolveFieldValue(value: string | undefined): string;
+    /**
+     * Formats the meeting date for display using the shared luxon display format
+     * (Req 7.3). Falls back to the raw value when it cannot be parsed.
+     * @return {string} The formatted meeting date.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    get formattedDate(): string;
+    /**
+     * Formats the meeting time + timezone for display using luxon (Req 7.3).
+     * The timezone abbreviation from the meeting model is appended to the parsed
+     * time. Falls back to the raw value when it cannot be parsed.
+     * @return {string} The formatted meeting time with timezone.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    get formattedTime(): string;
+    /**
+     * Handles activation of the attendance action button. Delegates to the pure
+     * `resolveAttendanceAction` handler and emits exactly one event based on the
+     * resolved action: `logAttendance` for `LOG_ATTENDANCE`, `leaveMeeting` for
+     * `LEAVE_MEETING`, and nothing for `NONE` (empty id or in-flight)
+     * (Req 7.7, 7.8, 7.9, 7.10, 13.6).
+     * @memberof MeetingAttendanceRowComponent
+     */
+    onAttendanceAction(): void;
+    /**
+     * Handles activation of the meeting-name link. Emits the meeting id only when
+     * the row is actionable (non-empty meeting id) (Req 7.4, 7.10).
+     * @memberof MeetingAttendanceRowComponent
+     */
+    onOpenMeeting(): void;
+    /**
+     * Parses an ISO string with luxon and formats it with the supplied token,
+     * returning the raw value unchanged when it is missing or unparseable.
+     * @param {string | undefined} isoValue - The ISO date/time string.
+     * @param {string} format - The luxon format token.
+     * @return {string} The formatted value or the raw/empty fallback.
+     * @memberof MeetingAttendanceRowComponent
+     */
+    private formatIso;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MeetingAttendanceRowComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MeetingAttendanceRowComponent, "ieeesa-meeting-attendance-row", never, { "meeting": { "alias": "meeting"; "required": false; }; "attendanceState": { "alias": "attendanceState"; "required": false; }; "isInFlight": { "alias": "isInFlight"; "required": false; }; "permissions": { "alias": "permissions"; "required": false; }; }, { "openMeeting": "openMeeting"; "logAttendance": "logAttendance"; "leaveMeeting": "leaveMeeting"; }, never, never, true, never>;
+}