@nok-integration/storefront-react 0.19.14 → 0.19.16

package/dist/index.d.ts

@@ -2503,6 +2503,7 @@ declare function createClient(options: ClientOptions): {
                 cta: string;
                 image?: string | undefined;
                 target?: string | undefined;
+                video?: string | undefined;
                 focal_y?: number | undefined;
             }[];
         }>;
@@ -2858,6 +2859,7 @@ declare function createClient(options: ClientOptions): {
                     amount: number;
                     currency: string;
                 } | undefined;
+                returned_qty?: number | undefined;
             }[];
             totals: {
                 shipping: {
@@ -2951,6 +2953,7 @@ declare function createClient(options: ClientOptions): {
                     amount: number;
                     currency: string;
                 } | undefined;
+                returned_qty?: number | undefined;
             }[];
             totals: {
                 shipping: {
@@ -3729,6 +3732,20 @@ declare const OrderDetail: z.ZodObject<{
          */
         cancelled_qty: z.ZodNumber;
         refunded_qty: z.ZodNumber;
+        /**
+         * Units already reported as coming back.
+         *
+         * **The returns screen cannot compute what is left without it, and got it wrong.** The
+         * engine refuses a return of more than `qty - cancelled_qty - refunded_qty - returned_qty`
+         * (`returns.service`), and this was the only one of those four not on the wire — so a
+         * line returned in full still offered its full quantity, and choosing it answered 400
+         * `invalid_request` with "Only 0 of line_1 can be returned". Seen on UAT order 611887,
+         * 28 Aug.
+         *
+         * Optional so an engine that predates it stays valid; absent means zero, which is what a
+         * consumer already assumed.
+         */
+        returned_qty: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         sku: string;
         qty: number;
@@ -3750,6 +3767,7 @@ declare const OrderDetail: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         attributes?: Record<string, string> | undefined;
+        returned_qty?: number | undefined;
     }, {
         sku: string;
         qty: number;
@@ -3771,6 +3789,7 @@ declare const OrderDetail: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         attributes?: Record<string, string> | undefined;
+        returned_qty?: number | undefined;
     }>, "many">;
     ship_to: z.ZodObject<{
         name: z.ZodString;
@@ -3951,6 +3970,7 @@ declare const OrderDetail: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         attributes?: Record<string, string> | undefined;
+        returned_qty?: number | undefined;
     }[];
     totals: {
         shipping: {
@@ -4037,6 +4057,7 @@ declare const OrderDetail: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         attributes?: Record<string, string> | undefined;
+        returned_qty?: number | undefined;
     }[];
     totals: {
         shipping: {
@@ -4704,7 +4725,7 @@ export declare interface ProductDetailsProps {
 }
 
 /**
- * One product as its own gallery (Figma `mobile/limited edition`, 5304:77067).
+ * One product as its own gallery (Figma `mobile/limited edition`, 5986:27948).
  *
  * **The third shape a product takes on a category page**, and the reason it is its own
  * component rather than a variant of the other two: `featured` is one product as one large
@@ -5769,6 +5790,51 @@ export declare interface ShopSurfaceProps extends Omit<ComponentPropsWithoutRef<
 
 export declare type ShopTone = 'dark' | 'light';
 
+/**
+ * Full-bleed background video: muted, looping, inline, and never showing a control.
+ *
+ * The four attributes below are not stylistic. `muted` and `playsInline` together are the
+ * only combination iOS will start without a gesture — a video that is unmuted, or that is
+ * allowed to go fullscreen, simply does not play, and the panel shows its poster forever.
+ * `loop` is the brief. `controls` is absent because this is artwork behind copy, not a
+ * player: a tap belongs to the CTA stretched over the panel, and a play button in the
+ * middle of a category slide would sit directly on that hit area.
+ *
+ * **Playback follows visibility.** The shop entry is five full-screen panels, so a naive
+ * page decodes five simultaneous streams for four panels nobody is looking at. Each clip
+ * starts when its panel comes into view and pauses when it leaves, which keeps one video
+ * decoding at a time. Fetching is deferred the same way: `preload="none"` until the
+ * observer fires, so a fan who never scrolls past the hero pays for the hero alone.
+ *
+ * **Reduced motion is honoured by not playing at all.** Autoplaying background video is
+ * exactly what the preference is about, and there is a good still to fall back to — the
+ * poster is frame 0 of the clip, so the panel is the design's own opening frame rather
+ * than an empty box. The preference is read live rather than once: a fan can change it
+ * while the page is open, and on iOS it changes with the low-power setting.
+ */
+export declare function ShopVideo({ src, poster, fill, className, style, priority, }: ShopVideoProps): JSX.Element;
+
+export declare interface ShopVideoProps {
+    src: string;
+    /**
+     * Still shown until the first frame decodes, and the only thing shown when motion is
+     * reduced. Cut from frame 0 of `src` so there is no jump when playback starts.
+     */
+    poster?: string;
+    /**
+     * Fill the positioned ancestor, as `ShopImage`'s `fill` does. The parent must be
+     * `position: relative` (or absolute/fixed) — same requirement, same reason.
+     */
+    fill?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    /**
+     * Above the fold. Fetches the file immediately instead of waiting for the panel to come
+     * into view. One video per screen should carry this; the rest should not.
+     */
+    priority?: boolean;
+}
+
 /**
  * Sizing help, shown in the PDP "Size guide" overlay (Figma `size-guide`, 4882:58365).
  *