@vtex/faststore 0.0.8 → 0.0.10

package/dist/catalog.json

@@ -369,6 +369,37 @@
     "schema": {},
     "guideline": "Status, count, or category labels with semantic color variants. Use for tags, status indicators, and notification badges."
   },
+  "BindingSwitcher": {
+    "name": "BindingSwitcher",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Binding Switcher",
+      "category": "action"
+    },
+    "actions": {
+      "locale": [
+        "set"
+      ]
+    },
+    "schema": {
+      "bindings": {
+        "type": "object",
+        "label": "Bindings"
+      },
+      "label": {
+        "type": "string",
+        "default": "Language",
+        "label": "Label"
+      },
+      "notice": {
+        "type": "string",
+        "default": "This page isn't available in the selected language.",
+        "label": "Notice"
+      }
+    },
+    "guideline": "Lists the bindings a store declares and switches the whole binding (locale, currency, sales channel) through locale.set. Renders nothing when fewer than two bindings are present; the store passes bindings as $data.Global.localization.bindings.",
+    "docPath": "src/particles/binding-switcher/binding-switcher.md"
+  },
   "Button": {
     "name": "Button",
     "importPath": "@vtex/faststore/components",
@@ -379,6 +410,72 @@
     "schema": {},
     "guideline": "Composable action button — combine with Icon for icon buttons, Spinner for loading states. Ghost appearance can be achieved via className."
   },
+  "CardSummary": {
+    "name": "CardSummary",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "card-summary",
+    "editor": {
+      "label": "Card Summary",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "A saved card's identity: network mark, label or else network name, mask, last four digits, in that order by default. Compose CardSummaryMark / Name / Mask / Digits as children to reorder or drop a part; the reading order follows the composition. The default satisfies the rule that the mark and the digits always show; a custom composition that drops either gives that up. Must be inside a card-summary provider.",
+    "docPath": "src/particles/card-summary/card-summary.md"
+  },
+  "CardSummaryMark": {
+    "name": "CardSummaryMark",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "card-summary",
+    "editor": {
+      "label": "Card Summary Mark",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "The card network's mark. When the card has a label, it also carries the network: hidden text beside the mark, or the network name as visible text for a network with no mark. Renders nothing for an unlabelled card on a network with no mark, since the name says it. On an unlabelled card the glyph is decorative and CardSummaryName announces the network, so compose both: Mark without Name leaves screen readers no network. Marks come from data, so the store lists CARD_NETWORK_ICON_NAMES under icons.include. Must be inside a card-summary provider.",
+    "docPath": "src/particles/card-summary/card-summary.md"
+  },
+  "CardSummaryName": {
+    "name": "CardSummaryName",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "card-summary",
+    "editor": {
+      "label": "Card Summary Name",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "The shopper's label for the card, or else its network name; nothing when both are blank. Read-only. On an unlabelled card it is the only part a screen reader hears the network from. Must be inside a card-summary provider.",
+    "docPath": "src/particles/card-summary/card-summary.md"
+  },
+  "CardSummaryMask": {
+    "name": "CardSummaryMask",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "card-summary",
+    "editor": {
+      "label": "Card Summary Mask",
+      "category": "content"
+    },
+    "schema": {
+      "mask": {
+        "type": "string",
+        "default": "••••",
+        "label": "Mask"
+      }
+    },
+    "guideline": "Decoration standing for the hidden digits: the mask text (•••• by default), or children such as an icon in its place. Keep children inline. Always hidden from assistive technology; dropping it changes nothing a screen reader hears. Renders nothing when empty or when the card has no digits. Must be inside a card-summary provider.",
+    "docPath": "src/particles/card-summary/card-summary.md"
+  },
+  "CardSummaryDigits": {
+    "name": "CardSummaryDigits",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "card-summary",
+    "editor": {
+      "label": "Card Summary Digits",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "The last four digits, announced to screen readers as \"ending in\" and the digits. Never more than four digits. Renders nothing when the card has no digits. Must be inside a card-summary provider.",
+    "docPath": "src/particles/card-summary/card-summary.md"
+  },
   "CarouselRoot": {
     "name": "CarouselRoot",
     "importPath": "@vtex/faststore/components",
@@ -3281,7 +3378,8 @@
         "label": "Default Auto-Dismiss (ms)"
       }
     },
-    "guideline": "Mount once at the layout root to enable toasts anywhere in the tree. Compose as: ToastProvider > ToastPortal > ToastViewport (a childless viewport renders the active toasts itself; add ToastRoot children only to override). Components trigger toasts via the useToast() hook, not through page-schema composition.",
+    "providesContext": "toast",
+    "guideline": "Mount once at the layout root, above the Slot. Compose as: ToastProvider > ToastPortal > ToastViewport. A childless ToastViewport renders the active toasts itself; to control the markup, put a ToastList with a ToastRoot template inside it. Code raises toasts with useOptionalToast() (null without a provider) or useToast() (throws without one).",
     "docPath": "src/particles/toast/toast.md"
   },
   "ToastPortal": {
@@ -3303,7 +3401,7 @@
       "category": "layout"
     },
     "schema": {},
-    "guideline": "The fixed-position stack container for all active toasts. With no children it renders every active toast itself (title, description, action and a localized close button), so a page schema needs only ToastProvider > ToastPortal > ToastViewport. Pass children (a ToastRoot per useToast().toasts entry) to take control of the markup. Position it with a swatch on data-fs-toast-viewport (e.g. bottom-right vs. top-center). Direct child of ToastPortal.",
+    "guideline": "The fixed-position stack container for all active toasts. With no children it renders every active toast itself (title, description, action and a localized close button), so a page schema needs only ToastProvider > ToastPortal > ToastViewport. Pass children to take control of the markup: a ToastList with a ToastRoot template is the schema-composable way (it renders the template once per queued toast), or map useToast().toasts to ToastRoot in code. Position it with a swatch on data-fs-toast-viewport (e.g. bottom-right vs. top-center). Direct child of ToastPortal.",
     "docPath": "src/particles/toast/toast.md"
   },
   "ToastRoot": {
@@ -3314,7 +3412,21 @@
       "category": "layout"
     },
     "schema": {},
-    "guideline": "One instance per active toast. A childless ToastViewport renders these itself; compose ToastRoot only to override that, by mapping over useToast().toasts. Compose as: ToastRoot > (Icon + ToastTitle + ToastDescription + ToastAction + ToastClose), all optional except at least one of Title/Description.",
+    "requiresContext": "toast-item",
+    "guideline": "One instance per active toast. Inside a ToastList it is the per-toast template and reads its toast from the list; a childless ToastViewport renders its own ToastRoot per toast, so compose one only to override that. Compose as: ToastRoot > (Icon + ToastTitle + ToastDescription + ToastAction + ToastClose), all optional except at least one of Title/Description.",
+    "docPath": "src/particles/toast/toast.md"
+  },
+  "ToastList": {
+    "name": "ToastList",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Toast List",
+      "category": "layout"
+    },
+    "schema": {},
+    "requiresContext": "toast",
+    "providesContext": "toast-item",
+    "guideline": "Renders its children once per queued toast; place a ToastRoot (with ToastTitle and ToastDescription, both auto-filled from the toast) inside it as the template. With no children it renders that template by default. Direct child of ToastViewport; renders nothing without a ToastProvider ancestor.",
     "docPath": "src/particles/toast/toast.md"
   },
   "ToastTitle": {
@@ -4344,6 +4456,231 @@
     "guideline": "Loading placeholder rendered by AccountMenuIdentity while the profile is unresolved. Declares no context requirement — it renders before the matter has anything to show.",
     "docPath": "src/matter/account-menu-identity/account-menu-identity.md"
   },
+  "AccountSavedCardsRoot": {
+    "name": "AccountSavedCardsRoot",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment AccountSavedCardsData on Query {\n    customerSavedCards {\n      __typename\n      id\n      cards {\n        __typename\n        id\n      }\n    }\n  }\n",
+    "fetchStrategy": "reactive",
+    "requiresContext": "session",
+    "providesContext": "account-saved-cards",
+    "actions": {
+      "savedCard": [
+        "remove"
+      ]
+    },
+    "editor": {
+      "label": "Account Saved Cards Root",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "The signed-in shopper's saved cards, read with no cart. Renders nothing unless the session is loggedIn, and no chrome of its own: compose AccountSavedCardsHeading, AccountSavedCardsRemoveFeedback, AccountSavedCardsLoading, AccountSavedCardsError, AccountSavedCardsEmpty, and AccountSavedCardsList (with an AccountSavedCardItem inside) as children. Exactly one of Loading, Error, Empty, or List renders at a time; the state is on data-fs-account-saved-cards-state. It owns the removal state and supplies the savedCard.remove write to every AccountSavedCardRemove inside, placed or default, so the write sits here rather than on the control that dispatches it; with no remove control composed the write is never called. Must be inside a SessionRoot, normally the my-account layout's. See account-saved-cards.md.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardsHeading": {
+    "name": "AccountSavedCardsHeading",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-cards-heading",
+    "requiresContext": "account-saved-cards",
+    "editor": {
+      "label": "Account Saved Cards Heading",
+      "category": "identity"
+    },
+    "schema": {
+      "as": {
+        "type": [
+          "h2",
+          "h3",
+          "h4",
+          "h5",
+          "h6"
+        ],
+        "default": "h2",
+        "label": "Heading level"
+      }
+    },
+    "guideline": "The section heading, rendered in every state. `as` sets the level from h2 to h6 (default h2); there is no h1, because the page title belongs to the page shell — pick the level that fits where the section is nested, or omit the heading. Text resolves children, then the CMS entry, then the catalog (fs/saved-cards.heading). Must be inside AccountSavedCardsRoot.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardsList": {
+    "name": "AccountSavedCardsList",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-saved-cards",
+    "providesContext": "account-saved-card",
+    "editor": {
+      "label": "Account Saved Cards List",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "The list of saved cards, one row per card in the platform order, rendered only when the shopper has at least one. Place one AccountSavedCardItem inside as the row template. Must be inside AccountSavedCardsRoot.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardItem": {
+    "name": "AccountSavedCardItem",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment AccountSavedCardItemData on Query {\n    customerSavedCards {\n      cards {\n        __typename\n        id\n        network {\n          name\n        }\n        lastDigits\n        expiry {\n          month\n          year\n        }\n        status\n      }\n    }\n  }\n",
+    "fetchStrategy": "reactive-list-item",
+    "requiresContext": "account-saved-card",
+    "providesContext": [
+      "card-summary",
+      "account-saved-card-data"
+    ],
+    "editor": {
+      "label": "Account Saved Card Item",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "One saved card as a list row. It provides the card to the CardSummary parts, AccountSavedCardExpiry, and AccountSavedCardRemove. With no children it renders CardSummary (mark, network name, mask, last four digits), AccountSavedCardExpiry, and AccountSavedCardRemove, whose text is then always the catalog wording; compose them as children to rearrange them or to reword them from the CMS, keep AccountSavedCardExpiry in any custom row, and leave AccountSavedCardRemove out only for a read-only list. An expired row carries data-fs-account-saved-card-expired, an unusable one data-fs-account-saved-card-unusable, and a row whose removal is pending data-fs-account-saved-card-removing, for a swatch to dim. Never shows more than the last four digits. Must be inside AccountSavedCardsList.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardExpiry": {
+    "name": "AccountSavedCardExpiry",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-card-expiry",
+    "requiresContext": "account-saved-card-data",
+    "editor": {
+      "label": "Account Saved Card Expiry",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "When a saved card expires: \"Expires 05/28\" for a working card, \"Expired 05/24\" (or \"Expired\" with no date) for an expired one, and \"This card can't be used\", with no date, for an unusable one. Renders nothing for a working card with no date. The label comes from the CMS entry, then the catalog (fs/saved-cards.expires, .expired, .expired-no-date, .unusable); the component always places the MM/YY date after it, and only a placed element reads the CMS entry. The state is on data-fs-account-saved-card-expiry-status (usable, expired, unusable). Must be inside AccountSavedCardItem.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardsEmpty": {
+    "name": "AccountSavedCardsEmpty",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-cards-empty",
+    "requiresContext": "account-saved-cards",
+    "editor": {
+      "label": "Account Saved Cards Empty",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "States that the shopper has no saved cards. Renders only once the read resolved with none — never while loading or after a failure. Text resolves children, then the CMS entry, then the catalog (fs/saved-cards.empty). Must be inside AccountSavedCardsRoot.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardsLoading": {
+    "name": "AccountSavedCardsLoading",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-cards-loading",
+    "requiresContext": "account-saved-cards",
+    "editor": {
+      "label": "Account Saved Cards Loading",
+      "category": "identity"
+    },
+    "schema": {
+      "skeletonCount": {
+        "type": "number",
+        "default": 2,
+        "label": "Placeholder rows"
+      }
+    },
+    "guideline": "Placeholder rows while the saved cards load, plus one polite live region that announces the wait (CMS entry, then the catalog fs/saved-cards.loading). The rows are hidden from assistive technology; style them through data-fs-account-saved-cards-loading-row. Without this part the section shows no loading look. Must be inside AccountSavedCardsRoot.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardsError": {
+    "name": "AccountSavedCardsError",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-cards-error",
+    "requiresContext": "account-saved-cards",
+    "editor": {
+      "label": "Account Saved Cards Error",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "An alert shown when the saved cards cannot be read. An expired session says so and links to sign-in, returning the shopper to this page; any other failure says the cards could not be loaded. The wording comes from the CMS entry, then the catalog (fs/saved-cards.session-expired, .sign-in, .load-failed), never from the server; children replace it for every failure and drop the link. Must be inside AccountSavedCardsRoot.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardRemove": {
+    "name": "AccountSavedCardRemove",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-saved-card-data",
+    "providesContext": "account-saved-card-remove",
+    "editor": {
+      "label": "Account Saved Card Remove",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "Lets the shopper remove the row's card after confirming. State-only controller: wrap one AlertDialogRoot and it becomes controlled, so never set open or onOpenChange on it. Compose AlertDialogRoot > (AccountSavedCardRemoveTrigger + AlertDialogPortal > (AlertDialogBackdrop + AlertDialogViewport > AlertDialogPopup > (AccountSavedCardRemoveTitle + AccountSavedCardRemoveDescription + AccountSavedCardRemoveCancel + AccountSavedCardRemoveConfirm))), Cancel before Confirm so the safe action takes focus. With no children it renders that prompt with catalog text; compose the parts to reword them from the CMS. The prompt stays open while the removal runs and closes when it fails; on success the row leaves the list. AccountSavedCardsRoot supplies the savedCard.remove write, and the outcome goes unreported unless the section composes AccountSavedCardsRemoveFeedback. Must be inside AccountSavedCardItem.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardRemoveTrigger": {
+    "name": "AccountSavedCardRemoveTrigger",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-card-remove-trigger",
+    "requiresContext": "account-saved-card-remove",
+    "editor": {
+      "label": "Account Saved Card Remove Trigger",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "Opens the removal prompt. Its accessible name is its text followed by the card, e.g. \"Remove Visa ending in 1234\"; the card part is visually hidden. Disabled while any removal in the section is pending. Text resolves children, then the CMS entry, then the catalog (fs/saved-cards.remove.trigger). Direct child of the AlertDialogRoot inside AccountSavedCardRemove.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardRemoveTitle": {
+    "name": "AccountSavedCardRemoveTitle",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-card-remove-title",
+    "requiresContext": "account-saved-card-remove",
+    "editor": {
+      "label": "Account Saved Card Remove Title",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "The removal prompt's question and its accessible name. Required inside AlertDialogPopup. Text resolves children, then the CMS entry, then the catalog (fs/saved-cards.remove.title). Must be inside AccountSavedCardRemove.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardRemoveDescription": {
+    "name": "AccountSavedCardRemoveDescription",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-card-remove-description",
+    "requiresContext": "account-saved-card-remove",
+    "editor": {
+      "label": "Account Saved Card Remove Description",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "Names the card and states the consequence; screen readers announce it with the prompt. With no children it renders CardSummary and then the text, which resolves the CMS entry, then the catalog (fs/saved-cards.remove.description); children replace both, so keep a CardSummary in them for the prompt to name the card. Inside AlertDialogPopup, after AccountSavedCardRemoveTitle. Must be inside AccountSavedCardRemove.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardRemoveCancel": {
+    "name": "AccountSavedCardRemoveCancel",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-card-remove-cancel",
+    "requiresContext": "account-saved-card-remove",
+    "editor": {
+      "label": "Account Saved Card Remove Cancel",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "Closes the removal prompt and keeps the card. Disabled while the removal runs. Place it before AccountSavedCardRemoveConfirm so it takes focus when the prompt opens. Text resolves children, then the CMS entry, then the catalog (fs/saved-cards.remove.cancel). Must be inside AccountSavedCardRemove.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardRemoveConfirm": {
+    "name": "AccountSavedCardRemoveConfirm",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-card-remove-confirm",
+    "requiresContext": "account-saved-card-remove",
+    "editor": {
+      "label": "Account Saved Card Remove Confirm",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "Removes the card. It dispatches savedCard.remove through the write AccountSavedCardsRoot supplies and declares none of its own. While the removal runs it is busy and shows its pending text; one removal runs at a time in the section. Text resolves children, then the CMS entry, then the catalog (fs/saved-cards.remove.confirm, .pending). Must be inside AccountSavedCardRemove.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
+  "AccountSavedCardsRemoveFeedback": {
+    "name": "AccountSavedCardsRemoveFeedback",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-saved-cards-remove-feedback",
+    "requiresContext": "account-saved-cards",
+    "editor": {
+      "label": "Account Saved Cards Remove Feedback",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "Tells the shopper how a card removal ended: a status message that takes focus when the card was removed, or an alert when it was not, with a sign-in link back to this page when the session expired. Renders in every state of the section, so the message outlives the removed row and an emptied list; it stays until the next removal starts. Without this part a removal's outcome goes unreported. The wording comes from the CMS entry, then the catalog (fs/saved-cards.remove.success, .failed, fs/saved-cards.session-expired, .sign-in), never from the server; the outcome is on data-fs-account-saved-cards-remove-feedback-outcome. Must be inside AccountSavedCardsRoot.",
+    "docPath": "src/matter/account-saved-cards/account-saved-cards.md"
+  },
   "BillingAddress": {
     "name": "BillingAddress",
     "importPath": "@vtex/faststore/components",
@@ -4699,14 +5036,19 @@
   "CartRoot": {
     "name": "CartRoot",
     "importPath": "@vtex/faststore/components",
-    "fragment": "\n  fragment CartData on Query {\n    cart {\n      __typename\n      id\n      items {\n        __typename\n        id\n        quantity\n        gift\n        variant {\n          __typename\n          availability\n        }\n      }\n      totalizers {\n        __typename\n        id\n        name\n        value {\n          ...MoneyFragment\n        }\n      }\n      total {\n        ...MoneyFragment\n      }\n      messages {\n        __typename\n        code\n        text\n        status\n      }\n      appliedCoupons {\n        code\n        isUnmatchedCondition\n      }\n    }\n  }\n\nfragment MoneyFragment on Money {\n  __typename\n  amount\n  currencyCode\n}",
+    "fragment": "\n  fragment CartData on Query {\n    cart {\n      __typename\n      id\n      items {\n        __typename\n        id\n        quantity\n        gift\n        variant {\n          __typename\n          availability\n        }\n      }\n      totalizers {\n        __typename\n        id\n        name\n        value {\n          ...MoneyFragment\n        }\n      }\n      total {\n        ...MoneyFragment\n      }\n      messages {\n        __typename\n        code\n        text\n        status\n      }\n      appliedCoupons {\n        code\n        isUnmatchedCondition\n      }\n      discounts {\n        name\n        value {\n          ...MoneyFragment\n        }\n        kind\n      }\n      salesChannelMismatch {\n        cartSalesChannel\n        activeSalesChannel\n      }\n    }\n  }\n\nfragment MoneyFragment on Money {\n  __typename\n  amount\n  currencyCode\n}",
     "fetchStrategy": "reactive",
     "editor": {
       "label": "Cart Root",
       "category": "commerce"
     },
     "schema": {},
-    "guideline": "Cart data provider hosted by the layout (shared shell), wrapping the slot so every page consumes its context; exactly one per tree — do not place it as a page root. To build a mini-cart, wrap this CartRoot subtree in a modal DrawerRoot: the header carries a DrawerTrigger with a CartCount badge, the DrawerPopup body is a CartList line-item template, and its footer is CartTotal plus CartGoCheckout. The mini-cart is this layout composition, not a dedicated component. See cart.md.",
+    "actions": {
+      "cart": [
+        "syncSalesChannel"
+      ]
+    },
+    "guideline": "Cart data provider hosted by the layout (shared shell), wrapping the slot so every page consumes its context; exactly one per tree — do not place it as a page root. To build a mini-cart, wrap this CartRoot subtree in a modal DrawerRoot: the header carries a DrawerTrigger with a CartCount badge, the DrawerPopup body is a CartList line-item template, and its footer is CartTotal plus CartGoCheckout. The mini-cart is this layout composition, not a dedicated component. See cart.md. On load, a cart whose sales channel differs from the request is moved onto the active channel.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartList": {
@@ -4755,9 +5097,13 @@
         "type": "string",
         "default": "{count}",
         "label": "Template"
+      },
+      "templateOne": {
+        "type": "string",
+        "label": "Template (one)"
       }
     },
-    "guideline": "Renders the total item count in the cart; use the template prop to customize the format (e.g. '{count} produtos'). Gift lines are excluded from the count — a promotional gift is not something the shopper added — so a cart holding only gifts shows 0. In a mini-cart, place it as the badge on the header DrawerTrigger and again in the DrawerPopup header. Must be inside CartRoot.",
+    "guideline": "Renders the total item count in the cart; use the template prop to customize the format (e.g. '{count} produtos'). Set templateOne (e.g. '{count} produto') to word the count of exactly 1; template covers every other count, including 0, and is also used when templateOne is unset. A count that is not a finite number renders nothing. Gift lines are excluded from the count — a promotional gift is not something the shopper added — so a cart holding only gifts shows 0. In a mini-cart, place it as the badge on the header DrawerTrigger and again in the DrawerPopup header. Must be inside CartRoot.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartError": {
@@ -4816,6 +5162,11 @@
       "applyLabel": {
         "type": "string",
         "label": "Apply Label"
+      },
+      "appliedMessage": {
+        "type": "string",
+        "default": "Coupon applied",
+        "label": "Applied message"
       }
     },
     "actions": {
@@ -4823,7 +5174,7 @@
         "applyCoupon"
       ]
     },
-    "guideline": "Coupon code input plus an apply button; root-agnostic (dispatches $actions.cart.applyCoupon). While an apply is in flight it disables the input and button and exposes data-fs-cart-coupon-pending. In a mini-cart it sits in the DrawerPopup footer above the totals; pair it with CartAppliedCoupons (the applied list) and CartCouponError (the error banner). Must be inside CartRoot.",
+    "guideline": "Coupon code input plus an apply button; root-agnostic (dispatches $actions.cart.applyCoupon). While an apply is in flight it disables the input and button and exposes data-fs-cart-coupon-pending. In a mini-cart it sits in the DrawerPopup footer above the totals; pair it with CartAppliedCoupons (the applied list) and CartCouponError (the error banner). For a single-coupon store, wrap the entry (the accordion holding this form) in CartCouponEmpty so it hides once a code is applied. When an apply returns no errors and the submitted code comes back matched, it raises a toast titled appliedMessage (needs a ToastProvider with a ToastList in the layout; with none, no toast shows and the apply still works). An unmatched code raises no toast; compose CartCouponUnmatched in the chip for that case. The toast still shows when CartCouponEmpty removes the form. Must be inside CartRoot.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartAppliedCoupons": {
@@ -4839,7 +5190,7 @@
         "removeCoupon"
       ]
     },
-    "guideline": "Renders one chip per applied coupon (cart.appliedCoupons), each showing its code and a CartCouponRemove control; renders nothing when no coupons are applied. A coupon whose conditions did not match is marked with data-fs-cart-coupon-unmatched. Place it next to CartCouponForm in the mini-cart footer. Must be inside CartRoot.",
+    "guideline": "Renders one chip per applied coupon (cart.appliedCoupons), each showing its code and a CartCouponRemove control; renders nothing when no coupons are applied. A coupon whose conditions did not match is marked with data-fs-cart-coupon-unmatched. Place it next to CartCouponForm in the mini-cart footer. Composed children replace the built-in remove control, so a chip template that adds CartCouponUnmatched (the unmatched-coupon notice) or CartCouponSavings (the amount the coupon saves) must also compose CartCouponRemove. Must be inside CartRoot.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartCouponRemove": {
@@ -4874,6 +5225,51 @@
     "guideline": "Inline error banner that surfaces coupon apply/remove errors next to the CartCouponForm; renders nothing when there are none. Reads a dedicated coupon error channel, separate from CartError. Must be inside CartRoot.",
     "docPath": "src/matter/cart/cart.md"
   },
+  "CartCouponEmpty": {
+    "name": "CartCouponEmpty",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Cart Coupon Empty",
+      "category": "commerce"
+    },
+    "schema": {},
+    "guideline": "Coupon entry gate: renders its children only while the resolved cart has no applied coupon (cart.appliedCoupons is empty), and nothing while the cart loads. The merchant coupon policy is composition: for a single-coupon store, wrap the coupon entry (the AccordionRoot holding CartCouponForm) in it so the entry hides once a code is applied and returns when the chip is removed; for a multi-coupon store, omit it so the entry stays open for more codes. Keep CartAppliedCoupons and CartCouponError outside it, so the applied chips and coupon errors stay visible. Must be inside CartRoot. See cart.md.",
+    "docPath": "src/matter/cart/cart.md"
+  },
+  "CartCouponUnmatched": {
+    "name": "CartCouponUnmatched",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Cart Coupon Unmatched",
+      "category": "commerce"
+    },
+    "schema": {
+      "message": {
+        "type": "string",
+        "default": "This coupon is not being applied to your cart",
+        "label": "Message"
+      }
+    },
+    "guideline": "Per-chip notice for an applied coupon that grants nothing: renders the message copy in an <output> live region only while the enclosing chip's coupon has isUnmatchedCondition (its conditions stopped matching, were never met, or the code was accepted without validation), and nothing once it matches again, outside a chip, or when the copy is blank. Place it inside CartAppliedCoupons next to CartCouponRemove: composed children replace the built-in remove control, so a chip template without CartCouponRemove loses the X. It does not remove the coupon; the shopper removes it with the X. See cart.md.",
+    "docPath": "src/matter/cart/cart.md"
+  },
+  "CartCouponSavings": {
+    "name": "CartCouponSavings",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Cart Coupon Savings",
+      "category": "commerce"
+    },
+    "schema": {
+      "template": {
+        "type": "string",
+        "default": "{amount}",
+        "label": "Template"
+      }
+    },
+    "guideline": "Per-chip amount a fixed-amount coupon took off, summed from cart.discounts for the enclosing chip's code. Renders nothing for an unmatched, free-shipping or percentage coupon (the API attributes no amount to them), outside a chip, or when the sum is not above zero. Set template to word the chip text, e.g. 'Economia de {amount}' or '{code} — Economia de {amount}': every {amount} becomes the saving and every {code} the chip's code; the default is '{amount}' and a blank template counts as unset. The chip already shows the code before its children, so {code} repeats it. Place it inside a CartAppliedCoupons chip template next to CartCouponRemove: composed children replace the built-in remove control, so a chip template without CartCouponRemove loses the X. Must be inside CartRoot. See cart.md.",
+    "docPath": "src/matter/cart/cart.md"
+  },
   "CartCheckoutGuard": {
     "name": "CartCheckoutGuard",
     "importPath": "@vtex/faststore/components",
@@ -4930,9 +5326,13 @@
         "type": "string",
         "default": "{count} items unavailable",
         "label": "Template"
+      },
+      "templateOne": {
+        "type": "string",
+        "label": "Template (one)"
       }
     },
-    "guideline": "Cart-level summary of how many lines are unavailable; self-hides when none. See cart.md.",
+    "guideline": "Cart-level summary of how many lines are unavailable; self-hides when none. Set templateOne to word the count of exactly 1 line; template covers every other count, including 0, and is also used when templateOne is unset. See cart.md.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartRemoveUnavailable": {
@@ -4951,6 +5351,22 @@
     "guideline": "Button that removes every unavailable line in one batch call; self-hides when none. See cart.md.",
     "docPath": "src/matter/cart/cart.md"
   },
+  "ClearCartButton": {
+    "name": "ClearCartButton",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Clear Cart Button",
+      "category": "commerce"
+    },
+    "schema": {},
+    "actions": {
+      "cart": [
+        "removeItems"
+      ]
+    },
+    "guideline": "Button that removes every line in the cart (gift and unavailable lines included) in one batch call; self-hides when the cart has no lines. Disabled, with data-fs-clear-cart-button-pending, while the call is in flight. No confirmation and no toast. The write is optimistic: CartEmpty replaces CartFilled as soon as it is clicked; on failure the lines come back and the error shows in CartError, so compose a CartError outside the CartFilled/CartEmpty branches. Children are the label (default \"Clear cart\"). Must be inside CartRoot. See cart.md.",
+    "docPath": "src/matter/cart/cart.md"
+  },
   "CartOpenOnAdd": {
     "name": "CartOpenOnAdd",
     "importPath": "@vtex/faststore/components",
@@ -5030,7 +5446,7 @@
       }
     },
     "providesContext": "cart-alert",
-    "guideline": "Merchant-authored notice near the top of the mini-cart overlay (a minimum order, a running promotion): wraps CartAlertIcon and CartAlertText in any subset, any order — the arrangement is the composition, not a prop — and renders the glyph then the copy when composed with no children. Its copy and glyph are CMS-editable through the cart-alert content model, with the text, icon, iconUrl and iconAlt props as the non-CMS fallback; it renders nothing when no message is configured, so an unconfigured banner leaves no empty box. Reads no cart data, so it needs no CartRoot ancestor and no cart-state gate — place it inside CartFilled to hide it on an empty cart. A store whose merchants choose the icon must list CART_ALERT_ICON_NAMES under icons.include in global.json, or a chosen glyph renders empty. Distinct from CartError (cart mutation errors) and CartUnavailableCount (data-driven). See cart.md.",
+    "guideline": "Merchant-authored notice near the top of the mini-cart overlay (a minimum order, a running promotion): wraps CartAlertIcon and CartAlertText in any subset, any order — the arrangement is the composition, not a prop — and renders the glyph then the copy when composed with no children. Its copy and glyph are CMS-editable through the cart-alert content model, with the text, icon, iconUrl and iconAlt props as the non-CMS fallback; it renders nothing when no message is configured, so an unconfigured banner leaves no empty box. Reads no cart data, so it needs no CartRoot ancestor and no cart-state gate — place it inside CartFilled to hide it on an empty cart. A store whose merchants choose the icon must list CART_ALERT_ICON_NAMES under icons.include in its foundation, or a chosen glyph renders empty. Distinct from CartError (cart mutation errors) and CartUnavailableCount (data-driven). See cart.md.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartAlertIcon": {
@@ -5093,10 +5509,194 @@
     "guideline": "Dismisses the cart overlay so the shopper can keep browsing; dispatches no cart write. Place it in the empty panel inside CartEmpty, commonly in a footer Container. It closes the drawer, so it requires a DrawerRoot ancestor — on a cart page with no drawer, compose a NavigationLink back to browsing instead of this control. CMS content wins over the label prop, and composed children win over both (compose an icon that way). See cart.md.",
     "docPath": "src/matter/cart/cart.md"
   },
+  "CartDestinationRoot": {
+    "name": "CartDestinationRoot",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment CartDestinationData on Query {\n    shipping {\n      __typename\n      id\n      address {\n        __typename\n        id\n        postalCode\n        country\n        city\n        state\n      }\n    }\n  }\n",
+    "fetchStrategy": "reactive",
+    "providesContext": "cartDestination",
+    "actions": {
+      "shipping": [
+        "setAddress"
+      ]
+    },
+    "editor": {
+      "label": "Cart Destination Root",
+      "category": "content"
+    },
+    "schema": {
+      "defaultCountry": {
+        "type": "string",
+        "default": "BRA",
+        "label": "Default country (ISO alpha-3)"
+      }
+    },
+    "guideline": "Where the cart is delivered, with a postal-code-only form that writes the cart destination so the free-shipping bar follows. Compose CartDestinationRead (CartDestinationValue, CartDestinationUnset, CartDestinationChange) for read mode and CartDestinationForm (PostalCodeControl, Submit, Cancel, Error) for edit mode. Starts in read mode; the store cannot open edit mode from outside. See cart-destination.md.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationRead": {
+    "name": "CartDestinationRead",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Read",
+      "category": "layout"
+    },
+    "schema": {},
+    "guideline": "Wraps what read mode shows: the value, the invitation when no destination is set, and the change control. Renders nothing while edit mode is open. Must be inside CartDestinationRoot.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationValue": {
+    "name": "CartDestinationValue",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "cart-destination-value",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Value",
+      "category": "content"
+    },
+    "schema": {
+      "prefix": {
+        "type": "string",
+        "label": "Prefix"
+      }
+    },
+    "guideline": "The cart destination as postal code, city and state, each in its own element. Renders nothing while loading or when no destination is set. Must be inside CartDestinationRoot.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationUnset": {
+    "name": "CartDestinationUnset",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Unset",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "Renders its children only once the destination resolved and none is set. Place the store-authored invitation (for example a Text reading \"Informe seu CEP\") inside it, within CartDestinationRead. Must be inside CartDestinationRoot.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationChange": {
+    "name": "CartDestinationChange",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "cart-destination-change",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Change",
+      "category": "action"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Button label"
+      }
+    },
+    "guideline": "Button that opens edit mode, styled as a link by the store. Place it inside CartDestinationRead. Must be inside CartDestinationRoot.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationForm": {
+    "name": "CartDestinationForm",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Form",
+      "category": "action"
+    },
+    "schema": {},
+    "guideline": "Edit mode: renders only while editing and routes Enter to the submit. Holds the postal code control, Submit, Cancel and Error, and any help text the store places. Must be inside CartDestinationRoot.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationPostalCodeControl": {
+    "name": "CartDestinationPostalCodeControl",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Postal Code Control",
+      "category": "content"
+    },
+    "schema": {
+      "mask": {
+        "type": "string",
+        "label": "Mask pattern"
+      },
+      "label": {
+        "type": "string",
+        "label": "Label"
+      },
+      "placeholder": {
+        "type": "string",
+        "label": "Placeholder"
+      },
+      "invalidMessage": {
+        "type": "string",
+        "label": "Invalid-value message"
+      }
+    },
+    "guideline": "The postal code input of edit mode, empty each time edit mode opens and focused on open. The mask follows the cart country unless set. Must be inside CartDestinationForm.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationSubmit": {
+    "name": "CartDestinationSubmit",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "cart-destination-submit",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Submit",
+      "category": "action"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Button label"
+      },
+      "pendingLabel": {
+        "type": "string",
+        "label": "Pending label"
+      }
+    },
+    "guideline": "Writes the typed postal code. Disabled until it is complete for the country, valid and different from the current one, and while a write is pending (aria-busy). Must be inside CartDestinationForm.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationCancel": {
+    "name": "CartDestinationCancel",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "cart-destination-cancel",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Cancel",
+      "category": "action"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Button label"
+      }
+    },
+    "guideline": "Closes edit mode, discards what was typed and writes nothing. Disabled while a write is pending. Must be inside CartDestinationForm.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
+  "CartDestinationError": {
+    "name": "CartDestinationError",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "cart-destination-error",
+    "requiresContext": "cartDestination",
+    "editor": {
+      "label": "Cart Destination Error",
+      "category": "content"
+    },
+    "schema": {
+      "genericMessage": {
+        "type": "string",
+        "label": "Failure message"
+      }
+    },
+    "guideline": "Announces why the destination write failed, as an alert, and renders nothing otherwise. Author one message covering a refused postal code and a network failure: both reach the client as the same error. Must be inside CartDestinationForm.",
+    "docPath": "src/matter/cart-destination/cart-destination.md"
+  },
   "CartItemRoot": {
     "name": "CartItemRoot",
     "importPath": "@vtex/faststore/components",
-    "fragment": "\n  fragment CartItemRootData on Query {\n    cart {\n      items {\n        __typename\n        id\n        quantity\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n        sellingPrice {\n          amount\n          currencyCode\n        }\n        gift\n        ownTotal {\n          ...MoneyFragment\n        }\n        total {\n          ...MoneyFragment\n        }\n        variant {\n          __typename\n          variantId\n          sku\n          name\n          image {\n            url\n            altText\n          }\n          availability\n        }\n        product {\n          __typename\n          productId\n          title\n          detailUrl\n          categories {\n            categoryId\n            name\n          }\n          brand {\n            brandId\n            name\n          }\n        }\n      }\n    }\n  }\n\nfragment MoneyFragment on Money {\n  __typename\n  amount\n  currencyCode\n}",
+    "fragment": "\n  fragment CartItemRootData on Query {\n    cart {\n      items {\n        __typename\n        id\n        lineId\n        quantity\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n        sellingPrice {\n          amount\n          currencyCode\n        }\n        gift\n        ownTotal {\n          ...MoneyFragment\n        }\n        total {\n          ...MoneyFragment\n        }\n        variant {\n          __typename\n          variantId\n          sku\n          name\n          image {\n            url\n            altText\n          }\n          availability\n        }\n        product {\n          __typename\n          productId\n          title\n          detailUrl\n          categories {\n            categoryId\n            name\n          }\n          brand {\n            brandId\n            name\n          }\n        }\n      }\n    }\n  }\n\nfragment MoneyFragment on Money {\n  __typename\n  amount\n  currencyCode\n}",
     "fetchStrategy": "reactive-list-item",
     "requiresContext": "cart-item",
     "providesContext": "cart-item-data",
@@ -5128,7 +5728,7 @@
         "label": "Object Fit"
       }
     },
-    "guideline": "Renders the product image from the cart item. Must be inside CartItemRoot.",
+    "guideline": "Renders the product image from the cart item. When the line has no image, or the image fails to load, it renders a decorative placeholder span in the same slot (same className and style, hidden from assistive technology) carrying data-fs-cart-item-image-broken for a swatch to style. The placeholder keeps the inline-level display of the image (inline-block) so width and height apply, and adds no color, border or background. Must be inside CartItemRoot.",
     "docPath": "src/matter/cart-item/cart-item.md"
   },
   "CartItemProductLink": {
@@ -5140,7 +5740,7 @@
       "category": "commerce"
     },
     "schema": {},
-    "guideline": "Links the cart line image to its product page, using the product URL the line already carries: place it inside CartItemRoot wrapping CartItemImage. Whether a line links is decided by placing this element, so there is no prop to toggle it — a checkout line simply omits it. Renders its children unwrapped when the line has no image or no usable product URL, so it never leaves an empty or unsafe link. Navigation is same-tab, and the leaf adds no fields to the page query. Must be inside CartItemRoot. See cart-item.md.",
+    "guideline": "Links the cart line image to its product page, using the product URL the line already carries: place it inside CartItemRoot wrapping CartItemImage. Whether a line links is decided by placing this element, so there is no prop to toggle it — a checkout line simply omits it. Renders its children unwrapped when the line has no image or no usable product URL, so it never leaves an empty or unsafe link. The link names itself with an aria-label taken from the image alt text (or the variant name), so it stays named when the image shows the placeholder; an aria-label passed to the link wins. Navigation is same-tab, and the leaf adds no fields to the page query. Must be inside CartItemRoot. See cart-item.md.",
     "docPath": "src/matter/cart-item/cart-item.md"
   },
   "CartItemName": {
@@ -5323,13 +5923,19 @@
       "label": "Cart Item Remove",
       "category": "commerce"
     },
-    "schema": {},
+    "schema": {
+      "removedMessage": {
+        "type": "string",
+        "default": "Item removed",
+        "label": "Removed message"
+      }
+    },
     "actions": {
       "cart": [
         "removeItem"
       ]
     },
-    "guideline": "Button that removes the current line item from the cart. Must be inside CartItemRoot. Also composes inside CartItemUnavailable as a remove-on-alert control. See cart-item.md.",
+    "guideline": "Button that removes the current line item from the cart. Disabled while the removal is in flight; when the removal returns no errors it raises a toast titled removedMessage (needs a ToastProvider with a ToastList in the layout; with none, no toast shows and removal still works). Must be inside CartItemRoot. Also composes inside CartItemUnavailable as a remove-on-alert control. See cart-item.md.",
     "docPath": "src/matter/cart-item/cart-item.md"
   },
   "CartItemAvailable": {
@@ -6052,7 +6658,7 @@
   "FreeShippingProgressRoot": {
     "name": "FreeShippingProgressRoot",
     "importPath": "@vtex/faststore/components",
-    "fragment": "\n  fragment FreeShippingProgressData on Query {\n    cart {\n      id\n      total {\n        amount\n        currencyCode\n      }\n      freeShippingProgress {\n        threshold {\n          amount\n          currencyCode\n        }\n        remaining {\n          amount\n          currencyCode\n        }\n        qualified\n      }\n    }\n  }\n",
+    "fragment": "\n  fragment FreeShippingProgressData on Query {\n    cart {\n      id\n      totalizers {\n        id\n        value {\n          amount\n          currencyCode\n        }\n      }\n      freeShippingProgress {\n        threshold {\n          amount\n          currencyCode\n        }\n        remaining {\n          amount\n          currencyCode\n        }\n        qualified\n      }\n    }\n  }\n",
     "fetchStrategy": "reactive",
     "editor": {
       "label": "Free Shipping Progress",
@@ -8217,6 +8823,115 @@
     "guideline": "Data-owning root of a facet-sourced product shelf. Owns a products(first:, orderBy:, filter:) fragment whose variables bind to this element: the merchant fills them in the CMS (content model product-shelf) and the props of the same name are the defaults. Receives $data lazily. Compose as: ProductShelfRoot > (ProductShelfHeading + CarouselRoot > (ProductShelfItems + CarouselPrevious + CarouselNext + CarouselBullets)). Compose ProductShelfHeading with the title as its children to render a heading; set the source with categoryId / brandId / collectionId / searchTerm and tune first, sort, availableOnly. Renders a skeleton while loading and nothing when the result is empty. Bind itemsPerPage to the CarouselRoot so paging matches the shelf config. See product-shelf.md.",
     "docPath": "src/matter/product-shelf/product-shelf.md"
   },
+  "ProductShelfOnMountRoot": {
+    "name": "ProductShelfOnMountRoot",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment ProductShelfData on Query {\n    products(\n      first: $first\n      orderBy: $orderBy\n      filter: {\n        categoryIds: $categoryId\n        brandIds: $brandId\n        collectionId: $collectionId\n        searchTerm: $searchTerm\n        availableOnly: $availableOnly\n      }\n    ) {\n      edges {\n        node {\n          id\n          title\n          slug\n          routeSlug\n          images(first: 1) {\n            edges {\n              node {\n                url\n                altText\n              }\n            }\n          }\n          variants(first: 1) {\n            edges {\n              node {\n                availableForSale\n                quantityAvailable\n                price {\n                  amount\n                  currencyCode\n                }\n                compareAtPrice {\n                  amount\n                  currencyCode\n                }\n                sellers {\n                  isDefault\n                  offer {\n                    price {\n                      amount\n                      currencyCode\n                    }\n                    listPrice {\n                      amount\n                      currencyCode\n                    }\n                    spotPrice {\n                      amount\n                      currencyCode\n                    }\n                    tax {\n                      amount\n                      currencyCode\n                    }\n                    taxPercentage\n                    availableQuantity\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n      totalCount\n    }\n  }\n",
+    "fetchStrategy": "lazy-on-mount",
+    "variables": {
+      "orderBy": {
+        "from": "sort",
+        "values": {
+          "relevance": {
+            "field": "RELEVANCE",
+            "direction": "DESC"
+          },
+          "price_asc": {
+            "field": "PRICE",
+            "direction": "ASC"
+          },
+          "price_desc": {
+            "field": "PRICE",
+            "direction": "DESC"
+          },
+          "name_asc": {
+            "field": "TITLE",
+            "direction": "ASC"
+          },
+          "name_desc": {
+            "field": "TITLE",
+            "direction": "DESC"
+          },
+          "release": {
+            "field": "RELEASE_DATE",
+            "direction": "DESC"
+          },
+          "orders": {
+            "field": "BEST_SELLING",
+            "direction": "DESC"
+          },
+          "discount": {
+            "field": "RELEVANCE",
+            "direction": "DESC"
+          }
+        }
+      }
+    },
+    "editor": {
+      "label": "Product Shelf Root (on mount)",
+      "category": "commerce"
+    },
+    "providesContext": "product-shelf",
+    "schema": {
+      "itemsPerPage": {
+        "type": "number",
+        "default": 5,
+        "label": "Items Per Page"
+      },
+      "usePriceWithTaxes": {
+        "type": "boolean",
+        "default": false,
+        "label": "Use Price With Taxes"
+      },
+      "taxesLabel": {
+        "type": "string",
+        "default": "Tax included",
+        "label": "Taxes Label"
+      },
+      "first": {
+        "type": "number",
+        "default": 5,
+        "label": "Number of Products"
+      },
+      "sort": {
+        "type": [
+          "relevance",
+          "price_asc",
+          "price_desc",
+          "name_asc",
+          "name_desc",
+          "release",
+          "orders",
+          "discount"
+        ],
+        "default": "relevance",
+        "label": "Sort"
+      },
+      "searchTerm": {
+        "type": "string",
+        "label": "Search Term"
+      },
+      "categoryId": {
+        "type": "string",
+        "label": "Category ID"
+      },
+      "brandId": {
+        "type": "string",
+        "label": "Brand ID"
+      },
+      "collectionId": {
+        "type": "string",
+        "label": "Collection ID"
+      },
+      "availableOnly": {
+        "type": "boolean",
+        "default": false,
+        "label": "Available Only"
+      }
+    },
+    "guideline": "ProductShelfRoot variant that fetches its products on the client when it mounts, in its own request: the products never enter the page query and are absent from the server HTML. Renders nothing while loading, when the request fails and when the result is empty (no skeleton). Meant for a conditional branch such as CartEmpty, never above the fold. Configured by props only (first, sort, availableOnly, categoryId, brandId, collectionId, searchTerm, itemsPerPage). Compose as: ProductShelfOnMountRoot > (ProductShelfHeading + CarouselRoot > (ProductShelfItems + CarouselPrevious + CarouselNext)). See product-shelf.md.",
+    "docPath": "src/matter/product-shelf/product-shelf.md"
+  },
   "ProductShelfItems": {
     "name": "ProductShelfItems",
     "importPath": "@vtex/faststore/components",