@windstream/react-shared-components 0.1.91 → 0.1.93

package/src/contentful/blocks/navigation/Navigation.stories.mocks.tsx

@@ -0,0 +1,78 @@
+export const PRIMARY_LINKS: any = [
+  {
+    __typename: "ComponentButton",
+    buttonLabel: "Home",
+    href: "/",
+    preserveQueryParameters: false,
+  },
+  {
+    __typename: "ComponentButton",
+    buttonLabel: "Products",
+    href: "/products",
+    preserveQueryParameters: false,
+  },
+  {
+    __typename: "ComponentButtonGroup",
+    title: "Services",
+    items: {
+      items: [
+        {
+          __typename: "ComponentButton",
+          buttonLabel: "Internet",
+          href: "/internet",
+        },
+        {
+          __typename: "ComponentButton",
+          buttonLabel: "Phone",
+          href: "/phone",
+        },
+      ],
+    },
+  },
+];
+
+export const UTILITY_LINKS: any = [
+   {
+    __typename: "ComponentButton",
+    buttonLabel: "Residential",
+    href: "/residential",
+  },
+  {
+    __typename: "ComponentButton",
+    buttonLabel: "Business",
+    href: "/business",
+  },
+ 
+];
+
+export const ACCOUNT_LINKS: any = [
+  {
+    __typename: "ComponentButtonGroup",
+    title: "My Account",
+    items: {
+      items: [
+        {
+          __typename: "ComponentButton",
+          buttonLabel: "Profile",
+          href: "/profile",
+        },
+      ],
+    },
+  },
+];
+
+export const SUPPORT_LINKS: any = [
+  {
+    __typename: "ComponentButtonGroup",
+    title: "Support",
+    items: {
+      items: [
+        {
+          __typename: "ComponentButton",
+          buttonLabel: "Help",
+          href: "/help",
+        },
+      ],
+    },
+  },
+];

package/src/contentful/blocks/navigation/Navigation.stories.tsx

@@ -0,0 +1,138 @@
+import { Navigation } from "./index";
+import type { Meta, StoryObj } from "@storybook/react";
+import { DocsPage } from "@shared/stories/DocsTemplate";
+
+import {
+  PRIMARY_LINKS,
+  UTILITY_LINKS,
+  ACCOUNT_LINKS,
+  SUPPORT_LINKS,
+} from "./Navigation.stories.mocks";
+
+const meta: Meta<typeof Navigation> = {
+  title: "Contentful Blocks/Navigation",
+  component: Navigation,
+  tags: ["autodocs"],
+
+  parameters: {
+    docs: {
+      page: DocsPage,
+      description: {
+        component:
+          "Navigation component that includes utility navigation, main navigation, support/account links, search, and mobile drawer.",
+      },
+    },
+  },
+
+  args: {
+    primaryNavigationLinks: PRIMARY_LINKS,
+    primaryNavigationLogo: undefined,
+
+    utilityNavigationLinks: UTILITY_LINKS,
+    accountNavigationLinks: ACCOUNT_LINKS,
+    supportNavigationLinks: SUPPORT_LINKS,
+
+    displayUtilityNavigation: true,
+    displaySearchBar: true,
+    displayCallNowCta: true,
+
+    showCallButton: true,
+    showMobileSliderMenu: true,
+
+    cartHref: "#",
+    displayCartIcon: true,
+
+    invocaPhoneNumberDisplayText: "1-855-654-0841",
+    callNowCtaText: "Call now:",
+
+  },
+
+  argTypes: {
+    displayUtilityNavigation: { control: "boolean" },
+    displaySearchBar: { control: "boolean" },
+    displayCallNowCta: { control: "boolean" },
+
+    navigationBackgroundColor: { control: "text" },
+    navigationLinkColor: { control: "text" },
+
+    cartHasRetention: { control: "boolean" },
+
+    onSearch: { action: "search triggered" },
+    onCartClick: { action: "cart clicked" },
+    onCallClickDesktop: { action: "call desktop" },
+    onCallClickMobile: { action: "call mobile" },
+  },
+};
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+
+
+/* DEFAULT (ALL FEATURES) */
+export const Default: Story = {};
+
+
+
+/* WITHOUT UTILITY NAV */
+export const WithoutUtilityNavigation: Story = {
+  args: {
+    displayUtilityNavigation: false,
+  },
+};
+
+
+
+/* WITHOUT SEARCH */
+export const WithoutSearchBar: Story = {
+  args: {
+    displaySearchBar: false,
+  },
+};
+
+
+
+/* WITHOUT CALL CTA */
+export const WithoutCallCTA: Story = {
+  args: {
+    displayCallNowCta: false,
+  },
+};
+
+
+
+/* CART RETENTION DOT */
+export const WithCartRetentionDot: Story = {
+  args: {
+    cartHasRetention: true,
+  },
+};
+
+
+
+/* CUSTOM BACKGROUND */
+export const CustomBackgroundColor: Story = {
+  args: {
+    navigationBackgroundColor: "bg-blue-500",
+  },
+};
+
+
+
+/* CUSTOM LINK COLOR */
+export const CustomLinkColor: Story = {
+  args: {
+    navigationLinkColor: "text-red-500",
+  },
+};
+
+
+/* MOBILE VIEW */
+export const MobileView: Story = {
+  parameters: {
+    viewport: {
+      defaultViewport: "mobile1",
+    },
+  },
+};

package/src/contentful/blocks/navigation/desktop-link-groups.tsx/index.tsx

@@ -1,139 +1,141 @@
-import React, { CSSProperties } from "react";
-
-import { MaterialIcon } from "@shared/components/material-icon";
-import { Text } from "@shared/components/text";
-import { Button } from "@shared/contentful/blocks/button";
-import { ButtonProps as ContentfulButtonProps } from "@shared/contentful/blocks/button/types";
-import { useOutsideClick } from "@shared/hooks/use-outside-click";
-import { cx } from "@shared/utils";
-
-type ComponentButtonGroup = {
-  anchorId?: string | null;
-  title?: string | null;
-  items?: { items?: ContentfulButtonProps[] | null } | null;
-};
-
-type Link = ContentfulButtonProps | ComponentButtonGroup;
-
-type LinkGroupsProps = {
-  link?: Link;
-  anchorName: string;
-  /**
-   * Tailwind text-color class to apply to the top-level link/group
-   * label. Lets the parent navbar invert text color (e.g. `text-white`)
-   * when rendered on a dark background. Submenu items keep their
-   * default `text-text-link` so they remain readable on the white
-   * popover background.
-   */
-  linkColorClassName?: string;
-};
-
-const isButton = (link: Link): link is ContentfulButtonProps => {
-  // If your group never has `href`, this is a simple and effective guard
-  return typeof (link as ContentfulButtonProps).href === "string";
-};
-
-export const DesktopLinkGroups: React.FC<LinkGroupsProps> = ({
-  link,
-  anchorName,
-  linkColorClassName,
-}) => {
-  const [isOpen, setIsOpen] = React.useState(false);
-
-  const ref = React.useRef<HTMLDivElement>(null);
-  useOutsideClick(ref, () => setIsOpen(false));
-
-  if (!link) return null;
-
-  // Single button
-  if (isButton(link)) {
-    return (
-      <Button
-        key={`submenu-link-btn-${link.anchorId}`}
-        {...link}
-        linkClassName={cx(
-          "body3 flex items-center h-full",
-          linkColorClassName || "text-text"
-        )}
-        linkVariant="unstyled"
-      />
-    );
-  }
-
-  // Group
-  const { anchorId, title, items } = link;
-  const subMenu = Array.isArray(items?.items) ? items!.items! : [];
-  const fullAnchorName = `--link-anchor-${anchorName}`;
-
-  return (
-    <div
-      className="relative h-full"
-      style={{ anchorName: fullAnchorName } as CSSProperties}
-      ref={ref}
-    >
-      <Button
-        onClick={() => setIsOpen(prev => !prev)}
-        aria-expanded={isOpen}
-        buttonClassName={cx(
-          "group body3 flex h-full items-center",
-          linkColorClassName || "text-text"
-        )}
-        key={anchorId}
-        showButtonAs="unstyled"
-      >
-        <Text as="span" className="group-hover:underline">
-          {title ?? null}
-        </Text>
-        <MaterialIcon
-          weight="200"
-          size={24}
-          className="text-icon-secondary group-hover:opacity-50"
-          name={isOpen ? "keyboard_arrow_up" : "keyboard_arrow_down"}
-        />
-      </Button>
-
-      <div
-        className={cx(
-          "shadow-navDrop fixed z-[1001] min-w-44 rounded-input-poppers border border-border bg-bg",
-          "transition-[opacity,transform] ease-out",
-          isOpen && subMenu.length > 0
-            ? "pointer-events-auto translate-y-0 opacity-100 duration-75"
-            : "pointer-events-none -translate-y-2 opacity-0 duration-0"
-        )}
-        style={
-          {
-            positionAnchor: fullAnchorName,
-            top: "anchor(bottom)",
-            left: "calc((anchor(left) + anchor(right)) / 2)",
-            translate: "-50% 0",
-          } as CSSProperties
-        }
-      >
-        <ul
-          className="flex flex-col gap-2 py-2"
-          onClick={event => {
-            // Close the popup when a submenu link is clicked.
-            // Required for Pages Router where this component persists across
-            // client-side navigations and `isOpen` would otherwise stay true.
-            const target = event.target as HTMLElement | null;
-            if (target?.closest("a")) {
-              setIsOpen(false);
-            }
-          }}
-        >
-          {subMenu.map((site, index) => {
-            return (
-              <li key={`submenu-link-${index}`} className="submenu-link">
-                <Button
-                  {...site}
-                  linkVariant="unstyled"
-                  linkClassName="body3 px-4 hover:bg-bg-surface-hover flex items-center w-full h-11 text-text-link"
-                />
-              </li>
-            );
-          })}
-        </ul>
-      </div>
-    </div>
-  );
-};
+import React, { CSSProperties } from "react";
+
+import { MaterialIcon } from "@shared/components/material-icon";
+import { Text } from "@shared/components/text";
+import { Button } from "@shared/contentful/blocks/button";
+import { ButtonProps as ContentfulButtonProps } from "@shared/contentful/blocks/button/types";
+import { useOutsideClick } from "@shared/hooks/use-outside-click";
+import { cx } from "@shared/utils";
+
+type ComponentButtonGroup = {
+  anchorId?: string | null;
+  title?: string | null;
+  items?: { items?: ContentfulButtonProps[] | null } | null;
+};
+
+type Link = ContentfulButtonProps | ComponentButtonGroup;
+
+type LinkGroupsProps = {
+  link?: Link;
+  anchorName: string;
+  /**
+   * Tailwind text-color class to apply to the top-level link/group
+   * label. Lets the parent navbar invert text color (e.g. `text-white`)
+   * when rendered on a dark background. Submenu items keep their
+   * default `text-text-link` so they remain readable on the white
+   * popover background.
+   */
+  linkColorClassName?: string;
+};
+
+const isButton = (link: Link): link is ContentfulButtonProps => {
+  // If your group never has `href`, this is a simple and effective guard
+  return typeof (link as ContentfulButtonProps).href === "string";
+};
+
+export const DesktopLinkGroups: React.FC<LinkGroupsProps> = ({
+  link,
+  anchorName,
+  linkColorClassName,
+}) => {
+  const [isOpen, setIsOpen] = React.useState(false);
+
+  const ref = React.useRef<HTMLDivElement>(null);
+  useOutsideClick(ref, () => setIsOpen(false));
+
+  if (!link) return null;
+
+  // Single button
+  if (isButton(link)) {
+    return (
+      <Button
+        key={`submenu-link-btn-${link.anchorId}`}
+        {...link}
+        showButtonAs="text"  
+        linkClassName={cx(
+          "body3 inline-flex items-center no-underline hover:underline",  
+          linkColorClassName || "text-text"
+        )}
+      />
+    );
+  }
+
+
+  // Group
+  const { anchorId, title, items } = link;
+  const subMenu = Array.isArray(items?.items) ? items!.items! : [];
+  const fullAnchorName = `--link-anchor-${anchorName}`;
+
+  return (
+    <div
+      className="relative h-full"
+      style={{ anchorName: fullAnchorName } as CSSProperties}
+      ref={ref}
+    >
+      <Button
+        onClick={() => setIsOpen(prev => !prev)}
+        aria-expanded={isOpen}
+        buttonClassName={cx(
+          "group body3 flex items-center h-full",
+          linkColorClassName || "text-text"
+        )}
+        key={anchorId}
+        showButtonAs="unstyled"   
+      >
+
+        <Text as="span" className="group-hover:underline leading-none">
+          {title ?? null}
+        </Text>
+        <MaterialIcon
+          weight="200"
+          size={24}
+          className="text-icon-secondary group-hover:opacity-50 mt-[1px]"
+          name={isOpen ? "keyboard_arrow_up" : "keyboard_arrow_down"}
+        />
+      </Button>
+
+      <div
+        className={cx(
+          "shadow-navDrop fixed z-[1001] min-w-44 rounded-input-poppers border border-border bg-bg",
+          "transition-[opacity,transform] ease-out",
+          isOpen && subMenu.length > 0
+            ? "pointer-events-auto translate-y-0 opacity-100 duration-75"
+            : "pointer-events-none -translate-y-2 opacity-0 duration-0"
+        )}
+        style={
+          {
+            positionAnchor: fullAnchorName,
+            top: "anchor(bottom)",
+            left: "calc((anchor(left) + anchor(right)) / 2)",
+            translate: "-50% 0",
+          } as CSSProperties
+        }
+      >
+        <ul
+          className="flex flex-col gap-2 py-2"
+          onClick={event => {
+            // Close the popup when a submenu link is clicked.
+            // Required for Pages Router where this component persists across
+            // client-side navigations and `isOpen` would otherwise stay true.
+            const target = event.target as HTMLElement | null;
+            if (target?.closest("a")) {
+              setIsOpen(false);
+            }
+          }}
+        >
+          {subMenu.map((site, index) => {
+            return (
+              <li key={`submenu-link-${index}`} className="submenu-link">
+                <Button
+                  {...site}
+                  showButtonAs="text"
+                  linkClassName="body3 px-3 flex items-center text-text-link no-underline hover:underline hover:bg-bg-surface-hover"
+                />
+              </li>
+            );
+          })}
+        </ul>
+      </div>
+    </div>
+  );
+};