@kaizen/components 1.42.5 → 1.42.7

package/src/__future__/Tag/Tag/_docs/Tag-migration-guide.stories.tsx

@@ -0,0 +1,328 @@
+import React from "react"
+import { Meta, StoryObj } from "@storybook/react"
+import { fn } from "@storybook/test"
+import { Avatar } from "~components/Avatar"
+import {
+  CautionIcon,
+  ExclamationIcon,
+  InformationIcon,
+  SuccessIcon,
+  LiveIcon,
+} from "~components/Icon"
+import styles from "~components/Tag/Tag.module.scss"
+import { Tag, RemovableTag } from "../.."
+
+const meta = {
+  title: "Components/Tag/Future Tag Migration Guide",
+  component: Tag,
+  args: {
+    children: "My tag",
+  },
+  parameters: {
+    docs: {
+      source: {
+        type: "dynamic",
+      },
+    },
+  },
+} satisfies Meta<typeof Tag>
+
+export default meta
+
+/** * This is a stand-in component for the legacy Tag's bake in LiveIcon - we should consider adding this as an actual component or replacing it */
+const LiveIconComponent = (): JSX.Element => (
+  <span className={styles.liveIcon}>
+    <LiveIcon
+      role="presentation"
+      classNameOverride={styles.liveIcon_base}
+      width="16"
+      height="16"
+      viewBox="0 0 16 16"
+      fill="none"
+    />
+    <LiveIcon
+      role="presentation"
+      classNameOverride={styles.liveIcon_1}
+      width="16"
+      height="16"
+      viewBox="0 0 16 16"
+      fill="none"
+    />
+    <LiveIcon
+      role="presentation"
+      classNameOverride={styles.liveIcon_2}
+      width="16"
+      height="16"
+      viewBox="0 0 16 16"
+      fill="none"
+    />
+    <LiveIcon
+      role="presentation"
+      classNameOverride={styles.liveIcon_3}
+      width="16"
+      height="16"
+      viewBox="0 0 16 16"
+      fill="none"
+    />
+  </span>
+)
+
+export const LiveIconComponentStory: StoryObj = {
+  render: () => <LiveIconComponent />,
+  parameters: {
+    docs: {
+      source: {
+        type: "dynamic",
+        code: `
+  // component with styled with CSS modules
+  const LiveIconComponent = (): JSX.Element => (
+    <span className={styles.liveIcon}>
+      <LiveIcon
+        role="presentation"
+        classNameOverride={styles.liveIcon_base}
+        width="16"
+        height="16"
+        viewBox="0 0 16 16"
+        fill="none"
+      />
+      <LiveIcon
+        role="presentation"
+        classNameOverride={styles.liveIcon_1}
+        width="16"
+        height="16"
+        viewBox="0 0 16 16"
+        fill="none"
+      />
+      <LiveIcon
+        role="presentation"
+        classNameOverride={styles.liveIcon_2}
+        width="16"
+        height="16"
+        viewBox="0 0 16 16"
+        fill="none"
+      />
+      <LiveIcon
+        role="presentation"
+        classNameOverride={styles.liveIcon_3}
+        width="16"
+        height="16"
+        viewBox="0 0 16 16"
+        fill="none"
+      />
+    </span>
+  )
+
+  // Minified SCSS from the stylesheet
+  <style>
+    .liveIcon_2,.liveIcon_3{animation-duration:3s;animation-iteration-count:3;animation-delay:1s}.liveIcon{display:inline-block;position:relative;width:20px;height:20px;color:$color-green-500}.liveIcon_1,.liveIcon_2,.liveIcon_3{display:block;position:absolute;top:0;left:$0;width:100%;height:100%;overflow:hidden}.liveIcon_base{opacity:30%;display:block}.liveIcon_1{clip-path:circle(16%)}.liveIcon_2{clip-path:circle(32%);animation-name:pulse-inner}.liveIcon_3{clip-path:circle(50%);animation-name:pulse-outer}@keyframes pulse-inner{0%,25%{opacity:0%}100%,50%,75%{opacity:100%}}@keyframes pulse-outer{0%,25%,50%{opacity:0%}100%,75%{opacity:100%}}
+  </style>
+        `,
+      },
+    },
+  },
+}
+
+export const StatusMigration: StoryObj = {
+  render: () => (
+    <>
+      <Tag classNameOverride="gap-4" color="green">
+        <span>Tag</span>
+        <LiveIconComponent />
+      </Tag>
+      <Tag color="blue">Tag</Tag>
+      <Tag color="red">Tag</Tag>
+      <Tag color="orange">Tag</Tag>
+    </>
+  ),
+  decorators: [
+    Story => (
+      <div className="flex gap-12">
+        <Story />
+      </div>
+    ),
+  ],
+}
+
+export const ValidationMigration: StoryObj = {
+  render: () => (
+    <>
+      <Tag
+        color="green"
+        icon={<SuccessIcon role="img" aria-label="Success," />}
+      >
+        Tag
+      </Tag>
+      <Tag
+        color="blue"
+        icon={<InformationIcon role="img" aria-label="Note," />}
+      >
+        Tag
+      </Tag>
+      <Tag
+        color="red"
+        icon={<ExclamationIcon role="img" aria-label="Error," />}
+      >
+        Tag
+      </Tag>
+      <Tag
+        color="yellow"
+        icon={<CautionIcon role="img" aria-label="Warning," />}
+      >
+        Tag
+      </Tag>
+    </>
+  ),
+  decorators: [
+    Story => (
+      <div className="flex gap-12">
+        <Story />
+      </div>
+    ),
+  ],
+}
+
+export const SentimentsMigration: StoryObj = {
+  render: () => (
+    <>
+      <Tag color="green">Tag</Tag>
+      <Tag color="gray">Tag</Tag>
+      <Tag color="red">Tag</Tag>
+      <Tag color="blue">Tag</Tag>
+      <Tag color="yellow">Tag</Tag>
+      <Tag color="orange">Tag</Tag>
+    </>
+  ),
+  decorators: [
+    Story => (
+      <div className="flex gap-12">
+        <Story />
+      </div>
+    ),
+  ],
+}
+
+export const SentimentNone: StoryObj = {
+  render: () => (
+    <Tag
+      color="gray"
+      classNameOverride="bg-white border-default-color border-solid border"
+    >
+      Tag
+    </Tag>
+  ),
+}
+
+export const DismissibleMigration: StoryObj = {
+  render: () => (
+    <RemovableTag
+      removeButtonProps={{
+        ariaLabel: "Remove this tag",
+        onClick: fn(),
+      }}
+    >
+      Tag
+    </RemovableTag>
+  ),
+}
+
+export const AvatarMigration: StoryObj = {
+  render: () => (
+    <>
+      <Tag classNameOverride="ps-4">
+        <span className="flex gap-6 items-center">
+          <Avatar size="small" />
+          Tag
+        </span>
+      </Tag>
+      <Tag classNameOverride="ps-4">
+        <span className="flex gap-6 items-center">
+          <Avatar size="small" fullName="Reed Richards" />
+          Reed Richards
+        </span>
+      </Tag>
+      <Tag classNameOverride="ps-4">
+        <span className="flex gap-6 items-center">
+          <Avatar
+            size="small"
+            fullName="Sue Storm"
+            avatarSrc="https://www.cultureampcom-preview-1.usw2.wp-dev-us.cultureamp-cdn.com/assets/slices/main/assets/public/media/chapters-card-1@2x.05e547444387f29f14df0b82634bf2b6.png"
+          />
+          Susan Storm
+        </span>
+      </Tag>
+    </>
+  ),
+  decorators: [
+    Story => (
+      <div className="flex gap-12">
+        <Story />
+      </div>
+    ),
+  ],
+}
+
+export const AvatarRemovableMigration: StoryObj = {
+  render: () => (
+    <>
+      <RemovableTag
+        removeButtonProps={{
+          ariaLabel: "Remove user from *this context*",
+          onClick: fn(),
+        }}
+        classNameOverride="ps-4"
+      >
+        <span className="flex gap-6 items-center">
+          <Avatar size="small" />
+          Tag
+        </span>
+      </RemovableTag>
+      <RemovableTag
+        removeButtonProps={{
+          ariaLabel: "Remove Reed Richards from *this context*",
+          onClick: fn(),
+        }}
+        classNameOverride="ps-4"
+      >
+        <span className="flex gap-6 items-center">
+          <Avatar size="small" fullName="Reed Richards" />
+          Tag
+        </span>
+      </RemovableTag>
+      <RemovableTag
+        removeButtonProps={{
+          ariaLabel: "Remove Sue Storm from *this context*",
+          onClick: fn(),
+        }}
+        classNameOverride="ps-4"
+      >
+        <span className="flex gap-6 items-center">
+          <Avatar
+            size="small"
+            fullName="Sue Storm"
+            avatarSrc="https://www.cultureampcom-preview-1.usw2.wp-dev-us.cultureamp-cdn.com/assets/slices/main/assets/public/media/chapters-card-1@2x.05e547444387f29f14df0b82634bf2b6.png"
+          />
+          Tag
+        </span>
+      </RemovableTag>
+    </>
+  ),
+  decorators: [
+    Story => (
+      <div className="flex gap-12">
+        <Story />
+      </div>
+    ),
+  ],
+}
+
+export const InlineMigration: StoryObj = {
+  render: () => (
+    <div className="flex gap-12">
+      <Tag>Tag</Tag>
+      <Tag>Tag</Tag>
+      <Tag>Tag</Tag>
+    </div>
+  ),
+}
+
+export const SizesMigration: StoryObj = {}

package/src/__future__/Tag/Tag/_docs/Tag.mdx

@@ -36,7 +36,7 @@ Takes a `ReactNode`. This should be the text that is displayed inside the Tag.
 
 ### `color`
 
-Determines the color of the background, text, and icon.
+Determines the color of the background, text, and icon. This can be used to convey status and give meaning to the `Tag`. Find more guidance on color usage [here](https://cultureamp.atlassian.net/wiki/spaces/DesignSystem/pages/3064857902/Color).
 
 <Canvas of={TagStories.Color} />
 
@@ -52,3 +52,12 @@ in LTR, and on the right of `children` in RTL. For a list of icons, see [Icons](
 Allows classnames to be attached to the outermost element of Tag.
 
 <Canvas of={TagStories.ClassNameOverride} />
+
+#### variant
+
+`variant` has been dropped as a catch all way to supply context and mean to `Tag`. Instead, `color` and `icon` should be used to capture sentiment, validation and status.
+
+### Migrating to future Tag
+
+See our [full guide](?path=/docs/components-tag-future-tag-migration-guide--docs) here to migrate to the future release of `Tag`.
+