@ieeesa-npm/dashboard 0.0.6 → 0.0.7

package/lib/components/upcoming-meetings-events/upcoming-meetings-events.component.d.ts

@@ -42,6 +42,14 @@ export declare class UpcomingMeetingsEventsComponent {
     inFlightMeetingIds: ReadonlySet<string>;
     /** Whether the host has determined the viewport is at/below the mobile breakpoint. */
     isMobileView: boolean;
+    /** Server total across all pages — the main paginator length (from `totalRecords`). */
+    totalRecords: number;
+    /** Server count of EVENT rows across all pages (collapsed summary). */
+    eventCount: number;
+    /** Server count of STANDALONE MEETING rows across all pages (collapsed summary). */
+    standaloneMeetingCount: number;
+    /** Server count of standalone meetings open for attendance across all pages (collapsed summary). */
+    standaloneMeetingsOpenForAttendanceCount: number;
     /** Emits when the "View All" link is activated (Req 5.2). */
     viewAll: EventEmitter<void>;
     /** Bubbles the event id when a card's "View Event" button is activated (Req 6.4). */
@@ -71,61 +79,31 @@ export declare class UpcomingMeetingsEventsComponent {
     }>;
     /** Whether the section's card list is currently expanded; starts collapsed. */
     isExpanded: boolean;
-    /** Section-level page size — 5 events/meetings per page per the design. */
-    readonly sectionPageSize = 5;
-    /** The current zero-based page index of the section list. */
-    sectionPageIndex: number;
-    /** The total number of events/meetings in the section (paginator length). */
+    /** Selectable "Items per page" page sizes, matching the Your Groups card. */
+    readonly pageSizeOptions: number[];
+    /** The current zero-based page index of the section list (host/server-driven). */
+    pageIndex: number;
+    /** The current page size of the section list (host/server-driven). */
+    pageSize: number;
+    /** Emits the requested page when the section paginator changes (server-paged). */
+    sectionPageChange: EventEmitter<PageChange>;
+    /** The total number of events/meetings in the section (paginator length), from the server. */
     get totalItems(): number;
     /**
-     * The slice of events/meetings for the current section page (5 per page),
-     * used by the card `*ngFor`.
+     * The events for the current page. The list endpoint is server-paged, so the
+     * component renders the events it was given directly (no client-side slicing).
      * @return {UpcomingEvent[]} The events on the current page.
      * @memberof UpcomingMeetingsEventsComponent
      */
     get pagedEvents(): UpcomingEvent[];
-    /** The one-based index of the first item shown on the current page. */
-    get sectionRangeStart(): number;
-    /** The one-based index of the last item shown on the current page. */
-    get sectionRangeEnd(): number;
     /**
-     * The section paginator range label (e.g. "1-5 of 20 Meetings & Events")
-     * built from the `constants.json` template.
-     * @return {string} The formatted range label.
-     * @memberof UpcomingMeetingsEventsComponent
-     */
-    get sectionRangeLabel(): string;
-    /**
-     * Handles the section paginator change, updating the current section page.
+     * Handles the section paginator change, emitting the requested page/size so
+     * the container can load the matching server page (no client-side slicing).
      * @param {PageEvent} event - The Material paginator page event.
      * @return {void}
      * @memberof UpcomingMeetingsEventsComponent
      */
     onSectionPageChange(event: PageEvent): void;
-    /** Number of EVENT rows in the list (for the collapsed summary). */
-    get eventCount(): number;
-    /**
-     * Total number of meetings across the list: each event's `meetingCount` plus
-     * one per standalone meeting (for the collapsed summary).
-     * @return {number} The total meeting count.
-     * @memberof UpcomingMeetingsEventsComponent
-     */
-    get totalMeetingCount(): number;
-    /**
-     * Total number of meetings open for attendance across the list (for the
-     * collapsed summary): each event's open count plus any standalone meeting that
-     * is attendance-eligible.
-     * @return {number} The total open-for-attendance count.
-     * @memberof UpcomingMeetingsEventsComponent
-     */
-    get totalOpenForAttendanceCount(): number;
-    /**
-     * The collapsed summary line (e.g. "3 events · 50 meetings · 21 open for
-     * attendance") built from the `constants.json` template and the counts.
-     * @return {string} The formatted collapsed summary.
-     * @memberof UpcomingMeetingsEventsComponent
-     */
-    get collapsedSummary(): string;
     /**
      * Allows the host/container to open or close the section (e.g. a "Jump to"
      * shortcut opens it). Writing the input mirrors the value onto the internal
@@ -217,5 +195,5 @@ export declare class UpcomingMeetingsEventsComponent {
         leaveMeeting?: boolean;
     }): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<UpcomingMeetingsEventsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<UpcomingMeetingsEventsComponent, "ieeesa-upcoming-meetings-events", never, { "events": { "alias": "events"; "required": false; }; "sectionState": { "alias": "sectionState"; "required": false; }; "permissions": { "alias": "permissions"; "required": false; }; "attendanceStates": { "alias": "attendanceStates"; "required": false; }; "inFlightMeetingIds": { "alias": "inFlightMeetingIds"; "required": false; }; "isMobileView": { "alias": "isMobileView"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; }, { "viewAll": "viewAll"; "viewEvent": "viewEvent"; "openMeeting": "openMeeting"; "logAttendance": "logAttendance"; "leaveMeeting": "leaveMeeting"; "meetingPageChange": "meetingPageChange"; "loadEventMeetings": "loadEventMeetings"; "navigateToMeeting": "navigateToMeeting"; "expandedChange": "expandedChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UpcomingMeetingsEventsComponent, "ieeesa-upcoming-meetings-events", never, { "events": { "alias": "events"; "required": false; }; "sectionState": { "alias": "sectionState"; "required": false; }; "permissions": { "alias": "permissions"; "required": false; }; "attendanceStates": { "alias": "attendanceStates"; "required": false; }; "inFlightMeetingIds": { "alias": "inFlightMeetingIds"; "required": false; }; "isMobileView": { "alias": "isMobileView"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "eventCount": { "alias": "eventCount"; "required": false; }; "standaloneMeetingCount": { "alias": "standaloneMeetingCount"; "required": false; }; "standaloneMeetingsOpenForAttendanceCount": { "alias": "standaloneMeetingsOpenForAttendanceCount"; "required": false; }; "pageIndex": { "alias": "pageIndex"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; }, { "viewAll": "viewAll"; "viewEvent": "viewEvent"; "openMeeting": "openMeeting"; "logAttendance": "logAttendance"; "leaveMeeting": "leaveMeeting"; "meetingPageChange": "meetingPageChange"; "loadEventMeetings": "loadEventMeetings"; "navigateToMeeting": "navigateToMeeting"; "sectionPageChange": "sectionPageChange"; "expandedChange": "expandedChange"; }, never, never, true, never>;
 }

package/lib/dashboard.component.d.ts

@@ -10,6 +10,7 @@ import { DashboardUserInfo } from './models/dashboard-user-info.model';
 import { GroupRow } from './models/group-row.model';
 import { PageChange } from './models/page-change.model';
 import { UpcomingEvent } from './models/upcoming-event.model';
+import { UpcomingSummary } from './models/upcoming-summary.model';
 import { DashboardService } from './services/dashboard.service';
 import { UserPermissionsService } from './services/user-permissions.service';
 import { DashboardJumpTarget } from './components/welcome-header/dashboard-welcome-header.component';
@@ -101,12 +102,6 @@ export declare class DashboardComponent implements OnInit, OnDestroy {
             eventDatesLabel: string;
             meetingDateLabel: string;
             timeTimezoneLabel: string;
-            /**
-             * A navigation intent emitted by {@link DashboardComponent} for the host
-             * application to act on. The library never performs navigation itself; it emits
-             * the resolved target `path` (from the {@link DashboardRouteConfig}) together
-             * with the triggering identifier so the host can route accordingly (Req 11.1).
-             */
             meetingsLabel: string;
             noMeetingsMessage: string;
             openForAttendanceTemplate: string;
@@ -213,6 +208,12 @@ export declare class DashboardComponent implements OnInit, OnDestroy {
     dashboardNavigate: EventEmitter<DashboardNavigationIntent>;
     /** The user's upcoming events, bound to the upcoming section (Req 13.1, 13.2). */
     upcomingEvents: UpcomingEvent[];
+    /** Server-provided summary counts (paginator length + collapsed-summary counts). */
+    upcomingSummary: UpcomingSummary;
+    /** Zero-based page index of the upcoming section's server-paged list. */
+    upcomingPageIndex: number;
+    /** Page size of the upcoming section's server-paged list. */
+    upcomingPageSize: number;
     /** The user's groups, bound to the groups section (Req 13.1, 13.2). */
     groups: GroupRow[];
     /** The upcoming-events section's load/empty/error state (Req 13.1, 13.2, 13.5). */
@@ -419,6 +420,16 @@ export declare class DashboardComponent implements OnInit, OnDestroy {
      * @memberof DashboardComponent
      */
     private loadUpcomingEvents;
+    /**
+     * Handles the upcoming section's paginator change by requesting the matching
+     * server page. The list endpoint is server-paged, so the paginator length is
+     * the response `totalRecords`; page/size are converted to the one-based API
+     * page and a fresh page is loaded (no client-side slicing) (Req 3.x).
+     * @param {PageChange} page - The requested zero-based page index and size.
+     * @return {void}
+     * @memberof DashboardComponent
+     */
+    onUpcomingPageChange(page: PageChange): void;
     /**
      * Triggers the groups load, setting the section to `ERROR` on failure so only
      * the section error region renders. Isolated from the upcoming-events load so

package/lib/models/event-meeting-list-item.model.d.ts

@@ -49,7 +49,14 @@ export interface EventMeetingListItem {
 }
 /** Body of the home events-&-meetings list response. */
 export interface EventMeetingListBody {
+    /** Total number of rows across all pages (paginator length). */
     totalRecords: number;
+    /** Number of EVENT rows across all pages (collapsed-summary count). */
+    eventCount: number;
+    /** Number of STANDALONE MEETING rows across all pages (collapsed-summary count). */
+    standaloneMeetingCount: number;
+    /** Number of standalone meetings open for attendance across all pages (collapsed-summary count). */
+    standaloneMeetingsOpenForAttendanceCount: number;
     eventMeetingList: EventMeetingListItem[];
 }
 /** Response envelope for the home events-&-meetings list endpoint. */

package/lib/models/upcoming-summary.model.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Server-provided summary counts for the "Upcoming Meetings & Events" section,
+ * taken directly from the home events-&-meetings list response body. These back
+ * the paginator length and the collapsed-summary line so no counts are computed
+ * (or hardcoded) on the frontend.
+ */
+export interface UpcomingSummary {
+    /** Total number of rows across all pages — the main paginator length. */
+    totalRecords: number;
+    /** Number of EVENT rows across all pages. */
+    eventCount: number;
+    /** Number of STANDALONE MEETING rows across all pages. */
+    standaloneMeetingCount: number;
+    /** Number of standalone meetings open for attendance across all pages. */
+    standaloneMeetingsOpenForAttendanceCount: number;
+}

package/lib/services/dashboard.service.d.ts

@@ -7,6 +7,7 @@ import { DashboardSectionState } from '../models/dashboard-section-state.model';
 import { GroupRow } from '../models/group-row.model';
 import { MyGroupsView } from '../models/my-groups-view.model';
 import { UpcomingEvent } from '../models/upcoming-event.model';
+import { UpcomingSummary } from '../models/upcoming-summary.model';
 import { EventMeetingDetailResponse, EventMeetingListResponse } from '../models/event-meeting-list-item.model';
 import * as i0 from "@angular/core";
 /**
@@ -32,6 +33,7 @@ export declare class DashboardService {
     apiBaseUrl: string;
     userPermissions: UserPermission[];
     private readonly upcomingEvents;
+    private readonly upcomingSummary;
     private readonly groups;
     private readonly upcomingState;
     private readonly groupsState;
@@ -39,6 +41,8 @@ export declare class DashboardService {
     private readonly inFlightMeetingIds;
     /** Emits the list of the user's upcoming events. */
     upcomingEvents$: Observable<UpcomingEvent[]>;
+    /** Emits the server-provided summary counts (paginator length + collapsed-summary counts). */
+    upcomingSummary$: Observable<UpcomingSummary>;
     /** Emits the list of the user's groups. */
     groups$: Observable<GroupRow[]>;
     /** Emits the load/empty/error state of the upcoming-events section. */
@@ -72,7 +76,7 @@ export declare class DashboardService {
      * @return {Observable<EventMeetingListResponse>} The home events-&-meetings response envelope.
      * @memberof DashboardService
      */
-    loadUpcomingEvents(): Observable<EventMeetingListResponse>;
+    loadUpcomingEvents(page?: number, size?: number): Observable<EventMeetingListResponse>;
     /**
      * Lazily loads (and paginates) the child meetings of an EVENT via
      * `POST {apiBaseUrl}/meetings/home/events/{eventId}/meetings` (the drill-down

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ieeesa-npm/dashboard",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "peerDependencies": {
     "@angular/common": "^16.1.0",
     "@angular/core": "^16.1.0",

package/public-api.d.ts

@@ -14,6 +14,7 @@ export * from './lib/models/page-change.model';
 export * from './lib/models/dashboard-user-info.model';
 export * from './lib/models/meeting-row.model';
 export * from './lib/models/upcoming-event.model';
+export * from './lib/models/upcoming-summary.model';
 export * from './lib/models/event-meeting-list-item.model';
 export * from './lib/models/event-meeting-list-payload.model';
 export * from './lib/models/group-row.model';