@windstream/react-shared-components 0.1.92 → 0.1.94

package/src/contentful/blocks/text/index.test.tsx

@@ -0,0 +1,36 @@
+import React from "react";
+import { Text } from "./index";
+
+import { render, screen } from "@testing-library/react";
+
+// Mock dependencies
+jest.mock("@shared/components/text", () => ({
+  Text: ({ children }: { children: React.ReactNode }) => (
+    <span data-testid="text-component">{children}</span>
+  ),
+}));
+
+describe("Text (Contentful Block)", () => {
+  describe("Rendering", () => {
+    it("renders the Text Block placeholder text", () => {
+      render(<Text fields={{}} />);
+      expect(screen.getByText("Text Block")).toBeInTheDocument();
+    });
+
+    it("renders inside a div wrapper", () => {
+      const { container } = render(<Text fields={{}} />);
+      expect(container.firstChild?.nodeName).toBe("DIV");
+    });
+
+    it("uses the shared TextComponent", () => {
+      render(<Text fields={{}} />);
+      expect(screen.getByTestId("text-component")).toBeInTheDocument();
+    });
+
+    it("renders consistently with empty fields object", () => {
+      const { container: first } = render(<Text fields={{}} />);
+      const { container: second } = render(<Text fields={{}} />);
+      expect(first.innerHTML).toBe(second.innerHTML);
+    });
+  });
+});

package/src/contentful/blocks/text/index.tsx

@@ -1,12 +1,12 @@
-import { TextProps } from "./types";
-
-import { Text as TextComponent } from "@shared/components/text";
-
-export const Text: React.FC<{ fields: TextProps }> = ({ fields }) => {
-  return (
-    <div>
-      <TextComponent>Text Block</TextComponent>
-    </div>
-  );
-};
-export default Text;
+import { TextProps } from "./types";
+
+import { Text as TextComponent } from "@shared/components/text";
+
+export const Text: React.FC<{ fields: TextProps }> = ({ fields }) => {
+  return (
+    <div>
+      <TextComponent>Text Block</TextComponent>
+    </div>
+  );
+};
+export default Text;

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

@@ -1 +1 @@
-export type TextProps = {};
+export type TextProps = {};

package/src/contentful/index.test.ts

@@ -0,0 +1,45 @@
+import * as ContentfulExports from "./index";
+
+describe("contentful barrel exports", () => {
+  it("exports all expected contentful blocks", () => {
+    expect(ContentfulExports.Accordion).toBeDefined();
+    expect(ContentfulExports.Callout).toBeDefined();
+    expect(ContentfulExports.Cards).toBeDefined();
+    expect(ContentfulExports.SimpleCard).toBeDefined();
+    expect(ContentfulExports.Carousel).toBeDefined();
+    expect(ContentfulExports.FloatingBanner).toBeDefined();
+    expect(ContentfulExports.Footer).toBeDefined();
+    expect(ContentfulExports.ImagePromoBar).toBeDefined();
+    expect(ContentfulExports.Navigation).toBeDefined();
+    expect(ContentfulExports.PrimaryHero).toBeDefined();
+    expect(ContentfulExports.Text).toBeDefined();
+    expect(ContentfulExports.Button).toBeDefined();
+    expect(ContentfulExports.Modal).toBeDefined();
+    expect(ContentfulExports.ShapeBackgroundWrapper).toBeDefined();
+    expect(ContentfulExports.CtaCallout).toBeDefined();
+    expect(ContentfulExports.FindKinetic).toBeDefined();
+    expect(ContentfulExports.ComparisonTable).toBeDefined();
+    expect(ContentfulExports.TestimonialCard).toBeDefined();
+    expect(ContentfulExports.ProductCard).toBeDefined();
+    expect(ContentfulExports.BlogCard).toBeDefined();
+    expect(ContentfulExports.BlogGrid).toBeDefined();
+    expect(ContentfulExports.BlogGridBase).toBeDefined();
+    expect(ContentfulExports.BreadcrumbNavigation).toBeDefined();
+    expect(ContentfulExports.SearchBlock).toBeDefined();
+    expect(ContentfulExports.AddressInputBanner).toBeDefined();
+    expect(ContentfulExports.DynamicTabs).toBeDefined();
+    expect(ContentfulExports.AnchoredBottomBanner).toBeDefined();
+    expect(ContentfulExports.CookieBanner).toBeDefined();
+    expect(ContentfulExports.EmailInputBlock).toBeDefined();
+    expect(ContentfulExports.CartRetentionBanner).toBeDefined();
+  });
+
+  it("exports contentful rich text utilities", () => {
+    expect(ContentfulExports.toDocument).toBeDefined();
+    expect(ContentfulExports.renderContentfulRichText).toBeDefined();
+    expect(ContentfulExports.useContentfulRichText).toBeDefined();
+    expect(ContentfulExports.renderContentfulRichTextTable).toBeDefined();
+    expect(ContentfulExports.useProcessedChecklist).toBeDefined();
+    expect(ContentfulExports.label1BoldOptions).toBeDefined();
+  });
+});

package/src/contentful/index.ts

@@ -1,105 +1,105 @@
-// Contentful Blocks
-export { Accordion } from "./blocks/accordion";
-export type { AccordionProps } from "./blocks/accordion/types";
-
-export { Callout } from "./blocks/callout";
-export type { CalloutProps } from "./blocks/callout/types";
-
-export { Cards } from "./blocks/cards";
-export type { CardsProps } from "./blocks/cards/types";
-
-export { SimpleCard } from "./blocks/cards/simple-card";
-export type { SimpleCardProps } from "./blocks/cards/simple-card/types";
-
-export { Carousel } from "./blocks/carousel";
-export type { CarouselProps } from "./blocks/carousel/types";
-
-export { FloatingBanner } from "./blocks/floating-banner";
-export type { FloatingBannerProps } from "./blocks/floating-banner/types";
-
-export { Footer } from "./blocks/footer";
-export type { FooterProps } from "./blocks/footer/types";
-
-export { ImagePromoBar } from "./blocks/image-promo-bar";
-export type { ImagePromoBarProps } from "./blocks/image-promo-bar/types";
-
-export { Navigation } from "./blocks/navigation";
-export type { NavigationProps } from "./blocks/navigation/types";
-
-export { PrimaryHero } from "./blocks/primary-hero";
-export type { PrimaryHeroProps } from "./blocks/primary-hero/types";
-
-export { Text } from "./blocks/text";
-export type { TextProps } from "./blocks/text/types";
-
-export { Button } from "./blocks/button";
-export type { ButtonProps } from "./blocks/button/types";
-
-export { Modal } from "./blocks/modal";
-export type { ModalProps } from "./blocks/modal/types";
-
-export { ShapeBackgroundWrapper } from "./blocks/shape-background-wrapper";
-export type { ShapeBackgroundWrapperProps } from "./blocks/shape-background-wrapper/types";
-
-export { CtaCallout } from "./blocks/cta-callout";
-export type { CtaCalloutProps } from "./blocks/cta-callout/types";
-
-export { FindKinetic } from "./blocks/find-kinetic";
-export type { FindKineticProps } from "./blocks/find-kinetic/types";
-
-export { ComparisonTable } from "./blocks/comparison-table";
-export type { ComparisonTableProps } from "./blocks/comparison-table/types";
-
-export { TestimonialCard } from "./blocks/cards/testimonial-card";
-export type { TestimonialCardProps } from "./blocks/cards/testimonial-card/types";
-
-export { ProductCard } from "./blocks/cards/product-card";
-export type { ProductCardProps } from "./blocks/cards/product-card/types";
-
-export { BlogCard } from "./blocks/cards/blog-card";
-export type { BlogCardProps } from "./blocks/cards/blog-card/types";
-
-export { BlogGrid } from "./blocks/blogs-grid";
-export type { BlogGridProps } from "./blocks/blogs-grid/types";
-
-export { BlogGridBase } from "./blocks/blogs-grid-base";
-export type { BlogGridBaseProps } from "./blocks/blogs-grid-base/types";
-
-export { BreadcrumbNavigation } from "./blocks/breadcrumbs";
-export type { BreadcrumbNavigationProps } from "./blocks/breadcrumbs/types";
-
-export { SearchBlock } from "./blocks/search-block";
-export type { SearchBlockProps } from "./blocks/search-block/types";
-
-export { AddressInputBanner } from "./blocks/address-input-banner";
-export type { AddressInputBannerProps } from "./blocks/address-input-banner/types";
-
-export { DynamicTabs } from "./blocks/dynamic-tabs";
-export type { DynamicTabsT } from "./blocks/dynamic-tabs/types";
-
-export { AnchoredBottomBanner } from "./blocks/anchored-bottom-banner";
-export type { AnchoredBottomBannerProps } from "./blocks/anchored-bottom-banner/types";
-
-export { default as CookieBanner } from "./blocks/cookiebanner";
-export type { TypeComponentRichTextFields as CookieBannerProps } from "./blocks/cookiebanner/type";
-
-export { EmailInputBlock } from "./blocks/email-input-block";
-export type { EmailInputBlockProps } from "./blocks/email-input-block/types";
-
-export { default as CartRetentionBanner } from "./blocks/cart-retention-banner";
-export type { TypeCartRetentionBannerFields as CartRetentionBannerProps } from "./blocks/cart-retention-banner/types";
-
-// Contentful Rich Text Hooks & Utils
-export { toDocument } from "../utils/contentful/to-document";
-
-export {
-  renderContentfulRichText,
-  useContentfulRichText,
-  renderContentfulRichTextTable,
-} from "../hooks/contentful/use-contentful-rich-text";
-
-export {
-  useProcessedChecklist,
-  label1BoldOptions,
-} from "../hooks/contentful/use-processed-check-list";
-export type { ProcessedChecklistItem } from "../hooks/contentful/use-processed-check-list";
+// Contentful Blocks
+export { Accordion } from "./blocks/accordion";
+export type { AccordionProps } from "./blocks/accordion/types";
+
+export { Callout } from "./blocks/callout";
+export type { CalloutProps } from "./blocks/callout/types";
+
+export { Cards } from "./blocks/cards";
+export type { CardsProps } from "./blocks/cards/types";
+
+export { SimpleCard } from "./blocks/cards/simple-card";
+export type { SimpleCardProps } from "./blocks/cards/simple-card/types";
+
+export { Carousel } from "./blocks/carousel";
+export type { CarouselProps } from "./blocks/carousel/types";
+
+export { FloatingBanner } from "./blocks/floating-banner";
+export type { FloatingBannerProps } from "./blocks/floating-banner/types";
+
+export { Footer } from "./blocks/footer";
+export type { FooterProps } from "./blocks/footer/types";
+
+export { ImagePromoBar } from "./blocks/image-promo-bar";
+export type { ImagePromoBarProps } from "./blocks/image-promo-bar/types";
+
+export { Navigation } from "./blocks/navigation";
+export type { NavigationProps } from "./blocks/navigation/types";
+
+export { PrimaryHero } from "./blocks/primary-hero";
+export type { PrimaryHeroProps } from "./blocks/primary-hero/types";
+
+export { Text } from "./blocks/text";
+export type { TextProps } from "./blocks/text/types";
+
+export { Button } from "./blocks/button";
+export type { ButtonProps } from "./blocks/button/types";
+
+export { Modal } from "./blocks/modal";
+export type { ModalProps } from "./blocks/modal/types";
+
+export { ShapeBackgroundWrapper } from "./blocks/shape-background-wrapper";
+export type { ShapeBackgroundWrapperProps } from "./blocks/shape-background-wrapper/types";
+
+export { CtaCallout } from "./blocks/cta-callout";
+export type { CtaCalloutProps } from "./blocks/cta-callout/types";
+
+export { FindKinetic } from "./blocks/find-kinetic";
+export type { FindKineticProps } from "./blocks/find-kinetic/types";
+
+export { ComparisonTable } from "./blocks/comparison-table";
+export type { ComparisonTableProps } from "./blocks/comparison-table/types";
+
+export { TestimonialCard } from "./blocks/cards/testimonial-card";
+export type { TestimonialCardProps } from "./blocks/cards/testimonial-card/types";
+
+export { ProductCard } from "./blocks/cards/product-card";
+export type { ProductCardProps } from "./blocks/cards/product-card/types";
+
+export { BlogCard } from "./blocks/cards/blog-card";
+export type { BlogCardProps } from "./blocks/cards/blog-card/types";
+
+export { BlogGrid } from "./blocks/blogs-grid";
+export type { BlogGridProps } from "./blocks/blogs-grid/types";
+
+export { BlogGridBase } from "./blocks/blogs-grid-base";
+export type { BlogGridBaseProps } from "./blocks/blogs-grid-base/types";
+
+export { BreadcrumbNavigation } from "./blocks/breadcrumbs";
+export type { BreadcrumbNavigationProps } from "./blocks/breadcrumbs/types";
+
+export { SearchBlock } from "./blocks/search-block";
+export type { SearchBlockProps } from "./blocks/search-block/types";
+
+export { AddressInputBanner } from "./blocks/address-input-banner";
+export type { AddressInputBannerProps } from "./blocks/address-input-banner/types";
+
+export { DynamicTabs } from "./blocks/dynamic-tabs";
+export type { DynamicTabsT } from "./blocks/dynamic-tabs/types";
+
+export { AnchoredBottomBanner } from "./blocks/anchored-bottom-banner";
+export type { AnchoredBottomBannerProps } from "./blocks/anchored-bottom-banner/types";
+
+export { default as CookieBanner } from "./blocks/cookiebanner";
+export type { TypeComponentRichTextFields as CookieBannerProps } from "./blocks/cookiebanner/type";
+
+export { EmailInputBlock } from "./blocks/email-input-block";
+export type { EmailInputBlockProps } from "./blocks/email-input-block/types";
+
+export { default as CartRetentionBanner } from "./blocks/cart-retention-banner";
+export type { TypeCartRetentionBannerFields as CartRetentionBannerProps } from "./blocks/cart-retention-banner/types";
+
+// Contentful Rich Text Hooks & Utils
+export { toDocument } from "../utils/contentful/to-document";
+
+export {
+  renderContentfulRichText,
+  useContentfulRichText,
+  renderContentfulRichTextTable,
+} from "../hooks/contentful/use-contentful-rich-text";
+
+export {
+  useProcessedChecklist,
+  label1BoldOptions,
+} from "../hooks/contentful/use-processed-check-list";
+export type { ProcessedChecklistItem } from "../hooks/contentful/use-processed-check-list";

package/src/global-mocks/contentful/to-document.ts

@@ -0,0 +1,25 @@
+/* eslint-env jest */
+/**
+ * Mock: utils/contentful/to-document.ts
+ *
+ * Provides a mock `toDocument` that returns null by default.
+ *
+ * Usage:
+ *   import { mockToDocumentUtil, resetToDocumentMocks } from "@shared/global-mocks/contentful/to-document";
+ *   mockToDocumentUtil();
+ *   afterEach(resetToDocumentMocks);
+ */
+
+export const mockToDocument = jest.fn().mockReturnValue(null);
+
+export function mockToDocumentUtil() {
+  jest.mock("@shared/utils/contentful/to-document", () => ({
+    toDocument: mockToDocument,
+  }));
+
+  return { mockToDocument };
+}
+
+export function resetToDocumentMocks() {
+  mockToDocument.mockReset().mockReturnValue(null);
+}

package/src/global-mocks/cookie.ts

@@ -0,0 +1,48 @@
+/* eslint-env jest */
+/**
+ * Mock: utils/cookie.ts
+ *
+ * Provides mock implementations for all cookie utility functions.
+ * Uses `jest.mock` with the `@shared/utils/cookie` path alias.
+ *
+ * Usage:
+ *   import { mockCookieUtils, resetCookieMocks } from "@shared/global-mocks/cookie";
+ *   mockCookieUtils();          // call at top-level (hoisted by Jest)
+ *   afterEach(resetCookieMocks);
+ */
+
+export const mockGetUTMs = jest.fn().mockReturnValue(null);
+export const mockSetUTMs = jest.fn();
+export const mockRemoveUTMs = jest.fn();
+export const mockGetCookie = jest.fn().mockReturnValue(null);
+export const mockGetParsedCookie = jest.fn().mockReturnValue(null);
+export const mockSetCookie = jest.fn();
+
+export function mockCookieUtils() {
+  jest.mock("@shared/utils/cookie", () => ({
+    getUTMs: mockGetUTMs,
+    setUTMs: mockSetUTMs,
+    removeUTMs: mockRemoveUTMs,
+    getCookie: mockGetCookie,
+    getParsedCookie: mockGetParsedCookie,
+    setCookie: mockSetCookie,
+  }));
+
+  return {
+    mockGetUTMs,
+    mockSetUTMs,
+    mockRemoveUTMs,
+    mockGetCookie,
+    mockGetParsedCookie,
+    mockSetCookie,
+  };
+}
+
+export function resetCookieMocks() {
+  mockGetUTMs.mockReset().mockReturnValue(null);
+  mockSetUTMs.mockReset();
+  mockRemoveUTMs.mockReset();
+  mockGetCookie.mockReset().mockReturnValue(null);
+  mockGetParsedCookie.mockReset().mockReturnValue(null);
+  mockSetCookie.mockReset();
+}

package/src/global-mocks/cx.ts

@@ -0,0 +1,37 @@
+/* eslint-env jest */
+/**
+ * Mock: utils/cx.ts
+ *
+ * Provides a mock `cx` that simply joins truthy arguments with a space.
+ *
+ * Usage:
+ *   import { mockCxUtil, resetCxMocks } from "@shared/global-mocks/cx";
+ *   mockCxUtil();
+ *   afterEach(resetCxMocks);
+ */
+
+export const mockCx = jest
+  .fn()
+  .mockImplementation((...args: unknown[]) => args.filter(Boolean).join(" "));
+
+export const mockClsx = jest
+  .fn()
+  .mockImplementation((...args: unknown[]) => args.filter(Boolean).join(" "));
+
+export function mockCxUtil() {
+  jest.mock("@shared/utils/cx", () => ({
+    cx: mockCx,
+    clsx: mockClsx,
+  }));
+
+  return { mockCx, mockClsx };
+}
+
+export function resetCxMocks() {
+  mockCx
+    .mockReset()
+    .mockImplementation((...args: unknown[]) => args.filter(Boolean).join(" "));
+  mockClsx
+    .mockReset()
+    .mockImplementation((...args: unknown[]) => args.filter(Boolean).join(" "));
+}

package/src/global-mocks/index.ts

@@ -0,0 +1,89 @@
+// ── Convenience helpers ────────────────────────────────
+import {
+  mockToDocumentUtil,
+  resetToDocumentMocks,
+} from "./contentful/to-document";
+import { mockCookieUtils, resetCookieMocks } from "./cookie";
+import { mockCxUtil, resetCxMocks } from "./cx";
+import { resetJsCookieMocks } from "./external/js-cookie";
+import { mockSpeedCardBgUtil, resetSpeedCardBgMocks } from "./speed-card-bg";
+import { mockUtmUtils, resetUtmMocks } from "./utm";
+
+/**
+ * Global Mocks — Barrel Export
+ *
+ * Re-exports every mock from the individual modules so consumers
+ * can import from a single entry point:
+ *
+ *   import { mockCookieUtils, mockUtmUtils } from "@shared/global-mocks";
+ *
+ * Or import from a specific module to keep dependencies narrow:
+ *
+ *   import { mockCookieUtils } from "@shared/global-mocks/cookie";
+ */
+
+// ── Individual modules ─────────────────────────────────
+export {
+  mockGetUTMs,
+  mockSetUTMs,
+  mockRemoveUTMs,
+  mockGetCookie,
+  mockGetParsedCookie,
+  mockSetCookie,
+  mockCookieUtils,
+  resetCookieMocks,
+} from "./cookie";
+
+export { mockCx, mockClsx, mockCxUtil, resetCxMocks } from "./cx";
+
+export {
+  mockSpeedCardBg,
+  mockSpeedCardBgUtil,
+  resetSpeedCardBgMocks,
+} from "./speed-card-bg";
+
+export {
+  mockGetUtmParametersFromURL,
+  mockCombineExistingAndNewUTMs,
+  mockGetOrganicTrafficUtmParameters,
+  mockGetCampaignProperties,
+  mockBuildPreservedQueryHref,
+  mockUtmUtils,
+  resetUtmMocks,
+} from "./utm";
+
+export {
+  mockToDocument,
+  mockToDocumentUtil,
+  resetToDocumentMocks,
+} from "./contentful/to-document";
+
+// ── External dependencies ──────────────────────────────
+export {
+  mockedCookies,
+  mockCookiesGet,
+  mockCookiesSet,
+  mockCookiesRemove,
+  resetJsCookieMocks,
+} from "./external/js-cookie";
+
+/** Activate mocks for ALL utility modules at once. */
+export function mockAllUtils() {
+  const cookie = mockCookieUtils();
+  const utm = mockUtmUtils();
+  const cx = mockCxUtil();
+  const speedCardBg = mockSpeedCardBgUtil();
+  const toDoc = mockToDocumentUtil();
+
+  return { ...cookie, ...utm, ...cx, ...speedCardBg, ...toDoc };
+}
+
+/** Reset every utility mock to its default state. */
+export function resetAllUtilMocks() {
+  resetCookieMocks();
+  resetCxMocks();
+  resetSpeedCardBgMocks();
+  resetUtmMocks();
+  resetToDocumentMocks();
+  resetJsCookieMocks();
+}

package/src/global-mocks/speed-card-bg.ts

@@ -0,0 +1,27 @@
+/* eslint-env jest */
+/**
+ * Mock: utils/speed-card-bg.ts
+ *
+ * Provides a mock `SpeedCardBg` that returns a minimal SVG string.
+ *
+ * Usage:
+ *   import { mockSpeedCardBgUtil, resetSpeedCardBgMocks } from "@shared/global-mocks/speed-card-bg";
+ *   mockSpeedCardBgUtil();
+ *   afterEach(resetSpeedCardBgMocks);
+ */
+
+export const mockSpeedCardBg = jest.fn().mockReturnValue("<svg></svg>");
+
+export function mockSpeedCardBgUtil() {
+  jest.mock("@shared/utils/speed-card-bg", () => ({
+    __esModule: true,
+    SpeedCardBg: mockSpeedCardBg,
+    default: mockSpeedCardBg,
+  }));
+
+  return { mockSpeedCardBg };
+}
+
+export function resetSpeedCardBgMocks() {
+  mockSpeedCardBg.mockReset().mockReturnValue("<svg></svg>");
+}

package/src/global-mocks/utm.ts

@@ -0,0 +1,49 @@
+/* eslint-env jest */
+/**
+ * Mock: utils/utm.ts
+ *
+ * Provides mock implementations for all UTM utility functions.
+ *
+ * Usage:
+ *   import { mockUtmUtils, resetUtmMocks } from "@shared/global-mocks/utm";
+ *   mockUtmUtils();
+ *   afterEach(resetUtmMocks);
+ */
+
+export const mockGetUtmParametersFromURL = jest.fn().mockReturnValue(null);
+export const mockCombineExistingAndNewUTMs = jest.fn().mockReturnValue({});
+export const mockGetOrganicTrafficUtmParameters = jest
+  .fn()
+  .mockReturnValue(null);
+export const mockGetCampaignProperties = jest.fn().mockReturnValue(null);
+export const mockBuildPreservedQueryHref = jest
+  .fn()
+  .mockImplementation((href: string) => href);
+
+export function mockUtmUtils() {
+  jest.mock("@shared/utils/utm", () => ({
+    getUtmParametersFromURL: mockGetUtmParametersFromURL,
+    combineExistingAndNewUTMs: mockCombineExistingAndNewUTMs,
+    getOrganicTrafficUtmParameters: mockGetOrganicTrafficUtmParameters,
+    getCampaignProperties: mockGetCampaignProperties,
+    buildPreservedQueryHref: mockBuildPreservedQueryHref,
+  }));
+
+  return {
+    mockGetUtmParametersFromURL,
+    mockCombineExistingAndNewUTMs,
+    mockGetOrganicTrafficUtmParameters,
+    mockGetCampaignProperties,
+    mockBuildPreservedQueryHref,
+  };
+}
+
+export function resetUtmMocks() {
+  mockGetUtmParametersFromURL.mockReset().mockReturnValue(null);
+  mockCombineExistingAndNewUTMs.mockReset().mockReturnValue({});
+  mockGetOrganicTrafficUtmParameters.mockReset().mockReturnValue(null);
+  mockGetCampaignProperties.mockReset().mockReturnValue(null);
+  mockBuildPreservedQueryHref
+    .mockReset()
+    .mockImplementation((href: string) => href);
+}