@vtex/faststore 0.0.8 → 0.0.10

package/dist/docs/payment-method-badges.md

@@ -124,7 +124,7 @@ verbatim can still resolve to a declared key — `"WH Google Pay"` resolves to `
 set of names a strip can produce is wider than the store's literal method labels and has to be read off this
 list, not off the payment configuration's screen.
 
-**If the store's `global.json` already has an `icons` object, extend it — do not replace it**, for the same
+**If the store's `foundation.json` already has an `icons` object, extend it — do not replace it**, for the same
 reason `card-entry.md` gives: replacing it silently drops `collection` (or any existing `include` entries),
 and every other icon in that store re-resolves through the fallback default with no error to flag it.
 
@@ -202,7 +202,7 @@ and every other icon in that store re-resolves through the fallback default with
 
 ## Styling
 
-`PaymentMethodBadges` and `AcceptedPaymentMethodBadges` render one root you style directly, plus per-part hooks — the identical set for both, since both are produced by the same internal render path. Each carries its own catalog name, so each gets its own independent swatch entry in `global.json`'s `styles` key even though the two emit the same hooks; style each surface separately if it needs to look different.
+`PaymentMethodBadges` and `AcceptedPaymentMethodBadges` render one root you style directly, plus per-part hooks — the identical set for both, since both are produced by the same internal render path. Each carries its own catalog name, so each gets its own independent swatch entry in `foundation.json`'s `styles` key even though the two emit the same hooks; style each surface separately if it needs to look different.
 
 | Component | What you style | Plausible classes |
 |---|---|---|

package/dist/docs/payment-methods.md

@@ -48,7 +48,7 @@ FooterRoot
 
 **Nothing in the model is required, so a half-filled entry still renders.** An entry with only a heading keeps the authored `methods` prop under the merchant's heading, and vice versa. What the component drops is per item, never the whole strip: an item is skipped when its label is blank, or when it carries neither a `method` nor an `iconUrl` — an icon nobody can name is the one thing this must not ship.
 
-**Every predefined name must be registered.** A `method` resolves to a sprite symbol the store's build has to include; the store's `global.json` writes the names out under `icons.include` — it is JSON, so it cannot import `PAYMENT_METHOD_NAMES`, and a test that derives the expected set from the exported constant is what keeps the two in step. A name the store never registered renders an empty `<svg>` — no build error and no runtime error, just a missing flag.
+**Every predefined name must be registered.** A `method` resolves to a sprite symbol the store's build has to include; the store's `foundation.json` writes the names out under `icons.include` — it is JSON, so it cannot import `PAYMENT_METHOD_NAMES`, and a test that derives the expected set from the exported constant is what keeps the two in step. A name the store never registered renders an empty `<svg>` — no build error and no runtime error, just a missing flag.
 
 ---
 

package/dist/docs/product-information.md

@@ -96,7 +96,7 @@ Renders the product description, optionally collapsed behind a "show more" toggl
 | `moreLabel` | string | `'Show more'` | Trigger label shown when the panel is collapsed. Localize per storefront (e.g. `'mais informações'` for pt-BR). |
 | `lessLabel` | string | `'Show less'` | Trigger label shown when the panel is expanded (e.g. `'menos informações'`). |
 
-The wrapper element follows from the resolved branch: plain text renders as `<p>` (semantic body-text exposure for screen-reader paragraph navigation and SEO); rich HTML renders as `<div>` so block-level markup inside `descriptionHtml` (`<p>`, `<ul>`, headings) stays valid DOM. The element that hosts the rendered description text carries `data-fs-text=""` so project-level `Text` typography defined in `global.json` cascades to the description automatically — no need to repeat font, size, color, leading, or tracking classes inline on every description node. With `collapse: 'none'` that element is the wrapper itself; with `collapse: 'showMore'` or `'section'` it is the panel (the `Collapsible.Root` and the trigger `<button>` deliberately do not carry it so body typography does not cascade onto the trigger label).
+The wrapper element follows from the resolved branch: plain text renders as `<p>` (semantic body-text exposure for screen-reader paragraph navigation and SEO); rich HTML renders as `<div>` so block-level markup inside `descriptionHtml` (`<p>`, `<ul>`, headings) stays valid DOM. The element that hosts the rendered description text carries `data-fs-text=""` so project-level `Text` typography defined in `foundation.json` cascades to the description automatically — no need to repeat font, size, color, leading, or tracking classes inline on every description node. With `collapse: 'none'` that element is the wrapper itself; with `collapse: 'showMore'` or `'section'` it is the panel (the `Collapsible.Root` and the trigger `<button>` deliberately do not carry it so body typography does not cascade onto the trigger label).
 
 Rich HTML is rendered via `dangerouslySetInnerHTML`; Storefront API Core sanitizes `descriptionHtml` upstream, so this is safe for first-party catalogs.
 
@@ -253,7 +253,7 @@ The main heading — large and bold. Typical: `text-[20px] leading-[1.3] font-se
 
 ### ProductInformationDescription
 
-Body copy — smaller, lighter, comfortable line height. Typical: `text-[14px] leading-[1.6] font-normal text-[#666666]`. The element that hosts the text carries `data-fs-text=""` in every collapse mode (the wrapper itself for `collapse: 'none'`, the panel for `'showMore'` and `'section'`), so if the project's `global.json` defines `Text.base` with the body-text typography (font, size, leading, weight, color), those styles cascade to the description automatically and no inline typography classes are needed on the description node.
+Body copy — smaller, lighter, comfortable line height. Typical: `text-[14px] leading-[1.6] font-normal text-[#666666]`. The element that hosts the text carries `data-fs-text=""` in every collapse mode (the wrapper itself for `collapse: 'none'`, the panel for `'showMore'` and `'section'`), so if the project's `foundation.json` defines `Text.base` with the body-text typography (font, size, leading, weight, color), those styles cascade to the description automatically and no inline typography classes are needed on the description node.
 
 When `collapse` is `'showMore'` or `'section'`, the trigger element is a real `<button>` rendered as a sibling of the panel inside the Collapsible root. Style it via the `data-fs-product-information-description-trigger` attribute hook so the trigger inherits the description's flex container without being centered or stretched. Typical: `[&_[data-fs-product-information-description-trigger]]:self-start [&_[data-fs-product-information-description-trigger]]:text-[14px] [&_[data-fs-product-information-description-trigger]]:font-medium [&_[data-fs-product-information-description-trigger]]:underline`. Pair with the brand's link color via an arbitrary hex (e.g. `[&_[data-fs-product-information-description-trigger]]:text-[#e60014]`).
 

package/dist/docs/product-shelf.md

@@ -26,11 +26,14 @@ The image is the source of truth for the heading text, `first`/`itemsPerPage`, a
 
 - A cross-sell / discovery shelf on the PDP (Related Products), PLP, or Search Results: a facet-scoped, navigable carousel of product cards configured entirely in the VTEX Studio.
 
+- A shelf inside a conditional branch that is often not shown, such as the empty state of the cart: use `ProductShelfOnMountRoot`. It is the same shelf, but its data is fetched by the client when the element mounts and never reaches the server HTML or the page query.
+
 ## When NOT to use
 
 - A full-page product listing driven by the route/search → use `ProductListRoot` (prop-driven) with the PLP grid.
 - PDP single-product pricing → use `PricingRoot` (it fetches one `productBySlug`; it cannot price a per-card item in a list).
 - A generic non-product track of children → use the `Carousel` particle directly.
+- `ProductShelfOnMountRoot` above the fold, or anywhere the products must be in the server HTML → use `ProductShelfRoot`.
 
 ---
 
@@ -66,6 +69,10 @@ The image is the source of truth for the heading text, `first`/`itemsPerPage`, a
 | `$data` | slice | — | Compiler-injected fragment result |
 | `products` | `ProductShelfItem[]` | — | Pre-shaped items (stories/tests; bypasses `$data`). Rendered as given: `first` does not limit them |
 
+### ProductShelfOnMountRoot
+
+`ProductShelfRoot` with `fetchStrategy: 'lazy-on-mount'`. It renders `ProductShelfRoot` and reuses its fragment, `variables` block and props (all of the table above except `$content` and `$data`). The difference is delivery: the page query never selects its `products` field, and the client sends the request, in its own operation, only when the element mounts. The generated page wraps it in a `HotDataProvider` with a `null` fallback, so until the response arrives, and when the request fails or returns no products, it renders nothing (no skeleton). Without that provider and without a `products` prop it has no source and renders the loading skeleton permanently; pass `products` outside a generated page. It has no content model, so its variables come from props only. Place it inside a conditional branch (for example `CartEmpty`), never above the fold; a layout cannot compose it.
+
 ### Content model `product-shelf`
 
 `ProductShelfContent` declares the merchant-facing fields: `first` (number, minimum 1), `sort` (the eight members above), `categoryId`, `brandId`, `collectionId`, `searchTerm` (string) and `availableOnly` (boolean). None is required. In a store with a `cms` binding the merchant fills them in the Content Platform entry keyed by the element id, and the shelf re-queries on the next request with no deploy; an empty field falls to the prop, and an empty facet relaxes the filter.

package/dist/docs/select.md

@@ -26,10 +26,9 @@ Signals that distinguish it from other controls:
 - A **country/region selector** (ISO codes resolved to display names), a **sort-order dropdown**, or a
   **quantity/unit picker** are the most common PDP/checkout uses.
 
-This particle currently has no `store-editor` knowledge-base row: it is a leaf control with no
-distinct visual region of its own, and the bound `FieldSelect.*` parts cannot be generated from a
-screenshot without the bound Control that consumes them (`ShippingAddressCountryControl`). This section documents the
-visual pattern for a human reader; it is not wired into image→schema detection.
+This particle is a leaf control with no distinct visual region of its own, and the bound `FieldSelect.*`
+parts cannot be generated from a screenshot without the bound Control that consumes them
+(`ShippingAddressCountryControl`). This section documents the visual pattern for a human reader.
 
 ---
 

package/dist/docs/sign-in-redirect.md

@@ -118,7 +118,7 @@ That element carries both hooks: `data-fs-sign-in-redirect` is the component's i
 }
 ```
 
-A spinner beside the text is a decoration the component does not render. Draw it from the element itself, once per store, as the `SignInRedirect` base swatch in `global.json → styles`. `before:block` is what makes the pseudo-element take a width and height — an inline one ignores both:
+A spinner beside the text is a decoration the component does not render. Draw it from the element itself, once per store, as the `SignInRedirect` base swatch in `foundation.json → styles`. `before:block` is what makes the pseudo-element take a width and height — an inline one ignores both:
 
 ```json
 {

package/dist/docs/toast.md

@@ -21,23 +21,23 @@
 
 ## Composition
 
-`Toast` is not authored as a per-toast PageSchema tree. Only the **stack scaffolding** is mounted once, near the layout root, and a `ToastViewport` with no children renders every toast itself:
+`Toast` is not authored as a per-toast PageSchema tree. The stack is mounted once in the layout schema, near the root. A `ToastViewport` with no children renders every toast itself; to control the markup, put a `ToastList` inside it with the per-toast card as a template:
 
 ```
 ToastProvider
 └── ToastPortal
     └── ToastViewport
+        └── ToastList            ← repeats its children once per queued toast
+            └── ToastRoot        ← the template; reads its toast from ToastList
+                ├── ToastTitle                (optional — auto-renders toast.title with no children)
+                ├── ToastDescription          (optional — auto-renders toast.description with no children)
+                ├── ToastAction (optional)    ← reversible action, e.g. "Undo"
+                └── ToastClose (optional)
 ```
 
-A `ToastViewport` with no children renders one default toast per entry of `useToast().toasts` (see below), so a page schema never lists a toast. To control the markup, pass children: map over `useToast().toasts` and render a `ToastRoot` for each. A typical per-toast render tree (authored in application code, not in a schema):
+A `ToastViewport` with no children renders one default toast per entry of `useToast().toasts` (see below), so a page schema never lists a toast. Passing children takes control of the markup, and `ToastList` is the schema-composable way to do it: it renders its template once per queued toast and `ToastRoot` reads each toast from it. In application code you can instead map over `useToast().toasts` and pass `toast` to `ToastRoot` yourself.
 
-```
-ToastRoot                    ← one per queued toast, keyed by toast.id
-├── ToastTitle                (optional — auto-renders toast.title with no children)
-├── ToastDescription          (optional — auto-renders toast.description with no children)
-├── ToastAction (optional)    ← reversible action, e.g. "Undo"
-└── ToastClose (optional)
-```
+The message text is not in the schema. It comes from whoever calls `add()` at runtime. With no children, `ToastList` renders `ToastRoot > ToastTitle + ToastDescription` for each toast; a `ToastViewport` containing a `ToastList` counts as having children, so the default toasts do not render alongside it.
 
 `Icon` (existing particle) may be composed as a plain sibling of `ToastTitle`/`ToastDescription` inside `ToastRoot` — there is no dedicated status-icon sub-component. Wrap it in a plain `<span data-fs-toast-icon-container="">` at the call site for a tinted background; `ToastRoot` does not inject this wrapper itself, since it renders `children` verbatim. Style both hooks off `data-fs-toast-root-type`.
 
@@ -67,13 +67,19 @@ The fixed-position stack container. Renders a `<div>` — style it directly.
 
 No props beyond standard `className`/HTML attributes. It reads the message catalog, so it needs an intl provider ancestor (a generated app's root layout provides one).
 
+### ToastList
+
+Renders its `children` once for each queued toast, in the order of `useToast().toasts`, each inside a per-toast context that `ToastRoot` reads. With no children it renders `ToastRoot > ToastTitle + ToastDescription`. It renders no element of its own, so it adds no `data-fs-*` hook and takes no `style`. Without a `ToastProvider` ancestor it renders nothing. Place it as the direct child of `ToastViewport`.
+
+No props beyond `children`.
+
 ### ToastRoot
 
-One instance per active toast.
+One instance per active toast. Place it inside `ToastList` as the template, or render it yourself with an explicit `toast`. With neither, it renders nothing.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
-| `toast` | `ToastObject` | — | Required. One entry from `useToast().toasts`. |
+| `toast` | `ToastObject` | toast from the enclosing `ToastList` | One entry from `useToast().toasts`. Wins over the list's toast when both exist. |
 | `swipeDirection` | `'up' \| 'down' \| 'left' \| 'right'` or an array of those | `['down', 'right']` | Directions the shopper can swipe to dismiss. |
 
 ### ToastTitle / ToastDescription
@@ -101,7 +107,18 @@ function SaveProfileButton() {
 }
 ```
 
-`useToast()` is Base UI's `useToastManager()` re-exported under the FastStore name — `toasts`, `add`, `close`, `update`, and `promise` all behave exactly as documented at [base-ui.com/react/components/toast](https://base-ui.com/react/components/toast).
+Under a provider-optional caller, such as a component that renders in layouts with or without a provider, use `useOptionalToast()`. It returns the same value as `useToast()`, or `null` when no `ToastProvider` is mounted, and never throws:
+
+```tsx
+import { useOptionalToast } from '@vtex/faststore/components';
+
+function RemoveButton() {
+  const toast = useOptionalToast();
+  return <button onClick={() => toast?.add({ title: 'Item removed' })}>Remove</button>;
+}
+```
+
+`useToast()` is Base UI's `useToastManager()` re-exported under the FastStore name, and it still throws without a provider. `toasts`, `add`, `close`, `update`, and `promise` all behave exactly as documented at [base-ui.com/react/components/toast](https://base-ui.com/react/components/toast).
 
 ---
 
@@ -110,6 +127,7 @@ function SaveProfileButton() {
 | Component | What you style | Plausible classes |
 |---|---|---|
 | `ToastViewport` | Positions the stack on the screen | `fixed bottom-4 right-4 flex flex-col gap-2 w-[320px]` |
+| `ToastList` | Nothing. It renders no element | — |
 | `ToastRoot` | The toast card's surface; key off `data-fs-toast-root-type` for status color | `rounded-lg px-4 py-3 shadow-lg data-[fs-toast-root-type=error]:bg-red-50` |
 | `ToastTitle` | Toast heading typography | `text-sm font-semibold` |
 | `ToastDescription` | Toast body typography | `text-sm text-gray-600` |

package/dist/index.d.ts

@@ -9,6 +9,7 @@ import { CartUserError } from "./sdk/cart/operations.js";
 import { AddItemPayload, CartActions, CartCouponPayload, CartLinePayload, CartLinesPayload, CartQuantityPayload } from "./sdk/cart/use-cart-actions.js";
 import { ClientPreferenceKey, ClientProfileUserError, CustomerProfileUserError } from "./sdk/identity/operations.js";
 import { ClientPreferencesUpdatePayload, ClientProfileUpdatePayload, CustomerProfileUpdatePayload, IdentityActions } from "./sdk/identity/use-identity-actions.js";
+import { LocaleActions } from "./sdk/locale/use-locale-actions.js";
 import { OrderCancelOrder, OrderCancelUserError } from "./sdk/orders/order-operations.js";
 import { OrderActions, OrderCancelInput, OrderCancelResult } from "./sdk/orders/use-order-actions.js";
 import { PaymentBillingAddressUpdateInput, PaymentMethodSelectInput, PaymentMoney, PaymentUserError } from "./sdk/payment/operations.js";
@@ -23,4 +24,4 @@ import { ShippingAddressInput, ShippingAddressUpdateErrorEntity } from "./sdk/sh
 import { ShippingActions } from "./sdk/shipping/use-shipping-actions.js";
 import { ComponentActions } from "./sdk/actions/types.js";
 import { resolveStorefrontHref } from "./sdk/navigation/resolve-storefront-href.js";
-export { type ActionSelector, type AddItemPayload, type CartActions, type CartCouponPayload, type CartLinePayload, type CartLinesPayload, type CartQuantityPayload, type CartUserError, type ClientPreferenceKey, type ClientPreferencesUpdatePayload, type ClientProfileUpdatePayload, type ClientProfileUserError, type ComponentActions, type ComponentDefinition, type ContentArraySchema, type ContentNestedObjectShape, type ContentObjectPropertySchema, type ContentObjectSchema, type ContentPropertySchema, type ContentPropertyType, type ContentScalarSchema, type ContentScalarType, type ContentTypeDefinition, type ContentValue, type CustomerProfileUpdatePayload, type CustomerProfileUserError, type EditorMetadata, type FetchStrategy, type IdentityActions, type JsonValue, type MockActions, type OrderActions, type OrderCancelInput, type OrderCancelOrder, type OrderCancelResult, type OrderCancelUserError, type PageRef, type PaymentActions, type PaymentBillingAddressUpdateInput, type PaymentGatewayCallbackResult, type PaymentGatewayCard, type PaymentGatewayNewCard, type PaymentGatewayResult, type PaymentGatewaySavedCard, type PaymentGatewayTransaction, type PaymentMethodSelectInput, type PaymentMoney, type PaymentStartTransactionResult, type PaymentUserError, type PropSchema, type PropSchemaField, type PropType, type RegionActions, type RegionUserError, type ResolveHrefReason, type ResolveHrefResult, type RouteIdentity, type RouteKind, type RouteMap, type RouteMapEntry, type SendPaymentsRequest, type SessionAccessCodeRequestResult, type SessionActions, type SessionPasswordLoginPayload, type SessionRequestAccessCodePayload, type SessionUserError, type SessionValidateAccessCodePayload, type ShippingActions, type ShippingAddressInput, type ShippingAddressUpdateErrorEntity, type ShippingOptionSelectUserError, type StandardName, type StorefrontContext, type VariableBinding, type VariableBindings, defineComponent, defineContentType, mockAction, resolveStorefrontHref };
+export { type ActionSelector, type AddItemPayload, type CartActions, type CartCouponPayload, type CartLinePayload, type CartLinesPayload, type CartQuantityPayload, type CartUserError, type ClientPreferenceKey, type ClientPreferencesUpdatePayload, type ClientProfileUpdatePayload, type ClientProfileUserError, type ComponentActions, type ComponentDefinition, type ContentArraySchema, type ContentNestedObjectShape, type ContentObjectPropertySchema, type ContentObjectSchema, type ContentPropertySchema, type ContentPropertyType, type ContentScalarSchema, type ContentScalarType, type ContentTypeDefinition, type ContentValue, type CustomerProfileUpdatePayload, type CustomerProfileUserError, type EditorMetadata, type FetchStrategy, type IdentityActions, type JsonValue, type LocaleActions, type MockActions, type OrderActions, type OrderCancelInput, type OrderCancelOrder, type OrderCancelResult, type OrderCancelUserError, type PageRef, type PaymentActions, type PaymentBillingAddressUpdateInput, type PaymentGatewayCallbackResult, type PaymentGatewayCard, type PaymentGatewayNewCard, type PaymentGatewayResult, type PaymentGatewaySavedCard, type PaymentGatewayTransaction, type PaymentMethodSelectInput, type PaymentMoney, type PaymentStartTransactionResult, type PaymentUserError, type PropSchema, type PropSchemaField, type PropType, type RegionActions, type RegionUserError, type ResolveHrefReason, type ResolveHrefResult, type RouteIdentity, type RouteKind, type RouteMap, type RouteMapEntry, type SendPaymentsRequest, type SessionAccessCodeRequestResult, type SessionActions, type SessionPasswordLoginPayload, type SessionRequestAccessCodePayload, type SessionUserError, type SessionValidateAccessCodePayload, type ShippingActions, type ShippingAddressInput, type ShippingAddressUpdateErrorEntity, type ShippingOptionSelectUserError, type StandardName, type StorefrontContext, type VariableBinding, type VariableBindings, defineComponent, defineContentType, mockAction, resolveStorefrontHref };

package/dist/internal/client.d.ts

@@ -5,9 +5,11 @@ import { AddressActionProvider, AddressActionProviderProps } from "../sdk/action
 import { AnalyticsActionProvider, AnalyticsActionProviderProps } from "../sdk/actions/analytics-action-provider.js";
 import { CartActionProvider, CartActionProviderProps } from "../sdk/actions/cart-action-provider.js";
 import { IdentityActionProvider, IdentityActionProviderProps } from "../sdk/actions/identity-action-provider.js";
+import { LocaleActionProvider, LocaleActionProviderProps } from "../sdk/actions/locale-action-provider.js";
 import { OrderActionProvider, OrderActionProviderProps } from "../sdk/actions/order-action-provider.js";
 import { PaymentActionProvider, PaymentActionProviderProps } from "../sdk/actions/payment-action-provider.js";
 import { RegionActionProvider, RegionActionProviderProps } from "../sdk/actions/region-action-provider.js";
+import { SavedCardActionProvider, SavedCardActionProviderProps } from "../sdk/actions/saved-card-action-provider.js";
 import { SessionActionProvider, SessionActionProviderProps } from "../sdk/actions/session-action-provider.js";
 import { ShippingActionProvider, ShippingActionProviderProps } from "../sdk/actions/shipping-action-provider.js";
 import "../sdk/actions/index.js";
@@ -21,6 +23,7 @@ import { ClientVariablesMap, PageReactiveDataRoot, PageReactiveDataRootProps, Re
 import { ReactiveDataProvider, ReactiveDataProviderProps } from "../sdk/data/reactive-data-provider.js";
 import { ReactiveListItemDataProvider, ReactiveListItemDataProviderProps } from "../sdk/data/reactive-list-item-data-provider.js";
 import "../sdk/data/index.js";
+import { BindingSwitchProvider, BindingSwitchProviderProps } from "../sdk/locale/binding-switch-provider.js";
 import { RouteMapProvider, RouteMapProviderProps, ToLogicalPath } from "../sdk/navigation/route-map-provider.js";
 import { reportNotFoundRequest } from "../sdk/navigation/not-found-log.js";
 import { RouteIdentityProvider, RouteIdentityProviderProps } from "../sdk/navigation/route-identity-provider.js";
@@ -28,4 +31,4 @@ import { StorefrontProvider, StorefrontProviderProps } from "../sdk/provider/sto
 import "../sdk/provider/index.js";
 import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../sdk/state/cart.js";
 import { SelectedVariant, publishedVariantIdFor, selectedVariantVar } from "../sdk/state/variant-selector.js";
-export { AddressActionProvider, type AddressActionProviderProps, AnalyticsActionProvider, type AnalyticsActionProviderProps, CartActionProvider, type CartActionProviderProps, type ClientVariablesMap, DataOverrideContext, HotDataProvider, type HotDataProviderProps, IdentityActionProvider, type IdentityActionProviderProps, type ListItemRef, ListItemRefContext, type MessageId, type Messages, MultipleReactiveDataProvider, type MultipleReactiveDataProviderEntity, type MultipleReactiveDataProviderProps, OrderActionProvider, type OrderActionProviderProps, PageReactiveDataRoot, type PageReactiveDataRootProps, PaymentActionProvider, type PaymentActionProviderProps, ReactiveDataProvider, type ReactiveDataProviderProps, ReactiveListItemDataProvider, type ReactiveListItemDataProviderProps, ReactiveRootContext, type ReactiveRootContextValue, RegionActionProvider, type RegionActionProviderProps, RouteIdentityProvider, type RouteIdentityProviderProps, RouteMapProvider, type RouteMapProviderProps, type SelectedVariant, SessionActionProvider, type SessionActionProviderProps, ShippingActionProvider, type ShippingActionProviderProps, StorefrontProvider, type StorefrontProviderProps, type ToLogicalPath, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, reportNotFoundRequest, selectedVariantVar, useDataOverride, useListItemRef };
+export { AddressActionProvider, type AddressActionProviderProps, AnalyticsActionProvider, type AnalyticsActionProviderProps, BindingSwitchProvider, type BindingSwitchProviderProps, CartActionProvider, type CartActionProviderProps, type ClientVariablesMap, DataOverrideContext, HotDataProvider, type HotDataProviderProps, IdentityActionProvider, type IdentityActionProviderProps, type ListItemRef, ListItemRefContext, LocaleActionProvider, type LocaleActionProviderProps, type MessageId, type Messages, MultipleReactiveDataProvider, type MultipleReactiveDataProviderEntity, type MultipleReactiveDataProviderProps, OrderActionProvider, type OrderActionProviderProps, PageReactiveDataRoot, type PageReactiveDataRootProps, PaymentActionProvider, type PaymentActionProviderProps, ReactiveDataProvider, type ReactiveDataProviderProps, ReactiveListItemDataProvider, type ReactiveListItemDataProviderProps, ReactiveRootContext, type ReactiveRootContextValue, RegionActionProvider, type RegionActionProviderProps, RouteIdentityProvider, type RouteIdentityProviderProps, RouteMapProvider, type RouteMapProviderProps, SavedCardActionProvider, type SavedCardActionProviderProps, type SelectedVariant, SessionActionProvider, type SessionActionProviderProps, ShippingActionProvider, type ShippingActionProviderProps, StorefrontProvider, type StorefrontProviderProps, type ToLogicalPath, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, reportNotFoundRequest, selectedVariantVar, useDataOverride, useListItemRef };

package/dist/internal/client.js

@@ -12,9 +12,12 @@ import { AddressActionProvider } from "../sdk/actions/address-action-provider.js
 import { AnalyticsActionProvider } from "../sdk/actions/analytics-action-provider.js";
 import { CartActionProvider } from "../sdk/actions/cart-action-provider.js";
 import { IdentityActionProvider } from "../sdk/actions/identity-action-provider.js";
+import { BindingSwitchProvider } from "../sdk/locale/binding-switch-provider.js";
+import { LocaleActionProvider } from "../sdk/actions/locale-action-provider.js";
 import { OrderActionProvider } from "../sdk/actions/order-action-provider.js";
 import { PaymentActionProvider } from "../sdk/actions/payment-action-provider.js";
 import { RegionActionProvider } from "../sdk/actions/region-action-provider.js";
+import { SavedCardActionProvider } from "../sdk/actions/saved-card-action-provider.js";
 import { SessionActionProvider } from "../sdk/actions/session-action-provider.js";
 import { ShippingActionProvider } from "../sdk/actions/shipping-action-provider.js";
 import "../sdk/actions/index.js";
@@ -27,4 +30,4 @@ import { reportNotFoundRequest } from "../sdk/navigation/not-found-log.js";
 import { StorefrontProvider } from "../sdk/provider/storefront-provider.js";
 import "../sdk/provider/index.js";
 import "../sdk/state/index.js";
-export { AddressActionProvider, AnalyticsActionProvider, CartActionProvider, DataOverrideContext, HotDataProvider, IdentityActionProvider, ListItemRefContext, MultipleReactiveDataProvider, OrderActionProvider, PageReactiveDataRoot, PaymentActionProvider, ReactiveDataProvider, ReactiveListItemDataProvider, ReactiveRootContext, RegionActionProvider, RouteIdentityProvider, RouteMapProvider, SessionActionProvider, ShippingActionProvider, StorefrontProvider, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, reportNotFoundRequest, selectedVariantVar, useDataOverride, useListItemRef };
+export { AddressActionProvider, AnalyticsActionProvider, BindingSwitchProvider, CartActionProvider, DataOverrideContext, HotDataProvider, IdentityActionProvider, ListItemRefContext, LocaleActionProvider, MultipleReactiveDataProvider, OrderActionProvider, PageReactiveDataRoot, PaymentActionProvider, ReactiveDataProvider, ReactiveListItemDataProvider, ReactiveRootContext, RegionActionProvider, RouteIdentityProvider, RouteMapProvider, SavedCardActionProvider, SessionActionProvider, ShippingActionProvider, StorefrontProvider, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, reportNotFoundRequest, selectedVariantVar, useDataOverride, useListItemRef };

package/dist/internal/server.d.ts

@@ -1,14 +1,16 @@
 import { resolveStorefrontHref } from "../sdk/navigation/resolve-storefront-href.js";
 import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
+import { AlternateBinding, BuildPageAlternatesOptions, CATALOG_ROUTE_ALTERNATES_QUERY, PageAlternates, RouteParams, RouteVariant, buildPageAlternates, catalogClusterPaths, routeLogicalPath } from "../sdk/seo/page-alternates.js";
+import { BindingSwitchRequest, BindingSwitchResult, ResolveBindingSwitchOptions, resolveBindingSwitch } from "../sdk/navigation/binding-switch.js";
 import { customerOrdersFilter } from "../matter/order-list/customer-orders-filter.js";
 import { CreateClientOptions, createClient } from "../sdk/client/create-client.js";
 import { FetchPageDataOptions, FetchPageDataResult, fetchPageData } from "../sdk/client/fetch-page-data.js";
 import { PreloadQueryRegistry, RegisterPreloadQueryOptions, registerPreloadQuery } from "../sdk/client/register-preload-query.js";
 import { ContentVariableField, ContentVariablesSpec, VariablesFromContentOptions, variablesFromContent } from "../sdk/data/variables-from-content.js";
 import { getIntl, loadMessages } from "../sdk/i18n/server.js";
+import { decodeRouteParams } from "../sdk/navigation/decode-route-params.js";
 import { permanentRedirectToStorefrontPage, redirectToStorefrontPage } from "../sdk/navigation/redirect.js";
-import { AlternateBinding, BuildPageAlternatesOptions, CATALOG_ROUTE_ALTERNATES_QUERY, PageAlternates, RouteParams, RouteVariant, buildPageAlternates, catalogClusterPaths, routeLogicalPath } from "../sdk/seo/page-alternates.js";
 import { ServerSessionRead, readServerSession } from "../sdk/session/read-server-session.js";
 import { signInTarget } from "../utils/safe-href.js";
 import { PreloadQueryProps } from "@apollo/client-integration-nextjs";
-export { type AlternateBinding, type BuildPageAlternatesOptions, CATALOG_ROUTE_ALTERNATES_QUERY, type ContentVariableField, type ContentVariablesSpec, type CreateClientOptions, type FetchPageDataOptions, type FetchPageDataResult, type PageAlternates, type PreloadQueryProps, type PreloadQueryRegistry, type RegisterPreloadQueryOptions, type RouteParams, type RouteVariant, type ServerSessionRead, type VariablesFromContentOptions, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, customerOrdersFilter, fetchPageData, getIntl, loadMessages, permanentRedirectToStorefrontPage, readServerSession, redirectToStorefrontPage, registerPreloadQuery, resolveStorefrontHref, routeLogicalPath, signInTarget, variablesFromContent };
+export { type AlternateBinding, type BindingSwitchRequest, type BindingSwitchResult, type BuildPageAlternatesOptions, CATALOG_ROUTE_ALTERNATES_QUERY, type ContentVariableField, type ContentVariablesSpec, type CreateClientOptions, type FetchPageDataOptions, type FetchPageDataResult, type PageAlternates, type PreloadQueryProps, type PreloadQueryRegistry, type RegisterPreloadQueryOptions, type ResolveBindingSwitchOptions, type RouteParams, type RouteVariant, type ServerSessionRead, type VariablesFromContentOptions, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, customerOrdersFilter, decodeRouteParams, fetchPageData, getIntl, loadMessages, permanentRedirectToStorefrontPage, readServerSession, redirectToStorefrontPage, registerPreloadQuery, resolveBindingSwitch, resolveStorefrontHref, routeLogicalPath, signInTarget, variablesFromContent };

package/dist/internal/server.js

@@ -7,7 +7,9 @@ import { fetchPageData } from "../sdk/client/fetch-page-data.js";
 import { registerPreloadQuery } from "../sdk/client/register-preload-query.js";
 import { variablesFromContent } from "../sdk/data/variables-from-content.js";
 import { getIntl, loadMessages } from "../sdk/i18n/server.js";
-import { permanentRedirectToStorefrontPage, redirectToStorefrontPage } from "../sdk/navigation/redirect.js";
 import { CATALOG_ROUTE_ALTERNATES_QUERY, buildPageAlternates, catalogClusterPaths, routeLogicalPath } from "../sdk/seo/page-alternates.js";
+import { decodeRouteParams } from "../sdk/navigation/decode-route-params.js";
+import { resolveBindingSwitch } from "../sdk/navigation/binding-switch.js";
+import { permanentRedirectToStorefrontPage, redirectToStorefrontPage } from "../sdk/navigation/redirect.js";
 import { readServerSession } from "../sdk/session/read-server-session.js";
-export { CATALOG_ROUTE_ALTERNATES_QUERY, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, customerOrdersFilter, fetchPageData, getIntl, loadMessages, permanentRedirectToStorefrontPage, readServerSession, redirectToStorefrontPage, registerPreloadQuery, resolveStorefrontHref, routeLogicalPath, signInTarget, variablesFromContent };
+export { CATALOG_ROUTE_ALTERNATES_QUERY, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, customerOrdersFilter, decodeRouteParams, fetchPageData, getIntl, loadMessages, permanentRedirectToStorefrontPage, readServerSession, redirectToStorefrontPage, registerPreloadQuery, resolveBindingSwitch, resolveStorefrontHref, routeLogicalPath, signInTarget, variablesFromContent };