@genesislcap/foundation-header 14.139.2 → 14.141.0

package/dist/foundation-header.api.json

@@ -184,6 +184,103 @@
       "name": "",
       "preserveMemberOrder": false,
       "members": [
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-header!configure:function(1)",
+          "docComment": "/**\n * A function that allows configuring the header micro-frontend with name and templateOptions.\n *\n * @remarks\n *\n * Configure the Header micro frontend for host app integration.\n *\n * @param config - A partial HeaderConfig.\n *\n * @example\n *\n * Providing template options to align to your host application.\n * ```ts\n *\n *   const { configure } = await import('@genesislcap/foundation-header/config'); // < import from the subpath\n *   return configure({\n *     name: `nexus-app-header`,\n *     // These will be merged with the packages `defaultTemplateOptions`. You will need to have these components registered in your application.\n *     templateOptions: {\n *       button: 'nexus-button',\n *       icon: 'nexus-icon-next',\n *     },\n *   });\n * },\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function configure(config: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Partial",
+              "canonicalReference": "!Partial:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "HeaderConfig",
+              "canonicalReference": "@genesislcap/foundation-header!HeaderConfig:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<typeof import(\"../main\")."
+            },
+            {
+              "kind": "Reference",
+              "text": "Navigation",
+              "canonicalReference": "@genesislcap/foundation-header!Navigation:class"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/config/configure.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 6,
+            "endIndex": 10
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "config",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "configure"
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-header!defaultHeaderConfig:var",
+          "docComment": "/**\n * Default HeaderConfig DI implementation.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "defaultHeaderConfig: "
+            },
+            {
+              "kind": "Reference",
+              "text": "HeaderConfig",
+              "canonicalReference": "@genesislcap/foundation-header!HeaderConfig:interface"
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "defaultHeaderConfig",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-header!ElementTargetId:type",
@@ -229,6 +326,66 @@
             "endIndex": 6
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-header!HeaderConfig:interface",
+          "docComment": "/**\n * HeaderConfig DI interface.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface HeaderConfig extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PartialFASTElementDefinition",
+              "canonicalReference": "@microsoft/fast-element!PartialFASTElementDefinition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Public",
+          "name": "HeaderConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-header!HeaderConfig#templateOptions:member",
+              "docComment": "/**\n * Template options.\n *\n * @remarks\n *\n * Used by host applications to assign MF template options and subcomponent tags to align with the host design system.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "templateOptions: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TemplateOptions",
+                  "canonicalReference": "@genesislcap/foundation-header!~TemplateOptions:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "templateOptions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-header!HeaderTargetId:type",
@@ -507,6 +664,37 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-header!Navigation#headerConfig:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "headerConfig: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HeaderConfig",
+                  "canonicalReference": "@genesislcap/foundation-header!HeaderConfig:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "headerConfig",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-header!Navigation#hideSideBar:member",
@@ -1241,6 +1429,37 @@
             "startIndex": 1,
             "endIndex": 2
           }
+        },
+        {
+          "kind": "Class",
+          "canonicalReference": "@genesislcap/foundation-header!ZeroHeader:class",
+          "docComment": "/**\n * ZeroHeader is a zero version of the header micro-frontend.\n *\n * @remarks\n *\n * A zero version that pre-registers zero components and uses the zero design system. ZeroHeader and its components won't bloat the core bundle as these are only loaded on-demand when in use.\n *\n * @example\n * ```ts\n * import { ZeroHeader } from '@genesislcap/foundation-header';\n * ...\n * ZeroHeader\n * ```\n *\n * @example\n *\n * Load the micro frontend on-demand\n * ```ts\n *\n *   const { ZeroHeader } = await import('@genesislcap/foundation-header');\n *   return ZeroHeader;\n * },\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class ZeroHeader extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "Navigation",
+              "canonicalReference": "@genesislcap/foundation-header!Navigation:class"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/main/main.ts",
+          "releaseTag": "Public",
+          "isAbstract": false,
+          "name": "ZeroHeader",
+          "preserveMemberOrder": false,
+          "members": [],
+          "extendsTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "implementsTokenRanges": []
         }
       ]
     }

package/dist/foundation-header.d.ts

@@ -6,8 +6,59 @@ import { EmitOptions } from '@genesislcap/foundation-events';
 import { EmitReturn } from '@genesislcap/foundation-events';
 import type { FoundationRouteNavItem } from '@genesislcap/foundation-ui';
 import { I18next } from '@genesislcap/foundation-i18n';
+import { InterfaceSymbol } from '@microsoft/fast-foundation';
+import { PartialFASTElementDefinition } from '@microsoft/fast-element';
+import { SyntheticViewTemplate } from '@microsoft/fast-element';
+import { TemplateElementDependency } from '@genesislcap/foundation-ui';
 import { ViewTemplate } from '@microsoft/fast-element';
 
+/**
+ * A function that allows configuring the header micro-frontend with name and templateOptions.
+ *
+ * @remarks
+ * Configure the Header micro frontend for host app integration.
+ *
+ * @example Providing template options to align to your host application.
+ * ```ts
+
+ *   const { configure } = await import('@genesislcap/foundation-header/config'); // < import from the subpath
+ *   return configure({
+ *     name: `nexus-app-header`,
+ *     // These will be merged with the packages `defaultTemplateOptions`. You will need to have these components registered in your application.
+ *     templateOptions: {
+ *       button: 'nexus-button',
+ *       icon: 'nexus-icon-next',
+ *     },
+ *   });
+ * },
+ * ```
+ *
+ * @param config - A partial HeaderConfig.
+ * @public
+ */
+export declare function configure(config: Partial<HeaderConfig>): Promise<Navigation>;
+
+/**
+ * Default HeaderConfig DI implementation.
+ * @public
+ */
+export declare const defaultHeaderConfig: HeaderConfig;
+
+/**
+ * Top level template for Navigation class
+ *
+ * @remarks
+ *
+ * Dynamic template which wraps the code in a provider
+ *
+ * @typeParam Navigation - Navigation class
+ *
+ * @returns ViewTemplate instance of the Navigation html
+ *
+ * @internal
+ */
+export declare const DynamicTemplate: ViewTemplate<Navigation>;
+
 /**
  * Package element integration targets.
  *
@@ -15,6 +66,33 @@ import { ViewTemplate } from '@microsoft/fast-element';
  */
 export declare type ElementTargetId = HeaderTargetId | NavTargetId | SideNavTargetId;
 
+/**
+ * Do not reference any ../main files here. We must avoid ../tags being referenced and therefore setup pre-configuration.
+ */
+/**
+ * HeaderConfig DI interface.
+ *
+ * @public
+ */
+export declare interface HeaderConfig extends PartialFASTElementDefinition {
+    /**
+     * Template options.
+     *
+     * @remarks
+     * Used by host applications to assign MF template options and subcomponent tags to align with the host design system.
+     */
+    templateOptions: TemplateOptions;
+}
+
+/**
+ * HeaderConfig DI key.
+ *
+ * @internal
+ * @privateRemarks
+ * Marked as internal to stop api-extractor becoming confused cross-linking tokens with the same name.
+ */
+export declare const HeaderConfig: InterfaceSymbol<HeaderConfig>;
+
 /**
  * Header integration targets.
  *
@@ -31,6 +109,21 @@ export declare type LanguageOptions = {
     selectedLanguage: string;
 };
 
+/**
+ * Loading template for the Navigation class
+ *
+ * @remarks
+ *
+ * Template used to indicate loading to the user
+ *
+ * @typeParam Navigation - Navigation class
+ *
+ * @returns ViewTemplate instance of the Loading html
+ *
+ * @internal
+ */
+export declare const LoadingTemplate: ViewTemplate<Navigation>;
+
 /**
  * Base styles for the foundation-header
  *
@@ -40,6 +133,21 @@ export declare type LanguageOptions = {
  */
 export declare const MainStyles: ElementStyles;
 
+/**
+ * Render template for the Navigation class
+ *
+ * @remarks
+ *
+ * Template used when the class has finished loading
+ *
+ * @typeParam Navigation - Navigation class
+ *
+ * @returns ViewTemplate instance of the Main html
+ *
+ * @internal
+ */
+export declare const MainTemplate: ViewTemplate<Navigation>;
+
 /**
  * Events dispatched by the navigation control buttons
  * @public
@@ -88,6 +196,7 @@ export declare class Navigation extends Navigation_base {
     auth: Auth;
     credentialManager: CredentialManager;
     i18next: I18next;
+    headerConfig: HeaderConfig;
     ready: boolean;
     /**
      * Username of the logged in user
@@ -180,16 +289,6 @@ export declare class Navigation extends Navigation_base {
      * If present the defined {@link @genesislcap/foundation-ui#FoundationRouteNavItem | FoundationRouteNavItems} will be rendered in the header 'routes' slot
      */
     routeNavItems: FoundationRouteNavItem[];
-    /**
-     * Load remote components
-     *
-     * @remarks
-     *
-     * With regards to module federation
-     *
-     * @internal
-     */
-    loadRemotes(): Promise<void>;
     selectTemplate(): ViewTemplate<Navigation, any>;
     /**
      * Logs the user out of their session
@@ -310,9 +409,7 @@ declare const Navigation_base: abstract new (...args: any[]) => {
     readonly classList: DOMTokenList;
     className: string;
     readonly clientHeight: number;
-    readonly clientLeft: number; /**
-    * Username of the logged in user
-    */
+    readonly clientLeft: number;
     readonly clientTop: number;
     readonly clientWidth: number;
     id: string;
@@ -370,6 +467,11 @@ declare const Navigation_base: abstract new (...args: any[]) => {
     scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void;
     scrollTo(options?: ScrollToOptions): void;
     scrollTo(x: number, y: number): void;
+    /**
+     * If present the defined route buttons will be rendered in the header 'routes' slot
+     *
+     * @deprecated - Use `routeNavItems` instead.
+     */
     setAttribute(qualifiedName: string, value: string): void;
     setAttributeNS(namespace: string, qualifiedName: string, value: string): void;
     setAttributeNode(attr: Attr): Attr;
@@ -430,7 +532,16 @@ declare const Navigation_base: abstract new (...args: any[]) => {
     ariaChecked: string;
     ariaColCount: string;
     ariaColIndex: string;
-    ariaColIndexText: string;
+    ariaColIndexText: string; /**
+    * Emits the event corresponding to the luminance icon being clicked
+    *
+    * @remarks
+    *
+    * Activated when the user clicks on the moon icon on the navigation
+    * bar right hand side
+    *
+    * @internal
+    */
     ariaColSpan: string;
     ariaCurrent: string;
     ariaDisabled: string;
@@ -463,16 +574,7 @@ declare const Navigation_base: abstract new (...args: any[]) => {
     ariaValueMin: string;
     ariaValueNow: string;
     ariaValueText: string;
-    role: string; /**
-    * Emits the event corresponding to the notification icon being clicked
-    *
-    * @remarks
-    *
-    * Activated when the user clicks on the bell icon on the navigation
-    * bar right hand side
-    *
-    * @internal
-    */
+    role: string;
     animate(keyframes: PropertyIndexedKeyframes | Keyframe[], options?: number | KeyframeAnimationOptions): Animation;
     getAnimations(options?: GetAnimationsOptions): Animation[];
     after(...nodes: (string | Node)[]): void;
@@ -643,4 +745,65 @@ export declare type SideNavTargetId = 'side-nav-start' | 'side-nav' | 'side-nav-
  */
 export declare type StyleTargetId = 'header';
 
+/**
+ * TemplateComponents.
+ * @public
+ */
+declare type TemplateComponents = {
+    icon: TemplateElementDependency;
+    button: TemplateElementDependency;
+    connectionIndicator: TemplateElementDependency;
+    select: TemplateElementDependency;
+    option: TemplateElementDependency;
+    flyout: TemplateElementDependency;
+};
+
+/**
+ * TemplateOptions.
+ * @public
+ */
+declare type TemplateOptions = Partial<TemplateComponents> & {
+    /**
+     * @remarks
+     * Just for reference that template options may be more than tags.
+     * @internal
+     */
+    somePartial?: string | SyntheticViewTemplate;
+};
+
+/**
+ * ZeroHeader is a zero version of the header micro-frontend.
+ *
+ * @remarks
+ * A zero version that pre-registers zero components and uses the zero design system. ZeroHeader and its components won't bloat the core bundle as
+ * these are only loaded on-demand when in use.
+ *
+ * @example
+ * ```ts
+ * import { ZeroHeader } from '@genesislcap/foundation-header';
+ * ...
+ * ZeroHeader
+ * ```
+ *
+ * @example Load the micro frontend on-demand
+ * ```ts
+
+ *   const { ZeroHeader } = await import('@genesislcap/foundation-header');
+ *   return ZeroHeader;
+ * },
+ * ```
+ *
+ * @public
+ */
+export declare class ZeroHeader extends Navigation {
+    /**
+     * @internal
+     */
+    connectedCallback(): Promise<void>;
+    /**
+     * @internal
+     */
+    loadRemotes(): Promise<void>;
+}
+
 export { }

package/docs/api/foundation-header.configure.md

@@ -0,0 +1,46 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-header](./foundation-header.md) &gt; [configure](./foundation-header.configure.md)
+
+## configure() function
+
+A function that allows configuring the header micro-frontend with name and templateOptions.
+
+**Signature:**
+
+```typescript
+export declare function configure(config: Partial<HeaderConfig>): Promise<typeof import("../main").Navigation>;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  config | Partial&lt;[HeaderConfig](./foundation-header.headerconfig.md)<!-- -->&gt; | A partial HeaderConfig. |
+
+**Returns:**
+
+Promise&lt;typeof import("../main").[Navigation](./foundation-header.navigation.md)<!-- -->&gt;
+
+## Remarks
+
+Configure the Header micro frontend for host app integration.
+
+## Example
+
+Providing template options to align to your host application.
+
+```ts
+
+  const { configure } = await import('@genesislcap/foundation-header/config'); // < import from the subpath
+  return configure({
+    name: `nexus-app-header`,
+    // These will be merged with the packages `defaultTemplateOptions`. You will need to have these components registered in your application.
+    templateOptions: {
+      button: 'nexus-button',
+      icon: 'nexus-icon-next',
+    },
+  });
+},
+```
+

package/docs/api/foundation-header.defaultheaderconfig.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-header](./foundation-header.md) &gt; [defaultHeaderConfig](./foundation-header.defaultheaderconfig.md)
+
+## defaultHeaderConfig variable
+
+Default HeaderConfig DI implementation.
+
+**Signature:**
+
+```typescript
+defaultHeaderConfig: HeaderConfig
+```

package/docs/api/foundation-header.headerconfig.md

@@ -0,0 +1,21 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-header](./foundation-header.md) &gt; [HeaderConfig](./foundation-header.headerconfig.md)
+
+## HeaderConfig interface
+
+HeaderConfig DI interface.
+
+**Signature:**
+
+```typescript
+export interface HeaderConfig extends PartialFASTElementDefinition 
+```
+**Extends:** PartialFASTElementDefinition
+
+## Properties
+
+|  Property | Modifiers | Type | Description |
+|  --- | --- | --- | --- |
+|  [templateOptions](./foundation-header.headerconfig.templateoptions.md) |  | TemplateOptions | Template options. |
+

package/docs/api/foundation-header.headerconfig.templateoptions.md

@@ -0,0 +1,18 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-header](./foundation-header.md) &gt; [HeaderConfig](./foundation-header.headerconfig.md) &gt; [templateOptions](./foundation-header.headerconfig.templateoptions.md)
+
+## HeaderConfig.templateOptions property
+
+Template options.
+
+**Signature:**
+
+```typescript
+templateOptions: TemplateOptions;
+```
+
+## Remarks
+
+Used by host applications to assign MF template options and subcomponent tags to align with the host design system.
+

package/docs/api/foundation-header.md

@@ -9,11 +9,25 @@
 |  Class | Description |
 |  --- | --- |
 |  [Navigation](./foundation-header.navigation.md) | Navigation micro-frontend includes navigation bar and flyout menu |
+|  [ZeroHeader](./foundation-header.zeroheader.md) | ZeroHeader is a zero version of the header micro-frontend. |
+
+## Functions
+
+|  Function | Description |
+|  --- | --- |
+|  [configure(config)](./foundation-header.configure.md) | A function that allows configuring the header micro-frontend with name and templateOptions. |
+
+## Interfaces
+
+|  Interface | Description |
+|  --- | --- |
+|  [HeaderConfig](./foundation-header.headerconfig.md) | HeaderConfig DI interface. |
 
 ## Variables
 
 |  Variable | Description |
 |  --- | --- |
+|  [defaultHeaderConfig](./foundation-header.defaultheaderconfig.md) | Default HeaderConfig DI implementation. |
 |  [MainStyles](./foundation-header.mainstyles.md) | Base styles for the foundation-header |
 |  [NavTemplate](./foundation-header.navtemplate.md) | Template for Navigation class |
 

package/docs/api/foundation-header.navigation.headerconfig.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-header](./foundation-header.md) &gt; [Navigation](./foundation-header.navigation.md) &gt; [headerConfig](./foundation-header.navigation.headerconfig.md)
+
+## Navigation.headerConfig property
+
+**Signature:**
+
+```typescript
+headerConfig: HeaderConfig;
+```

package/docs/api/foundation-header.navigation.md

@@ -23,6 +23,7 @@ export declare class Navigation extends Navigation_base
 |  --- | --- | --- | --- |
 |  [auth](./foundation-header.navigation.auth.md) |  | Auth |  |
 |  [credentialManager](./foundation-header.navigation.credentialmanager.md) |  | CredentialManager |  |
+|  [headerConfig](./foundation-header.navigation.headerconfig.md) |  | [HeaderConfig](./foundation-header.headerconfig.md) |  |
 |  [hideSideBar](./foundation-header.navigation.hidesidebar.md) |  | boolean | Boolean attribute which controls whether to include the sideNav component Control via<code>hide-side-bar</code> |
 |  [i18next](./foundation-header.navigation.i18next.md) |  | I18next |  |
 |  [languageOptions](./foundation-header.navigation.languageoptions.md) |  | [LanguageOptions](./foundation-header.languageoptions.md) |  |