@vtex/faststore 0.0.10 → 0.0.12

package/dist/matter/cart-totalizer/cart-totalizer.d.ts

@@ -1,3 +1,4 @@
+import { ContentValue, MessageLocaleProp } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import { CartTotalizer, Money } from "../../sdk/cart/operations.js";
@@ -37,7 +38,7 @@ export type CartDiscountKind = 'PROMOTION' | 'COUPON' | 'OTHER';
  * One cart-level discount line from `Cart.discounts`. `value` is the absolute amount discounted
  * (a positive `Money`); the negative sign is applied on render by the locale's currency format.
  * `amount` is typed `number` but is a string at runtime, so it is `Number()`-coerced before formatting.
- * `name` is null for the OTHER residual and for an unnamed promotion — the `otherLabel` prop names those.
+ * `name` is null for the OTHER residual and for an unnamed promotion — the `otherLabel` message names those.
  */
 export type CartDiscountEntry = {
   name: string | null;
@@ -51,14 +52,31 @@ export type CartDiscountEntry = {
 type CartDiscountLinesSlice = {
   discounts: CartDiscountEntry[];
 };
-export type CartDiscountLineProps = ComponentPropsWithRef<'div'> & {
-  /** Label for lines the API cannot name: the OTHER residual and an unnamed featured promotion. */
-  otherLabel?: string;
+export declare const CartDiscountLineContent: {
+  readonly id: "cart-discount-line";
+  readonly title: "Cart Discount Line";
+  readonly description: "Label for the discount lines the API cannot name.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly otherLabel: {
+        readonly type: "string";
+        readonly title: "Unnamed discount label";
+        readonly description: "Names the OTHER residual and an unnamed featured promotion.";
+        readonly format: "icu-message";
+        readonly messageSource: "Other discounts";
+      };
+    };
+  };
+};
+export type CartDiscountLineProps = ComponentPropsWithRef<'div'> & MessageLocaleProp & {
   /** Cart discount slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */
   $data?: CartDiscountLinesSlice | null;
+  $content?: ContentValue<typeof CartDiscountLineContent>;
 };
 export declare const CartDiscountLineDefinition: ComponentDefinition<CartDiscountLineProps>;
-export declare function CartDiscountLine({ otherLabel, className, $data: $dataProp, ...props }: CartDiscountLineProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartDiscountLine({ className, $data: $dataProp, $content, $locale, ...props }: CartDiscountLineProps): import("react/jsx-runtime").JSX.Element | null;
 /** Cart slice forwarded by the reactive runtime — the value of the top-level `cart` field. */
 type CartMarkdownSlice = {
   itemMarkdownTotal: {
@@ -66,13 +84,29 @@ type CartMarkdownSlice = {
     currencyCode: string;
   };
 };
-export type CartMarkdownLineProps = ComponentPropsWithRef<'div'> & {
-  /** Row label for the aggregate item-level markdown. Interim operational default until the i18n catalog lands. */
-  label?: string;
+export declare const CartMarkdownLineContent: {
+  readonly id: "cart-markdown-line";
+  readonly title: "Cart Markdown Line";
+  readonly description: "Label for the aggregate item-level markdown row.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly label: {
+        readonly type: "string";
+        readonly title: "Markdown label";
+        readonly format: "icu-message";
+        readonly messageSource: "Item discounts";
+      };
+    };
+  };
+};
+export type CartMarkdownLineProps = ComponentPropsWithRef<'div'> & MessageLocaleProp & {
   /** Cart markdown slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */
   $data?: CartMarkdownSlice | null;
+  $content?: ContentValue<typeof CartMarkdownLineContent>;
 };
 export declare const CartMarkdownLineDefinition: ComponentDefinition<CartMarkdownLineProps>;
-export declare function CartMarkdownLine({ label, className, $data: $dataProp, ...props }: CartMarkdownLineProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartMarkdownLine({ className, $data: $dataProp, $content, $locale, ...props }: CartMarkdownLineProps): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
 //# sourceMappingURL=cart-totalizer.d.ts.map

package/dist/matter/cart-totalizer/cart-totalizer.js

@@ -1,7 +1,9 @@
 "use client";
 import { defineComponent } from "../../core/dist/define-component.js";
+import { defineContentType } from "../../core/dist/define-content-type.js";
 import "../../core/dist/index.js";
 import { useStorefrontContext } from "../../sdk/context/storefront-context.js";
+import { useMessageFormatter } from "../../sdk/i18n/use-message-formatter.js";
 import { graphql } from "../../sdk/generated/gql.js";
 import { useDataOverride } from "../../sdk/data/data-override-context.js";
 import { CartTotalValueContext, formatPrice, isFiniteAmount } from "../cart/cart.js";
@@ -124,26 +126,40 @@ const cartDiscountLinesFragment = graphql(`
     }
   }
 `);
+const CartDiscountLineContent = defineContentType({
+	id: "cart-discount-line",
+	title: "Cart Discount Line",
+	description: "Label for the discount lines the API cannot name.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { otherLabel: {
+			type: "string",
+			title: "Unnamed discount label",
+			description: "Names the OTHER residual and an unnamed featured promotion.",
+			format: "icu-message",
+			messageSource: "Other discounts"
+		} }
+	}
+});
 const CartDiscountLineDefinition = defineComponent({
 	name: "CartDiscountLine",
 	importPath: "@vtex/faststore/components",
 	component: CartDiscountLine,
 	fragment: cartDiscountLinesFragment,
 	fetchStrategy: "reactive",
+	content: CartDiscountLineContent,
 	editor: {
 		label: "Cart Discount Line",
 		category: "commerce"
 	},
-	schema: { otherLabel: {
-		type: "string",
-		default: "Other discounts",
-		label: "Unnamed discount label"
-	} },
-	guideline: "Itemized order-summary discounts: renders one line per entry in cart.discounts (one per promotion and per coupon, plus a residual \"other\" line), each as label + negative amount. Renders nothing when the cart has no discounts. This is the itemized alternative to CartTotalizerLine totalizerId=\"Discounts\": the entries sum to that same aggregate, so compose this OR that line, never both (both would double-count the same money). Place it in the order summary, typically inside CartTotalizerRoot. Set otherLabel for the residual and any unnamed promotion. See cart-totalizer.md."
+	schema: {},
+	guideline: "Itemized order-summary discounts: renders one line per entry in cart.discounts (one per promotion and per coupon, plus a residual \"other\" line), each as label + negative amount. Renders nothing when the cart has no discounts. This is the itemized alternative to CartTotalizerLine totalizerId=\"Discounts\": the entries sum to that same aggregate, so compose this OR that line, never both (both would double-count the same money). Place it in the order summary, typically inside CartTotalizerRoot. The $content field otherLabel names the residual and any unnamed promotion. See cart-totalizer.md."
 });
-function CartDiscountLine({ otherLabel = "Other discounts", className, $data: $dataProp, ...props }) {
+function CartDiscountLine({ className, $data: $dataProp, $content, $locale, ...props }) {
 	const slice = useDataOverride($dataProp);
 	const { locale, currency } = useStorefrontContext();
+	const { format } = useMessageFormatter(CartDiscountLineContent, $content);
 	const discounts = slice?.discounts;
 	if (!discounts || discounts.length === 0) return null;
 	return /* @__PURE__ */ jsx("div", {
@@ -152,7 +168,7 @@ function CartDiscountLine({ otherLabel = "Other discounts", className, $data: $d
 		"data-fs-cart-discount-lines": "",
 		children: discounts.map((discount, index) => {
 			const amount = Number(discount.value.amount);
-			const label = discount.name ?? otherLabel;
+			const label = discount.name ?? format("otherLabel");
 			return /* @__PURE__ */ jsxs("div", {
 				"data-fs-cart-discount-line": "",
 				"data-fs-cart-discount-line-kind": discount.kind.toLowerCase(),
@@ -179,26 +195,39 @@ const cartMarkdownFragment = graphql(`
     }
   }
 `);
+const CartMarkdownLineContent = defineContentType({
+	id: "cart-markdown-line",
+	title: "Cart Markdown Line",
+	description: "Label for the aggregate item-level markdown row.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { label: {
+			type: "string",
+			title: "Markdown label",
+			format: "icu-message",
+			messageSource: "Item discounts"
+		} }
+	}
+});
 const CartMarkdownLineDefinition = defineComponent({
 	name: "CartMarkdownLine",
 	importPath: "@vtex/faststore/components",
 	component: CartMarkdownLine,
 	fragment: cartMarkdownFragment,
 	fetchStrategy: "reactive",
+	content: CartMarkdownLineContent,
 	editor: {
 		label: "Cart Markdown Line",
 		category: "commerce"
 	},
-	schema: { label: {
-		type: "string",
-		default: "Item discounts",
-		label: "Markdown label"
-	} },
-	guideline: "Aggregate item-level catalog markdown: renders Cart.itemMarkdownTotal (the sum of listPrice − price across the cart, the \"de/por\" catalog savings) as a single negative line. Renders nothing when the cart has no markdown. This is DISTINCT money from CartDiscountLine and CartTotalizerLine totalizerId=\"Discounts\" (those are cart-level promotions/coupons, price − sellingPrice) — it may be shown ALONGSIDE them, not instead of them, and does not double-count. Place it in the order summary, typically inside CartTotalizerRoot. Set label to word the row. See cart-totalizer.md."
+	schema: {},
+	guideline: "Aggregate item-level catalog markdown: renders Cart.itemMarkdownTotal (the sum of listPrice − price across the cart, the \"de/por\" catalog savings) as a single negative line. Renders nothing when the cart has no markdown. This is DISTINCT money from CartDiscountLine and CartTotalizerLine totalizerId=\"Discounts\" (those are cart-level promotions/coupons, price − sellingPrice) — it may be shown ALONGSIDE them, not instead of them, and does not double-count. Place it in the order summary, typically inside CartTotalizerRoot. The $content field label words the row. See cart-totalizer.md."
 });
-function CartMarkdownLine({ label = "Item discounts", className, $data: $dataProp, ...props }) {
+function CartMarkdownLine({ className, $data: $dataProp, $content, $locale, ...props }) {
 	const slice = useDataOverride($dataProp);
 	const { locale, currency } = useStorefrontContext();
+	const { format } = useMessageFormatter(CartMarkdownLineContent, $content);
 	const amount = Number(slice?.itemMarkdownTotal?.amount ?? 0);
 	if (!amount) return null;
 	return /* @__PURE__ */ jsxs("div", {
@@ -208,7 +237,7 @@ function CartMarkdownLine({ label = "Item discounts", className, $data: $dataPro
 		"data-fs-text": "",
 		children: [/* @__PURE__ */ jsx("span", {
 			"data-fs-cart-markdown-line-label": "",
-			children: label
+			children: format("label")
 		}), /* @__PURE__ */ jsx("span", {
 			"data-fs-cart-markdown-line-value": "",
 			children: formatPrice(-amount, locale, currency)
@@ -216,6 +245,6 @@ function CartMarkdownLine({ label = "Item discounts", className, $data: $dataPro
 	});
 }
 //#endregion
-export { CartDiscountLine, CartDiscountLineDefinition, CartMarkdownLine, CartMarkdownLineDefinition, CartTotalizerLine, CartTotalizerLineDefinition, CartTotalizerRoot, CartTotalizerRootDefinition, useCartTotalizers };
+export { CartDiscountLine, CartDiscountLineContent, CartDiscountLineDefinition, CartMarkdownLine, CartMarkdownLineContent, CartMarkdownLineDefinition, CartTotalizerLine, CartTotalizerLineDefinition, CartTotalizerRoot, CartTotalizerRootDefinition, useCartTotalizers };
 
 //# sourceMappingURL=cart-totalizer.js.map

package/dist/matter/cart-totalizer/cart-totalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"cart-totalizer.js","names":[],"sources":["../../../src/matter/cart-totalizer/cart-totalizer.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { type ComponentPropsWithRef, createContext, useContext, useMemo } from 'react';\nimport type { Money, CartTotalizer as Totalizer } from '../../sdk/cart/operations.js';\nimport { useStorefrontContext } from '../../sdk/context/storefront-context.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { graphql } from '../../sdk/generated/gql.js';\nimport { CartTotalValueContext, formatPrice, isFiniteAmount } from '../cart/cart.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — narrow cart slice (totalizers + total)\n// ---------------------------------------------------------------------------\n\nconst fragment = graphql(`\n  fragment CartTotalizerData on Query {\n    cart {\n      __typename\n      id\n      totalizers {\n        __typename\n        id\n        name\n        value {\n          ...MoneyFragment\n        }\n      }\n      total {\n        ...MoneyFragment\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Context — totalizers list, provided by CartTotalizerRoot for CartTotalizerLine\n// ---------------------------------------------------------------------------\n\ntype CartTotalizerContextValue = Readonly<{\n  totalizers: readonly Totalizer[];\n}>;\n\nconst CART_TOTALIZER_UNSET = Symbol('CartTotalizerContextUnset');\n\nconst CartTotalizerContextInternal = createContext<CartTotalizerContextValue | typeof CART_TOTALIZER_UNSET>(\n  CART_TOTALIZER_UNSET,\n);\n\nexport function useCartTotalizers(): CartTotalizerContextValue {\n  const ctx = useContext(CartTotalizerContextInternal);\n  if (ctx === CART_TOTALIZER_UNSET) {\n    throw new Error('useCartTotalizers() must be used inside a <CartTotalizerRoot> subtree.');\n  }\n  return ctx;\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type CartTotalizerRootProps = ComponentPropsWithRef<'div'> & {\n  /**\n   * Cart totalizer slice forwarded by the reactive runtime (`ReactiveDataProvider`) — it is the\n   * value of the `cart` top-level field on `CartTotalizerData on Query`, not the wrapping\n   * `{ cart: … }` shape. Receives `null` when the cart has not yet resolved.\n   */\n  $data?: { totalizers: readonly Totalizer[]; total: Money } | null;\n};\n\nexport type CartTotalizerLineProps = ComponentPropsWithRef<'div'> & {\n  /** Which `cart.totalizers` entry to render, selected by `id` (e.g. \"Items\", \"Shipping\", \"Discounts\"). */\n  totalizerId: string;\n  /** Optional label override; defaults to the totalizer's `name`. */\n  label?: string;\n  /** Styling hook → `data-fs-cart-totalizer-line-variant`. The F9 discounts line uses `'discount'`. */\n  variant?: 'default' | 'discount';\n  /** Text rendered in place of the value when the amount is exactly zero (e.g. \"Free\" for shipping — Decision 5). */\n  zeroLabel?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const CartTotalizerRootDefinition = defineComponent<CartTotalizerRootProps>({\n  name: 'CartTotalizerRoot',\n  importPath: '@vtex/faststore/components',\n  component: CartTotalizerRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  editor: { label: 'Cart Totalizer Root', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Focused reactive provider for cart totalizers + total (narrower than CartRoot); merges with CartRoot into one cart query when both are present on the page (e.g. CartRoot wrapping the mini-cart drawer, CartTotalizerRoot composing its footer). Use it to compose an order summary — in a mini-cart drawer footer or a checkout summary panel: wrap a CartTotalizerLine totalizerId=\"Items\" (subtotal), a CartTotalizerLine totalizerId=\"Discounts\" variant=\"discount\" (auto-hides at zero), a CartTotalizerLine totalizerId=\"Shipping\" zeroLabel=\"Grátis\", and a CartTotal for the grand total (set CartTotal label for a labeled total row). CartTotal is root-agnostic and reads the total from this root — there is no CartTotalizerTotal.',\n});\n\nexport const CartTotalizerLineDefinition = defineComponent<CartTotalizerLineProps>({\n  name: 'CartTotalizerLine',\n  importPath: '@vtex/faststore/components',\n  component: CartTotalizerLine,\n  editor: { label: 'Cart Totalizer Line', category: 'commerce' },\n  schema: {\n    totalizerId: { type: 'string', label: 'Totalizer Id' },\n    label: { type: 'string', label: 'Label' },\n    variant: { type: ['default', 'discount'] as const, default: 'default', label: 'Variant' },\n    zeroLabel: { type: 'string', label: 'Zero Label' },\n  },\n  guideline:\n    'Renders one cart totalizer row (label + value) selected by totalizerId. The canonical order-summary lines are totalizerId=\"Items\" (the subtotal), totalizerId=\"Discounts\" (the discount), and totalizerId=\"Shipping\" (the shipping cost). For the discounts line set variant=\"discount\" — it hides itself when the value is zero (no active discount). The Core API returns a negative amount for discounts; the formatted value displays as-is (e.g. \"-R$ 40,00\"). Set zeroLabel=\"Grátis\" for the shipping line so a zero amount renders the label instead of R$ 0,00. A line whose totalizerId is absent from the cart renders nothing (no empty row). Must be inside CartTotalizerRoot.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\nexport function CartTotalizerRoot({ $data: $dataProp, className, children, ...props }: CartTotalizerRootProps) {\n  const $data = useDataOverride($dataProp);\n\n  const totalizerValue: CartTotalizerContextValue = useMemo(\n    () => ({ totalizers: $data?.totalizers ?? [] }),\n    [$data?.totalizers],\n  );\n\n  return (\n    <CartTotalValueContext value={$data?.total ?? null}>\n      <CartTotalizerContextInternal value={totalizerValue}>\n        <div {...props} className={className} data-fs-cart-totalizer-root=\"\">\n          {children}\n        </div>\n      </CartTotalizerContextInternal>\n    </CartTotalValueContext>\n  );\n}\n\nexport function CartTotalizerLine({\n  totalizerId,\n  label,\n  variant = 'default',\n  zeroLabel,\n  className,\n  children,\n  ...props\n}: CartTotalizerLineProps) {\n  const { totalizers } = useCartTotalizers();\n  const { locale, currency } = useStorefrontContext();\n  const totalizer = totalizers.find((t) => t.id === totalizerId);\n\n  if (!totalizer) return null;\n\n  if (!isFiniteAmount(totalizer.value.amount)) return null;\n\n  const amount = Number(totalizer.value.amount);\n\n  if (variant === 'discount' && amount === 0) return null;\n\n  const valueContent = amount === 0 && zeroLabel != null ? zeroLabel : formatPrice(amount, locale, currency);\n\n  return (\n    <div {...props} className={className} data-fs-cart-totalizer-line=\"\" data-fs-cart-totalizer-line-variant={variant}>\n      <span>{label ?? totalizer.name}</span>\n      <span>{children ?? valueContent}</span>\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// CartDiscountLine — itemized discount breakdown (F11)\n// ---------------------------------------------------------------------------\n\n// Owns its own `Cart.discounts` slice (ADR-0011 data ownership): the field is fetched only when this\n// leaf is placed and merges with any CartTotalizerRoot / CartRoot cart selection into one query. The\n// entries are the itemized companion to the aggregate \"Discounts\" totalizer and sum to it, so a store\n// composes this OR CartTotalizerLine totalizerId=\"Discounts\", never both.\nconst cartDiscountLinesFragment = graphql(`\n  fragment CartDiscountLinesData on Query {\n    cart {\n      __typename\n      id\n      discounts {\n        name\n        value {\n          ...MoneyFragment\n        }\n        kind\n      }\n    }\n  }\n`);\n\nexport type CartDiscountKind = 'PROMOTION' | 'COUPON' | 'OTHER';\n\n/**\n * One cart-level discount line from `Cart.discounts`. `value` is the absolute amount discounted\n * (a positive `Money`); the negative sign is applied on render by the locale's currency format.\n * `amount` is typed `number` but is a string at runtime, so it is `Number()`-coerced before formatting.\n * `name` is null for the OTHER residual and for an unnamed promotion — the `otherLabel` prop names those.\n */\nexport type CartDiscountEntry = {\n  name: string | null;\n  value: { amount: number; currencyCode: string };\n  kind: CartDiscountKind;\n};\n\n/** Cart slice forwarded by the reactive runtime — the value of the top-level `cart` field. */\ntype CartDiscountLinesSlice = { discounts: CartDiscountEntry[] };\n\nexport type CartDiscountLineProps = ComponentPropsWithRef<'div'> & {\n  /** Label for lines the API cannot name: the OTHER residual and an unnamed featured promotion. */\n  otherLabel?: string;\n  /** Cart discount slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */\n  $data?: CartDiscountLinesSlice | null;\n};\n\nexport const CartDiscountLineDefinition = defineComponent<CartDiscountLineProps>({\n  name: 'CartDiscountLine',\n  importPath: '@vtex/faststore/components',\n  component: CartDiscountLine,\n  fragment: cartDiscountLinesFragment,\n  fetchStrategy: 'reactive',\n  editor: { label: 'Cart Discount Line', category: 'commerce' },\n  schema: {\n    otherLabel: { type: 'string', default: 'Other discounts', label: 'Unnamed discount label' },\n  },\n  guideline:\n    'Itemized order-summary discounts: renders one line per entry in cart.discounts (one per promotion ' +\n    'and per coupon, plus a residual \"other\" line), each as label + negative amount. Renders nothing ' +\n    'when the cart has no discounts. This is the itemized alternative to CartTotalizerLine ' +\n    'totalizerId=\"Discounts\": the entries sum to that same aggregate, so compose this OR that line, ' +\n    'never both (both would double-count the same money). Place it in the order summary, typically ' +\n    'inside CartTotalizerRoot. Set otherLabel for the residual and any unnamed promotion. See cart-totalizer.md.',\n});\n\nexport function CartDiscountLine({\n  otherLabel = 'Other discounts',\n  className,\n  $data: $dataProp,\n  ...props\n}: CartDiscountLineProps) {\n  const slice = useDataOverride<CartDiscountLinesSlice | null | undefined>($dataProp);\n  const { locale, currency } = useStorefrontContext();\n  const discounts = slice?.discounts;\n\n  if (!discounts || discounts.length === 0) {\n    return null;\n  }\n\n  return (\n    <div {...props} className={className} data-fs-cart-discount-lines=\"\">\n      {discounts.map((discount, index) => {\n        const amount = Number(discount.value.amount);\n        const label = discount.name ?? otherLabel;\n\n        return (\n          <div\n            key={`${discount.kind}-${discount.name}-${index}`}\n            data-fs-cart-discount-line=\"\"\n            data-fs-cart-discount-line-kind={discount.kind.toLowerCase()}\n            data-fs-text=\"\"\n          >\n            <span data-fs-cart-discount-line-label=\"\">{label}</span>\n            {/* Negate the positive magnitude and let the currency format sign it — no hardcoded glyph. */}\n            <span data-fs-cart-discount-line-value=\"\">{formatPrice(-amount, locale, currency)}</span>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// CartMarkdownLine — aggregate item-level catalog markdown (F11 scenario 1)\n// ---------------------------------------------------------------------------\n\n// Renders Cart.itemMarkdownTotal — Σ(listPrice − price) × qty across non-gift lines, computed\n// server-side — as one negative summary line, self-hiding when zero. This is the catalog \"de/por\"\n// markdown that sits ABOVE the Items subtotal, so it is DISTINCT money from the cart-level promotions\n// on the Discounts totalizer / CartDiscountLine (price − sellingPrice): the two coexist in a summary,\n// they do not substitute. Owns its own slice (ADR-0011): the field is fetched only when this leaf is\n// placed and merges with any CartTotalizerRoot / CartRoot cart selection into one query.\nconst cartMarkdownFragment = graphql(`\n  fragment CartMarkdownData on Query {\n    cart {\n      __typename\n      id\n      itemMarkdownTotal {\n        ...MoneyFragment\n      }\n    }\n  }\n`);\n\n/** Cart slice forwarded by the reactive runtime — the value of the top-level `cart` field. */\ntype CartMarkdownSlice = { itemMarkdownTotal: { amount: number; currencyCode: string } };\n\nexport type CartMarkdownLineProps = ComponentPropsWithRef<'div'> & {\n  /** Row label for the aggregate item-level markdown. Interim operational default until the i18n catalog lands. */\n  label?: string;\n  /** Cart markdown slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */\n  $data?: CartMarkdownSlice | null;\n};\n\nexport const CartMarkdownLineDefinition = defineComponent<CartMarkdownLineProps>({\n  name: 'CartMarkdownLine',\n  importPath: '@vtex/faststore/components',\n  component: CartMarkdownLine,\n  fragment: cartMarkdownFragment,\n  fetchStrategy: 'reactive',\n  editor: { label: 'Cart Markdown Line', category: 'commerce' },\n  schema: {\n    label: { type: 'string', default: 'Item discounts', label: 'Markdown label' },\n  },\n  guideline:\n    'Aggregate item-level catalog markdown: renders Cart.itemMarkdownTotal (the sum of listPrice − price ' +\n    'across the cart, the \"de/por\" catalog savings) as a single negative line. Renders nothing when the ' +\n    'cart has no markdown. This is DISTINCT money from CartDiscountLine and CartTotalizerLine ' +\n    'totalizerId=\"Discounts\" (those are cart-level promotions/coupons, price − sellingPrice) — it may be ' +\n    'shown ALONGSIDE them, not instead of them, and does not double-count. Place it in the order summary, ' +\n    'typically inside CartTotalizerRoot. Set label to word the row. See cart-totalizer.md.',\n});\n\nexport function CartMarkdownLine({\n  label = 'Item discounts',\n  className,\n  $data: $dataProp,\n  ...props\n}: CartMarkdownLineProps) {\n  const slice = useDataOverride<CartMarkdownSlice | null | undefined>($dataProp);\n  const { locale, currency } = useStorefrontContext();\n  // `amount` is a string at runtime; coerce before checking/formatting. A zero markdown self-hides.\n  const amount = Number(slice?.itemMarkdownTotal?.amount ?? 0);\n\n  if (!amount) {\n    return null;\n  }\n\n  return (\n    <div {...props} className={className} data-fs-cart-markdown-line=\"\" data-fs-text=\"\">\n      <span data-fs-cart-markdown-line-label=\"\">{label}</span>\n      {/* Negate the positive magnitude and let the currency format sign it — no hardcoded glyph. */}\n      <span data-fs-cart-markdown-line-value=\"\">{formatPrice(-amount, locale, currency)}</span>\n    </div>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"cart-totalizer.js","names":[],"sources":["../../../src/matter/cart-totalizer/cart-totalizer.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType, type MessageLocaleProp } from '@vtex/fs-core';\nimport { type ComponentPropsWithRef, createContext, useContext, useMemo } from 'react';\nimport type { Money, CartTotalizer as Totalizer } from '../../sdk/cart/operations.js';\nimport { useStorefrontContext } from '../../sdk/context/storefront-context.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { graphql } from '../../sdk/generated/gql.js';\nimport { useMessageFormatter } from '../../sdk/i18n/use-message-formatter.js';\nimport { CartTotalValueContext, formatPrice, isFiniteAmount } from '../cart/cart.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — narrow cart slice (totalizers + total)\n// ---------------------------------------------------------------------------\n\nconst fragment = graphql(`\n  fragment CartTotalizerData on Query {\n    cart {\n      __typename\n      id\n      totalizers {\n        __typename\n        id\n        name\n        value {\n          ...MoneyFragment\n        }\n      }\n      total {\n        ...MoneyFragment\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Context — totalizers list, provided by CartTotalizerRoot for CartTotalizerLine\n// ---------------------------------------------------------------------------\n\ntype CartTotalizerContextValue = Readonly<{\n  totalizers: readonly Totalizer[];\n}>;\n\nconst CART_TOTALIZER_UNSET = Symbol('CartTotalizerContextUnset');\n\nconst CartTotalizerContextInternal = createContext<CartTotalizerContextValue | typeof CART_TOTALIZER_UNSET>(\n  CART_TOTALIZER_UNSET,\n);\n\nexport function useCartTotalizers(): CartTotalizerContextValue {\n  const ctx = useContext(CartTotalizerContextInternal);\n  if (ctx === CART_TOTALIZER_UNSET) {\n    throw new Error('useCartTotalizers() must be used inside a <CartTotalizerRoot> subtree.');\n  }\n  return ctx;\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type CartTotalizerRootProps = ComponentPropsWithRef<'div'> & {\n  /**\n   * Cart totalizer slice forwarded by the reactive runtime (`ReactiveDataProvider`) — it is the\n   * value of the `cart` top-level field on `CartTotalizerData on Query`, not the wrapping\n   * `{ cart: … }` shape. Receives `null` when the cart has not yet resolved.\n   */\n  $data?: { totalizers: readonly Totalizer[]; total: Money } | null;\n};\n\nexport type CartTotalizerLineProps = ComponentPropsWithRef<'div'> & {\n  /** Which `cart.totalizers` entry to render, selected by `id` (e.g. \"Items\", \"Shipping\", \"Discounts\"). */\n  totalizerId: string;\n  /** Optional label override; defaults to the totalizer's `name`. */\n  label?: string;\n  /** Styling hook → `data-fs-cart-totalizer-line-variant`. The F9 discounts line uses `'discount'`. */\n  variant?: 'default' | 'discount';\n  /** Text rendered in place of the value when the amount is exactly zero (e.g. \"Free\" for shipping — Decision 5). */\n  zeroLabel?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const CartTotalizerRootDefinition = defineComponent<CartTotalizerRootProps>({\n  name: 'CartTotalizerRoot',\n  importPath: '@vtex/faststore/components',\n  component: CartTotalizerRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  editor: { label: 'Cart Totalizer Root', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Focused reactive provider for cart totalizers + total (narrower than CartRoot); merges with CartRoot into one cart query when both are present on the page (e.g. CartRoot wrapping the mini-cart drawer, CartTotalizerRoot composing its footer). Use it to compose an order summary — in a mini-cart drawer footer or a checkout summary panel: wrap a CartTotalizerLine totalizerId=\"Items\" (subtotal), a CartTotalizerLine totalizerId=\"Discounts\" variant=\"discount\" (auto-hides at zero), a CartTotalizerLine totalizerId=\"Shipping\" zeroLabel=\"Grátis\", and a CartTotal for the grand total (set CartTotal label for a labeled total row). CartTotal is root-agnostic and reads the total from this root — there is no CartTotalizerTotal.',\n});\n\nexport const CartTotalizerLineDefinition = defineComponent<CartTotalizerLineProps>({\n  name: 'CartTotalizerLine',\n  importPath: '@vtex/faststore/components',\n  component: CartTotalizerLine,\n  editor: { label: 'Cart Totalizer Line', category: 'commerce' },\n  schema: {\n    totalizerId: { type: 'string', label: 'Totalizer Id' },\n    label: { type: 'string', label: 'Label' },\n    variant: { type: ['default', 'discount'] as const, default: 'default', label: 'Variant' },\n    zeroLabel: { type: 'string', label: 'Zero Label' },\n  },\n  guideline:\n    'Renders one cart totalizer row (label + value) selected by totalizerId. The canonical order-summary lines are totalizerId=\"Items\" (the subtotal), totalizerId=\"Discounts\" (the discount), and totalizerId=\"Shipping\" (the shipping cost). For the discounts line set variant=\"discount\" — it hides itself when the value is zero (no active discount). The Core API returns a negative amount for discounts; the formatted value displays as-is (e.g. \"-R$ 40,00\"). Set zeroLabel=\"Grátis\" for the shipping line so a zero amount renders the label instead of R$ 0,00. A line whose totalizerId is absent from the cart renders nothing (no empty row). Must be inside CartTotalizerRoot.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\nexport function CartTotalizerRoot({ $data: $dataProp, className, children, ...props }: CartTotalizerRootProps) {\n  const $data = useDataOverride($dataProp);\n\n  const totalizerValue: CartTotalizerContextValue = useMemo(\n    () => ({ totalizers: $data?.totalizers ?? [] }),\n    [$data?.totalizers],\n  );\n\n  return (\n    <CartTotalValueContext value={$data?.total ?? null}>\n      <CartTotalizerContextInternal value={totalizerValue}>\n        <div {...props} className={className} data-fs-cart-totalizer-root=\"\">\n          {children}\n        </div>\n      </CartTotalizerContextInternal>\n    </CartTotalValueContext>\n  );\n}\n\nexport function CartTotalizerLine({\n  totalizerId,\n  label,\n  variant = 'default',\n  zeroLabel,\n  className,\n  children,\n  ...props\n}: CartTotalizerLineProps) {\n  const { totalizers } = useCartTotalizers();\n  const { locale, currency } = useStorefrontContext();\n  const totalizer = totalizers.find((t) => t.id === totalizerId);\n\n  if (!totalizer) return null;\n\n  if (!isFiniteAmount(totalizer.value.amount)) return null;\n\n  const amount = Number(totalizer.value.amount);\n\n  if (variant === 'discount' && amount === 0) return null;\n\n  const valueContent = amount === 0 && zeroLabel != null ? zeroLabel : formatPrice(amount, locale, currency);\n\n  return (\n    <div {...props} className={className} data-fs-cart-totalizer-line=\"\" data-fs-cart-totalizer-line-variant={variant}>\n      <span>{label ?? totalizer.name}</span>\n      <span>{children ?? valueContent}</span>\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// CartDiscountLine — itemized discount breakdown (F11)\n// ---------------------------------------------------------------------------\n\n// Owns its own `Cart.discounts` slice (ADR-0011 data ownership): the field is fetched only when this\n// leaf is placed and merges with any CartTotalizerRoot / CartRoot cart selection into one query. The\n// entries are the itemized companion to the aggregate \"Discounts\" totalizer and sum to it, so a store\n// composes this OR CartTotalizerLine totalizerId=\"Discounts\", never both.\nconst cartDiscountLinesFragment = graphql(`\n  fragment CartDiscountLinesData on Query {\n    cart {\n      __typename\n      id\n      discounts {\n        name\n        value {\n          ...MoneyFragment\n        }\n        kind\n      }\n    }\n  }\n`);\n\nexport type CartDiscountKind = 'PROMOTION' | 'COUPON' | 'OTHER';\n\n/**\n * One cart-level discount line from `Cart.discounts`. `value` is the absolute amount discounted\n * (a positive `Money`); the negative sign is applied on render by the locale's currency format.\n * `amount` is typed `number` but is a string at runtime, so it is `Number()`-coerced before formatting.\n * `name` is null for the OTHER residual and for an unnamed promotion — the `otherLabel` message names those.\n */\nexport type CartDiscountEntry = {\n  name: string | null;\n  value: { amount: number; currencyCode: string };\n  kind: CartDiscountKind;\n};\n\n/** Cart slice forwarded by the reactive runtime — the value of the top-level `cart` field. */\ntype CartDiscountLinesSlice = { discounts: CartDiscountEntry[] };\n\nexport const CartDiscountLineContent = defineContentType({\n  id: 'cart-discount-line',\n  title: 'Cart Discount Line',\n  description: 'Label for the discount lines the API cannot name.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      otherLabel: {\n        type: 'string',\n        title: 'Unnamed discount label',\n        description: 'Names the OTHER residual and an unnamed featured promotion.',\n        format: 'icu-message',\n        messageSource: 'Other discounts',\n      },\n    },\n  },\n});\n\nexport type CartDiscountLineProps = ComponentPropsWithRef<'div'> &\n  MessageLocaleProp & {\n    /** Cart discount slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */\n    $data?: CartDiscountLinesSlice | null;\n    $content?: ContentValue<typeof CartDiscountLineContent>;\n  };\n\nexport const CartDiscountLineDefinition = defineComponent<CartDiscountLineProps>({\n  name: 'CartDiscountLine',\n  importPath: '@vtex/faststore/components',\n  component: CartDiscountLine,\n  fragment: cartDiscountLinesFragment,\n  fetchStrategy: 'reactive',\n  content: CartDiscountLineContent,\n  editor: { label: 'Cart Discount Line', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Itemized order-summary discounts: renders one line per entry in cart.discounts (one per promotion ' +\n    'and per coupon, plus a residual \"other\" line), each as label + negative amount. Renders nothing ' +\n    'when the cart has no discounts. This is the itemized alternative to CartTotalizerLine ' +\n    'totalizerId=\"Discounts\": the entries sum to that same aggregate, so compose this OR that line, ' +\n    'never both (both would double-count the same money). Place it in the order summary, typically ' +\n    'inside CartTotalizerRoot. The $content field otherLabel names the residual and any unnamed promotion. ' +\n    'See cart-totalizer.md.',\n});\n\nexport function CartDiscountLine({ className, $data: $dataProp, $content, $locale, ...props }: CartDiscountLineProps) {\n  const slice = useDataOverride<CartDiscountLinesSlice | null | undefined>($dataProp);\n  const { locale, currency } = useStorefrontContext();\n  const { format } = useMessageFormatter(CartDiscountLineContent, $content);\n  const discounts = slice?.discounts;\n\n  if (!discounts || discounts.length === 0) {\n    return null;\n  }\n\n  return (\n    <div {...props} className={className} data-fs-cart-discount-lines=\"\">\n      {discounts.map((discount, index) => {\n        const amount = Number(discount.value.amount);\n        const label = discount.name ?? format('otherLabel');\n\n        return (\n          <div\n            key={`${discount.kind}-${discount.name}-${index}`}\n            data-fs-cart-discount-line=\"\"\n            data-fs-cart-discount-line-kind={discount.kind.toLowerCase()}\n            data-fs-text=\"\"\n          >\n            <span data-fs-cart-discount-line-label=\"\">{label}</span>\n            {/* Negate the positive magnitude and let the currency format sign it — no hardcoded glyph. */}\n            <span data-fs-cart-discount-line-value=\"\">{formatPrice(-amount, locale, currency)}</span>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// CartMarkdownLine — aggregate item-level catalog markdown (F11 scenario 1)\n// ---------------------------------------------------------------------------\n\n// Renders Cart.itemMarkdownTotal — Σ(listPrice − price) × qty across non-gift lines, computed\n// server-side — as one negative summary line, self-hiding when zero. This is the catalog \"de/por\"\n// markdown that sits ABOVE the Items subtotal, so it is DISTINCT money from the cart-level promotions\n// on the Discounts totalizer / CartDiscountLine (price − sellingPrice): the two coexist in a summary,\n// they do not substitute. Owns its own slice (ADR-0011): the field is fetched only when this leaf is\n// placed and merges with any CartTotalizerRoot / CartRoot cart selection into one query.\nconst cartMarkdownFragment = graphql(`\n  fragment CartMarkdownData on Query {\n    cart {\n      __typename\n      id\n      itemMarkdownTotal {\n        ...MoneyFragment\n      }\n    }\n  }\n`);\n\n/** Cart slice forwarded by the reactive runtime — the value of the top-level `cart` field. */\ntype CartMarkdownSlice = { itemMarkdownTotal: { amount: number; currencyCode: string } };\n\nexport const CartMarkdownLineContent = defineContentType({\n  id: 'cart-markdown-line',\n  title: 'Cart Markdown Line',\n  description: 'Label for the aggregate item-level markdown row.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      label: { type: 'string', title: 'Markdown label', format: 'icu-message', messageSource: 'Item discounts' },\n    },\n  },\n});\n\nexport type CartMarkdownLineProps = ComponentPropsWithRef<'div'> &\n  MessageLocaleProp & {\n    /** Cart markdown slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */\n    $data?: CartMarkdownSlice | null;\n    $content?: ContentValue<typeof CartMarkdownLineContent>;\n  };\n\nexport const CartMarkdownLineDefinition = defineComponent<CartMarkdownLineProps>({\n  name: 'CartMarkdownLine',\n  importPath: '@vtex/faststore/components',\n  component: CartMarkdownLine,\n  fragment: cartMarkdownFragment,\n  fetchStrategy: 'reactive',\n  content: CartMarkdownLineContent,\n  editor: { label: 'Cart Markdown Line', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Aggregate item-level catalog markdown: renders Cart.itemMarkdownTotal (the sum of listPrice − price ' +\n    'across the cart, the \"de/por\" catalog savings) as a single negative line. Renders nothing when the ' +\n    'cart has no markdown. This is DISTINCT money from CartDiscountLine and CartTotalizerLine ' +\n    'totalizerId=\"Discounts\" (those are cart-level promotions/coupons, price − sellingPrice) — it may be ' +\n    'shown ALONGSIDE them, not instead of them, and does not double-count. Place it in the order summary, ' +\n    'typically inside CartTotalizerRoot. The $content field label words the row. See cart-totalizer.md.',\n});\n\nexport function CartMarkdownLine({ className, $data: $dataProp, $content, $locale, ...props }: CartMarkdownLineProps) {\n  const slice = useDataOverride<CartMarkdownSlice | null | undefined>($dataProp);\n  const { locale, currency } = useStorefrontContext();\n  const { format } = useMessageFormatter(CartMarkdownLineContent, $content);\n  // `amount` is a string at runtime; coerce before checking/formatting. A zero markdown self-hides.\n  const amount = Number(slice?.itemMarkdownTotal?.amount ?? 0);\n\n  if (!amount) {\n    return null;\n  }\n\n  return (\n    <div {...props} className={className} data-fs-cart-markdown-line=\"\" data-fs-text=\"\">\n      <span data-fs-cart-markdown-line-label=\"\">{format('label')}</span>\n      {/* Negate the positive magnitude and let the currency format sign it — no hardcoded glyph. */}\n      <span data-fs-cart-markdown-line-value=\"\">{formatPrice(-amount, locale, currency)}</span>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/matter/challenge-return/challenge-return.d.ts

@@ -0,0 +1,62 @@
+import { ContentValue, MessageLocaleProp } from "../../core/dist/define-content-type.js";
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { PageRef } from "../../sdk/navigation/types.js";
+import { ComponentActions } from "../../sdk/actions/types.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/challenge-return/challenge-return.d.ts
+export declare const ChallengeReturnContent: {
+  readonly id: "challenge-return";
+  readonly title: "Challenge Return";
+  readonly description: "Copy for the page the bank sends the shopper back to after a 3D Secure challenge.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly resumingMessage: {
+        readonly type: "string";
+        readonly title: "Message while finishing the order";
+        readonly format: "icu-message";
+        readonly messageSource: "Finishing your order...";
+      };
+      readonly lateReturnMessage: {
+        readonly type: "string";
+        readonly title: "Message when the verification lapsed";
+        readonly description: "Shown in an alert when the callback answered a refusal: the order was not placed.";
+        readonly format: "icu-message";
+        readonly messageSource: "3D Secure expired. Go back to the checkout to place your order again.";
+      };
+      readonly unconfirmedMessage: {
+        readonly type: "string";
+        readonly title: "Message when the order could not be confirmed";
+        readonly description: "Shown as a status when the callback gave no answer: the payment may still be processing.";
+        readonly format: "icu-message";
+        readonly messageSource: "We could not confirm your order yet. Your payment may still be processing, so please do not pay again.";
+      };
+      readonly checkoutLabel: {
+        readonly type: "string";
+        readonly title: "Back to the checkout label";
+        readonly description: "Label of the link back to the checkout, shown with the late-return message.";
+        readonly format: "icu-message";
+        readonly messageSource: "Back to the checkout";
+      };
+    };
+  };
+};
+export type ChallengeReturnProps = ComponentPropsWithRef<'div'> & MessageLocaleProp & {
+  /** Where the late-return link goes. e.g. `{ standard: 'checkout' }` */
+  checkoutHref?: PageRef | string;
+  /**
+   * Where the shopper lands once the order is finished. A page reference gets the order's Node id as its
+   * `orderId` param. e.g. `{ standard: 'order-placed' }`
+   */
+  successHref?: PageRef | string;
+  /** Merchant-authored copy for each state the page can end on. */
+  $content?: ContentValue<typeof ChallengeReturnContent>;
+  /** Compiler-injected action surface; carries `payment.gatewayCallback` and `analytics.track`. */
+  $actions?: ComponentActions;
+};
+export declare const ChallengeReturnDefinition: ComponentDefinition<ChallengeReturnProps>;
+export declare function ChallengeReturn({ $content, $locale, checkoutHref, successHref, $actions: $actionsProp, className, ref, ...props }: ChallengeReturnProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=challenge-return.d.ts.map

package/dist/matter/challenge-return/challenge-return.js

@@ -0,0 +1,241 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import { defineContentType } from "../../core/dist/define-content-type.js";
+import "../../core/dist/index.js";
+import { resolveSiteRelativeHref } from "../../utils/safe-href.js";
+import { useMessageFormatter } from "../../sdk/i18n/use-message-formatter.js";
+import { useStorefrontNavigation } from "../../sdk/navigation/use-storefront-navigation.js";
+import { StorefrontLink } from "../../sdk/navigation/storefront-link.js";
+import { useActionsOverride } from "../../sdk/actions/actions-override-context.js";
+import { PAYMENT_NETWORK_ERROR_CODE } from "../../sdk/payment/operations.js";
+import { readChallengeReturn } from "../../sdk/payment/challenge-return.js";
+import { emitPurchaseForOrder, useSettledOrderRead } from "../../sdk/payment/resumed-purchase.js";
+import { useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/challenge-return/challenge-return.tsx
+/**
+* The page a shopper lands on when the bank sends them back from a 3D Secure challenge (T208). It finishes
+* the order with no click: one `gatewayCallback` for the order group in its own URL, one read of the settled
+* order, one `purchase`, and a replace to the confirmation page. A whole-page handover component, like
+* `SignInRedirect`: it does its work in an effect and renders only the state it is in.
+*
+* **A return never pays.** This page reaches `payment.gatewayCallback` and nothing else of the payment
+* actions, and renders no field of any kind: the card was handed to the gateway before the shopper left.
+*
+* The query is read from the document in the effect, never through `useSearchParams()`, which would need a
+* `Suspense` boundary the generator does not emit on a prerendered route; a prerender has no query at all,
+* so the first paint is the resuming state and the effect decides.
+*/
+const CHECKOUT_PAGE = { standard: "checkout" };
+const ORDER_PLACED_PAGE = { standard: "order-placed" };
+const ChallengeReturnContent = defineContentType({
+	id: "challenge-return",
+	title: "Challenge Return",
+	description: "Copy for the page the bank sends the shopper back to after a 3D Secure challenge.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			resumingMessage: {
+				type: "string",
+				title: "Message while finishing the order",
+				format: "icu-message",
+				messageSource: "Finishing your order..."
+			},
+			lateReturnMessage: {
+				type: "string",
+				title: "Message when the verification lapsed",
+				description: "Shown in an alert when the callback answered a refusal: the order was not placed.",
+				format: "icu-message",
+				messageSource: "3D Secure expired. Go back to the checkout to place your order again."
+			},
+			unconfirmedMessage: {
+				type: "string",
+				title: "Message when the order could not be confirmed",
+				description: "Shown as a status when the callback gave no answer: the payment may still be processing.",
+				format: "icu-message",
+				messageSource: "We could not confirm your order yet. Your payment may still be processing, so please do not pay again."
+			},
+			checkoutLabel: {
+				type: "string",
+				title: "Back to the checkout label",
+				description: "Label of the link back to the checkout, shown with the late-return message.",
+				format: "icu-message",
+				messageSource: "Back to the checkout"
+			}
+		}
+	}
+});
+const ChallengeReturnDefinition = defineComponent({
+	name: "ChallengeReturn",
+	importPath: "@vtex/faststore/components",
+	component: ChallengeReturn,
+	actions: {
+		payment: ["gatewayCallback"],
+		analytics: ["track"]
+	},
+	content: ChallengeReturnContent,
+	editor: {
+		label: "Challenge Return",
+		category: "commerce"
+	},
+	schema: {
+		checkoutHref: {
+			type: "link",
+			default: { standard: "checkout" },
+			label: "Checkout page"
+		},
+		successHref: {
+			type: "link",
+			default: { standard: "order-placed" },
+			fills: ["orderId"],
+			label: "Confirmation Page"
+		}
+	},
+	guideline: "The whole of the page the bank sends the shopper back to after a 3D Secure challenge: on mount it finishes the order with no click (one gateway callback for the order group in the URL, one read of the order, one purchase event) and replaces the page with the order confirmation. Place it alone on its own page, named by PlaceOrder's challengeReturnHref, never beside anything the shopper is meant to read. It renders no payment field and never pays: a shopper who returns after the verification lapsed reads an alert with a link back to the checkout, and one whose order could not be confirmed reads a status that says not to pay again, with no such link. See challenge-return.md."
+});
+/** What a result with no readable `userErrors` collapses to: this package's own code, which says nothing about the order. */
+const PAYMENT_NETWORK_ERROR_CODE_ENTRY = {
+	code: PAYMENT_NETWORK_ERROR_CODE,
+	message: "Unable to complete the request. Please try again."
+};
+/** True when the entry carries a code the server sent: an answer about this payment, not this package's own collapse. */
+function carriesServerCode(userErrors) {
+	return userErrors.some((userError) => typeof userError?.code === "string" && userError.code !== "NETWORK_ERROR");
+}
+/** The confirmation target: the authored page filled with the Node id, or a site-relative path of the store. */
+function confirmationTarget(successHref, orderNodeId) {
+	if (typeof successHref !== "string") return {
+		...successHref,
+		params: {
+			...successHref.params,
+			orderId: orderNodeId
+		}
+	};
+	const destination = resolveSiteRelativeHref(successHref);
+	if (destination.safe && !destination.href.includes("{")) return destination.href;
+	if (process.env.NODE_ENV !== "production") console.warn("[ChallengeReturn] successHref is not a path of this store; going to the confirmation page instead.");
+	return {
+		...ORDER_PLACED_PAGE,
+		params: { orderId: orderNodeId }
+	};
+}
+/** The order node id the callback settled, or the state the page ends on when it did not. */
+async function callGateway(callback, orderGroup) {
+	let result;
+	try {
+		result = await callback(orderGroup, { acceptChallenges: true });
+	} catch {
+		return { failedState: "unconfirmed" };
+	}
+	const userErrors = Array.isArray(result?.userErrors) ? result.userErrors : [PAYMENT_NETWORK_ERROR_CODE_ENTRY];
+	if (userErrors.length > 0) return { failedState: carriesServerCode(userErrors) ? "late" : "unconfirmed" };
+	const orderNodeId = result.orderNodeId ?? null;
+	return orderNodeId === null ? { failedState: "unconfirmed" } : { orderNodeId };
+}
+/** Reports the purchase and goes to the confirmation page; the state the page ends on. */
+async function reportAndConfirm({ track, readOrder, replace, hrefFor, successHref }, orderNodeId) {
+	await emitPurchaseForOrder({
+		track,
+		readOrder,
+		orderNodeId
+	});
+	const confirmation = confirmationTarget(successHref, orderNodeId);
+	if (hrefFor(confirmation) === null) return "unconfirmed";
+	try {
+		replace(confirmation);
+	} catch {
+		console.error("[ChallengeReturn] could not go to the confirmation page");
+		return "unconfirmed";
+	}
+	return "done";
+}
+async function finishChallengeReturn({ gatewayCallback, settle, ...rest }) {
+	const returned = readChallengeReturn(globalThis.location.search);
+	if (returned === null) {
+		settle("late");
+		return;
+	}
+	if (!gatewayCallback) {
+		console.error("[ChallengeReturn] the payment action namespace is not injected");
+		settle("unconfirmed");
+		return;
+	}
+	const outcome = await callGateway(gatewayCallback, returned.orderGroup);
+	if ("failedState" in outcome) {
+		settle(outcome.failedState);
+		return;
+	}
+	settle(await reportAndConfirm(rest, outcome.orderNodeId));
+}
+function ChallengeReturn({ $content, $locale, checkoutHref = CHECKOUT_PAGE, successHref = ORDER_PLACED_PAGE, $actions: $actionsProp, className, ref, ...props }) {
+	const $actions = useActionsOverride($actionsProp);
+	const { format } = useMessageFormatter(ChallengeReturnContent, $content);
+	const gatewayCallback = $actions?.payment?.gatewayCallback;
+	const track = $actions?.analytics?.track;
+	const readOrder = useSettledOrderRead();
+	const { replace, hrefFor } = useStorefrontNavigation();
+	const [state, setState] = useState("resuming");
+	const startedRef = useRef(false);
+	const mountedRef = useRef(false);
+	useEffect(() => {
+		mountedRef.current = true;
+		if (!startedRef.current) {
+			startedRef.current = true;
+			const settle = (next) => {
+				if (mountedRef.current) setState(next);
+			};
+			finishChallengeReturn({
+				gatewayCallback,
+				track,
+				readOrder,
+				replace,
+				hrefFor,
+				successHref,
+				settle
+			});
+		}
+		return () => {
+			mountedRef.current = false;
+		};
+	}, [
+		gatewayCallback,
+		track,
+		readOrder,
+		replace,
+		hrefFor,
+		successHref
+	]);
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		ref,
+		className,
+		"data-fs-challenge-return": "",
+		children: [
+			state === "resuming" ? /* @__PURE__ */ jsx("output", {
+				"data-fs-challenge-return-resuming": "",
+				children: format("resumingMessage")
+			}) : null,
+			state === "late" ? /* @__PURE__ */ jsxs("div", {
+				role: "alert",
+				"data-fs-challenge-return-late": "",
+				children: [/* @__PURE__ */ jsx("span", {
+					"data-fs-challenge-return-message": "",
+					children: format("lateReturnMessage")
+				}), /* @__PURE__ */ jsx(StorefrontLink, {
+					href: checkoutHref,
+					"data-fs-challenge-return-checkout-link": "",
+					children: format("checkoutLabel")
+				})]
+			}) : null,
+			state === "unconfirmed" ? /* @__PURE__ */ jsx("output", {
+				"data-fs-challenge-return-unconfirmed": "",
+				children: format("unconfirmedMessage")
+			}) : null
+		]
+	});
+}
+//#endregion
+export { ChallengeReturn, ChallengeReturnContent, ChallengeReturnDefinition };
+
+//# sourceMappingURL=challenge-return.js.map