@vtex/faststore 0.0.8 → 0.0.11

package/dist/matter/cart/cart.js

@@ -2,23 +2,29 @@
 import { defineComponent } from "../../core/dist/define-component.js";
 import { defineContentType } from "../../core/dist/define-content-type.js";
 import "../../core/dist/index.js";
+import { resolveSafeHref } from "../../utils/safe-href.js";
 import { useStorefrontContext } from "../../sdk/context/storefront-context.js";
+import { useMessageFormatter } from "../../sdk/i18n/use-message-formatter.js";
 import { useStorefrontNavigation } from "../../sdk/navigation/use-storefront-navigation.js";
 import { graphql } from "../../sdk/generated/gql.js";
 import { useActionsOverride } from "../../sdk/actions/actions-override-context.js";
+import { formatErrorCode } from "../../sdk/i18n/format-error-code.js";
 import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { loggableErrorName } from "../../utils/loggable-error-name.js";
+import { ReactiveRootContext } from "../../sdk/data/page-reactive-data-root.js";
 import { NavigationLink } from "../../particles/navigation-link/navigation-link.js";
 import { ListItemRefContext } from "../../sdk/data/list-item-ref-context.js";
-import { ReactiveRootContext } from "../../sdk/data/page-reactive-data-root.js";
+import { useOptionalToast } from "../../particles/toast/toast.js";
 import { Icon } from "../../particles/icon/icon.js";
 import { DrawerClose } from "../../particles/drawer/drawer.js";
 import { Image } from "../../particles/image/image.js";
 import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../../sdk/state/cart.js";
 import { awaitCartWrites } from "../../sdk/cart/write-gate.js";
 import { readCartFromCache } from "../../sdk/cart/use-cart-actions.js";
+import { useCartSyncSalesChannel } from "../../sdk/cart/use-cart-sync-sales-channel.js";
 import { useCartValidateOnOpen } from "../../sdk/cart/use-cart-validate-on-open.js";
-import { useApolloClient, useReactiveVar } from "@apollo/client/react";
-import { cloneElement, createContext, isValidElement, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { getApolloContext, useApolloClient, useReactiveVar } from "@apollo/client/react";
+import { cloneElement, createContext, isValidElement, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useLinkStatus } from "next/link";
 //#region src/matter/cart/cart.tsx
@@ -40,18 +46,246 @@ const CartDisclaimerContent = defineContentType({
 const CartCheckoutLabelContent = defineContentType({
 	id: "cart-checkout-label",
 	title: "Cart Checkout Label",
-	description: "Editorial label for the checkout call to action.",
+	description: "Label for the checkout call to action.",
 	schema: {
 		type: "object",
 		additionalProperties: false,
-		required: ["label"],
 		properties: { label: {
 			type: "string",
 			minLength: 1,
-			title: "Checkout label"
+			title: "Checkout label",
+			format: "icu-message",
+			messageSource: "Checkout"
+		} }
+	}
+});
+const CartCountContent = defineContentType({
+	id: "cart-count",
+	title: "Cart Count",
+	description: "Text of the cart item count.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { template: {
+			type: "string",
+			title: "Item count",
+			format: "icu-message",
+			messageSource: "{count}",
+			messageArguments: {
+				type: "object",
+				properties: { count: { type: "integer" } }
+			},
+			messageExample: { count: 3 }
 		} }
 	}
 });
+const CartCouponFormContent = defineContentType({
+	id: "cart-coupon-form",
+	title: "Cart Coupon Form",
+	description: "Copy for the coupon code input, its apply button and the applied toast.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			placeholder: {
+				type: "string",
+				title: "Input placeholder",
+				description: "Also the accessible name of the input.",
+				format: "icu-message",
+				messageSource: "Coupon code"
+			},
+			applyLabel: {
+				type: "string",
+				title: "Apply button label",
+				format: "icu-message",
+				messageSource: "Apply"
+			},
+			appliedMessage: {
+				type: "string",
+				title: "Applied toast title",
+				description: "Raised after an apply whose code comes back matched; blank raises no toast.",
+				format: "icu-message",
+				messageSource: "Coupon applied"
+			}
+		}
+	}
+});
+const CartAppliedCouponsContent = defineContentType({
+	id: "cart-applied-coupons",
+	title: "Cart Applied Coupons",
+	description: "Copy for the built-in remove control of each applied coupon chip.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { removeLabel: {
+			type: "string",
+			title: "Remove control accessible label",
+			format: "icu-message",
+			messageSource: "Remove coupon {code}",
+			messageArguments: {
+				type: "object",
+				properties: { code: { type: "string" } }
+			},
+			messageExample: { code: "SAVE10" }
+		} }
+	}
+});
+const CartCouponUnmatchedContent = defineContentType({
+	id: "cart-coupon-unmatched",
+	title: "Cart Coupon Unmatched",
+	description: "Notice shown on an applied coupon whose conditions do not match the cart.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { message: {
+			type: "string",
+			title: "Notice",
+			format: "icu-message",
+			messageSource: "This coupon is not being applied to your cart"
+		} }
+	}
+});
+const CartCouponSavingsContent = defineContentType({
+	id: "cart-coupon-savings",
+	title: "Cart Coupon Savings",
+	description: "Text of the amount an applied coupon saves.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { template: {
+			type: "string",
+			title: "Savings text",
+			description: "`amount` is the formatted saving.",
+			format: "icu-message",
+			messageSource: "{amount}",
+			messageArguments: {
+				type: "object",
+				properties: { amount: { type: "string" } }
+			},
+			messageExample: { amount: "-$10.00" }
+		} }
+	}
+});
+const CartUnavailableCountContent = defineContentType({
+	id: "cart-unavailable-count",
+	title: "Cart Unavailable Count",
+	description: "Summary of how many cart lines are unavailable.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { template: {
+			type: "string",
+			title: "Unavailable count",
+			format: "icu-message",
+			messageSource: "{count, plural, one {# item unavailable} other {# items unavailable}}",
+			messageArguments: {
+				type: "object",
+				properties: { count: { type: "integer" } }
+			},
+			messageExample: { count: 2 }
+		} }
+	}
+});
+const CartRemoveUnavailableContent = defineContentType({
+	id: "cart-remove-unavailable",
+	title: "Cart Remove Unavailable",
+	description: "Label for the button that removes every unavailable cart line.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { label: {
+			type: "string",
+			title: "Button label",
+			format: "icu-message",
+			messageSource: "Remove unavailable items"
+		} }
+	}
+});
+const ClearCartButtonContent = defineContentType({
+	id: "clear-cart-button",
+	title: "Clear Cart Button",
+	description: "Label for the button that removes every cart line.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { label: {
+			type: "string",
+			title: "Button label",
+			format: "icu-message",
+			messageSource: "Clear cart"
+		} }
+	}
+});
+const CartErrorContent = defineContentType({
+	id: "cart-error",
+	title: "Cart Error",
+	description: "Messages shown when a cart item write is refused, one per error code the shopper can act on.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			invalidQuantityMessage: {
+				type: "string",
+				title: "Invalid quantity message",
+				description: "Shown when the requested quantity is not accepted.",
+				format: "icu-message",
+				messageSource: "Choose a valid quantity."
+			},
+			itemNotFoundMessage: {
+				type: "string",
+				title: "Item not found message",
+				description: "Shown when the item is no longer in the cart.",
+				format: "icu-message",
+				messageSource: "This item is no longer in your cart."
+			},
+			genericErrorMessage: {
+				type: "string",
+				title: "Generic failure message",
+				description: "Shown for a network failure and for every refusal the shopper cannot act on.",
+				format: "icu-message",
+				messageSource: "Unable to update cart. Please try again."
+			}
+		}
+	}
+});
+const CartCouponErrorContent = defineContentType({
+	id: "cart-coupon-error",
+	title: "Cart Coupon Error",
+	description: "Messages shown when a coupon apply or remove is refused, one per error code the shopper can act on.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			couponNotFoundMessage: {
+				type: "string",
+				title: "Coupon not found message",
+				description: "Shown when the code is unknown or not accepted by this cart.",
+				format: "icu-message",
+				messageSource: "This coupon is not valid for your cart."
+			},
+			couponExpiredMessage: {
+				type: "string",
+				title: "Coupon expired message",
+				format: "icu-message",
+				messageSource: "This coupon has expired."
+			},
+			couponNotCombinedMessage: {
+				type: "string",
+				title: "Coupon not combined message",
+				description: "Shown when the code is refused while another coupon is applied. The platform does not say whether the code is unknown or cannot be combined.",
+				format: "icu-message",
+				messageSource: "This coupon cannot be used with the coupons already applied."
+			},
+			genericErrorMessage: {
+				type: "string",
+				title: "Generic failure message",
+				description: "Shown for a network failure and for every refusal the shopper cannot act on.",
+				format: "icu-message",
+				messageSource: "Unable to update your coupons. Please try again."
+			}
+		}
+	}
+});
 const fragment = graphql(`
   fragment CartData on Query {
     cart {
@@ -88,6 +322,17 @@ const fragment = graphql(`
         code
         isUnmatchedCondition
       }
+      discounts {
+        name
+        value {
+          ...MoneyFragment
+        }
+        kind
+      }
+      salesChannelMismatch {
+        cartSalesChannel
+        activeSalesChannel
+      }
     }
   }
 `);
@@ -97,6 +342,17 @@ function formatPrice(value, locale, currency) {
 		currency
 	}).format(value);
 }
+/**
+* True when a money amount can be read as a number: a finite `number` (the optimistic-cache shape) or
+* a non-blank string `Number` parses to a finite value (the wire shape, a decimal string). Blank and
+* nullish amounts are rejected before `Number()` runs, because `Number('')` and `Number(null)` are `0`
+* and would turn a missing amount into a real zero.
+*/
+function isFiniteAmount(value) {
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value === "string") return value.trim() !== "" && Number.isFinite(Number(value));
+	return false;
+}
 const CartTotalValueContext = createContext(null);
 const CART_DATA_UNSET = Symbol("CartDataContextUnset");
 const CartDataContextInternal = createContext(CART_DATA_UNSET);
@@ -126,7 +382,8 @@ const CartRootDefinition = defineComponent({
 		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."
 });
 const CartListDefinition = defineComponent({
 	name: "CartList",
@@ -144,6 +401,34 @@ const CartListDefinition = defineComponent({
 	providesContext: "cart-item",
 	guideline: "Renders its children once per cart item; wrap the line-item template in a CartItemRoot and place CartItem* components inside it to define the template (e.g. CartItemImage, CartItemName, CartItemPrice, a CartItemQuantity stepper, CartItemRemove). While the cart is loading it renders skeletonCount CartItemSkeleton placeholders instead. In a mini-cart it is the scrollable body of the DrawerPopup. Must be inside CartRoot."
 });
+const CartAvailableItemsDefinition = defineComponent({
+	name: "CartAvailableItems",
+	importPath: "@vtex/faststore/components",
+	component: CartAvailableItems,
+	editor: {
+		label: "Cart Available Items",
+		category: "commerce"
+	},
+	schema: { skeletonCount: {
+		type: "number",
+		default: 3,
+		label: "Skeleton Count"
+	} },
+	providesContext: "cart-item",
+	guideline: "Renders its children once per purchasable cart line (availability AVAILABLE); wrap the line-item template in a CartItemRoot. Place it under CartFilled in the place of CartList, together with CartUnavailableSection for the lines the shopper cannot buy; do not compose CartList beside it. Gift lines follow their availability. Renders skeletonCount skeletons while the cart is loading and nothing when no line is purchasable. Must be inside CartRoot. See cart.md."
+});
+const CartUnavailableItemsDefinition = defineComponent({
+	name: "CartUnavailableItems",
+	importPath: "@vtex/faststore/components",
+	component: CartUnavailableItems,
+	editor: {
+		label: "Cart Unavailable Items",
+		category: "commerce"
+	},
+	schema: {},
+	providesContext: "cart-item",
+	guideline: "Renders its children once per unavailable cart line (any availability other than AVAILABLE); wrap the line-item template in a CartItemRoot and compose the line leaves (for example CartItemImage, CartItemName, CartItemVariations, CartItemRemove), adding CartItemUnavailable only when the line itself must state its reason. Renders nothing when no line is unavailable or while the cart is loading. Place it inside CartUnavailableSection after its header. Gift lines follow their availability and show no per-line remove. Must be inside CartRoot. See cart.md."
+});
 const CartTotalDefinition = defineComponent({
 	name: "CartTotal",
 	importPath: "@vtex/faststore/components",
@@ -162,27 +447,25 @@ const CartCountDefinition = defineComponent({
 	name: "CartCount",
 	importPath: "@vtex/faststore/components",
 	component: CartCount,
+	content: CartCountContent,
 	editor: {
 		label: "Cart Count",
 		category: "commerce"
 	},
-	schema: { template: {
-		type: "string",
-		default: "{count}",
-		label: "Template"
-	} },
-	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."
+	schema: {},
+	guideline: "Renders the total item count in the cart; the text comes from the $content field template, an ICU message with a count argument (e.g. '{count, plural, =1 {# produto} other {# produtos}}'). 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."
 });
 const CartErrorDefinition = defineComponent({
 	name: "CartError",
 	importPath: "@vtex/faststore/components",
 	component: CartError,
+	content: CartErrorContent,
 	editor: {
 		label: "Cart Error",
 		category: "commerce"
 	},
 	schema: {},
-	guideline: "Inline error banner that surfaces cart mutation errors. Must be inside CartRoot."
+	guideline: "Inline error banner that surfaces cart item write errors; renders nothing when there are none. Words each error code from its $content (genericErrorMessage for a network failure, every refusal the shopper cannot act on, and an unknown code). Authored children replace the message. Must be inside CartRoot."
 });
 const CartGoCheckoutDefinition = defineComponent({
 	name: "CartGoCheckout",
@@ -193,53 +476,39 @@ const CartGoCheckoutDefinition = defineComponent({
 		label: "Cart Go Checkout",
 		category: "commerce"
 	},
-	schema: {
-		href: {
-			type: "link",
-			default: { standard: "checkout" },
-			label: "Checkout URL"
-		},
-		label: {
-			type: "string",
-			default: "Checkout",
-			label: "Checkout label"
-		}
-	},
+	schema: { href: {
+		type: "link",
+		default: { standard: "checkout" },
+		label: "Checkout URL"
+	} },
 	actions: { cart: ["validate"] },
-	guideline: "Navigation link to the checkout page (default href the checkout page); use as the checkout CTA inside the cart summary. In a mini-cart it is the DrawerPopup footer CTA, next to CartTotal. The button wording is merchant-editable content: a CMS entry wins, then the label prop (default \"Checkout\"), then children — so a store that labels the button through children keeps working and a CMS save overrides it without a deploy. The destination is not content-editable: href stays an authored prop, because re-pointing checkout is not a copy decision. Before routing it runs a stock validation and only navigates when the re-checked cart has no unavailable line; a validation that cannot run falls open and navigates anyway. During a client-side route transition to checkout it surfaces a loading state on its content wrapper as aria-busy plus data-fs-cart-go-checkout-pending, and while the pre-checkout validation runs it exposes data-fs-cart-go-checkout-validating — there is no built-in spinner, so opt into one by styling those attributes (e.g. composing a Spinner). For an external or hard checkout navigation there is no client-side transition, so the loading state simply does not show (a graceful no-op). The enriched footer checkout CTA is CartCheckoutGuard wrapping CartTotal and this CartGoCheckout: the guard makes the CTA inert (data-fs-cart-checkout-blocked) while any item is unavailable, and CartTotal shows the grand total at the button. Must be inside CartRoot."
+	guideline: "Navigation link to the checkout page (default href the checkout page); use as the checkout CTA inside the cart summary. In a mini-cart it is the DrawerPopup footer CTA, next to CartTotal. Composed children are the button content; without them the text comes from the $content field label. The destination is not content-editable: href stays an authored prop, because re-pointing checkout is not a copy decision. Before routing it runs a stock validation and only navigates when the re-checked cart has no unavailable line; a validation that cannot run falls open and navigates anyway. When it leaves for the checkout it closes the mini-cart drawer it sits in, so do not wrap it in DrawerClose. During a client-side route transition to checkout it surfaces a loading state on its content wrapper as aria-busy plus data-fs-cart-go-checkout-pending, and while the pre-checkout validation runs it exposes data-fs-cart-go-checkout-validating — there is no built-in spinner, so opt into one by styling those attributes (e.g. composing a Spinner). For an external or hard checkout navigation there is no client-side transition, so the loading state simply does not show (a graceful no-op). The enriched footer checkout CTA is CartCheckoutGuard wrapping CartTotal and this CartGoCheckout: the guard makes the CTA inert (data-fs-cart-checkout-blocked) while any item is unavailable, and CartTotal shows the grand total at the button. Must be inside CartRoot."
 });
 const CartCouponFormDefinition = defineComponent({
 	name: "CartCouponForm",
 	importPath: "@vtex/faststore/components",
 	component: CartCouponForm,
+	content: CartCouponFormContent,
 	editor: {
 		label: "Cart Coupon Form",
 		category: "commerce"
 	},
-	schema: {
-		placeholder: {
-			type: "string",
-			label: "Placeholder"
-		},
-		applyLabel: {
-			type: "string",
-			label: "Apply Label"
-		}
-	},
+	schema: {},
 	actions: { cart: ["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 by the $content field 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."
 });
 const CartAppliedCouponsDefinition = defineComponent({
 	name: "CartAppliedCoupons",
 	importPath: "@vtex/faststore/components",
 	component: CartAppliedCoupons,
+	content: CartAppliedCouponsContent,
 	editor: {
 		label: "Cart Applied Coupons",
 		category: "commerce"
 	},
 	schema: {},
 	actions: { cart: ["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 (named by the $content field removeLabel); 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."
 });
 const CartCouponRemoveDefinition = defineComponent({
 	name: "CartCouponRemove",
@@ -260,20 +529,64 @@ const CartCouponErrorDefinition = defineComponent({
 	name: "CartCouponError",
 	importPath: "@vtex/faststore/components",
 	component: CartCouponError,
+	content: CartCouponErrorContent,
 	editor: {
 		label: "Cart Coupon Error",
 		category: "commerce"
 	},
 	schema: {},
-	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."
+	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. Words each error code from its $content (genericErrorMessage for a network failure, every refusal the shopper cannot act on, and an unknown code). Authored children replace the message. Must be inside CartRoot."
+});
+const CartCouponEmptyDefinition = defineComponent({
+	name: "CartCouponEmpty",
+	importPath: "@vtex/faststore/components",
+	component: CartCouponEmpty,
+	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."
+});
+const CartCouponUnmatchedDefinition = defineComponent({
+	name: "CartCouponUnmatched",
+	importPath: "@vtex/faststore/components",
+	component: CartCouponUnmatched,
+	content: CartCouponUnmatchedContent,
+	editor: {
+		label: "Cart Coupon Unmatched",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Per-chip notice for an applied coupon that grants nothing: renders the $content field message 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."
 });
-function CartRoot({ $data: $dataProp, className, children, ...props }) {
-	const cart = useDataOverride($dataProp) ?? null;
+const CartCouponSavingsDefinition = defineComponent({
+	name: "CartCouponSavings",
+	importPath: "@vtex/faststore/components",
+	component: CartCouponSavings,
+	content: CartCouponSavingsContent,
+	editor: {
+		label: "Cart Coupon Savings",
+		category: "commerce"
+	},
+	schema: {},
+	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. The chip text is the $content field template, an ICU message whose {amount} argument is the formatted saving, e.g. '{amount}' or 'Economia de {amount}'. The chip already shows the code before its children. 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."
+});
+const useIsomorphicLayoutEffect = globalThis.window === void 0 ? useEffect : useLayoutEffect;
+function CartRoot({ $data: $dataProp, $actions: $actionsProp, className, children, ...props }) {
+	const $data = useDataOverride($dataProp);
+	const $actions = useActionsOverride($actionsProp);
+	const cart = $data ?? null;
+	useCartSyncSalesChannel($actions?.cart?.syncSalesChannel, cart?.id ?? null, cart?.salesChannelMismatch);
 	const { error: rootError } = useContext(ReactiveRootContext);
 	const cartEntityId = cart?.id ?? null;
 	useEffect(() => {
 		if (cartEntityId) orderFormIdVar(cartEntityId);
 	}, [cartEntityId]);
+	useIsomorphicLayoutEffect(() => {
+		cartUserErrorsVar([]);
+		cartCouponErrorsVar([]);
+	}, []);
 	const dataValue = useMemo(() => ({
 		cart,
 		error: rootError ?? null
@@ -315,10 +628,56 @@ function CartList({ className, children, skeletonCount = 3, ...props }) {
 		}, item.id))
 	});
 }
+function CartLines({ items, className, children, attribute, rest }) {
+	return /* @__PURE__ */ jsx("div", {
+		...rest,
+		className,
+		...attribute,
+		children: items.map((item) => /* @__PURE__ */ jsx(ListItemRefContext, {
+			value: {
+				__typename: "CartItem",
+				id: item.id,
+				fallbackData: item
+			},
+			children
+		}, item.id))
+	});
+}
+function CartAvailableItems({ className, children, skeletonCount = 3, ...props }) {
+	const { cart } = useCart();
+	const { loading } = useContext(ReactiveRootContext);
+	if (loading && cart == null) return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-available-items": "",
+		children: Array.from({ length: skeletonCount }, (_, i) => /* @__PURE__ */ jsx(CartItemSkeleton, {}, i))
+	});
+	const items = (cart?.items ?? []).filter((item) => !isUnavailable(item));
+	if (items.length === 0) return null;
+	return /* @__PURE__ */ jsx(CartLines, {
+		items,
+		className,
+		attribute: { "data-fs-cart-available-items": "" },
+		rest: props,
+		children
+	});
+}
+function CartUnavailableItems({ className, children, ...props }) {
+	const { cart } = useCart();
+	const items = (cart?.items ?? []).filter(isUnavailable);
+	if (items.length === 0) return null;
+	return /* @__PURE__ */ jsx(CartLines, {
+		items,
+		className,
+		attribute: { "data-fs-cart-unavailable-items": "" },
+		rest: props,
+		children
+	});
+}
 function CartTotal({ label, className, children, ...props }) {
 	const total = useContext(CartTotalValueContext);
 	const { locale, currency } = useStorefrontContext();
-	const value = children ?? formatPrice(total?.amount ?? 0, locale, currency);
+	const value = children ?? formatPrice(Number(total?.amount ?? 0), locale, currency);
 	return /* @__PURE__ */ jsx("span", {
 		...props,
 		className,
@@ -327,19 +686,51 @@ function CartTotal({ label, className, children, ...props }) {
 		children: label == null ? value : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", { children: label }), /* @__PURE__ */ jsx("span", { children: value })] })
 	});
 }
-function CartCount({ className, children, template = "{count}", ...props }) {
+function addToCount(sum, item) {
+	if (item.gift) return sum;
+	return Number.isFinite(item.quantity) ? sum + item.quantity : NaN;
+}
+function CartCount({ className, children, $content, $locale, ...props }) {
 	const { cart } = useCart();
-	const count = cart?.items.reduce((sum, item) => item.gift ? sum : sum + item.quantity, 0) ?? 0;
+	const { format } = useMessageFormatter(CartCountContent, $content);
+	const count = cart?.items.reduce(addToCount, 0) ?? 0;
+	if (!Number.isFinite(count)) return null;
 	return /* @__PURE__ */ jsx("span", {
 		...props,
 		className,
 		"data-fs-cart-count": "",
 		"data-fs-text": "",
-		children: children ?? template.replace("{count}", String(count))
+		children: children ?? format("template", { count })
 	});
 }
-function CartError({ className, children, ...props }) {
-	const [firstError] = useReactiveVar(cartUserErrorsVar);
+/**
+* The message for each code an item write can publish: the five item mutations' codes plus the
+* client-minted transport failure. A code this map does not know (a newer server) shows genericErrorMessage.
+*/
+const CART_ERROR_FIELDS = {
+	INVALID_QUANTITY: "invalidQuantityMessage",
+	ITEM_NOT_FOUND: "itemNotFoundMessage",
+	MISSING_CART_CONTEXT: "genericErrorMessage",
+	CART_NOT_FOUND: "genericErrorMessage",
+	INVALID_VARIANT_ID: "genericErrorMessage",
+	INVALID_SELLER_ID: "genericErrorMessage",
+	NO_LINE_IDS_PROVIDED: "genericErrorMessage",
+	UPSTREAM_ERROR: "genericErrorMessage",
+	NETWORK_ERROR: "genericErrorMessage"
+};
+/** The message for each code a coupon write can publish, plus the client-minted transport failure. */
+const CART_COUPON_ERROR_FIELDS = {
+	COUPON_NOT_FOUND: "couponNotFoundMessage",
+	COUPON_EXPIRED: "couponExpiredMessage",
+	COUPON_NOT_COMBINED: "couponNotCombinedMessage",
+	MISSING_CART_CONTEXT: "genericErrorMessage",
+	CART_NOT_FOUND: "genericErrorMessage",
+	NETWORK_ERROR: "genericErrorMessage"
+};
+function CartError({ $content, $locale, className, children, ...props }) {
+	const userErrors = useReactiveVar(cartUserErrorsVar);
+	const { format } = useMessageFormatter(CartErrorContent, $content);
+	const [firstError] = userErrors;
 	if (!firstError) return null;
 	return /* @__PURE__ */ jsx("div", {
 		...props,
@@ -347,7 +738,7 @@ function CartError({ className, children, ...props }) {
 		className,
 		"data-fs-cart-error": "",
 		"data-fs-text": "",
-		children: children ?? firstError.message
+		children: children ?? formatErrorCode(CartErrorContent, CART_ERROR_FIELDS, firstError, format, "genericErrorMessage")
 	});
 }
 function CartGoCheckoutPending({ children }) {
@@ -364,19 +755,29 @@ function configuredLabel(value) {
 }
 /** The default destination of both checkout navigations. Module-level, so an effect keyed on it is stable. */
 const CHECKOUT_PAGE = { standard: "checkout" };
-function CartGoCheckout({ href = CHECKOUT_PAGE, label, className, children, onClick, $content, $actions: $actionsProp, ...props }) {
+function isPlainLeftClick(e) {
+	return !e.defaultPrevented && e.button === 0 && !e.metaKey && !e.ctrlKey && !e.shiftKey && !e.altKey;
+}
+function CartGoCheckout({ href = CHECKOUT_PAGE, className, children, onClick, $content, $locale, $actions: $actionsProp, ...props }) {
 	const $actions = useActionsOverride($actionsProp);
+	const { format } = useMessageFormatter(CartCheckoutLabelContent, $content);
 	const client = useApolloClient();
 	const { push } = useStorefrontNavigation();
 	const [validating, setValidating] = useState(false);
 	const inFlight = useRef(false);
-	const resolvedChildren = typeof children === "string" ? configuredLabel(children) : children;
-	const resolvedLabel = configuredLabel($content?.label) ?? configuredLabel(label) ?? resolvedChildren ?? "Checkout";
+	const resolvedLabel = (typeof children === "string" ? configuredLabel(children) : children) ?? format("label");
+	function leave() {
+		miniCartOpenVar(false);
+		push(href);
+	}
 	async function handleClick(e) {
 		onClick?.(e);
+		if (!isPlainLeftClick(e)) return;
 		const validate = $actions?.cart?.validate;
-		if (!validate) return;
-		if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+		if (!validate) {
+			miniCartOpenVar(false);
+			return;
+		}
 		e.preventDefault();
 		if (inFlight.current) return;
 		inFlight.current = true;
@@ -384,10 +785,10 @@ function CartGoCheckout({ href = CHECKOUT_PAGE, label, className, children, onCl
 		try {
 			await awaitCartWrites();
 			if ((await validate()).length > 0) {
-				push(href);
+				leave();
 				return;
 			}
-			if (!(readCartFromCache(client)?.items ?? []).some((item) => item.variant.availability !== "AVAILABLE")) push(href);
+			if (!(readCartFromCache(client)?.items ?? []).some((item) => item.variant.availability !== "AVAILABLE")) leave();
 		} finally {
 			inFlight.current = false;
 			setValidating(false);
@@ -403,8 +804,11 @@ function CartGoCheckout({ href = CHECKOUT_PAGE, label, className, children, onCl
 		children: /* @__PURE__ */ jsx(CartGoCheckoutPending, { children: resolvedLabel })
 	});
 }
-function CartCouponForm({ placeholder = "Coupon code", applyLabel = "Apply", className, children, onSubmit, $actions: $actionsProp, ...props }) {
+function CartCouponForm({ className, children, onSubmit, $content, $locale, $actions: $actionsProp, ...props }) {
 	const $actions = useActionsOverride($actionsProp);
+	const { format } = useMessageFormatter(CartCouponFormContent, $content);
+	const toast = useOptionalToast();
+	const { client } = useContext(getApolloContext());
 	const [code, setCode] = useState("");
 	const [pending, setPending] = useState(false);
 	async function handleSubmit(e) {
@@ -416,10 +820,19 @@ function CartCouponForm({ placeholder = "Coupon code", applyLabel = "Apply", cla
 		try {
 			const errors = await $actions?.cart?.applyCoupon?.({ code: trimmed });
 			if (!errors || errors.length === 0) setCode("");
+			if (errors?.length === 0 && client && toast) {
+				const submitted = trimmed.toLowerCase();
+				const title = (readCartFromCache(client)?.appliedCoupons ?? []).some((coupon) => coupon.code.trim().toLowerCase() === submitted && coupon.isUnmatchedCondition === false) ? format("appliedMessage") : "";
+				if (title) toast.add({
+					title,
+					type: "success"
+				});
+			}
 		} finally {
 			setPending(false);
 		}
 	}
+	const placeholder = children == null ? format("placeholder") : void 0;
 	return /* @__PURE__ */ jsx("form", {
 		...props,
 		className,
@@ -439,12 +852,13 @@ function CartCouponForm({ placeholder = "Coupon code", applyLabel = "Apply", cla
 			disabled: pending,
 			"data-fs-cart-coupon-apply": "",
 			"data-fs-button": "",
-			children: applyLabel
+			children: format("applyLabel")
 		})] })
 	});
 }
-function CartAppliedCoupons({ className, children, $actions: $actionsProp, ...props }) {
+function CartAppliedCoupons({ className, children, $content, $locale, $actions: $actionsProp, ...props }) {
 	const $actions = useActionsOverride($actionsProp);
+	const { format } = useMessageFormatter(CartAppliedCouponsContent, $content);
 	const { cart } = useCart();
 	const coupons = cart?.appliedCoupons ?? [];
 	if (coupons.length === 0) return null;
@@ -456,12 +870,13 @@ function CartAppliedCoupons({ className, children, $actions: $actionsProp, ...pr
 			value: coupon,
 			children: /* @__PURE__ */ jsx(CartCouponChip, {
 				$actions,
+				removeLabel: children == null ? format("removeLabel", { code: coupon.code }) : void 0,
 				children
 			})
 		}, coupon.code))
 	});
 }
-function CartCouponChip({ children, $actions }) {
+function CartCouponChip({ children, removeLabel, $actions }) {
 	const coupon = useContext(CartCouponContext);
 	if (!coupon) return null;
 	return /* @__PURE__ */ jsxs("span", {
@@ -473,7 +888,7 @@ function CartCouponChip({ children, $actions }) {
 			children: coupon.code
 		}), children ?? /* @__PURE__ */ jsx(CartCouponRemove, {
 			$actions,
-			"aria-label": `Remove coupon ${coupon.code}`,
+			"aria-label": removeLabel,
 			children: "×"
 		})]
 	});
@@ -496,8 +911,10 @@ function CartCouponRemove({ code, className, children, onClick, $actions: $actio
 		children
 	});
 }
-function CartCouponError({ className, children, ...props }) {
-	const [firstError] = useReactiveVar(cartCouponErrorsVar);
+function CartCouponError({ $content, $locale, className, children, ...props }) {
+	const couponErrors = useReactiveVar(cartCouponErrorsVar);
+	const { format } = useMessageFormatter(CartCouponErrorContent, $content);
+	const [firstError] = couponErrors;
 	if (!firstError) return null;
 	return /* @__PURE__ */ jsx("div", {
 		...props,
@@ -505,7 +922,47 @@ function CartCouponError({ className, children, ...props }) {
 		className,
 		"data-fs-cart-coupon-error": "",
 		"data-fs-text": "",
-		children: children ?? firstError.message
+		children: children ?? formatErrorCode(CartCouponErrorContent, CART_COUPON_ERROR_FIELDS, firstError, format, "genericErrorMessage")
+	});
+}
+function CartCouponEmpty({ className, children, ...props }) {
+	const { cart } = useCart();
+	if (cart == null || (cart.appliedCoupons ?? []).length > 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-coupon-empty": "",
+		children
+	});
+}
+function CartCouponUnmatched({ className, children, $content, $locale, ...props }) {
+	const coupon = useContext(CartCouponContext);
+	const { format } = useMessageFormatter(CartCouponUnmatchedContent, $content);
+	if (coupon?.isUnmatchedCondition !== true) return null;
+	const notice = children ?? format("message");
+	if (notice === "") return null;
+	return /* @__PURE__ */ jsx("output", {
+		...props,
+		className,
+		"data-fs-cart-coupon-unmatched-notice": "",
+		"data-fs-text": "",
+		children: notice
+	});
+}
+function CartCouponSavings({ className, $content, $locale, ...props }) {
+	const coupon = useContext(CartCouponContext);
+	const { cart } = useCart();
+	const { locale, currency } = useStorefrontContext();
+	const { format } = useMessageFormatter(CartCouponSavingsContent, $content);
+	if (!cart || !coupon || coupon.isUnmatchedCondition || coupon.code === "") return null;
+	const saved = cart.discounts.reduce((sum, discount) => discount.kind === "COUPON" && discount.name === coupon.code && isFiniteAmount(discount.value.amount) ? sum + Number(discount.value.amount) : sum, 0);
+	if (saved <= 0) return null;
+	return /* @__PURE__ */ jsx("span", {
+		...props,
+		className,
+		"data-fs-cart-coupon-savings": "",
+		"data-fs-text": "",
+		children: format("template", { amount: formatPrice(-saved, locale, currency) })
 	});
 }
 const CartCheckoutGuardDefinition = defineComponent({
@@ -550,34 +1007,45 @@ const CartFilledDefinition = defineComponent({
 		category: "commerce"
 	},
 	schema: {},
-	guideline: "The filled branch of the three-state mini-cart (loading / empty / filled): renders its children only when the cart has one or more items. Wrap the CartList, the order summary, and the checkout CTA in it so they hide when the cart is empty. Pair with CartLoading and CartEmpty. Must be inside CartRoot. See cart.md."
+	guideline: "The filled branch of the three-state mini-cart (loading / empty / filled): renders its children only when the cart has one or more items. Wrap the CartList (or the CartAvailableItems and CartUnavailableItems pair that replaces it, the latter inside a CartUnavailableSection with a CartUnavailableLabel), the order summary, and the checkout CTA in it so they hide when the cart is empty. Pair with CartLoading and CartEmpty. Must be inside CartRoot. See cart.md."
 });
 const CartUnavailableCountDefinition = defineComponent({
 	name: "CartUnavailableCount",
 	importPath: "@vtex/faststore/components",
 	component: CartUnavailableCount,
+	content: CartUnavailableCountContent,
 	editor: {
 		label: "Cart Unavailable Count",
 		category: "commerce"
 	},
-	schema: { template: {
-		type: "string",
-		default: "{count} items unavailable",
-		label: "Template"
-	} },
-	guideline: "Cart-level summary of how many lines are unavailable; self-hides when none. See cart.md."
+	schema: {},
+	guideline: "Cart-level summary of how many lines are unavailable; self-hides when none. The text is the $content field template, an ICU message with a count argument. See cart.md."
 });
 const CartRemoveUnavailableDefinition = defineComponent({
 	name: "CartRemoveUnavailable",
 	importPath: "@vtex/faststore/components",
 	component: CartRemoveUnavailable,
+	content: CartRemoveUnavailableContent,
 	editor: {
 		label: "Cart Remove Unavailable",
 		category: "commerce"
 	},
 	schema: {},
 	actions: { cart: ["removeItems"] },
-	guideline: "Button that removes every unavailable line in one batch call; self-hides when none. See cart.md."
+	guideline: "Button that removes every unavailable line in one batch call; self-hides when none. Composed children are the label; without them it is the $content field label. See cart.md."
+});
+const ClearCartButtonDefinition = defineComponent({
+	name: "ClearCartButton",
+	importPath: "@vtex/faststore/components",
+	component: ClearCartButton,
+	content: ClearCartButtonContent,
+	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. Composed children are the label; without them it is the $content field label. Must be inside CartRoot. See cart.md."
 });
 function isUnavailable(item) {
 	return item.variant.availability !== "AVAILABLE";
@@ -595,8 +1063,9 @@ function CartCheckoutGuard({ className, children, ...props }) {
 		children
 	});
 }
-function CartUnavailableCount({ className, children, template = "{count} items unavailable", ...props }) {
+function CartUnavailableCount({ className, children, $content, $locale, ...props }) {
 	const { cart } = useCart();
+	const { format } = useMessageFormatter(CartUnavailableCountContent, $content);
 	const count = (cart?.items ?? []).filter(isUnavailable).length;
 	if (count === 0) return null;
 	return /* @__PURE__ */ jsx("span", {
@@ -604,11 +1073,12 @@ function CartUnavailableCount({ className, children, template = "{count} items u
 		className,
 		"data-fs-cart-unavailable-count": "",
 		"data-fs-text": "",
-		children: children ?? template.replace("{count}", String(count))
+		children: children ?? format("template", { count })
 	});
 }
-function CartRemoveUnavailable({ className, children, onClick, $actions: $actionsProp, ...props }) {
+function CartRemoveUnavailable({ className, children, onClick, $content, $locale, $actions: $actionsProp, ...props }) {
 	const $actions = useActionsOverride($actionsProp);
+	const { format } = useMessageFormatter(CartRemoveUnavailableContent, $content);
 	const { cart } = useCart();
 	const unavailableIds = (cart?.items ?? []).filter(isUnavailable).map((item) => item.id);
 	if (unavailableIds.length === 0) return null;
@@ -623,7 +1093,224 @@ function CartRemoveUnavailable({ className, children, onClick, $actions: $action
 		onClick: handleClick,
 		"data-fs-cart-remove-unavailable": "",
 		"data-fs-button": "",
-		children: children ?? "Remove unavailable items"
+		children: children ?? format("label")
+	});
+}
+const CartUnavailableLabelContent = defineContentType({
+	id: "cart-unavailable-label",
+	title: "Cart Unavailable Label",
+	description: "Heading copy of the cart section that holds the lines the shopper cannot buy.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { text: {
+			type: "string",
+			title: "Unavailable section label",
+			format: "icu-message",
+			messageSource: "Unavailable"
+		} }
+	}
+});
+const CartUnavailableSectionDefinition = defineComponent({
+	name: "CartUnavailableSection",
+	importPath: "@vtex/faststore/components",
+	component: CartUnavailableSection,
+	editor: {
+		label: "Cart Unavailable Section",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders its children only when at least one cart line is unavailable, so the section card, header and list disappear together; it carries no copy (compose CartUnavailableLabel and CartUnavailableItems inside it). Pair with CartAvailableItems under CartFilled. Must be inside CartRoot. See cart.md."
+});
+const CartUnavailableLabelDefinition = defineComponent({
+	name: "CartUnavailableLabel",
+	importPath: "@vtex/faststore/components",
+	component: CartUnavailableLabel,
+	content: CartUnavailableLabelContent,
+	editor: {
+		label: "Cart Unavailable Label",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Heading copy of the unavailable section, rendered as plain text from the $content field text; blank copy renders nothing. It renders only while at least one line is unavailable. Compose one inside CartUnavailableSection as its header, grouped with an Icon in a Container when the header carries one. Must be inside CartRoot. See cart.md."
+});
+function CartUnavailableSection({ className, children, ...props }) {
+	const { cart } = useCart();
+	if (!cart?.items.some(isUnavailable)) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-unavailable-section": "",
+		children
+	});
+}
+function CartUnavailableLabel({ $content, $locale, className, ...props }) {
+	const { cart } = useCart();
+	const { format } = useMessageFormatter(CartUnavailableLabelContent, $content);
+	if (!cart?.items.some(isUnavailable)) return null;
+	const copy = format("text");
+	if (!copy.trim()) return null;
+	return /* @__PURE__ */ jsx("p", {
+		...props,
+		className,
+		"data-fs-cart-unavailable-label": "",
+		"data-fs-text": "",
+		children: copy
+	});
+}
+const CartAllUnavailableMessageContent = defineContentType({
+	id: "cart-all-unavailable-message",
+	title: "Cart All Unavailable Message",
+	description: "Warning shown in the cart when none of the lines the shopper added can be bought, with an optional link.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			text: {
+				type: "string",
+				title: "Nothing purchasable message",
+				format: "icu-message",
+				messageSource: "No items are available for purchase right now"
+			},
+			linkText: {
+				type: "string",
+				minLength: 1,
+				title: "Link text"
+			},
+			linkHref: {
+				type: "string",
+				minLength: 1,
+				title: "Link destination",
+				format: "uri-reference",
+				pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$"
+			}
+		}
+	}
+});
+const CartAllUnavailableDefinition = defineComponent({
+	name: "CartAllUnavailable",
+	importPath: "@vtex/faststore/components",
+	component: CartAllUnavailable,
+	editor: {
+		label: "Cart All Unavailable",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders its children only when the cart has at least one line the shopper added and every such line is unavailable; gift lines are ignored, so a gift-only cart never shows it and a cart whose only available line is a gift does. Distinct from CartEmpty (zero lines). Carries no copy: compose CartAllUnavailableMessage inside it, which carries the optional link. While it holds no rendered CartAllUnavailableMessage (blank copy, or no message composed), the store stylesheet hides it with display: none, so put the box on the gate: blank copy leaves no empty box, and a display class cannot show it. Place under CartFilled. Must be inside CartRoot. See cart.md."
+});
+const CartAllUnavailableMessageDefinition = defineComponent({
+	name: "CartAllUnavailableMessage",
+	importPath: "@vtex/faststore/components",
+	component: CartAllUnavailableMessage,
+	content: CartAllUnavailableMessageContent,
+	editor: {
+		label: "Cart All Unavailable Message",
+		category: "commerce"
+	},
+	schema: {
+		linkText: {
+			type: "string",
+			label: "Link text"
+		},
+		linkHref: {
+			type: "link",
+			label: "Link destination"
+		}
+	},
+	guideline: "The warning that nothing in the cart can be bought, inside CartAllUnavailable, announced to screen readers as an alert. The message is the $content field text; blank copy renders nothing. It renders only while the cart has nothing purchasable. An optional link follows the text: set linkText and linkHref (a page reference such as { \"page\": \"<page name>\" }), or the same CMS fields; it renders only when both are set, there is no default, and a destination that is not a page reference or an http, https, mailto, tel or site-relative URL is dropped. A non-blank CMS field wins over its prop, so a CMS store authors no link props. Must be inside CartRoot. See cart.md."
+});
+/** True when the cart has a shopper-added line and every shopper-added line is unavailable. */
+function hasNothingPurchasable(items) {
+	const shopperLines = items.filter((item) => !item.gift);
+	return shopperLines.length > 0 && shopperLines.every(isUnavailable);
+}
+function CartAllUnavailable({ className, children, ...props }) {
+	const { cart } = useCart();
+	if (cart == null || !hasNothingPurchasable(cart.items)) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-all-unavailable": "",
+		children
+	});
+}
+/**
+* A page reference skips the string allowlist. A string is checked, and a refusal drops the link.
+* The runtime content slice does not enforce the model's `pattern`, so this is the only gate on a CMS string.
+*/
+function resolveMessageLinkHref(href) {
+	if (href == null) return null;
+	if (typeof href !== "string") return href;
+	if (!href.trim()) return null;
+	const destination = resolveSafeHref(href);
+	if (!destination.safe) {
+		console.warn("[CartAllUnavailableMessage] link destination rejected", { reason: destination.reason });
+		return null;
+	}
+	return destination.href;
+}
+function CartAllUnavailableMessage({ linkText, linkHref, $content, $locale, className, ...props }) {
+	const { cart } = useCart();
+	const { format } = useMessageFormatter(CartAllUnavailableMessageContent, $content);
+	if (cart == null || !hasNothingPurchasable(cart.items)) return null;
+	const copy = format("text");
+	if (!copy.trim()) return null;
+	const resolvedLinkText = configuredLabel($content?.linkText) ?? configuredLabel(linkText);
+	const rawHref = $content?.linkHref?.trim() ? $content.linkHref : linkHref;
+	const destination = resolvedLinkText ? resolveMessageLinkHref(rawHref) : null;
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		role: "alert",
+		className,
+		"data-fs-cart-all-unavailable-message": "",
+		children: [/* @__PURE__ */ jsx("p", {
+			"data-fs-cart-all-unavailable-message-text": "",
+			"data-fs-text": "",
+			children: copy
+		}), resolvedLinkText && destination != null ? /* @__PURE__ */ jsx(NavigationLink, {
+			href: destination,
+			"data-fs-cart-all-unavailable-message-link": "",
+			children: resolvedLinkText
+		}) : null]
+	});
+}
+function ClearCartButton({ className, children, disabled, onClick, $content, $locale, $actions: $actionsProp, ...props }) {
+	const $actions = useActionsOverride($actionsProp);
+	const { format } = useMessageFormatter(ClearCartButtonContent, $content);
+	const { cart } = useCart();
+	const [pending, setPending] = useState(false);
+	const inFlight = useRef(false);
+	const ids = (cart?.items ?? []).map((item) => item.id);
+	if (ids.length === 0) return null;
+	async function clear(removeItems) {
+		try {
+			await removeItems({ ids });
+		} catch (error) {
+			console.error("[ClearCartButton] removeItems failed", loggableErrorName(error));
+		} finally {
+			inFlight.current = false;
+			setPending(false);
+		}
+	}
+	function handleClick(e) {
+		if (inFlight.current) return;
+		onClick?.(e);
+		const removeItems = $actions?.cart?.removeItems;
+		if (typeof removeItems !== "function") return;
+		inFlight.current = true;
+		setPending(true);
+		clear(removeItems);
+	}
+	return /* @__PURE__ */ jsx("button", {
+		...props,
+		type: "button",
+		className,
+		onClick: handleClick,
+		disabled: pending || disabled,
+		"data-fs-clear-cart-button": "",
+		"data-fs-button": "",
+		...pending ? { "data-fs-clear-cart-button-pending": "" } : {},
+		children: children ?? format("label")
 	});
 }
 const CartOpenOnAddDefinition = defineComponent({
@@ -876,7 +1563,7 @@ const CartAlertRootDefinition = defineComponent({
 		}
 	},
 	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."
 });
 const CartAlertIconDefinition = defineComponent({
 	name: "CartAlertIcon",
@@ -959,12 +1646,12 @@ const CartEmptyMessageContent = defineContentType({
 	schema: {
 		type: "object",
 		additionalProperties: false,
-		required: ["text"],
 		properties: { text: {
 			type: "string",
 			minLength: 1,
 			title: "Empty cart message",
-			default: "Your cart is empty"
+			format: "icu-message",
+			messageSource: "Your cart is empty"
 		} }
 	}
 });
@@ -975,12 +1662,12 @@ const CartContinueShoppingContent = defineContentType({
 	schema: {
 		type: "object",
 		additionalProperties: false,
-		required: ["label"],
 		properties: { label: {
 			type: "string",
 			minLength: 1,
 			title: "Continue shopping label",
-			default: "Continue shopping"
+			format: "icu-message",
+			messageSource: "Continue shopping"
 		} }
 	}
 });
@@ -993,12 +1680,8 @@ const CartEmptyMessageDefinition = defineComponent({
 		label: "Cart Empty Message",
 		category: "commerce"
 	},
-	schema: { text: {
-		type: "string",
-		default: "Your cart is empty",
-		label: "Empty cart message"
-	} },
-	guideline: "The empty-cart message, rendered as plain text inside CartEmpty. CMS content wins over the text prop, which defaults to \"Your cart is empty\"; blank resolved copy renders nothing. It carries no layout — group and space it with Container, and pair it with CartContinueShopping for the way back to browsing. See cart.md."
+	schema: {},
+	guideline: "The empty-cart message, rendered as plain text inside CartEmpty. The text is the $content field text; a blank message renders nothing. It carries no layout — group and space it with Container, and pair it with CartContinueShopping for the way back to browsing. See cart.md."
 });
 const CartContinueShoppingDefinition = defineComponent({
 	name: "CartContinueShopping",
@@ -1009,16 +1692,13 @@ const CartContinueShoppingDefinition = defineComponent({
 		label: "Cart Continue Shopping",
 		category: "action"
 	},
-	schema: { label: {
-		type: "string",
-		default: "Continue shopping",
-		label: "Continue shopping label"
-	} },
-	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."
+	schema: {},
+	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. Composed children are the button content (compose an icon that way); without them the text is the $content field label. See cart.md."
 });
-function CartEmptyMessage({ text = "Your cart is empty", $content, className, ...props }) {
-	const message = $content?.text ?? text;
-	if (!message.trim()) return null;
+function CartEmptyMessage({ $content, $locale, className, ...props }) {
+	const { format } = useMessageFormatter(CartEmptyMessageContent, $content);
+	const message = format("text");
+	if (message === "") return null;
 	return /* @__PURE__ */ jsx("p", {
 		...props,
 		className,
@@ -1027,18 +1707,19 @@ function CartEmptyMessage({ text = "Your cart is empty", $content, className, ..
 		children: message
 	});
 }
-function CartContinueShopping({ label = "Continue shopping", $content, className, children, ...props }) {
-	const content = $content?.label ?? label;
-	if (children == null && !content.trim()) return null;
+function CartContinueShopping({ $content, $locale, className, children, ...props }) {
+	const { format } = useMessageFormatter(CartContinueShoppingContent, $content);
+	const content = children ?? format("label");
+	if (content === "") return null;
 	return /* @__PURE__ */ jsx(DrawerClose, {
 		...props,
 		className,
 		"data-fs-cart-continue-shopping": "",
 		"data-fs-button": "",
-		children: children ?? content
+		children: content
 	});
 }
 //#endregion
-export { CART_ALERT_ICON_NAMES, CartAlertContent, CartAlertIcon, CartAlertIconDefinition, CartAlertRoot, CartAlertRootDefinition, CartAlertText, CartAlertTextDefinition, CartAppliedCoupons, CartAppliedCouponsDefinition, CartCheckoutGuard, CartCheckoutGuardDefinition, CartCheckoutLabelContent, CartContinueShopping, CartContinueShoppingContent, CartContinueShoppingDefinition, CartCount, CartCountDefinition, CartCouponError, CartCouponErrorDefinition, CartCouponForm, CartCouponFormDefinition, CartCouponRemove, CartCouponRemoveDefinition, CartDataContext, CartDisclaimer, CartDisclaimerContent, CartDisclaimerDefinition, CartEmpty, CartEmptyDefinition, CartEmptyMessage, CartEmptyMessageContent, CartEmptyMessageDefinition, CartError, CartErrorDefinition, CartFilled, CartFilledDefinition, CartGoCheckout, CartGoCheckoutDefinition, CartItemSkeleton, CartList, CartListDefinition, CartLoading, CartLoadingDefinition, CartOpenOnAdd, CartOpenOnAddDefinition, CartRedirectOnAdd, CartRedirectOnAddDefinition, CartRemoveUnavailable, CartRemoveUnavailableDefinition, CartRoot, CartRootDefinition, CartTotal, CartTotalDefinition, CartTotalValueContext, CartUnavailableCount, CartUnavailableCountDefinition, formatPrice, useCart };
+export { CART_ALERT_ICON_NAMES, CART_COUPON_ERROR_FIELDS, CART_ERROR_FIELDS, CartAlertContent, CartAlertIcon, CartAlertIconDefinition, CartAlertRoot, CartAlertRootDefinition, CartAlertText, CartAlertTextDefinition, CartAllUnavailable, CartAllUnavailableDefinition, CartAllUnavailableMessage, CartAllUnavailableMessageContent, CartAllUnavailableMessageDefinition, CartAppliedCoupons, CartAppliedCouponsContent, CartAppliedCouponsDefinition, CartAvailableItems, CartAvailableItemsDefinition, CartCheckoutGuard, CartCheckoutGuardDefinition, CartCheckoutLabelContent, CartContinueShopping, CartContinueShoppingContent, CartContinueShoppingDefinition, CartCount, CartCountContent, CartCountDefinition, CartCouponEmpty, CartCouponEmptyDefinition, CartCouponError, CartCouponErrorContent, CartCouponErrorDefinition, CartCouponForm, CartCouponFormContent, CartCouponFormDefinition, CartCouponRemove, CartCouponRemoveDefinition, CartCouponSavings, CartCouponSavingsContent, CartCouponSavingsDefinition, CartCouponUnmatched, CartCouponUnmatchedContent, CartCouponUnmatchedDefinition, CartDataContext, CartDisclaimer, CartDisclaimerContent, CartDisclaimerDefinition, CartEmpty, CartEmptyDefinition, CartEmptyMessage, CartEmptyMessageContent, CartEmptyMessageDefinition, CartError, CartErrorContent, CartErrorDefinition, CartFilled, CartFilledDefinition, CartGoCheckout, CartGoCheckoutDefinition, CartItemSkeleton, CartList, CartListDefinition, CartLoading, CartLoadingDefinition, CartOpenOnAdd, CartOpenOnAddDefinition, CartRedirectOnAdd, CartRedirectOnAddDefinition, CartRemoveUnavailable, CartRemoveUnavailableContent, CartRemoveUnavailableDefinition, CartRoot, CartRootDefinition, CartTotal, CartTotalDefinition, CartTotalValueContext, CartUnavailableCount, CartUnavailableCountContent, CartUnavailableCountDefinition, CartUnavailableItems, CartUnavailableItemsDefinition, CartUnavailableLabel, CartUnavailableLabelContent, CartUnavailableLabelDefinition, CartUnavailableSection, CartUnavailableSectionDefinition, ClearCartButton, ClearCartButtonContent, ClearCartButtonDefinition, formatPrice, isFiniteAmount, useCart };
 
 //# sourceMappingURL=cart.js.map