@kaizen/components 1.78.1 → 1.78.3

package/dist/types/Filter/FilterMultiSelect/FilterMultiSelect.d.ts

@@ -15,11 +15,13 @@ type SelectionProps = {
 export type FilterMultiSelectProps = {
     trigger: (value?: MenuTriggerProviderContextType) => React.ReactNode;
     children: (value?: SelectionProviderContextType) => React.ReactNode;
+    /** Replaces the MenuPopup. Should only be used for changing how the floating element is positioned, ie: with the `<ResponsiveMenuPopup />` primitive. */
+    customMenuPopup?: React.ComponentType<MenuPopupProps>;
     triggerRef?: React.RefObject<HTMLButtonElement>;
     className?: string;
 } & Omit<MenuPopupProps, 'children'> & Omit<MenuTriggerProviderProps, 'children'> & SelectionProps;
 export declare const FilterMultiSelect: {
-    ({ trigger, children, isOpen, defaultOpen, onOpenChange, isLoading, loadingSkeleton, label, items, selectedKeys, defaultSelectedKeys, onSelectionChange, selectionMode, onSearchInputChange, triggerRef, className, }: FilterMultiSelectProps): JSX.Element;
+    ({ trigger, children, customMenuPopup, isOpen, defaultOpen, onOpenChange, isLoading, loadingSkeleton, label, items, selectedKeys, defaultSelectedKeys, onSelectionChange, selectionMode, onSearchInputChange, triggerRef, className, ...restProps }: FilterMultiSelectProps): JSX.Element;
     displayName: string;
     TriggerButton: {
         ({ selectedOptionLabels, label, classNameOverride, labelCharacterLimitBeforeTruncate, }: import("./subcomponents/Trigger").FilterTriggerButtonProps): JSX.Element;
@@ -70,5 +72,9 @@ export declare const FilterMultiSelect: {
         ({ children, ...restProps }: import("./subcomponents/NoResults").NoResultsProps): JSX.Element;
         displayName: string;
     };
+    ResponsiveMenuPopup: {
+        ({ children, floatingConfig, classNameOverride, isLoading, loadingSkeleton, ...restProps }: import("./subcomponents/MenuPopup").ResponsiveMenuPopupProps): JSX.Element;
+        displayName: string;
+    };
 };
 export {};

package/dist/types/Filter/FilterMultiSelect/_docs/MockData.d.ts

@@ -8,3 +8,4 @@ export declare const locationDemographicValues: {
     demographicValueId: string;
     label: string;
 }[];
+export declare const mockManyItems: ItemType[];

package/dist/types/Filter/FilterMultiSelect/subcomponents/MenuPopup/ResponsiveMenuPopup.d.ts

@@ -0,0 +1,22 @@
+import { type HTMLAttributes } from 'react';
+import { type UseFloatingOptions } from '@floating-ui/react-dom';
+import { type OverrideClassName } from "../../../../types/OverrideClassName";
+import { type MenuPopupProps } from './MenuPopup';
+export type FloatingConfig = Pick<UseFloatingOptions, 'placement' | 'strategy' | 'whileElementsMounted'> & {
+    /** Whether the component should automatically resize based on the available window height.
+     * @default true
+     */
+    shouldResize?: boolean;
+    /** Whether the component should automatically flip to the top of the input based on the available window height.
+     * @default true
+     */
+    shouldFlip?: boolean;
+};
+export type ResponsiveMenuPopupProps = MenuPopupProps & {
+    floatingConfig?: FloatingConfig;
+} & OverrideClassName<HTMLAttributes<HTMLDivElement>>;
+/** This is a popup primitive that can be used with the FilterMultiSelect when there are overflow issues with the original implementation. This uses the floating-ui */
+export declare const ResponsiveMenuPopup: {
+    ({ children, floatingConfig, classNameOverride, isLoading, loadingSkeleton, ...restProps }: ResponsiveMenuPopupProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/Filter/FilterMultiSelect/subcomponents/MenuPopup/index.d.ts

@@ -1 +1,2 @@
 export * from './MenuPopup';
+export * from './ResponsiveMenuPopup';

package/dist/types/LikertScaleLegacy/LikertScaleLegacy.d.ts

@@ -12,10 +12,14 @@ export type LikertScaleProps = {
     'colorSchema'?: ColorSchema | 'classical';
     'validationMessage'?: string;
     'status'?: 'default' | 'error';
+    /**
+     * Sets aria-required value on radiogroup for assistive technologies. Validation must still be handled.
+     */
+    'isRequired'?: boolean;
     'onSelect': (value: ScaleItem | null) => void;
 };
 /**
  * {@link https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3082060201/Likert+Scale Guidance} |
  * {@link https://cultureamp.design/?path=/docs/components-likertscalelegacy--docs Storybook}
  */
-export declare const LikertScaleLegacy: ({ scale, selectedItem, reversed, colorSchema, "data-testid": dataTestId, onSelect, validationMessage, status, labelId, }: LikertScaleProps) => JSX.Element;
+export declare const LikertScaleLegacy: ({ scale, selectedItem, reversed, colorSchema, "data-testid": dataTestId, onSelect, validationMessage, status, labelId, isRequired, }: LikertScaleProps) => JSX.Element;

package/dist/types/Menu/subcomponents/StatelessMenu/StatelessMenu.d.ts

@@ -41,7 +41,6 @@ export type StatelessMenuProps = {
     'renderButton': (args: {
         'onClick': (e: any) => void;
         'onMouseDown': (e: any) => void;
-        'aria-haspopup': boolean;
         'aria-expanded': boolean;
     }) => React.ReactElement;
     'onClick'?: (event: SyntheticEvent) => void;

package/dist/types/__next__/Select/Select.d.ts

@@ -51,7 +51,7 @@ export type SelectProps<Option extends SelectOption = SelectOption> = {
  * {@link https://cultureamp.design/?path=/docs/components-select--docs Storybook}
  */
 export declare const Select: {
-    <Option extends SelectOption = SelectOption>({ label, items, id: propsId, trigger, children, status, validationMessage, isReversed, isFullWidth, disabledValues, classNameOverride, selectedKey, description, placeholder, isDisabled, portalContainerId, ...restProps }: SelectProps<Option>): JSX.Element;
+    <Option extends SelectOption = SelectOption>({ label, items, id: propsId, trigger, children, status, validationMessage, isReversed, isRequired, isFullWidth, disabledValues, classNameOverride, selectedKey, description, placeholder, isDisabled, portalContainerId, onSelectionChange, ...restProps }: SelectProps<Option>): JSX.Element;
     displayName: string;
     Section: {
         <Option extends SelectOption = SelectOption>({ section, }: import("./subcomponents").ListBoxSectionProps<Option>): JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaizen/components",
-  "version": "1.78.1",
+  "version": "1.78.3",
   "description": "Kaizen component library",
   "author": "Geoffrey Chong <geoff.chong@cultureamp.com>",
   "homepage": "https://cultureamp.design",

package/src/Filter/FilterBar/subcomponents/FilterBarMultiSelect/FilterBarMultiSelect.spec.tsx

@@ -180,6 +180,7 @@ describe('<FilterBarMultiSelect />', () => {
     })
 
     await user.click(getByRole('option', { name: 'Fruit Jelly' }))
+    await user.keyboard('{Escape}')
     await waitFor(() => {
       expect(getByRole('button', { name: 'Toppings : Pearls, Fruit Jelly' })).toBeInTheDocument()
     })

package/src/Filter/FilterMultiSelect/FilterMultiSelect.tsx

@@ -13,7 +13,7 @@ import { ListBox } from './subcomponents/ListBox'
 import { ListBoxSection } from './subcomponents/ListBoxSection'
 import { LoadMoreButton } from './subcomponents/LoadMoreButton'
 import { MenuFooter, MenuLoadingSkeleton } from './subcomponents/MenuLayout'
-import { MenuPopup, type MenuPopupProps } from './subcomponents/MenuPopup'
+import { MenuPopup, ResponsiveMenuPopup, type MenuPopupProps } from './subcomponents/MenuPopup'
 import { MultiSelectOption } from './subcomponents/MultiSelectOption'
 import { NoResults } from './subcomponents/NoResults'
 import { SearchInput } from './subcomponents/SearchInput'
@@ -35,6 +35,8 @@ type SelectionProps = {
 export type FilterMultiSelectProps = {
   trigger: (value?: MenuTriggerProviderContextType) => React.ReactNode
   children: (value?: SelectionProviderContextType) => React.ReactNode // the content of the menu
+  /** Replaces the MenuPopup. Should only be used for changing how the floating element is positioned, ie: with the `<ResponsiveMenuPopup />` primitive. */
+  customMenuPopup?: React.ComponentType<MenuPopupProps>
   triggerRef?: React.RefObject<HTMLButtonElement>
   className?: string
 } & Omit<MenuPopupProps, 'children'> &
@@ -44,6 +46,7 @@ export type FilterMultiSelectProps = {
 export const FilterMultiSelect = ({
   trigger,
   children,
+  customMenuPopup,
   isOpen,
   defaultOpen,
   onOpenChange,
@@ -58,9 +61,11 @@ export const FilterMultiSelect = ({
   onSearchInputChange,
   triggerRef,
   className,
+  ...restProps
 }: FilterMultiSelectProps): JSX.Element => {
+  const MenuComponent = customMenuPopup ?? MenuPopup
   const menuTriggerProps = { isOpen, defaultOpen, onOpenChange, triggerRef }
-  const menuPopupProps = { isLoading, loadingSkeleton }
+  const menuPopupProps = { isLoading, loadingSkeleton, ...restProps }
   const disabledKeys: Selection = new Set(
     items?.filter((item) => item.isDisabled === true).map((disabledItem) => disabledItem.value),
   )
@@ -79,11 +84,11 @@ export const FilterMultiSelect = ({
     <MenuTriggerProvider {...menuTriggerProps}>
       <div className={className}>
         <MenuTriggerConsumer>{trigger}</MenuTriggerConsumer>
-        <MenuPopup {...menuPopupProps}>
+        <MenuComponent aria-label={label} {...menuPopupProps}>
           <SelectionProvider {...selectionProps}>
             <SelectionConsumer>{children}</SelectionConsumer>
           </SelectionProvider>
-        </MenuPopup>
+        </MenuComponent>
       </div>
     </MenuTriggerProvider>
   )
@@ -104,3 +109,4 @@ FilterMultiSelect.MenuFooter = MenuFooter // For layout
 FilterMultiSelect.MenuLoadingSkeleton = MenuLoadingSkeleton // Menu Loading Skeleton example
 FilterMultiSelect.LoadMoreButton = LoadMoreButton
 FilterMultiSelect.NoResults = NoResults
+FilterMultiSelect.ResponsiveMenuPopup = ResponsiveMenuPopup

package/src/Filter/FilterMultiSelect/_docs/FilterMultiSelect.mdx

@@ -1,4 +1,4 @@
-import { Controls, Meta, Canvas } from '@storybook/blocks'
+import { Controls, Meta, Canvas, DocsStory } from '@storybook/blocks'
 import { ResourceLinks, KAIOInstallation, NoClipCanvas } from '~storybook/components'
 import * as FilterMultiSelectStories from './FilterMultiSelect.stories'
 
@@ -30,6 +30,14 @@ The FilterMultiSelect is a component relies heavily on consumer implemntation. I
 
 <Canvas of={FilterMultiSelectStories.WithSectionHeaders} />
 
+### With customMenuPopup component
+
+You can replace the `MenuPopup` component within the FilterMultiSelect to allow flexibility in how the popup's placement is determined. While the default behavior should satisfy most scenarios, this can be used when there is limited vertical space available in the viewport.
+
+<Canvas of={FilterMultiSelectStories.AboveIfAvailable} />
+
+For convenience, a primitive called `ResponsiveMenuPopup` that can be accessed via dot notation that will automatically adjust the placement and size of the popup based on the available window height. This implementation uses `floating-ui` and the [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API) instead of `react-aria` hooks. It also locks scroll when the popup is active.
+
 ### Async
 
 The following is an example of how you may create an async FilterMultiSelect using `@tanstack/react-query`.

package/src/Filter/FilterMultiSelect/_docs/FilterMultiSelect.stories.tsx

@@ -1,11 +1,12 @@
 import React, { useState } from 'react'
 import type { Selection } from '@react-types/shared'
 import type { Meta, StoryObj } from '@storybook/react'
+import { expect, userEvent, waitFor, within } from '@storybook/test'
 import isChromatic from 'chromatic'
 import { InlineNotification } from '~components/Notification'
 import { TextField } from '~components/TextField'
 import { FilterMultiSelect, getSelectedOptionLabels } from '..'
-import { mockItems } from './MockData'
+import { mockItems, mockManyItems } from './MockData'
 
 const IS_CHROMATIC = isChromatic()
 
@@ -14,7 +15,7 @@ const meta = {
   component: FilterMultiSelect,
   parameters: {
     docs: {
-      source: { type: 'code' },
+      source: { type: 'auto' },
     },
   },
   args: {
@@ -178,6 +179,7 @@ export const WithSectionHeaders: Story = {
   ...FilterMultiSelectTemplate,
   args: {
     isOpen: IS_CHROMATIC || undefined,
+    items: mockManyItems,
     children: (): JSX.Element => (
       <>
         <FilterMultiSelect.SearchInput />
@@ -308,3 +310,78 @@ export const WithSectionNotification: Story = {
     chromatic: { disable: false },
   },
 }
+
+const sourceCode = `
+  <FilterMultiSelect
+    {...filterMultiSelectProps}
+    customMenuPopup={(props): JSX.Element => (
+      // This will replace the default MenuPopup with a custom one. The rest of the component should still be implemented as the FilterMultiSelect pattern.
+      <FilterMultiSelect.ResponsiveMenuPopup {...props} />
+    )}
+  >
+    {/* FilterMultiSelect children */}
+  </FilterMultiSelect>
+`
+
+export const AboveIfAvailable: Story = {
+  ...WithSectionNotification,
+  name: 'With customMenuPopup and vertical placement',
+  parameters: {
+    viewport: {
+      viewports: {
+        LimitedViewportAutoPlace: {
+          name: 'Limited vertical space',
+          styles: {
+            width: '1024px',
+            height: '650px',
+          },
+        },
+      },
+      defaultViewport: 'LimitedViewportAutoPlace',
+    },
+    docs: { source: { code: sourceCode } },
+  },
+  args: {
+    customMenuPopup: (props): JSX.Element => <FilterMultiSelect.ResponsiveMenuPopup {...props} />,
+  },
+  decorators: [
+    (Story) => (
+      <div>
+        <div style={{ height: '80vh', maxHeight: '500px' }}>Content above</div>
+        <Story />
+      </div>
+    ),
+  ],
+}
+
+export const ShouldResize: Story = {
+  ...AboveIfAvailable,
+  name: 'With customMenuPopup, vertical placement and resized popup',
+  parameters: {
+    chromatic: {
+      disable: false,
+    },
+    viewport: {
+      viewports: {
+        LimitedViewportAutoPlace: {
+          name: 'Limited vertical space',
+          styles: {
+            width: '1024px',
+            height: '450px',
+          },
+        },
+      },
+      defaultViewport: 'LimitedViewportAutoPlace',
+    },
+  },
+  play: async ({ canvasElement, step }) => {
+    const canvas = within(canvasElement.parentElement!)
+    const triggerButton = await canvas.findByRole('button', {
+      name: /Engineer/i,
+    })
+    await step('Trigger opens the FilterMultiSelect dialog', async () => {
+      await userEvent.click(triggerButton)
+      await waitFor(() => expect(canvas.getByRole('dialog')).toBeVisible())
+    })
+  },
+}

package/src/Filter/FilterMultiSelect/_docs/MockData.ts

@@ -58,3 +58,42 @@ export const locationDemographicValues = [
     label: 'London',
   },
 ]
+
+export const mockManyItems: ItemType[] = [
+  { label: 'Front-End', value: 'id-fe', count: '1245' },
+  { label: 'Back-End', value: 'id-be', count: '4', isDisabled: true },
+  { label: 'SRE', value: 'id-sre', count: '4', isDisabled: true },
+  { label: 'Dev-ops', value: 'id-devops' },
+  { label: 'Others', value: 'id-others' },
+  {
+    label: 'Engineer-type-1 has a really really long label',
+    value: 'id-type-1',
+  },
+  {
+    label: 'Engineer-type-2 also has a really really long label',
+    value: 'id-type-2',
+    count: '156',
+  },
+  { label: 'Engineer-type-3', value: 'id-type-3' },
+  {
+    label: 'Engineer-type-4',
+    value: 'id-type-4',
+    count: '4',
+    isDisabled: true,
+  },
+  { label: 'Engineer-type-5', value: 'id-type-5' },
+  { label: 'UI Designer', value: 'id-ui', count: '42' },
+  { label: 'UX Researcher', value: 'id-ux', count: '15' },
+  { label: 'Product Manager', value: 'id-pm', count: '28' },
+  { label: 'Project Manager', value: 'id-project', count: '19', isDisabled: true },
+  { label: 'Data Scientist', value: 'id-ds', count: '11' },
+  { label: 'Machine Learning Engineer', value: 'id-ml', count: '7' },
+  { label: 'QA Tester', value: 'id-qa', count: '22' },
+  {
+    label: 'Technical Writer with documentation expertise',
+    value: 'id-tech-writer',
+    count: '5',
+  },
+  { label: 'DevSecOps Engineer', value: 'id-devsecops', count: '3', isDisabled: true },
+  { label: 'Cloud Architect', value: 'id-cloud', count: '8' },
+]

package/src/Filter/FilterMultiSelect/context/MenuTriggerProvider/MenuTriggerProvider.spec.tsx

@@ -1,7 +1,6 @@
 import React from 'react'
 import { render, screen, waitFor } from '@testing-library/react'
 import userEvent from '@testing-library/user-event'
-import { vi } from 'vitest'
 import { FilterTriggerButton } from '~components/Filter/FilterMultiSelect/subcomponents/Trigger'
 import { MenuPopup } from '../../subcomponents/MenuPopup'
 import { MenuTriggerProvider, type MenuTriggerProviderProps } from './MenuTriggerProvider'
@@ -53,15 +52,11 @@ describe('<MenuTriggerProvider /> - Visual content', () => {
       rerender(<MenuTriggerProviderWrapper isOpen={false} />)
       expect(screen.queryByText('menu-content-mock')).not.toBeInTheDocument()
     })
-
-    it('fires the onOpenChange callback when the trigger is interacted', async () => {
+    it('fires the onOpenChange callback on user interaction to close the menu', async () => {
       const onOpenChange = vi.fn()
       render(<MenuTriggerProviderWrapper isOpen onOpenChange={onOpenChange} />)
 
-      const trigger = screen.getByRole('button', {
-        name: 'trigger-display-label-mock',
-      })
-      await user.click(trigger)
+      await user.keyboard('{Escape}')
 
       await waitFor(() => {
         expect(onOpenChange).toBeCalledTimes(1)
@@ -86,17 +81,6 @@ describe('<MenuTriggerProvider /> - Mouse interaction', () => {
   })
 
   describe('Given the menu is opened', () => {
-    it('is closed when user clicks on the trigger', async () => {
-      render(<MenuTriggerProviderWrapper defaultOpen />)
-      const trigger = screen.getByRole('button', {
-        name: 'trigger-display-label-mock',
-      })
-      await user.click(trigger)
-      await waitFor(() => {
-        expect(screen.queryByText('menu-content-mock')).not.toBeInTheDocument()
-      })
-    })
-
     it('is closed when user clicks outside of the menu', async () => {
       render(<MenuTriggerProviderWrapper defaultOpen />)
       await user.click(document.body)

package/src/Filter/FilterMultiSelect/subcomponents/ListBox/ListBox.module.css

@@ -0,0 +1,20 @@
+.listBox {
+  list-style: none;
+  padding: var(--spacing-12);
+  margin: 0 var(--spacing-12) 0 0;
+  display: grid;
+  max-height: 22rem;
+  overflow-y: auto;
+}
+
+.overflown {
+  padding-right: var(--spacing-12);
+}
+
+.hidden {
+  display: none;
+}
+
+.noResultsWrapper {
+  list-style: none;
+}

package/src/Filter/FilterMultiSelect/subcomponents/ListBox/ListBox.tsx

@@ -3,7 +3,7 @@ import { type Collection, type Key } from '@react-types/shared'
 import classnames from 'classnames'
 import { useSelectionContext } from '../../context/SelectionProvider'
 import { type MultiSelectItem } from '../../types'
-import styles from './ListBox.module.scss'
+import styles from './ListBox.module.css'
 
 export type ListBoxItems = {
   selectedItems: MultiSelectItem[]

package/src/Filter/FilterMultiSelect/subcomponents/ListBoxSection/ListBoxSection.module.scss

@@ -9,6 +9,7 @@
 }
 
 .listBoxSectionHeader {
+  position: relative; // this is needed to ensure the VisuallyHidden element doesn't impact the scroll height of the list
   font-family: $typography-heading-6-font-family;
   font-size: $typography-heading-6-font-size;
   font-weight: $typography-heading-6-font-weight;

package/src/Filter/FilterMultiSelect/subcomponents/MenuPopup/MenuPopup.module.css

@@ -0,0 +1,20 @@
+.menuPopup {
+  /* from $ca-z-index-dropdown */
+  z-index: 1000;
+  box-sizing: border-box;
+  background: var(--color-white);
+  color: var(--color-purple-800);
+  border-radius: var(--border-solid-border-radius);
+  box-shadow: var(--shadow-large-box-shadow);
+  padding: var(--spacing-12) 0;
+  margin-top: var(--spacing-6);
+  text-align: start;
+  width: var(--menu-container-width, 294px);
+  max-height: var(--menu-container-height, 500px);
+}
+
+.menuPopup[popover]:popover-open {
+  z-index: unset;
+  margin: 0;
+  inset: unset;
+}

package/src/Filter/FilterMultiSelect/subcomponents/MenuPopup/MenuPopup.tsx

@@ -2,7 +2,7 @@ import React from 'react'
 import { FocusScope } from '@react-aria/focus'
 import { DismissButton, useOverlay } from '@react-aria/overlays'
 import { useMenuTriggerContext } from '../../context'
-import styles from './MenuPopup.module.scss'
+import styles from './MenuPopup.module.css'
 
 export type MenuPopupProps = {
   isLoading?: boolean

package/src/Filter/FilterMultiSelect/subcomponents/MenuPopup/ResponsiveMenuPopup.tsx

@@ -0,0 +1,115 @@
+import React, { useEffect, useState, type HTMLAttributes } from 'react'
+import {
+  autoPlacement,
+  autoUpdate,
+  offset,
+  size,
+  useFloating,
+  type UseFloatingOptions,
+} from '@floating-ui/react-dom'
+import classnames from 'classnames'
+import { FocusOn } from 'react-focus-on'
+import { type OverrideClassName } from '~components/types/OverrideClassName'
+import { useMenuTriggerContext } from '../../context'
+import { type MenuPopupProps } from './MenuPopup'
+import styles from './MenuPopup.module.css'
+
+export type FloatingConfig = Pick<
+  UseFloatingOptions,
+  'placement' | 'strategy' | 'whileElementsMounted'
+> & {
+  /** Whether the component should automatically resize based on the available window height.
+   * @default true
+   */
+  shouldResize?: boolean
+  /** Whether the component should automatically flip to the top of the input based on the available window height.
+   * @default true
+   */
+  shouldFlip?: boolean
+}
+
+export type ResponsiveMenuPopupProps = MenuPopupProps & {
+  floatingConfig?: FloatingConfig
+} & OverrideClassName<HTMLAttributes<HTMLDivElement>>
+
+/** This is a popup primitive that can be used with the FilterMultiSelect when there are overflow issues with the original implementation. This uses the floating-ui */
+export const ResponsiveMenuPopup = ({
+  children,
+  floatingConfig = {
+    placement: 'bottom-start',
+    strategy: 'absolute',
+    whileElementsMounted: autoUpdate,
+    shouldFlip: true,
+    shouldResize: true,
+  },
+  classNameOverride,
+  isLoading,
+  loadingSkeleton,
+  ...restProps
+}: ResponsiveMenuPopupProps): JSX.Element => {
+  const [floatingElement, setFloatingElement] = useState<HTMLDivElement | null>(null)
+  const { menuTriggerState, buttonRef } = useMenuTriggerContext()
+  const referenceElement = buttonRef.current
+
+  const { floatingStyles, update } = useFloating({
+    elements: {
+      reference: referenceElement,
+      floating: floatingElement,
+    },
+    middleware: [
+      offset(6),
+      floatingConfig.shouldFlip &&
+        autoPlacement({ allowedPlacements: ['bottom-start', 'top-start'] }),
+      floatingConfig.shouldResize &&
+        size({
+          apply({ availableHeight, elements }) {
+            Object.assign(elements.floating.style, {
+              maxHeight: Math.max(250, Math.min(availableHeight - 12, 500)) + 'px',
+            })
+          },
+        }),
+    ],
+    ...floatingConfig,
+  })
+
+  const handleReturnFocus = (): void => {
+    requestAnimationFrame(() => {
+      buttonRef.current?.focus()
+    })
+  }
+
+  useEffect(() => {
+    if (floatingElement && referenceElement) {
+      floatingElement.showPopover?.()
+      update()
+    }
+  }, [floatingElement, referenceElement, update])
+
+  return menuTriggerState.isOpen ? (
+    <FocusOn
+      enabled={menuTriggerState.isOpen}
+      scrollLock={true}
+      returnFocus={false}
+      onClickOutside={menuTriggerState.close}
+      onEscapeKey={menuTriggerState.close}
+      onDeactivation={handleReturnFocus}
+    >
+      <div
+        ref={setFloatingElement}
+        style={floatingStyles}
+        className={classnames(styles.menuPopup, classNameOverride)}
+        role="dialog"
+        aria-modal="true"
+        // @ts-expect-error: popover is valid in supported browsers
+        popover="manual"
+        {...restProps}
+      >
+        {isLoading && loadingSkeleton ? loadingSkeleton : children}
+      </div>
+    </FocusOn>
+  ) : (
+    <></>
+  )
+}
+
+ResponsiveMenuPopup.displayName = 'FilterMultiSelect.ResponsiveMenuPopup'

package/src/Filter/FilterMultiSelect/subcomponents/MenuPopup/index.ts

@@ -1 +1,2 @@
 export * from './MenuPopup'
+export * from './ResponsiveMenuPopup'

package/src/LikertScaleLegacy/LikertScaleLegacy.spec.tsx

@@ -36,6 +36,7 @@ const LikertScaleLegacyWrapper = (props: Partial<LikertScaleProps>): JSX.Element
     labelId="test__likert-scale"
     selectedItem={null}
     onSelect={(): void => undefined}
+    isRequired
     {...props}
   />
 )

package/src/LikertScaleLegacy/LikertScaleLegacy.tsx

@@ -25,6 +25,10 @@ export type LikertScaleProps = {
   'colorSchema'?: ColorSchema | 'classical'
   'validationMessage'?: string
   'status'?: 'default' | 'error'
+  /**
+   * Sets aria-required value on radiogroup for assistive technologies. Validation must still be handled.
+   */
+  'isRequired'?: boolean
   'onSelect': (value: ScaleItem | null) => void
 }
 
@@ -46,6 +50,7 @@ export const LikertScaleLegacy = ({
   validationMessage,
   status,
   labelId,
+  isRequired,
 }: LikertScaleProps): JSX.Element => {
   const [hoveredItem, setHoveredItem] = useState<ScaleItem | null>(null)
   const itemRefs: ItemRefs = scale.map((s) => ({
@@ -104,11 +109,12 @@ export const LikertScaleLegacy = ({
         reversed && [styles.reversed],
         hoveredItem !== null && styles.hovered,
       )}
-      aria-labelledby={labelId}
+      aria-labelledby={isRequired ? `${labelId}` : labelId}
       role="radiogroup"
       tabIndex={-1}
       aria-describedby={validationMessageId}
       data-testid={dataTestId}
+      aria-required={isRequired}
     >
       <div className={styles.legend} data-testid={dataTestId && `${dataTestId}-legend`}>
         <Text variant="small" color={reversed ? 'white' : 'dark'}>

package/src/LikertScaleLegacy/_docs/LikertScaleLegacy.mdx

@@ -21,3 +21,11 @@ Likert scale radio buttons let people select one option in a Likert scale rangin
 
 <Canvas of={LikertScaleLegacyStories.Playground} />
 <Controls of={LikertScaleLegacyStories.Playground} />
+
+## API
+
+### isRequired
+
+Sets aria-required value on radiogroup for assistive technologies. An accessible label must be provided and validation must still be handled within implementations.
+
+<Canvas of={LikertScaleLegacyStories.IsRequired} />