@windstream/react-shared-components 0.1.92 → 0.1.94

package/src/contentful/blocks/callout/types.ts

@@ -1,78 +1,78 @@
-import type { ReactNode } from "react";
-import type { ButtonProps } from "../button/types";
-
-import type { AnimationType } from "@shared/components/animation-wrapper";
-
-export type CalloutCardType = "simple" | "blog" | "fullImage" | "floatingImage";
-
-export type CalloutCtaProps = ButtonProps & {
-  label?: string;
-};
-
-export type CalloutItem = {
-  /**
-   * Optional per-item card type. When provided, overrides the top-level
-   * `cardType` for this single item — enables mixed card variants in one
-   * Callout (e.g. one full-image + two simple cards).
-   */
-  cardType?: CalloutCardType;
-  // Permissive shape — concrete card components validate their own subset.
-  [key: string]: any;
-};
-
-export type CalloutProps = {
-  /** Outer `<section>` id — anchor link target. */
-  anchorId?: string;
-  title?: string;
-  enableHeading?: boolean;
-  subtitle?: string;
-  description?: string;
-  finePrint?: ReactNode;
-  cta?: CalloutCtaProps;
-  applyBoxShadow?: boolean;
-  cardStackingMobile?: boolean;
-  bottomText?: string;
-  color?: "dark" | "light";
-  /**
-   * When `true` (default) cards are laid out in a responsive Tailwind
-   * grid sized by `maxCardsPerRow`. When `false` the cards stretch
-   * full-width and stack vertically (no inner widths).
-   *
-   * Accepts a string for backward compatibility with legacy consumers
-   * that pass a Tailwind width class (e.g. "w-1/2"); any truthy value
-   * enables grid mode — the string itself is not applied.
-   */
-  cardsWidth?: boolean | string;
-  maxCardsPerRow?: number;
-  noGutter?: boolean;
-  items: CalloutItem[];
-  maxWidth?: boolean;
-  /** Top-level card type used when an item does not specify its own. */
-  cardType?: CalloutCardType;
-  /**
-   * Background color token. When omitted the section has no background
-   * (preserves prior behavior for existing 0.1.70 consumers).
-   */
-  backgroundColor?:
-    | "cream500"
-    | "gray100"
-    | "white"
-    | "transparent"
-    | "blue"
-    | "green"
-    | "navy"
-    | "purple"
-    | "yellow";
-  /** Raw background CSS value (overrides `backgroundColor` when present). */
-  background?: string;
-  /** Inline text color override applied to the heading region. */
-  textColor?: string;
-  /** Extra class names for the outer <section>. */
-  containerClassName?: string;
-  /** Extra class names for the inner content wrapper. */
-  innerClassName?: string;
-  /** Disable card hover/tap animations. */
-  disableAnimation?: boolean;
-  /** Animation type(s) applied to each card. */
-  animationType?: AnimationType | AnimationType[];
-};
+import type { ReactNode } from "react";
+import type { ButtonProps } from "../button/types";
+
+import type { AnimationType } from "@shared/components/animation-wrapper";
+
+export type CalloutCardType = "simple" | "blog" | "fullImage" | "floatingImage";
+
+export type CalloutCtaProps = ButtonProps & {
+  label?: string;
+};
+
+export type CalloutItem = {
+  /**
+   * Optional per-item card type. When provided, overrides the top-level
+   * `cardType` for this single item — enables mixed card variants in one
+   * Callout (e.g. one full-image + two simple cards).
+   */
+  cardType?: CalloutCardType;
+  // Permissive shape — concrete card components validate their own subset.
+  [key: string]: any;
+};
+
+export type CalloutProps = {
+  /** Outer `<section>` id — anchor link target. */
+  anchorId?: string;
+  title?: string;
+  enableHeading?: boolean;
+  subtitle?: string;
+  description?: string;
+  finePrint?: ReactNode;
+  cta?: CalloutCtaProps;
+  applyBoxShadow?: boolean;
+  cardStackingMobile?: boolean;
+  bottomText?: string;
+  color?: "dark" | "light";
+  /**
+   * When `true` (default) cards are laid out in a responsive Tailwind
+   * grid sized by `maxCardsPerRow`. When `false` the cards stretch
+   * full-width and stack vertically (no inner widths).
+   *
+   * Accepts a string for backward compatibility with legacy consumers
+   * that pass a Tailwind width class (e.g. "w-1/2"); any truthy value
+   * enables grid mode — the string itself is not applied.
+   */
+  cardsWidth?: boolean | string;
+  maxCardsPerRow?: number;
+  noGutter?: boolean;
+  items: CalloutItem[];
+  maxWidth?: boolean;
+  /** Top-level card type used when an item does not specify its own. */
+  cardType?: CalloutCardType;
+  /**
+   * Background color token. When omitted the section has no background
+   * (preserves prior behavior for existing 0.1.70 consumers).
+   */
+  backgroundColor?:
+    | "cream500"
+    | "gray100"
+    | "white"
+    | "transparent"
+    | "blue"
+    | "green"
+    | "navy"
+    | "purple"
+    | "yellow";
+  /** Raw background CSS value (overrides `backgroundColor` when present). */
+  background?: string;
+  /** Inline text color override applied to the heading region. */
+  textColor?: string;
+  /** Extra class names for the outer <section>. */
+  containerClassName?: string;
+  /** Extra class names for the inner content wrapper. */
+  innerClassName?: string;
+  /** Disable card hover/tap animations. */
+  disableAnimation?: boolean;
+  /** Animation type(s) applied to each card. */
+  animationType?: AnimationType | AnimationType[];
+};

package/src/contentful/blocks/cards/Cards.stories.tsx

@@ -1,23 +1,23 @@
-import { Cards } from "./index";
-
-import { DocsPage } from "@shared/stories/DocsTemplate";
-import type { Meta, StoryObj } from "@storybook/react";
-
-const meta: Meta<typeof Cards> = {
-  title: "Contentful Blocks/Cards",
-  component: Cards,
-  tags: ["autodocs"],
-  parameters: {
-    layout: "centered",
-    docs: {
-      page: DocsPage,
-      description: {
-        component: "Contentful cards block.",
-      },
-    },
-  },
-  args: { fields: {} },
-};
-export default meta;
-type Story = StoryObj<typeof meta>;
-export const Default: Story = {};
+import { Cards } from "./index";
+
+import { DocsPage } from "@shared/stories/DocsTemplate";
+import type { Meta, StoryObj } from "@storybook/react";
+
+const meta: Meta<typeof Cards> = {
+  title: "Contentful Blocks/Cards",
+  component: Cards,
+  tags: ["autodocs"],
+  parameters: {
+    layout: "centered",
+    docs: {
+      page: DocsPage,
+      description: {
+        component: "Contentful cards block.",
+      },
+    },
+  },
+  args: { fields: {} },
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export const Default: Story = {};

package/src/contentful/blocks/cards/blog-card/index.test.tsx

@@ -0,0 +1,218 @@
+import React from "react";
+import { BlogCard } from "./index";
+
+import { render, screen } from "@testing-library/react";
+
+// Mock next/link
+jest.mock("next/link", () => {
+  const MockLink = ({ children, href, className, ...rest }: any) => (
+    <a href={href} className={className} {...rest}>
+      {children}
+    </a>
+  );
+  MockLink.displayName = "MockNextLink";
+  return MockLink;
+});
+
+jest.mock("@shared/components/material-icon", () => ({
+  MaterialIcon: ({ name }: any) => (
+    <span data-testid="material-icon" data-name={name}>
+      {name}
+    </span>
+  ),
+}));
+
+jest.mock("@shared/components/text", () => ({
+  Text: ({ children, className, ...rest }: any) => (
+    <span className={className} {...rest}>
+      {children}
+    </span>
+  ),
+}));
+
+describe("BlogCard", () => {
+  const defaultProps = {
+    href: "/blog/test-post",
+    title: "Test Blog Post",
+    description: "A description of the post",
+    date: "Jan 15, 2026",
+    category: "Technology",
+  };
+
+  describe("Rendering", () => {
+    it("renders the article element", () => {
+      const { container } = render(<BlogCard {...defaultProps} />);
+      expect(container.querySelector("article")).toBeInTheDocument();
+    });
+
+    it("renders title as a link", () => {
+      render(<BlogCard {...defaultProps} />);
+      expect(screen.getByText("Test Blog Post")).toBeInTheDocument();
+      expect(screen.getByText("Test Blog Post").closest("a")).toHaveAttribute(
+        "href",
+        "/blog/test-post"
+      );
+    });
+
+    it("renders description", () => {
+      render(<BlogCard {...defaultProps} />);
+      expect(screen.getByText("A description of the post")).toBeInTheDocument();
+    });
+
+    it("renders category", () => {
+      render(<BlogCard {...defaultProps} />);
+      expect(screen.getByText("Technology")).toBeInTheDocument();
+    });
+
+    it("renders date", () => {
+      render(<BlogCard {...defaultProps} />);
+      expect(screen.getByText("Jan 15, 2026")).toBeInTheDocument();
+    });
+
+    it("renders dot separator between category and date", () => {
+      render(<BlogCard {...defaultProps} />);
+      expect(screen.getByText("•")).toBeInTheDocument();
+    });
+
+    it("renders read more link", () => {
+      render(<BlogCard {...defaultProps} />);
+      expect(screen.getByText("Read more")).toBeInTheDocument();
+    });
+
+    it("renders custom readMoreText", () => {
+      render(<BlogCard {...defaultProps} readMoreText="Continue reading" />);
+      expect(screen.getByText("Continue reading")).toBeInTheDocument();
+    });
+
+    it("does not render date separator when date is not provided", () => {
+      render(<BlogCard {...defaultProps} date={undefined} />);
+      expect(screen.queryByText("•")).not.toBeInTheDocument();
+    });
+  });
+
+  describe("Image", () => {
+    it("renders img element when image is provided", () => {
+      const image = {
+        src: "/test.jpg",
+        alt: "Test image",
+        width: 400,
+        height: 300,
+      };
+      const { container } = render(
+        <BlogCard {...defaultProps} image={image} />
+      );
+      const img = container.querySelector("img");
+      expect(img).toBeInTheDocument();
+      expect(img).toHaveAttribute("src", "/test.jpg");
+      expect(img).toHaveAttribute("alt", "Test image");
+    });
+
+    it("renders custom imageComponent when provided", () => {
+      const image = {
+        src: "/test.jpg",
+        alt: "Custom image",
+        width: 400,
+        height: 300,
+      };
+      const CustomImage = (props: any) => (
+        <img data-testid="custom-image" {...props} />
+      );
+      render(
+        <BlogCard
+          {...defaultProps}
+          image={image}
+          imageComponent={CustomImage}
+        />
+      );
+      expect(screen.getByTestId("custom-image")).toBeInTheDocument();
+    });
+
+    it("renders placeholder when no image is provided", () => {
+      const { container } = render(<BlogCard {...defaultProps} />);
+      const placeholder = container.querySelector("[aria-hidden='true']");
+      expect(placeholder).toBeInTheDocument();
+    });
+  });
+
+  describe("Layout", () => {
+    it("applies grid layout by default", () => {
+      const { container } = render(<BlogCard {...defaultProps} />);
+      const article = container.querySelector("article");
+      expect(article?.className).toContain("flex h-full flex-col");
+    });
+
+    it("applies non-grid layout when asGrid is false", () => {
+      const { container } = render(
+        <BlogCard {...defaultProps} asGrid={false} />
+      );
+      const article = container.querySelector("article");
+      expect(article?.className).toContain("callout-card");
+    });
+
+    it("applies lgWidth and mdWidth in non-grid mode", () => {
+      const { container } = render(
+        <BlogCard
+          {...defaultProps}
+          asGrid={false}
+          lgWidth="lg:w-1/3"
+          mdWidth="md:w-1/2"
+        />
+      );
+      const article = container.querySelector("article");
+      expect(article?.className).toContain("lg:w-1/3");
+      expect(article?.className).toContain("md:w-1/2");
+    });
+
+    it("applies data-section-type attribute", () => {
+      const { container } = render(<BlogCard {...defaultProps} />);
+      const article = container.querySelector("article");
+      expect(article).toHaveAttribute("data-section-type", "blog-card");
+    });
+
+    it("applies data-section-index attribute", () => {
+      const { container } = render(<BlogCard {...defaultProps} index={2} />);
+      const article = container.querySelector("article");
+      expect(article).toHaveAttribute("data-section-index", "2");
+    });
+  });
+
+  describe("Optional props", () => {
+    it("renders without title", () => {
+      const { container } = render(
+        <BlogCard {...defaultProps} title={undefined} />
+      );
+      expect(container.querySelector("article")).toBeInTheDocument();
+    });
+
+    it("renders without description", () => {
+      const { container } = render(
+        <BlogCard {...defaultProps} description={undefined} />
+      );
+      expect(container.querySelector("article")).toBeInTheDocument();
+    });
+
+    it("sets aria-label on read more link", () => {
+      render(<BlogCard {...defaultProps} />);
+      const links = screen.getAllByRole("link");
+      const readMoreLink = links.find(link =>
+        link.getAttribute("aria-label")?.includes("Read more")
+      );
+      expect(readMoreLink).toHaveAttribute(
+        "aria-label",
+        "Read more about Test Blog Post"
+      );
+    });
+
+    it("uses fallback aria-label when title is not provided", () => {
+      render(<BlogCard {...defaultProps} title={undefined} />);
+      const links = screen.getAllByRole("link");
+      const readMoreLink = links.find(link =>
+        link.getAttribute("aria-label")?.includes("Read more")
+      );
+      expect(readMoreLink).toHaveAttribute(
+        "aria-label",
+        "Read more about this article"
+      );
+    });
+  });
+});

package/src/contentful/blocks/cards/blog-card/index.tsx

@@ -1,129 +1,129 @@
-import React from "react";
-import { BlogCardProps } from "./types";
-import * as _NextLink from "next/link";
-
-// import { Button } from "@shared/components/button";
-import { MaterialIcon } from "@shared/components/material-icon";
-import { Text } from "@shared/components/text";
-
-// CJS/ESM interop: next/link uses standard __esModule exports so this is safe.
-// next/image is intentionally avoided — its image-external.js uses the
-// `0 && (module.exports = {...})` tree-shaking hint which confuses webpack's
-// CJS→ESM interop and causes "got: object" errors in consuming apps.
-const Link = ((_NextLink as any).default ??
-  _NextLink) as typeof import("next/link").default;
-
-export const BlogCard: React.FC<BlogCardProps> = ({
-  href,
-  title,
-  description,
-  date,
-  category,
-  image,
-  imageComponent: ImageComponent,
-  readMoreText = "Read more",
-  asGrid = true,
-  lgWidth,
-  mdWidth,
-  index,
-}: BlogCardProps) => {
-  const basehwClass = "lg:w-[calc(33.3333%-1rem)] md:w-[calc(50%-1rem)]";
-  const parentClassName = asGrid
-    ? "flex h-full flex-col overflow-hidden rounded-card-lg bg-white shadow-drop transition-all duration-200 hover:-translate-y-0.5 hover:shadow-cardDrop"
-    : `callout-card ${basehwClass} ${lgWidth} ${mdWidth} w-full overflow-hidden rounded-card-lg bg-white shadow-drop transition-all duration-200 hover:-translate-y-0.5 hover:shadow-cardDrop`;
-
-  return (
-    <article
-      className={parentClassName}
-      data-section-type={"blog-card"}
-      data-section-index={index}
-    >
-      {/* Image */}
-      <Link href={href} tabIndex={-1} aria-hidden="true" className="block">
-        <div className="h-[232px] w-full flex-shrink-0 overflow-hidden bg-gray-100">
-          {image ? (
-            ImageComponent ? (
-              <ImageComponent
-                src={image.src}
-                alt={image.alt}
-                width={image.width}
-                height={image.height}
-                className="h-full w-full object-cover transition-transform duration-300 hover:scale-[1.03]"
-                sizes="(max-width: 640px) 100vw, (max-width: 1024px) 50vw, 33vw"
-              />
-            ) : (
-              <img
-                src={image.src}
-                alt={image.alt}
-                width={image.width}
-                height={image.height}
-                loading="lazy"
-                decoding="async"
-                className="h-full w-full object-cover transition-transform duration-300 hover:scale-[1.03]"
-              />
-            )
-          ) : (
-            <div
-              className="h-full w-full bg-gradient-to-br from-gray-200 to-gray-100"
-              aria-hidden="true"
-            />
-          )}
-        </div>
-      </Link>
-
-      {/* Body */}
-      <div className="flex flex-1 flex-col gap-5 p-6 md:p-8">
-        {/* Meta: category + date */}
-        <div className="flex items-center gap-2 text-[13px]">
-          <span className="body2 text-text-brand">{category}</span>
-          {date && (
-            <>
-              <span className="footnote text-text" aria-hidden="true">
-                •
-              </span>
-              <time className="body2 text-text">{date}</time>
-            </>
-          )}
-        </div>
-
-        {/* Title */}
-        {title && (
-          <Link
-            href={href}
-            className="heading6 m-0 line-clamp-3 font-black transition-colors duration-150 hover:text-text-brand"
-          >
-            {title}
-          </Link>
-        )}
-
-        {/* Excerpt */}
-        {description && (
-          <Text className="body1 m-0 line-clamp-3 flex-1 text-text">
-            {description}
-          </Text>
-        )}
-
-        {/* Read more */}
-        <Link
-          href={href}
-          className="group mt-auto inline-flex items-center justify-start gap-2 pt-3 text-sm text-text-brand no-underline"
-          aria-label={`${readMoreText} about ${title || "this article"}`}
-        >
-          <Text
-            aria-label={`${readMoreText} about ${title || "this article"}`}
-            className="label1 text-nowrap"
-          >
-            {readMoreText}
-          </Text>
-          <MaterialIcon
-            name="expand_circle_right"
-            fill={1}
-            size={24}
-            weight="200"
-          />
-        </Link>
-      </div>
-    </article>
-  );
-};
-export default BlogCard;
+import React from "react";
+import { BlogCardProps } from "./types";
+import * as _NextLink from "next/link";
+
+// import { Button } from "@shared/components/button";
+import { MaterialIcon } from "@shared/components/material-icon";
+import { Text } from "@shared/components/text";
+
+// CJS/ESM interop: next/link uses standard __esModule exports so this is safe.
+// next/image is intentionally avoided — its image-external.js uses the
+// `0 && (module.exports = {...})` tree-shaking hint which confuses webpack's
+// CJS→ESM interop and causes "got: object" errors in consuming apps.
+const Link = ((_NextLink as any).default ??
+  _NextLink) as typeof import("next/link").default;
+
+export const BlogCard: React.FC<BlogCardProps> = ({
+  href,
+  title,
+  description,
+  date,
+  category,
+  image,
+  imageComponent: ImageComponent,
+  readMoreText = "Read more",
+  asGrid = true,
+  lgWidth,
+  mdWidth,
+  index,
+}: BlogCardProps) => {
+  const basehwClass = "lg:w-[calc(33.3333%-1rem)] md:w-[calc(50%-1rem)]";
+  const parentClassName = asGrid
+    ? "flex h-full flex-col overflow-hidden rounded-card-lg bg-white shadow-drop transition-all duration-200 hover:-translate-y-0.5 hover:shadow-cardDrop"
+    : `callout-card ${basehwClass} ${lgWidth} ${mdWidth} w-full overflow-hidden rounded-card-lg bg-white shadow-drop transition-all duration-200 hover:-translate-y-0.5 hover:shadow-cardDrop`;
+
+  return (
+    <article
+      className={parentClassName}
+      data-section-type={"blog-card"}
+      data-section-index={index}
+    >
+      {/* Image */}
+      <Link href={href} tabIndex={-1} aria-hidden="true" className="block">
+        <div className="h-[232px] w-full flex-shrink-0 overflow-hidden bg-gray-100">
+          {image ? (
+            ImageComponent ? (
+              <ImageComponent
+                src={image.src}
+                alt={image.alt}
+                width={image.width}
+                height={image.height}
+                className="h-full w-full object-cover transition-transform duration-300 hover:scale-[1.03]"
+                sizes="(max-width: 640px) 100vw, (max-width: 1024px) 50vw, 33vw"
+              />
+            ) : (
+              <img
+                src={image.src}
+                alt={image.alt}
+                width={image.width}
+                height={image.height}
+                loading="lazy"
+                decoding="async"
+                className="h-full w-full object-cover transition-transform duration-300 hover:scale-[1.03]"
+              />
+            )
+          ) : (
+            <div
+              className="h-full w-full bg-gradient-to-br from-gray-200 to-gray-100"
+              aria-hidden="true"
+            />
+          )}
+        </div>
+      </Link>
+
+      {/* Body */}
+      <div className="flex flex-1 flex-col gap-5 p-6 md:p-8">
+        {/* Meta: category + date */}
+        <div className="flex items-center gap-2 text-[13px]">
+          <span className="body2 text-text-brand">{category}</span>
+          {date && (
+            <>
+              <span className="footnote text-text" aria-hidden="true">
+                •
+              </span>
+              <time className="body2 text-text">{date}</time>
+            </>
+          )}
+        </div>
+
+        {/* Title */}
+        {title && (
+          <Link
+            href={href}
+            className="heading6 m-0 line-clamp-3 font-black transition-colors duration-150 hover:text-text-brand"
+          >
+            {title}
+          </Link>
+        )}
+
+        {/* Excerpt */}
+        {description && (
+          <Text className="body1 m-0 line-clamp-3 flex-1 text-text">
+            {description}
+          </Text>
+        )}
+
+        {/* Read more */}
+        <Link
+          href={href}
+          className="group mt-auto inline-flex items-center justify-start gap-2 pt-3 text-sm text-text-brand no-underline"
+          aria-label={`${readMoreText} about ${title || "this article"}`}
+        >
+          <Text
+            aria-label={`${readMoreText} about ${title || "this article"}`}
+            className="label1 text-nowrap"
+          >
+            {readMoreText}
+          </Text>
+          <MaterialIcon
+            name="expand_circle_right"
+            fill={1}
+            size={24}
+            weight="200"
+          />
+        </Link>
+      </div>
+    </article>
+  );
+};
+export default BlogCard;