@purpurds/promotion-card 8.2.6 → 8.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purpurds/promotion-card",
-  "version": "8.2.6",
+  "version": "8.3.0",
   "license": "AGPL-3.0-only",
   "main": "./dist/promotion-card.cjs.js",
   "types": "./dist/promotion-card.d.ts",
@@ -17,15 +17,15 @@
   "source": "src/promotion-card.tsx",
   "dependencies": {
     "classnames": "~2.5.0",
-    "@purpurds/button": "8.2.6",
-    "@purpurds/cta-link": "8.2.6",
-    "@purpurds/card": "8.2.6",
-    "@purpurds/heading": "8.2.6",
-    "@purpurds/paragraph": "8.2.6",
-    "@purpurds/icon": "8.2.6",
-    "@purpurds/tokens": "8.2.6",
-    "@purpurds/common-types": "8.2.6",
-    "@purpurds/badge": "8.2.6"
+    "@purpurds/badge": "8.3.0",
+    "@purpurds/button": "8.3.0",
+    "@purpurds/card": "8.3.0",
+    "@purpurds/common-types": "8.3.0",
+    "@purpurds/cta-link": "8.3.0",
+    "@purpurds/heading": "8.3.0",
+    "@purpurds/icon": "8.3.0",
+    "@purpurds/paragraph": "8.3.0",
+    "@purpurds/tokens": "8.3.0"
   },
   "devDependencies": {
     "@storybook/react-vite": "^9.0.18",
@@ -46,9 +46,9 @@
     "vite": "^6.2.1",
     "vitest": "^3.1.2",
     "@purpurds/component-rig": "1.0.0",
-    "@purpurds/grid": "8.2.6",
-    "@purpurds/theme": "8.2.6",
-    "@purpurds/text-spacing": "8.2.6"
+    "@purpurds/grid": "8.3.0",
+    "@purpurds/text-spacing": "8.3.0",
+    "@purpurds/theme": "8.3.0"
   },
   "peerDependencies": {
     "@types/react": "^18 || ^19",

package/src/promotion-card.stories.tsx

@@ -76,6 +76,7 @@ const meta = {
         },
       },
     },
+    forceColorScheme: { control: "radio", options: ["light", "dark"] },
     actions: { control: false },
     badgeIcon: { control: false },
     decorativeImage: { control: false },

package/src/promotion-card.tsx

@@ -1,10 +1,10 @@
-import React, { forwardRef, type ReactNode } from "react";
+import React, { forwardRef, type ReactNode, useId } from "react";
 import { Badge } from "@purpurds/badge";
 import { Card } from "@purpurds/card";
 import type { BaseProps } from "@purpurds/common-types";
 import { Heading, type HeadingTagType, type HeadingVariant } from "@purpurds/heading";
 import { Paragraph } from "@purpurds/paragraph";
-import { useColorScheme } from "@purpurds/theme";
+import { type ColorScheme, useApplyTheme, useTheme } from "@purpurds/theme";
 import c from "classnames/bind";
 
 import styles from "./promotion-card.module.scss";
@@ -54,6 +54,11 @@ export type PromotionCardProps = Omit<BaseProps, "children"> & {
   children: ReactNode;
   alignment?: "space-between" | "flex-end";
   additionalText?: ReactNode;
+  forceColorScheme?: ColorScheme;
+  /**
+   * @deprecated Gradient has been removed from both design and implementation. This prop will be removed in the next major release.
+   */
+  hasGradient?: boolean;
 } & (DecorativeImage | ProductImage);
 
 const cx = c.bind(styles);
@@ -76,14 +81,22 @@ export const PromotionCard = forwardRef<HTMLDivElement, PromotionCardProps>(
       style,
       alignment = "space-between",
       additionalText,
+      forceColorScheme,
       ...props
     },
     ref
   ) => {
-    const [colorScheme] = useColorScheme();
     let rest = props;
     let image;
 
+    const id = useId();
+    const { options, currentColorScheme } = useTheme();
+
+    useApplyTheme({
+      cssVariablesSelector: `[data-id="${id}"]`,
+      currentColorScheme: forceColorScheme ?? options?.promotionCardScheme,
+    });
+
     if ("decorativeImage" in props) {
       const { decorativeImage, ...spread } = props;
       image = decorativeImage;
@@ -94,18 +107,22 @@ export const PromotionCard = forwardRef<HTMLDivElement, PromotionCardProps>(
       rest = spread;
     }
 
+    const effectiveColorScheme =
+      forceColorScheme ?? options?.promotionCardScheme ?? currentColorScheme;
+
     const customProperties = {
       "--promotion-card-background": backgrounds[variant],
       "--promotion-card-color": colors[variant],
       "--promotion-card-background-image": image
         ? "none"
-        : colorScheme === "dark"
+        : effectiveColorScheme === "dark"
         ? backgroundImagesDark[variant]
         : backgroundImages[variant],
     } as React.CSSProperties;
 
     return (
       <Card
+        data-id={id}
         data-testid={dataTestid}
         ref={ref}
         fullHeight