@ieeesa-npm/dashboard 0.0.0-stage → 0.0.2

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

@@ -0,0 +1,175 @@
+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 { DashboardSectionState } from '../../models/dashboard-section-state.model';
+import { PageChange } from '../../models/page-change.model';
+import { UpcomingEvent } from '../../models/upcoming-event.model';
+import * as i0 from "@angular/core";
+/**
+ * Upcoming_Meetings_Events renders the "Upcoming Meetings & Events" dashboard
+ * section: a section title and "View All" link, a collapse/expand toggle that
+ * starts expanded, and one {@link EventGroupCardComponent} per upcoming event.
+ *
+ * The section is driven by its `sectionState` input: it shows the Loader while
+ * `LOADING`, the event-group cards while `LOADED`, the empty-state message while
+ * `EMPTY`, and the error message while `ERROR` — the four regions are mutually
+ * exclusive (Req 13.1, 13.2, 13.3, 13.5). The component is purely
+ * presentational: "View All" emits `viewAll` (Req 5.1, 5.2), the collapse toggle
+ * flips `isExpanded` and the card-list visibility while exposing
+ * `[attr.aria-expanded]` (Req 5.3, 5.4, 14.3), and each card is rendered via
+ * `*ngFor` with {@link trackByEventId} to preserve input order (Req 5.5, 5.6,
+ * 14.4). Card outputs (`viewEvent`/`openMeeting`/`logAttendance`/`leaveMeeting`)
+ * are bubbled upward unchanged, and each card's `pageChange` is mapped to
+ * `meetingPageChange` tagged with the originating event id (Req 6.9).
+ * @export
+ * @class UpcomingMeetingsEventsComponent
+ */
+export declare class UpcomingMeetingsEventsComponent {
+    /** User-facing strings sourced from `constants.json`. */
+    constants: any;
+    /** Enum reference for template comparisons against `sectionState`. */
+    readonly sectionStates: typeof DashboardSectionState;
+    /** The upcoming events rendered as event-group cards (Req 5.5, 5.6). */
+    events: UpcomingEvent[];
+    /** The load/empty/error status driving the section's mutually exclusive regions. */
+    sectionState: DashboardSectionState;
+    /** 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 card. */
+    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 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). */
+    viewEvent: EventEmitter<string>;
+    /** Bubbles the meeting id when a card's meeting-name link is activated (Req 7.4). */
+    openMeeting: EventEmitter<string>;
+    /** Bubbles the meeting id when a card requests logging attendance (Req 7.7). */
+    logAttendance: EventEmitter<string>;
+    /** Bubbles the meeting id when a card requests leaving the meeting (Req 7.8). */
+    leaveMeeting: EventEmitter<string>;
+    /** Emits the requested page tagged with its event id when a card paginates (Req 6.9). */
+    meetingPageChange: EventEmitter<{
+        eventId: string;
+    } & PageChange>;
+    /** Emits the event id + one-based page to lazily load an event's child meetings. */
+    loadEventMeetings: EventEmitter<{
+        eventId: string;
+        page: number;
+    }>;
+    /** 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). */
+    get totalItems(): number;
+    /**
+     * The slice of events/meetings for the current section page (5 per page),
+     * used by the card `*ngFor`.
+     * @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.
+     * @param {PageEvent} event - The Material paginator page event.
+     * @return {void}
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onSectionPageChange(event: PageEvent): void;
+    /**
+     * 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
+     * expand state while leaving the user's own toggle free to change it after.
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    set expanded(value: boolean);
+    get expanded(): boolean;
+    /**
+     * Emits the new expanded state whenever the user toggles the section, so a
+     * two-way `[(expanded)]` binding keeps the host's flag in sync (otherwise a
+     * host-opened section the user then collapses leaves the host flag stale,
+     * making a repeat "Jump to" a no-op).
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    expandedChange: EventEmitter<boolean>;
+    /**
+     * `trackBy` for the event-group-card `*ngFor`, keyed by the stable event id so
+     * Angular renders exactly one card per event in input order (Req 5.5, 5.6, 14.4).
+     * @param {number} index - The iteration index (fallback key).
+     * @param {UpcomingEvent} event - The event for this card.
+     * @return {string} The stable track key (event id).
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    trackByEventId(index: number, event: UpcomingEvent): string;
+    /**
+     * Toggles the section's expanded/collapsed state, inverting the card-list
+     * visibility and the exposed `aria-expanded` value (Req 5.4, 14.3).
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onToggleExpanded(): void;
+    /**
+     * Handles the "View All" link, emitting the `viewAll` intent to the host (Req 5.2).
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onViewAll(): void;
+    /**
+     * Bubbles a card's "View Event" activation upward (Req 6.4).
+     * @param {string} eventId - The event id emitted by the card.
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onViewEvent(eventId: string): void;
+    /**
+     * Bubbles a card's meeting-name link activation upward (Req 7.4).
+     * @param {string} meetingId - The meeting id emitted by the card.
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onOpenMeeting(meetingId: string): void;
+    /**
+     * Bubbles a card's log-attendance request upward (Req 7.7).
+     * @param {string} meetingId - The meeting id emitted by the card.
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onLogAttendance(meetingId: string): void;
+    /**
+     * Bubbles a card's leave-meeting request upward (Req 7.8).
+     * @param {string} meetingId - The meeting id emitted by the card.
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onLeaveMeeting(meetingId: string): void;
+    /**
+     * Maps a card's `pageChange` into a `meetingPageChange` tagged with the
+     * originating event id so the host can page the correct event (Req 6.9).
+     * @param {string} eventId - The id of the event whose card paginated.
+     * @param {PageChange} page - The requested page from the card paginator.
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onMeetingPageChange(eventId: string, page: PageChange): void;
+    /**
+     * Bubbles a card's lazy child-meeting load request upward, tagged with the
+     * originating event id so the container can fetch that event's meetings.
+     * @param {string} eventId - The event whose meetings to load.
+     * @param {number} page - The one-based page requested by the card.
+     * @memberof UpcomingMeetingsEventsComponent
+     */
+    onLoadEventMeetings(eventId: string, page: number): 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"; "expandedChange": "expandedChange"; }, never, never, true, never>;
+}

package/lib/components/welcome-header/dashboard-welcome-header.component.d.ts

@@ -0,0 +1,98 @@
+import { EventEmitter } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Identifies which dashboard section a "Jump to" shortcut targets, emitted via
+ * {@link DashboardWelcomeHeaderComponent.shortcutSelected} for the host/container
+ * to scroll to or navigate.
+ */
+export declare enum DashboardJumpTarget {
+    MEETINGS = "MEETINGS",
+    GROUPS = "GROUPS"
+}
+/**
+ * A single "Jump to" shortcut rendered in the welcome header: a circular icon
+ * that expands on hover/focus into a pill showing the section label and its
+ * count badge.
+ */
+interface JumpShortcut {
+    target: DashboardJumpTarget;
+    label: string;
+    iconUrl: string;
+    ariaLabel: string;
+    count: number;
+}
+/**
+ * Welcome_Header renders the personalized greeting and the "Jump to" shortcut
+ * control at the top of the dashboard.
+ *
+ * The greeting is composed from the greeting label in `constants.json` and the
+ * supplied `userName`, falling back to the configured fallback greeting when the
+ * name is empty or undefined. The "Jump to" control shows one circular icon per
+ * dashboard section (Upcoming Meetings & Events, Your Groups); hovering or
+ * focusing an icon expands it into a pill with the section label and a count
+ * badge (the counts are supplied by the host via `meetingsCount` /
+ * `groupsCount`). Activating a shortcut emits {@link shortcutSelected} with the
+ * target section for the host to act on. Purely presentational — no API work.
+ * @export
+ * @class DashboardWelcomeHeaderComponent
+ */
+export declare class DashboardWelcomeHeaderComponent {
+    private readonly constants;
+    /** User-facing strings sourced from `constants.json`. */
+    readonly texts: any;
+    /** Enum reference for template comparisons. */
+    readonly jumpTarget: typeof DashboardJumpTarget;
+    private userNameValue;
+    /**
+     * The signed-in user's display name. Drives the personalized greeting; when
+     * empty or undefined the greeting falls back to the configured fallback text.
+     * @memberof DashboardWelcomeHeaderComponent
+     */
+    set userName(value: string);
+    get userName(): string;
+    private meetingsCountValue;
+    /** Count shown in the Upcoming Meetings & Events shortcut badge. */
+    set meetingsCount(value: number);
+    get meetingsCount(): number;
+    private groupsCountValue;
+    /** Count shown in the Your Groups shortcut badge. */
+    set groupsCount(value: number);
+    get groupsCount(): number;
+    /** Emits the selected "Jump to" target for the host to act on. */
+    shortcutSelected: EventEmitter<DashboardJumpTarget>;
+    /** The jump shortcuts rendered in the control, rebuilt when counts change. */
+    shortcuts: JumpShortcut[];
+    /**
+     * The personalized greeting: the greeting label plus the user's name when
+     * present, otherwise the configured fallback greeting.
+     * @readonly
+     * @memberof DashboardWelcomeHeaderComponent
+     */
+    get greeting(): string;
+    /**
+     * Emits the chosen shortcut's target for the host to scroll/navigate to.
+     * @param {DashboardJumpTarget} target - The selected section.
+     * @memberof DashboardWelcomeHeaderComponent
+     */
+    onShortcutClick(target: DashboardJumpTarget): void;
+    /**
+     * TrackBy for the shortcut list.
+     * @param {number} _index
+     * @param {JumpShortcut} shortcut
+     * @return {string}
+     * @memberof DashboardWelcomeHeaderComponent
+     */
+    trackByTarget(_index: number, shortcut: JumpShortcut): string;
+    /** Rebuilds the shortcut list so the template reflects the latest counts. */
+    private buildShortcuts;
+    /**
+     * Builds the shortcut view models from `constants.json` and the current
+     * counts.
+     * @return {JumpShortcut[]}
+     * @memberof DashboardWelcomeHeaderComponent
+     */
+    private buildShortcutList;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DashboardWelcomeHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DashboardWelcomeHeaderComponent, "ieeesa-dashboard-welcome-header", never, { "userName": { "alias": "userName"; "required": false; }; "meetingsCount": { "alias": "meetingsCount"; "required": false; }; "groupsCount": { "alias": "groupsCount"; "required": false; }; }, { "shortcutSelected": "shortcutSelected"; }, never, never, true, never>;
+}
+export {};

package/lib/components/your-groups/your-groups.component.d.ts

@@ -0,0 +1,159 @@
+import { EventEmitter } from '@angular/core';
+import { PageEvent } from '@angular/material/paginator';
+import { DashboardSectionState } from '../../models/dashboard-section-state.model';
+import { GroupHierarchyNode, GroupRow } from '../../models/group-row.model';
+import { PageChange } from '../../models/page-change.model';
+import * as i0 from "@angular/core";
+/**
+ * A single rendered table row. Either a top-level group row (`kind: 'group'`,
+ * carrying the full {@link GroupRow}) or a hierarchy (ancestor) row revealed
+ * when a group is expanded (`kind: 'hierarchy'`, carrying the ancestor node and
+ * its depth for indentation).
+ */
+interface TableRow {
+    kind: 'group' | 'hierarchy';
+    group?: GroupRow;
+    node?: GroupHierarchyNode;
+    level: number;
+}
+/**
+ * Groups_Section (`ieeesa-your-groups`) renders the signed-in user's groups in
+ * a collapsible card as a custom hierarchy table styled like the My Profile
+ * Find Groups tree: each group row carries a blue +/- toggle (when it has an
+ * ancestor hierarchy) that expands to reveal the group's hierarchy path
+ * (root→leaf), indented. Columns: Group, Type, Officer Role, Affiliation,
+ * Member Level (the member level renders as a coloured pill — green for an
+ * assigned level, amber for "Unassigned"). The card paginates the top-level
+ * groups (5 per page).
+ *
+ * Purely presentational: data arrives via `@Input`, intents leave via
+ * `@Output`; no API or navigation here. States (loader / empty / error / table)
+ * are driven by `sectionState`.
+ * @export
+ * @class YourGroupsComponent
+ */
+export declare class YourGroupsComponent {
+    private readonly constants;
+    /** User-facing strings sourced from `constants.json`. */
+    readonly texts: any;
+    /** Enum reference for template comparisons against `sectionState`. */
+    readonly sectionStates: typeof DashboardSectionState;
+    /** Per-level indentation step (px) for the expanded hierarchy rows. */
+    readonly indentPerLevel = 28;
+    /** Selectable "Items per page" page sizes. */
+    readonly pageSizeOptions: number[];
+    private groupsValue;
+    /** The groups rendered in the table. */
+    set groups(value: GroupRow[]);
+    get groups(): GroupRow[];
+    /** The section's load/empty/error state driving the mutually-exclusive regions. */
+    sectionState: DashboardSectionState;
+    /** Total number of groups (for the "{n} Groups" count and paginator). */
+    totalGroups: number;
+    private pageIndexValue;
+    /** Current zero-based page index. */
+    set pageIndex(value: number);
+    get pageIndex(): number;
+    private pageSizeValue;
+    /** Current page size (defaults to 5 rows per page per the design). */
+    set pageSize(value: number);
+    get pageSize(): number;
+    /** Emits when the "View All" link is activated. */
+    viewAllGroups: EventEmitter<void>;
+    /** Emits the requested page when the paginator changes. */
+    pageChange: EventEmitter<PageChange>;
+    /**
+     * Emits the new expanded state whenever the user toggles the card, so a
+     * two-way `[(expanded)]` binding keeps the host's flag in sync. Without this,
+     * a host that opened the card (expanded=true) and then the user collapsing it
+     * would leave the host flag stale, so re-opening via the same input value
+     * would be a no-op.
+     * @memberof YourGroupsComponent
+     */
+    expandedChange: EventEmitter<boolean>;
+    /** Whether the card is expanded (table visible). Starts collapsed. */
+    isExpanded: boolean;
+    /**
+     * Allows the host/container to open or close the card (e.g. a "Jump to"
+     * shortcut opens it).
+     * @memberof YourGroupsComponent
+     */
+    set expanded(value: boolean);
+    get expanded(): boolean;
+    /** GroupIds of the top-level groups whose hierarchy is currently expanded. */
+    private readonly expandedGroupIds;
+    /** The flattened rows currently rendered (group rows + any expanded hierarchy rows). */
+    visibleRows: TableRow[];
+    /**
+     * The count shown in the header subtitle — the server total when provided,
+     * otherwise the number of groups.
+     * @readonly
+     * @memberof YourGroupsComponent
+     */
+    get groupCount(): number;
+    /**
+     * Whether a group row can expand: it has an ancestor hierarchy (more than the
+     * group's own node). A single-node hierarchy (the group itself) is a leaf.
+     * @param {GroupRow} group
+     * @return {boolean}
+     * @memberof YourGroupsComponent
+     */
+    hasHierarchy(group: GroupRow): boolean;
+    /**
+     * Whether the given group row is currently expanded.
+     * @param {GroupRow} group
+     * @return {boolean}
+     * @memberof YourGroupsComponent
+     */
+    isGroupExpanded(group: GroupRow): boolean;
+    /**
+     * Toggles a group's hierarchy expansion and rebuilds the visible rows.
+     * @param {GroupRow} group
+     * @memberof YourGroupsComponent
+     */
+    onToggleHierarchy(group: GroupRow): void;
+    /**
+     * Toggles the card's expanded/collapsed state (whole table visibility) and
+     * emits the new state so the host's two-way binding stays in sync.
+     * @memberof YourGroupsComponent
+     */
+    onToggleExpand(): void;
+    /**
+     * Emits the "View All" intent for the host.
+     * @memberof YourGroupsComponent
+     */
+    onViewAll(): void;
+    /**
+     * Re-emits the Material paginator change (page index or "Items per page"
+     * size) as a {@link PageChange} for the host.
+     * @param {PageEvent} event - The Material paginator event.
+     * @memberof YourGroupsComponent
+     */
+    onPaginatorChange(event: PageEvent): void;
+    /**
+     * Resolves the member-level pill CSS class, mirroring the My Groups profile
+     * tab: an assigned level renders green (success), "Unassigned" renders amber.
+     * @param {string} memberLevel
+     * @return {string}
+     * @memberof YourGroupsComponent
+     */
+    resolveBadgeClass(memberLevel: string): string;
+    /**
+     * TrackBy for the rendered table rows.
+     * @param {number} index
+     * @param {TableRow} row
+     * @return {string}
+     * @memberof YourGroupsComponent
+     */
+    trackByRow(index: number, row: TableRow): string;
+    /**
+     * Rebuilds the flat list of visible rows: the current page of top-level group
+     * rows, each optionally followed by its hierarchy (ancestor) rows when the
+     * group is expanded. The hierarchy path is shown root→leaf, indented by depth.
+     * @memberof YourGroupsComponent
+     */
+    private rebuildRows;
+    static ɵfac: i0.ɵɵFactoryDeclaration<YourGroupsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<YourGroupsComponent, "ieeesa-your-groups", never, { "groups": { "alias": "groups"; "required": false; }; "sectionState": { "alias": "sectionState"; "required": false; }; "totalGroups": { "alias": "totalGroups"; "required": false; }; "pageIndex": { "alias": "pageIndex"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; }, { "viewAllGroups": "viewAllGroups"; "pageChange": "pageChange"; "expandedChange": "expandedChange"; }, never, never, true, never>;
+}
+export {};