@kaizen/components 1.79.5 → 1.79.7

package/dist/types/Skirt/subcomponents/SkirtCard/SkirtCard.d.ts

@@ -1,5 +1,8 @@
 import { type CardProps } from "../../../Card";
 export type SkirtCardProps = CardProps;
+/**
+ * @deprecated This component will be removed in v2. Use a regular Card component instead.
+ */
 export declare const SkirtCard: {
     (props: SkirtCardProps): JSX.Element;
     displayName: string;

package/dist/types/SplitButton/SplitButton.d.ts

@@ -36,6 +36,8 @@ export type SplitButtonProps = {
     dir?: 'ltr' | 'rtl';
 } & 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/dist/types/TitleBlockZen/TitleBlockZen.d.ts

@@ -1,5 +1,8 @@
 import { type TitleBlockProps } from './types';
 /**
+ * @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/dist/types/__alpha__/SingleSelect/SingleSelect.d.ts

@@ -0,0 +1,23 @@
+import React, { type HTMLAttributes, type PropsWithChildren } from 'react';
+import { type OverrideClassName } from "../../types/OverrideClassName";
+export type SingleSelectProps = {
+    children?: React.ReactNode;
+} & OverrideClassName<HTMLAttributes<Element>>;
+export declare const SingleSelect: {
+    ({ classNameOverride, children, ...restProps }: PropsWithChildren<SingleSelectProps>): JSX.Element;
+    displayName: string;
+    List: {
+        ({ children, className, ...props }: import("react-aria-components").ListBoxProps<object> & PropsWithChildren): React.ReactElement;
+        displayName: string;
+    };
+    ListItem: {
+        ({ children, className, ...props }: import("react-aria-components").ListBoxItemProps<object> & PropsWithChildren): React.ReactElement;
+        displayName: string;
+    };
+    ListSection: {
+        ({ name, className, children, ...props }: import("react-aria-components").ListBoxSectionProps<object> & PropsWithChildren & {
+            name: string;
+        }): React.ReactElement;
+        displayName: string;
+    };
+};

package/dist/types/__alpha__/SingleSelect/_docs/mockData.d.ts

@@ -0,0 +1,59 @@
+export declare const singleMockItems: {
+    label: string;
+    value: string;
+}[];
+export declare const groupedMockItems: {
+    label: string;
+    options: {
+        label: string;
+        value: string;
+    }[];
+}[];
+export declare const mixedMockItemsDisabled: ({
+    label: string;
+    value: string;
+    disabled: boolean;
+    options?: undefined;
+} | {
+    label: string;
+    value: string;
+    disabled?: undefined;
+    options?: undefined;
+} | {
+    label: string;
+    options: ({
+        label: string;
+        value: string;
+        disabled?: undefined;
+    } | {
+        label: string;
+        value: string;
+        disabled: boolean;
+    })[];
+    value?: undefined;
+    disabled?: undefined;
+})[];
+export declare const mixedMockItemsUngroupedFirst: ({
+    label: string;
+    value: string;
+    options?: undefined;
+} | {
+    label: string;
+    options: {
+        label: string;
+        value: string;
+    }[];
+    value?: undefined;
+})[];
+export declare const mixedMockItemsUnordered: ({
+    label: string;
+    options: {
+        label: string;
+        value: string;
+    }[];
+    value?: undefined;
+} | {
+    label: string;
+    value: string;
+    options?: undefined;
+})[];

package/dist/types/__alpha__/SingleSelect/index.d.ts

@@ -0,0 +1 @@
+export * from './SingleSelect';

package/dist/types/__alpha__/SingleSelect/subcomponents/List/List.d.ts

@@ -0,0 +1,6 @@
+import React, { type PropsWithChildren } from 'react';
+import { type ListBoxProps } from 'react-aria-components';
+export declare const List: {
+    ({ children, className, ...props }: ListBoxProps<object> & PropsWithChildren): React.ReactElement;
+    displayName: string;
+};

package/dist/types/__alpha__/SingleSelect/subcomponents/List/index.d.ts

@@ -0,0 +1 @@
+export * from './List';

package/dist/types/__alpha__/SingleSelect/subcomponents/ListItem/ListItem.d.ts

@@ -0,0 +1,6 @@
+import React, { type PropsWithChildren } from 'react';
+import { type ListBoxItemProps } from 'react-aria-components';
+export declare const ListItem: {
+    ({ children, className, ...props }: ListBoxItemProps<object> & PropsWithChildren): React.ReactElement;
+    displayName: string;
+};

package/dist/types/__alpha__/SingleSelect/subcomponents/ListItem/index.d.ts

@@ -0,0 +1 @@
+export * from './ListItem';

package/dist/types/__alpha__/SingleSelect/subcomponents/ListSection/ListSection.d.ts

@@ -0,0 +1,8 @@
+import React, { type PropsWithChildren } from 'react';
+import { type ListBoxSectionProps } from 'react-aria-components';
+export declare const ListSection: {
+    ({ name, className, children, ...props }: ListBoxSectionProps<object> & PropsWithChildren & {
+        name: string;
+    }): React.ReactElement;
+    displayName: string;
+};

package/dist/types/__alpha__/SingleSelect/subcomponents/ListSection/index.d.ts

@@ -0,0 +1 @@
+export * from './ListSection';

package/dist/types/__alpha__/SingleSelect/subcomponents/Trigger/Trigger.d.ts

@@ -0,0 +1 @@
+export declare const Trigger: () => JSX.Element;

package/dist/types/__alpha__/SingleSelect/subcomponents/Trigger/index.d.ts

@@ -0,0 +1 @@
+export * from './Trigger';

package/dist/types/__alpha__/SingleSelect/subcomponents/index.d.ts

@@ -0,0 +1,4 @@
+export * from './List';
+export * from './ListSection';
+export * from './ListItem';
+export * from './Trigger';

package/dist/types/__alpha__/index.d.ts

@@ -0,0 +1 @@
+export * from './SingleSelect';

package/package.json

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

package/src/Button/Button/Button.tsx

@@ -5,6 +5,11 @@ import { GenericButton, type ButtonRef, type GenericButtonProps } from '../Gener
 export type ButtonProps = GenericButtonProps
 
 /**
+ * @deprecated This component will be replaced by the next Button component in v2.
+ * Use `@kaizen/components/next` Button instead.
+ * Migration guide: {@link https://cultureamp.design/?path=/docs/components-button-migration-guide--docs}
+ * Codemod available: `upgradeV1Buttons`
+ *
  * {@link https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3062890984/Button Guidance} |
  * {@link https://cultureamp.design/?path=/docs/components-buttons-button--docs Storybook}
  */

package/src/Button/IconButton/IconButton.tsx

@@ -9,6 +9,11 @@ import {
 export type IconButtonProps = Omit<BaseButtonProps, 'iconPosition'> & WorkingButtonProps
 
 /**
+ * @deprecated This component will be replaced by the next Button component in v2.
+ * Use `@kaizen/components/next` Button instead.
+ * Migration guide: {@link https://cultureamp.design/?path=/docs/components-button-migration-guide--docs}
+ * Codemod available: `upgradeV1Buttons`
+ *
  * {@link https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3062890984/Button Guidance} |
  * {@link https://cultureamp.design/?path=/docs/components-iconbutton--docs Storybook}
  */

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/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',
+      },
+    },
+  },
+}