From d8b2820dce2a963ab010e8c27d7ab287df24f445 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Kry=C5=A1p=C3=ADn?= <crishpeen@gmail.com>
Date: Wed, 8 Jan 2025 14:50:25 +0100
Subject: [PATCH 1/4] Feat(web): Introduce `NavigationItem` subcomponent
 #DS-1411

---
 .../src/scss/components/Navigation/README.md  | 39 +++++++++++++---
 .../components/Navigation/_Navigation.scss    |  4 +-
 .../Navigation/_NavigationAction.scss         | 44 +++++++++++--------
 .../Navigation/_NavigationItem.scss           | 17 +++++++
 .../scss/components/Navigation/_theme.scss    | 43 ++++++++++--------
 .../src/scss/components/Navigation/index.html | 12 ++---
 .../src/scss/components/Navigation/index.scss |  1 +
 7 files changed, 108 insertions(+), 52 deletions(-)
 create mode 100644 packages/web/src/scss/components/Navigation/_NavigationItem.scss

diff --git a/packages/web/src/scss/components/Navigation/README.md b/packages/web/src/scss/components/Navigation/README.md
index 2b40fcbc58..e11cba6d26 100644
--- a/packages/web/src/scss/components/Navigation/README.md
+++ b/packages/web/src/scss/components/Navigation/README.md
@@ -5,6 +5,7 @@ The `Navigation` component is a container for the navigation actions of the appl
 It consists of these parts:
 
 - [Navigation](#navigation)
+  - [NavigationItem](#navigation-item)
   - [NavigationAction](#navigation-action)
 
 ## Navigation
@@ -29,6 +30,34 @@ it will insert a gap between them.
 
 ℹ️ Don't forget to add the `aria-label` attribute to the `Navigation` component for correct accessible title.
 
+## Navigation Item
+
+The `NavigationItem` is a container for a navigation action or any other action.
+
+```html
+<li class="NavigationItem">
+  <!-- action -->
+</li>
+```
+
+### Navigation Item Alignment
+
+Use alignment classes to center or stretch the content. If there is a NavigationAction inside, it overrides the class and
+stretches its content vertically.
+
+```html
+<li class="NavigationItem NavigationItem--alignmentYCenter">
+  <a href="#">Vertically centered link</a>
+</li>
+<li class="NavigationItem NavigationItem--alignmentYStretch">
+  <a href="#">Stretched link</a>
+</li>
+<li class="NavigationItem NavigationItem--alignmentYCenter">
+  <a href="#" class="NavigationAction">Stretched NavigationAction</a>
+  <!-- This will be stretched -->
+</li>
+```
+
 ## Navigation Action
 
 The `NavigationAction` is component that is styled to be used as a navigation action.
@@ -58,13 +87,13 @@ With NavigationAction components:
 ```html
 <nav class="Navigation" aria-label="Main Navigation">
   <ul>
-    <li>
+    <li class="NavigationItem NavigationItem--alignmentYCenter">
       <a class="NavigationAction NavigationAction--selected" href="#" aria-current="page">Selected Link</a>
     </li>
-    <li>
+    <li class="NavigationItem NavigationItem--alignmentYCenter">
       <span class="NavigationAction NavigationAction--disabled">Disabled Link</span>
     </li>
-    <li>
+    <li class="NavigationItem NavigationItem--alignmentYCenter">
       <a class="NavigationAction" href="#">Link</a>
     </li>
   </ul>
@@ -76,10 +105,10 @@ With Buttons:
 ```html
 <nav class="Navigation" aria-label="Secondary Navigation">
   <ul>
-    <li>
+    <li class="NavigationItem NavigationItem--alignmentYCenter">
       <a href="#" class="Button Button--medium Button--primary">Button</a>
     </li>
-    <li>
+    <li class="NavigationItem NavigationItem--alignmentYCenter">
       <a href="#" class="Button Button--medium Button--secondary">Button</a>
     </li>
   </ul>
diff --git a/packages/web/src/scss/components/Navigation/_Navigation.scss b/packages/web/src/scss/components/Navigation/_Navigation.scss
index 9844a6b284..79c8a4e6cc 100644
--- a/packages/web/src/scss/components/Navigation/_Navigation.scss
+++ b/packages/web/src/scss/components/Navigation/_Navigation.scss
@@ -3,8 +3,7 @@
 @use 'theme';
 
 .Navigation,
-.Navigation > ul,
-.Navigation > ul > li {
+.Navigation > ul {
     display: flex;
 }
 
@@ -15,7 +14,6 @@
 .Navigation:not(:has(.NavigationAction)),
 .Navigation:not(:has(.NavigationAction)) > ul {
     gap: theme.$spacing;
-    align-items: center;
 }
 
 .Navigation > ul {
diff --git a/packages/web/src/scss/components/Navigation/_NavigationAction.scss b/packages/web/src/scss/components/Navigation/_NavigationAction.scss
index af756d719c..56771b54db 100644
--- a/packages/web/src/scss/components/Navigation/_NavigationAction.scss
+++ b/packages/web/src/scss/components/Navigation/_NavigationAction.scss
@@ -1,56 +1,62 @@
 // 1. We need to set the top border too, otherwise the content won't be aligned properly.
 
 @use '@tokens' as tokens;
+@use '../../tools/reset';
 @use '../../tools/typography';
 @use 'theme';
 
+.NavigationAction:where(button) {
+    @include reset.button();
+}
+
 .NavigationAction {
-    @include typography.generate(theme.$link-typography);
+    @include typography.generate(theme.$action-typography);
 
     display: flex;
+    gap: theme.$action-gap;
     align-items: center;
     justify-content: center;
-    padding-inline: theme.$link-spacing;
-    color: theme.$link-color-state-default;
-    border-top: theme.$link-border-bottom-width theme.$link-border-bottom-style transparent; // 1.
-    border-bottom: theme.$link-border-bottom-width theme.$link-border-bottom-style
-        theme.$link-border-bottom-color-state-default;
-    background-color: theme.$link-background-color-state-default;
+    padding-inline: theme.$action-spacing;
+    color: theme.$action-color-state-default;
+    border-top: theme.$action-border-bottom-width theme.$action-border-bottom-style transparent; // 1.
+    border-bottom: theme.$action-border-bottom-width theme.$action-border-bottom-style
+        theme.$action-border-bottom-color-state-default;
+    background-color: theme.$action-background-color-state-default;
 
     @media (hover: hover) {
         &:hover {
             text-decoration: none;
-            color: theme.$link-color-state-hover;
-            border-bottom-color: theme.$link-border-bottom-color-state-hover;
-            background-color: theme.$link-background-color-state-hover;
+            color: theme.$action-color-state-hover;
+            border-bottom-color: theme.$action-border-bottom-color-state-hover;
+            background-color: theme.$action-background-color-state-hover;
         }
     }
 
     &:active {
         text-decoration: none;
-        color: theme.$link-color-state-active;
-        border-bottom-color: theme.$link-border-bottom-color-state-active;
-        background-color: theme.$link-background-color-state-active;
+        color: theme.$action-color-state-active;
+        border-bottom-color: theme.$action-border-bottom-color-state-active;
+        background-color: theme.$action-background-color-state-active;
     }
 }
 
 .NavigationAction--selected {
-    color: theme.$link-color-state-selected;
-    border-bottom-color: theme.$link-border-bottom-color-selected-state-default;
-    background-color: theme.$link-background-color-state-selected;
+    color: theme.$action-color-state-selected;
+    border-bottom-color: theme.$action-border-bottom-color-selected-state-default;
+    background-color: theme.$action-background-color-state-selected;
 
     @media (hover: hover) {
         &:hover {
-            border-bottom-color: theme.$link-border-bottom-color-selected-state-hover;
+            border-bottom-color: theme.$action-border-bottom-color-selected-state-hover;
         }
     }
 
     &:active {
-        border-bottom-color: theme.$link-border-bottom-color-selected-state-active;
+        border-bottom-color: theme.$action-border-bottom-color-selected-state-active;
     }
 }
 
 .NavigationAction--disabled {
-    color: theme.$link-color-state-disabled;
+    color: theme.$action-color-state-disabled;
     pointer-events: none;
 }
diff --git a/packages/web/src/scss/components/Navigation/_NavigationItem.scss b/packages/web/src/scss/components/Navigation/_NavigationItem.scss
new file mode 100644
index 0000000000..ead180f731
--- /dev/null
+++ b/packages/web/src/scss/components/Navigation/_NavigationItem.scss
@@ -0,0 +1,17 @@
+@use '@tokens' as tokens;
+@use '../../tools/dictionaries';
+@use 'theme';
+
+.NavigationItem {
+    display: flex;
+}
+
+@include dictionaries.generate-alignments(
+    $class-name: 'NavigationItem',
+    $dictionary-values: theme.$item-alignment-dictionary,
+    $axis: 'y'
+);
+
+.NavigationItem:has(.NavigationAction) {
+    align-items: stretch;
+}
diff --git a/packages/web/src/scss/components/Navigation/_theme.scss b/packages/web/src/scss/components/Navigation/_theme.scss
index 0e087b203b..44447273f1 100644
--- a/packages/web/src/scss/components/Navigation/_theme.scss
+++ b/packages/web/src/scss/components/Navigation/_theme.scss
@@ -1,24 +1,29 @@
+// 1. We do not use the dictionary for this, because we want only two values: center and stretch.
+
 @use '@tokens' as tokens;
 
 $spacing: tokens.$space-700;
 $height: 50px;
 
-$link-typography: tokens.$body-small-semibold;
-$link-spacing: tokens.$space-600;
-$link-color-state-default: tokens.$component-header-item-state-default;
-$link-color-state-hover: tokens.$component-header-item-state-hover;
-$link-color-state-active: tokens.$component-header-item-state-active;
-$link-color-state-selected: tokens.$component-header-item-state-selected;
-$link-color-state-disabled: tokens.$disabled-content;
-$link-border-bottom-width: tokens.$border-width-200;
-$link-border-bottom-style: solid;
-$link-border-bottom-color-state-default: transparent;
-$link-border-bottom-color-state-hover: tokens.$component-header-stripe-state-unselected;
-$link-border-bottom-color-state-active: tokens.$component-header-stripe-state-unselected;
-$link-border-bottom-color-selected-state-default: tokens.$component-header-stripe-state-selected;
-$link-border-bottom-color-selected-state-hover: tokens.$component-header-stripe-state-selected;
-$link-border-bottom-color-selected-state-active: tokens.$component-header-stripe-state-selected;
-$link-background-color-state-default: tokens.$component-header-item-background-state-default;
-$link-background-color-state-hover: tokens.$component-header-item-background-state-hover;
-$link-background-color-state-active: tokens.$component-header-item-background-state-active;
-$link-background-color-state-selected: tokens.$component-header-item-background-state-selected;
+$action-typography: tokens.$body-small-semibold;
+$action-gap: tokens.$space-600;
+$action-spacing: tokens.$space-600;
+$action-color-state-default: tokens.$component-header-item-state-default;
+$action-color-state-hover: tokens.$component-header-item-state-hover;
+$action-color-state-active: tokens.$component-header-item-state-active;
+$action-color-state-selected: tokens.$component-header-item-state-selected;
+$action-color-state-disabled: tokens.$disabled-content;
+$action-border-bottom-width: tokens.$border-width-200;
+$action-border-bottom-style: solid;
+$action-border-bottom-color-state-default: transparent;
+$action-border-bottom-color-state-hover: tokens.$component-header-stripe-state-unselected;
+$action-border-bottom-color-state-active: tokens.$component-header-stripe-state-unselected;
+$action-border-bottom-color-selected-state-default: tokens.$component-header-stripe-state-selected;
+$action-border-bottom-color-selected-state-hover: tokens.$component-header-stripe-state-selected;
+$action-border-bottom-color-selected-state-active: tokens.$component-header-stripe-state-selected;
+$action-background-color-state-default: tokens.$component-header-item-background-state-default;
+$action-background-color-state-hover: tokens.$component-header-item-background-state-hover;
+$action-background-color-state-active: tokens.$component-header-item-background-state-active;
+$action-background-color-state-selected: tokens.$component-header-item-background-state-selected;
+
+$item-alignment-dictionary: center, stretch; // 1.
diff --git a/packages/web/src/scss/components/Navigation/index.html b/packages/web/src/scss/components/Navigation/index.html
index 6851e89807..678d882126 100644
--- a/packages/web/src/scss/components/Navigation/index.html
+++ b/packages/web/src/scss/components/Navigation/index.html
@@ -11,7 +11,7 @@ <h2 class="docs-Heading">Navigation</h2>
       <div style="--spirit-header-height: 72px;">
         <nav class="Navigation" aria-label="Main Navigation">
           <ul>
-            <li>
+            <li class="NavigationItem NavigationItem--alignmentYCenter">
               Item
             </li>
           </ul>
@@ -34,13 +34,13 @@ <h2 class="docs-Heading">NavigationAction</h2>
 
       <nav class="Navigation" aria-label="Main Navigation">
         <ul>
-          <li>
+          <li class="NavigationItem NavigationItem--alignmentYCenter">
             <a href="#" class="NavigationAction">Link</a>
           </li>
-          <li>
+          <li class="NavigationItem NavigationItem--alignmentYCenter">
             <a href="#" class="NavigationAction NavigationAction--selected" aria-current="page">Selected</a>
           </li>
-          <li>
+          <li class="NavigationItem NavigationItem--alignmentYCenter">
             <span class="NavigationAction NavigationAction--disabled">Disabled</span>
           </li>
         </ul>
@@ -62,12 +62,12 @@ <h2 class="docs-Heading">Navigation with Buttons</h2>
 
       <nav class="Navigation" aria-label="Navigation with Buttons">
         <ul>
-          <li>
+          <li class="NavigationItem NavigationItem--alignmentYCenter">
             <a href="#" class="Button Button--medium Button--primary">
               Button
             </a>
           </li>
-          <li>
+          <li class="NavigationItem NavigationItem--alignmentYCenter">
             <a href="#" class="Button Button--medium Button--secondary">
               Button
             </a>
diff --git a/packages/web/src/scss/components/Navigation/index.scss b/packages/web/src/scss/components/Navigation/index.scss
index 7802f42579..7070d90895 100644
--- a/packages/web/src/scss/components/Navigation/index.scss
+++ b/packages/web/src/scss/components/Navigation/index.scss
@@ -1,2 +1,3 @@
 @forward 'Navigation';
 @forward 'NavigationAction';
+@forward 'NavigationItem';

From 2bfac595491b9eef4c53d4a5e0427cd65b070c44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Kry=C5=A1p=C3=ADn?= <crishpeen@gmail.com>
Date: Wed, 8 Jan 2025 14:50:39 +0100
Subject: [PATCH 2/4] Feat(web-react): Introduce `NavigationItem` subcomponent
 #DS-1411

---
 .../src/components/Navigation/Navigation.tsx  |  2 +-
 .../Navigation/NavigationAction.tsx           |  6 +--
 .../components/Navigation/NavigationItem.tsx  | 15 ++++--
 .../src/components/Navigation/README.md       | 26 ++++++++--
 .../Navigation/__tests__/Navigation.test.tsx  |  4 +-
 .../__tests__/NavigationAction.test.tsx       |  4 +-
 .../__tests__/NavigationItem.test.tsx         | 17 +++++-
 .../useNavigationActionStyleProps.test.ts     | 26 ----------
 .../__tests__/useNavigationStyleProps.test.ts | 26 +++++++++-
 .../src/components/Navigation/index.ts        |  1 -
 .../stories/NavigationItem.stories.tsx        | 11 ++++
 .../useNavigationActionStyleProps.ts          | 31 -----------
 .../Navigation/useNavigationStyleProps.ts     | 52 +++++++++++++++++--
 packages/web-react/src/types/navigation.ts    |  7 ++-
 14 files changed, 144 insertions(+), 84 deletions(-)
 delete mode 100644 packages/web-react/src/components/Navigation/__tests__/useNavigationActionStyleProps.test.ts
 delete mode 100644 packages/web-react/src/components/Navigation/useNavigationActionStyleProps.ts

diff --git a/packages/web-react/src/components/Navigation/Navigation.tsx b/packages/web-react/src/components/Navigation/Navigation.tsx
index b27049daec..4ef129f95d 100644
--- a/packages/web-react/src/components/Navigation/Navigation.tsx
+++ b/packages/web-react/src/components/Navigation/Navigation.tsx
@@ -13,7 +13,7 @@ const Navigation = (props: SpiritNavigationProps): JSX.Element => {
   const { styleProps, props: otherProps } = useStyleProps(restProps);
 
   return (
-    <nav {...otherProps} className={classNames(classProps, styleProps.className)} style={styleProps.style}>
+    <nav {...otherProps} className={classNames(classProps.root, styleProps.className)} style={styleProps.style}>
       <ul>{children}</ul>
     </nav>
   );
diff --git a/packages/web-react/src/components/Navigation/NavigationAction.tsx b/packages/web-react/src/components/Navigation/NavigationAction.tsx
index 2e7e5d67a6..0415bb9c98 100644
--- a/packages/web-react/src/components/Navigation/NavigationAction.tsx
+++ b/packages/web-react/src/components/Navigation/NavigationAction.tsx
@@ -5,7 +5,7 @@ import React, { ElementType, forwardRef } from 'react';
 import { useStyleProps } from '../../hooks';
 import { PolymorphicRef, SpiritNavigationActionProps } from '../../types';
 import { useNavigationActionProps } from './useNavigationActionProps';
-import { useNavigationActionStyleProps } from './useNavigationActionStyleProps';
+import { useNavigationStyleProps } from './useNavigationStyleProps';
 
 const defaultProps: Partial<SpiritNavigationActionProps> = {
   elementType: 'a',
@@ -22,7 +22,7 @@ const _NavigationAction = <E extends ElementType = 'a'>(
   const ElementTag = propsWithDefaults.isDisabled ? 'span' : elementType;
 
   const { navigationActionProps } = useNavigationActionProps(propsWithDefaults);
-  const { classProps, props: modifiedProps } = useNavigationActionStyleProps(restProps);
+  const { classProps, props: modifiedProps } = useNavigationStyleProps(restProps);
   const { styleProps, props: otherProps } = useStyleProps(modifiedProps);
 
   return (
@@ -30,7 +30,7 @@ const _NavigationAction = <E extends ElementType = 'a'>(
       {...otherProps}
       {...styleProps}
       {...navigationActionProps}
-      className={classNames(classProps, styleProps.className)}
+      className={classNames(classProps.action, styleProps.className)}
       ref={ref}
     >
       {children}
diff --git a/packages/web-react/src/components/Navigation/NavigationItem.tsx b/packages/web-react/src/components/Navigation/NavigationItem.tsx
index bb32fff3ca..40717ee85c 100644
--- a/packages/web-react/src/components/Navigation/NavigationItem.tsx
+++ b/packages/web-react/src/components/Navigation/NavigationItem.tsx
@@ -1,16 +1,25 @@
 'use client';
 
+import classNames from 'classnames';
 import React from 'react';
+import { AlignmentYExtended } from '../../constants';
 import { useStyleProps } from '../../hooks';
 import { SpiritNavigationItemProps } from '../../types';
+import { useNavigationStyleProps } from './useNavigationStyleProps';
+
+const defaultProps: Partial<SpiritNavigationItemProps> = {
+  alignmentY: AlignmentYExtended.CENTER,
+};
 
 const NavigationItem = (props: SpiritNavigationItemProps): JSX.Element => {
-  const { children, ...restProps } = props;
+  const propsWithDefaults = { ...defaultProps, ...props };
+  const { children, ...restProps } = propsWithDefaults;
 
-  const { styleProps, props: otherProps } = useStyleProps(restProps);
+  const { classProps, props: modifiedProps } = useNavigationStyleProps(restProps);
+  const { styleProps, props: otherProps } = useStyleProps(modifiedProps);
 
   return (
-    <li {...otherProps} className={styleProps.className} style={styleProps.style}>
+    <li {...otherProps} className={classNames(classProps.item, styleProps.className)} style={styleProps.style}>
       {children}
     </li>
   );
diff --git a/packages/web-react/src/components/Navigation/README.md b/packages/web-react/src/components/Navigation/README.md
index f9fcdcee67..5a7dc1a8b3 100644
--- a/packages/web-react/src/components/Navigation/README.md
+++ b/packages/web-react/src/components/Navigation/README.md
@@ -43,11 +43,27 @@ import { NavigationItem } from '@lmc-eu/spirit-web-react';
 <NavigationItem>{/* Navigation actions go here */}</NavigationItem>;
 ```
 
+### Navigation Item Alignment
+
+Use `alignmentY` prop to center or stretch the content. If there is a `NavigationAction` inside, it overrides the prop and
+stretches its content vertically.
+
+```jsx
+import { NavigationAction, NavigationItem } from '@lmc-eu/spirit-web-react';
+
+<NavigationItem>{/* Vertically centered items */}</NavigationItem>;
+<NavigationItem alignmentY="stretch">{/* Vertically stretched items */}</NavigationItem>;
+<NavigationItem>
+  <NavigationAction>{/* Vertically stretched Action */}</NavigationAction>
+</NavigationItem>;
+```
+
 ### API
 
-| Name       | Type                    | Default | Required | Description                   |
-| ---------- | ----------------------- | ------- | -------- | ----------------------------- |
-| `children` | `string` \| `ReactNode` | `null`  | ✓        | Content of the NavigationItem |
+| Name         | Type                     | Default  | Required | Description                        |
+| ------------ | ------------------------ | -------- | -------- | ---------------------------------- |
+| `alignmentY` | \[`center` \| `stretch`] | `center` | ✕        | Vertical alignment of the children |
+| `children`   | `string` \| `ReactNode`  | `null`   | ✓        | Content of the NavigationItem      |
 
 The components accept [additional attributes][readme-additional-attributes].
 If you need more control over the styling of a component, you can use [style props][readme-style-props]
@@ -123,7 +139,9 @@ With Buttons:
     <ButtonLink href="#">Button</ButtonLink>
   </NavigationItem>
   <NavigationItem>
-    <ButtonLink href="#" color="secondary">Button</Button>
+    <ButtonLink href="#" color="secondary">
+      Button
+    </ButtonLink>
   </NavigationItem>
 </Navigation>
 ```
diff --git a/packages/web-react/src/components/Navigation/__tests__/Navigation.test.tsx b/packages/web-react/src/components/Navigation/__tests__/Navigation.test.tsx
index 621ac52c91..01001c8993 100644
--- a/packages/web-react/src/components/Navigation/__tests__/Navigation.test.tsx
+++ b/packages/web-react/src/components/Navigation/__tests__/Navigation.test.tsx
@@ -1,9 +1,7 @@
 import '@testing-library/jest-dom';
 import { render, screen } from '@testing-library/react';
 import React from 'react';
-import { classNamePrefixProviderTest } from '../../../../tests/providerTests/classNamePrefixProviderTest';
-import { restPropsTest } from '../../../../tests/providerTests/restPropsTest';
-import { stylePropsTest } from '../../../../tests/providerTests/stylePropsTest';
+import { classNamePrefixProviderTest, restPropsTest, stylePropsTest } from '@local/tests';
 import Navigation from '../Navigation';
 
 describe('Navigation', () => {
diff --git a/packages/web-react/src/components/Navigation/__tests__/NavigationAction.test.tsx b/packages/web-react/src/components/Navigation/__tests__/NavigationAction.test.tsx
index 7053c2ca49..ef43b4bfaf 100644
--- a/packages/web-react/src/components/Navigation/__tests__/NavigationAction.test.tsx
+++ b/packages/web-react/src/components/Navigation/__tests__/NavigationAction.test.tsx
@@ -1,9 +1,7 @@
 import '@testing-library/jest-dom';
 import { render, screen } from '@testing-library/react';
 import React from 'react';
-import { classNamePrefixProviderTest } from '../../../../tests/providerTests/classNamePrefixProviderTest';
-import { restPropsTest } from '../../../../tests/providerTests/restPropsTest';
-import { stylePropsTest } from '../../../../tests/providerTests/stylePropsTest';
+import { classNamePrefixProviderTest, restPropsTest, stylePropsTest } from '@local/tests';
 import NavigationAction from '../NavigationAction';
 
 describe('NavigationAction', () => {
diff --git a/packages/web-react/src/components/Navigation/__tests__/NavigationItem.test.tsx b/packages/web-react/src/components/Navigation/__tests__/NavigationItem.test.tsx
index 2037bdb321..8b53c5b85b 100644
--- a/packages/web-react/src/components/Navigation/__tests__/NavigationItem.test.tsx
+++ b/packages/web-react/src/components/Navigation/__tests__/NavigationItem.test.tsx
@@ -1,15 +1,28 @@
 import '@testing-library/jest-dom';
 import { render, screen } from '@testing-library/react';
 import React from 'react';
-import { restPropsTest } from '../../../../tests/providerTests/restPropsTest';
-import { stylePropsTest } from '../../../../tests/providerTests/stylePropsTest';
+import { classNamePrefixProviderTest, restPropsTest, stylePropsTest } from '@local/tests';
 import NavigationItem from '../NavigationItem';
 
 describe('NavigationItem', () => {
+  classNamePrefixProviderTest(NavigationItem, 'NavigationItem');
+
   stylePropsTest(NavigationItem);
 
   restPropsTest(NavigationItem, 'li');
 
+  it('should have default classname', () => {
+    render(<NavigationItem>Content</NavigationItem>);
+
+    expect(screen.getByRole('listitem')).toHaveClass('NavigationItem NavigationItem--alignmentYCenter');
+  });
+
+  it('should have stretch alignment classname', () => {
+    render(<NavigationItem alignmentY="stretch">Content</NavigationItem>);
+
+    expect(screen.getByRole('listitem')).toHaveClass('NavigationItem--alignmentYStretch');
+  });
+
   it('should have correct role', () => {
     render(<NavigationItem>Content</NavigationItem>);
 
diff --git a/packages/web-react/src/components/Navigation/__tests__/useNavigationActionStyleProps.test.ts b/packages/web-react/src/components/Navigation/__tests__/useNavigationActionStyleProps.test.ts
deleted file mode 100644
index b9bc991931..0000000000
--- a/packages/web-react/src/components/Navigation/__tests__/useNavigationActionStyleProps.test.ts
+++ /dev/null
@@ -1,26 +0,0 @@
-import { renderHook } from '@testing-library/react';
-import { SpiritNavigationActionProps } from '../../../types';
-import { useNavigationActionStyleProps } from '../useNavigationActionStyleProps';
-
-describe('useNavigationActionStyleProps', () => {
-  it('should return defaults', () => {
-    const props = {};
-    const { result } = renderHook(() => useNavigationActionStyleProps(props));
-
-    expect(result.current.classProps).toBe('NavigationAction');
-  });
-
-  it('should return disabled class', () => {
-    const props: SpiritNavigationActionProps = { isDisabled: true };
-    const { result } = renderHook(() => useNavigationActionStyleProps(props));
-
-    expect(result.current.classProps).toBe('NavigationAction NavigationAction--disabled');
-  });
-
-  it('should return selected class', () => {
-    const props = { isSelected: true };
-    const { result } = renderHook(() => useNavigationActionStyleProps(props));
-
-    expect(result.current.classProps).toBe('NavigationAction NavigationAction--selected');
-  });
-});
diff --git a/packages/web-react/src/components/Navigation/__tests__/useNavigationStyleProps.test.ts b/packages/web-react/src/components/Navigation/__tests__/useNavigationStyleProps.test.ts
index a1efc2675e..9cd038b017 100644
--- a/packages/web-react/src/components/Navigation/__tests__/useNavigationStyleProps.test.ts
+++ b/packages/web-react/src/components/Navigation/__tests__/useNavigationStyleProps.test.ts
@@ -1,10 +1,34 @@
 import { renderHook } from '@testing-library/react';
+import { SpiritNavigationActionProps } from '../../../types';
 import { useNavigationStyleProps } from '../useNavigationStyleProps';
 
 describe('useNavigationStyleProps', () => {
   it('should return defaults', () => {
     const { result } = renderHook(() => useNavigationStyleProps());
 
-    expect(result.current.classProps).toBe('Navigation');
+    expect(result.current.classProps.root).toBe('Navigation');
+    expect(result.current.classProps.action).toBe('NavigationAction');
+    expect(result.current.classProps.item).toBe('NavigationItem NavigationItem--alignmentYCenter');
+  });
+
+  it('should return disabled class', () => {
+    const props: SpiritNavigationActionProps = { isDisabled: true };
+    const { result } = renderHook(() => useNavigationStyleProps(props));
+
+    expect(result.current.classProps.action).toBe('NavigationAction NavigationAction--disabled');
+  });
+
+  it('should return selected class', () => {
+    const props = { isSelected: true };
+    const { result } = renderHook(() => useNavigationStyleProps(props));
+
+    expect(result.current.classProps.action).toBe('NavigationAction NavigationAction--selected');
+  });
+
+  it('should return alignment class', () => {
+    const props = { alignmentY: 'stretch' };
+    const { result } = renderHook(() => useNavigationStyleProps(props));
+
+    expect(result.current.classProps.item).toBe('NavigationItem NavigationItem--alignmentYStretch');
   });
 });
diff --git a/packages/web-react/src/components/Navigation/index.ts b/packages/web-react/src/components/Navigation/index.ts
index fe3a713e3b..2f3f543a67 100644
--- a/packages/web-react/src/components/Navigation/index.ts
+++ b/packages/web-react/src/components/Navigation/index.ts
@@ -5,4 +5,3 @@ export { default as NavigationAction } from './NavigationAction';
 export { default as NavigationItem } from './NavigationItem';
 export * from './useNavigationStyleProps';
 export * from './useNavigationActionProps';
-export * from './useNavigationActionStyleProps';
diff --git a/packages/web-react/src/components/Navigation/stories/NavigationItem.stories.tsx b/packages/web-react/src/components/Navigation/stories/NavigationItem.stories.tsx
index 3513b0dd2a..997491e923 100644
--- a/packages/web-react/src/components/Navigation/stories/NavigationItem.stories.tsx
+++ b/packages/web-react/src/components/Navigation/stories/NavigationItem.stories.tsx
@@ -1,6 +1,7 @@
 import { Markdown } from '@storybook/blocks';
 import type { Meta, StoryObj } from '@storybook/react';
 import React from 'react';
+import { AlignmentYExtended } from '../../../constants';
 import NavigationAction from '../NavigationAction';
 import NavigationItem from '../NavigationItem';
 import ReadMe from '../README.md';
@@ -13,7 +14,17 @@ const meta: Meta<typeof NavigationItem> = {
       page: () => <Markdown>{ReadMe}</Markdown>,
     },
   },
+  argTypes: {
+    alignmentY: {
+      control: 'select',
+      options: [AlignmentYExtended.CENTER, AlignmentYExtended.STRETCH],
+      table: {
+        defaultValue: { summary: AlignmentYExtended.CENTER },
+      },
+    },
+  },
   args: {
+    alignmentY: AlignmentYExtended.CENTER,
     children: <NavigationAction href="/">Link</NavigationAction>,
   },
 };
diff --git a/packages/web-react/src/components/Navigation/useNavigationActionStyleProps.ts b/packages/web-react/src/components/Navigation/useNavigationActionStyleProps.ts
deleted file mode 100644
index 46b4bf0518..0000000000
--- a/packages/web-react/src/components/Navigation/useNavigationActionStyleProps.ts
+++ /dev/null
@@ -1,31 +0,0 @@
-import classNames from 'classnames';
-import { ElementType } from 'react';
-import { useClassNamePrefix } from '../../hooks';
-import { LinkProps, SpiritNavigationActionProps } from '../../types';
-
-export interface NavigationActionStyles<E extends ElementType = 'p'> {
-  /** className props */
-  classProps: string | null;
-  /** props to be passed to the input element */
-  props: Partial<LinkProps<E>>;
-}
-
-export function useNavigationActionStyleProps<E extends ElementType = 'a'>(
-  props: SpiritNavigationActionProps<E>,
-): NavigationActionStyles<E> {
-  const { isDisabled, isSelected, ...restProps } = props;
-
-  const navigationActionClass = useClassNamePrefix('NavigationAction');
-  const navigationActionDisabledClass = `${navigationActionClass}--disabled`;
-  const navigationActionSelectedClass = `${navigationActionClass}--selected`;
-
-  const className = classNames(navigationActionClass, {
-    [navigationActionDisabledClass]: isDisabled,
-    [navigationActionSelectedClass]: isSelected,
-  });
-
-  return {
-    classProps: className,
-    props: restProps,
-  };
-}
diff --git a/packages/web-react/src/components/Navigation/useNavigationStyleProps.ts b/packages/web-react/src/components/Navigation/useNavigationStyleProps.ts
index 608f5492f7..970d1e3bc0 100644
--- a/packages/web-react/src/components/Navigation/useNavigationStyleProps.ts
+++ b/packages/web-react/src/components/Navigation/useNavigationStyleProps.ts
@@ -1,13 +1,55 @@
-import { useClassNamePrefix } from '../../hooks';
+import classNames from 'classnames';
+import { AlignmentYExtended } from '../../constants';
+import { AlignmentPropertyType, useAlignmentClass, useClassNamePrefix } from '../../hooks';
+import {
+  SpiritNavigationActionProps,
+  SpiritNavigationItemAlignmentYType,
+  SpiritNavigationItemProps,
+} from '../../types';
 
-export interface NavigationStyles {
-  classProps: string;
+export interface UseNavigationStyleProps {
+  isDisabled?: boolean;
+  isSelected?: boolean;
+  alignmentY?: SpiritNavigationItemAlignmentYType;
 }
 
-export const useNavigationStyleProps = () => {
+export interface UseNavigationStyleReturn {
+  classProps: {
+    root: string;
+    action: string;
+    item: string;
+  };
+  props: SpiritNavigationItemProps | SpiritNavigationActionProps;
+}
+
+export const useNavigationStyleProps = ({
+  isDisabled = false,
+  isSelected = false,
+  alignmentY = AlignmentYExtended.CENTER,
+  ...restProps
+}: UseNavigationStyleProps = {}): UseNavigationStyleReturn => {
   const navigationClass = useClassNamePrefix('Navigation');
+  const navigationActionClass = useClassNamePrefix('NavigationAction');
+  const navigationItemClass = useClassNamePrefix('NavigationItem');
+
+  const navigationActionDisabledClass = `${navigationActionClass}--disabled`;
+  const navigationActionSelectedClass = `${navigationActionClass}--selected`;
+
+  const navigationItemClasses = classNames(navigationItemClass, {
+    [useAlignmentClass(navigationItemClass, alignmentY as AlignmentPropertyType, 'alignmentY')]: alignmentY,
+  });
+
+  const classProps = {
+    root: navigationClass,
+    action: classNames(navigationActionClass, {
+      [navigationActionDisabledClass]: isDisabled,
+      [navigationActionSelectedClass]: isSelected,
+    }),
+    item: navigationItemClasses,
+  };
 
   return {
-    classProps: navigationClass,
+    classProps,
+    props: restProps,
   };
 };
diff --git a/packages/web-react/src/types/navigation.ts b/packages/web-react/src/types/navigation.ts
index 8ddf9de085..78b0ece479 100644
--- a/packages/web-react/src/types/navigation.ts
+++ b/packages/web-react/src/types/navigation.ts
@@ -2,6 +2,7 @@ import { ElementType, ReactElement } from 'react';
 import { NavigationItem } from '../components';
 import { LinkTarget } from './link';
 import {
+  AlignmentYExtendedDictionaryType,
   AriaLabelingProps,
   ChildrenProps,
   SpiritPolymorphicElementPropsWithRef,
@@ -29,7 +30,11 @@ export type NavigationActionProps<E extends ElementType> = {
   elementType?: E;
 } & NavigationActionBaseProps;
 
-export interface SpiritNavigationItemProps extends ChildrenProps, StyleProps {}
+export type SpiritNavigationItemAlignmentYType = Omit<AlignmentYExtendedDictionaryType, 'top' | 'bottom' | 'baseline'>;
+
+export interface SpiritNavigationItemProps extends ChildrenProps, StyleProps {
+  alignmentY?: SpiritNavigationItemAlignmentYType;
+}
 
 export type SpiritNavigationActionProps<E extends ElementType = 'a'> = NavigationActionProps<E> &
   SpiritPolymorphicElementPropsWithRef<E, NavigationActionProps<E>>;

From bb247ef120dd729ec73409e534a7b1f5345087a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Kry=C5=A1p=C3=ADn?= <crishpeen@gmail.com>
Date: Wed, 8 Jan 2025 14:51:10 +0100
Subject: [PATCH 3/4] Docs(web): Showcase Header with Navigation and Dropdown
 #DS-1411

---
 .../components/UNSTABLE_Header/index.html     | 103 ++++++++++++++++--
 .../unstable-header-chromium-linux.png        | Bin 38709 -> 41699 bytes
 2 files changed, 95 insertions(+), 8 deletions(-)

diff --git a/packages/web/src/scss/components/UNSTABLE_Header/index.html b/packages/web/src/scss/components/UNSTABLE_Header/index.html
index 59b81dc283..d9507723af 100644
--- a/packages/web/src/scss/components/UNSTABLE_Header/index.html
+++ b/packages/web/src/scss/components/UNSTABLE_Header/index.html
@@ -78,7 +78,7 @@ <h2 class="docs-Heading">With Navigation</h2>
     <header class="UNSTABLE_Header">
       <div class="Container">
         <div
-          class="Flex Flex--row Flex--noWrap Flex--alignmentXLeft Flex--alignmentYCenter"
+          class="Flex Flex--row Flex--noWrap Flex--alignmentXLeft Flex--alignmentYStretch"
           style="--flex-spacing-x: var(--spirit-space-1000);"
         >
           <a href="#" aria-label="JobBoard homepage" class="UNSTABLE_HeaderLogo">
@@ -89,13 +89,53 @@ <h2 class="docs-Heading">With Navigation</h2>
 
           <nav class="Navigation" aria-label="Main Navigation">
             <ul>
-              <li>
+              <li class="NavigationItem NavigationItem--alignmentYCenter">
                 <a href="#" class="NavigationAction">Link</a>
               </li>
-              <li>
+              <li class="NavigationItem NavigationItem--alignmentYCenter">
                 <a href="#" class="NavigationAction NavigationAction--selected" aria-current="page">Selected</a>
               </li>
-              <li>
+              <li class="NavigationItem NavigationItem--alignmentYCenter">
+                <div class="Dropdown Dropdown--alignmentXStretch Dropdown--alignmentYStretch">
+                  <button
+                    type="button"
+                    class="NavigationAction"
+                    data-spirit-toggle="dropdown"
+                    data-spirit-target="#dropdown-navigation"
+                    aria-expanded="false"
+                    aria-controls="dropdown-navigation"
+                    data-spirit-autoclose="true"
+                  >
+                    Dropdown
+                    <svg width="20" height="20" aria-hidden="true" class="accessibility-open">
+                      <use xlink:href="/assets/icons/svg/sprite.svg#chevron-up" />
+                    </svg>
+                    <svg width="20" height="20" aria-hidden="true" class="accessibility-closed">
+                      <use xlink:href="/assets/icons/svg/sprite.svg#chevron-down" />
+                    </svg>
+                  </button>
+                  <div class="DropdownPopover" data-spirit-placement="bottom-end" id="dropdown-navigation">
+                    <ul class="list-unstyled">
+                      <li>
+                        <a href="https://www.example.com" class="Item">
+                          <span class="Item__label">My Account</span>
+                        </a>
+                      </li>
+                      <li>
+                        <a href="https://www.example.com" class="Item">
+                          <span class="Item__label">Settings</span>
+                        </a>
+                      </li>
+                      <li>
+                        <a href="https://www.example.com" class="Item">
+                          <span class="Item__label">Log Out</span>
+                        </a>
+                      </li>
+                    </ul>
+                  </div>
+                </div>
+              </li>
+              <li class="NavigationItem NavigationItem--alignmentYCenter">
                 <span class="NavigationAction NavigationAction--disabled">Disabled</span>
               </li>
             </ul>
@@ -103,17 +143,64 @@ <h2 class="docs-Heading">With Navigation</h2>
 
           <nav class="Navigation ml-auto" aria-label="Secondary Navigation">
             <ul>
-              <li>
+              <li class="NavigationItem NavigationItem--alignmentYCenter">
                 <button class="Button Button--tertiary Button--medium Button--symmetrical">
                   <svg width="24" height="24" aria-hidden="true">
                     <use xlink:href="/assets/icons/svg/sprite.svg#search" />
                   </svg>
                 </button>
               </li>
-              <li>
-                <a href="#" class="Button Button--secondary Button--medium">Sign up</a>
+              <li class="NavigationItem NavigationItem--alignmentYStretch">
+                <div class="Dropdown Dropdown--alignmentXStretch Dropdown--alignmentYStretch">
+                  <button
+                    type="button"
+                    class="button-unstyled"
+                    data-spirit-toggle="dropdown"
+                    data-spirit-target="#dropdown-avatar"
+                    aria-expanded="false"
+                    aria-controls="dropdown-avatar"
+                    data-spirit-autoclose="true"
+                  >
+                    <span class="Flex Flex--row Flex--noWrap Flex--alignmentXStretch Flex--alignmentYCenter" style="--flex-spacing-x: var(--spirit-space-500)">
+                      <span class="UNSTABLE_Avatar UNSTABLE_Avatar--medium UNSTABLE_Avatar--square" aria-label="Profile of Jiří Bárta">
+                        <svg width="20" height="20" aria-hidden="true">
+                          <use xlink:href="/assets/icons/svg/sprite.svg#profile" />
+                        </svg>
+                      </span>
+                      <span class="typography-body-small-semibold text-primary">My Account</span>
+                      <svg width="20" height="20" aria-hidden="true" class="accessibility-open">
+                        <use xlink:href="/assets/icons/svg/sprite.svg#chevron-up" />
+                      </svg>
+                      <svg width="20" height="20" aria-hidden="true" class="accessibility-closed">
+                        <use xlink:href="/assets/icons/svg/sprite.svg#chevron-down" />
+                      </svg>
+                    </span>
+                  </button>
+                  <div class="DropdownPopover" data-spirit-placement="bottom-end" id="dropdown-avatar">
+                    <ul class="list-unstyled">
+                      <li>
+                        <a href="https://www.example.com" class="Item">
+                          <span class="Item__label">My Account</span>
+                        </a>
+                      </li>
+                      <li>
+                        <a href="https://www.example.com" class="Item">
+                          <span class="Item__label">Settings</span>
+                        </a>
+                      </li>
+                      <li>
+                        <a href="https://www.example.com" class="Item">
+                          <span class="Item__label">Log Out</span>
+                        </a>
+                      </li>
+                    </ul>
+                  </div>
+                </div>
+              </li>
+              <li class="NavigationItem NavigationItem--alignmentYCenter">
+                <a href="#" class="Button Button--secondary Button--medium">Log out</a>
               </li>
-              <li>
+              <li class="NavigationItem NavigationItem--alignmentYCenter">
                 <a href="#" class="Button Button--primary Button--medium">Post a job</a>
               </li>
             </ul>
diff --git a/tests/e2e/demo-components-compare.spec.ts-snapshots/unstable-header-chromium-linux.png b/tests/e2e/demo-components-compare.spec.ts-snapshots/unstable-header-chromium-linux.png
index 8509a8b0a8793e687fbc174a628a6d7ea299bbb9..ced6eaa85da64703f05675ab6496cabf4de58796 100644
GIT binary patch
delta 25623
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
Jdc*qRe*ig63_bt=

delta 22609
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
Wz~5{XmJo##VQb}JS$6Kqt^WXmv|ob&


From 866be97c7bcd2802a7e1a0ef9abf8316c306d9b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Kry=C5=A1p=C3=ADn?= <crishpeen@gmail.com>
Date: Wed, 8 Jan 2025 14:51:23 +0100
Subject: [PATCH 4/4] Docs(web-react): Showcase Header with Navigation and
 Dropdown #DS-1411

---
 .../__tests__/UNSTABLE_Header.test.tsx        |  4 +-
 .../__tests__/UNSTABLE_HeaderLogo.test.tsx    |  4 +-
 .../demo/HeaderWithNavigation.tsx             | 84 ++++++++++++++++++-
 3 files changed, 84 insertions(+), 8 deletions(-)

diff --git a/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_Header.test.tsx b/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_Header.test.tsx
index 29194763ce..0e5c1b4a4d 100644
--- a/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_Header.test.tsx
+++ b/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_Header.test.tsx
@@ -1,9 +1,7 @@
 import '@testing-library/jest-dom';
 import { render, screen } from '@testing-library/react';
 import React from 'react';
-import { classNamePrefixProviderTest } from '../../../../tests/providerTests/classNamePrefixProviderTest';
-import { restPropsTest } from '../../../../tests/providerTests/restPropsTest';
-import { stylePropsTest } from '../../../../tests/providerTests/stylePropsTest';
+import { classNamePrefixProviderTest, restPropsTest, stylePropsTest } from '@local/tests';
 import UNSTABLE_Header from '../UNSTABLE_Header';
 
 describe('UNSTABLE_Header', () => {
diff --git a/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_HeaderLogo.test.tsx b/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_HeaderLogo.test.tsx
index a50db40d4c..0953fa144f 100644
--- a/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_HeaderLogo.test.tsx
+++ b/packages/web-react/src/components/UNSTABLE_Header/__tests__/UNSTABLE_HeaderLogo.test.tsx
@@ -1,9 +1,7 @@
 import '@testing-library/jest-dom';
 import { render, screen } from '@testing-library/react';
 import React from 'react';
-import { classNamePrefixProviderTest } from '../../../../tests/providerTests/classNamePrefixProviderTest';
-import { restPropsTest } from '../../../../tests/providerTests/restPropsTest';
-import { stylePropsTest } from '../../../../tests/providerTests/stylePropsTest';
+import { classNamePrefixProviderTest, restPropsTest, stylePropsTest } from '@local/tests';
 import UNSTABLE_HeaderLogo from '../UNSTABLE_HeaderLogo';
 
 describe('UNSTABLE_HeaderLogo', () => {
diff --git a/packages/web-react/src/components/UNSTABLE_Header/demo/HeaderWithNavigation.tsx b/packages/web-react/src/components/UNSTABLE_Header/demo/HeaderWithNavigation.tsx
index 9a7bd946d5..f7975a5edb 100644
--- a/packages/web-react/src/components/UNSTABLE_Header/demo/HeaderWithNavigation.tsx
+++ b/packages/web-react/src/components/UNSTABLE_Header/demo/HeaderWithNavigation.tsx
@@ -1,20 +1,35 @@
 import React from 'react';
+import { SpiritNavigationActionProps } from '../../../types';
 import { Button } from '../../Button';
 import { ButtonLink } from '../../ButtonLink';
 import { Container } from '../../Container';
+import { Dropdown, DropdownPopover, DropdownTrigger } from '../../Dropdown';
 import { Flex } from '../../Flex';
 import { Icon } from '../../Icon';
+import { Item } from '../../Item';
 import { Navigation, NavigationAction, NavigationItem } from '../../Navigation';
 import { ProductLogo } from '../../ProductLogo';
 import { defaultSvgLogo } from '../../ProductLogo/demo/ProductLogoDefault';
+import { Text } from '../../Text';
+import { UNSTABLE_Avatar } from '../../UNSTABLE_Avatar';
 import UNSTABLE_Header from '../UNSTABLE_Header';
 import UNSTABLE_HeaderLogo from '../UNSTABLE_HeaderLogo';
 
+const NavigationActionAsDropdownTrigger = (props: SpiritNavigationActionProps) => (
+  <NavigationAction {...props} elementType="button" />
+);
+const AvatarButtonAsDropdownTrigger = (props: SpiritNavigationActionProps) => (
+  <button {...props} className="button-unstyled" type="button" />
+);
+
 const HeaderDefault = () => {
+  const [isNavigationActionDropdownOpen, setIsNavigationActionDropdownOpen] = React.useState(false);
+  const [isAvatarDropdownOpen, setIsAvatarDropdownOpen] = React.useState(false);
+
   return (
     <UNSTABLE_Header>
       <Container>
-        <Flex alignmentX="left" alignmentY="center" spacing="space-1000">
+        <Flex alignmentX="left" alignmentY="stretch" spacing="space-1000">
           <UNSTABLE_HeaderLogo href="#">
             <ProductLogo>{defaultSvgLogo}</ProductLogo>
           </UNSTABLE_HeaderLogo>
@@ -27,6 +42,35 @@ const HeaderDefault = () => {
                 Selected
               </NavigationAction>
             </NavigationItem>
+            <NavigationItem>
+              <Dropdown
+                alignmentX="stretch"
+                alignmentY="stretch"
+                id="navigation-action-dropdown"
+                isOpen={isNavigationActionDropdownOpen}
+                onToggle={() => setIsNavigationActionDropdownOpen(!isNavigationActionDropdownOpen)}
+                placement="bottom-end"
+              >
+                <DropdownTrigger elementType={NavigationActionAsDropdownTrigger as unknown as HTMLButtonElement}>
+                  Dropdown
+                  <Icon name="chevron-up" boxSize={20} UNSAFE_className="accessibility-open" />
+                  <Icon name="chevron-down" boxSize={20} UNSAFE_className="accessibility-closed" />
+                </DropdownTrigger>
+                <DropdownPopover>
+                  <ul className="list-unstyled">
+                    <li>
+                      <Item label="My Account" href="https://www.example.com" />
+                    </li>
+                    <li>
+                      <Item label="Settings" href="https://www.example.com" />
+                    </li>
+                    <li>
+                      <Item label="Log Out" href="https://www.example.com" />
+                    </li>
+                  </ul>
+                </DropdownPopover>
+              </Dropdown>
+            </NavigationItem>
             <NavigationItem>
               <NavigationAction href="#" isDisabled>
                 Disabled
@@ -39,9 +83,45 @@ const HeaderDefault = () => {
                 <Icon name="search" />
               </Button>
             </NavigationItem>
+            <NavigationItem alignmentY="stretch">
+              <Dropdown
+                alignmentX="stretch"
+                alignmentY="stretch"
+                id="avatar-dropdown"
+                isOpen={isAvatarDropdownOpen}
+                onToggle={() => setIsAvatarDropdownOpen(!isAvatarDropdownOpen)}
+                placement="bottom-end"
+              >
+                <DropdownTrigger elementType={AvatarButtonAsDropdownTrigger as unknown as HTMLButtonElement}>
+                  <Flex spacingX="space-500" alignmentX="stretch" alignmentY="center">
+                    <UNSTABLE_Avatar isSquare aria-label="Profile of Jiří Bárta">
+                      <Icon name="profile" boxSize={20} />
+                    </UNSTABLE_Avatar>
+                    <Text elementType="span" size="small" emphasis="semibold" UNSAFE_className="text-primary">
+                      My Account
+                    </Text>
+                    <Icon name="chevron-up" boxSize={20} UNSAFE_className="accessibility-open" />
+                    <Icon name="chevron-down" boxSize={20} UNSAFE_className="accessibility-closed" />
+                  </Flex>
+                </DropdownTrigger>
+                <DropdownPopover>
+                  <ul className="list-unstyled">
+                    <li>
+                      <Item label="My Account" href="https://www.example.com" />
+                    </li>
+                    <li>
+                      <Item label="Settings" href="https://www.example.com" />
+                    </li>
+                    <li>
+                      <Item label="Log Out" href="https://www.example.com" />
+                    </li>
+                  </ul>
+                </DropdownPopover>
+              </Dropdown>
+            </NavigationItem>
             <NavigationItem>
               <ButtonLink href="#" color="secondary">
-                Sign up
+                Log out
               </ButtonLink>
             </NavigationItem>
             <NavigationItem>