@vtex/faststore 0.0.1

package/dist/matter/cart-item-seller-info/cart-item-seller-info.js

@@ -0,0 +1,54 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { graphql } from "../../sdk/generated/gql.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/matter/cart-item-seller-info/cart-item-seller-info.tsx
+const cartItemSellerInfoFragment = graphql(`
+  fragment CartItemSellerInfoData on Query {
+    cart {
+      items {
+        __typename
+        id
+        variant {
+          __typename
+          variantId
+          seller {
+            sellerId
+            name
+          }
+        }
+      }
+    }
+  }
+`);
+const CartItemSellerInfoDefinition = defineComponent({
+	name: "CartItemSellerInfo",
+	importPath: "@vtex/faststore/components",
+	component: CartItemSellerInfo,
+	fragment: cartItemSellerInfoFragment,
+	fetchStrategy: "reactive-list-item",
+	requiresContext: "cart-item",
+	editor: {
+		label: "Cart Item Seller Info",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders the marketplace seller name for a cart line; renders null when the line has no seller. Optional per-item data owned by its own fragment (ADR-0011). Must be inside CartList."
+});
+function CartItemSellerInfo({ className, children, $data: $dataProp, ...props }) {
+	const sellerName = useDataOverride($dataProp)?.variant?.seller?.name;
+	if (!sellerName) return null;
+	return /* @__PURE__ */ jsx("span", {
+		...props,
+		className,
+		"data-fs-cart-item-seller-info": "",
+		"data-fs-text": "",
+		children: children ?? sellerName
+	});
+}
+//#endregion
+export { CartItemSellerInfo, CartItemSellerInfoDefinition };
+
+//# sourceMappingURL=cart-item-seller-info.js.map

package/dist/matter/cart-item-seller-info/cart-item-seller-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-item-seller-info.js","names":[],"sources":["../../../src/matter/cart-item-seller-info/cart-item-seller-info.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { graphql } from '../../sdk/generated/gql.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset (T7)\n// ---------------------------------------------------------------------------\n\n// ADR-0011: CartItemSellerInfo is a per-item sub-matter that OWNS its (optional) seller data.\n// Decomposed out of the monolithic CartItemFragment, the seller subtree is fetched only on pages\n// that place this matter — over-fetch elimination by data ownership. The author writes one uniform\n// `on Query` fragment drilling the list; the compiler re-roots it to\n// `CartItemSellerInfoData_CartItem on CartItem`. Fields are inlined (no `...` spread) so the derived\n// per-item fragment is self-contained for `useFragment`.\nconst cartItemSellerInfoFragment = graphql(`\n  fragment CartItemSellerInfoData on Query {\n    cart {\n      items {\n        __typename\n        id\n        variant {\n          __typename\n          variantId\n          seller {\n            sellerId\n            name\n          }\n        }\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Per-line slice delivered by the `reactive-list-item` runtime: the value the wrapper publishes\n * through `DataOverrideContext`, read via `useDataOverride`. Only the fields the component renders\n * are typed; the resolved cache slice carries the full fragment selection.\n */\nexport type CartItemSellerInfoSlice = {\n  variant: { seller: { name: string } | null } | null;\n};\n\nexport type CartItemSellerInfoProps = ComponentPropsWithRef<'span'> & {\n  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */\n  $data?: CartItemSellerInfoSlice | null;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const CartItemSellerInfoDefinition = defineComponent<CartItemSellerInfoProps>({\n  name: 'CartItemSellerInfo',\n  importPath: '@vtex/faststore/components',\n  component: CartItemSellerInfo,\n  fragment: cartItemSellerInfoFragment,\n  fetchStrategy: 'reactive-list-item',\n  // requiresContext pairs with CartList (provides 'cart-item') so the context-constraints walk\n  // rejects placing this matter outside its iterator.\n  requiresContext: 'cart-item',\n  editor: { label: 'Cart Item Seller Info', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the marketplace seller name for a cart line; renders null when the line has no seller. Optional per-item data owned by its own fragment (ADR-0011). Must be inside CartList.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport function CartItemSellerInfo({ className, children, $data: $dataProp, ...props }: CartItemSellerInfoProps) {\n  // Delivery-agnostic: the slice arrives through the DataOverrideContext seam the reactive-list-item\n  // wrapper publishes (or via $data in tests); the component calls no data hook.\n  const slice = useDataOverride<CartItemSellerInfoSlice | null | undefined>($dataProp);\n  const sellerName = slice?.variant?.seller?.name;\n\n  if (!sellerName) {\n    return null;\n  }\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-seller-info=\"\" data-fs-text=\"\">\n      {children ?? sellerName}\n    </span>\n  );\n}\n"],"mappings":";;;;;;;AAiBA,MAAM,6BAA6B,QAAQ;;;;;;;;;;;;;;;;;CAiB1C;AAwBD,MAAa,+BAA+B,gBAAyC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,UAAU;CACV,eAAe;CAGf,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAyB,UAAU;CAAW;CAC/D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAMD,SAAgB,mBAAmB,EAAE,WAAW,UAAU,OAAO,WAAW,GAAG,SAAkC;CAI/G,MAAM,aADQ,gBAA4D,SACnD,CAAC,EAAE,SAAS,QAAQ;CAE3C,IAAI,CAAC,YACH,OAAO;CAGT,OACE,oBAAC,QAAD;EAAM,GAAI;EAAkB;EAAW,iCAA8B;EAAG,gBAAa;EAClF,UAAA,YAAY;CACT,CAAA;AAEV"}

package/dist/matter/cart-item-variations/cart-item-variations.d.ts

@@ -0,0 +1,27 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/cart-item-variations/cart-item-variations.d.ts
+/** One selected variation on the current cart line (e.g. `{ name: 'Cor', value: 'Vermelho' }`). */
+export type CartItemVariationEntry = {
+  name: string;
+  value: string;
+};
+/**
+ * Per-line slice delivered by the `reactive-list-item` runtime: the value the wrapper publishes
+ * through `DataOverrideContext`, read via `useDataOverride`. Only the fields the component renders
+ * are typed; the resolved cache slice carries the full fragment selection.
+ */
+export type CartItemVariationsSlice = {
+  variant: {
+    selectedOptions: CartItemVariationEntry[];
+  } | null;
+};
+export type CartItemVariationsProps = ComponentPropsWithRef<'div'> & {
+  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */
+  $data?: CartItemVariationsSlice | null;
+};
+export declare const CartItemVariationsDefinition: ComponentDefinition<CartItemVariationsProps>;
+export declare function CartItemVariations({ className, $data: $dataProp, ...props }: CartItemVariationsProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=cart-item-variations.d.ts.map

package/dist/matter/cart-item-variations/cart-item-variations.js

@@ -0,0 +1,69 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { graphql } from "../../sdk/generated/gql.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/cart-item-variations/cart-item-variations.tsx
+const cartItemVariationsFragment = graphql(`
+  fragment CartItemVariationsData on Query {
+    cart {
+      items {
+        __typename
+        id
+        variant {
+          __typename
+          selectedOptions {
+            name
+            value
+          }
+        }
+      }
+    }
+  }
+`);
+const CartItemVariationsDefinition = defineComponent({
+	name: "CartItemVariations",
+	importPath: "@vtex/faststore/components",
+	component: CartItemVariations,
+	fragment: cartItemVariationsFragment,
+	fetchStrategy: "reactive-list-item",
+	requiresContext: "cart-item",
+	editor: {
+		label: "Cart Item Variations",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders the variations selected on a cart line (e.g. \"Cor: Vermelho\"); renders null when the line has none. Optional per-item data owned by its own fragment (ADR-0011). Must be inside CartList. See cart-item.md."
+});
+function CartItemVariations({ className, $data: $dataProp, ...props }) {
+	const options = useDataOverride($dataProp)?.variant?.selectedOptions;
+	if (!options || options.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-item-variations": "",
+		children: options.map((option, index) => /* @__PURE__ */ jsxs("span", {
+			"data-fs-cart-item-variation": "",
+			"data-fs-text": "",
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-variation-name": "",
+					children: option.name
+				}),
+				/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-variation-separator": "",
+					children: ": "
+				}),
+				/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-variation-value": "",
+					children: option.value
+				})
+			]
+		}, `${option.name}-${index}`))
+	});
+}
+//#endregion
+export { CartItemVariations, CartItemVariationsDefinition };
+
+//# sourceMappingURL=cart-item-variations.js.map

package/dist/matter/cart-item-variations/cart-item-variations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-item-variations.js","names":[],"sources":["../../../src/matter/cart-item-variations/cart-item-variations.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { graphql } from '../../sdk/generated/gql.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset (T7)\n// ---------------------------------------------------------------------------\n\n// ADR-0011: CartItemVariations is a per-item sub-matter that OWNS its (optional) selected-options\n// data. Decomposed out of the monolithic CartItemFragment, the selected-options subtree is\n// fetched only on pages that place this matter — over-fetch elimination by data ownership. The\n// author writes one uniform `on Query` fragment drilling the list; the compiler re-roots it to\n// `CartItemVariationsData_CartItem on CartItem`. Fields are inlined (no `...` spread) so the\n// derived per-item fragment is self-contained for `useFragment`; it drills the identical\n// cart { items { ... } } path as the other per-item matters so it merges un-aliased (ADR-0012).\nconst cartItemVariationsFragment = graphql(`\n  fragment CartItemVariationsData on Query {\n    cart {\n      items {\n        __typename\n        id\n        variant {\n          __typename\n          selectedOptions {\n            name\n            value\n          }\n        }\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** One selected variation on the current cart line (e.g. `{ name: 'Cor', value: 'Vermelho' }`). */\nexport type CartItemVariationEntry = { name: string; value: string };\n\n/**\n * Per-line slice delivered by the `reactive-list-item` runtime: the value the wrapper publishes\n * through `DataOverrideContext`, read via `useDataOverride`. Only the fields the component renders\n * are typed; the resolved cache slice carries the full fragment selection.\n */\nexport type CartItemVariationsSlice = {\n  variant: { selectedOptions: CartItemVariationEntry[] } | null;\n};\n\nexport type CartItemVariationsProps = ComponentPropsWithRef<'div'> & {\n  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */\n  $data?: CartItemVariationsSlice | null;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const CartItemVariationsDefinition = defineComponent<CartItemVariationsProps>({\n  name: 'CartItemVariations',\n  importPath: '@vtex/faststore/components',\n  component: CartItemVariations,\n  fragment: cartItemVariationsFragment,\n  fetchStrategy: 'reactive-list-item',\n  // requiresContext pairs with CartList (provides 'cart-item') so the context-constraints walk\n  // rejects placing this matter outside its iterator.\n  requiresContext: 'cart-item',\n  editor: { label: 'Cart Item Variations', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the variations selected on a cart line (e.g. \"Cor: Vermelho\"); renders null when the line has none. Optional per-item data owned by its own fragment (ADR-0011). Must be inside CartList. See cart-item.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport function CartItemVariations({ className, $data: $dataProp, ...props }: CartItemVariationsProps) {\n  // Delivery-agnostic: the slice arrives through the DataOverrideContext seam the reactive-list-item\n  // wrapper publishes (or via $data in tests); the component calls no data hook.\n  const slice = useDataOverride<CartItemVariationsSlice | null | undefined>($dataProp);\n  const options = slice?.variant?.selectedOptions;\n\n  if (!options || options.length === 0) {\n    return null;\n  }\n\n  return (\n    <div {...props} className={className} data-fs-cart-item-variations=\"\">\n      {options.map((option, index) => (\n        <span key={`${option.name}-${index}`} data-fs-cart-item-variation=\"\" data-fs-text=\"\">\n          <span data-fs-cart-item-variation-name=\"\">{option.name}</span>\n          <span data-fs-cart-item-variation-separator=\"\">{': '}</span>\n          <span data-fs-cart-item-variation-value=\"\">{option.value}</span>\n        </span>\n      ))}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;AAkBA,MAAM,6BAA6B,QAAQ;;;;;;;;;;;;;;;;CAgB1C;AA2BD,MAAa,+BAA+B,gBAAyC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,UAAU;CACV,eAAe;CAGf,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAwB,UAAU;CAAW;CAC9D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAMD,SAAgB,mBAAmB,EAAE,WAAW,OAAO,WAAW,GAAG,SAAkC;CAIrG,MAAM,UADQ,gBAA4D,SACtD,CAAC,EAAE,SAAS;CAEhC,IAAI,CAAC,WAAW,QAAQ,WAAW,GACjC,OAAO;CAGT,OACE,oBAAC,OAAD;EAAK,GAAI;EAAkB;EAAW,gCAA6B;EAChE,UAAA,QAAQ,KAAK,QAAQ,UACpB,qBAAC,QAAD;GAAsC,+BAA4B;GAAG,gBAAa;GAAlF,UAAA;IACE,oBAAC,QAAD;KAAM,oCAAiC;KAAI,UAAA,OAAO;IAAW,CAAA;IAC7D,oBAAC,QAAD;KAAM,yCAAsC;KAAI,UAAA;IAAW,CAAA;IAC3D,oBAAC,QAAD;KAAM,qCAAkC;KAAI,UAAA,OAAO;IAAY,CAAA;GAC3D;EAJK,GAAA,GAAG,OAAO,KAAK,GAAG,OAIvB,CACP;CACE,CAAA;AAET"}

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

@@ -0,0 +1,78 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { CartTotalizer, Money } from "../../sdk/cart/operations.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/cart-totalizer/cart-totalizer.d.ts
+type CartTotalizerContextValue = Readonly<{
+  totalizers: readonly CartTotalizer[];
+}>;
+export declare function useCartTotalizers(): CartTotalizerContextValue;
+export type CartTotalizerRootProps = ComponentPropsWithRef<'div'> & {
+  /**
+   * Cart totalizer slice forwarded by the reactive runtime (`ReactiveDataProvider`) — it is the
+   * value of the `cart` top-level field on `CartTotalizerData on Query`, not the wrapping
+   * `{ cart: … }` shape. Receives `null` when the cart has not yet resolved.
+   */
+  $data?: {
+    totalizers: readonly CartTotalizer[];
+    total: Money;
+  } | null;
+};
+export type CartTotalizerLineProps = ComponentPropsWithRef<'div'> & {
+  /** Which `cart.totalizers` entry to render, selected by `id` (e.g. "Items", "Shipping", "Discounts"). */
+  totalizerId: string;
+  /** Optional label override; defaults to the totalizer's `name`. */
+  label?: string;
+  /** Styling hook → `data-fs-cart-totalizer-line-variant`. The F9 discounts line uses `'discount'`. */
+  variant?: 'default' | 'discount';
+  /** Text rendered in place of the value when the amount is exactly zero (e.g. "Free" for shipping — Decision 5). */
+  zeroLabel?: string;
+};
+export declare const CartTotalizerRootDefinition: ComponentDefinition<CartTotalizerRootProps>;
+export declare const CartTotalizerLineDefinition: ComponentDefinition<CartTotalizerLineProps>;
+export declare function CartTotalizerRoot({ $data: $dataProp, className, children, ...props }: CartTotalizerRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function CartTotalizerLine({ totalizerId, label, variant, zeroLabel, className, children, ...props }: CartTotalizerLineProps): import("react/jsx-runtime").JSX.Element | null;
+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.
+ */
+export type CartDiscountEntry = {
+  name: string | null;
+  value: {
+    amount: number;
+    currencyCode: string;
+  };
+  kind: CartDiscountKind;
+};
+/** Cart slice forwarded by the reactive runtime — the value of the top-level `cart` field. */
+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;
+  /** Cart discount slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */
+  $data?: CartDiscountLinesSlice | null;
+};
+export declare const CartDiscountLineDefinition: ComponentDefinition<CartDiscountLineProps>;
+export declare function CartDiscountLine({ otherLabel, className, $data: $dataProp, ...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: {
+    amount: number;
+    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;
+  /** Cart markdown slice forwarded by the reactive runtime; injected/overridden by the runtime or in tests. */
+  $data?: CartMarkdownSlice | null;
+};
+export declare const CartMarkdownLineDefinition: ComponentDefinition<CartMarkdownLineProps>;
+export declare function CartMarkdownLine({ label, className, $data: $dataProp, ...props }: CartMarkdownLineProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=cart-totalizer.d.ts.map

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

@@ -0,0 +1,220 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { useStorefrontContext } from "../../sdk/context/storefront-context.js";
+import { graphql } from "../../sdk/generated/gql.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { CartTotalValueContext, formatPrice } from "../cart/cart.js";
+import { createContext, useContext, useMemo } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/cart-totalizer/cart-totalizer.tsx
+const fragment = graphql(`
+  fragment CartTotalizerData on Query {
+    cart {
+      __typename
+      id
+      totalizers {
+        __typename
+        id
+        name
+        value {
+          ...MoneyFragment
+        }
+      }
+      total {
+        ...MoneyFragment
+      }
+    }
+  }
+`);
+const CART_TOTALIZER_UNSET = Symbol("CartTotalizerContextUnset");
+const CartTotalizerContextInternal = createContext(CART_TOTALIZER_UNSET);
+function useCartTotalizers() {
+	const ctx = useContext(CartTotalizerContextInternal);
+	if (ctx === CART_TOTALIZER_UNSET) throw new Error("useCartTotalizers() must be used inside a <CartTotalizerRoot> subtree.");
+	return ctx;
+}
+const CartTotalizerRootDefinition = defineComponent({
+	name: "CartTotalizerRoot",
+	importPath: "@vtex/faststore/components",
+	component: CartTotalizerRoot,
+	fragment,
+	fetchStrategy: "reactive",
+	editor: {
+		label: "Cart Totalizer Root",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "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."
+});
+const CartTotalizerLineDefinition = defineComponent({
+	name: "CartTotalizerLine",
+	importPath: "@vtex/faststore/components",
+	component: CartTotalizerLine,
+	editor: {
+		label: "Cart Totalizer Line",
+		category: "commerce"
+	},
+	schema: {
+		totalizerId: {
+			type: "string",
+			label: "Totalizer Id"
+		},
+		label: {
+			type: "string",
+			label: "Label"
+		},
+		variant: {
+			type: ["default", "discount"],
+			default: "default",
+			label: "Variant"
+		},
+		zeroLabel: {
+			type: "string",
+			label: "Zero Label"
+		}
+	},
+	guideline: "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."
+});
+function CartTotalizerRoot({ $data: $dataProp, className, children, ...props }) {
+	const $data = useDataOverride($dataProp);
+	const totalizerValue = useMemo(() => ({ totalizers: $data?.totalizers ?? [] }), [$data?.totalizers]);
+	return /* @__PURE__ */ jsx(CartTotalValueContext, {
+		value: $data?.total ?? null,
+		children: /* @__PURE__ */ jsx(CartTotalizerContextInternal, {
+			value: totalizerValue,
+			children: /* @__PURE__ */ jsx("div", {
+				...props,
+				className,
+				"data-fs-cart-totalizer-root": "",
+				children
+			})
+		})
+	});
+}
+function CartTotalizerLine({ totalizerId, label, variant = "default", zeroLabel, className, children, ...props }) {
+	const { totalizers } = useCartTotalizers();
+	const { locale, currency } = useStorefrontContext();
+	const totalizer = totalizers.find((t) => t.id === totalizerId);
+	if (!totalizer) return null;
+	const amount = totalizer.value.amount;
+	if (variant === "discount" && amount === 0) return null;
+	const valueContent = amount === 0 && zeroLabel != null ? zeroLabel : formatPrice(amount, locale, currency);
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		className,
+		"data-fs-cart-totalizer-line": "",
+		"data-fs-cart-totalizer-line-variant": variant,
+		children: [/* @__PURE__ */ jsx("span", { children: label ?? totalizer.name }), /* @__PURE__ */ jsx("span", { children: children ?? valueContent })]
+	});
+}
+const cartDiscountLinesFragment = graphql(`
+  fragment CartDiscountLinesData on Query {
+    cart {
+      __typename
+      id
+      discounts {
+        name
+        value {
+          ...MoneyFragment
+        }
+        kind
+      }
+    }
+  }
+`);
+const CartDiscountLineDefinition = defineComponent({
+	name: "CartDiscountLine",
+	importPath: "@vtex/faststore/components",
+	component: CartDiscountLine,
+	fragment: cartDiscountLinesFragment,
+	fetchStrategy: "reactive",
+	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."
+});
+function CartDiscountLine({ otherLabel = "Other discounts", className, $data: $dataProp, ...props }) {
+	const slice = useDataOverride($dataProp);
+	const { locale, currency } = useStorefrontContext();
+	const discounts = slice?.discounts;
+	if (!discounts || discounts.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-discount-lines": "",
+		children: discounts.map((discount, index) => {
+			const amount = Number(discount.value.amount);
+			const label = discount.name ?? otherLabel;
+			return /* @__PURE__ */ jsxs("div", {
+				"data-fs-cart-discount-line": "",
+				"data-fs-cart-discount-line-kind": discount.kind.toLowerCase(),
+				"data-fs-text": "",
+				children: [/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-discount-line-label": "",
+					children: label
+				}), /* @__PURE__ */ jsx("span", {
+					"data-fs-cart-discount-line-value": "",
+					children: formatPrice(-amount, locale, currency)
+				})]
+			}, `${discount.kind}-${discount.name}-${index}`);
+		})
+	});
+}
+const cartMarkdownFragment = graphql(`
+  fragment CartMarkdownData on Query {
+    cart {
+      __typename
+      id
+      itemMarkdownTotal {
+        ...MoneyFragment
+      }
+    }
+  }
+`);
+const CartMarkdownLineDefinition = defineComponent({
+	name: "CartMarkdownLine",
+	importPath: "@vtex/faststore/components",
+	component: CartMarkdownLine,
+	fragment: cartMarkdownFragment,
+	fetchStrategy: "reactive",
+	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."
+});
+function CartMarkdownLine({ label = "Item discounts", className, $data: $dataProp, ...props }) {
+	const slice = useDataOverride($dataProp);
+	const { locale, currency } = useStorefrontContext();
+	const amount = Number(slice?.itemMarkdownTotal?.amount ?? 0);
+	if (!amount) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		className,
+		"data-fs-cart-markdown-line": "",
+		"data-fs-text": "",
+		children: [/* @__PURE__ */ jsx("span", {
+			"data-fs-cart-markdown-line-label": "",
+			children: label
+		}), /* @__PURE__ */ jsx("span", {
+			"data-fs-cart-markdown-line-value": "",
+			children: formatPrice(-amount, locale, currency)
+		})]
+	});
+}
+//#endregion
+export { CartDiscountLine, CartDiscountLineDefinition, CartMarkdownLine, CartMarkdownLineDefinition, CartTotalizerLine, CartTotalizerLineDefinition, CartTotalizerRoot, CartTotalizerRootDefinition, useCartTotalizers };
+
+//# sourceMappingURL=cart-totalizer.js.map

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

@@ -0,0 +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 } 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  const amount = 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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"}

package/dist/matter/client-preferences/client-preferences.d.ts

@@ -0,0 +1,50 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentActions } from "../../sdk/actions/types.js";
+import { ReactNode } from "react";
+//#region src/matter/client-preferences/client-preferences.d.ts
+/** The `$data` slice forwarded by the reactive runtime — the `ClientPreferences` sibling entity. */
+export type ClientPreferencesData = {
+  clientPreferences?: {
+    optinNewsLetter?: boolean | null;
+    savePersonalData?: boolean | null;
+  } | null;
+} | null;
+export type ClientPreferencesRootProps = {
+  /** `Query` slice forwarded by the reactive runtime (value of the section fragment). */
+  $data?: ClientPreferencesData;
+  className?: string;
+  children?: ReactNode;
+};
+export type ClientPreferencesControlProps = {
+  label: string;
+  className?: string;
+  /** Injected by the compiler from `actions: { identity: ['clientPreferencesUpdate'] }`; the write surface. */
+  $actions?: ComponentActions;
+};
+export type NewsletterOptInControlProps = ClientPreferencesControlProps;
+export type SavePersonalDataOptInControlProps = ClientPreferencesControlProps;
+export declare const ClientPreferencesRootDefinition: ComponentDefinition<ClientPreferencesRootProps>;
+export declare const NewsletterOptInControlDefinition: ComponentDefinition<ClientPreferencesControlProps>;
+export declare const SavePersonalDataOptInControlDefinition: ComponentDefinition<ClientPreferencesControlProps>;
+/**
+ * Renders the client-preferences section Root: reads `$data` (the `ClientPreferences` sibling entity),
+ * reads `useSession()` (which also enforces the `SessionRoot` ancestor, mirroring
+ * `EmailIdentificationControl`), seeds both opt-in values from the section fragment, and publishes a
+ * section context exposing both values plus per-field pending/error tracking. The write itself flows
+ * through the Control's `$actions.identity.clientPreferencesUpdate` (ADR-0010); this Root tracks which
+ * keys are in flight and stores the returned userErrors under each key so each Control surfaces ITS OWN
+ * pending/error. When the session reports `canEditData: false` (identified but unauthenticated claimed
+ * profile — VTEX refuses the write server-side) every Control renders disabled with its readonly
+ * `data-fs-*` attribute, mirroring `EmailIdentificationControl`.
+ */
+export declare function ClientPreferencesRoot({ $data: $dataProp, className, children }: ClientPreferencesRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function NewsletterOptInControl(props: NewsletterOptInControlProps): import("react/jsx-runtime").JSX.Element;
+export declare function SavePersonalDataOptInControl(props: SavePersonalDataOptInControlProps): import("react/jsx-runtime").JSX.Element;
+export declare const ClientPreferences: {
+  Root: typeof ClientPreferencesRoot;
+  NewsletterOptInControl: typeof NewsletterOptInControl;
+  SavePersonalDataOptInControl: typeof SavePersonalDataOptInControl;
+};
+//#endregion
+//# sourceMappingURL=client-preferences.d.ts.map