@windstream/react-shared-components 0.1.78 → 0.1.79

package/src/contentful/blocks/anchored-bottom-banner/index.tsx

@@ -1,181 +1,181 @@
-import React, {
-  useCallback,
-  useEffect,
-  useMemo,
-  useRef,
-  useState,
-} from "react";
-import { AnchoredBottomBannerProps } from "./types";
-import Link from "next/link";
-
-import { MaterialIcon } from "@shared/components/material-icon";
-
-function parseCountdownDateTime(value?: string): number | undefined {
-  if (!value) return undefined;
-  const parsed = Date.parse(value);
-  if (!Number.isFinite(parsed)) {
-    console.error("Invalid countdown datetime", { value });
-    return undefined;
-  }
-  return parsed;
-}
-
-function formatCountdown(totalSeconds: number) {
-  const safeSeconds = Math.max(0, Math.floor(totalSeconds));
-  const hours = Math.floor(safeSeconds / 3600);
-  const minutes = Math.floor((safeSeconds % 3600) / 60);
-  const seconds = safeSeconds % 60;
-
-  return `${String(hours).padStart(2, "0")}H : ${String(minutes).padStart(2, "0")}M : ${String(seconds).padStart(2, "0")}`;
-}
-
-export const AnchoredBottomBanner: React.FC<AnchoredBottomBannerProps> = ({
-  ctaSuffixText,
-  backgroundColor,
-  iconName,
-  boxShadow,
-  ctaButtonLabel,
-  ctaButtonLink,
-  ctaButtonTarget,
-  anchorId = "anchored-banner",
-  enableCountdownTimer,
-  countdownStartDateTime,
-  countdownEndDateTime,
-}) => {
-  const backGroundColorClasses = {
-    navy: "bg-bg-fill-inverse",
-    green: "bg-bg-fill-success",
-    blue: "bg-bg-fill-brand-supporting",
-    purple: "bg-bg-fill-brand-tertiary",
-    yellow: "bg-bg-fill-brand-accent",
-    white: "bg-white",
-  };
-
-  const bgClass = backgroundColor
-    ? backGroundColorClasses[backgroundColor]
-    : "bg-bg-fill-brand-accent";
-
-  const isLightBackground =
-    backgroundColor === "yellow" ||
-    backgroundColor === "white" ||
-    !backgroundColor;
-  const textColorClass = isLightBackground ? "text-text-primary" : "text-white";
-
-  // Memoize parsed timestamps so they aren't re-parsed every second
-  const endMs = useMemo(
-    () => parseCountdownDateTime(countdownEndDateTime),
-    [countdownEndDateTime]
-  );
-  const startMs = useMemo(
-    () => parseCountdownDateTime(countdownStartDateTime),
-    [countdownStartDateTime]
-  );
-
-  const isTimerValid = useMemo(() => {
-    if (!enableCountdownTimer || endMs === undefined) return false;
-    if (countdownStartDateTime && startMs === undefined) return false;
-    if (startMs !== undefined && startMs >= endMs) {
-      console.error("Invalid countdown range: start must be before end", {
-        countdownStartDateTime,
-        countdownEndDateTime,
-      });
-      return false;
-    }
-    return true;
-  }, [
-    enableCountdownTimer,
-    endMs,
-    startMs,
-    countdownStartDateTime,
-    countdownEndDateTime,
-  ]);
-
-  const [nowMs, setNowMs] = useState(() => Date.now());
-  const intervalRef = useRef<number | null>(null);
-
-  const clearTimer = useCallback(() => {
-    if (intervalRef.current !== null) {
-      window.clearInterval(intervalRef.current);
-      intervalRef.current = null;
-    }
-  }, []);
-
-  useEffect(() => {
-    if (!isTimerValid) {
-      clearTimer();
-      return;
-    }
-
-    intervalRef.current = window.setInterval(() => {
-      const now = Date.now();
-      // Auto-clear interval once countdown expires
-      if (endMs !== undefined && now >= endMs) {
-        clearTimer();
-      }
-      setNowMs(now);
-    }, 1000);
-
-    return clearTimer;
-  }, [isTimerValid, endMs, clearTimer]);
-
-  const countdown = useMemo(() => {
-    if (!isTimerValid || endMs === undefined) {
-      return { shouldShow: false, text: "" };
-    }
-
-    const isBeforeStart = startMs !== undefined && nowMs < startMs;
-    const isAfterEnd = nowMs >= endMs;
-    if (isBeforeStart || isAfterEnd) return { shouldShow: false, text: "" };
-
-    const remainingSeconds = (endMs - nowMs) / 1000;
-    return {
-      shouldShow: remainingSeconds > 0,
-      text: formatCountdown(remainingSeconds),
-    };
-  }, [isTimerValid, endMs, startMs, nowMs]);
-
-  return (
-    <section id={anchorId}>
-      <div
-        className={`fixed bottom-0 left-0 right-0 z-[30] flex w-full items-center justify-center px-4 py-3 transition-all duration-300 ${bgClass} ${
-          boxShadow ? boxShadow : "shadow-[0_-4px_10px_rgba(0,0,0,0.1)]"
-        }`}
-      >
-        <Link
-          href={ctaButtonLink || "#"}
-          target={ctaButtonTarget || "_self"}
-          className="max-w-screen-xl w-full transition-all"
-        >
-          <div className="flex flex-col items-center justify-center gap-1 text-center font-black">
-            <div
-              className={`${textColorClass} break-words text-body1 font-black leading-snug md:text-[18px]`}
-            >
-              {iconName && (
-                <MaterialIcon
-                  name={
-                    iconName as React.ComponentProps<
-                      typeof MaterialIcon
-                    >["name"]
-                  }
-                  size={24}
-                  fill={1}
-                  className={`${textColorClass} align-text-bottom`}
-                />
-              )}
-              {countdown.shouldShow && (
-                <span className="inline-block whitespace-nowrap rounded-lg bg-white px-1 tabular-nums text-text">
-                  {countdown.text}
-                </span>
-              )}
-              {countdown.shouldShow ? " " : null}
-              {ctaButtonLabel && ctaButtonLabel}{" "}
-              {ctaSuffixText && <span className="ml-0.5">{ctaSuffixText}</span>}
-            </div>
-          </div>
-        </Link>
-      </div>
-    </section>
-  );
-};
-
-export default AnchoredBottomBanner;
+import React, {
+  useCallback,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+} from "react";
+import { AnchoredBottomBannerProps } from "./types";
+import Link from "next/link";
+
+import { MaterialIcon } from "@shared/components/material-icon";
+
+function parseCountdownDateTime(value?: string): number | undefined {
+  if (!value) return undefined;
+  const parsed = Date.parse(value);
+  if (!Number.isFinite(parsed)) {
+    console.error("Invalid countdown datetime", { value });
+    return undefined;
+  }
+  return parsed;
+}
+
+function formatCountdown(totalSeconds: number) {
+  const safeSeconds = Math.max(0, Math.floor(totalSeconds));
+  const hours = Math.floor(safeSeconds / 3600);
+  const minutes = Math.floor((safeSeconds % 3600) / 60);
+  const seconds = safeSeconds % 60;
+
+  return `${String(hours).padStart(2, "0")}H : ${String(minutes).padStart(2, "0")}M : ${String(seconds).padStart(2, "0")}`;
+}
+
+export const AnchoredBottomBanner: React.FC<AnchoredBottomBannerProps> = ({
+  ctaSuffixText,
+  backgroundColor,
+  iconName,
+  boxShadow,
+  ctaButtonLabel,
+  ctaButtonLink,
+  ctaButtonTarget,
+  anchorId = "anchored-banner",
+  enableCountdownTimer,
+  countdownStartDateTime,
+  countdownEndDateTime,
+}) => {
+  const backGroundColorClasses = {
+    navy: "bg-bg-fill-inverse",
+    green: "bg-bg-fill-success",
+    blue: "bg-bg-fill-brand-supporting",
+    purple: "bg-bg-fill-brand-tertiary",
+    yellow: "bg-bg-fill-brand-accent",
+    white: "bg-white",
+  };
+
+  const bgClass = backgroundColor
+    ? backGroundColorClasses[backgroundColor]
+    : "bg-bg-fill-brand-accent";
+
+  const isLightBackground =
+    backgroundColor === "yellow" ||
+    backgroundColor === "white" ||
+    !backgroundColor;
+  const textColorClass = isLightBackground ? "text-text-primary" : "text-white";
+
+  // Memoize parsed timestamps so they aren't re-parsed every second
+  const endMs = useMemo(
+    () => parseCountdownDateTime(countdownEndDateTime),
+    [countdownEndDateTime]
+  );
+  const startMs = useMemo(
+    () => parseCountdownDateTime(countdownStartDateTime),
+    [countdownStartDateTime]
+  );
+
+  const isTimerValid = useMemo(() => {
+    if (!enableCountdownTimer || endMs === undefined) return false;
+    if (countdownStartDateTime && startMs === undefined) return false;
+    if (startMs !== undefined && startMs >= endMs) {
+      console.error("Invalid countdown range: start must be before end", {
+        countdownStartDateTime,
+        countdownEndDateTime,
+      });
+      return false;
+    }
+    return true;
+  }, [
+    enableCountdownTimer,
+    endMs,
+    startMs,
+    countdownStartDateTime,
+    countdownEndDateTime,
+  ]);
+
+  const [nowMs, setNowMs] = useState(() => Date.now());
+  const intervalRef = useRef<number | null>(null);
+
+  const clearTimer = useCallback(() => {
+    if (intervalRef.current !== null) {
+      window.clearInterval(intervalRef.current);
+      intervalRef.current = null;
+    }
+  }, []);
+
+  useEffect(() => {
+    if (!isTimerValid) {
+      clearTimer();
+      return;
+    }
+
+    intervalRef.current = window.setInterval(() => {
+      const now = Date.now();
+      // Auto-clear interval once countdown expires
+      if (endMs !== undefined && now >= endMs) {
+        clearTimer();
+      }
+      setNowMs(now);
+    }, 1000);
+
+    return clearTimer;
+  }, [isTimerValid, endMs, clearTimer]);
+
+  const countdown = useMemo(() => {
+    if (!isTimerValid || endMs === undefined) {
+      return { shouldShow: false, text: "" };
+    }
+
+    const isBeforeStart = startMs !== undefined && nowMs < startMs;
+    const isAfterEnd = nowMs >= endMs;
+    if (isBeforeStart || isAfterEnd) return { shouldShow: false, text: "" };
+
+    const remainingSeconds = (endMs - nowMs) / 1000;
+    return {
+      shouldShow: remainingSeconds > 0,
+      text: formatCountdown(remainingSeconds),
+    };
+  }, [isTimerValid, endMs, startMs, nowMs]);
+
+  return (
+    <section id={anchorId}>
+      <div
+        className={`fixed bottom-0 left-0 right-0 z-[30] flex w-full items-center justify-center px-4 py-3 transition-all duration-300 ${bgClass} ${
+          boxShadow ? boxShadow : "shadow-[0_-4px_10px_rgba(0,0,0,0.1)]"
+        }`}
+      >
+        <Link
+          href={ctaButtonLink || "#"}
+          target={ctaButtonTarget || "_self"}
+          className="max-w-screen-xl w-full transition-all"
+        >
+          <div className="flex flex-col items-center justify-center gap-1 text-center font-black">
+            <div
+              className={`${textColorClass} break-words text-body1 font-black leading-snug md:text-[18px]`}
+            >
+              {iconName && (
+                <MaterialIcon
+                  name={
+                    iconName as React.ComponentProps<
+                      typeof MaterialIcon
+                    >["name"]
+                  }
+                  size={24}
+                  fill={1}
+                  className={`${textColorClass} align-text-bottom`}
+                />
+              )}
+              {countdown.shouldShow && (
+                <span className="inline-block whitespace-nowrap rounded-lg bg-white px-1 tabular-nums text-text">
+                  {countdown.text}
+                </span>
+              )}
+              {countdown.shouldShow ? " " : null}
+              {ctaButtonLabel && ctaButtonLabel}{" "}
+              {ctaSuffixText && <span className="ml-0.5">{ctaSuffixText}</span>}
+            </div>
+          </div>
+        </Link>
+      </div>
+    </section>
+  );
+};
+
+export default AnchoredBottomBanner;

package/src/contentful/blocks/anchored-bottom-banner/types.ts

@@ -1,13 +1,13 @@
-export interface AnchoredBottomBannerProps {
-  ctaSuffixText?: string;
-  backgroundColor?: "navy" | "yellow" | "green" | "purple" | "blue" | "white";
-  iconName?: string;
-  boxShadow?: boolean;
-  ctaButtonLabel?: string;
-  ctaButtonLink?: string;
-  ctaButtonTarget?: string;
-  anchorId?: string;
-  enableCountdownTimer?: boolean;
-  countdownStartDateTime?: string;
-  countdownEndDateTime?: string;
-}
+export interface AnchoredBottomBannerProps {
+  ctaSuffixText?: string;
+  backgroundColor?: "navy" | "yellow" | "green" | "purple" | "blue" | "white";
+  iconName?: string;
+  boxShadow?: boolean;
+  ctaButtonLabel?: string;
+  ctaButtonLink?: string;
+  ctaButtonTarget?: string;
+  anchorId?: string;
+  enableCountdownTimer?: boolean;
+  countdownStartDateTime?: string;
+  countdownEndDateTime?: string;
+}

package/src/contentful/blocks/blogs-grid/BlogGrid.stories.mocks.tsx

@@ -0,0 +1,144 @@
+import { BlogCardProps, BlogCategoryOption } from "./types";
+
+/* ----------------------
+   CATEGORY OPTIONS
+------------------------- */
+
+export const CATEGORY_OPTIONS: BlogCategoryOption[] = [
+  { value: "all", label: "All Categories" },
+  { value: "technology", label: "Technology" },
+  { value: "business", label: "Business" },
+  { value: "lifestyle", label: "Lifestyle" },
+  { value: "entertainment", label: "Entertainment" },
+];
+
+/* ----------------------
+   ARTICLES WITH COVERS (6)
+------------------------- */
+
+export const ARTICLES_WITH_COVERS: BlogCardProps[] = [
+  {
+    slug: "blog/getting-started-with-fiber",
+    title: "Getting Started with Fiber Internet",
+    shortDescription:
+      "Everything you need to know about making the switch to fiber optic internet for your home.",
+    blogCreationDate: "2025-12-01",
+    category: "Technology",
+    cover: {
+      url: "https://placehold.co/600x338/0ea5e9/ffffff?text=Fiber+Internet",
+      width: 600,
+      height: 338,
+      title: "Fiber internet illustration",
+    },
+  },
+  {
+    slug: "blog/smart-home-tips",
+    title: "10 Smart Home Tips for Beginners",
+    shortDescription:
+      "Transform your living space with these easy smart-home upgrades that anyone can do.",
+    blogCreationDate: "2025-11-18",
+    category: "Technology",
+    cover: {
+      url: "https://placehold.co/600x338/8b5cf6/ffffff?text=Smart+Home",
+      width: 600,
+      height: 338,
+      title: "Smart home devices",
+    },
+  },
+  {
+    slug: "blog/remote-work-connectivity",
+    title: "Stay Connected While Working Remotely",
+    shortDescription:
+      "Best practices for maintaining a rock-solid internet connection in your home office.",
+    blogCreationDate: "2025-11-05",
+    category: "Business",
+    cover: {
+      url: "https://placehold.co/600x338/f59e0b/ffffff?text=Remote+Work",
+      width: 600,
+      height: 338,
+      title: "Remote work setup",
+    },
+  },
+  {
+    slug: "blog/streaming-quality-guide",
+    title: "The Ultimate Streaming Quality Guide",
+    shortDescription:
+      "How to get the best picture and sound from your favorite streaming services.",
+    blogCreationDate: "2025-10-22",
+    category: "Entertainment",
+    cover: {
+      url: "https://placehold.co/600x338/ec4899/ffffff?text=Streaming",
+      width: 600,
+      height: 338,
+      title: "Streaming setup",
+    },
+  },
+  {
+    slug: "blog/digital-wellness",
+    title: "Digital Wellness: Finding Balance Online",
+    shortDescription:
+      "Practical strategies for maintaining a healthy relationship with technology.",
+    blogCreationDate: "2025-10-10",
+    category: "Lifestyle",
+    cover: {
+      url: "https://placehold.co/600x338/10b981/ffffff?text=Digital+Wellness",
+      width: 600,
+      height: 338,
+      title: "Digital wellness",
+    },
+  },
+  {
+    slug: "blog/cybersecurity-basics",
+    title: "Cybersecurity Basics for Every Household",
+    shortDescription:
+      "Simple steps to protect your family's data and devices from online threats.",
+    blogCreationDate: "2025-09-28",
+    category: "Technology",
+    cover: {
+      url: "https://placehold.co/600x338/ef4444/ffffff?text=Cybersecurity",
+      width: 600,
+      height: 338,
+      title: "Cybersecurity basics",
+    },
+  },
+];
+
+/* ----------------------
+   ARTICLES WITHOUT COVERS (3)
+------------------------- */
+
+export const ARTICLES_WITHOUT_COVERS: BlogCardProps[] = [
+  {
+    slug: "blog/home-network-setup",
+    title: "How to Set Up Your Home Network Like a Pro",
+    shortDescription:
+      "A step-by-step guide to configuring routers, extenders, and mesh systems.",
+    blogCreationDate: "2025-09-15",
+    category: "Technology",
+  },
+  {
+    slug: "blog/budgeting-internet-plan",
+    title: "Choosing the Right Internet Plan on a Budget",
+    shortDescription:
+      "Compare plans and find the best value for your household's internet needs.",
+    blogCreationDate: "2025-09-01",
+    category: "Business",
+  },
+  {
+    slug: "blog/gaming-online",
+    title: "Level Up Your Online Gaming Experience",
+    shortDescription:
+      "Reduce lag, improve ping, and get the most out of competitive online gaming.",
+    blogCreationDate: "2025-08-20",
+    category: "Entertainment",
+  },
+];
+
+/* ----------------------
+   COMBINED (all 9 articles)
+------------------------- */
+
+export const ALL_ARTICLES: BlogCardProps[] = [
+  ...ARTICLES_WITH_COVERS,
+  ...ARTICLES_WITHOUT_COVERS,
+];

package/src/contentful/blocks/blogs-grid/BlogGrid.stories.tsx

@@ -0,0 +1,156 @@
+import {
+  ALL_ARTICLES,
+  ARTICLES_WITH_COVERS,
+  ARTICLES_WITHOUT_COVERS,
+  CATEGORY_OPTIONS,
+} from "./BlogGrid.stories.mocks";
+import { BlogGrid } from "./index";
+import type { BlogGridProps } from "./types";
+
+import { DocsPage } from "@shared/stories/DocsTemplate";
+import type { ArgTypes, Meta, StoryObj } from "@storybook/react";
+
+/* ------------
+   ArgTypes
+--------------- */
+
+const argTypes: ArgTypes<BlogGridProps> = {
+  paginatedArticles: {
+    control: { type: "object" as const },
+    description: "Array of blog articles to display on the current page",
+  },
+  totalArticles: {
+    control: { type: "number" as const },
+    description: "Total number of articles across all pages",
+  },
+  currentPage: {
+    control: { type: "number" as const },
+    description: "Current active page number",
+  },
+  totalPages: {
+    control: { type: "number" as const },
+    description: "Total number of pages",
+  },
+  selectedCategory: {
+    control: { type: "object" as const },
+    description: "Currently selected category option",
+  },
+  categoryOptions: {
+    control: { type: "object" as const },
+    description: "Available category filter options",
+  },
+};
+
+/* --------
+   Meta
+----------- */
+
+const meta: Meta<typeof BlogGrid> = {
+  title: "Contentful Blocks/BlogGrid",
+  component: BlogGrid,
+  tags: ["autodocs"],
+  argTypes,
+  parameters: {
+    layout: "fullscreen",
+    docs: {
+      page: DocsPage,
+      description: {
+        component:
+          "A paginated, filterable grid of blog article cards with a category dropdown, article count summary, and pagination controls.",
+      },
+    },
+  },
+  args: {
+    paginatedArticles: ARTICLES_WITH_COVERS,
+    totalArticles: ALL_ARTICLES.length,
+    currentPage: 1,
+    totalPages: 2,
+    selectedCategory: CATEGORY_OPTIONS[0],
+    categoryOptions: CATEGORY_OPTIONS,
+  },
+};
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+/* --------
+   Stories
+----------- */
+
+export const Default: Story = {};
+
+export const WithPagination: Story = {
+  args: {
+    paginatedArticles: ARTICLES_WITH_COVERS,
+    totalArticles: 18,
+    currentPage: 2,
+    totalPages: 3,
+  },
+};
+
+export const SinglePage: Story = {
+  args: {
+    paginatedArticles: ARTICLES_WITH_COVERS,
+    totalArticles: 6,
+    currentPage: 1,
+    totalPages: 1,
+  },
+};
+
+export const EmptyState: Story = {
+  args: {
+    paginatedArticles: [],
+    totalArticles: 9,
+    currentPage: 1,
+    totalPages: 1,
+    selectedCategory: CATEGORY_OPTIONS[1],
+  },
+};
+
+export const CategoryFilterActive: Story = {
+  args: {
+    paginatedArticles: ALL_ARTICLES.filter(
+      (a) => a.category === "Technology",
+    ),
+    totalArticles: 4,
+    currentPage: 1,
+    totalPages: 1,
+    selectedCategory: CATEGORY_OPTIONS[1],
+  },
+};
+
+export const WithCoverImages: Story = {
+  args: {
+    paginatedArticles: ARTICLES_WITH_COVERS,
+    totalArticles: 6,
+    currentPage: 1,
+    totalPages: 1,
+  },
+};
+
+export const WithoutCoverImages: Story = {
+  args: {
+    paginatedArticles: ARTICLES_WITHOUT_COVERS,
+    totalArticles: 3,
+    currentPage: 1,
+    totalPages: 1,
+  },
+};
+
+export const MixedCoverImages: Story = {
+  args: {
+    paginatedArticles: [...ARTICLES_WITH_COVERS.slice(4), ...ARTICLES_WITHOUT_COVERS],
+    totalArticles: 5,
+    currentPage: 1,
+    totalPages: 1,
+  },
+};
+
+export const SingleArticle: Story = {
+  args: {
+    paginatedArticles: [ARTICLES_WITH_COVERS[0]],
+    totalArticles: 1,
+    currentPage: 1,
+    totalPages: 1,
+  },
+};