@vtex/faststore 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-item.js","names":["BaseNumberField"],"sources":["../../../src/matter/cart-item/cart-item.tsx"],"sourcesContent":["'use client';\n\nimport { NumberField as BaseNumberField } from '@base-ui/react/number-field';\nimport { defineComponent } from '@vtex/fs-core';\nimport { type ComponentPropsWithRef, createContext, type ReactNode, useContext, useState } from 'react';\nimport { NavigationLink, type NavigationLinkProps } from '../../particles/navigation-link/navigation-link.js';\nimport type { ComponentActions } from '../../sdk/actions/types.js';\nimport type { CartItemEntity } 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 { resolveSafeHref } from '../../utils/safe-href.js';\nimport { formatPrice } from '../cart/cart.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type CartItemRootProps = ComponentPropsWithRef<'div'> & {\n  /**\n   * Per-line slice delivered by the `reactive-list-item` runtime (`ReactiveListItemDataProvider`) —\n   * the resolved `CartItem` entity read from the normalized cache via `useFragment(CartItem:<id>)`.\n   * Injected through the iteration context in a compiled page; the `$data` prop is retained for test\n   * injection.\n   */\n  $data?: CartItemEntity | null;\n};\n\nexport type CartItemImageProps = ComponentPropsWithRef<'img'> & {\n  objectFit?: 'contain' | 'cover' | 'fill' | 'none';\n};\n\n// The destination is the line's own product page, so `href` is not authorable. `$content` goes with it\n// because the leaf declares no content model: a product URL is commerce data, not copy. `target` goes\n// too, so the same-tab rule is enforced by the type rather than merely absent from the schema — an\n// image-only link cannot carry the \"(opens in new tab)\" cue a `_blank` destination needs.\nexport type CartItemProductLinkProps = Omit<NavigationLinkProps, 'href' | '$content' | 'target'>;\n\nexport type CartItemNameProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemVariantProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemSkuProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemPriceProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemListPriceProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemDiscountPercentageProps = ComponentPropsWithRef<'span'> & {\n  template?: string;\n};\n\nexport type CartItemLineTotalProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemOwnTotalProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemAggregateTotalProps = ComponentPropsWithRef<'span'>;\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 field the stepper converts with\n * is typed; the resolved cache slice carries the full fragment selection.\n */\nexport type CartItemQuantitySlice = {\n  variant: { unitMultiplier: number } | null;\n};\n\nexport type CartItemQuantityProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'value'> & {\n  /** Minimum, in purchasable units — not in the unit shown to the shopper. */\n  min?: number;\n  /** Maximum, in purchasable units. Unbounded when unset. */\n  max?: number;\n  /** Step, in purchasable units: one step moves the display by one unit multiplier. */\n  step?: number;\n  removeOnDecrement?: boolean;\n  /** Snap-notice template; `{value}` is replaced with the corrected displayed amount. */\n  validationMessage?: string;\n  children?: ReactNode;\n  /** Per-line slice from the reactive-list-item runtime; injected/overridden by the wrapper. */\n  $data?: CartItemQuantitySlice | null;\n  /** Injected by the compiler from `actions: { cart: [...] }`; the cart write surface. */\n  $actions?: ComponentActions;\n};\n\nexport type CartItemQuantityValueProps = ComponentPropsWithRef<'span'>;\n\nexport type CartItemRemoveProps = ComponentPropsWithRef<'button'> & {\n  /** Injected by the compiler from `actions: { cart: ['removeItem'] }`; the cart write surface. */\n  $actions?: ComponentActions;\n};\n\nexport type CartItemAvailableProps = ComponentPropsWithRef<'div'>;\n\nexport type CartItemUnavailableProps = ComponentPropsWithRef<'div'>;\n\nexport type CartItemGiftProps = ComponentPropsWithRef<'span'>;\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset (T7)\n//\n// CartItemRoot owns the core-scalar slice of each cart line (ADR-0012 Option B). Fields are inlined\n// (no `...` spread) so the compiler's list-field derivation finds the iterated `items` list by its\n// direct child field and re-roots this fragment to `CartItemRootData_CartItem on CartItem` for the\n// per-line `useFragment` subscription. `variant.availability` stays here — it is a cross-cutting core\n// scalar (CartCheckoutGuard, CartItemAvailable/Unavailable read it), not an optional display leaf.\n// `gift` stays here for the same reason: CartItemGift, CartItemRemove's suppression, and the row's\n// own state hook all read it, so one selection serves three consumers.\n//\n// Every field selected here MUST also be selected by the mutation fragment (`CartItemFragment` in\n// sdk/cart/operations.ts). ReactiveListItemDataProvider resolves `complete ? data : fallbackData`,\n// so a field present here but missing there makes every line incomplete after a cart write and\n// degrades the whole list to the cart-level slice, which carries no product or prices.\n// ---------------------------------------------------------------------------\n\nconst fragment = graphql(`\n  fragment CartItemRootData on Query {\n    cart {\n      items {\n        __typename\n        id\n        quantity\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n        sellingPrice {\n          amount\n          currencyCode\n        }\n        gift\n        ownTotal {\n          ...MoneyFragment\n        }\n        total {\n          ...MoneyFragment\n        }\n        variant {\n          __typename\n          variantId\n          sku\n          name\n          image {\n            url\n            altText\n          }\n          availability\n        }\n        product {\n          __typename\n          productId\n          title\n          detailUrl\n          categories {\n            categoryId\n            name\n          }\n          brand {\n            brandId\n            name\n          }\n        }\n      }\n    }\n  }\n`);\n\n// ADR-0011: the unit multiplier is optional per-line data owned by the stepper that converts with\n// it, not by the core root — a cart line showing a read-only quantity never fetches it. Fields are\n// inlined (no `...` spread) so the derived per-item fragment is self-contained for `useFragment`, and\n// it drills the identical cart { items { ... } } path as the other per-item matters so it merges\n// un-aliased (ADR-0012).\nconst cartItemQuantityFragment = graphql(`\n  fragment CartItemQuantityData on Query {\n    cart {\n      items {\n        __typename\n        id\n        variant {\n          __typename\n          unitMultiplier\n        }\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Cart item context — provided by CartItemRoot with its resolved per-line slice\n// ---------------------------------------------------------------------------\n\nconst CartItemContext = createContext<CartItemEntity | null>(null);\n\nfunction useCartItem(): CartItemEntity {\n  const item = useContext(CartItemContext);\n  if (!item) {\n    throw new Error('Cart item components must be used inside a <CartItemRoot> subtree.');\n  }\n  return item;\n}\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const CartItemRootDefinition = defineComponent<CartItemRootProps>({\n  name: 'CartItemRoot',\n  importPath: '@vtex/faststore/components',\n  component: CartItemRoot,\n  fragment,\n  fetchStrategy: 'reactive-list-item',\n  // Placement: requires CartList's `cart-item` iteration context and provides `cart-item-data` to the\n  // core particles below. The two tokens differ, so it does not self-satisfy — the context-constraints\n  // walk checks `requiresContext` before pushing this node's own `providesContext`.\n  requiresContext: 'cart-item',\n  providesContext: 'cart-item-data',\n  editor: { label: 'Cart Item Root', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Per-line data provider for the cart line-item template: place it directly inside CartList, wrapping the CartItem* particles (CartItemImage, CartItemName, CartItemPrice, the CartItemQuantity stepper, CartItemRemove, …). It owns the core per-item fields and delivers each line its own slice, so the core particles must sit inside it. Must be inside CartList. See cart-item.md.',\n});\n\nexport const CartItemImageDefinition = defineComponent<CartItemImageProps>({\n  name: 'CartItemImage',\n  importPath: '@vtex/faststore/components',\n  component: CartItemImage,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Image', category: 'commerce' },\n  schema: {\n    objectFit: { type: ['contain', 'cover', 'fill', 'none'] as const, default: 'contain', label: 'Object Fit' },\n  },\n  guideline: 'Renders the product image from the cart item. Must be inside CartItemRoot.',\n});\n\nexport const CartItemProductLinkDefinition = defineComponent<CartItemProductLinkProps>({\n  name: 'CartItemProductLink',\n  importPath: '@vtex/faststore/components',\n  component: CartItemProductLink,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Product Link', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Links the cart line image to its product page, using the product URL the line already carries: place it inside CartItemRoot wrapping CartItemImage. Whether a line links is decided by placing this element, so there is no prop to toggle it — a checkout line simply omits it. Renders its children unwrapped when the line has no image or no usable product URL, so it never leaves an empty or unsafe link. Navigation is same-tab, and the leaf adds no fields to the page query. Must be inside CartItemRoot. See cart-item.md.',\n});\n\nexport const CartItemNameDefinition = defineComponent<CartItemNameProps>({\n  name: 'CartItemName',\n  importPath: '@vtex/faststore/components',\n  component: CartItemName,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Name', category: 'commerce' },\n  schema: {},\n  guideline: 'Renders the product name from the cart item. Must be inside CartItemRoot.',\n});\n\nexport const CartItemVariantDefinition = defineComponent<CartItemVariantProps>({\n  name: 'CartItemVariant',\n  importPath: '@vtex/faststore/components',\n  component: CartItemVariant,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Variant', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the selected variant name of the cart item (e.g. \"Midnight Black\"); renders null when the variant has no name. Use as a subtitle under CartItemName, typically alongside CartItemSku. Must be inside CartItemRoot.',\n});\n\nexport const CartItemSkuDefinition = defineComponent<CartItemSkuProps>({\n  name: 'CartItemSku',\n  importPath: '@vtex/faststore/components',\n  component: CartItemSku,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item SKU', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the SKU code of the cart item variant (e.g. \"WNC-400X\"); renders null when the variant has no SKU. Use as a subtitle under CartItemName, typically alongside CartItemVariant. Must be inside CartItemRoot.',\n});\n\nexport const CartItemPriceDefinition = defineComponent<CartItemPriceProps>({\n  name: 'CartItemPrice',\n  importPath: '@vtex/faststore/components',\n  component: CartItemPrice,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Price', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the selling price of the cart item, formatted from the active storefront context. Must be inside CartItemRoot.',\n});\n\nexport const CartItemListPriceDefinition = defineComponent<CartItemListPriceProps>({\n  name: 'CartItemListPrice',\n  importPath: '@vtex/faststore/components',\n  component: CartItemListPrice,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item List Price', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the original list price of the cart item (strikethrough); renders null when no discount is active. Use alongside CartItemPrice to show promotional pricing. Must be inside CartItemRoot.',\n});\n\nexport const CartItemDiscountPercentageDefinition = defineComponent<CartItemDiscountPercentageProps>({\n  name: 'CartItemDiscountPercentage',\n  importPath: '@vtex/faststore/components',\n  component: CartItemDiscountPercentage,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Discount %', category: 'commerce' },\n  schema: {\n    template: { type: 'string', default: '-{percentage}%', label: 'Template' },\n  },\n  guideline:\n    'Per-line discount badge showing the integer listPrice-vs-sellingPrice percentage (e.g. \"-20%\"); use the template prop to customize the format ({percentage} is the integer percent). Renders null when the line has no discount (sellingPrice >= listPrice), so it only appears on promotional lines. Place alongside CartItemPrice/CartItemListPrice. Must be inside CartItemRoot.',\n});\n\nexport const CartItemLineTotalDefinition = defineComponent<CartItemLineTotalProps>({\n  name: 'CartItemLineTotal',\n  importPath: '@vtex/faststore/components',\n  component: CartItemLineTotal,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Line Total', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the per-line total (selling price × quantity) formatted from the active storefront context. Must be inside CartItemRoot.',\n});\n\nexport const CartItemOwnTotalDefinition = defineComponent<CartItemOwnTotalProps>({\n  name: 'CartItemOwnTotal',\n  importPath: '@vtex/faststore/components',\n  component: CartItemOwnTotal,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Own Total', category: 'commerce' },\n  schema: {},\n  guideline:\n    \"Renders the line's own total (excludes bundle/composition children), formatted from the active storefront context. Equals CartItemAggregateTotal on lines with no compositions. Must be inside CartItemRoot. See cart-item.md.\",\n});\n\nexport const CartItemAggregateTotalDefinition = defineComponent<CartItemAggregateTotalProps>({\n  name: 'CartItemAggregateTotal',\n  importPath: '@vtex/faststore/components',\n  component: CartItemAggregateTotal,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Aggregate Total', category: 'commerce' },\n  schema: {},\n  guideline:\n    \"Renders the line's aggregate total including all nested composition children, formatted from the active storefront context — the price the shopper actually pays for a bundled line. Equals CartItemOwnTotal on lines with no compositions. Must be inside CartItemRoot. See cart-item.md.\",\n});\n\nexport const CartItemQuantityDefinition = defineComponent<CartItemQuantityProps>({\n  name: 'CartItemQuantity',\n  importPath: '@vtex/faststore/components',\n  component: CartItemQuantity,\n  fragment: cartItemQuantityFragment,\n  fetchStrategy: 'reactive-list-item',\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Quantity', category: 'commerce' },\n  schema: {\n    min: { type: 'number', default: 1, label: 'Min' },\n    max: { type: 'number', label: 'Max' },\n    step: { type: 'number', default: 1, label: 'Step' },\n    removeOnDecrement: { type: 'boolean', default: false, label: 'Remove On Decrement' },\n    validationMessage: { type: 'string', default: 'Quantity adjusted to {value}.', label: 'Validation Message' },\n  },\n  actions: { cart: ['increaseQuantity', 'decreaseQuantity', 'removeItem'] },\n  guideline:\n    \"Quantity stepper for a cart item, shown in the unit the merchant sells in: the displayed amount is the line's quantity times its unit multiplier, so a SKU sold in 500 g portions reads 1.5 rather than 3. min, max, and step are configured in purchasable units and converted for display, so one template serves SKUs with different multipliers. A typed amount that is out of bounds or off the multiplier grid snaps to the nearest valid value on commit and renders validationMessage. Set removeOnDecrement=true to remove the item when quantity reaches the minimum. Renders nothing on a gift line — a gift's quantity is promotion-controlled and cannot be stepped or removed, so use CartItemQuantityValue to show a gift's fixed quantity. Must be inside CartItemRoot. See cart-item.md.\",\n});\n\nexport const CartItemQuantityValueDefinition = defineComponent<CartItemQuantityValueProps>({\n  name: 'CartItemQuantityValue',\n  importPath: '@vtex/faststore/components',\n  component: CartItemQuantityValue,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Quantity Value', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the read-only quantity count of the cart item as text (e.g. a \"Qty\" badge). Distinct from the editable CartItemQuantity stepper. Must be inside CartItemRoot.',\n});\n\nexport const CartItemRemoveDefinition = defineComponent<CartItemRemoveProps>({\n  name: 'CartItemRemove',\n  importPath: '@vtex/faststore/components',\n  component: CartItemRemove,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Remove', category: 'commerce' },\n  schema: {},\n  actions: { cart: ['removeItem'] },\n  guideline:\n    'Button that removes the current line item from the cart. Must be inside CartItemRoot. Also composes inside CartItemUnavailable as a remove-on-alert control. See cart-item.md.',\n});\n\nexport const CartItemAvailableDefinition = defineComponent<CartItemAvailableProps>({\n  name: 'CartItemAvailable',\n  importPath: '@vtex/faststore/components',\n  component: CartItemAvailable,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Available', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders its children only when the current cart item is in stock (availability AVAILABLE). Wrap price, quantity stepper, and line total so they hide for unavailable items. Must be inside CartItemRoot.',\n});\n\nexport const CartItemUnavailableDefinition = defineComponent<CartItemUnavailableProps>({\n  name: 'CartItemUnavailable',\n  importPath: '@vtex/faststore/components',\n  component: CartItemUnavailable,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Unavailable', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Status badge shown only when the current cart item is NOT available. Renders a built-in English label per state (OUT_OF_STOCK → \"Out of stock\", UNAVAILABLE → \"Cannot be delivered\", otherwise \"Unavailable\"); pass children to override the text — children REPLACE the label, so a remove-on-alert composition nests an explicit label plus a CartItemRemove. Emits data-fs-cart-item-unavailable-state for per-state styling. Must be inside CartItemRoot. See cart-item.md.',\n});\n\nexport const CartItemGiftDefinition = defineComponent<CartItemGiftProps>({\n  name: 'CartItemGift',\n  importPath: '@vtex/faststore/components',\n  component: CartItemGift,\n  requiresContext: 'cart-item-data',\n  editor: { label: 'Cart Item Gift', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Free marker for a promotional gift line: renders only when the current cart item is a gift, showing a built-in \"Free\" label; pass children to override the text — children REPLACE the label. Place it beside CartItemPrice/CartItemListPrice, whose struck-through list price it complements. It is an inline marker, not a wrapper for a gift-only subtree. On a gift line CartItemRemove suppresses itself and CartItemRoot marks the row with data-fs-cart-item-gift-line, so neither needs composing differently. Must be inside CartItemRoot. See cart-item.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\nexport function CartItemRoot({ $data: $dataProp, className, children, ...props }: CartItemRootProps) {\n  // Read the resolved per-line slice through the DataOverrideContext seam the reactive-list-item\n  // wrapper publishes (or via $data in tests), then re-provide it to the core particles — the same\n  // \"read my slice, then provide React context to descendants\" shape CartRoot uses for the cart.\n  const slice = useDataOverride<CartItemEntity | null | undefined>($dataProp) ?? null;\n\n  return (\n    <CartItemContext value={slice}>\n      <div\n        {...props}\n        className={className}\n        data-fs-cart-item-root=\"\"\n        {...(slice?.gift ? { 'data-fs-cart-item-gift-line': '' } : {})}\n      >\n        {children}\n      </div>\n    </CartItemContext>\n  );\n}\n\nexport function CartItemImage({ className, objectFit = 'contain', ...props }: CartItemImageProps) {\n  const item = useCartItem();\n  const image = item.variant.image;\n\n  if (!image) return null;\n\n  return (\n    // biome-ignore lint/performance/noImgElement: Cart item image URL is dynamic; matter stays Next-agnostic.\n    <img\n      {...props}\n      src={image.url}\n      alt={image.altText ?? item.variant.name}\n      className={className}\n      style={{ objectFit, ...props.style }}\n      data-fs-cart-item-image=\"\"\n      data-fs-image=\"\"\n    />\n  );\n}\n\nexport function CartItemProductLink({ className, children, ...props }: Readonly<CartItemProductLinkProps>) {\n  const item = useCartItem();\n  // The particle gates only CMS-authored destinations, so a platform URL arriving on the `href` prop\n  // is this leaf's own to validate. `detailUrl` is `String!`, which excludes null but not an empty or\n  // hostile value. Either way the leaf degrades to a passthrough rather than self-hiding the way the\n  // data-bearing leaves do: returning null would take the image with it.\n  const destination = resolveSafeHref(item.product.detailUrl);\n\n  if (!destination.safe) {\n    // A blank URL is ordinary, so it stays quiet. Anything else was actively refused, and the reason\n    // is logged the way the particle logs a refused authored destination — never the value itself.\n    if (destination.reason !== 'blank') {\n      console.warn('[CartItemProductLink] product URL rejected', { reason: destination.reason });\n    }\n    return children;\n  }\n\n  // The anchor is named by the wrapped image's alt text (`altText ?? variant.name`). With no image\n  // there is nothing to render or name; with a blank alt the anchor would be a focus stop with no\n  // accessible name. Either way, degrade to the unwrapped children rather than emit an unnamed link.\n  const image = item.variant.image;\n  if (!image || !(image.altText ?? item.variant.name ?? '').trim()) return children;\n\n  return (\n    <NavigationLink {...props} href={destination.href} className={className} data-fs-cart-item-product-link=\"\">\n      {children}\n    </NavigationLink>\n  );\n}\n\nexport function CartItemName({ className, children, ...props }: CartItemNameProps) {\n  const item = useCartItem();\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-name=\"\" data-fs-text=\"\">\n      {children ?? item.product.title}\n    </span>\n  );\n}\n\nexport function CartItemVariant({ className, children, ...props }: CartItemVariantProps) {\n  const item = useCartItem();\n  const { name } = item.variant;\n  if (!name) return null;\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-variant=\"\">\n      {children ?? name}\n    </span>\n  );\n}\n\nexport function CartItemSku({ className, children, ...props }: CartItemSkuProps) {\n  const item = useCartItem();\n  const { sku } = item.variant;\n  if (!sku) return null;\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-sku=\"\">\n      {children ?? sku}\n    </span>\n  );\n}\n\nexport function CartItemPrice({ className, children, ...props }: CartItemPriceProps) {\n  const item = useCartItem();\n  const { locale, currency } = useStorefrontContext();\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-price=\"\" data-fs-text=\"\">\n      {children ?? formatPrice(item.sellingPrice.amount, locale, currency)}\n    </span>\n  );\n}\n\nexport function CartItemListPrice({ className, children, ...props }: CartItemListPriceProps) {\n  const item = useCartItem();\n  const { locale, currency } = useStorefrontContext();\n\n  if (item.listPrice.amount <= item.sellingPrice.amount) {\n    return null;\n  }\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-list-price=\"\" data-fs-text=\"\">\n      {children ?? formatPrice(item.listPrice.amount, locale, currency)}\n    </span>\n  );\n}\n\nexport function CartItemDiscountPercentage({\n  template = '-{percentage}%',\n  className,\n  children,\n  ...props\n}: CartItemDiscountPercentageProps) {\n  const item = useCartItem();\n\n  const listPrice = Number(item.listPrice.amount);\n  const sellingPrice = Number(item.sellingPrice.amount);\n\n  if (listPrice <= sellingPrice) {\n    return null;\n  }\n\n  const percent = Math.round(((listPrice - sellingPrice) / listPrice) * 100);\n  const text = template.replaceAll('{percentage}', String(percent));\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-discount-percentage=\"\" data-fs-text=\"\">\n      {children ?? text}\n    </span>\n  );\n}\n\nexport function CartItemLineTotal({ className, children, ...props }: CartItemLineTotalProps) {\n  const item = useCartItem();\n  const { locale, currency } = useStorefrontContext();\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-line-total=\"\">\n      {children ?? formatPrice(item.sellingPrice.amount * item.quantity, locale, currency)}\n    </span>\n  );\n}\n\nexport function CartItemOwnTotal({ className, children, ...props }: CartItemOwnTotalProps) {\n  const item = useCartItem();\n  const { locale, currency } = useStorefrontContext();\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-own-total=\"\" data-fs-text=\"\">\n      {children ?? formatPrice(Number(item.ownTotal.amount), locale, currency)}\n    </span>\n  );\n}\n\nexport function CartItemAggregateTotal({ className, children, ...props }: CartItemAggregateTotalProps) {\n  const item = useCartItem();\n  const { locale, currency } = useStorefrontContext();\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-aggregate-total=\"\" data-fs-text=\"\">\n      {children ?? formatPrice(Number(item.total.amount), locale, currency)}\n    </span>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Quantity stepper — the unit multiplier converts between the purchasable count the order form and\n// the cart mutations use, and the measure the merchant sells in. `1` is the identity, so a SKU sold\n// by the unit behaves exactly as it did before the multiplier was read.\n// ---------------------------------------------------------------------------\n\n/** Why a committed amount had to be corrected; drives both the notice and its styling hook. */\ntype QuantityAdjustment = { reason: 'min' | 'max' | 'multiple'; value: number };\n\nconst MAX_DISPLAY_DECIMALS = 6;\n\n/**\n * A multiplier the platform cannot sell in — zero, negative, or non-finite — is treated as `1`, which\n * is also the fallback when the optional slice is absent (the stepper composed with no own provider).\n */\nfunction effectiveMultiplier(slice: CartItemQuantitySlice | null | undefined): number {\n  const multiplier = slice?.variant?.unitMultiplier ?? 1;\n  return Number.isFinite(multiplier) && multiplier > 0 ? multiplier : 1;\n}\n\n/**\n * Precision of the multiplier, so a displayed amount never carries binary-representation noise.\n * Derived through `toFixed` rather than `String`: `String` switches to exponential notation below\n * 1e-6, where it carries no decimal point and would report zero places, yielding a step of 0 that no\n * control can move. The normal-path precisions (0.5, 0.1, 0.333) are covered by tests; the\n * exponential branch is not, since it needs a multiplier no SKU can have.\n */\nfunction decimalPlacesOf(multiplier: number): number {\n  const [, decimals = ''] = multiplier.toFixed(MAX_DISPLAY_DECIMALS).split('.');\n  // Trailing zeros carry no precision; strip them with a linear scan rather than a `/0+$/` regex,\n  // which SonarQube flags as super-linear (harmless here — the input is a bounded toFixed string).\n  let end = decimals.length;\n  while (end > 0 && decimals[end - 1] === '0') end -= 1;\n  return end;\n}\n\nfunction roundTo(value: number, decimals: number): number {\n  return Number(value.toFixed(decimals));\n}\n\nfunction resolveAdjustment(\n  entered: number,\n  snappedDisplay: number,\n  multiplier: number,\n  minDisplay: number,\n  maxDisplay: number | undefined,\n): QuantityAdjustment | null {\n  if (maxDisplay != null && entered > maxDisplay) return { reason: 'max', value: snappedDisplay };\n  if (entered < minDisplay) return { reason: 'min', value: snappedDisplay };\n  // Tolerance is relative to the multiplier, so recovering the count through a division never reads\n  // as an off-grid entry.\n  if (Math.abs(entered - snappedDisplay) > multiplier * 1e-6) return { reason: 'multiple', value: snappedDisplay };\n  return null;\n}\n\nexport function CartItemQuantity({\n  className,\n  children,\n  min = 1,\n  max,\n  step,\n  removeOnDecrement,\n  validationMessage = 'Quantity adjusted to {value}.',\n  $data: $dataProp,\n  $actions,\n  ...props\n}: CartItemQuantityProps) {\n  const item = useCartItem();\n  const slice = useDataOverride<CartItemQuantitySlice | null | undefined>($dataProp);\n  const [adjustment, setAdjustment] = useState<QuantityAdjustment | null>(null);\n\n  // A gift line has no interactive quantity control, the same way CartItemRemove has no remove\n  // control: a promotion-controlled quantity the shopper cannot validly change, and — with\n  // removeOnDecrement — a path that would otherwise dispatch removeItem on a gift, discarding a\n  // benefit T6 already sealed off from the remove button. Suppressing the stepper closes that path\n  // under any composition. A store showing a gift's fixed quantity composes CartItemQuantityValue.\n  if (item.gift) return null;\n\n  const cart = $actions?.cart;\n\n  const multiplier = effectiveMultiplier(slice);\n  const decimals = decimalPlacesOf(multiplier);\n  // min, max, and step are counts of purchasable units, and a cart line holds a whole number of\n  // them, so a fractional bound has no valid value to land on. Left unrounded, a fractional `min` or\n  // `max` becomes the clamp result and leaks into the delta — `decreaseQuantity({ by: 2.5 })` — which\n  // the cart mutations reject. Rounding all three keeps every reachable value, and every dispatched\n  // delta, an integer.\n  const stepUnits = Math.max(1, Math.round(step ?? 1));\n  const minUnits = Math.round(min);\n  const maxUnits = max == null ? undefined : Math.round(max);\n  const displayStep = roundTo(stepUnits * multiplier, decimals);\n  const minDisplay = roundTo(minUnits * multiplier, decimals);\n  const maxDisplay = maxUnits == null ? undefined : roundTo(maxUnits * multiplier, decimals);\n\n  // Commit rather than change: `onValueChange` fires per parseable keystroke, so enforcing there\n  // writes to the cart for every digit typed and snaps a value the shopper has not finished entering.\n  function handleValueCommitted(value: number | null) {\n    if (value == null) return;\n\n    if (removeOnDecrement && value < minDisplay) {\n      setAdjustment(null);\n      void cart?.removeItem?.({ id: item.id });\n      return;\n    }\n\n    const snapped = Math.min(Math.max(Math.round(value / multiplier), minUnits), maxUnits ?? Number.POSITIVE_INFINITY);\n    const snappedDisplay = roundTo(snapped * multiplier, decimals);\n    setAdjustment(resolveAdjustment(value, snappedDisplay, multiplier, minDisplay, maxDisplay));\n\n    const delta = snapped - item.quantity;\n    if (delta > 0) {\n      void cart?.increaseQuantity?.({ id: item.id, by: delta });\n    } else if (delta < 0) {\n      void cart?.decreaseQuantity?.({ id: item.id, by: -delta });\n    }\n  }\n\n  const effectiveMin = removeOnDecrement ? 0 : minDisplay;\n  const computedClassName = removeOnDecrement ? (className ? `group ${className}` : 'group') : className;\n\n  return (\n    <BaseNumberField.Root\n      {...props}\n      value={roundTo(item.quantity * multiplier, decimals)}\n      onValueCommitted={handleValueCommitted}\n      // A shopper editing the field again makes the previous correction stale, so it is dropped as\n      // soon as they type. Step and scrub reasons are excluded: those land on the grid by\n      // construction and never raise a notice, so clearing on them would be dead code.\n      onValueChange={(_value, details) => {\n        if (details.reason === 'input-change' || details.reason === 'input-paste' || details.reason === 'input-clear') {\n          setAdjustment(null);\n        }\n      }}\n      min={effectiveMin}\n      max={maxDisplay}\n      step={displayStep}\n      smallStep={displayStep}\n      largeStep={roundTo(displayStep * 10, decimals)}\n      snapOnStep\n      // Base UI clamps text entry to min/max on its own, which would correct an out-of-bounds amount\n      // before this component ever saw it — and a correction nobody can observe cannot be explained.\n      allowOutOfRange\n      className={computedClassName}\n      data-fs-cart-item-quantity=\"\"\n      {...(multiplier === 1 ? {} : { 'data-fs-cart-item-quantity-multiplier': String(multiplier) })}\n      {...(adjustment\n        ? {\n            'data-fs-cart-item-quantity-adjusted': '',\n            'data-fs-cart-item-quantity-adjusted-reason': adjustment.reason,\n          }\n        : {})}\n      {...(removeOnDecrement && item.quantity <= minUnits ? { 'data-fs-cart-item-at-min': '' } : {})}\n    >\n      {children}\n      {adjustment ? (\n        <div role=\"alert\" data-fs-cart-item-quantity-validation=\"\">\n          {validationMessage.replaceAll('{value}', String(adjustment.value))}\n        </div>\n      ) : null}\n    </BaseNumberField.Root>\n  );\n}\n\nexport function CartItemQuantityValue({ className, children, ...props }: CartItemQuantityValueProps) {\n  const item = useCartItem();\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-quantity-value=\"\">\n      {children ?? String(item.quantity)}\n    </span>\n  );\n}\n\nexport function CartItemRemove({ className, children, onClick, $actions, ...props }: CartItemRemoveProps) {\n  const item = useCartItem();\n\n  // A gift line has no remove control: the promotion granted the item, and this phase does not let a\n  // shopper discard it. Suppressed here rather than by composition, because CartList renders one\n  // template for every line — an author cannot leave the leaf out of gift rows alone. Covers the\n  // remove-on-alert composition too; an unavailable gift is recovered by the cart-level\n  // CartRemoveUnavailable batch and by server-side cart validation.\n  if (item.gift) return null;\n\n  function handleClick(e: React.MouseEvent<HTMLButtonElement>) {\n    void $actions?.cart?.removeItem?.({ id: item.id });\n    onClick?.(e);\n  }\n\n  return (\n    <button\n      {...props}\n      type=\"button\"\n      className={className}\n      onClick={handleClick}\n      data-fs-cart-item-remove=\"\"\n      data-fs-button=\"\"\n    >\n      {children}\n    </button>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Availability gates — read `variant.availability` from the core slice (F4).\n// UNKNOWN and any future non-available state fall back to the generic \"Unavailable\".\n// ---------------------------------------------------------------------------\n\nconst UNAVAILABLE_LABELS: Record<string, string> = {\n  OUT_OF_STOCK: 'Out of stock',\n  UNAVAILABLE: 'Cannot be delivered',\n};\n\nfunction unavailableLabel(availability: string): string {\n  return UNAVAILABLE_LABELS[availability] ?? 'Unavailable';\n}\n\nexport function CartItemAvailable({ className, children, ...props }: CartItemAvailableProps) {\n  const item = useCartItem();\n  if (item.variant.availability !== 'AVAILABLE') return null;\n\n  return (\n    <div {...props} className={className} data-fs-cart-item-available=\"\">\n      {children}\n    </div>\n  );\n}\n\nexport function CartItemUnavailable({ className, children, ...props }: CartItemUnavailableProps) {\n  const item = useCartItem();\n  const { availability } = item.variant;\n  if (availability === 'AVAILABLE') return null;\n\n  return (\n    <div\n      {...props}\n      className={className}\n      data-fs-cart-item-unavailable=\"\"\n      data-fs-cart-item-unavailable-state={availability.toLowerCase()}\n    >\n      {children ?? unavailableLabel(availability)}\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// F9 — gift marker. Inline, so `children` override the label rather than nesting a subtree; a gift\n// row's other needs are met by the row's own `data-fs-cart-item-gift-line` hook. \"Free\" is\n// operational copy, so it ships as a built-in default like the unavailability labels above, and moves\n// to the localization catalog rather than to a content model.\n// ---------------------------------------------------------------------------\n\nexport function CartItemGift({ className, children, ...props }: CartItemGiftProps) {\n  const item = useCartItem();\n  if (!item.gift) return null;\n\n  return (\n    <span {...props} className={className} data-fs-cart-item-gift=\"\" data-fs-text=\"\">\n      {children ?? 'Free'}\n    </span>\n  );\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,49 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/cart-item-compositions/cart-item-compositions.d.ts
+export type CartItemCustomizationEntryView = {
+  name: string;
+  value: string;
+};
+export type CartItemCustomizationView = {
+  id: string;
+  entries: CartItemCustomizationEntryView[];
+};
+export type CartItemCompositionView = {
+  id: string;
+  name: string;
+  quantity: number;
+  price: {
+    amount: number;
+    currencyCode: string;
+  };
+  ownTotal: {
+    amount: number;
+    currencyCode: string;
+  };
+  total: {
+    amount: number;
+    currencyCode: string;
+  };
+  availability: string;
+  assemblyId: string;
+  customizations: CartItemCustomizationView[];
+  compositions?: CartItemCompositionView[];
+};
+/**
+ * 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 CartItemCompositionsSlice = {
+  compositions: CartItemCompositionView[];
+};
+export type CartItemCompositionsProps = ComponentPropsWithRef<'div'> & {
+  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */
+  $data?: CartItemCompositionsSlice | null;
+};
+export declare const CartItemCompositionsDefinition: ComponentDefinition<CartItemCompositionsProps>;
+export declare function CartItemCompositions({ className, $data: $dataProp, ...props }: CartItemCompositionsProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=cart-item-compositions.d.ts.map

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

@@ -0,0 +1,165 @@
+"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 { formatPrice } from "../cart/cart.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/cart-item-compositions/cart-item-compositions.tsx
+const cartItemCompositionsFragment = graphql(`
+  fragment CartItemCompositionsData on Query {
+    cart {
+      items {
+        __typename
+        id
+        compositions {
+          id
+          name
+          quantity
+          price {
+            ...MoneyFragment
+          }
+          availability
+          assemblyId
+          ownTotal {
+            ...MoneyFragment
+          }
+          total {
+            ...MoneyFragment
+          }
+          customizations {
+            id
+            entries {
+              name
+              value
+            }
+          }
+          compositions {
+            id
+            name
+            quantity
+            price {
+              ...MoneyFragment
+            }
+            availability
+            assemblyId
+            ownTotal {
+              ...MoneyFragment
+            }
+            total {
+              ...MoneyFragment
+            }
+            customizations {
+              id
+              entries {
+                name
+                value
+              }
+            }
+            compositions {
+              id
+              name
+              quantity
+              price {
+                ...MoneyFragment
+              }
+              availability
+              assemblyId
+              ownTotal {
+                ...MoneyFragment
+              }
+              total {
+                ...MoneyFragment
+              }
+              customizations {
+                id
+                entries {
+                  name
+                  value
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`);
+const CartItemCompositionsDefinition = defineComponent({
+	name: "CartItemCompositions",
+	importPath: "@vtex/faststore/components",
+	component: CartItemCompositions,
+	fragment: cartItemCompositionsFragment,
+	fetchStrategy: "reactive-list-item",
+	requiresContext: "cart-item",
+	editor: {
+		label: "Cart Item Compositions",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders the nested bundle/assembly tree a shopper built under a cart line — each child shows name, quantity, unit price, and its own customizations, recursing on nested children; renders null when the line has none. Must be inside CartList. See cart-item.md."
+});
+function CustomizationGroups({ customizations }) {
+	if (customizations.length === 0) return null;
+	return /* @__PURE__ */ jsx(Fragment, { children: customizations.map((group) => /* @__PURE__ */ jsxs("div", {
+		"data-fs-cart-item-customization": "",
+		"data-fs-cart-item-customization-id": group.id,
+		children: [/* @__PURE__ */ jsx("span", {
+			"data-fs-cart-item-customization-label": "",
+			"data-fs-text": "",
+			children: group.id
+		}), group.entries.map((entry, index) => /* @__PURE__ */ jsxs("span", {
+			"data-fs-cart-item-customization-entry": "",
+			"data-fs-text": "",
+			children: [/* @__PURE__ */ jsx("span", {
+				"data-fs-cart-item-customization-name": "",
+				children: entry.name
+			}), /* @__PURE__ */ jsx("span", {
+				"data-fs-cart-item-customization-value": "",
+				children: entry.value
+			})]
+		}, `${entry.name}-${index}`))]
+	}, group.id)) });
+}
+function CartItemCompositions({ className, $data: $dataProp, ...props }) {
+	const slice = useDataOverride($dataProp);
+	const { locale, currency } = useStorefrontContext();
+	const compositions = slice?.compositions;
+	if (!compositions || compositions.length === 0) return null;
+	function renderComposition(node, depth) {
+		return /* @__PURE__ */ jsxs("div", {
+			"data-fs-cart-item-composition": "",
+			"data-fs-cart-item-composition-depth": depth,
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-composition-name": "",
+					"data-fs-text": "",
+					children: node.name
+				}),
+				/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-composition-quantity": "",
+					"data-fs-text": "",
+					children: `×${node.quantity}`
+				}),
+				/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-composition-price": "",
+					"data-fs-text": "",
+					children: formatPrice(Number(node.price.amount), locale, currency)
+				}),
+				/* @__PURE__ */ jsx(CustomizationGroups, { customizations: node.customizations }),
+				(node.compositions ?? []).map((child) => renderComposition(child, depth + 1))
+			]
+		}, node.id);
+	}
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-item-compositions": "",
+		children: compositions.map((node) => renderComposition(node, 0))
+	});
+}
+//#endregion
+export { CartItemCompositions, CartItemCompositionsDefinition };
+
+//# sourceMappingURL=cart-item-compositions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-item-compositions.js","names":[],"sources":["../../../src/matter/cart-item-compositions/cart-item-compositions.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\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 { formatPrice } from '../cart/cart.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type CartItemCustomizationEntryView = { name: string; value: string };\n\nexport type CartItemCustomizationView = { id: string; entries: CartItemCustomizationEntryView[] };\n\nexport type CartItemCompositionView = {\n  id: string;\n  name: string;\n  quantity: number;\n  price: { amount: number; currencyCode: string };\n  ownTotal: { amount: number; currencyCode: string };\n  total: { amount: number; currencyCode: string };\n  availability: string;\n  assemblyId: string;\n  customizations: CartItemCustomizationView[];\n  // Recursive; the fragment inlines this selection to 3 levels, so a node at the deepest fetched\n  // level has no `compositions` sub-selection and the field is `undefined` at runtime.\n  compositions?: CartItemCompositionView[];\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 CartItemCompositionsSlice = {\n  compositions: CartItemCompositionView[];\n};\n\nexport type CartItemCompositionsProps = ComponentPropsWithRef<'div'> & {\n  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */\n  $data?: CartItemCompositionsSlice | null;\n};\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset\n// ---------------------------------------------------------------------------\n\n// ADR-0011: CartItemCompositions is a per-item sub-matter that OWNS its (optional) compositions data.\n// Decomposed out of the monolithic CartItemFragment, the compositions 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// `CartItemCompositionsData_CartItem on CartItem`. The recursive `compositions` selection is inlined to\n// a pragmatic depth (GraphQL selection sets cannot self-reference); the server guards cycles (836\n// visited-index) and depth is bounded by the assembly config.\nconst cartItemCompositionsFragment = graphql(`\n  fragment CartItemCompositionsData on Query {\n    cart {\n      items {\n        __typename\n        id\n        compositions {\n          id\n          name\n          quantity\n          price {\n            ...MoneyFragment\n          }\n          availability\n          assemblyId\n          ownTotal {\n            ...MoneyFragment\n          }\n          total {\n            ...MoneyFragment\n          }\n          customizations {\n            id\n            entries {\n              name\n              value\n            }\n          }\n          compositions {\n            id\n            name\n            quantity\n            price {\n              ...MoneyFragment\n            }\n            availability\n            assemblyId\n            ownTotal {\n              ...MoneyFragment\n            }\n            total {\n              ...MoneyFragment\n            }\n            customizations {\n              id\n              entries {\n                name\n                value\n              }\n            }\n            compositions {\n              id\n              name\n              quantity\n              price {\n                ...MoneyFragment\n              }\n              availability\n              assemblyId\n              ownTotal {\n                ...MoneyFragment\n              }\n              total {\n                ...MoneyFragment\n              }\n              customizations {\n                id\n                entries {\n                  name\n                  value\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const CartItemCompositionsDefinition = defineComponent<CartItemCompositionsProps>({\n  name: 'CartItemCompositions',\n  importPath: '@vtex/faststore/components',\n  component: CartItemCompositions,\n  fragment: cartItemCompositionsFragment,\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 Compositions', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the nested bundle/assembly tree a shopper built under a cart line — each child shows name, quantity, unit price, and its own customizations, recursing on nested children; renders null when the line has none. Must be inside CartList. See cart-item.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Shared customization-row renderer, co-located per single-file-matter convention. Renders the same\n// name/value anatomy as CartItemCustomizations so one compound swatch styles both surfaces. Not\n// imported from that matter — coupling two matters' data ownership/fragments is avoided (836 Decision 3).\nfunction CustomizationGroups({ customizations }: { customizations: CartItemCustomizationView[] }) {\n  if (customizations.length === 0) return null;\n\n  return (\n    <>\n      {customizations.map((group) => (\n        <div key={group.id} data-fs-cart-item-customization=\"\" data-fs-cart-item-customization-id={group.id}>\n          <span data-fs-cart-item-customization-label=\"\" data-fs-text=\"\">\n            {group.id}\n          </span>\n          {group.entries.map((entry, index) => (\n            <span key={`${entry.name}-${index}`} data-fs-cart-item-customization-entry=\"\" data-fs-text=\"\">\n              <span data-fs-cart-item-customization-name=\"\">{entry.name}</span>\n              <span data-fs-cart-item-customization-value=\"\">{entry.value}</span>\n            </span>\n          ))}\n        </div>\n      ))}\n    </>\n  );\n}\n\nexport function CartItemCompositions({ className, $data: $dataProp, ...props }: CartItemCompositionsProps) {\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<CartItemCompositionsSlice | null | undefined>($dataProp);\n  const { locale, currency } = useStorefrontContext();\n  const compositions = slice?.compositions;\n\n  if (!compositions || compositions.length === 0) {\n    return null;\n  }\n\n  // Recursion is over finite in-slice data (the server guarantees acyclic compositions): render the\n  // node's row (name, quantity, unit price), its own customizations (836 Decision 8), then recurse\n  // over its nested children at depth + 1. React keys use the node id.\n  function renderComposition(node: CartItemCompositionView, depth: number) {\n    return (\n      <div key={node.id} data-fs-cart-item-composition=\"\" data-fs-cart-item-composition-depth={depth}>\n        <span data-fs-cart-item-composition-name=\"\" data-fs-text=\"\">\n          {node.name}\n        </span>\n        <span data-fs-cart-item-composition-quantity=\"\" data-fs-text=\"\">\n          {`×${node.quantity}`}\n        </span>\n        <span data-fs-cart-item-composition-price=\"\" data-fs-text=\"\">\n          {formatPrice(Number(node.price.amount), locale, currency)}\n        </span>\n        <CustomizationGroups customizations={node.customizations} />\n        {(node.compositions ?? []).map((child) => renderComposition(child, depth + 1))}\n      </div>\n    );\n  }\n\n  return (\n    <div {...props} className={className} data-fs-cart-item-compositions=\"\">\n      {compositions.map((node) => renderComposition(node, 0))}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAyDA,MAAM,+BAA+B,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E5C;AAMD,MAAa,iCAAiC,gBAA2C;CACvF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,UAAU;CACV,eAAe;CAGf,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA0B,UAAU;CAAW;CAChE,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AASD,SAAS,oBAAoB,EAAE,kBAAmE;CAChG,IAAI,eAAe,WAAW,GAAG,OAAO;CAExC,OACE,oBAAA,UAAA,EAAA,UACG,eAAe,KAAK,UACnB,qBAAC,OAAD;EAAoB,mCAAgC;EAAG,sCAAoC,MAAM;EAAjG,UAAA,CACE,oBAAC,QAAD;GAAM,yCAAsC;GAAG,gBAAa;GACzD,UAAA,MAAM;EACH,CAAA,GACL,MAAM,QAAQ,KAAK,OAAO,UACzB,qBAAC,QAAD;GAAqC,yCAAsC;GAAG,gBAAa;GAA3F,UAAA,CACE,oBAAC,QAAD;IAAM,wCAAqC;IAAI,UAAA,MAAM;GAAW,CAAA,GAChE,oBAAC,QAAD;IAAM,yCAAsC;IAAI,UAAA,MAAM;GAAY,CAAA,CAC9D;EAHK,GAAA,GAAG,MAAM,KAAK,GAAG,OAGtB,CACP,CACE;CAVK,GAAA,MAAM,EAUX,CACN,EACD,CAAA;AAEN;AAEA,SAAgB,qBAAqB,EAAE,WAAW,OAAO,WAAW,GAAG,SAAoC;CAGzG,MAAM,QAAQ,gBAA8D,SAAS;CACrF,MAAM,EAAE,QAAQ,aAAa,qBAAqB;CAClD,MAAM,eAAe,OAAO;CAE5B,IAAI,CAAC,gBAAgB,aAAa,WAAW,GAC3C,OAAO;CAMT,SAAS,kBAAkB,MAA+B,OAAe;EACvE,OACE,qBAAC,OAAD;GAAmB,iCAA8B;GAAG,uCAAqC;GAAzF,UAAA;IACE,oBAAC,QAAD;KAAM,sCAAmC;KAAG,gBAAa;KACtD,UAAA,KAAK;IACF,CAAA;IACN,oBAAC,QAAD;KAAM,0CAAuC;KAAG,gBAAa;KAC1D,UAAA,IAAI,KAAK;IACN,CAAA;IACN,oBAAC,QAAD;KAAM,uCAAoC;KAAG,gBAAa;KACvD,UAAA,YAAY,OAAO,KAAK,MAAM,MAAM,GAAG,QAAQ,QAAQ;IACpD,CAAA;IACN,oBAAC,qBAAD,EAAqB,gBAAgB,KAAK,eAAiB,CAAA;KACzD,KAAK,gBAAgB,CAAC,EAAA,CAAG,KAAK,UAAU,kBAAkB,OAAO,QAAQ,CAAC,CAAC;GAC1E;EAZK,GAAA,KAAK,EAYV;CAET;CAEA,OACE,oBAAC,OAAD;EAAK,GAAI;EAAkB;EAAW,kCAA+B;EAClE,UAAA,aAAa,KAAK,SAAS,kBAAkB,MAAM,CAAC,CAAC;CACnD,CAAA;AAET"}

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

@@ -0,0 +1,28 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/cart-item-customizations/cart-item-customizations.d.ts
+export type CartItemCustomizationEntryView = {
+  name: string;
+  value: string;
+};
+export type CartItemCustomizationView = {
+  id: string;
+  entries: CartItemCustomizationEntryView[];
+};
+/**
+ * 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 CartItemCustomizationsSlice = {
+  customizations: CartItemCustomizationView[];
+};
+export type CartItemCustomizationsProps = ComponentPropsWithRef<'div'> & {
+  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */
+  $data?: CartItemCustomizationsSlice | null;
+};
+export declare const CartItemCustomizationsDefinition: ComponentDefinition<CartItemCustomizationsProps>;
+export declare function CartItemCustomizations({ className, $data: $dataProp, ...props }: CartItemCustomizationsProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=cart-item-customizations.d.ts.map

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

@@ -0,0 +1,73 @@
+"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 { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/cart-item-customizations/cart-item-customizations.tsx
+const cartItemCustomizationsFragment = graphql(`
+  fragment CartItemCustomizationsData on Query {
+    cart {
+      items {
+        __typename
+        id
+        customizations {
+          id
+          entries {
+            name
+            value
+          }
+        }
+      }
+    }
+  }
+`);
+const CartItemCustomizationsDefinition = defineComponent({
+	name: "CartItemCustomizations",
+	importPath: "@vtex/faststore/components",
+	component: CartItemCustomizations,
+	fragment: cartItemCustomizationsFragment,
+	fetchStrategy: "reactive-list-item",
+	requiresContext: "cart-item",
+	editor: {
+		label: "Cart Item Customizations",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders the form-based customizations a shopper applied to a cart line (e.g. \"Text: MARIA\"), one group per assembly; renders null when the line has none. Must be inside CartList. See cart-item.md."
+});
+function CustomizationGroups({ customizations }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: customizations.map((group) => /* @__PURE__ */ jsxs("div", {
+		"data-fs-cart-item-customization": "",
+		"data-fs-cart-item-customization-id": group.id,
+		children: [/* @__PURE__ */ jsx("span", {
+			"data-fs-cart-item-customization-label": "",
+			"data-fs-text": "",
+			children: group.id
+		}), group.entries.map((entry, index) => /* @__PURE__ */ jsxs("span", {
+			"data-fs-cart-item-customization-entry": "",
+			"data-fs-text": "",
+			children: [/* @__PURE__ */ jsx("span", {
+				"data-fs-cart-item-customization-name": "",
+				children: entry.name
+			}), /* @__PURE__ */ jsx("span", {
+				"data-fs-cart-item-customization-value": "",
+				children: entry.value
+			})]
+		}, `${entry.name}-${index}`))]
+	}, group.id)) });
+}
+function CartItemCustomizations({ className, $data: $dataProp, ...props }) {
+	const customizations = useDataOverride($dataProp)?.customizations;
+	if (!customizations || customizations.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-cart-item-customizations": "",
+		children: /* @__PURE__ */ jsx(CustomizationGroups, { customizations })
+	});
+}
+//#endregion
+export { CartItemCustomizations, CartItemCustomizationsDefinition };
+
+//# sourceMappingURL=cart-item-customizations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-item-customizations.js","names":[],"sources":["../../../src/matter/cart-item-customizations/cart-item-customizations.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// Types\n// ---------------------------------------------------------------------------\n\nexport type CartItemCustomizationEntryView = { name: string; value: string };\n\nexport type CartItemCustomizationView = { id: string; entries: CartItemCustomizationEntryView[] };\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 CartItemCustomizationsSlice = {\n  customizations: CartItemCustomizationView[];\n};\n\nexport type CartItemCustomizationsProps = ComponentPropsWithRef<'div'> & {\n  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */\n  $data?: CartItemCustomizationsSlice | null;\n};\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset\n// ---------------------------------------------------------------------------\n\n// ADR-0011: CartItemCustomizations is a per-item sub-matter that OWNS its (optional) customizations\n// data. Decomposed out of the monolithic CartItemFragment, the customizations subtree is fetched only\n// on pages that place this matter — over-fetch elimination by data ownership. The author writes one\n// uniform `on Query` fragment drilling the list; the compiler re-roots it to\n// `CartItemCustomizationsData_CartItem on CartItem`. Fields are inlined (no `...` spread on the owned\n// subtree) so the derived per-item fragment is self-contained for `useFragment`; it drills the\n// identical cart { items { ... } } path as the other per-item matters so it merges un-aliased.\nconst cartItemCustomizationsFragment = graphql(`\n  fragment CartItemCustomizationsData on Query {\n    cart {\n      items {\n        __typename\n        id\n        customizations {\n          id\n          entries {\n            name\n            value\n          }\n        }\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const CartItemCustomizationsDefinition = defineComponent<CartItemCustomizationsProps>({\n  name: 'CartItemCustomizations',\n  importPath: '@vtex/faststore/components',\n  component: CartItemCustomizations,\n  fragment: cartItemCustomizationsFragment,\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 Customizations', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the form-based customizations a shopper applied to a cart line (e.g. \"Text: MARIA\"), one group per assembly; renders null when the line has none. Must be inside CartList. See cart-item.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Shared customization-row renderer, co-located per single-file-matter convention. The identical\n// name/value anatomy is reused by CartItemCompositions for each composition child's own\n// customizations (836 Decision 8), so a single compound swatch styles both surfaces.\nfunction CustomizationGroups({ customizations }: { customizations: CartItemCustomizationView[] }) {\n  return (\n    <>\n      {customizations.map((group) => (\n        <div key={group.id} data-fs-cart-item-customization=\"\" data-fs-cart-item-customization-id={group.id}>\n          <span data-fs-cart-item-customization-label=\"\" data-fs-text=\"\">\n            {group.id}\n          </span>\n          {group.entries.map((entry, index) => (\n            <span key={`${entry.name}-${index}`} data-fs-cart-item-customization-entry=\"\" data-fs-text=\"\">\n              <span data-fs-cart-item-customization-name=\"\">{entry.name}</span>\n              <span data-fs-cart-item-customization-value=\"\">{entry.value}</span>\n            </span>\n          ))}\n        </div>\n      ))}\n    </>\n  );\n}\n\nexport function CartItemCustomizations({ className, $data: $dataProp, ...props }: CartItemCustomizationsProps) {\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<CartItemCustomizationsSlice | null | undefined>($dataProp);\n  const customizations = slice?.customizations;\n\n  if (!customizations || customizations.length === 0) {\n    return null;\n  }\n\n  return (\n    <div {...props} className={className} data-fs-cart-item-customizations=\"\">\n      <CustomizationGroups customizations={customizations} />\n    </div>\n  );\n}\n"],"mappings":";;;;;;;AAwCA,MAAM,iCAAiC,QAAQ;;;;;;;;;;;;;;;;CAgB9C;AAMD,MAAa,mCAAmC,gBAA6C;CAC3F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,UAAU;CACV,eAAe;CAGf,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA4B,UAAU;CAAW;CAClE,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AASD,SAAS,oBAAoB,EAAE,kBAAmE;CAChG,OACE,oBAAA,UAAA,EAAA,UACG,eAAe,KAAK,UACnB,qBAAC,OAAD;EAAoB,mCAAgC;EAAG,sCAAoC,MAAM;EAAjG,UAAA,CACE,oBAAC,QAAD;GAAM,yCAAsC;GAAG,gBAAa;GACzD,UAAA,MAAM;EACH,CAAA,GACL,MAAM,QAAQ,KAAK,OAAO,UACzB,qBAAC,QAAD;GAAqC,yCAAsC;GAAG,gBAAa;GAA3F,UAAA,CACE,oBAAC,QAAD;IAAM,wCAAqC;IAAI,UAAA,MAAM;GAAW,CAAA,GAChE,oBAAC,QAAD;IAAM,yCAAsC;IAAI,UAAA,MAAM;GAAY,CAAA,CAC9D;EAHK,GAAA,GAAG,MAAM,KAAK,GAAG,OAGtB,CACP,CACE;CAVK,GAAA,MAAM,EAUX,CACN,EACD,CAAA;AAEN;AAEA,SAAgB,uBAAuB,EAAE,WAAW,OAAO,WAAW,GAAG,SAAsC;CAI7G,MAAM,iBADQ,gBAAgE,SACnD,CAAC,EAAE;CAE9B,IAAI,CAAC,kBAAkB,eAAe,WAAW,GAC/C,OAAO;CAGT,OACE,oBAAC,OAAD;EAAK,GAAI;EAAkB;EAAW,oCAAiC;EACrE,UAAA,oBAAC,qBAAD,EAAqC,eAAiB,CAAA;CACnD,CAAA;AAET"}

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

@@ -0,0 +1,33 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/cart-item-discounts/cart-item-discounts.d.ts
+/**
+ * One named promotion discount on the current cart line. `value` is the absolute amount discounted
+ * (a positive `Money`); the leading `−` and the `%` sign are presentational (FSPG-835 contract).
+ * `amount` is typed `number` but is a string at runtime, so it is `Number()`-coerced before formatting.
+ */
+export type CartItemDiscountEntry = {
+  name: string;
+  value: {
+    amount: number;
+    currencyCode: string;
+  };
+  isPercentual: boolean;
+};
+/**
+ * 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 CartItemDiscountsSlice = {
+  discounts: CartItemDiscountEntry[];
+};
+export type CartItemDiscountsProps = ComponentPropsWithRef<'div'> & {
+  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */
+  $data?: CartItemDiscountsSlice | null;
+};
+export declare const CartItemDiscountsDefinition: ComponentDefinition<CartItemDiscountsProps>;
+export declare function CartItemDiscounts({ className, $data: $dataProp, ...props }: CartItemDiscountsProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=cart-item-discounts.d.ts.map

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

@@ -0,0 +1,70 @@
+"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 { formatPrice } from "../cart/cart.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/cart-item-discounts/cart-item-discounts.tsx
+const cartItemDiscountsFragment = graphql(`
+  fragment CartItemDiscountsData on Query {
+    cart {
+      items {
+        __typename
+        id
+        discounts {
+          name
+          value {
+            ...MoneyFragment
+          }
+          isPercentual
+        }
+      }
+    }
+  }
+`);
+const CartItemDiscountsDefinition = defineComponent({
+	name: "CartItemDiscounts",
+	importPath: "@vtex/faststore/components",
+	component: CartItemDiscounts,
+	fragment: cartItemDiscountsFragment,
+	fetchStrategy: "reactive-list-item",
+	requiresContext: "cart-item",
+	editor: {
+		label: "Cart Item Discounts",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders the named promotion discounts applied to a cart line (e.g. \"Black Friday −R$ 20,00\"); renders null when the line has none. Distinct from the CartItemDiscountPercentage badge. Must be inside CartList. See cart-item.md."
+});
+function CartItemDiscounts({ 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-item-discounts": "",
+		children: discounts.map((discount, index) => {
+			const amount = Number(discount.value.amount);
+			const value = discount.isPercentual ? `−${amount}%` : `−${formatPrice(amount, locale, currency)}`;
+			return /* @__PURE__ */ jsxs("span", {
+				"data-fs-cart-item-discount": "",
+				"data-fs-text": "",
+				children: [/* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-discount-name": "",
+					children: discount.name
+				}), /* @__PURE__ */ jsx("span", {
+					"data-fs-cart-item-discount-value": "",
+					children: value
+				})]
+			}, `${discount.name}-${index}`);
+		})
+	});
+}
+//#endregion
+export { CartItemDiscounts, CartItemDiscountsDefinition };
+
+//# sourceMappingURL=cart-item-discounts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-item-discounts.js","names":[],"sources":["../../../src/matter/cart-item-discounts/cart-item-discounts.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\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 { formatPrice } from '../cart/cart.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset\n// ---------------------------------------------------------------------------\n\n// ADR-0011: CartItemDiscounts is a per-item sub-matter that OWNS its (optional) discounts data.\n// Decomposed out of the monolithic CartItemFragment, the discounts 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// `CartItemDiscountsData_CartItem on CartItem`. Fields are inlined (no `...` spread on `discounts`)\n// so the 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 cartItemDiscountsFragment = graphql(`\n  fragment CartItemDiscountsData on Query {\n    cart {\n      items {\n        __typename\n        id\n        discounts {\n          name\n          value {\n            ...MoneyFragment\n          }\n          isPercentual\n        }\n      }\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * One named promotion discount on the current cart line. `value` is the absolute amount discounted\n * (a positive `Money`); the leading `−` and the `%` sign are presentational (FSPG-835 contract).\n * `amount` is typed `number` but is a string at runtime, so it is `Number()`-coerced before formatting.\n */\nexport type CartItemDiscountEntry = {\n  name: string;\n  value: { amount: number; currencyCode: string };\n  isPercentual: boolean;\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 CartItemDiscountsSlice = {\n  discounts: CartItemDiscountEntry[];\n};\n\nexport type CartItemDiscountsProps = ComponentPropsWithRef<'div'> & {\n  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */\n  $data?: CartItemDiscountsSlice | null;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const CartItemDiscountsDefinition = defineComponent<CartItemDiscountsProps>({\n  name: 'CartItemDiscounts',\n  importPath: '@vtex/faststore/components',\n  component: CartItemDiscounts,\n  fragment: cartItemDiscountsFragment,\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 Discounts', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders the named promotion discounts applied to a cart line (e.g. \"Black Friday −R$ 20,00\"); renders null when the line has none. Distinct from the CartItemDiscountPercentage badge. Must be inside CartList. See cart-item.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport function CartItemDiscounts({ className, $data: $dataProp, ...props }: CartItemDiscountsProps) {\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<CartItemDiscountsSlice | 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-item-discounts=\"\">\n      {discounts.map((discount, index) => {\n        const amount = Number(discount.value.amount);\n        const value = discount.isPercentual ? `−${amount}%` : `−${formatPrice(amount, locale, currency)}`;\n\n        return (\n          <span key={`${discount.name}-${index}`} data-fs-cart-item-discount=\"\" data-fs-text=\"\">\n            <span data-fs-cart-item-discount-name=\"\">{discount.name}</span>\n            <span data-fs-cart-item-discount-value=\"\">{value}</span>\n          </span>\n        );\n      })}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAoBA,MAAM,4BAA4B,QAAQ;;;;;;;;;;;;;;;;CAgBzC;AAmCD,MAAa,8BAA8B,gBAAwC;CACjF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,UAAU;CACV,eAAe;CAGf,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAuB,UAAU;CAAW;CAC7D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAMD,SAAgB,kBAAkB,EAAE,WAAW,OAAO,WAAW,GAAG,SAAiC;CAGnG,MAAM,QAAQ,gBAA2D,SAAS;CAClF,MAAM,EAAE,QAAQ,aAAa,qBAAqB;CAClD,MAAM,YAAY,OAAO;CAEzB,IAAI,CAAC,aAAa,UAAU,WAAW,GACrC,OAAO;CAGT,OACE,oBAAC,OAAD;EAAK,GAAI;EAAkB;EAAW,+BAA4B;EAC/D,UAAA,UAAU,KAAK,UAAU,UAAU;GAClC,MAAM,SAAS,OAAO,SAAS,MAAM,MAAM;GAC3C,MAAM,QAAQ,SAAS,eAAe,IAAI,OAAO,KAAK,IAAI,YAAY,QAAQ,QAAQ,QAAQ;GAE9F,OACE,qBAAC,QAAD;IAAwC,8BAA2B;IAAG,gBAAa;IAAnF,UAAA,CACE,oBAAC,QAAD;KAAM,mCAAgC;KAAI,UAAA,SAAS;IAAW,CAAA,GAC9D,oBAAC,QAAD;KAAM,oCAAiC;KAAI,UAAA;IAAY,CAAA,CACnD;GAHK,GAAA,GAAG,SAAS,KAAK,GAAG,OAGzB;EAEV,CAAC;CACE,CAAA;AAET"}

package/dist/matter/cart-item-seller-info/cart-item-seller-info.d.ts

@@ -0,0 +1,24 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/cart-item-seller-info/cart-item-seller-info.d.ts
+/**
+ * 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 CartItemSellerInfoSlice = {
+  variant: {
+    seller: {
+      name: string;
+    } | null;
+  } | null;
+};
+export type CartItemSellerInfoProps = ComponentPropsWithRef<'span'> & {
+  /** Per-item slice from the reactive-list-item runtime; injected/overridden by the wrapper. */
+  $data?: CartItemSellerInfoSlice | null;
+};
+export declare const CartItemSellerInfoDefinition: ComponentDefinition<CartItemSellerInfoProps>;
+export declare function CartItemSellerInfo({ className, children, $data: $dataProp, ...props }: CartItemSellerInfoProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=cart-item-seller-info.d.ts.map