@vtex/faststore 0.0.8 → 0.0.11

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`.
 
@@ -61,19 +61,36 @@ Renders `ToastViewport` into `document.body`. No props, context-only.
 
 The fixed-position stack container. Renders a `<div>` — style it directly.
 
-- **No children:** renders one default toast per active toast, in queue order: `ToastRoot` > `ToastTitle` + `ToastDescription` + `ToastAction` + `ToastClose`. Each part renders nothing when the toast has no matching text or `actionProps`, so a reversible toast shows its action between the text and the close button. The close button is named from the message catalog (`fs/toast.dismiss`); its `×` glyph is hidden from assistive technology. The default toast has no status icon and adds no `data-fs-*` hook beyond the existing ones.
-- **With children:** renders exactly those children and no default toast. `null`, `false` and `undefined` count as no children.
-- **Region name:** every viewport gets `aria-label` from the message catalog (`fs/toast.region`, "Notifications") unless you pass your own `aria-label`.
+- **No children:** renders one default toast per active toast, in queue order: `ToastRoot` > `ToastTitle` + `ToastDescription` + `ToastAction` + `ToastClose`. Each part renders nothing when the toast has no matching text or `actionProps`, so a reversible toast shows its action between the text and the close button. The close button is named by the `dismissLabel` message; its `×` glyph is hidden from assistive technology. The default toast has no status icon and adds no `data-fs-*` hook beyond the existing ones.
+- **With children:** renders exactly those children and no default toast, and does not read `dismissLabel`. `null`, `false` and `undefined` count as no children.
+- **Region name:** every viewport's `aria-label` is the `regionLabel` message. A missing message renders an empty name and logs `message.missing`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `$content` | `ContentValue<typeof ToastViewportContent>` | — | The viewport's messages (below). |
+
+Other props are standard `className`/HTML attributes, except `aria-label`, which comes from `regionLabel`. It formats its messages in the storefront locale, so it needs a `StorefrontContextProvider` ancestor (a generated app's root layout provides one).
+
+Content type `toast-viewport`:
+
+| Content field | Description |
+|---|---|
+| regionLabel | The viewport's accessible name |
+| dismissLabel | The default toast's close button name |
 
-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 +118,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 +138,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/docs/variant-selector.md

@@ -337,10 +337,10 @@ A design wanting no colon, the value beside the swatches, or no value at all jus
 
 Per-swatch descendant variants you place on the group's `style` (pick the set matching the swatch list inside it):
 
-- **`VariantSelectorLabelSwatches` (label/box swatches):** `[&_[data-fs-variant-selector-option]]:rounded-[6px] [&_[data-fs-variant-selector-option]]:border [&_[data-fs-variant-selector-option]]:border-[#ccc] [&_[data-fs-variant-selector-option]]:px-[16px] [&_[data-fs-variant-selector-option]]:py-[8px] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:border-[#111] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:bg-[#111] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:text-white [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-disabled=true]]:opacity-40 [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-disabled=true]]:line-through`
-- **`VariantSelectorColorSwatches` (color chips):** `[&_[data-fs-variant-selector-option-color]]:h-[28px] [&_[data-fs-variant-selector-option-color]]:w-[28px] [&_[data-fs-variant-selector-option-color]]:rounded-full [&_[data-fs-variant-selector-option-color]]:[background-color:var(--fs-variant-selector-option-color-bkg-color)] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:ring-2 [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:ring-[#111]`
-- **`VariantSelectorImageSwatches` (image swatches):** `[&_[data-fs-variant-selector-option-image]]:block [&_[data-fs-variant-selector-option-image]]:h-[64px] [&_[data-fs-variant-selector-option-image]]:w-[64px] [&_[data-fs-variant-selector-option-image]]:object-cover [&_[data-fs-variant-selector-option]]:rounded-[6px] [&_[data-fs-variant-selector-option]]:border-2 [&_[data-fs-variant-selector-option]]:border-transparent [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:border-[#111]`
-- **`VariantSelectorRadioSwatches` (radio-dot):** lay each option out as a row and draw the ring + dot on the control/indicator hooks. For a square control swap `rounded-full` → `rounded-none` — no component change. `[&_[data-fs-variant-selector-option]]:flex [&_[data-fs-variant-selector-option]]:items-center [&_[data-fs-variant-selector-option]]:gap-[8px] [&_[data-fs-variant-selector-option-control]]:grid [&_[data-fs-variant-selector-option-control]]:place-items-center [&_[data-fs-variant-selector-option-control]]:h-[18px] [&_[data-fs-variant-selector-option-control]]:w-[18px] [&_[data-fs-variant-selector-option-control]]:rounded-full [&_[data-fs-variant-selector-option-control]]:border [&_[data-fs-variant-selector-option-control]]:border-[#8A8A8A] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]_[data-fs-variant-selector-option-control]]:border-[#C8102E] [&_[data-fs-variant-selector-option-indicator]]:h-[10px] [&_[data-fs-variant-selector-option-indicator]]:w-[10px] [&_[data-fs-variant-selector-option-indicator]]:rounded-full [&_[data-fs-variant-selector-option-indicator]]:bg-[#C8102E]`
+- **`VariantSelectorLabelSwatches` (label/box swatches):** `[&_[data-fs-variant-selector-option]]:rounded-[6px] [&_[data-fs-variant-selector-option]]:border [&_[data-fs-variant-selector-option]]:border-[var(--color-border-strong)] [&_[data-fs-variant-selector-option]]:px-[16px] [&_[data-fs-variant-selector-option]]:py-[8px] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:border-[var(--color-border-contrast)] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:bg-[var(--color-border-contrast)] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:text-white [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-disabled=true]]:opacity-40 [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-disabled=true]]:line-through`
+- **`VariantSelectorColorSwatches` (color chips):** `[&_[data-fs-variant-selector-option-color]]:h-[28px] [&_[data-fs-variant-selector-option-color]]:w-[28px] [&_[data-fs-variant-selector-option-color]]:rounded-full [&_[data-fs-variant-selector-option-color]]:[background-color:var(--fs-variant-selector-option-color-bkg-color)] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:ring-2 [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:ring-[var(--color-border-contrast)]`
+- **`VariantSelectorImageSwatches` (image swatches):** `[&_[data-fs-variant-selector-option-image]]:block [&_[data-fs-variant-selector-option-image]]:h-[64px] [&_[data-fs-variant-selector-option-image]]:w-[64px] [&_[data-fs-variant-selector-option-image]]:object-cover [&_[data-fs-variant-selector-option]]:rounded-[6px] [&_[data-fs-variant-selector-option]]:border-2 [&_[data-fs-variant-selector-option]]:border-transparent [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:border-[var(--color-border-contrast)]`
+- **`VariantSelectorRadioSwatches` (radio-dot):** lay each option out as a row and draw the ring + dot on the control/indicator hooks. For a square control swap `rounded-full` → `rounded-none` — no component change. `[&_[data-fs-variant-selector-option]]:flex [&_[data-fs-variant-selector-option]]:items-center [&_[data-fs-variant-selector-option]]:gap-[8px] [&_[data-fs-variant-selector-option-control]]:grid [&_[data-fs-variant-selector-option-control]]:place-items-center [&_[data-fs-variant-selector-option-control]]:h-[18px] [&_[data-fs-variant-selector-option-control]]:w-[18px] [&_[data-fs-variant-selector-option-control]]:rounded-full [&_[data-fs-variant-selector-option-control]]:border [&_[data-fs-variant-selector-option-control]]:border-[var(--color-border-emphasis)] [&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]_[data-fs-variant-selector-option-control]]:border-[var(--color-primary)] [&_[data-fs-variant-selector-option-indicator]]:h-[10px] [&_[data-fs-variant-selector-option-indicator]]:w-[10px] [&_[data-fs-variant-selector-option-indicator]]:rounded-full [&_[data-fs-variant-selector-option-indicator]]:bg-[var(--color-primary)]`
 - **`VariantSelectorOverflow` ("+N more" trigger):** `[&_[data-fs-variant-selector-overflow-trigger]]:rounded-[6px] [&_[data-fs-variant-selector-overflow-trigger]]:border [&_[data-fs-variant-selector-overflow-trigger]]:border-dashed [&_[data-fs-variant-selector-overflow-trigger]]:px-[16px] [&_[data-fs-variant-selector-overflow-trigger]]:py-[8px] [&_[data-fs-variant-selector-overflow-trigger]]:text-[13px]`
 
 Styled example (color + label-size; the color row composes a `VariantSelectorOverflow`, so it collapses to fit its width):
@@ -367,7 +367,7 @@ Styled example (color + label-size; the color row composes a `VariantSelectorOve
       "[&_[data-fs-variant-selector-option-color]]:rounded-full",
       "[&_[data-fs-variant-selector-option-color]]:[background-color:var(--fs-variant-selector-option-color-bkg-color)]",
       "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:ring-2",
-      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:ring-[#111]"
+      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:ring-[var(--color-border-contrast)]"
     ]
   },
   "variant-color-title": { "type": "VariantSelectorGroupTitle" },
@@ -384,11 +384,11 @@ Styled example (color + label-size; the color row composes a `VariantSelectorOve
       "[&_[data-fs-variant-selector-group-list]]:gap-[8px]",
       "[&_[data-fs-variant-selector-option]]:rounded-[6px]",
       "[&_[data-fs-variant-selector-option]]:border",
-      "[&_[data-fs-variant-selector-option]]:border-[#ccc]",
+      "[&_[data-fs-variant-selector-option]]:border-[var(--color-border-strong)]",
       "[&_[data-fs-variant-selector-option]]:px-[16px]",
       "[&_[data-fs-variant-selector-option]]:py-[8px]",
-      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:border-[#111]",
-      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:bg-[#111]",
+      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:border-[var(--color-border-contrast)]",
+      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:bg-[var(--color-border-contrast)]",
       "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]]:text-white",
       "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-disabled=true]]:opacity-40",
       "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-disabled=true]]:line-through"
@@ -424,12 +424,12 @@ Radio-dot example (a stacked voltage list with the design's prompt copy):
       "[&_[data-fs-variant-selector-option-control]]:w-[18px]",
       "[&_[data-fs-variant-selector-option-control]]:rounded-full",
       "[&_[data-fs-variant-selector-option-control]]:border",
-      "[&_[data-fs-variant-selector-option-control]]:border-[#8A8A8A]",
-      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]_[data-fs-variant-selector-option-control]]:border-[#C8102E]",
+      "[&_[data-fs-variant-selector-option-control]]:border-[var(--color-border-emphasis)]",
+      "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-checked=true]_[data-fs-variant-selector-option-control]]:border-[var(--color-primary)]",
       "[&_[data-fs-variant-selector-option-indicator]]:h-[10px]",
       "[&_[data-fs-variant-selector-option-indicator]]:w-[10px]",
       "[&_[data-fs-variant-selector-option-indicator]]:rounded-full",
-      "[&_[data-fs-variant-selector-option-indicator]]:bg-[#C8102E]",
+      "[&_[data-fs-variant-selector-option-indicator]]:bg-[var(--color-primary)]",
       "[&_[data-fs-variant-selector-option][data-fs-variant-selector-option-disabled=true]]:opacity-40"
     ]
   },
@@ -441,6 +441,10 @@ Radio-dot example (a stacked voltage list with the design's prompt copy):
 }
 ```
 
+The role colors above are the foundation's `visualIdentity` roles (`--color-primary`), so they follow the store when it changes them.
+
+The colors that several elements share are variables of the page or layout `theme`, which declares them: `{"--color-border-strong": "#CCCCCC", "--color-border-contrast": "#111111", "--color-border-emphasis": "#8A8A8A"}`. A color used once stays a hex.
+
 ---
 
 ## Related

package/dist/graphql/types.d.ts

@@ -59,16 +59,12 @@ export type SubgraphResolvers<TContext = SubgraphContext> = {
  * the author writes `@key`/`@external` on entities they extend; the SDK
  * injects the federation `@link` preamble, generates each entity's
  * `__resolveReference`, and prefixes every name the extension contributes
- * with `vendor_` (see `applyVendorPrefix` in `./vendor-prefix`).
+ * with the Platform Extension's vendor (see `applyVendorPrefix` in
+ * `./vendor-prefix`). The vendor and the secret names are not declared here:
+ * `extension.yaml` carries the vendor and the Asset's `asset.yaml` lists the
+ * secrets (ADR-00025).
  */
 export type SubgraphDefinition = {
-  /**
-   * Required. The publisher's VTEX vendor; validated `^[a-z][a-z0-9]*$`.
-   * Prefixes every name this subgraph contributes (entity-extension fields,
-   * root fields, and declared types) — applied by the SDK, never typed by
-   * the author. See ADR-0001.
-   */
-  vendor: string;
   /** Defaults to the package name; the subgraph name used at compose time. */
   name?: string;
   /** Plain SDL, authored with bare names. The SDK applies the vendor prefix. */
@@ -77,12 +73,6 @@ export type SubgraphDefinition = {
   extends: string[];
   /** Author resolvers keyed by bare names; the SDK remaps keys to the prefixed names and merges __resolveReference. */
   resolvers: SubgraphResolvers;
-  /**
-   * Env-var names this extension declares it needs. Their values populate
-   * `ctx.secrets` (read from `process.env`); undeclared names never reach a
-   * resolver. Optional — an extension with no secrets omits it. See ADR-0003.
-   */
-  secrets?: string[];
 };
 //#endregion
 //# sourceMappingURL=types.d.ts.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ActionSelector } from "./core/dist/actions/registry.js";
 import { MockActions, mockAction } from "./core/dist/actions/mock-action.js";
 import { JsonValue, StorefrontContext } from "./core/dist/schema/generated/schema.js";
-import { ContentArraySchema, ContentNestedObjectShape, ContentObjectPropertySchema, ContentObjectSchema, ContentPropertySchema, ContentPropertyType, ContentScalarSchema, ContentScalarType, ContentTypeDefinition, ContentValue, defineContentType } from "./core/dist/define-content-type.js";
+import { ContentArraySchema, ContentNestedObjectShape, ContentObjectPropertySchema, ContentObjectSchema, ContentPropertySchema, ContentPropertyType, ContentScalarSchema, ContentScalarType, ContentTypeDefinition, ContentValue, MessageArgumentSchema, MessageArguments, MessageArgumentsSchema, MessageFieldName, MessageLocaleProp, MessageTagName, defineContentType } from "./core/dist/define-content-type.js";
 import { ComponentDefinition, EditorMetadata, FetchStrategy, PropSchema, PropSchemaField, PropType, VariableBinding, VariableBindings, defineComponent } from "./core/dist/define-component.js";
 import "./core/dist/index.js";
 import { PageRef, ResolveHrefReason, ResolveHrefResult, RouteIdentity, RouteKind, RouteMap, RouteMapEntry, StandardName } from "./sdk/navigation/types.js";
@@ -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 MessageArgumentSchema, type MessageArguments, type MessageArgumentsSchema, type MessageFieldName, type MessageLocaleProp, type MessageTagName, 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

@@ -1,13 +1,13 @@
-import { MessageId, Messages } from "../sdk/i18n/locales.js";
-import "../sdk/i18n/client.js";
 import { gql } from "../sdk/graphql-tag.js";
 import { AddressActionProvider, AddressActionProviderProps } from "../sdk/actions/address-action-provider.js";
 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 +21,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 +29,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, 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

@@ -2,8 +2,8 @@ import { gql } from "../sdk/graphql-tag.js";
 import { RouteMapProvider } from "../sdk/navigation/route-map-provider.js";
 import { RouteIdentityProvider } from "../sdk/navigation/route-identity-provider.js";
 import { DataOverrideContext, useDataOverride } from "../sdk/data/data-override-context.js";
-import { ListItemRefContext, useListItemRef } from "../sdk/data/list-item-ref-context.js";
 import { PageReactiveDataRoot, ReactiveRootContext } from "../sdk/data/page-reactive-data-root.js";
+import { ListItemRefContext, useListItemRef } from "../sdk/data/list-item-ref-context.js";
 import { HotDataProvider } from "../sdk/data/hot-data-provider.js";
 import { publishedVariantIdFor, selectedVariantVar } from "../sdk/state/variant-selector.js";
 import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../sdk/state/cart.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,19 @@
 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 { 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 { decodeRouteParams } from "../sdk/navigation/decode-route-params.js";
+import { permanentRedirectToStorefrontPage, redirectToSignIn, redirectToStorefrontPage } from "../sdk/navigation/redirect.js";
+import { EntityLandingLookup, EntityLandingLookupOptions, EntityLandingQuery, createEntityLandingLookup } from "../sdk/seo/entity-landing.js";
+import { SearchLandingItemRead, SearchLandingLookup, SearchLandingLookupOptions, SearchLandingQuery, createSearchLandingLookup, normalizeSearchTerm } from "../sdk/seo/search-landing.js";
+import { MOCK_SESSION_COOKIE } from "../sdk/session/mock-session.js";
 import { ServerSessionRead, readServerSession } from "../sdk/session/read-server-session.js";
-import { signInTarget } from "../utils/safe-href.js";
+import { returnPathSegment } from "../sdk/session/return-path-segment.js";
+import { RETURN_URL_PARAM, 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 EntityLandingLookup, type EntityLandingLookupOptions, type EntityLandingQuery, type FetchPageDataOptions, type FetchPageDataResult, MOCK_SESSION_COOKIE, type PageAlternates, type PreloadQueryProps, type PreloadQueryRegistry, RETURN_URL_PARAM, type RegisterPreloadQueryOptions, type ResolveBindingSwitchOptions, type RouteParams, type RouteVariant, type SearchLandingItemRead, type SearchLandingLookup, type SearchLandingLookupOptions, type SearchLandingQuery, type ServerSessionRead, type VariablesFromContentOptions, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, createEntityLandingLookup, createSearchLandingLookup, customerOrdersFilter, decodeRouteParams, fetchPageData, normalizeSearchTerm, permanentRedirectToStorefrontPage, readServerSession, redirectToSignIn, redirectToStorefrontPage, registerPreloadQuery, resolveBindingSwitch, resolveStorefrontHref, returnPathSegment, routeLogicalPath, signInTarget, variablesFromContent };

package/dist/internal/server.js

@@ -1,4 +1,4 @@
-import { signInTarget } from "../utils/safe-href.js";
+import { RETURN_URL_PARAM, signInTarget } from "../utils/safe-href.js";
 import { resolveStorefrontHref } from "../sdk/navigation/resolve-storefront-href.js";
 import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
 import { customerOrdersFilter } from "../matter/order-list/customer-orders-filter.js";
@@ -6,8 +6,13 @@ import { createClient } from "../sdk/client/create-client.js";
 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 { MOCK_SESSION_COOKIE } from "../sdk/session/mock-session.js";
+import { permanentRedirectToStorefrontPage, redirectToSignIn, redirectToStorefrontPage } from "../sdk/navigation/redirect.js";
+import { createSearchLandingLookup, normalizeSearchTerm } from "../sdk/seo/search-landing.js";
+import { createEntityLandingLookup } from "../sdk/seo/entity-landing.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 };
+import { returnPathSegment } from "../sdk/session/return-path-segment.js";
+export { CATALOG_ROUTE_ALTERNATES_QUERY, MOCK_SESSION_COOKIE, RETURN_URL_PARAM, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, createEntityLandingLookup, createSearchLandingLookup, customerOrdersFilter, decodeRouteParams, fetchPageData, normalizeSearchTerm, permanentRedirectToStorefrontPage, readServerSession, redirectToSignIn, redirectToStorefrontPage, registerPreloadQuery, resolveBindingSwitch, resolveStorefrontHref, returnPathSegment, routeLogicalPath, signInTarget, variablesFromContent };