@windstream/react-shared-components 0.1.81 → 0.1.86

package/src/components/alert-card/AlertCard.stories.tsx

@@ -1,171 +1,171 @@
-import { AlertCard } from "./index";
-
-import { DocsPage } from "@shared/stories/DocsTemplate";
-import type { Meta, StoryObj } from "@storybook/react";
-
-const meta: Meta<typeof AlertCard> = {
-  title: "Components/AlertCard",
-  component: AlertCard,
-  tags: ["autodocs"],
-  parameters: {
-    layout: "centered",
-    docs: {
-      page: DocsPage,
-      description: {
-        component:
-          "An alert card component for displaying error messages and critical information with an icon and responsive layout.",
-      },
-    },
-  },
-  argTypes: {
-    errorMessage: {
-      control: { type: "text" },
-      description: "Error message or content to display",
-    },
-    className: {
-      control: { type: "text" },
-      description: "Additional CSS classes",
-    },
-    textVariant: {
-      control: { type: "text" },
-      description: "Text variant class name",
-    },
-  },
-  args: {
-    errorMessage: "This is an error message that needs your attention.",
-  },
-};
-
-export default meta;
-type Story = StoryObj<typeof meta>;
-
-// Default alert card
-export const Default: Story = {
-  args: {},
-};
-
-// Short error message
-export const ShortMessage: Story = {
-  args: {
-    errorMessage: "Error occurred",
-  },
-};
-
-// Long error message
-export const LongMessage: Story = {
-  args: {
-    errorMessage:
-      "This is a longer error message that demonstrates how the alert card handles extended text content. The layout will adapt responsively to accommodate the message length.",
-  },
-};
-
-// Custom text variant
-export const CustomTextVariant: Story = {
-  args: {
-    errorMessage: "Error with custom text styling",
-    textVariant: "body1",
-  },
-};
-
-// With React node content
-export const WithReactNode: Story = {
-  args: {
-    errorMessage: (
-      <div>
-        <p className="body2">Error occurred while processing your request.</p>
-        <p className="body3 mt-1 text-text-secondary">
-          Please try again or contact support if the issue persists.
-        </p>
-      </div>
-    ),
-  },
-};
-
-// Responsive layout
-export const Responsive: Story = {
-  render: () => (
-    <div className="max-w-4xl w-full space-y-4">
-      <div>
-        <h3 className="mb-2 text-sm font-medium text-gray-600">
-          Mobile Layout (flex-col)
-        </h3>
-        <div className="w-64 border border-gray-200 p-2">
-          <AlertCard errorMessage="This alert card stacks vertically on mobile devices with the icon on top." />
-        </div>
-      </div>
-      <div>
-        <h3 className="mb-2 text-sm font-medium text-gray-600">
-          Desktop Layout (flex-row)
-        </h3>
-        <div className="w-full border border-gray-200 p-2">
-          <AlertCard errorMessage="This alert card displays horizontally on desktop with the icon on the left." />
-        </div>
-      </div>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Alert card adapts its layout responsively - vertical on mobile, horizontal on desktop.",
-      },
-    },
-  },
-};
-
-// Custom styling
-export const CustomStyling: Story = {
-  args: {
-    errorMessage: "Alert card with custom styling",
-    className: "rounded-lg shadow-lg",
-  },
-};
-
-// Multiple alert cards
-export const Multiple: Story = {
-  render: () => (
-    <div className="max-w-2xl w-full space-y-4">
-      <AlertCard errorMessage="First error message" />
-      <AlertCard errorMessage="Second error message with more details about what went wrong" />
-      <AlertCard errorMessage="Third error message" />
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story: "Multiple alert cards displayed together.",
-      },
-    },
-  },
-};
-
-// All variants showcase
-export const AllVariants: Story = {
-  render: () => (
-    <div className="max-w-2xl w-full space-y-6">
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Default Alert Card</h3>
-        <AlertCard errorMessage="Default error message" />
-      </div>
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Long Message</h3>
-        <AlertCard errorMessage="This is a longer error message that demonstrates how the alert card handles extended text content while maintaining proper spacing and readability." />
-      </div>
-      <div>
-        <h3 className="mb-3 text-lg font-semibold">Custom Styled</h3>
-        <AlertCard
-          errorMessage="Custom styled alert card"
-          className="rounded-lg"
-          textVariant="body1"
-        />
-      </div>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story: "Showcase of all alert card variants and states.",
-      },
-    },
-  },
-};
+import { AlertCard } from "./index";
+
+import { DocsPage } from "@shared/stories/DocsTemplate";
+import type { Meta, StoryObj } from "@storybook/react";
+
+const meta: Meta<typeof AlertCard> = {
+  title: "Components/AlertCard",
+  component: AlertCard,
+  tags: ["autodocs"],
+  parameters: {
+    layout: "centered",
+    docs: {
+      page: DocsPage,
+      description: {
+        component:
+          "An alert card component for displaying error messages and critical information with an icon and responsive layout.",
+      },
+    },
+  },
+  argTypes: {
+    errorMessage: {
+      control: { type: "text" },
+      description: "Error message or content to display",
+    },
+    className: {
+      control: { type: "text" },
+      description: "Additional CSS classes",
+    },
+    textVariant: {
+      control: { type: "text" },
+      description: "Text variant class name",
+    },
+  },
+  args: {
+    errorMessage: "This is an error message that needs your attention.",
+  },
+};
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+// Default alert card
+export const Default: Story = {
+  args: {},
+};
+
+// Short error message
+export const ShortMessage: Story = {
+  args: {
+    errorMessage: "Error occurred",
+  },
+};
+
+// Long error message
+export const LongMessage: Story = {
+  args: {
+    errorMessage:
+      "This is a longer error message that demonstrates how the alert card handles extended text content. The layout will adapt responsively to accommodate the message length.",
+  },
+};
+
+// Custom text variant
+export const CustomTextVariant: Story = {
+  args: {
+    errorMessage: "Error with custom text styling",
+    textVariant: "body1",
+  },
+};
+
+// With React node content
+export const WithReactNode: Story = {
+  args: {
+    errorMessage: (
+      <div>
+        <p className="body2">Error occurred while processing your request.</p>
+        <p className="body3 mt-1 text-text-secondary">
+          Please try again or contact support if the issue persists.
+        </p>
+      </div>
+    ),
+  },
+};
+
+// Responsive layout
+export const Responsive: Story = {
+  render: () => (
+    <div className="max-w-4xl w-full space-y-4">
+      <div>
+        <h3 className="mb-2 text-sm font-medium text-gray-600">
+          Mobile Layout (flex-col)
+        </h3>
+        <div className="w-64 border border-gray-200 p-2">
+          <AlertCard errorMessage="This alert card stacks vertically on mobile devices with the icon on top." />
+        </div>
+      </div>
+      <div>
+        <h3 className="mb-2 text-sm font-medium text-gray-600">
+          Desktop Layout (flex-row)
+        </h3>
+        <div className="w-full border border-gray-200 p-2">
+          <AlertCard errorMessage="This alert card displays horizontally on desktop with the icon on the left." />
+        </div>
+      </div>
+    </div>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story:
+          "Alert card adapts its layout responsively - vertical on mobile, horizontal on desktop.",
+      },
+    },
+  },
+};
+
+// Custom styling
+export const CustomStyling: Story = {
+  args: {
+    errorMessage: "Alert card with custom styling",
+    className: "rounded-lg shadow-lg",
+  },
+};
+
+// Multiple alert cards
+export const Multiple: Story = {
+  render: () => (
+    <div className="max-w-2xl w-full space-y-4">
+      <AlertCard errorMessage="First error message" />
+      <AlertCard errorMessage="Second error message with more details about what went wrong" />
+      <AlertCard errorMessage="Third error message" />
+    </div>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story: "Multiple alert cards displayed together.",
+      },
+    },
+  },
+};
+
+// All variants showcase
+export const AllVariants: Story = {
+  render: () => (
+    <div className="max-w-2xl w-full space-y-6">
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Default Alert Card</h3>
+        <AlertCard errorMessage="Default error message" />
+      </div>
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Long Message</h3>
+        <AlertCard errorMessage="This is a longer error message that demonstrates how the alert card handles extended text content while maintaining proper spacing and readability." />
+      </div>
+      <div>
+        <h3 className="mb-3 text-lg font-semibold">Custom Styled</h3>
+        <AlertCard
+          errorMessage="Custom styled alert card"
+          className="rounded-lg"
+          textVariant="body1"
+        />
+      </div>
+    </div>
+  ),
+  parameters: {
+    docs: {
+      description: {
+        story: "Showcase of all alert card variants and states.",
+      },
+    },
+  },
+};

package/src/components/alert-card/index.tsx

@@ -1,41 +1,41 @@
-import React from "react";
-import { AlertCardProps } from "./types";
-
-import { MaterialIcon } from "@shared/components/material-icon";
-import { Text } from "@shared/components/text";
-import { cx } from "@shared/utils";
-
-export const AlertCard: React.FC<AlertCardProps> = ({
-  errorMessage,
-  className,
-  iconClassName,
-  iconSize = 52,
-  iconName = "dangerous",
-  textVariant,
-}) => {
-  if (!errorMessage) return null;
-
-  return (
-    <div
-      className={cx(
-        "flex flex-col items-center justify-center gap-5 rounded-surface-sm border-2 border-border-critical bg-bg-fill-critical-secondary px-4 py-6 md:flex-row md:py-4",
-        className
-      )}
-      data-testid="alert-card"
-    >
-      <div>
-        <MaterialIcon
-          name={iconName}
-          size={iconSize}
-          className={cx("text-icon-critical", iconClassName)}
-        />
-      </div>
-
-      <Text className={cx("body2 text-text", textVariant)}>{errorMessage}</Text>
-    </div>
-  );
-};
-
-AlertCard.displayName = "AlertCard";
-
-export type { AlertCardProps };
+import React from "react";
+import { AlertCardProps } from "./types";
+
+import { MaterialIcon } from "@shared/components/material-icon";
+import { Text } from "@shared/components/text";
+import { cx } from "@shared/utils";
+
+export const AlertCard: React.FC<AlertCardProps> = ({
+  errorMessage,
+  className,
+  iconClassName,
+  iconSize = 52,
+  iconName = "dangerous",
+  textVariant,
+}) => {
+  if (!errorMessage) return null;
+
+  return (
+    <div
+      className={cx(
+        "flex flex-col items-center justify-center gap-5 rounded-surface-sm border-2 border-border-critical bg-bg-fill-critical-secondary px-4 py-6 md:flex-row md:py-4",
+        className
+      )}
+      data-testid="alert-card"
+    >
+      <div>
+        <MaterialIcon
+          name={iconName}
+          size={iconSize}
+          className={cx("text-icon-critical", iconClassName)}
+        />
+      </div>
+
+      <Text className={cx("body2 text-text", textVariant)}>{errorMessage}</Text>
+    </div>
+  );
+};
+
+AlertCard.displayName = "AlertCard";
+
+export type { AlertCardProps };

package/src/components/alert-card/types.ts

@@ -1,13 +1,13 @@
-import { ReactNode } from "react";
-import { IconName, Size } from "../material-icon";
-
-import { TextVariant } from "@shared/components/text";
-
-export type AlertCardProps = {
-  errorMessage?: string | ReactNode;
-  className?: string;
-  iconName?: IconName;
-  iconClassName?: string;
-  textVariant?: TextVariant;
-  iconSize?: Size;
-};
+import { ReactNode } from "react";
+import { IconName, Size } from "../material-icon";
+
+import { TextVariant } from "@shared/components/text";
+
+export type AlertCardProps = {
+  errorMessage?: string | ReactNode;
+  className?: string;
+  iconName?: IconName;
+  iconClassName?: string;
+  textVariant?: TextVariant;
+  iconSize?: Size;
+};

package/src/components/animation-wrapper/index.tsx

@@ -0,0 +1,129 @@
+"use client";
+
+import React from "react";
+import { AnimationType, AnimationWrapperProps } from "./types";
+import { motion, useReducedMotion } from "framer-motion";
+
+interface AnimationPreset {
+  whileHover: Record<string, unknown>;
+  whileTap?: Record<string, unknown>;
+  transition: Record<string, unknown>;
+}
+
+const ANIMATION_PRESETS: Record<AnimationType, AnimationPreset> = {
+  scale: {
+    whileHover: { scale: 1.02 },
+    whileTap: { scale: 0.98 },
+    transition: { duration: 0.3 },
+  },
+  shadow: {
+    whileHover: { boxShadow: "0 10px 25px rgba(0,0,0,0.15)" },
+    transition: { duration: 0.3 },
+  },
+  lift: {
+    whileHover: { y: -5 },
+    whileTap: { y: 0 },
+    transition: { type: "spring", stiffness: 300, damping: 20 },
+  },
+  opacity: {
+    whileHover: { opacity: 0.8 },
+    transition: { duration: 0.2 },
+  },
+  grow: {
+    whileHover: { scale: 1.1 },
+    whileTap: { scale: 0.95 },
+    transition: { type: "spring", stiffness: 300, damping: 20 },
+  },
+};
+
+function mergePresets(animationType?: AnimationType | AnimationType[]) {
+  if (!animationType) return undefined;
+
+  const types = Array.isArray(animationType) ? animationType : [animationType];
+  if (types.length === 0) return undefined;
+
+  return types.reduce<AnimationPreset>(
+    (merged, type) => {
+      const preset = ANIMATION_PRESETS[type];
+      return {
+        whileHover: { ...merged.whileHover, ...preset.whileHover },
+        ...(merged.whileTap || preset.whileTap
+          ? {
+              whileTap: { ...merged.whileTap, ...preset.whileTap },
+            }
+          : {}),
+        transition: { ...merged.transition, ...preset.transition },
+      };
+    },
+    { whileHover: {}, transition: {} }
+  );
+}
+
+export function AnimationWrapper({
+  children,
+  animationType,
+  // default to true for backward compatibility
+  disableAnimation = true,
+  whileHover,
+  whileTap,
+  transition,
+  ...motionProps
+}: AnimationWrapperProps) {
+  const prefersReducedMotion = useReducedMotion();
+
+  const child = React.Children.only(children) as React.ReactElement<
+    Record<string, unknown>
+  >;
+
+  if (disableAnimation || prefersReducedMotion) {
+    return child;
+  }
+
+  const preset = mergePresets(animationType);
+
+  const mergedWhileHover = preset
+    ? { ...preset.whileHover, ...(whileHover as Record<string, unknown>) }
+    : whileHover;
+
+  const mergedWhileTap =
+    preset?.whileTap || whileTap
+      ? { ...preset?.whileTap, ...(whileTap as Record<string, unknown>) }
+      : undefined;
+
+  const mergedTransition = preset
+    ? { ...preset.transition, ...(transition as Record<string, unknown>) }
+    : transition;
+
+  const isIntrinsicElement = typeof child.type === "string";
+
+  if (isIntrinsicElement) {
+    const MotionComponent = motion[
+      child.type as keyof typeof motion
+    ] as React.ComponentType<Record<string, unknown>>;
+
+    return (
+      <MotionComponent
+        {...child.props}
+        whileHover={mergedWhileHover}
+        whileTap={mergedWhileTap}
+        transition={mergedTransition}
+        {...motionProps}
+      />
+    );
+  }
+
+  return (
+    <motion.div
+      whileHover={mergedWhileHover}
+      whileTap={mergedWhileTap}
+      transition={mergedTransition}
+      {...motionProps}
+    >
+      {child}
+    </motion.div>
+  );
+}
+
+AnimationWrapper.displayName = "AnimationWrapper";
+
+export type { AnimationWrapperProps, AnimationType };

package/src/components/animation-wrapper/types.ts

@@ -0,0 +1,11 @@
+import { ReactElement } from "react";
+import { HTMLMotionProps } from "framer-motion";
+
+export type AnimationType = "scale" | "shadow" | "lift" | "opacity" | "grow";
+
+export interface AnimationWrapperProps
+  extends Omit<HTMLMotionProps<"div">, "children"> {
+  children: ReactElement;
+  animationType?: AnimationType | AnimationType[];
+  disableAnimation?: boolean;
+}