@windstream/react-shared-components 0.1.81 → 0.1.86

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

@@ -1,72 +1,78 @@
-import type { ReactNode } from "react";
-import type { ButtonProps } from "../button/types";
-
-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;
-};
+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.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;

package/src/contentful/blocks/cards/blog-card/types.ts

@@ -1,34 +1,34 @@
-import React from "react";
-
-export interface BlogCardImageProps {
-  src: string;
-  alt: string;
-  width: number;
-  height: number;
-  className?: string;
-  sizes?: string;
-  loading?: "lazy" | "eager";
-  decoding?: "async" | "auto" | "sync";
-  [key: string]: unknown;
-}
-
-export interface BlogCardProps {
-  href: string;
-  title?: string;
-  description?: string;
-  date?: string;
-  category?: string;
-  image?: {
-    src: string;
-    alt: string;
-    width: number;
-    height: number;
-  };
-  /** Pass next/image's Image component here to enable image optimization */
-  imageComponent?: React.ComponentType<BlogCardImageProps>;
-  readMoreText?: string;
-  asGrid?: boolean;
-  lgWidth?: string;
-  mdWidth?: string;
-  index?: number;
-}
+import React from "react";
+
+export interface BlogCardImageProps {
+  src: string;
+  alt: string;
+  width: number;
+  height: number;
+  className?: string;
+  sizes?: string;
+  loading?: "lazy" | "eager";
+  decoding?: "async" | "auto" | "sync";
+  [key: string]: unknown;
+}
+
+export interface BlogCardProps {
+  href: string;
+  title?: string;
+  description?: string;
+  date?: string;
+  category?: string;
+  image?: {
+    src: string;
+    alt: string;
+    width: number;
+    height: number;
+  };
+  /** Pass next/image's Image component here to enable image optimization */
+  imageComponent?: React.ComponentType<BlogCardImageProps>;
+  readMoreText?: string;
+  asGrid?: boolean;
+  lgWidth?: string;
+  mdWidth?: string;
+  index?: number;
+}