@windstream/react-shared-components 0.1.92 → 0.1.94

package/src/components/link/Link.stories.tsx

@@ -1,163 +1,163 @@
-import { Link } from "./index";
-
-import { DocsPage } from "@shared/stories/DocsTemplate";
-import type { Meta, StoryObj } from "@storybook/react";
-
-const meta: Meta<typeof Link> = {
-  title: "Components/Link",
-  component: Link,
-  tags: ["autodocs"],
-  parameters: {
-    layout: "centered",
-    docs: {
-      page: DocsPage,
-      description: {
-        component:
-          "A flexible link component with multiple variants and states.",
-      },
-    },
-  },
-  argTypes: {
-    variant: {
-      control: { type: "select" },
-      options: ["default", "unstyled"],
-      description: "Link styling variant",
-    },
-    href: {
-      control: { type: "text" },
-      description: "Link URL",
-    },
-    target: {
-      control: { type: "select" },
-      options: ["_self", "_blank", "_parent", "_top"],
-      description: "Link target",
-    },
-    disabled: {
-      control: { type: "boolean" },
-      description: "Disable the link",
-    },
-    children: {
-      control: { type: "text" },
-      description: "Link content",
-    },
-  },
-  args: {
-    children: "Link Text",
-    href: "#",
-    variant: "default",
-    target: "_self",
-    disabled: false,
-  },
-};
-
-export default meta;
-type Story = StoryObj<typeof meta>;
-
-// Default link
-export const Default: Story = {
-  args: {},
-};
-
-// Unstyled link
-export const Unstyled: Story = {
-  args: {
-    variant: "unstyled",
-    children: "Unstyled Link",
-  },
-};
-
-// External link
-export const External: Story = {
-  args: {
-    href: "https://example.com",
-    target: "_blank",
-    children: "External Link ↗",
-  },
-};
-
-// Disabled link
-export const Disabled: Story = {
-  args: {
-    disabled: true,
-    children: "Disabled Link",
-  },
-};
-
-// Link with icon
-export const WithIcon: Story = {
-  args: {
-    children: "Link with Icon →",
-    className: "flex items-center gap-2",
-  },
-};
-
-// Navigation links
-export const Navigation: Story = {
-  render: () => (
-    <nav className="flex gap-6">
-      <Link href="#home" variant="default">
-        Home
-      </Link>
-      <Link href="#about">About</Link>
-      <Link href="#services">Services</Link>
-      <Link href="#contact">Contact</Link>
-    </nav>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story: "Navigation menu with different link variants.",
-      },
-    },
-  },
-};
-
-// All variants showcase
-export const AllVariants: Story = {
-  render: () => (
-    <div className="space-y-6">
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Variants</h3>
-        <div className="flex gap-4">
-          <Link href="#" variant="default">
-            Default
-          </Link>
-          <Link href="#" variant="unstyled">
-            Unstyled
-          </Link>
-        </div>
-      </div>
-
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Variants</h3>
-        <div className="flex items-center gap-4">
-          <Link href="#" variant="default">
-            Default
-          </Link>
-          <Link href="#" variant="unstyled">
-            Unstyled
-          </Link>
-        </div>
-      </div>
-
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">States</h3>
-        <div className="flex gap-4">
-          <Link href="#" disabled>
-            Disabled
-          </Link>
-          <Link href="https://example.com" target="_blank">
-            External ↗
-          </Link>
-        </div>
-      </div>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story: "Showcase of all link variants, sizes, and states.",
-      },
-    },
-  },
-};
+import { Link } from "./index";
+
+import { DocsPage } from "@shared/stories/DocsTemplate";
+import type { Meta, StoryObj } from "@storybook/react";
+
+const meta: Meta<typeof Link> = {
+  title: "Components/Link",
+  component: Link,
+  tags: ["autodocs"],
+  parameters: {
+    layout: "centered",
+    docs: {
+      page: DocsPage,
+      description: {
+        component:
+          "A flexible link component with multiple variants and states.",
+      },
+    },
+  },
+  argTypes: {
+    variant: {
+      control: { type: "select" },
+      options: ["default", "unstyled"],
+      description: "Link styling variant",
+    },
+    href: {
+      control: { type: "text" },
+      description: "Link URL",
+    },
+    target: {
+      control: { type: "select" },
+      options: ["_self", "_blank", "_parent", "_top"],
+      description: "Link target",
+    },
+    disabled: {
+      control: { type: "boolean" },
+      description: "Disable the link",
+    },
+    children: {
+      control: { type: "text" },
+      description: "Link content",
+    },
+  },
+  args: {
+    children: "Link Text",
+    href: "#",
+    variant: "default",
+    target: "_self",
+    disabled: false,
+  },
+};
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+// Default link
+export const Default: Story = {
+  args: {},
+};
+
+// Unstyled link
+export const Unstyled: Story = {
+  args: {
+    variant: "unstyled",
+    children: "Unstyled Link",
+  },
+};
+
+// External link
+export const External: Story = {
+  args: {
+    href: "https://example.com",
+    target: "_blank",
+    children: "External Link ↗",
+  },
+};
+
+// Disabled link
+export const Disabled: Story = {
+  args: {
+    disabled: true,
+    children: "Disabled Link",
+  },
+};
+
+// Link with icon
+export const WithIcon: Story = {
+  args: {
+    children: "Link with Icon →",
+    className: "flex items-center gap-2",
+  },
+};
+
+// Navigation links
+export const Navigation: Story = {
+  render: () => (
+    <nav className="flex gap-6">
+      <Link href="#home" variant="default">
+        Home
+      </Link>
+      <Link href="#about">About</Link>
+      <Link href="#services">Services</Link>
+      <Link href="#contact">Contact</Link>
+    </nav>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story: "Navigation menu with different link variants.",
+      },
+    },
+  },
+};
+
+// All variants showcase
+export const AllVariants: Story = {
+  render: () => (
+    <div className="space-y-6">
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Variants</h3>
+        <div className="flex gap-4">
+          <Link href="#" variant="default">
+            Default
+          </Link>
+          <Link href="#" variant="unstyled">
+            Unstyled
+          </Link>
+        </div>
+      </div>
+
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Variants</h3>
+        <div className="flex items-center gap-4">
+          <Link href="#" variant="default">
+            Default
+          </Link>
+          <Link href="#" variant="unstyled">
+            Unstyled
+          </Link>
+        </div>
+      </div>
+
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">States</h3>
+        <div className="flex gap-4">
+          <Link href="#" disabled>
+            Disabled
+          </Link>
+          <Link href="https://example.com" target="_blank">
+            External ↗
+          </Link>
+        </div>
+      </div>
+    </div>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story: "Showcase of all link variants, sizes, and states.",
+      },
+    },
+  },
+};

package/src/components/link/index.test.tsx

@@ -0,0 +1,199 @@
+import React from "react";
+import { Link } from "./index";
+
+import { fireEvent, render, screen } from "@testing-library/react";
+
+import "@testing-library/jest-dom";
+
+// Mock next/link
+jest.mock("next/link", () => {
+  const MockLink = ({ children, href, className, onClick, ...rest }: any) => (
+    <a href={href} className={className} onClick={onClick} {...rest}>
+      {children}
+    </a>
+  );
+  MockLink.displayName = "MockNextLink";
+  return MockLink;
+});
+
+describe("Link", () => {
+  describe("Rendering", () => {
+    it("renders children content", () => {
+      render(<Link href="/test">Click me</Link>);
+      expect(screen.getByText("Click me")).toBeInTheDocument();
+    });
+
+    it("has correct displayName", () => {
+      expect(Link.displayName).toBe("Link");
+    });
+
+    it("renders as a Next.js Link for internal links", () => {
+      render(<Link href="/internal">Internal</Link>);
+      const el = screen.getByText("Internal");
+      expect(el.closest("a")).toHaveAttribute("href", "/internal");
+    });
+
+    it("renders as <a> for external links", () => {
+      render(
+        <Link href="https://example.com" external={true}>
+          External
+        </Link>
+      );
+      const el = screen.getByText("External");
+      expect(el.closest("a")).toHaveAttribute("href", "https://example.com");
+    });
+
+    it("renders as <a> for http links even without external prop", () => {
+      render(<Link href="https://example.com">Auto External</Link>);
+      const el = screen.getByText("Auto External");
+      expect(el.closest("a")).toHaveAttribute("href", "https://example.com");
+    });
+  });
+
+  describe("Variants", () => {
+    it("applies unstyled variant with no extra classes", () => {
+      render(
+        <Link href="/test" variant="unstyled">
+          Unstyled
+        </Link>
+      );
+      const el = screen.getByText("Unstyled").closest("a");
+      expect(el?.className).toContain("link--unstyled");
+    });
+
+    it("applies default variant classes", () => {
+      render(
+        <Link href="/test" variant="default">
+          Default
+        </Link>
+      );
+      const el = screen.getByText("Default").closest("a");
+      expect(el?.className).toContain("link--default");
+      expect(el?.className).toContain("underline");
+    });
+  });
+
+  describe("Disabled state", () => {
+    it("adds disabled class when disabled", () => {
+      render(
+        <Link href="/test" disabled={true}>
+          Disabled
+        </Link>
+      );
+      const el = screen.getByText("Disabled").closest("a");
+      expect(el?.className).toContain("link--disabled");
+    });
+
+    it("sets aria-disabled when disabled", () => {
+      render(
+        <Link href="/test" disabled={true} external={true}>
+          Disabled
+        </Link>
+      );
+      const el = screen.getByText("Disabled").closest("a");
+      expect(el).toHaveAttribute("aria-disabled", "true");
+    });
+
+    it("sets tabIndex -1 when disabled", () => {
+      render(
+        <Link href="/test" disabled={true} external={true}>
+          Disabled
+        </Link>
+      );
+      const el = screen.getByText("Disabled").closest("a");
+      expect(el).toHaveAttribute("tabindex", "-1");
+    });
+
+    it("prevents click when disabled", () => {
+      const onClick = jest.fn();
+      render(
+        <Link href="/test" disabled={true} external={true} onClick={onClick}>
+          Disabled
+        </Link>
+      );
+      const el = screen.getByText("Disabled").closest("a")!;
+      fireEvent.click(el);
+      expect(onClick).not.toHaveBeenCalled();
+    });
+  });
+
+  describe("External links", () => {
+    it("adds target=_blank for external links", () => {
+      render(
+        <Link href="https://example.com" external={true}>
+          External
+        </Link>
+      );
+      const el = screen.getByText("External").closest("a");
+      expect(el).toHaveAttribute("target", "_blank");
+    });
+
+    it("adds rel=noopener noreferrer for external links", () => {
+      render(
+        <Link href="https://example.com" external={true}>
+          External
+        </Link>
+      );
+      const el = screen.getByText("External").closest("a");
+      expect(el).toHaveAttribute("rel", "noopener noreferrer");
+    });
+
+    it("does not add target for disabled external links", () => {
+      render(
+        <Link href="https://example.com" external={true} disabled={true}>
+          External
+        </Link>
+      );
+      const el = screen.getByText("External").closest("a");
+      expect(el).not.toHaveAttribute("target", "_blank");
+    });
+  });
+
+  describe("Event handling", () => {
+    it("calls onClick handler when clicked", () => {
+      const onClick = jest.fn();
+      render(
+        <Link href="https://example.com" external={true} onClick={onClick}>
+          Click
+        </Link>
+      );
+      const el = screen.getByText("Click").closest("a")!;
+      fireEvent.click(el);
+      expect(onClick).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe("Ref forwarding", () => {
+    it("forwards ref to the anchor element", () => {
+      const ref = React.createRef<HTMLAnchorElement>();
+      render(
+        <Link ref={ref} href="https://test.com" external={true}>
+          Ref
+        </Link>
+      );
+      expect(ref.current).toBeInstanceOf(HTMLAnchorElement);
+    });
+  });
+
+  describe("Custom className and style", () => {
+    it("applies custom className", () => {
+      render(
+        <Link href="/test" className="custom-class">
+          Custom
+        </Link>
+      );
+      const el = screen.getByText("Custom").closest("a");
+      expect(el?.className).toContain("custom-class");
+    });
+
+    it("applies inline style", () => {
+      render(
+        <Link href="https://test.com" external={true} style={{ color: "red" }}>
+          Styled
+        </Link>
+      );
+      const el = screen.getByText("Styled").closest("a")!;
+      expect(el.style.color).toBe("red");
+    });
+  });
+});