@genesislcap/foundation-header 14.419.2 → 14.421.0

package/dist/custom-elements.json

@@ -763,6 +763,15 @@
               },
               "description": "Callback function to check if a layout item is currently active in the layout.\nUsed with nav items that have `isLayoutItem: true` and `layoutRegistration` set."
             },
+            {
+              "kind": "field",
+              "name": "onBeforeNavButtonClick",
+              "type": {
+                "text": "(detail: NavButtonClickDetail) => void | Promise<void> | undefined"
+              },
+              "description": "Callback invoked before navigation occurs when a nav button is clicked.\nAwaited before the route changes, so async cleanup is supported.",
+              "privacy": "public"
+            },
             {
               "kind": "method",
               "name": "isLayoutItemActive",
@@ -883,7 +892,7 @@
               "name": "handleNavButtonClick",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
@@ -1523,6 +1532,19 @@
                 "module": "src/main/main.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "onBeforeNavButtonClick",
+              "type": {
+                "text": "(detail: NavButtonClickDetail) => void | Promise<void> | undefined"
+              },
+              "description": "Callback invoked before navigation occurs when a nav button is clicked.\nAwaited before the route changes, so async cleanup is supported.",
+              "privacy": "public",
+              "inheritedFrom": {
+                "name": "Navigation",
+                "module": "src/main/main.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "isLayoutItemActive",
@@ -1675,7 +1697,7 @@
               "name": "handleNavButtonClick",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
@@ -2637,6 +2659,19 @@
                 "module": "src/main/main.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "onBeforeNavButtonClick",
+              "type": {
+                "text": "(detail: NavButtonClickDetail) => void | Promise<void> | undefined"
+              },
+              "description": "Callback invoked before navigation occurs when a nav button is clicked.\nAwaited before the route changes, so async cleanup is supported.",
+              "privacy": "public",
+              "inheritedFrom": {
+                "name": "Navigation",
+                "module": "src/main/main.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "isLayoutItemActive",
@@ -2789,7 +2824,7 @@
               "name": "handleNavButtonClick",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
@@ -3298,6 +3333,19 @@
                 "module": "src/main/main.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "onBeforeNavButtonClick",
+              "type": {
+                "text": "(detail: NavButtonClickDetail) => void | Promise<void> | undefined"
+              },
+              "description": "Callback invoked before navigation occurs when a nav button is clicked.\nAwaited before the route changes, so async cleanup is supported.",
+              "privacy": "public",
+              "inheritedFrom": {
+                "name": "Navigation",
+                "module": "src/main/main.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "isLayoutItemActive",
@@ -3436,7 +3484,7 @@
               "name": "handleNavButtonClick",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [

package/dist/dts/main/main.d.ts

@@ -7,6 +7,20 @@ import type { ViewTemplate } from '@genesislcap/web-core';
 import { Container } from '@genesislcap/web-core';
 import { ControlPanel } from '../components/control-panel';
 import { HeaderConfig } from '../config/config';
+/**
+ * Detail payload for nav button click events and callbacks
+ * @public
+ */
+export type NavButtonClickDetail = {
+    /** The navigation item that was clicked */
+    item: FoundationRouteNavItem;
+    /** The pathname before navigation */
+    oldPath: string;
+    /** The destination path (`routeNavItem.routePath`). Undefined for items with a custom `onClick` that don't navigate. */
+    newPath: string | undefined;
+    /** The header component instance */
+    context: any;
+};
 /**
  * Events dispatched by the navigation control buttons
  * @public
@@ -17,10 +31,7 @@ export type NavEventDetailMap = {
     'misc-icon-clicked': void;
     'notification-icon-clicked': void;
     'language-changed': void;
-    'nav-button-clicked': {
-        item: FoundationRouteNavItem;
-        context: any;
-    };
+    'nav-button-clicked': NavButtonClickDetail;
 };
 /**
  * Options for the language selector
@@ -640,6 +651,28 @@ export declare class Navigation extends Navigation_base {
      * @beta
      */
     layoutItemCheck?: (registration: string) => boolean;
+    /**
+     * Callback invoked before navigation occurs when a nav button is clicked.
+     * Awaited before the route changes, so async cleanup is supported.
+     *
+     * @remarks
+     * DOM events cannot be awaited, so this callback is the only way to guarantee
+     * execution before the route changes. The `nav-button-clicked` event fires after
+     * navigation and is suitable for informational use only.
+     *
+     * @example
+     * ```ts
+     * <foundation-header
+     *   :onBeforeNavButtonClick=${(x) => async (detail) => {
+     *     await x.cleanup();
+     *     console.log(`Navigating from ${detail.oldPath} to ${detail.newPath}`);
+     *   }}
+     * />
+     * ```
+     *
+     * @public
+     */
+    onBeforeNavButtonClick?: (detail: NavButtonClickDetail) => void | Promise<void>;
     /**
      * Check if a layout item is currently active in the layout
      * @param item - The navigation item to check
@@ -784,7 +817,7 @@ export declare class Navigation extends Navigation_base {
      * Handles the click event for a navigation button
      * @param routeNavItem - The navigation item that was clicked
      */
-    handleNavButtonClick(routeNavItem: FoundationRouteNavItem): void;
+    handleNavButtonClick(routeNavItem: FoundationRouteNavItem): Promise<void>;
     /**
      * Current pathname for route highlighting
      * @public

package/dist/dts/main/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/main/main.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/main/main.ts"],"names":[],"mappings":"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"}

package/dist/esm/main/main.js

@@ -454,13 +454,23 @@ let Navigation = class Navigation extends EventEmitter(GenesisElement) {
      * @param routeNavItem - The navigation item that was clicked
      */
     handleNavButtonClick(routeNavItem) {
-        if (routeNavItem.onClick) {
-            routeNavItem.onClick({ item: routeNavItem, context: this });
-        }
-        else if (routeNavItem.routePath) {
-            this.navigateTo(routeNavItem.routePath);
-        }
-        this.$emit('nav-button-clicked', { item: routeNavItem, context: this });
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const detail = {
+                item: routeNavItem,
+                oldPath: this.pathName,
+                newPath: routeNavItem.routePath,
+                context: this,
+            };
+            yield ((_a = this.onBeforeNavButtonClick) === null || _a === void 0 ? void 0 : _a.call(this, detail));
+            if (routeNavItem.onClick) {
+                routeNavItem.onClick({ item: routeNavItem, context: this });
+            }
+            else if (routeNavItem.routePath) {
+                this.navigateTo(routeNavItem.routePath);
+            }
+            this.$emit('nav-button-clicked', detail);
+        });
     }
     /**
      * Current pathname for route highlighting
@@ -578,6 +588,9 @@ __decorate([
 __decorate([
     observable
 ], Navigation.prototype, "layoutItemCheck", void 0);
+__decorate([
+    observable
+], Navigation.prototype, "onBeforeNavButtonClick", void 0);
 __decorate([
     attr({ mode: 'boolean', attribute: 'show-account-menu' })
 ], Navigation.prototype, "showAccountMenu", void 0);

package/dist/foundation-header.api.json

@@ -534,6 +534,41 @@
             "endIndex": 3
           }
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-header!NavButtonClickDetail:type",
+          "docComment": "/**\n * Detail payload for nav button click events and callbacks\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type NavButtonClickDetail = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    item: "
+            },
+            {
+              "kind": "Reference",
+              "text": "FoundationRouteNavItem",
+              "canonicalReference": "@genesislcap/foundation-ui!FoundationRouteNavItem:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";\n    oldPath: string;\n    newPath: string | undefined;\n    context: any;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/main/main.ts",
+          "releaseTag": "Public",
+          "name": "NavButtonClickDetail",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-header!NavEventDetailMap:type",
@@ -545,16 +580,16 @@
             },
             {
               "kind": "Content",
-              "text": "{\n    'luminance-icon-clicked': void;\n    'logout-clicked': void;\n    'misc-icon-clicked': void;\n    'notification-icon-clicked': void;\n    'language-changed': void;\n    'nav-button-clicked': {\n        item: "
+              "text": "{\n    'luminance-icon-clicked': void;\n    'logout-clicked': void;\n    'misc-icon-clicked': void;\n    'notification-icon-clicked': void;\n    'language-changed': void;\n    'nav-button-clicked': "
             },
             {
               "kind": "Reference",
-              "text": "FoundationRouteNavItem",
-              "canonicalReference": "@genesislcap/foundation-ui!FoundationRouteNavItem:type"
+              "text": "NavButtonClickDetail",
+              "canonicalReference": "@genesislcap/foundation-header!NavButtonClickDetail:type"
             },
             {
               "kind": "Content",
-              "text": ";\n        context: any;\n    };\n}"
+              "text": ";\n}"
             },
             {
               "kind": "Content",
@@ -851,9 +886,14 @@
                   "kind": "Content",
                   "text": "): "
                 },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
                 {
                   "kind": "Content",
-                  "text": "void"
+                  "text": "<void>"
                 },
                 {
                   "kind": "Content",
@@ -863,7 +903,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 3,
-                "endIndex": 4
+                "endIndex": 5
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -1428,6 +1468,54 @@
               "isAbstract": false,
               "name": "navigateTo"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-header!Navigation#onBeforeNavButtonClick:member",
+              "docComment": "/**\n * Callback invoked before navigation occurs when a nav button is clicked. Awaited before the route changes, so async cleanup is supported.\n *\n * @remarks\n *\n * DOM events cannot be awaited, so this callback is the only way to guarantee execution before the route changes. The `nav-button-clicked` event fires after navigation and is suitable for informational use only.\n *\n * @example\n * ```ts\n * <foundation-header\n *   :onBeforeNavButtonClick=${(x) => async (detail) => {\n *     await x.cleanup();\n *     console.log(`Navigating from ${detail.oldPath} to ${detail.newPath}`);\n *   }}\n * />\n * ```\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "onBeforeNavButtonClick?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(detail: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "NavButtonClickDetail",
+                  "canonicalReference": "@genesislcap/foundation-header!NavButtonClickDetail:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ") => void | "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "onBeforeNavButtonClick",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 6
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-header!Navigation#pathName:member",

package/dist/foundation-header.d.ts

@@ -287,6 +287,21 @@ export declare const MainStyles: ElementStyles;
  */
 export declare const mainTemplate: ViewTemplate<Navigation, any>;
 
+/**
+ * Detail payload for nav button click events and callbacks
+ * @public
+ */
+export declare type NavButtonClickDetail = {
+    /** The navigation item that was clicked */
+    item: FoundationRouteNavItem;
+    /** The pathname before navigation */
+    oldPath: string;
+    /** The destination path (`routeNavItem.routePath`). Undefined for items with a custom `onClick` that don't navigate. */
+    newPath: string | undefined;
+    /** The header component instance */
+    context: any;
+};
+
 /**
  * Events dispatched by the navigation control buttons
  * @public
@@ -297,10 +312,7 @@ export declare type NavEventDetailMap = {
     'misc-icon-clicked': void;
     'notification-icon-clicked': void;
     'language-changed': void;
-    'nav-button-clicked': {
-        item: FoundationRouteNavItem;
-        context: any;
-    };
+    'nav-button-clicked': NavButtonClickDetail;
 };
 
 /**
@@ -557,6 +569,28 @@ export declare class Navigation extends Navigation_base {
      * @beta
      */
     layoutItemCheck?: (registration: string) => boolean;
+    /**
+     * Callback invoked before navigation occurs when a nav button is clicked.
+     * Awaited before the route changes, so async cleanup is supported.
+     *
+     * @remarks
+     * DOM events cannot be awaited, so this callback is the only way to guarantee
+     * execution before the route changes. The `nav-button-clicked` event fires after
+     * navigation and is suitable for informational use only.
+     *
+     * @example
+     * ```ts
+     * <foundation-header
+     *   :onBeforeNavButtonClick=${(x) => async (detail) => {
+     *     await x.cleanup();
+     *     console.log(`Navigating from ${detail.oldPath} to ${detail.newPath}`);
+     *   }}
+     * />
+     * ```
+     *
+     * @public
+     */
+    onBeforeNavButtonClick?: (detail: NavButtonClickDetail) => void | Promise<void>;
     /**
      * Check if a layout item is currently active in the layout
      * @param item - The navigation item to check
@@ -701,7 +735,7 @@ export declare class Navigation extends Navigation_base {
      * Handles the click event for a navigation button
      * @param routeNavItem - The navigation item that was clicked
      */
-    handleNavButtonClick(routeNavItem: FoundationRouteNavItem): void;
+    handleNavButtonClick(routeNavItem: FoundationRouteNavItem): Promise<void>;
     /**
      * Current pathname for route highlighting
      * @public

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-header",
   "description": "Genesis Foundation Header",
-  "version": "14.419.2",
+  "version": "14.421.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/foundation-header.d.ts",
@@ -84,29 +84,29 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.419.2",
-    "@genesislcap/genx": "14.419.2",
-    "@genesislcap/rollup-builder": "14.419.2",
-    "@genesislcap/ts-builder": "14.419.2",
-    "@genesislcap/uvu-playwright-builder": "14.419.2",
-    "@genesislcap/vite-builder": "14.419.2",
-    "@genesislcap/webpack-builder": "14.419.2"
+    "@genesislcap/foundation-testing": "14.421.0",
+    "@genesislcap/genx": "14.421.0",
+    "@genesislcap/rollup-builder": "14.421.0",
+    "@genesislcap/ts-builder": "14.421.0",
+    "@genesislcap/uvu-playwright-builder": "14.421.0",
+    "@genesislcap/vite-builder": "14.421.0",
+    "@genesislcap/webpack-builder": "14.421.0"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.419.2",
-    "@genesislcap/foundation-auth": "14.419.2",
-    "@genesislcap/foundation-comms": "14.419.2",
-    "@genesislcap/foundation-events": "14.419.2",
-    "@genesislcap/foundation-i18n": "14.419.2",
-    "@genesislcap/foundation-logger": "14.419.2",
-    "@genesislcap/foundation-login": "14.419.2",
-    "@genesislcap/foundation-shell": "14.419.2",
-    "@genesislcap/foundation-ui": "14.419.2",
-    "@genesislcap/foundation-user": "14.419.2",
-    "@genesislcap/foundation-utils": "14.419.2",
-    "@genesislcap/foundation-zero": "14.419.2",
-    "@genesislcap/rapid-design-system": "14.419.2",
-    "@genesislcap/web-core": "14.419.2"
+    "@genesislcap/foundation-ai": "14.421.0",
+    "@genesislcap/foundation-auth": "14.421.0",
+    "@genesislcap/foundation-comms": "14.421.0",
+    "@genesislcap/foundation-events": "14.421.0",
+    "@genesislcap/foundation-i18n": "14.421.0",
+    "@genesislcap/foundation-logger": "14.421.0",
+    "@genesislcap/foundation-login": "14.421.0",
+    "@genesislcap/foundation-shell": "14.421.0",
+    "@genesislcap/foundation-ui": "14.421.0",
+    "@genesislcap/foundation-user": "14.421.0",
+    "@genesislcap/foundation-utils": "14.421.0",
+    "@genesislcap/foundation-zero": "14.421.0",
+    "@genesislcap/rapid-design-system": "14.421.0",
+    "@genesislcap/web-core": "14.421.0"
   },
   "repository": {
     "type": "git",
@@ -120,5 +120,5 @@
   "peerDependencies": {
     "@microsoft/fast-react-wrapper": ">=0.3.0"
   },
-  "gitHead": "a9bf0fc6bd28727bf0f95f63b227aee7c418470f"
+  "gitHead": "d109b70edbd07af351ed8bf393ace74b42bb5356"
 }