@memberjunction/ng-explorer-core 5.48.0 → 5.50.0

package/dist/lib/shell/components/header/app-nav.component.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter, OnInit, OnDestroy, ChangeDetectorRef } from '@angular/core';
+import { EventEmitter, OnInit, OnDestroy, AfterViewInit, ChangeDetectorRef, ElementRef } from '@angular/core';
 import { BaseApplication, NavItem, WorkspaceStateManager } from '@memberjunction/ng-base-application';
 import { SharedService } from '@memberjunction/ng-shared';
 import * as i0 from "@angular/core";
@@ -12,15 +12,21 @@ export interface NavItemClickEvent {
 /**
  * Horizontal navigation items for the current app.
  * Uses OnPush change detection and reactive state management for optimal performance.
+ *
+ * Overflow behavior (priority+ pattern): when the header can't fit every nav item,
+ * trailing items collapse into a "More" dropdown instead of squeezing the header's
+ * action cluster off-screen. Item widths are measured once per nav-items change
+ * (all items render for one frame, widths are cached), then every resize recomputes
+ * the fit from the cache — no re-measure, no layout thrash.
  */
-export declare class AppNavComponent implements OnInit, OnDestroy {
+export declare class AppNavComponent implements OnInit, OnDestroy, AfterViewInit {
     private workspaceManager;
     private sharedService;
     private cdr;
+    private host;
     private destroy$;
     private _app;
     private _cachedNavItems;
-    private _cachedAppColor;
     private _servicesInjected;
     /**
      * Monotonically increasing counter used to detect and discard stale async results.
@@ -38,20 +44,93 @@ export declare class AppNavComponent implements OnInit, OnDestroy {
      */
     private _updateGeneration;
     private activeStateMap;
+    /** Cached natural pixel width of each nav item, parallel to navItems order */
+    private itemWidths;
+    /** Measured width of the More button (fallback used until first render) */
+    private moreBtnWidth;
+    /** Left offset (px, relative to host) where the More dropdown anchors */
+    MoreDropdownLeft: number;
+    /** True when even one item + More can't fit — the lone visible pill
+     *  shrinks with an ellipsis instead of clipping the More button. */
+    Tight: boolean;
+    /** Flex gap between nav items — measured from the rendered row (falls back
+     *  to --mj-space-1's default of 4px until first measurement) */
+    private itemGap;
+    /** How many leading nav items are currently visible inline */
+    VisibleCount: number;
+    /** Whether the More dropdown is open */
+    MoreOpen: boolean;
+    /** True while nav items are being (re)loaded for skeleton display */
+    Loading: boolean;
+    private resizeObserver;
+    private _overflowEnabled;
+    private navListRef?;
+    private moreBtnRef?;
     navItemClick: EventEmitter<NavItemClickEvent>;
     navItemDismiss: EventEmitter<NavItem>;
-    constructor(workspaceManager: WorkspaceStateManager, sharedService: SharedService, cdr: ChangeDetectorRef);
+    /**
+     * Disable the priority+ overflow behavior. Used by the mobile drawer instance,
+     * where items stack vertically and can never overflow horizontally.
+     */
+    set OverflowEnabled(value: boolean);
+    get OverflowEnabled(): boolean;
+    constructor(workspaceManager: WorkspaceStateManager, sharedService: SharedService, cdr: ChangeDetectorRef, host: ElementRef<HTMLElement>);
     /**
      * Input setter for app - triggers cache update when app changes
      */
     set app(value: BaseApplication | null);
     get app(): BaseApplication | null;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
     /**
      * Update cached nav items and app color when app changes
      */
     private updateCachedData;
+    /**
+     * Cache the natural width of every nav item. Called in the frame after a new
+     * item set renders (all items visible, flex-shrink: 0, so widths are natural
+     * even if the row is clipped by overflow: hidden).
+     */
+    private measureItemWidths;
+    /**
+     * Decide how many items fit in the host's current width; the rest collapse
+     * into the More dropdown. Pure arithmetic over cached widths — safe to call
+     * on every resize.
+     */
+    private recomputeFit;
+    /**
+     * Self-heal for the item-width cache: if it's stale or missing (the
+     * measurement frame can race the first render after a reload/app switch),
+     * expand to the full item set, re-measure, and retry next frame until it
+     * converges. Returns true when the cache matches the current item set.
+     */
+    private ensureFreshWidthCache;
+    /** Pure fit arithmetic: how many leading items fit beside the More button */
+    private computeFitCount;
+    /** Commit a fit result, closing More if nothing overflows; CD only on change */
+    private applyFit;
+    /**
+     * markForCheck + synchronous detectChanges. In Angular 21 zoneless mode,
+     * markForCheck() alone is unreliable when the trigger is an RxJS
+     * subscription or rAF callback not tracked by the zoneless scheduler — the
+     * dirty flag is set but no follow-up tick is scheduled. detectChanges()
+     * throws if invoked re-entrantly during an in-flight CD pass; that's
+     * harmless (the in-flight pass picks up our markForCheck), hence the catch.
+     */
+    private syncChangeDetection;
+    /** Items rendered inline in the header row */
+    get InlineItems(): NavItem[];
+    /** Items collapsed into the More dropdown */
+    get OverflowItems(): NavItem[];
+    /** True when any overflowed item is the active one (More button shows active tint) */
+    get OverflowHasActive(): boolean;
+    /** Open/close the More dropdown, anchoring it under the More button and clamping it inside the host */
+    ToggleMore(event: MouseEvent): void;
+    /** Close the More dropdown on any outside click or Escape */
+    onDocumentClick(event: MouseEvent): void;
+    /** Close the More dropdown on Escape */
+    onEscape(): void;
     /**
      * Update active state map based on current workspace configuration
      */
@@ -73,10 +152,6 @@ export declare class AppNavComponent implements OnInit, OnDestroy {
      * Get cached navigation items (no computation in getter)
      */
     get navItems(): NavItem[];
-    /**
-     * Get cached app color (no computation in getter)
-     */
-    get appColor(): string;
     /**
      * Check if nav item is active (uses cached state from Map)
      */
@@ -96,6 +171,6 @@ export declare class AppNavComponent implements OnInit, OnDestroy {
      */
     onDismiss(item: NavItem, event: MouseEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AppNavComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AppNavComponent, "mj-app-nav", never, { "app": { "alias": "app"; "required": false; }; }, { "navItemClick": "navItemClick"; "navItemDismiss": "navItemDismiss"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AppNavComponent, "mj-app-nav", never, { "OverflowEnabled": { "alias": "OverflowEnabled"; "required": false; }; "app": { "alias": "app"; "required": false; }; }, { "navItemClick": "navItemClick"; "navItemDismiss": "navItemDismiss"; }, never, never, false, never>;
 }
 //# sourceMappingURL=app-nav.component.d.ts.map

package/dist/lib/shell/components/header/app-nav.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-nav.component.d.ts","sourceRoot":"","sources":["../../../../../src/lib/shell/components/header/app-nav.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAA2B,MAAM,eAAe,CAAC;AACtI,OAAO,EAAE,eAAe,EAAkB,OAAO,EAAE,qBAAqB,EAA0B,MAAM,qCAAqC,CAAC;AAC9I,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;;AAG1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAOa,eAAgB,YAAW,MAAM,EAAE,SAAS;IA8BrD,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,GAAG;IA/Bb,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,iBAAiB,CAAS;IAElC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,cAAc,CAA8B;IAE1C,YAAY,kCAAyC;IACrD,cAAc,wBAA+B;gBAG7C,gBAAgB,EAAE,qBAAqB,EACvC,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,iBAAiB;IAGhC;;OAEG;IACH,IACI,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,EASpC;IAED,IAAI,GAAG,IAAI,eAAe,GAAG,IAAI,CAEhC;IAED,QAAQ,IAAI,IAAI;IAahB,WAAW,IAAI,IAAI;IAKnB;;OAEG;YACW,gBAAgB;IAyD9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAIjC;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,EAAE,CAExB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAKhC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM;IAIrD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI;IAOnD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;yCAxPtC,eAAe;2CAAf,eAAe;CAyQ3B"}
+{"version":3,"file":"app-nav.component.d.ts","sourceRoot":"","sources":["../../../../../src/lib/shell/components/header/app-nav.component.ts"],"names":[],"mappings":"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"}