@windstream/react-shared-components 0.1.92 → 0.1.94

package/src/components/alert-card/AlertCard.stories.tsx

@@ -1,171 +1,171 @@
-import { AlertCard } from "./index";
-
-import { DocsPage } from "@shared/stories/DocsTemplate";
-import type { Meta, StoryObj } from "@storybook/react";
-
-const meta: Meta<typeof AlertCard> = {
-  title: "Components/AlertCard",
-  component: AlertCard,
-  tags: ["autodocs"],
-  parameters: {
-    layout: "centered",
-    docs: {
-      page: DocsPage,
-      description: {
-        component:
-          "An alert card component for displaying error messages and critical information with an icon and responsive layout.",
-      },
-    },
-  },
-  argTypes: {
-    errorMessage: {
-      control: { type: "text" },
-      description: "Error message or content to display",
-    },
-    className: {
-      control: { type: "text" },
-      description: "Additional CSS classes",
-    },
-    textVariant: {
-      control: { type: "text" },
-      description: "Text variant class name",
-    },
-  },
-  args: {
-    errorMessage: "This is an error message that needs your attention.",
-  },
-};
-
-export default meta;
-type Story = StoryObj<typeof meta>;
-
-// Default alert card
-export const Default: Story = {
-  args: {},
-};
-
-// Short error message
-export const ShortMessage: Story = {
-  args: {
-    errorMessage: "Error occurred",
-  },
-};
-
-// Long error message
-export const LongMessage: Story = {
-  args: {
-    errorMessage:
-      "This is a longer error message that demonstrates how the alert card handles extended text content. The layout will adapt responsively to accommodate the message length.",
-  },
-};
-
-// Custom text variant
-export const CustomTextVariant: Story = {
-  args: {
-    errorMessage: "Error with custom text styling",
-    textVariant: "body1",
-  },
-};
-
-// With React node content
-export const WithReactNode: Story = {
-  args: {
-    errorMessage: (
-      <div>
-        <p className="body2">Error occurred while processing your request.</p>
-        <p className="body3 mt-1 text-text-secondary">
-          Please try again or contact support if the issue persists.
-        </p>
-      </div>
-    ),
-  },
-};
-
-// Responsive layout
-export const Responsive: Story = {
-  render: () => (
-    <div className="max-w-4xl w-full space-y-4">
-      <div>
-        <h3 className="mb-2 text-sm font-medium text-gray-600">
-          Mobile Layout (flex-col)
-        </h3>
-        <div className="w-64 border border-gray-200 p-2">
-          <AlertCard errorMessage="This alert card stacks vertically on mobile devices with the icon on top." />
-        </div>
-      </div>
-      <div>
-        <h3 className="mb-2 text-sm font-medium text-gray-600">
-          Desktop Layout (flex-row)
-        </h3>
-        <div className="w-full border border-gray-200 p-2">
-          <AlertCard errorMessage="This alert card displays horizontally on desktop with the icon on the left." />
-        </div>
-      </div>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Alert card adapts its layout responsively - vertical on mobile, horizontal on desktop.",
-      },
-    },
-  },
-};
-
-// Custom styling
-export const CustomStyling: Story = {
-  args: {
-    errorMessage: "Alert card with custom styling",
-    className: "rounded-lg shadow-lg",
-  },
-};
-
-// Multiple alert cards
-export const Multiple: Story = {
-  render: () => (
-    <div className="max-w-2xl w-full space-y-4">
-      <AlertCard errorMessage="First error message" />
-      <AlertCard errorMessage="Second error message with more details about what went wrong" />
-      <AlertCard errorMessage="Third error message" />
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story: "Multiple alert cards displayed together.",
-      },
-    },
-  },
-};
-
-// All variants showcase
-export const AllVariants: Story = {
-  render: () => (
-    <div className="max-w-2xl w-full space-y-6">
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Default Alert Card</h3>
-        <AlertCard errorMessage="Default error message" />
-      </div>
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Long Message</h3>
-        <AlertCard errorMessage="This is a longer error message that demonstrates how the alert card handles extended text content while maintaining proper spacing and readability." />
-      </div>
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Custom Styled</h3>
-        <AlertCard
-          errorMessage="Custom styled alert card"
-          className="rounded-lg"
-          textVariant="body1"
-        />
-      </div>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story: "Showcase of all alert card variants and states.",
-      },
-    },
-  },
-};
+import { AlertCard } from "./index";
+
+import { DocsPage } from "@shared/stories/DocsTemplate";
+import type { Meta, StoryObj } from "@storybook/react";
+
+const meta: Meta<typeof AlertCard> = {
+  title: "Components/AlertCard",
+  component: AlertCard,
+  tags: ["autodocs"],
+  parameters: {
+    layout: "centered",
+    docs: {
+      page: DocsPage,
+      description: {
+        component:
+          "An alert card component for displaying error messages and critical information with an icon and responsive layout.",
+      },
+    },
+  },
+  argTypes: {
+    errorMessage: {
+      control: { type: "text" },
+      description: "Error message or content to display",
+    },
+    className: {
+      control: { type: "text" },
+      description: "Additional CSS classes",
+    },
+    textVariant: {
+      control: { type: "text" },
+      description: "Text variant class name",
+    },
+  },
+  args: {
+    errorMessage: "This is an error message that needs your attention.",
+  },
+};
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+// Default alert card
+export const Default: Story = {
+  args: {},
+};
+
+// Short error message
+export const ShortMessage: Story = {
+  args: {
+    errorMessage: "Error occurred",
+  },
+};
+
+// Long error message
+export const LongMessage: Story = {
+  args: {
+    errorMessage:
+      "This is a longer error message that demonstrates how the alert card handles extended text content. The layout will adapt responsively to accommodate the message length.",
+  },
+};
+
+// Custom text variant
+export const CustomTextVariant: Story = {
+  args: {
+    errorMessage: "Error with custom text styling",
+    textVariant: "body1",
+  },
+};
+
+// With React node content
+export const WithReactNode: Story = {
+  args: {
+    errorMessage: (
+      <div>
+        <p className="body2">Error occurred while processing your request.</p>
+        <p className="body3 mt-1 text-text-secondary">
+          Please try again or contact support if the issue persists.
+        </p>
+      </div>
+    ),
+  },
+};
+
+// Responsive layout
+export const Responsive: Story = {
+  render: () => (
+    <div className="max-w-4xl w-full space-y-4">
+      <div>
+        <h3 className="mb-2 text-sm font-medium text-gray-600">
+          Mobile Layout (flex-col)
+        </h3>
+        <div className="w-64 border border-gray-200 p-2">
+          <AlertCard errorMessage="This alert card stacks vertically on mobile devices with the icon on top." />
+        </div>
+      </div>
+      <div>
+        <h3 className="mb-2 text-sm font-medium text-gray-600">
+          Desktop Layout (flex-row)
+        </h3>
+        <div className="w-full border border-gray-200 p-2">
+          <AlertCard errorMessage="This alert card displays horizontally on desktop with the icon on the left." />
+        </div>
+      </div>
+    </div>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story:
+          "Alert card adapts its layout responsively - vertical on mobile, horizontal on desktop.",
+      },
+    },
+  },
+};
+
+// Custom styling
+export const CustomStyling: Story = {
+  args: {
+    errorMessage: "Alert card with custom styling",
+    className: "rounded-lg shadow-lg",
+  },
+};
+
+// Multiple alert cards
+export const Multiple: Story = {
+  render: () => (
+    <div className="max-w-2xl w-full space-y-4">
+      <AlertCard errorMessage="First error message" />
+      <AlertCard errorMessage="Second error message with more details about what went wrong" />
+      <AlertCard errorMessage="Third error message" />
+    </div>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story: "Multiple alert cards displayed together.",
+      },
+    },
+  },
+};
+
+// All variants showcase
+export const AllVariants: Story = {
+  render: () => (
+    <div className="max-w-2xl w-full space-y-6">
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Default Alert Card</h3>
+        <AlertCard errorMessage="Default error message" />
+      </div>
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Long Message</h3>
+        <AlertCard errorMessage="This is a longer error message that demonstrates how the alert card handles extended text content while maintaining proper spacing and readability." />
+      </div>
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Custom Styled</h3>
+        <AlertCard
+          errorMessage="Custom styled alert card"
+          className="rounded-lg"
+          textVariant="body1"
+        />
+      </div>
+    </div>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story: "Showcase of all alert card variants and states.",
+      },
+    },
+  },
+};

package/src/components/alert-card/index.test.tsx

@@ -0,0 +1,152 @@
+import "@testing-library/jest-dom";
+
+import { AlertCard } from "./index";
+
+import { render, screen } from "@testing-library/react";
+
+// Mock dependencies
+jest.mock("@shared/components/material-icon", () => ({
+  MaterialIcon: ({ name, size, className }: any) => (
+    <span
+      data-testid="material-icon"
+      data-name={name}
+      data-size={size}
+      className={className}
+    >
+      {name}
+    </span>
+  ),
+}));
+
+jest.mock("@shared/components/text", () => ({
+  Text: ({ children, className }: any) => (
+    <span data-testid="alert-text" className={className}>
+      {children}
+    </span>
+  ),
+}));
+
+jest.mock("@shared/utils", () => ({
+  cx: (...args: any[]) => args.filter(Boolean).join(" "),
+}));
+
+describe("AlertCard", () => {
+  it("has displayName set to AlertCard", () => {
+    expect(AlertCard.displayName).toBe("AlertCard");
+  });
+
+  describe("rendering", () => {
+    it("renders null when errorMessage is undefined", () => {
+      const { container } = render(<AlertCard />);
+      expect(container.firstChild).toBeNull();
+    });
+
+    it("renders null when errorMessage is empty string", () => {
+      const { container } = render(<AlertCard errorMessage="" />);
+      expect(container.firstChild).toBeNull();
+    });
+
+    it("renders null when errorMessage is null", () => {
+      const { container } = render(<AlertCard errorMessage={null as any} />);
+      expect(container.firstChild).toBeNull();
+    });
+
+    it("renders when errorMessage is provided", () => {
+      render(<AlertCard errorMessage="Something went wrong" />);
+      expect(screen.getByTestId("alert-card")).toBeInTheDocument();
+    });
+
+    it("renders the error message text", () => {
+      render(<AlertCard errorMessage="Connection failed" />);
+      expect(screen.getByText("Connection failed")).toBeInTheDocument();
+    });
+
+    it("renders a ReactNode as errorMessage", () => {
+      render(
+        <AlertCard
+          errorMessage={<strong data-testid="custom-node">Error!</strong>}
+        />
+      );
+      expect(screen.getByTestId("custom-node")).toBeInTheDocument();
+    });
+  });
+
+  describe("icon props", () => {
+    it("renders default icon name 'dangerous'", () => {
+      render(<AlertCard errorMessage="Error" />);
+      const icon = screen.getByTestId("material-icon");
+      expect(icon).toHaveAttribute("data-name", "dangerous");
+    });
+
+    it("renders custom icon name", () => {
+      render(<AlertCard errorMessage="Error" iconName="error" />);
+      const icon = screen.getByTestId("material-icon");
+      expect(icon).toHaveAttribute("data-name", "error");
+    });
+
+    it("uses default icon size of 52", () => {
+      render(<AlertCard errorMessage="Error" />);
+      const icon = screen.getByTestId("material-icon");
+      expect(icon).toHaveAttribute("data-size", "52");
+    });
+
+    it("uses custom icon size", () => {
+      render(<AlertCard errorMessage="Error" iconSize={24} />);
+      const icon = screen.getByTestId("material-icon");
+      expect(icon).toHaveAttribute("data-size", "24");
+    });
+
+    it("applies iconClassName to icon", () => {
+      render(<AlertCard errorMessage="Error" iconClassName="custom-icon" />);
+      const icon = screen.getByTestId("material-icon");
+      expect(icon).toHaveClass("custom-icon");
+    });
+
+    it("applies text-icon-critical class to icon by default", () => {
+      render(<AlertCard errorMessage="Error" />);
+      const icon = screen.getByTestId("material-icon");
+      expect(icon).toHaveClass("text-icon-critical");
+    });
+  });
+
+  describe("className props", () => {
+    it("applies custom className to container", () => {
+      render(<AlertCard errorMessage="Error" className="custom-class" />);
+      const card = screen.getByTestId("alert-card");
+      expect(card).toHaveClass("custom-class");
+    });
+
+    it("applies textVariant to text element", () => {
+      render(<AlertCard errorMessage="Error" textVariant="body1" />);
+      const text = screen.getByTestId("alert-text");
+      expect(text).toHaveClass("body1");
+    });
+
+    it("applies default text classes", () => {
+      render(<AlertCard errorMessage="Error" />);
+      const text = screen.getByTestId("alert-text");
+      expect(text.className).toContain("body2");
+      expect(text.className).toContain("text-text");
+    });
+  });
+
+  describe("structure", () => {
+    it("renders data-testid attribute on container", () => {
+      render(<AlertCard errorMessage="Error" />);
+      expect(screen.getByTestId("alert-card")).toBeInTheDocument();
+    });
+
+    it("renders icon within a wrapper div", () => {
+      render(<AlertCard errorMessage="Error" />);
+      const icon = screen.getByTestId("material-icon");
+      expect(icon.parentElement?.tagName).toBe("DIV");
+    });
+
+    it("applies base styling classes to container", () => {
+      render(<AlertCard errorMessage="Error" />);
+      const card = screen.getByTestId("alert-card");
+      expect(card).toHaveClass("flex");
+      expect(card).toHaveClass("flex-col");
+    });
+  });
+});

package/src/components/alert-card/index.tsx

@@ -1,41 +1,41 @@
-import React from "react";
-import { AlertCardProps } from "./types";
-
-import { MaterialIcon } from "@shared/components/material-icon";
-import { Text } from "@shared/components/text";
-import { cx } from "@shared/utils";
-
-export const AlertCard: React.FC<AlertCardProps> = ({
-  errorMessage,
-  className,
-  iconClassName,
-  iconSize = 52,
-  iconName = "dangerous",
-  textVariant,
-}) => {
-  if (!errorMessage) return null;
-
-  return (
-    <div
-      className={cx(
-        "flex flex-col items-center justify-center gap-5 rounded-surface-sm border-2 border-border-critical bg-bg-fill-critical-secondary px-4 py-6 md:flex-row md:py-4",
-        className
-      )}
-      data-testid="alert-card"
-    >
-      <div>
-        <MaterialIcon
-          name={iconName}
-          size={iconSize}
-          className={cx("text-icon-critical", iconClassName)}
-        />
-      </div>
-
-      <Text className={cx("body2 text-text", textVariant)}>{errorMessage}</Text>
-    </div>
-  );
-};
-
-AlertCard.displayName = "AlertCard";
-
-export type { AlertCardProps };
+import React from "react";
+import { AlertCardProps } from "./types";
+
+import { MaterialIcon } from "@shared/components/material-icon";
+import { Text } from "@shared/components/text";
+import { cx } from "@shared/utils";
+
+export const AlertCard: React.FC<AlertCardProps> = ({
+  errorMessage,
+  className,
+  iconClassName,
+  iconSize = 52,
+  iconName = "dangerous",
+  textVariant,
+}) => {
+  if (!errorMessage) return null;
+
+  return (
+    <div
+      className={cx(
+        "flex flex-col items-center justify-center gap-5 rounded-surface-sm border-2 border-border-critical bg-bg-fill-critical-secondary px-4 py-6 md:flex-row md:py-4",
+        className
+      )}
+      data-testid="alert-card"
+    >
+      <div>
+        <MaterialIcon
+          name={iconName}
+          size={iconSize}
+          className={cx("text-icon-critical", iconClassName)}
+        />
+      </div>
+
+      <Text className={cx("body2 text-text", textVariant)}>{errorMessage}</Text>
+    </div>
+  );
+};
+
+AlertCard.displayName = "AlertCard";
+
+export type { AlertCardProps };

package/src/components/alert-card/types.ts

@@ -1,13 +1,13 @@
-import { ReactNode } from "react";
-import { IconName, Size } from "../material-icon";
-
-import { TextVariant } from "@shared/components/text";
-
-export type AlertCardProps = {
-  errorMessage?: string | ReactNode;
-  className?: string;
-  iconName?: IconName;
-  iconClassName?: string;
-  textVariant?: TextVariant;
-  iconSize?: Size;
-};
+import { ReactNode } from "react";
+import { IconName, Size } from "../material-icon";
+
+import { TextVariant } from "@shared/components/text";
+
+export type AlertCardProps = {
+  errorMessage?: string | ReactNode;
+  className?: string;
+  iconName?: IconName;
+  iconClassName?: string;
+  textVariant?: TextVariant;
+  iconSize?: Size;
+};