@windstream/react-shared-components 0.1.19 → 0.1.21

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

@@ -1,111 +1,121 @@
-import React from "react";
-import { ButtonProps } from "./types";
-
-import { BrandButton } from "@shared/components/brand-button";
-import { Button as CoreButton } from "@shared/components/button";
-import { Link } from "@shared/components/link";
-import { MaterialIcon } from "@shared/components/material-icon";
-
-export const Button: React.FC<ButtonProps> = props => {
-  const {
-    showButtonAs = "solid",
-    buttonVariant = "primary_brand",
-    buttonLabel,
-    buttonPrefix,
-    href,
-    target = "_blank",
-    anchorId,
-    linkClassName,
-    linkVariant,
-    fullWidth,
-    preDefinedFunctionExecution,
-    renderCheckPlans,
-    buttonClassName,
-    clickToOpen,
-    tabmodalNameToOpen,
-    onModalButtonClick,
-    onClick,
-    iconName,
-    size,
-    ...rest
-  } = props;
-
-  if (preDefinedFunctionExecution === "check availability") {
-    const checkPlansNode = renderCheckPlans?.({
-      ctaText: buttonLabel,
-      buttonVariant: buttonVariant,
-      showButtonAs: showButtonAs,
-      cta: { ...props },
-    });
-    return checkPlansNode;
-  }
-
-  function handleModalClick() {
-    if (clickToOpen === "modal") {
-      onModalButtonClick?.(tabmodalNameToOpen);
-    }
-  }
-
-  function linkClick(event: React.MouseEvent<HTMLAnchorElement>) {
-    handleModalClick();
-    onClick?.(event);
-  }
-
-  function buttonClick(event: React.MouseEvent<HTMLButtonElement>) {
-    handleModalClick();
-    onClick?.(event);
-  }
-
-  let CTA = (
-    <CoreButton onClick={buttonClick} className={buttonClassName} {...rest} />
-  );
-
-  switch (showButtonAs) {
-    case "solid":
-      CTA = href ? (
-        <BrandButton
-          as="a"
-          href={href}
-          id={anchorId}
-          variant={buttonVariant}
-          text={buttonLabel}
-          label={buttonPrefix}
-          fullWidth={fullWidth}
-          size={size}
-          onClick={linkClick}
-        />
-      ) : (
-        <BrandButton
-          id={anchorId}
-          variant={buttonVariant}
-          text={buttonLabel}
-          label={buttonPrefix}
-          fullWidth={fullWidth}
-          size={size}
-          onClick={buttonClick}
-        />
-      );
-      break;
-    case "text":
-      CTA = (
-        <Link
-          href={href}
-          target={target}
-          variant={linkVariant || "default"}
-          className={`text-text-brand ${linkClassName || ""}`}
-          onClick={linkClick}
-        >
-          {buttonLabel}{" "}
-          {iconName && <MaterialIcon name={iconName as any} size={24} />}
-        </Link>
-      );
-      break;
-    case "unstyled": // For unstyled, we can use the CoreButton without any additional styling
-      break;
-    default: // For default, we can use the CoreButton without any additional styling
-      break;
-  }
-
-  return CTA;
-};
-export default Button;
+import React from "react";
+import { ButtonProps } from "./types";
+
+import { BrandButton } from "@shared/components/brand-button";
+import { Button as CoreButton } from "@shared/components/button";
+import { Link } from "@shared/components/link";
+import { MaterialIcon } from "@shared/components/material-icon";
+import { buildPreservedQueryHref } from "@shared/utils/utm";
+
+export const Button: React.FC<ButtonProps> = props => {
+  const {
+    showButtonAs = "solid",
+    buttonVariant = "primary_brand",
+    buttonLabel,
+    buttonPrefix,
+    href,
+    target = "_blank",
+    anchorId,
+    linkClassName,
+    linkVariant,
+    fullWidth,
+    preDefinedFunctionExecution,
+    renderCheckPlans,
+    buttonClassName,
+    clickToOpen,
+    tabmodalNameToOpen,
+    onModalButtonClick,
+    onClick,
+    iconName,
+    size,
+    preserveQueryParameters,
+    ...rest
+  } = props;
+
+  if (preDefinedFunctionExecution === "check availability") {
+    const checkPlansNode = renderCheckPlans?.({
+      ctaText: buttonLabel,
+      buttonVariant: buttonVariant,
+      showButtonAs: showButtonAs,
+      cta: { ...props },
+    });
+    return checkPlansNode;
+  }
+
+  function handleModalClick() {
+    if (clickToOpen === "modal") {
+      onModalButtonClick?.(tabmodalNameToOpen);
+    }
+  }
+
+  function linkClick(event: React.MouseEvent<HTMLAnchorElement>) {
+    handleModalClick();
+    onClick?.(event);
+  }
+
+  function buttonClick(event: React.MouseEvent<HTMLButtonElement>) {
+    handleModalClick();
+    onClick?.(event);
+  }
+
+  // Resolve the final href — merge non-UTM query params when preserveQueryParameters is true
+  const currentSearch =
+    typeof window !== "undefined" ? window.location.search : "";
+  const resolvedHref =
+    href && preserveQueryParameters && currentSearch
+      ? buildPreservedQueryHref(href, currentSearch)
+      : href;
+
+  let CTA = (
+    <CoreButton onClick={buttonClick} className={buttonClassName} {...rest} />
+  );
+
+  switch (showButtonAs) {
+    case "solid":
+      CTA = resolvedHref ? (
+        <BrandButton
+          as="a"
+          href={resolvedHref}
+          id={anchorId}
+          variant={buttonVariant}
+          text={buttonLabel}
+          label={buttonPrefix}
+          fullWidth={fullWidth}
+          size={size}
+          onClick={linkClick}
+        />
+      ) : (
+        <BrandButton
+          id={anchorId}
+          variant={buttonVariant}
+          text={buttonLabel}
+          label={buttonPrefix}
+          fullWidth={fullWidth}
+          size={size}
+          onClick={buttonClick}
+        />
+      );
+      break;
+    case "text":
+      CTA = (
+        <Link
+          href={resolvedHref}
+          target={target}
+          variant={linkVariant || "default"}
+          className={`text-text-brand ${linkClassName || ""}`}
+          onClick={linkClick}
+        >
+          {buttonLabel}{" "}
+          {iconName && <MaterialIcon name={iconName as any} size={24} />}
+        </Link>
+      );
+      break;
+    case "unstyled": // For unstyled, we can use the CoreButton without any additional styling
+      break;
+    default: // For default, we can use the CoreButton without any additional styling
+      break;
+  }
+
+  return CTA;
+};
+export default Button;

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

@@ -1,36 +1,36 @@
-import React from "react";
-
-import { CheckPlansProps } from "@shared/types/micro-components";
-import { ResponsiveSize } from "@shared/components/brand-button/types";
-
-export type ButtonProps = {
-  showButtonAs?: "solid" | "text" | "unstyled";
-  buttonVariant?: "primary_brand" | "secondary" | "primary_inverse";
-  buttonLabel?: string;
-  buttonPrefix?: string;
-  badge?: string;
-  badgeIcon?: string;
-  buttonIcon?: string;
-  buttonIconPosition?: "left" | "right";
-  href?: string;
-  target?: "_self" | "_blank";
-  anchorId?: string;
-  preserveQueryParameters?: boolean;
-  clickToOpen?: string;
-  tabmodalNameToOpen?: string;
-  preDefinedFunctionExecution?: string;
-  renderCheckPlans?: (overrides?: CheckPlansProps) => React.ReactNode;
-  linkClassName?: string;
-  buttonClassName?: string;
-  linkVariant?: "unstyled" | "default";
-  fullWidth?: boolean;
-  size?: ResponsiveSize;
-  onClick?: (
-    event: React.MouseEvent<HTMLAnchorElement | HTMLButtonElement>
-  ) => void;
-  children?: React.ReactNode;
-  modalTitle?: string;
-  modalSubtitle?: string;
-  onModalButtonClick?: (id?: string) => void;
-  iconName?: string;
-};
+import React from "react";
+
+import { ResponsiveSize } from "@shared/components/brand-button/types";
+import { CheckPlansProps } from "@shared/types/micro-components";
+
+export type ButtonProps = {
+  showButtonAs?: "solid" | "text" | "unstyled";
+  buttonVariant?: "primary_brand" | "secondary" | "primary_inverse";
+  buttonLabel?: string;
+  buttonPrefix?: string;
+  badge?: string;
+  badgeIcon?: string;
+  buttonIcon?: string;
+  buttonIconPosition?: "left" | "right";
+  href?: string;
+  target?: "_self" | "_blank";
+  anchorId?: string;
+  preserveQueryParameters?: boolean;
+  clickToOpen?: string;
+  tabmodalNameToOpen?: string;
+  preDefinedFunctionExecution?: string;
+  renderCheckPlans?: (overrides?: CheckPlansProps) => React.ReactNode;
+  linkClassName?: string;
+  buttonClassName?: string;
+  linkVariant?: "unstyled" | "default";
+  fullWidth?: boolean;
+  size?: ResponsiveSize;
+  onClick?: (
+    event: React.MouseEvent<HTMLAnchorElement | HTMLButtonElement>
+  ) => void;
+  children?: React.ReactNode;
+  modalTitle?: string;
+  modalSubtitle?: string;
+  onModalButtonClick?: (id?: string) => void;
+  iconName?: string;
+};

package/src/contentful/blocks/callout/Callout.stories.tsx

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

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

@@ -1,86 +1,86 @@
-import React from "react";
-import BlogCard from "../cards/blog-card";
-import SimpleCard from "../cards/simple-card";
-import { CalloutProps } from "./types";
-
-import { Text } from "@shared/components/text";
-
-export const Callout: React.FC<CalloutProps> = ({
-  title,
-  items,
-  enableHeading = false,
-  subtitle,
-  color = "dark",
-  maxWidth = true,
-  maxCardsPerRow,
-  cardType = "simple",
-}) => {
-  const lgWidth =
-    {
-      1: " lg:w-full",
-      2: " lg:w-[calc(50%-0.75rem)]",
-      3: " lg:w-[calc(33.3333%-1rem)]",
-      4: " lg:w-[calc(25%-1.125rem)]",
-    }[maxCardsPerRow || 4] || " lg:w-[calc(25%-1.125rem)]";
-
-  const mdWidth = items.length === 1 ? " md:w-full" : " md:w-[calc(50%-1rem)]";
-
-  const renderCard = (item: CalloutProps["items"][number], index: number) => {
-    if (cardType === "blog") {
-      const blogItem = item as any;
-      return (
-        <BlogCard
-          title={blogItem.title}
-          href={blogItem.slug}
-          description={blogItem.shortDescription}
-          date={blogItem.blogCreationDate}
-          category={blogItem.category}
-          image={blogItem.cover}
-          asGrid={false}
-        />
-      );
-    }
-    return (
-      <SimpleCard
-        key={index}
-        card={item as any}
-        lgWidth={lgWidth}
-        mdWidth={mdWidth}
-      />
-    );
-  };
-
-  return (
-    <div className="component-container">
-      <div
-        className={`mx-5 mb-5 mt-12 ${maxWidth ? "max-w-120 xl:mx-auto" : ""} ${color == "dark" ? "text-text" : "text-white"}`}
-      >
-        <div className="callout-container flex flex-col gap-8">
-          <div className="title-holder">
-            {title && (
-              <Text
-                as={enableHeading ? "h1" : "h2"}
-                className="heading2 md:heading1 md:text-center"
-              >
-                {title}
-              </Text>
-            )}
-            {subtitle && (
-              <Text
-                as={enableHeading ? "h2" : "h3"}
-                className="subheading3 mt-3 md:subheading1 md:text-center"
-              >
-                {subtitle}
-              </Text>
-            )}
-          </div>
-          <div className="card-holder flex flex-wrap items-stretch justify-center gap-8 self-stretch lg:gap-6">
-            {items.map((item, index: number) => renderCard(item, index))}
-          </div>
-        </div>
-      </div>
-    </div>
-  );
-};
-
-export default Callout;
+import React from "react";
+import BlogCard from "../cards/blog-card";
+import SimpleCard from "../cards/simple-card";
+import { CalloutProps } from "./types";
+
+import { Text } from "@shared/components/text";
+
+export const Callout: React.FC<CalloutProps> = ({
+  title,
+  items,
+  enableHeading = false,
+  subtitle,
+  color = "dark",
+  maxWidth = true,
+  maxCardsPerRow,
+  cardType = "simple",
+}) => {
+  const lgWidth =
+    {
+      1: " lg:w-full",
+      2: " lg:w-[calc(50%-0.75rem)]",
+      3: " lg:w-[calc(33.3333%-1rem)]",
+      4: " lg:w-[calc(25%-1.125rem)]",
+    }[maxCardsPerRow || 4] || " lg:w-[calc(25%-1.125rem)]";
+
+  const mdWidth = items.length === 1 ? " md:w-full" : " md:w-[calc(50%-1rem)]";
+
+  const renderCard = (item: CalloutProps["items"][number], index: number) => {
+    if (cardType === "blog") {
+      const blogItem = item as any;
+      return (
+        <BlogCard
+          title={blogItem.title}
+          href={blogItem.slug}
+          description={blogItem.shortDescription}
+          date={blogItem.blogCreationDate}
+          category={blogItem.category}
+          image={blogItem.cover}
+          asGrid={false}
+        />
+      );
+    }
+    return (
+      <SimpleCard
+        key={index}
+        card={item as any}
+        lgWidth={lgWidth}
+        mdWidth={mdWidth}
+      />
+    );
+  };
+
+  return (
+    <div className="component-container">
+      <div
+        className={`mx-5 mb-5 mt-12 ${maxWidth ? "max-w-120 xl:mx-auto" : ""} ${color == "dark" ? "text-text" : "text-white"}`}
+      >
+        <div className="callout-container flex flex-col gap-8">
+          <div className="title-holder">
+            {title && (
+              <Text
+                as={enableHeading ? "h1" : "h2"}
+                className="heading2 md:heading1 md:text-center"
+              >
+                {title}
+              </Text>
+            )}
+            {subtitle && (
+              <Text
+                as={enableHeading ? "h2" : "h3"}
+                className="subheading3 mt-3 md:subheading1 md:text-center"
+              >
+                {subtitle}
+              </Text>
+            )}
+          </div>
+          <div className="card-holder flex flex-wrap items-stretch justify-center gap-8 self-stretch lg:gap-6">
+            {items.map((item, index: number) => renderCard(item, index))}
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+};
+
+export default Callout;

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

@@ -1,15 +1,15 @@
-export type CalloutProps = {
-  title?: string;
-  enableHeading?: boolean;
-  subtitle?: string;
-  applyBoxShadow?: boolean;
-  cardStackingMobile?: boolean;
-  bottomText?: string;
-  color?: "dark" | "light";
-  cardsWidth?: string;
-  maxCardsPerRow?: number;
-  noGutter?: boolean;
-  items: any[];
-  maxWidth?: boolean;
-  cardType?: "simple" | "blog";
-};
+export type CalloutProps = {
+  title?: string;
+  enableHeading?: boolean;
+  subtitle?: string;
+  applyBoxShadow?: boolean;
+  cardStackingMobile?: boolean;
+  bottomText?: string;
+  color?: "dark" | "light";
+  cardsWidth?: string;
+  maxCardsPerRow?: number;
+  noGutter?: boolean;
+  items: any[];
+  maxWidth?: boolean;
+  cardType?: "simple" | "blog";
+};

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 = {};