@nok-integration/storefront-react 0.19.9 → 0.19.14

package/dist/index.d.ts

@@ -4241,20 +4241,27 @@ export declare interface OrderTimelineProps {
 }
 
 /**
- * Order tracking (Figma `order stats`, 5479:132209).
+ * Order tracking (Figma `order stats`, 5993:30258).
  *
  * One screen with three states, and the engine's `progress` is what draws them: the widget
  * says where the parcel is, and everything under it is the same for all three.
  *
  * The first state carries a "Cancel order" button and the last offers a return.
- * Cancelling happens in place, through the reason sheet; a return is three screens, so
- * "Return items" navigates to them. **Neither moves money** — both record a request and
- * hand it on, and nothing here computes or settles a refund.
+ * Cancelling happens in place, through the reason sheet; a return is three screens, and
+ * they open in place too unless the host has a route of its own. **Neither moves money** —
+ * both record a request and hand it on, and nothing here computes or settles a refund.
  *
  * Both are drawn on the ENGINE's say-so — `can_cancel` is its dispatch cut-off,
  * `can_return` its returns window. Neither is a status this screen can infer, and it does
  * not try.
  *
+ * **The return is offered in ONE place, and it is the "Start a return" row.** `order stats`
+ * draws no button under the timeline; the `Return flow` section's own entry frame
+ * (`5304:76852`) draws that button and no help block at all. The two disagree, and this
+ * screen belongs to `order stats` — the same rule that makes "Order placed" ignore the
+ * "Estimated delivery 22-27 Aug" headline that `Cancel flow` gives it. A screen that
+ * exists only inside a flow, like the cancelled state below, follows that flow's section.
+ *
  * "Contact support" is different again: the form behind it is DAZN's, but the row has
  * somewhere to go without them wiring anything, because pressing it raises
  * `support_requested`.
@@ -4270,15 +4277,14 @@ export declare interface OrderTrackingViewProps {
     /** Overrides the provider's locale for dates. */
     locale?: string;
     /**
-     * Open the return flow.
+     * Open the return flow on a route of your own.
      *
-     * Optional. The return flow is three SCREENS, and only the host knows where its routes
-     * are — the same reason `OrderListView` takes `onOpenOrder` rather than navigating
-     * itself. Mount `ReturnFlowView` with this order's reference and the whole flow is
-     * there.
+     * Optional. Pass it and you own the trip: point it at `<ReturnFlowView>` with this
+     * order's reference. Omit it and the flow opens in place on this screen, the way
+     * cancelling opens its reason sheet.
      *
-     * Without it the control is not drawn. The SDK will not offer a button whose destination
-     * does not exist, and that has not changed either.
+     * Either way the control is drawn whenever the engine sends `can_return`, so the frame's
+     * "Start a return" row is there for a fan whether you route it or not.
      */
     onStartReturn?: () => void;
     /**
@@ -5889,7 +5895,7 @@ export declare function sizeOptions(variants: ProductVariant[], colour?: string
  * choice the parent flips `error` and the message + scroll target appear (buttons stay
  * enabled per the design note). Chips are a real radiogroup for keyboard + SR support.
  */
-export declare function SizeSelector({ sizes, selected, onSelect, error, guide, }: SizeSelectorProps): JSX.Element;
+export declare function SizeSelector({ sizes, selected, onSelect, error, lowStock, guide, }: SizeSelectorProps): JSX.Element;
 
 export declare interface SizeSelectorProps {
     sizes: SizeOption[];
@@ -5898,6 +5904,14 @@ export declare interface SizeSelectorProps {
     onSelect: (value: string) => void;
     /** Show the "select a size" error (set after Add-to-cart is tapped with no selection). */
     error?: boolean;
+    /**
+     * "Only 1 left in M size", when the selected size is nearly gone.
+     *
+     * Rendered here rather than by the caller because the frame's `low-stock` layer lives
+     * INSIDE `mobile/pdp/size`, in the same slot as the error above it — the count is per
+     * size, so it belongs under the squares it is about.
+     */
+    lowStock?: string;
     /**
      * Category-wide sizing help. Absent = the control is not rendered at all, rather than
      * opening an empty overlay — until DAZN supplies a measurement chart most categories