@cqa-lib/cqa-ui 1.1.557 → 1.1.558

package/lib/sidebar/nav-item.component.d.ts

@@ -0,0 +1,48 @@
+import { ElementRef, OnDestroy, EventEmitter } from '@angular/core';
+import { ConnectedPosition, Overlay, ScrollStrategy } from '@angular/cdk/overlay';
+import { NavChildItem, NavItem } from './sidebar.models';
+import * as i0 from "@angular/core";
+export declare class NavItemComponent implements OnDestroy {
+    private readonly overlay;
+    item: NavItem;
+    isActive: boolean;
+    /** Whether the sidebar is in expanded (wide) mode */
+    isExpanded: boolean;
+    /** Whether this item's sub-menu is open */
+    isOpen: boolean;
+    /** Current route / selection id — used to highlight child in collapsed flyout */
+    activeNavId: string;
+    itemClick: EventEmitter<string>;
+    navHostRef?: ElementRef<HTMLElement>;
+    /** Collapsed parent: drives CDK connected overlay for submenu */
+    showCollapsedFlyout: boolean;
+    private closeFlyoutTimer;
+    private static readonly FLYOUT_CLOSE_DELAY_MS;
+    readonly flyoutScrollStrategy: ScrollStrategy;
+    readonly collapsedFlyoutPositions: ConnectedPosition[];
+    constructor(overlay: Overlay);
+    ngOnDestroy(): void;
+    get hasChildren(): boolean;
+    get collapsedFlyoutOpen(): boolean;
+    /**
+     * Collapsed rail: show label (leaf) or disabled copy in MatTooltip so it renders in CDK overlay,
+     * not as an absolute child inside the scrolling nav.
+     */
+    get collapsedRailTooltip(): string;
+    get collapsedRailTooltipClass(): string;
+    isChildRowActive(childId: string): boolean;
+    onHostMouseEnter(): void;
+    onHostMouseLeave(): void;
+    onHostFocusIn(_e: FocusEvent): void;
+    onHostFocusOut(e: FocusEvent): void;
+    onFlyoutOverlayPointerEnter(): void;
+    onFlyoutOverlayPointerLeave(): void;
+    onFlyoutOverlayFocusOut(e: FocusEvent): void;
+    closeCollapsedFlyout(): void;
+    onClick(): void;
+    onChildRowClick(e: Event, child: NavChildItem): void;
+    private clearFlyoutCloseTimer;
+    private scheduleCloseCollapsedFlyout;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NavItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NavItemComponent, "cqa-nav-item", never, { "item": "item"; "isActive": "isActive"; "isExpanded": "isExpanded"; "isOpen": "isOpen"; "activeNavId": "activeNavId"; }, { "itemClick": "itemClick"; }, never, never>;
+}

package/lib/sidebar/nav-menu.component.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from '@angular/core';
+import { NavMenuItem, NavItem, NavSection } from './sidebar.models';
+import * as i0 from "@angular/core";
+export declare class NavMenuComponent {
+    items: NavMenuItem[];
+    activeId: string;
+    isExpanded: boolean;
+    /** IDs of parent nav items whose sub-menus are currently open */
+    openParents: string[];
+    itemClick: EventEmitter<string>;
+    isSection(item: NavMenuItem): item is NavSection;
+    asNavItem(item: NavMenuItem): NavItem;
+    isItemActive(item: NavItem): boolean;
+    isParentOpen(item: NavItem): boolean;
+    isChildActive(childId: string): boolean;
+    onItemClick(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NavMenuComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NavMenuComponent, "cqa-nav-menu", never, { "items": "items"; "activeId": "activeId"; "isExpanded": "isExpanded"; "openParents": "openParents"; }, { "itemClick": "itemClick"; }, never, never>;
+}

package/lib/sidebar/nav-sub-item.component.d.ts

@@ -0,0 +1,11 @@
+import { EventEmitter } from '@angular/core';
+import { NavChildItem } from './sidebar.models';
+import * as i0 from "@angular/core";
+export declare class NavSubItemComponent {
+    item: NavChildItem;
+    isActive: boolean;
+    itemClick: EventEmitter<string>;
+    onClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NavSubItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NavSubItemComponent, "cqa-nav-sub-item", never, { "item": "item"; "isActive": "isActive"; }, { "itemClick": "itemClick"; }, never, never>;
+}

package/lib/sidebar/profile-menu/profile-menu.component.d.ts

@@ -0,0 +1,35 @@
+import { AfterViewInit, EventEmitter, OnChanges, OnDestroy, SimpleChanges, TemplateRef, ViewContainerRef } from '@angular/core';
+import { Overlay } from '@angular/cdk/overlay';
+import { ProfileMenuEntry, ProfileMenuItem, ProfileMenuUser, isProfileMenuDivider } from './profile-menu.models';
+import * as i0 from "@angular/core";
+export declare class ProfileMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
+    private overlay;
+    private viewContainerRef;
+    user: ProfileMenuUser;
+    entries: ProfileMenuEntry[];
+    anchor: HTMLElement | null;
+    /** Optional id on the popover element — useful for aria-labelledby wiring. */
+    popoverId?: string;
+    itemClick: EventEmitter<string>;
+    dismissed: EventEmitter<void>;
+    popoverTpl: TemplateRef<unknown>;
+    private overlayRef;
+    private keySub;
+    private backdropSub;
+    private viewInitialized;
+    constructor(overlay: Overlay, viewContainerRef: ViewContainerRef);
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    isDivider: typeof isProfileMenuDivider;
+    /** Narrowing helper for the template — Angular's template type checker can't
+     * follow our custom type guard through `*ngIf-else`, so we surface a typed cast
+     * via this method instead. */
+    asItem(entry: ProfileMenuEntry): ProfileMenuItem | null;
+    trackByEntry: (index: number, _entry: ProfileMenuEntry) => number;
+    onItemClick(item: ProfileMenuItem): void;
+    private openOverlay;
+    private closeOverlay;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ProfileMenuComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ProfileMenuComponent, "cqa-profile-menu", never, { "user": "user"; "entries": "entries"; "anchor": "anchor"; "popoverId": "popoverId"; }, { "itemClick": "itemClick"; "dismissed": "dismissed"; }, never, never>;
+}

package/lib/sidebar/profile-menu/profile-menu.models.d.ts

@@ -0,0 +1,35 @@
+export interface ProfileMenuUser {
+    /** Two-letter initials shown in the avatar circle (e.g. "TB"). */
+    initials: string;
+    /** Display name (e.g. "Teslim Bello"). */
+    name: string;
+    /** Optional email shown under the name. */
+    email?: string;
+    /** Optional role pill rendered below the email (e.g. "Workspace Admin"). */
+    badge?: {
+        label: string;
+        /** Visual variant: 'admin' (purple, default) or 'default' (neutral). */
+        variant?: 'admin' | 'default';
+    };
+    /** Optional CSS background override for the avatar (gradient or solid). */
+    avatarColor?: string;
+}
+export interface ProfileMenuItem {
+    /** Stable identifier emitted via `itemClick` when the row is clicked. */
+    id: string;
+    label: string;
+    /** Icon font class — same convention as NavItem.iconClass (e.g. "fa-solid fa-user"). */
+    iconClass?: string;
+    /** Raw inline SVG markup. Sanitized internally before render. Takes precedence over `iconClass`. */
+    iconSvg?: string;
+    /** Optional keyboard hint chip rendered on the right (e.g. "⌘O"). */
+    shortcut?: string;
+    /** 'danger' renders the row in red (used for Logout). */
+    variant?: 'default' | 'danger';
+    disabled?: boolean;
+}
+export interface ProfileMenuDivider {
+    type: 'divider';
+}
+export declare type ProfileMenuEntry = ProfileMenuItem | ProfileMenuDivider;
+export declare function isProfileMenuDivider(entry: ProfileMenuEntry): entry is ProfileMenuDivider;

package/lib/sidebar/sidebar.component.d.ts

@@ -0,0 +1,97 @@
+import { EventEmitter, OnChanges, OnInit, SimpleChanges, ElementRef, OnDestroy } from '@angular/core';
+import { DomSanitizer, SafeUrl } from '@angular/platform-browser';
+import { NavMenuItem, SidebarConfig } from './sidebar.models';
+import { ProfileMenuEntry, ProfileMenuUser } from './profile-menu/profile-menu.models';
+import { WorkspaceMenuItem } from './workspace-menu/workspace-menu.models';
+import * as i0 from "@angular/core";
+export declare class SidebarComponent implements OnInit, OnChanges, OnDestroy {
+    private sanitizer;
+    config: SidebarConfig;
+    navItems: NavMenuItem[];
+    activeNavId: string;
+    /** Parent item IDs to open by default (in addition to the one containing the active item). */
+    initialOpenParentIds: string[];
+    /**
+     * User details rendered in the profile-menu popover header. Required for the popover
+     * to open; when undefined the profile card retains its legacy single-action behavior
+     * (clicking it directly fires `logoutClick`).
+     */
+    profileUser?: ProfileMenuUser;
+    /**
+     * Menu entries shown inside the profile-menu popover. Provide at least one entry to
+     * enable the popover; an empty array preserves the legacy `logoutClick` behavior.
+     */
+    profileMenuEntries: ProfileMenuEntry[];
+    /**
+     * Workspaces shown inside the workspace-switcher popover. Provide at least one entry
+     * to enable the popover; an empty array preserves the legacy `workspaceSwitchClick`
+     * behavior (single emit on click, no UI).
+     */
+    workspaces: WorkspaceMenuItem[];
+    /** Id of the currently active workspace — drives the checkmark and active-row tint. */
+    currentWorkspaceId?: string | number;
+    navItemClick: EventEmitter<string>;
+    ctaClick: EventEmitter<void>;
+    searchClick: EventEmitter<void>;
+    workspaceSwitchClick: EventEmitter<void>;
+    logoutClick: EventEmitter<void>;
+    notificationsClick: EventEmitter<void>;
+    helpDocsClick: EventEmitter<void>;
+    speakerClick: EventEmitter<void>;
+    liveChatClick: EventEmitter<void>;
+    expandedChange: EventEmitter<boolean>;
+    /** Emits `ProfileMenuItem.id` when the user activates an entry in the profile popover. */
+    profileMenuItemClick: EventEmitter<string>;
+    /** Emits the workspace id when the user picks one from the workspace popover. */
+    workspaceSelected: EventEmitter<string | number>;
+    /** Emits when the user clicks the "Workspace Management" footer row. */
+    manageWorkspacesClick: EventEmitter<void>;
+    profileAnchorRef?: ElementRef<HTMLElement>;
+    workspaceAnchorRef?: ElementRef<HTMLElement>;
+    isExpanded: boolean;
+    isPinned: boolean;
+    openParents: string[];
+    isProfileMenuOpen: boolean;
+    isWorkspaceMenuOpen: boolean;
+    private leaveCollapseTimer;
+    private static readonly LEAVE_COLLAPSE_MS;
+    constructor(sanitizer: DomSanitizer);
+    /**
+     * Sanitizer bypass so `data:image/svg+xml;base64,…` URIs render in the workspace
+     * avatar — Angular 13's default URL sanitizer rewrites them to `unsafe:…`.
+     */
+    get workspaceLogoSafe(): SafeUrl | null;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    onProfileClick(): void;
+    onProfileMenuItemClick(id: string): void;
+    onProfileMenuDismissed(): void;
+    onWorkspaceClick(): void;
+    onWorkspaceMenuItemClick(id: string | number): void;
+    onWorkspaceMenuDismissed(): void;
+    onManageWorkspacesClick(): void;
+    /** Burger: wide sidebar without pinning — collapses on mouse leave. */
+    openSidebar(): void;
+    /** Header collapse control: always closes and clears pin. */
+    closeSidebar(): void;
+    pinSidebar(): void;
+    /** Cancel delayed collapse when the pointer returns to the sidebar. */
+    onAsideMouseEnter(): void;
+    /**
+     * When expanded but not pinned, collapse after the pointer leaves the rail.
+     * Skips scheduling if the pointer is moving into our CDK flyout / rail tooltip overlays.
+     */
+    onAsideMouseLeave(ev: MouseEvent): void;
+    private isPointerEnteringSidebarOverlay;
+    private clearLeaveCollapseTimer;
+    onNavItemClick(id: string): void;
+    get workspaceInitial(): string;
+    private toggleParent;
+    /** True if `id` matches a submenu row under some top-level nav item. */
+    private isChildNavId;
+    private findTopLevelNavItem;
+    private ensureActiveParentOpen;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarComponent, "cqa-sidebar", never, { "config": "config"; "navItems": "navItems"; "activeNavId": "activeNavId"; "initialOpenParentIds": "initialOpenParentIds"; "profileUser": "profileUser"; "profileMenuEntries": "profileMenuEntries"; "workspaces": "workspaces"; "currentWorkspaceId": "currentWorkspaceId"; }, { "navItemClick": "navItemClick"; "ctaClick": "ctaClick"; "searchClick": "searchClick"; "workspaceSwitchClick": "workspaceSwitchClick"; "logoutClick": "logoutClick"; "notificationsClick": "notificationsClick"; "helpDocsClick": "helpDocsClick"; "speakerClick": "speakerClick"; "liveChatClick": "liveChatClick"; "expandedChange": "expandedChange"; "profileMenuItemClick": "profileMenuItemClick"; "workspaceSelected": "workspaceSelected"; "manageWorkspacesClick": "manageWorkspacesClick"; }, never, never>;
+}

package/lib/sidebar/sidebar.models.d.ts

@@ -0,0 +1,63 @@
+export interface NavItem {
+    id: string;
+    label: string;
+    /** CSS icon class rendered as <i class="iconClass"> */
+    iconClass?: string;
+    /** Route path — consuming component navigates on navItemClick */
+    routerLink?: string;
+    children?: NavChildItem[];
+    /** Badge count or label, e.g. "3" */
+    badge?: string;
+    status?: 'live' | 'danger';
+    isNew?: boolean;
+    disabled?: boolean;
+    disabledTooltip?: string;
+}
+export interface NavChildItem {
+    id: string;
+    label: string;
+    iconClass?: string;
+    routerLink?: string;
+    isNew?: boolean;
+    disabled?: boolean;
+}
+export interface NavSection {
+    type: 'section';
+    label: string;
+}
+export declare type NavMenuItem = NavItem | NavSection;
+export declare function isNavSection(item: NavMenuItem): item is NavSection;
+export { ProfileMenuUser, ProfileMenuItem, ProfileMenuDivider, ProfileMenuEntry, isProfileMenuDivider, } from './profile-menu/profile-menu.models';
+export interface SidebarConfig {
+    workspaceName?: string;
+    /** Optional logo image URL/data-URI shown inside the workspace avatar. Falls back to the workspace initial when not provided. */
+    workspaceLogo?: string;
+    /** e.g. 'Live' */
+    workspaceBadge?: string;
+    workspaceStatus?: 'live' | 'warning' | 'offline';
+    userName?: string;
+    userInitials?: string;
+    userRole?: string;
+    /** Label for the CTA button, e.g. 'New Test Case' */
+    ctaLabel?: string;
+    searchPlaceholder?: string;
+    showSearch?: boolean;
+    /** When true, shows a ⌘K hint in the expanded search row */
+    showSearchShortcut?: boolean;
+    showCta?: boolean;
+    /** Reserved; notifications are not shown on the collapsed rail. */
+    showNotifications?: boolean;
+    /** Reserved; badge is not shown on the collapsed rail. */
+    notificationCount?: number;
+    showLiveChat?: boolean;
+    /** Help & docs entry (expanded footer + collapsed utility stack). Default true */
+    showHelpDocs?: boolean;
+    /** Reserved; speaker / “what’s new” is not shown on the collapsed rail. */
+    showSpeaker?: boolean;
+    /** Label for the help utility when the sidebar is expanded */
+    helpDocsLabel?: string;
+    /** When true, the sidebar starts expanded and pinned (mouse leave does not collapse). */
+    defaultPinned?: boolean;
+    /** When false, hides the header pin control (expanded sidebar always auto-collapses on mouse leave unless defaultPinned). Default: true. */
+    showSidebarPin?: boolean;
+}

package/lib/sidebar/workspace-menu/workspace-menu.component.d.ts

@@ -0,0 +1,34 @@
+import { AfterViewInit, EventEmitter, OnChanges, OnDestroy, SimpleChanges, TemplateRef, ViewContainerRef } from '@angular/core';
+import { Overlay } from '@angular/cdk/overlay';
+import { WorkspaceMenuItem } from './workspace-menu.models';
+import * as i0 from "@angular/core";
+export declare class WorkspaceMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
+    private overlay;
+    private viewContainerRef;
+    workspaces: WorkspaceMenuItem[];
+    currentWorkspaceId?: string | number;
+    /** Name of the currently active workspace — interpolated into the popover heading. */
+    workspaceName?: string;
+    anchor: HTMLElement | null;
+    /** Optional id on the popover element — useful for aria-labelledby wiring. */
+    popoverId?: string;
+    workspaceSelected: EventEmitter<string | number>;
+    manageWorkspacesClick: EventEmitter<void>;
+    dismissed: EventEmitter<void>;
+    popoverTpl: TemplateRef<unknown>;
+    private overlayRef;
+    private keySub;
+    private backdropSub;
+    private viewInitialized;
+    constructor(overlay: Overlay, viewContainerRef: ViewContainerRef);
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    trackByWs: (_index: number, item: WorkspaceMenuItem) => string | number;
+    onItemClick(item: WorkspaceMenuItem): void;
+    onManageClick(): void;
+    private openOverlay;
+    private closeOverlay;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMenuComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMenuComponent, "cqa-workspace-menu", never, { "workspaces": "workspaces"; "currentWorkspaceId": "currentWorkspaceId"; "workspaceName": "workspaceName"; "anchor": "anchor"; "popoverId": "popoverId"; }, { "workspaceSelected": "workspaceSelected"; "manageWorkspacesClick": "manageWorkspacesClick"; "dismissed": "dismissed"; }, never, never>;
+}

package/lib/sidebar/workspace-menu/workspace-menu.models.d.ts

@@ -0,0 +1,12 @@
+export interface WorkspaceMenuItem {
+    id: string | number;
+    name: string;
+    /** One-line meta text shown under the name, e.g. "Web · 12 members". Free-form. */
+    subtitle?: string;
+    /** Initials drawn inside the avatar tile when no logo URL is provided (e.g. "CQ"). */
+    initials?: string;
+    /** Optional logo image URL or data-URI. Takes precedence over `initials`. */
+    logoUrl?: string;
+    /** Optional CSS background for the avatar tile (gradient or solid). */
+    avatarColor?: string;
+}