fragment-headless-sdk 2.4.0 → 2.4.1

package/dist/types/announcement.d.ts

@@ -22,6 +22,7 @@ export interface IAnnouncement {
     name: string;
     status: AnnouncementStatus;
     content: IAnnouncementContent | null;
+    page_order: number | null;
     active_duration_seconds: number | null;
     active_start_date: string | null;
     active_end_date: string | null;

package/dist/types/hero.d.ts

@@ -26,6 +26,7 @@ export interface IHero {
     name: string;
     type: HeroType;
     page: ShopPage["handle"] | null;
+    page_order: number | null;
     status: HeroStatus;
     content: IHeroContent | null;
     active_duration_seconds: number | null;

package/dist/utils/styling.js

@@ -18,6 +18,10 @@ const KNOWN_ANNOUNCEMENT_SLOTS = [
     "countdownItem",
     "countdownLabel",
     "countdownValue",
+    "countdownContainer",
+    "countdownBlock",
+    "countdownDigit",
+    "countdownSeparator",
 ];
 const KNOWN_HERO_SLOTS = [
     "root",
@@ -43,7 +47,11 @@ const KNOWN_HERO_SLOTS = [
     "mobileDescription",
     "button",
     "desktopButton",
-    "mobileButton",
+    "mobileButton", "countdownContainer",
+    "countdownBlock",
+    "countdownDigit",
+    "countdownLabel",
+    "countdownSeparator",
 ];
 const ALL_KNOWN_SLOTS = [...KNOWN_ANNOUNCEMENT_SLOTS, ...KNOWN_HERO_SLOTS];
 function getCacheKey(base, slots, extra) {

package/docs/CHANGELOG.md

@@ -7,12 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### [Unreleased]
 
+### [2.4.1] - 2026-04-10
+
+#### Added
+
+- **`IHero.page_order`** – New `page_order: number | null` field on `IHero`. Consumers can use this to sort hero banners by their merchant-defined display order.
+
 ### [2.4.0] - 2026-03-08
 
 #### Added
 
 - **Hero countdown option** – Hero content supports optional countdown via `content.showCountdown` and `content.counterEndDate`. New `HeroCountdownTimer` component is used by Desktop/Mobile Hero when countdown is enabled.
 - **Button spacing** – Hero resolvers support `buttonSpacing` for configurable CTA spacing (`hero.ts`, `hero-resolvers.ts`).
+- **Content spacing** – Hero resolvers support `contentSpacing` for configurable gap between title, description, countdown, and button (`hero-resolvers.ts`); UI options in the app mirror this.
+- **Countdown color tokens** – Hero countdown supports `counterDigitColor`, `counterDigitBackgroundColor`, and `counterTextColor` via `content.styling.tokens.colors`; resolved by `resolveHeroCountdownColors()` in `hero-resolvers.ts`.
 
 #### Changed
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fragment-headless-sdk",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Official SDK for Fragment-Shopify CMS: React components, TypeScript types, and utilities for headless Shopify storefronts.",
   "license": "MIT",
   "main": "dist/index.js",

package/readme.md

@@ -4,7 +4,7 @@ The official SDK for integrating with Fragment-Shopify CMS. Provides React compo
 
 ## ✨ What's New
 
-**v2.3.3** – `fetchResource` uses environment-aware default caching: Next.js production defaults to 60s revalidation and resource-type cache tags; development and non–Next.js use `cache: "default"`. Request deduplication normalizes `status` for consistent cache keys.
+**v2.4.1** – `IHero` now includes a `page_order: number | null` field. Use this to sort hero banners by their merchant-defined display order; when all values are `null` the recommended behaviour is to randomize.
 
 > See [CHANGELOG.md](./docs/CHANGELOG.md) for full release history