@kaizen/components 0.0.0-canary-update-floating-fms-20250715035144 → 0.0.0-canary-handle-avatar-error-20250716233812

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

@@ -0,0 +1,24 @@
+@import '~@kaizen/design-tokens/sass/spacing';
+@import '~@kaizen/design-tokens/sass/shadow';
+@import '~@kaizen/design-tokens/sass/border';
+@import '~@kaizen/design-tokens/sass/color';
+
+@layer kz-components {
+  // figma hard coded: https://www.figma.com/file/eZKEE5kXbEMY3lx84oz8iN/%E2%9D%A4%EF%B8%8F-UI-Kit%3A-Heart?node-id=22814%3A96966
+  $menu-container-width: 294px;
+  $menu-container-max-height: 312px;
+
+  .menuPopup {
+    position: absolute;
+    z-index: 1000; // from $ca-z-index-dropdown
+    box-sizing: border-box;
+    background: $color-white;
+    color: $color-purple-800;
+    border-radius: $border-solid-border-radius;
+    box-shadow: $shadow-large-box-shadow;
+    padding: $spacing-sm 0;
+    margin-top: $spacing-xs;
+    text-align: start;
+    width: $menu-container-width;
+  }
+}

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

@@ -1,105 +1,58 @@
-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 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.css'
-
-export type FloatingConfig = Pick<
-  UseFloatingOptions,
-  'placement' | 'strategy' | 'whileElementsMounted'
-> & {
-  shouldResize?: boolean
-  shouldFlip?: boolean
-}
+import styles from './MenuPopup.module.scss'
 
 export type MenuPopupProps = {
-  children: React.ReactNode
   isLoading?: boolean
   loadingSkeleton?: React.ReactNode
-  floatingConfig?: FloatingConfig
-} & OverrideClassName<HTMLAttributes<HTMLDivElement>>
+  children: React.ReactNode
+}
 
 export const MenuPopup = ({
-  children,
-  floatingConfig = {
-    placement: 'bottom-start',
-    strategy: 'absolute',
-    whileElementsMounted: autoUpdate,
-  },
-  classNameOverride,
   isLoading,
   loadingSkeleton,
-  ...restProps
+  children,
 }: MenuPopupProps): 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,
+  const { menuTriggerState } = useMenuTriggerContext()
+
+  const onClose = (): void => menuTriggerState.close()
+
+  // Handle events that should cause the menu to close,
+  // e.g. blur, clicking outside, or pressing the escape key.
+  const overlayRef = React.createRef<HTMLDivElement>()
+  const { overlayProps } = useOverlay(
+    {
+      onClose,
+      isOpen: menuTriggerState.isOpen,
+      isDismissable: true,
     },
-    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])
+    overlayRef,
+  )
 
+  // Wrap in <FocusScope> so that focus is restored back to the trigger when the menu is closed
+  // and auto focus on the first focusable item after loading. (disable eslint no-autofocus error for it)
+  // In addition, add hidden <DismissButton> components at the start and end of the list
+  // to allow screen reader users to dismiss the popup easily.
   return menuTriggerState.isOpen ? (
-    <FocusOn
-      enabled={menuTriggerState.isOpen}
-      scrollLock={false}
-      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>
+    <div {...overlayProps} ref={overlayRef} className={styles.menuPopup}>
+      {isLoading && loadingSkeleton ? (
+        <>
+          <DismissButton onDismiss={onClose} />
+          {loadingSkeleton}
+          <DismissButton onDismiss={onClose} />
+        </>
+      ) : (
+        // eslint-disable-next-line jsx-a11y/no-autofocus
+        <FocusScope contain autoFocus restoreFocus>
+          <DismissButton onDismiss={onClose} />
+
+          {children}
+          <DismissButton onDismiss={onClose} />
+        </FocusScope>
+      )}
+    </div>
   ) : (
     <></>
   )

package/src/LikertScaleLegacy/LikertScaleLegacy.tsx

@@ -37,6 +37,9 @@ const SelectedItemIcon = (): JSX.Element => (
 )
 
 /**
+ * @deprecated This component will be renamed to LikertScale in v2.
+ * Start importing as LikertScale instead.
+ *
  * {@link https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3082060201/Likert+Scale Guidance} |
  * {@link https://cultureamp.design/?path=/docs/components-likertscalelegacy--docs Storybook}
  */

package/src/LikertScaleLegacy/_docs/LikertScaleLegacy.mdx

@@ -1,5 +1,5 @@
 import { Canvas, Controls, Meta } from '@storybook/blocks'
-import { ResourceLinks, KAIOInstallation } from '~storybook/components'
+import { ResourceLinks, KAIOInstallation, RenameNotice } from '~storybook/components'
 import * as LikertScaleLegacyStories from './LikertScaleLegacy.stories'
 
 <Meta of={LikertScaleLegacyStories} />
@@ -10,9 +10,10 @@ import * as LikertScaleLegacyStories from './LikertScaleLegacy.stories'
   sourceCode="https://github.com/cultureamp/kaizen-design-system/tree/main/packages/components/src/LikertScaleLegacy"
   figma="https://www.figma.com/file/ZRfnoNUXbGZv4eVWLbF4Az/%EF%B8%8F%F0%9F%96%BC%EF%B8%8F-Component-Gallery?node-id=9%3A39905&t=P1w10jr2cpPuaayw-1"
   designGuidelines="https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3082060201/Likert+Scale"
-
 />
 
+<RenameNotice />
+
 <KAIOInstallation exportNames="LikertScaleLegacy" />
 
 ## Overview

package/src/LikertScaleLegacy/_docs/LikertScaleLegacy.stickersheet.stories.tsx

@@ -5,7 +5,7 @@ import { LikertScaleLegacy, type LikertScaleProps } from '../index'
 import { type Scale } from '../types'
 
 export default {
-  title: 'Components/LikertScaleLegacy',
+  title: 'Components/LikertScaleLegacy (deprecated)',
   parameters: {
     chromatic: { disable: false },
     controls: { disable: true },

package/src/LikertScaleLegacy/_docs/LikertScaleLegacy.stories.tsx

@@ -33,7 +33,7 @@ const scale: Scale = [
 ]
 
 const meta = {
-  title: 'Components/LikertScaleLegacy',
+  title: 'Components/LikertScaleLegacy (deprecated)',
   component: LikertScaleLegacy,
   args: {
     scale,

package/src/Modal/GenericModal/GenericModal.tsx

@@ -3,6 +3,7 @@ import { createPortal } from 'react-dom'
 import { Transition } from '@headlessui/react'
 import classnames from 'classnames'
 import FocusLock from 'react-focus-lock'
+import { useIsClientReady } from '../../utils/useIsClientReady'
 import { warn } from '../util/console'
 import { ModalContext } from './context/ModalContext'
 import styles from './GenericModal.module.scss'
@@ -38,6 +39,8 @@ export const GenericModal = ({
   const labelledByID = useId()
   const describedByID = useId()
 
+  const isClientReady = useIsClientReady()
+
   const [scrollLayer, setScrollLayer] = useState<HTMLDivElement | null>(null)
   const [modalLayer, setModalLayer] = useState<HTMLDivElement | null>(null)
 
@@ -58,6 +61,8 @@ export const GenericModal = ({
   }
 
   const focusOnAccessibleLabel = (): void => {
+    if (!isClientReady) return
+
     // Check if focus already exists within the modal
     if (modalLayer?.contains(document.activeElement)) {
       return
@@ -69,6 +74,8 @@ export const GenericModal = ({
   }
 
   const a11yWarn = (): void => {
+    if (!isClientReady) return
+
     // Ensure that consumers have provided an element that labels the modal
     // to meet ARIA accessibility guidelines.
     if (!document.getElementById(labelledByID)) {
@@ -80,6 +87,8 @@ export const GenericModal = ({
   }
 
   const preventBodyScroll = (): void => {
+    if (!isClientReady) return
+
     const hasScrollbar = window.innerWidth > document.documentElement.clientWidth
     const scrollStyles = [styles.unscrollable]
 
@@ -111,12 +120,14 @@ export const GenericModal = ({
   const onBeforeEnterHandler = (): void => {
     preventBodyScroll()
 
-    if (onEscapeKeyup) {
+    if (onEscapeKeyup && isClientReady) {
       document.addEventListener('keyup', escapeKeyHandler)
     }
   }
 
   const cleanUpAfterClose = (): void => {
+    if (!isClientReady) return
+
     document.documentElement.classList.remove(styles.unscrollable, styles.pseudoScrollbar)
 
     if (onEscapeKeyup) {
@@ -133,6 +144,12 @@ export const GenericModal = ({
     cleanUpAfterClose()
     propsOnAfterLeave?.()
   }
+
+  // Don't render portal during SSR
+  if (!isClientReady) {
+    return <></>
+  }
+
   return createPortal(
     <Transition
       appear={true}

package/src/Skirt/Skirt.tsx

@@ -17,6 +17,10 @@ export type SkirtProps = {
   titleBlockHasNavigation?: boolean
 } & ContentProps
 
+/**
+ * @deprecated This component will be removed in v2. Please remove any usages.
+ */
+
 export const Skirt = ({
   children,
   variant = 'default',

package/src/Skirt/_docs/Skirt.mdx

@@ -1,5 +1,5 @@
 import { Canvas, Controls, Meta } from '@storybook/blocks'
-import { ResourceLinks, KAIOInstallation } from '~storybook/components'
+import { ResourceLinks, KAIOInstallation, RemovalNotice } from '~storybook/components'
 import * as SkirtStories from './Skirt.stories'
 
 <Meta of={SkirtStories} />
@@ -13,6 +13,8 @@ import * as SkirtStories from './Skirt.stories'
 
 />
 
+<RemovalNotice />
+
 <KAIOInstallation exportNames={['Skirt', 'SkirtCard']} />
 
 ## Overview

package/src/Skirt/_docs/Skirt.stories.tsx

@@ -5,7 +5,7 @@ import { Skirt } from '../index'
 import { SkirtCard } from '../subcomponents/SkirtCard'
 
 const meta = {
-  title: 'Components/Skirt',
+  title: 'Components/Skirt (deprecated)',
   component: Skirt,
   args: {
     children: (

package/src/Skirt/subcomponents/SkirtCard/SkirtCard.tsx

@@ -5,6 +5,10 @@ import styles from './SkirtCard.module.scss'
 
 export type SkirtCardProps = CardProps
 
+/**
+ * @deprecated This component will be removed in v2. Use a regular Card component instead.
+ */
+
 export const SkirtCard = (props: SkirtCardProps): JSX.Element => {
   const { classNameOverride, ...restProps } = props
   return <Card classNameOverride={classnames(styles.wrapper, classNameOverride)} {...restProps} />

package/src/SplitButton/SplitButton.tsx

@@ -41,6 +41,8 @@ export type SplitButtonProps = {
 } & OverrideClassName<HTMLAttributes<HTMLDivElement>>
 
 /**
+ * @deprecated This component will be removed in v2. Use a Button and Menu component instead.
+ *
  * {@link https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3081896196/Split+Button Guidance} |
  * {@link https://cultureamp.design/storybook/?path=/docs/components-splitbutton--docs Storybook}
  */

package/src/SplitButton/_docs/SplitButton.mdx

@@ -1,5 +1,5 @@
 import { Canvas, Controls, DocsStory, Meta } from '@storybook/blocks'
-import { ResourceLinks, KAIOInstallation, LinkTo } from '~storybook/components'
+import { ResourceLinks, KAIOInstallation, LinkTo, RemovalNotice } from '~storybook/components'
 import * as SplitButtonStories from './SplitButton.stories'
 
 <Meta of={SplitButtonStories} />
@@ -13,6 +13,8 @@ import * as SplitButtonStories from './SplitButton.stories'
 
 />
 
+<RemovalNotice />
+
 <KAIOInstallation exportNames="SplitButton" />
 
 ## Overview

package/src/SplitButton/_docs/SplitButton.stickersheet.stories.tsx

@@ -9,7 +9,7 @@ import { StickerSheet, type StickerSheetStory } from '~storybook/components/Stic
 import { SplitButton, type SplitButtonProps } from '../index'
 
 export default {
-  title: 'Components/SplitButton',
+  title: 'Components/SplitButton (deprecated)',
   parameters: {
     chromatic: { disable: false },
     controls: { disable: true },

package/src/SplitButton/_docs/SplitButton.stories.tsx

@@ -8,7 +8,7 @@ import {
 import { SplitButton } from '../index'
 
 const meta = {
-  title: 'Components/SplitButton',
+  title: 'Components/SplitButton (deprecated)',
   component: SplitButton,
   argTypes: {
     actionButtonProps: {

package/src/TitleBlockZen/TitleBlockZen.tsx

@@ -228,6 +228,9 @@ const renderNavigationTabs = (
 )
 
 /**
+ * @deprecated This component will be renamed to TitleBlock in v2.
+ * Start importing as TitleBlock instead.
+ *
  * {@link https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3075605782/Title+Block Guidance} |
  * {@link https://cultureamp.design/?path=/story/components-titleblock--docs Storybook}
  */

package/src/TitleBlockZen/_docs/TitleBlockZen.mdx

@@ -1,5 +1,5 @@
 import { Canvas, Meta } from '@storybook/blocks'
-import { ResourceLinks, KAIOInstallation } from '~storybook/components'
+import { ResourceLinks, KAIOInstallation, RenameNotice } from '~storybook/components'
 import * as TitleBlockZenStories from './TitleBlockZen.stories'
 
 <Meta of={TitleBlockZenStories} />
@@ -9,9 +9,10 @@ import * as TitleBlockZenStories from './TitleBlockZen.stories'
 <ResourceLinks
   sourceCode="https://github.com/cultureamp/kaizen-design-system/tree/main/packages/components/src/TitleBlockZen"
   designGuidelines="https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3075605782/Title+Block"
-
 />
 
+<RenameNotice />
+
 <KAIOInstallation exportNames="TitleBlockZen" />
 
 ## Overview

package/src/__alpha__/SingleSelect/SingleSelect.module.css

@@ -0,0 +1,9 @@
+@layer kz-components {
+  .popover {
+    background-color: var(--color-white);
+    border-radius: var(--spacing-8);
+    padding: var(--spacing-8);
+    width: 200px;
+    box-shadow: var(--shadow-small-box-shadow);
+  }
+}

package/src/__alpha__/SingleSelect/SingleSelect.spec.tsx

@@ -0,0 +1,26 @@
+import React from 'react'
+import { render } from '@testing-library/react'
+import { SingleSelect } from './SingleSelect'
+import { singleMockItems } from './_docs/mockData'
+
+const SingleSelectWrapper = (): JSX.Element => (
+  <SingleSelect>
+    <SingleSelect.List>
+      {singleMockItems.map((item) => (
+        <SingleSelect.ListItem key={item.value} value={{ value: item.value }}>
+          {item.label}
+        </SingleSelect.ListItem>
+      ))}
+    </SingleSelect.List>
+  </SingleSelect>
+)
+
+describe('<SingleSelect />', () => {
+  describe('renders', () => {
+    it('a basic select component', () => {
+      const { getByRole } = render(<SingleSelectWrapper />)
+      const select = getByRole('button')
+      expect(select).toBeInTheDocument()
+    })
+  })
+})

package/src/__alpha__/SingleSelect/SingleSelect.tsx

@@ -0,0 +1,27 @@
+import React, { type HTMLAttributes, type PropsWithChildren } from 'react'
+import { Popover as RACPopover, Select as RACSelect } from 'react-aria-components'
+import { type OverrideClassName } from '~components/types/OverrideClassName'
+import { List, ListItem, ListSection, Trigger } from './subcomponents'
+import styles from './SingleSelect.module.css'
+
+export type SingleSelectProps = {
+  children?: React.ReactNode
+} & OverrideClassName<HTMLAttributes<Element>>
+
+export const SingleSelect = ({
+  classNameOverride,
+  children,
+  ...restProps
+}: PropsWithChildren<SingleSelectProps>): JSX.Element => {
+  return (
+    <RACSelect className={classNameOverride} placeholder="" {...restProps}>
+      <Trigger />
+      <RACPopover className={styles.popover}>{children}</RACPopover>
+    </RACSelect>
+  )
+}
+
+SingleSelect.displayName = 'SingleSelect'
+SingleSelect.List = List
+SingleSelect.ListItem = ListItem
+SingleSelect.ListSection = ListSection

package/src/__alpha__/SingleSelect/_docs/SingleSelect.mdx

@@ -0,0 +1,27 @@
+import { Canvas, Controls, DocsStory, Meta } from '@storybook/blocks'
+import { ResourceLinks, KAIOInstallation, AlphaNotice } from '~storybook/components'
+import * as SingleSelectStories from './SingleSelect.stories'
+
+<Meta of={SingleSelectStories} />
+
+# SingleSelect
+
+<ResourceLinks
+  sourceCode="https://github.com/cultureamp/kaizen-design-system/tree/main/packages/components/src/__alpha__/SingleSelect"
+  figma=""
+  designGuidelines=""
+/>
+
+<AlphaNotice />
+
+<KAIOInstallation exportNames="SingleSelect" isAlpha />
+
+## Overview
+
+{/* @todo: Update summary. */}
+Brief summary of the component here.
+
+<Canvas of={SingleSelectStories.Playground} />
+<Controls of={SingleSelectStories.Playground} />
+
+## API

package/src/__alpha__/SingleSelect/_docs/SingleSelect.stickersheet.stories.tsx

@@ -0,0 +1,83 @@
+import React from 'react'
+import { type Meta } from '@storybook/react'
+import { StickerSheet, type StickerSheetStory } from '~storybook/components/StickerSheet'
+import { SingleSelect } from '../index'
+import { groupedMockItems, singleMockItems } from './mockData'
+
+export default {
+  title: 'Components/SingleSelect/SingleSelect (alpha)',
+  parameters: {
+    chromatic: { disable: false },
+    controls: { disable: true },
+  },
+} satisfies Meta
+
+const StickerSheetTemplate: StickerSheetStory = {
+  render: ({ isReversed }) => {
+    return (
+      <StickerSheet isReversed={isReversed} title="SingleSelect" headers={['Items', 'Grouped']}>
+        <StickerSheet.Row>
+          <SingleSelect>
+            <SingleSelect.List>
+              {singleMockItems.map((item) => (
+                <SingleSelect.ListItem key={item.value} value={{ value: item.value }}>
+                  {item.label}
+                </SingleSelect.ListItem>
+              ))}
+            </SingleSelect.List>
+          </SingleSelect>
+
+          <SingleSelect>
+            <SingleSelect.List>
+              {groupedMockItems.map((section) => (
+                <SingleSelect.ListSection name={section.label} key={section.label}>
+                  {section.options.map((item) => (
+                    <SingleSelect.ListItem key={item.value} value={{ value: item.value }}>
+                      {item.label}
+                    </SingleSelect.ListItem>
+                  ))}
+                </SingleSelect.ListSection>
+              ))}
+            </SingleSelect.List>
+          </SingleSelect>
+        </StickerSheet.Row>
+      </StickerSheet>
+    )
+  },
+  /** @note: Only required if you have pseudo states, otherwise this can be removed */
+  parameters: {
+    /** @todo: Remove any inapplicable pseudo states */
+    pseudo: {
+      hover: '[data-sb-pseudo-styles="hover"]',
+      active: '[data-sb-pseudo-styles="active"]',
+      focus: '[data-sb-pseudo-styles="focus"]',
+      focusVisible: '[data-sb-pseudo-styles="focus"]',
+    },
+  },
+}
+
+export const StickerSheetDefault: StickerSheetStory = {
+  ...StickerSheetTemplate,
+  name: 'Sticker Sheet (Default)',
+}
+
+export const StickerSheetReversed: StickerSheetStory = {
+  ...StickerSheetTemplate,
+  name: 'Sticker Sheet (Reversed)',
+  parameters: {
+    /** @note: Only required if template has parameters, otherwise this spread can be removed */
+    ...StickerSheetTemplate.parameters,
+    backgrounds: { default: 'Purple 700' },
+  },
+  args: { isReversed: true },
+}
+
+export const StickerSheetRTL: StickerSheetStory = {
+  ...StickerSheetTemplate,
+  name: 'Sticker Sheet (RTL)',
+  parameters: {
+    /** @note: Only required if template has parameters, otherwise this spread can be removed */
+    ...StickerSheetTemplate.parameters,
+    textDirection: 'rtl',
+  },
+}

package/src/__alpha__/SingleSelect/_docs/SingleSelect.stories.tsx

@@ -0,0 +1,23 @@
+import { type Meta, type StoryObj } from '@storybook/react'
+import { SingleSelect } from '../index'
+
+const meta = {
+  title: 'Components/SingleSelect/SingleSelect (alpha)',
+  component: SingleSelect,
+  args: {},
+} satisfies Meta<typeof SingleSelect>
+
+export default meta
+
+type Story = StoryObj<typeof meta>
+
+export const Playground: Story = {
+  args: {},
+  parameters: {
+    docs: {
+      canvas: {
+        sourceState: 'shown',
+      },
+    },
+  },
+}