@nok-integration/storefront-react 0.6.1 → 0.12.0

package/dist/index.d.ts

@@ -24,15 +24,15 @@ declare type AddCartItemRequest = z.infer<typeof AddCartItemRequest>;
 
 /** The `error` member — a machine `code`, a human `message`, and optional `details`. */
 declare const ApiErrorBody: z.ZodObject<{
-    code: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
+    code: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
     message: z.ZodString;
     details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
+    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "cart_not_found" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
     message: string;
     details?: Record<string, unknown> | undefined;
 }, {
-    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
+    code: "invalid_request" | "unauthorized" | "out_of_stock" | "cart_locked" | "sku_not_found" | "category_not_found" | "amount_mismatch" | "duplicate_order" | "order_not_found" | "order_not_cancellable" | "cart_not_found" | "forbidden" | "invalid_transition" | "rate_limited" | "server_error";
     message: string;
     details?: Record<string, unknown> | undefined;
 }>;
@@ -192,18 +192,17 @@ declare const CartItem: z.ZodObject<{
 declare type CartItem = z.infer<typeof CartItem>;
 
 /**
- * A single cart line: media, title, variant, unit price, qty stepper, and line total.
+ * A single cart line: media, title, variant, price and the qty stepper.
  *
- * Title, image and variant come from the line itself (contracts 2.15.0). Before that the
- * wire carried only a SKU, so this rendered an internal code against an empty grey box —
- * and two sizes of one product were indistinguishable.
+ * Title, image and variant come from the line itself (contracts 2.15.0) and are all
+ * optional — the catalogue projection is a cache, so a de-listed SKU still has a line. It
+ * degrades: the SKU stands in for a missing title, a missing image leaves the placeholder.
  *
- * All three stay optional, because the catalogue projection is a cache: a SKU de-listed
- * after it entered the cart still has a line. It degrades rather than breaks — the SKU
- * stands in for a missing title, and a missing image leaves the placeholder — so the fan
- * can always still read the price and remove the line.
+ * The figure shown is the LINE TOTAL, not the unit price. The design shows one price at
+ * qty 1, where the two are equal, so it does not settle it; line total is what reconciles
+ * with the Subtotal below.
  */
-export declare function CartLineItem({ item, title, image, maxQty, onQtyChange, onRemove, pending, }: CartLineItemProps): JSX.Element;
+export declare function CartLineItem({ item, title, image, compareAt, discountPct, maxQty, onQtyChange, onRemove, pending, }: CartLineItemProps): JSX.Element;
 
 export declare interface CartLineItemProps {
     item: CartItem;
@@ -214,6 +213,16 @@ export declare interface CartLineItemProps {
      */
     title?: string;
     image?: string;
+    /**
+     * Was-price and discount: a struck figure under the price, and a `-NN%` badge over the
+     * thumbnail (Figma `Property 1=cart-item`).
+     *
+     * `CartView` does not supply these — `CartItem` carries no was-price, so the cart cannot
+     * know a line is discounted and will not invent one. Same escape hatch as `title`/`image`
+     * above, for a host with its own catalogue data.
+     */
+    compareAt?: Money;
+    discountPct?: number;
     maxQty?: number;
     onQtyChange: (qty: number) => void;
     onRemove: () => void;
@@ -284,8 +293,9 @@ export declare interface CartViewProps {
      *
      * DAZN's checkout is the next step and DAZN name it; a host whose own wording is
      * "Continue" or "Go to checkout" should not have to accept ours. The locked-cart label
-     * is deliberately NOT configurable — it states a condition rather than an action, and a
-     * host renaming it could imply the button still works.
+     * is deliberately NOT configurable — it takes the fan back to a checkout that already
+     * exists, which is a different action from starting one, and a host renaming it could
+     * imply a second checkout is being created.
      */
     checkoutLabel?: string;
 }
@@ -446,11 +456,11 @@ declare const CategoryPage: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -478,11 +488,11 @@ declare const CategoryPage: z.ZodObject<{
         }, {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -514,11 +524,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -550,11 +560,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -594,6 +604,7 @@ declare const CategoryPage: z.ZodObject<{
         align?: "center" | "left" | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"featured">;
+        title: z.ZodOptional<z.ZodString>;
         product: z.ZodObject<{
             sku: z.ZodString;
             title: z.ZodString;
@@ -669,11 +680,11 @@ declare const CategoryPage: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -701,11 +712,11 @@ declare const CategoryPage: z.ZodObject<{
         }, {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -736,11 +747,11 @@ declare const CategoryPage: z.ZodObject<{
         product: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -766,16 +777,17 @@ declare const CategoryPage: z.ZodObject<{
                 notes?: string[] | undefined;
             } | undefined;
         };
+        title?: string | undefined;
     }, {
         kind: "featured";
         product: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -801,6 +813,7 @@ declare const CategoryPage: z.ZodObject<{
                 notes?: string[] | undefined;
             } | undefined;
         };
+        title?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"lifestyle_image">;
         images: z.ZodArray<z.ZodString, "many">;
@@ -888,11 +901,11 @@ declare const CategoryPage: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -920,11 +933,11 @@ declare const CategoryPage: z.ZodObject<{
         }, {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -956,11 +969,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -992,11 +1005,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -1034,18 +1047,21 @@ declare const CategoryPage: z.ZodObject<{
             quote: string;
             author: string;
         }>, "many">;
+        disclaimer: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         kind: "review";
         quotes: {
             quote: string;
             author: string;
         }[];
+        disclaimer?: string | undefined;
     }, {
         kind: "review";
         quotes: {
             quote: string;
             author: string;
         }[];
+        disclaimer?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"why_us">;
         items: z.ZodArray<z.ZodObject<{
@@ -1116,11 +1132,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -1155,11 +1171,11 @@ declare const CategoryPage: z.ZodObject<{
         product: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -1185,6 +1201,7 @@ declare const CategoryPage: z.ZodObject<{
                 notes?: string[] | undefined;
             } | undefined;
         };
+        title?: string | undefined;
     } | {
         kind: "lifestyle_image";
         images: string[];
@@ -1194,11 +1211,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -1230,6 +1247,7 @@ declare const CategoryPage: z.ZodObject<{
             quote: string;
             author: string;
         }[];
+        disclaimer?: string | undefined;
     } | {
         items: {
             title: string;
@@ -1258,11 +1276,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -1297,11 +1315,11 @@ declare const CategoryPage: z.ZodObject<{
         product: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -1327,6 +1345,7 @@ declare const CategoryPage: z.ZodObject<{
                 notes?: string[] | undefined;
             } | undefined;
         };
+        title?: string | undefined;
     } | {
         kind: "lifestyle_image";
         images: string[];
@@ -1336,11 +1355,11 @@ declare const CategoryPage: z.ZodObject<{
         products: {
             sku: string;
             title: string;
-            category: string;
             price: {
                 amount: number;
                 currency: string;
             };
+            category: string;
             media: string[];
             variants: {
                 sku: string;
@@ -1372,6 +1391,7 @@ declare const CategoryPage: z.ZodObject<{
             quote: string;
             author: string;
         }[];
+        disclaimer?: string | undefined;
     } | {
         items: {
             title: string;
@@ -1440,9 +1460,15 @@ declare interface ClientOptions {
 export declare function codeOf(err: unknown): ErrorCode | undefined;
 
 /**
- * PDP colour selector (Figma `mobile/pdp/color`): a "Colour: <name>" header and a row of
- * 79×105 image tiles. The selected tile gets a dark border; sold-out colours are disabled
- * with an overlay. A real radiogroup for keyboard + screen-reader support.
+ * PDP colour selector (Figma `mobile/pdp/color`): a "Color: <name>" header and a row of
+ * 79×105 image tiles. The selected tile gets a 1px dark border; a sold-out colour gets a
+ * dark scrim reading "Out of stock".
+ *
+ * A sold-out colour stays SELECTABLE, per the tile's design note ("tap always selects —
+ * sold-out selectable to view"): choosing it swaps the gallery, which is the only way a
+ * fan can look at a colourway that happens to be unavailable. The purchase is blocked
+ * further down, at the CTA, not here — disabling the tile would hide the product rather
+ * than the transaction.
  */
 export declare function ColorSelector({ colours, selected, onSelect }: ColorSelectorProps): JSX.Element;
 
@@ -1677,6 +1703,7 @@ declare function createClient(options: ClientOptions): {
                         notes?: string[] | undefined;
                     } | undefined;
                 };
+                title?: string | undefined;
             } | {
                 kind: "lifestyle_image";
                 images: string[];
@@ -1722,6 +1749,7 @@ declare function createClient(options: ClientOptions): {
                     quote: string;
                     author: string;
                 }[];
+                disclaimer?: string | undefined;
             } | {
                 kind: "why_us";
                 items: {
@@ -1739,6 +1767,19 @@ declare function createClient(options: ClientOptions): {
             })[];
         }>;
     };
+    content: {
+        /** The shop entry's slides. Falls back to whatever the consumer ships with. */
+        home: () => Promise<{
+            slides: {
+                title: string;
+                subtitle: string;
+                key: string;
+                cta: string;
+                image?: string | undefined;
+                target?: string | undefined;
+            }[];
+        }>;
+    };
     inventory: {
         get: (sku: string) => Promise<{
             sku: string;
@@ -1972,6 +2013,106 @@ declare function createClient(options: ClientOptions): {
             checkout_url: string;
         }>;
     };
+    /**
+     * The fan's own orders (ADR-0015). Session-scoped: there is no way to ask for
+     * someone else's, because there is no parameter that names a customer.
+     */
+    stockAlerts: {
+        /** "Remind me when available" — idempotent per SKU for the session's principal. */
+        create: (body: StockAlertRequest) => Promise<{
+            sku: string;
+            created_at: string;
+            notified_at?: string | undefined;
+        }>;
+    };
+    orders: {
+        list: () => Promise<{
+            orders: {
+                status: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
+                currency: string;
+                total: {
+                    amount: number;
+                    currency: string;
+                };
+                order_ref: string;
+                placed_at: string;
+                headline: string;
+                item_count: number;
+                image?: string | undefined;
+            }[];
+        }>;
+        get: (orderRef: string) => Promise<{
+            status: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
+            currency: string;
+            items: {
+                sku: string;
+                qty: number;
+                unit_price: {
+                    amount: number;
+                    currency: string;
+                };
+                line_total: {
+                    amount: number;
+                    currency: string;
+                };
+                line_ref: string;
+                cancelled_qty: number;
+                refunded_qty: number;
+                attributes?: Record<string, string> | undefined;
+                image?: string | undefined;
+                title?: string | undefined;
+            }[];
+            totals: {
+                shipping: {
+                    amount: number;
+                    currency: string;
+                };
+                tax: {
+                    amount: number;
+                    currency: string;
+                };
+                items: {
+                    amount: number;
+                    currency: string;
+                };
+                grand_total: {
+                    amount: number;
+                    currency: string;
+                };
+            };
+            order_ref: string;
+            placed_at: string;
+            ship_to: {
+                country: string;
+                name: string;
+                line1: string;
+                city: string;
+                postcode: string;
+                line2?: string | undefined;
+                region?: string | undefined;
+            };
+            headline: string;
+            progress: {
+                label: string;
+                step: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
+                current: boolean;
+                at?: string | undefined;
+            }[];
+            payment?: {
+                brand: string;
+                last4?: string | undefined;
+            } | undefined;
+            estimated_delivery?: {
+                from: string;
+                to: string;
+            } | undefined;
+            tracking?: {
+                carrier: string;
+                url?: string | undefined;
+                reference?: string | undefined;
+            } | undefined;
+        }>;
+    };
     auth: {
         /** Exchange a single-use DAZN identity JWT for a session (sets the cookie). */
         exchangeSession: (body: SessionExchangeRequest) => Promise<{
@@ -2137,7 +2278,7 @@ export declare interface EmptyStateProps {
  * | rate_limited       | 429  | too many requests                             |
  * | server_error       | 500  | unexpected error (safe to retry idempotent)   |
  */
-declare const ErrorCode: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
+declare const ErrorCode: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
 
 declare type ErrorCode = z.infer<typeof ErrorCode>;
 
@@ -2160,7 +2301,7 @@ declare type ErrorCode = z.infer<typeof ErrorCode>;
  * | rate_limited       | 429  | too many requests                             |
  * | server_error       | 500  | unexpected error (safe to retry idempotent)   |
  */
-declare const ErrorCode_2: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
+declare const ErrorCode_2: z.ZodEnum<["invalid_request", "unauthorized", "out_of_stock", "cart_locked", "sku_not_found", "category_not_found", "amount_mismatch", "duplicate_order", "order_not_found", "order_not_cancellable", "cart_not_found", "forbidden", "invalid_transition", "rate_limited", "server_error"]>;
 
 declare type ErrorCode_2 = z.infer<typeof ErrorCode_2>;
 
@@ -2288,7 +2429,13 @@ export declare function isDuplicateOrder(err: unknown): boolean;
 /** A 401 anywhere in the flow means the session lapsed — re-handshake, keep the cart. */
 export declare function isUnauthorized(err: unknown): boolean;
 
-/** Full-width lifestyle image (rounded), inset from the page edges. */
+/**
+ * Full-width editorial image, swipeable when the CMS supplies more than one.
+ *
+ * It previously rendered `images[0]` and dropped the rest, which is a silent failure of
+ * the worst kind: the block takes an array, an author publishes three, and nothing on the
+ * screen says the other two exist.
+ */
 export declare function LifestyleImage({ images }: {
     images: string[];
 }): JSX.Element | null;
@@ -2377,6 +2524,36 @@ export declare type Navigate = (to: ShopRoute) => void;
  */
 export declare type OnEvent = (event: ShopEvent) => void;
 
+/**
+ * One row of the timeline.
+ *
+ * **`at` is present only for a step that has actually happened.** A future step has no
+ * date, rather than a projected one: a predicted date rendered in the same place as a
+ * recorded one is indistinguishable from a promise, and this timeline is the fan's
+ * evidence of what occurred.
+ */
+declare const OrderProgressEntry: z.ZodObject<{
+    step: z.ZodEnum<["packing", "on_its_way", "out_for_delivery", "delivered", "cancelled"]>;
+    /** Ready-to-render label for the step, localised with the rest of the response. */
+    label: z.ZodString;
+    /** When the step completed. Absent = not reached yet. */
+    at: z.ZodOptional<z.ZodString>;
+    /** Exactly one entry is `current`; every earlier one is complete. */
+    current: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    step: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
+    current: boolean;
+    at?: string | undefined;
+}, {
+    label: string;
+    step: "packing" | "on_its_way" | "out_for_delivery" | "delivered" | "cancelled";
+    current: boolean;
+    at?: string | undefined;
+}>;
+
+declare type OrderProgressEntry = z.infer<typeof OrderProgressEntry>;
+
 /**
  * Fulfilment order status. Lives here (not in a synchronous order contract) because the
  * engine no longer owns orders (ADR-0008) — order/fulfilment status reaches us only as
@@ -2390,10 +2567,18 @@ declare type OrderStatus = z.infer<typeof OrderStatus>;
  * The pricing breakdown. DISPLAY ONLY — every value is server-authoritative; the UI
  * never sums or computes anything here.
  */
-export declare function OrderSummary({ pricing, deferred }: OrderSummaryProps): JSX.Element;
+export declare function OrderSummary({ pricing, deferred, rows }: OrderSummaryProps): JSX.Element;
 
 export declare interface OrderSummaryProps {
     pricing: Pricing;
+    /**
+     * Row order and wording, where a surface's design differs from the cart's.
+     *
+     * The order screen lists Subtotal, Tax, Shipping, Total and says "Shipping"; the cart
+     * says "Delivery". One component, two designs — passed in rather than picked here so
+     * neither screen silently inherits the other's wording.
+     */
+    rows?: SummaryRow[];
     /**
      * Rows whose value is **not ours to state**, rendered as "Calculated at checkout"
      * instead of the figure in `pricing`.
@@ -2410,7 +2595,42 @@ export declare interface OrderSummaryProps {
     deferred?: DeferredLine[];
 }
 
-/** PCP hero — category title + subtitle over a full-bleed lifestyle image (dark). */
+/**
+ * The order progress timeline (Figma `mobile/order/timeline-row`, 3879:13868).
+ *
+ * The steps come from the engine rather than being enumerated here, so the screen renders
+ * what the order can actually evidence — three rows for a normal delivery, four when a
+ * carrier reports the parcel out for delivery, and a cancelled tail when it applies.
+ *
+ * An ordered list, because it is one: the rows have a sequence and a screen reader should
+ * announce it as such.
+ */
+export declare function OrderTimeline({ progress, locale: localeProp }: OrderTimelineProps): JSX.Element;
+
+export declare interface OrderTimelineProps {
+    progress: OrderProgressEntry[];
+    /** Overrides the provider's locale for the step dates. */
+    locale?: string;
+}
+
+/**
+ * Order tracking (Figma `mobile/order/details`, ADR-0015).
+ *
+ * Read-only by design. Cancellation and refunds remain DAZN's under ADR-0008, so the
+ * design's "Cancel order" and "Return items" buttons are deliberately not here: a control
+ * that cannot complete is worse than an absent one, and both need a contract from DAZN
+ * before they can do anything.
+ */
+export declare function OrderTrackingView(props: OrderTrackingViewProps): JSX.Element;
+
+export declare interface OrderTrackingViewProps {
+    /** DAZN's order reference, e.g. `ord_GB26081021`. */
+    orderRef: string;
+    /** Overrides the provider's locale for dates. */
+    locale?: string;
+}
+
+/** PCP hero — category title and tagline read over a full-screen lifestyle image. */
 export declare function PcpHero({ hero }: {
     hero: CategoryHero;
 }): JSX.Element;
@@ -2639,11 +2859,11 @@ declare const Product: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sku: string;
     title: string;
-    category: string;
     price: {
         amount: number;
         currency: string;
     };
+    category: string;
     media: string[];
     variants: {
         sku: string;
@@ -2671,11 +2891,11 @@ declare const Product: z.ZodObject<{
 }, {
     sku: string;
     title: string;
-    category: string;
     price: {
         amount: number;
         currency: string;
     };
+    category: string;
     media: string[];
     variants: {
         sku: string;
@@ -2777,12 +2997,17 @@ declare type ProductPromo = z.infer<typeof ProductPromo>;
  * 165:220 image (radius-6) with a TOP PICK flag top-left and a green sale badge
  * bottom-left; below sit the title (2-line clamp) and price with a struck was-price.
  */
-export declare function ProductTile({ product, priority }: ProductTileProps): JSX.Element;
+export declare function ProductTile({ product, priority, size }: ProductTileProps): JSX.Element;
 
 export declare interface ProductTileProps {
     product: Product;
     /** Priority-load the image (above-the-fold tiles). */
     priority?: boolean;
+    /**
+     * `default` is the 165px rail/grid card. `large` is the full-width spotlight card —
+     * a taller 343:457 image and an 18px title (Figma `size=large`).
+     */
+    size?: 'default' | 'large';
 }
 
 /** `GET /v1/catalog/products` — a single purchasable variant of a product. */
@@ -2940,10 +3165,17 @@ declare interface Review {
     author: string;
 }
 
-/** Testimonial carousel — swipeable light cards with dot pagination. */
-export declare function ReviewCarousel({ quotes }: {
+/** Tester-quote carousel — swipeable cards with dot pagination. */
+export declare function ReviewCarousel({ quotes, disclaimer }: ReviewCarouselProps): JSX.Element;
+
+declare interface ReviewCarouselProps {
     quotes: Review[];
-}): JSX.Element;
+    /**
+     * The line that says these are tester quotes rather than customer reviews. The design
+     * makes it mandatory; without it the block is unattributed social proof.
+     */
+    disclaimer?: string;
+}
 
 /**
  * The single green sale/discount badge (Figma `mobile/badge/sale`): success-soft
@@ -3026,14 +3258,37 @@ export declare type ShopEvent = {
     type: 'cart_updated';
     itemCount: number;
     subtotal: Money;
-} | {
+}
+/**
+* Everything past `sku`/`qty` is display metadata (0.7.0), for a host that renders its
+* own add-to-cart confirmation. Optional and non-identifying: key on `sku`, and expect
+* any of them to be absent — they come from the catalogue projection, which is a cache.
+*/
+| {
     type: 'add_to_cart';
     sku: string;
     qty: number;
+    /** Product name, e.g. `DAZN Hoodie`. Display only. */
+    title?: string;
+    /** Mirror of `attributes.size`. Absent for a product with no size dimension. */
+    size?: string;
+    /** The variant's defining attributes, e.g. `{ colour: 'White', size: 'M' }`. */
+    attributes?: Record<string, string>;
+    /** Variant thumbnail, absolute URL. Absent = render without one. */
+    image?: string;
 } | {
     type: 'remove_from_cart';
     sku: string;
     qty: number;
+}
+/**
+* A fan asked to be told when a sold-out SKU returns (0.9.0). The engine records the
+* interest and raises the message when stock lands; this is the host's chance to
+* count the demand, which is the number a merchandiser actually wants.
+*/
+| {
+    type: 'stock_alert_requested';
+    sku: string;
 } | {
     type: 'checkout_handoff';
     cartId: string;
@@ -3043,10 +3298,18 @@ export declare type ShopEvent = {
     action: string;
 } | {
     type: 'session_expired';
-} | {
+}
+/**
+* A message the SDK would have shown, handed over because the host set
+* `notifications: 'host'`. `description`/`image` (0.7.0) are what the rich toast draws;
+* a plain error notification has neither.
+*/
+| {
     type: 'notification';
     tone: 'neutral' | 'success' | 'critical';
     message: string;
+    description?: string;
+    image?: string;
 } | {
     type: 'error';
     code: ErrorCode | undefined;
@@ -3064,13 +3327,14 @@ export declare type ShopEvent = {
  * if the design is ours, and a mismatch if only half of it is.
  *
  * The cart count is real, never fabricated: `useCartCount` returns `null` until it knows,
- * and the badge stays hidden for both `null` and `0` — an empty cart wearing a "0" is
- * noise, and a guessed number is worse.
+ * and the badge stays hidden until then. It is shown at zero, as the design draws it —
+ * `.cart.icon` has an explicit empty state carrying "0" — but a "0" that appears while the
+ * cart is still loading and then jumps to "3" is a guess wearing a number.
  *
  * Mount it inside `DaznShopProvider`, and inside `CartSheet` if `showCart` is on, since
  * the trigger opens that sheet.
  */
-export declare function ShopHeader({ onBack, onMenu, showCart, backLabel, menuLabel, className, }: ShopHeaderProps): JSX.Element;
+export declare function ShopHeader({ onBack, onMenu, showCart, floating, backLabel, menuLabel, className, }: ShopHeaderProps): JSX.Element;
 
 export declare interface ShopHeaderProps {
     /**
@@ -3082,6 +3346,14 @@ export declare interface ShopHeaderProps {
     onMenu?: () => void;
     /** The cart icon and its live count. */
     showCart?: boolean;
+    /**
+     * Lay the bar over the content instead of above it, with no background of its own.
+     *
+     * For screens whose artwork starts at the top of the display — the category page, where
+     * the hero's own measurements are taken from y=0. The parent must establish a containing
+     * block, and the content beneath must expect nothing reserved for the bar.
+     */
+    floating?: boolean;
     /** Accessible name for the back control, for a host that is not in English. */
     backLabel?: string;
     menuLabel?: string;
@@ -3350,12 +3622,38 @@ export declare interface StatusBadgeProps {
 }
 
 /** Bottom-pinned CTA bar, safe-area aware. Holds one or two primary actions. */
-export declare function StickyCtaBar({ children, info }: StickyCtaBarProps): JSX.Element;
+export declare function StickyCtaBar({ children, info, variant }: StickyCtaBarProps): JSX.Element;
 
 export declare interface StickyCtaBarProps {
     children: ReactNode;
     /** Optional content shown above the actions (e.g. a total). */
     info?: ReactNode;
+    /**
+     * `floating` (default) is the PDP bar: rounded top, drop shadow. `divider` is the cart
+     * bar: square, hairline top border. Two different frames in Figma, not a preference.
+     */
+    variant?: 'floating' | 'divider';
+}
+
+/** `POST /v1/stock-alerts` — tell me when this is buyable again. */
+declare const StockAlertRequest: z.ZodObject<{
+    /**
+     * The variant a fan actually wants, when one is resolvable — a fan who chose Black /
+     * M does not want telling that White / L came back. The parent product SKU is
+     * accepted and means "any variant of this product".
+     */
+    sku: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    sku: string;
+}, {
+    sku: string;
+}>;
+
+declare type StockAlertRequest = z.infer<typeof StockAlertRequest>;
+
+declare interface SummaryRow {
+    label: string;
+    key: keyof Pricing;
 }
 
 export declare function swatchColour(name: string): string;
@@ -3366,8 +3664,22 @@ export declare interface ToastAction {
     onAction: () => void;
 }
 
+/**
+ * `show` takes a tone or an options object as its second argument. The positional form
+ * stays because it is public API and DAZN are integrated against 0.6.x.
+ */
 declare interface ToastApi {
-    show: (message: string, tone?: ToastTone, action?: ToastAction) => void;
+    show: (message: string, toneOrOptions?: ToastTone | ToastOptions, action?: ToastAction) => void;
+}
+
+/** The richer toast: Figma `toast-added-to-cart`. Both fields optional and independent. */
+declare interface ToastOptions {
+    tone?: ToastTone;
+    action?: ToastAction;
+    /** Second line, quieter and smaller — e.g. `DAZN Hoodie · Size M`. */
+    description?: string;
+    /** 40×40 thumbnail. Decorative, so never given alt text. */
+    image?: string;
 }
 
 export declare function ToastProvider({ children }: {
@@ -3516,12 +3828,17 @@ export declare interface VariantSelectorProps {
     labelAttribute?: string;
 }
 
-/** "Why shop with us" reassurance rows. */
+/** "Why shop with us" reassurance tiles. */
 export declare function WhyUs({ items }: {
     items: WhyUsItem[];
 }): JSX.Element;
 
 declare interface WhyUsItem {
+    /**
+     * Accepted and ignored. The built design carries no icons — only the component's own
+     * description still mentions them, and it predates the frame. Kept so a host passing it
+     * does not break.
+     */
     icon?: 'payment' | 'delivery' | 'returns';
     title: string;
     body: string;