@vtex/faststore 0.0.7 → 0.0.10

package/dist/matter/cardholder-document/cardholder-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"cardholder-document.js","names":[],"sources":["../../../src/matter/cardholder-document/cardholder-document.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef, Ref } from 'react';\nimport { DocumentField } from '../../particles/document-field/document-field.js';\nimport { usePayment } from '../payment/payment.js';\nimport { isCardholderDocumentShown } from '../payment/use-payment-submit-gate.js';\n\n/**\n * The cardholder-document field (specs/cardholder-document.md, T8 of the Credit Card epic;\n * docs/features/credit-card/rfc.md § D3). Renders the existing `particles/document-field`\n * `DocumentField` for CPF, gated on the *selected* payment method's validator: presence follows\n * `documentDisplayable`, requiredness follows `documentRequired` — two distinct, non-null flags\n * (T1's read model; `use-payment-method-selection.ts`'s `PaymentSectionValidator`), read off\n * `usePayment().selectedMethod` (`selectedMethodId` resolved against the scoped `methods` list,\n * carrying the full validator — specs/payment-section-root.md's contract table names T8 as the\n * consumer of exactly these two flags on that field).\n *\n * Declares no fragment of its own: T5's merged `PaymentSectionData` fragment\n * (`matter/payment/payment.tsx`) already selects both flags, so this leaf reads them off context\n * instead of re-selecting them. The shipped precedent for a context-only, fragment-less payment\n * leaf is `SavedCardCvvField` (`matter/saved-cards/saved-cards.tsx`), deliberately absent from\n * `data-component-contract.test.ts`'s fragment-registration list for the same reason.\n *\n * The collected value is not sensitive — the RFC's \"The card-data submission channel\" section\n * names the cardholder document alongside the save-card flag/label as travelling on the ordinary\n * `draft`, never the submission registry — and is published via `setDraftDocument` on every\n * change, mirroring `CardEntry`'s own `setDraftBin` idiom (`card-entry.tsx`): no validation, no\n * dispatch, just keep the shared fact current. T7's `CardEntry` (merged) already folds\n * `draft.document` into its gateway card object, so this component's only job is keeping that\n * value current; it never itself calls `sendPayments` or registers a submission continuation.\n *\n * CPF-only by design, not by omission — see this task's own spec, § \"Multi-country deferral\", for\n * why the read model cannot yet select a document type or a country, and what widening a future\n * task would need to do about it.\n */\n\n// ---------------------------------------------------------------------------\n// Props\n// ---------------------------------------------------------------------------\n\nexport type CardholderDocumentProps = Omit<\n  ComponentPropsWithRef<'div'>,\n  'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref'\n> & {\n  label?: string;\n  placeholder?: string;\n  errorMessage?: string;\n  /** Disables the input without hiding it — distinct from the data-driven presence gate below. */\n  disabled?: boolean;\n  /** Forwarded to `DocumentField`, which lands it on the `<input>`, not on the wrapper `<div>`. */\n  ref?: Ref<HTMLInputElement>;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const CardholderDocumentDefinition = defineComponent<CardholderDocumentProps>({\n  name: 'CardholderDocument',\n  importPath: '@vtex/faststore/components',\n  component: CardholderDocument,\n  requiresContext: 'payment',\n  editor: { label: 'Cardholder Document', category: 'commerce' },\n  schema: {\n    label: { type: 'string', default: 'CPF', label: 'Label' },\n    placeholder: { type: 'string', default: '000.000.000-00', label: 'Placeholder' },\n    errorMessage: { type: 'string', default: 'Invalid CPF', label: 'Error message' },\n    disabled: { type: 'boolean', default: false, label: 'Disabled' },\n  },\n  guideline:\n    \"Cardholder tax-document field for the currently selected payment method (CPF only in this build): renders only when that method's validator marks a document displayable, and marks the input required when the validator marks the document required — the particle, not this leaf, decides whether a typed value is well-formed. Place as a sibling of CardEntry and SavedCards inside a PaymentSectionRoot or PaymentSectionController; renders nothing before a method is selected or when the selected method has no document to collect. The collected value is a plain draft fact — never a schema prop, a fragment field, or an action payload — and is unrelated to the shopper's saved profile document, which this component never reads. See cardholder-document.md.\",\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport function CardholderDocument({\n  label = 'CPF',\n  placeholder = '000.000.000-00',\n  errorMessage = 'Invalid CPF',\n  disabled = false,\n  className,\n  ...props\n}: CardholderDocumentProps) {\n  const { selectedMethod, draft, setDraftDocument, placing, cardPaymentCollapsed } = usePayment();\n  const validator = selectedMethod?.validator;\n  const documentRequired = validator?.documentRequired ?? false;\n\n  // Presence follows `documentDisplayable` alone (specs/payment-section-root.md's contract table),\n  // never the entry path: the validator is resolved off the selected *method*, not off\n  // `draft.path`, matching the merged T5 spec verbatim. See this task's own spec, § \"Decisions\",\n  // for the measured, deliberately-not-fixed interaction this has with a saved-card selection.\n  // T191 (FR-7, Decision 3): nothing renders while the card payment is collapsed either, whatever the\n  // selected method's own validator says. The field re-seeds from `draft.document` when it comes back.\n  // T192 (Decision 3): `isCardholderDocumentShown` is that condition, defined once — the submit gate\n  // reads the same function, so it never asks for a document this field is not showing.\n  if (!isCardholderDocumentShown({ cardPaymentCollapsed, selectedMethod })) return null;\n\n  return (\n    <DocumentField\n      {...props}\n      className={className}\n      // T28: `Field.Root` (Base UI) forwards unknown native props onto its rendered element\n      // (`document-field.tsx`'s own `{...props}` spread), so `inert`/`aria-disabled` land on the same\n      // element `data-fs-cardholder-document` is on — there is no separate root of this component's own.\n      inert={placing}\n      aria-disabled={placing || undefined}\n      documentType=\"CPF\"\n      requirement={documentRequired ? 'mandatory' : 'optional'}\n      // Re-seeds from the shared draft on every mount, so a shopper's already-typed value survives\n      // this leaf unmounting and remounting (e.g. `documentDisplayable` flips off then on again as\n      // network detection re-resolves mid-typing) instead of starting blank again. Uncontrolled —\n      // `DocumentField` owns masking and blur validation from here; this component never re-applies\n      // its own mask (Decision \"Uncontrolled composition, not a second masking implementation\").\n      defaultValue={draft.document ?? ''}\n      label={label}\n      placeholder={placeholder}\n      errorMessage={errorMessage}\n      disabled={disabled}\n      onValueChange={(value) => setDraftDocument(value || null)}\n      data-fs-cardholder-document=\"\"\n      {...(documentRequired ? { 'data-fs-cardholder-document-required': '' } : {})}\n      {...(placing ? { 'data-fs-cardholder-document-placing': '' } : {})}\n    />\n  );\n}\n"],"mappings":";;;;;;;;AA0DA,MAAa,+BAA+B,gBAAyC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAuB,UAAU;CAAW;CAC7D,QAAQ;EACN,OAAO;GAAE,MAAM;GAAU,SAAS;GAAO,OAAO;EAAQ;EACxD,aAAa;GAAE,MAAM;GAAU,SAAS;GAAkB,OAAO;EAAc;EAC/E,cAAc;GAAE,MAAM;GAAU,SAAS;GAAe,OAAO;EAAgB;EAC/E,UAAU;GAAE,MAAM;GAAW,SAAS;GAAO,OAAO;EAAW;CACjE;CACA,WACE;AACJ,CAAC;AAMD,SAAgB,mBAAmB,EACjC,QAAQ,OACR,cAAc,kBACd,eAAe,eACf,WAAW,OACX,WACA,GAAG,SACuB;CAC1B,MAAM,EAAE,gBAAgB,OAAO,kBAAkB,SAAS,yBAAyB,WAAW;CAE9F,MAAM,oBADY,gBAAgB,UAAA,EACE,oBAAoB;CAUxD,IAAI,CAAC,0BAA0B;EAAE;EAAsB;CAAe,CAAC,GAAG,OAAO;CAEjF,OACE,oBAAC,eAAD;EACE,GAAI;EACO;EAIX,OAAO;EACP,iBAAe,WAAW,KAAA;EAC1B,cAAa;EACb,aAAa,mBAAmB,cAAc;EAM9C,cAAc,MAAM,YAAY;EACzB;EACM;EACC;EACJ;EACV,gBAAgB,UAAU,iBAAiB,SAAS,IAAI;EACxD,+BAA4B;EAC5B,GAAK,mBAAmB,EAAE,wCAAwC,GAAG,IAAI,CAAC;EAC1E,GAAK,UAAU,EAAE,uCAAuC,GAAG,IAAI,CAAC;CACjE,CAAA;AAEL"}
+{"version":3,"file":"cardholder-document.js","names":[],"sources":["../../../src/matter/cardholder-document/cardholder-document.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { type ComponentPropsWithRef, type Ref, useEffect, useRef } from 'react';\nimport { DOCUMENTS, DocumentField } from '../../particles/document-field/document-field.js';\nimport { useComposedRef } from '../../particles/shared/compose-refs.js';\nimport { resolveCardholderDocument } from '../payment/cardholder-document-rule.js';\nimport { usePayment } from '../payment/payment.js';\nimport { isCardholderDocumentShown } from '../payment/use-payment-submit-gate.js';\n\n/**\n * The cardholder-document field (specs/cardholder-document.md, T8 of the Credit Card epic;\n * docs/features/credit-card/rfc.md § D3). Renders the existing `particles/document-field`\n * `DocumentField` for the document the store's country asks for (T42: `USA` SSN, `BRA` CPF, `CAN` SIN,\n * `MEX` RFC — `usePayment().countryDocumentType`), gated on the *selected* payment method's validator:\n * presence follows `documentDisplayable`, requiredness follows `documentRequired` — two distinct,\n * non-null flags (T1's read model; `use-payment-method-selection.ts`'s `PaymentSectionValidator`), read\n * off `usePayment().selectedMethod` (`selectedMethodId` resolved against the scoped `methods` list,\n * carrying the full validator — specs/payment-section-root.md's contract table names T8 as the\n * consumer of exactly these two flags on that field). `resolveCardholderDocument` combines the two\n * halves; the submit gate and the card capture read the same function.\n *\n * Declares no fragment of its own: T5's merged `PaymentSectionData` fragment\n * (`matter/payment/payment.tsx`) already selects both flags, so this leaf reads them off context\n * instead of re-selecting them. The shipped precedent for a context-only, fragment-less payment\n * leaf is `SavedCardCvvField` (`matter/saved-cards/saved-cards.tsx`), deliberately absent from\n * `data-component-contract.test.ts`'s fragment-registration list for the same reason.\n *\n * The collected value is not sensitive — the RFC's \"The card-data submission channel\" section\n * names the cardholder document alongside the save-card flag/label as travelling on the ordinary\n * `draft`, never the submission registry — and is published via `setDraftDocument` on every\n * change, mirroring `CardEntry`'s own `setDraftBin` idiom (`card-entry.tsx`): no validation, no\n * dispatch, just keep the shared fact current. T7's `CardEntry` (merged) already folds\n * `draft.document` into its gateway card object, so this component's only job is keeping that\n * value current; it never itself calls `sendPayments` or registers a submission continuation.\n *\n * A store whose country resolves to no document type shows no field, refuses nothing and sends no\n * document (T42, Decision 7).\n */\n\n// ---------------------------------------------------------------------------\n// Props\n// ---------------------------------------------------------------------------\n\nexport type CardholderDocumentProps = Omit<\n  ComponentPropsWithRef<'div'>,\n  'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref'\n> & {\n  label?: string;\n  placeholder?: string;\n  errorMessage?: string;\n  /** Disables the input without hiding it — distinct from the data-driven presence gate below. */\n  disabled?: boolean;\n  /** Forwarded to `DocumentField`, which lands it on the `<input>`, not on the wrapper `<div>`. */\n  ref?: Ref<HTMLInputElement>;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const CardholderDocumentDefinition = defineComponent<CardholderDocumentProps>({\n  name: 'CardholderDocument',\n  importPath: '@vtex/faststore/components',\n  component: CardholderDocument,\n  requiresContext: 'payment',\n  editor: { label: 'Cardholder Document', category: 'commerce' },\n  schema: {\n    label: { type: 'string', label: 'Label' },\n    placeholder: { type: 'string', label: 'Placeholder' },\n    errorMessage: { type: 'string', label: 'Error message' },\n    disabled: { type: 'boolean', default: false, label: 'Disabled' },\n  },\n  guideline:\n    \"Cardholder tax-document field for the currently selected payment method: the store's country picks the document (SSN for the United States, CPF for Brazil, SIN for Canada, RFC for Mexico) with its own label, mask and validation, so leave label, placeholder and errorMessage unset unless the store serves one country. Renders only when that method's validator marks a document displayable and the country has a document type, and marks the input required when the validator marks the document required — the particle, not this leaf, decides whether a typed value is well-formed. Place as a sibling of CardEntry and SavedCards inside a PaymentSectionRoot or PaymentSectionController; renders nothing before a method is selected or when the selected method has no document to collect. The collected value is a plain draft fact — never a schema prop, a fragment field, or an action payload — and is unrelated to the shopper's saved profile document, which this component never reads. See cardholder-document.md.\",\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport function CardholderDocument({\n  label,\n  placeholder,\n  errorMessage,\n  disabled = false,\n  className,\n  ref,\n  ...props\n}: CardholderDocumentProps) {\n  const {\n    selectedMethod,\n    countryDocumentType,\n    draft,\n    setDraftDocument,\n    placing,\n    cardPaymentCollapsed,\n    registerRefusalFocus,\n  } = usePayment();\n  const inputRef = useRef<HTMLInputElement>(null);\n  const composedRef = useComposedRef(ref, inputRef);\n  // T42: the method decides whether to ask and whether the answer is mandatory, the country decides which\n  // document. `null` — no method, a method that asks for nothing, or a country with no document type — is\n  // no field at all.\n  const documentRule = resolveCardholderDocument({ method: selectedMethod, countryDocumentType });\n  const documentRequired = documentRule?.required ?? false;\n\n  // Presence follows `documentDisplayable` alone (specs/payment-section-root.md's contract table),\n  // never the entry path: the validator is resolved off the selected *method*, not off\n  // `draft.path`, matching the merged T5 spec verbatim. See this task's own spec, § \"Decisions\",\n  // for the measured, deliberately-not-fixed interaction this has with a saved-card selection.\n  // T191 (FR-7, Decision 3): nothing renders while the card payment is collapsed either, whatever the\n  // selected method's own validator says. The field re-seeds from `draft.document` when it comes back.\n  // T192 (Decision 3): `isCardholderDocumentShown` is that condition, defined once — the submit gate\n  // reads the same function, so it never asks for a document this field is not showing.\n  const shown = isCardholderDocumentShown({ cardPaymentCollapsed, selectedMethod, countryDocumentType });\n\n  // T212: while this field is on screen and can take focus, a refusal naming it may move focus here. The\n  // function reads the live element at call time, so registering costs nothing per render, and it reports\n  // whether focus really landed so the registry can fall through to another leaf.\n  const canTakeFocus = shown && !disabled;\n  useEffect(() => {\n    if (!canTakeFocus) return;\n    return registerRefusalFocus('cardholder-field', () => {\n      const input = inputRef.current;\n      if (!input) return false;\n      input.focus();\n      return input.ownerDocument.activeElement === input;\n    });\n  }, [canTakeFocus, registerRefusalFocus]);\n\n  if (!shown || !documentRule) return null;\n  const spec = DOCUMENTS[documentRule.type];\n\n  return (\n    <DocumentField\n      // Keyed by type, so a type change remounts the particle and the mask of one type never meets the\n      // value of another.\n      key={documentRule.type}\n      {...props}\n      ref={composedRef}\n      className={className}\n      // T28: `Field.Root` (Base UI) forwards unknown native props onto its rendered element\n      // (`document-field.tsx`'s own `{...props}` spread), so `inert`/`aria-disabled` land on the same\n      // element `data-fs-cardholder-document` is on — there is no separate root of this component's own.\n      inert={placing}\n      aria-disabled={placing || undefined}\n      documentType={documentRule.type}\n      requirement={documentRequired ? 'mandatory' : 'optional'}\n      // Re-seeds from the shared draft on every mount, so a shopper's already-typed value survives\n      // this leaf unmounting and remounting (e.g. `documentDisplayable` flips off then on again as\n      // network detection re-resolves mid-typing) instead of starting blank again. Uncontrolled —\n      // `DocumentField` owns masking and blur validation from here; this component never re-applies\n      // its own mask (Decision \"Uncontrolled composition, not a second masking implementation\").\n      defaultValue={draft.document ?? ''}\n      label={label ?? spec.name}\n      placeholder={placeholder ?? spec.placeholder}\n      errorMessage={errorMessage ?? `Invalid ${spec.name}`}\n      disabled={disabled}\n      onValueChange={(value) => setDraftDocument(value || null)}\n      data-fs-cardholder-document=\"\"\n      {...(documentRequired ? { 'data-fs-cardholder-document-required': '' } : {})}\n      {...(placing ? { 'data-fs-cardholder-document-placing': '' } : {})}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;AA6DA,MAAa,+BAA+B,gBAAyC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAuB,UAAU;CAAW;CAC7D,QAAQ;EACN,OAAO;GAAE,MAAM;GAAU,OAAO;EAAQ;EACxC,aAAa;GAAE,MAAM;GAAU,OAAO;EAAc;EACpD,cAAc;GAAE,MAAM;GAAU,OAAO;EAAgB;EACvD,UAAU;GAAE,MAAM;GAAW,SAAS;GAAO,OAAO;EAAW;CACjE;CACA,WACE;AACJ,CAAC;AAMD,SAAgB,mBAAmB,EACjC,OACA,aACA,cACA,WAAW,OACX,WACA,KACA,GAAG,SACuB;CAC1B,MAAM,EACJ,gBACA,qBACA,OACA,kBACA,SACA,sBACA,yBACE,WAAW;CACf,MAAM,WAAW,OAAyB,IAAI;CAC9C,MAAM,cAAc,eAAe,KAAK,QAAQ;CAIhD,MAAM,eAAe,0BAA0B;EAAE,QAAQ;EAAgB;CAAoB,CAAC;CAC9F,MAAM,mBAAmB,cAAc,YAAY;CAUnD,MAAM,QAAQ,0BAA0B;EAAE;EAAsB;EAAgB;CAAoB,CAAC;CAKrG,MAAM,eAAe,SAAS,CAAC;CAC/B,gBAAgB;EACd,IAAI,CAAC,cAAc;EACnB,OAAO,qBAAqB,0BAA0B;GACpD,MAAM,QAAQ,SAAS;GACvB,IAAI,CAAC,OAAO,OAAO;GACnB,MAAM,MAAM;GACZ,OAAO,MAAM,cAAc,kBAAkB;EAC/C,CAAC;CACH,GAAG,CAAC,cAAc,oBAAoB,CAAC;CAEvC,IAAI,CAAC,SAAS,CAAC,cAAc,OAAO;CACpC,MAAM,OAAO,UAAU,aAAa;CAEpC,OACE,oBAAC,eAAD;EAIE,GAAI;EACJ,KAAK;EACM;EAIX,OAAO;EACP,iBAAe,WAAW,KAAA;EAC1B,cAAc,aAAa;EAC3B,aAAa,mBAAmB,cAAc;EAM9C,cAAc,MAAM,YAAY;EAChC,OAAO,SAAS,KAAK;EACrB,aAAa,eAAe,KAAK;EACjC,cAAc,gBAAgB,WAAW,KAAK;EACpC;EACV,gBAAgB,UAAU,iBAAiB,SAAS,IAAI;EACxD,+BAA4B;EAC5B,GAAK,mBAAmB,EAAE,wCAAwC,GAAG,IAAI,CAAC;EAC1E,GAAK,UAAU,EAAE,uCAAuC,GAAG,IAAI,CAAC;CACjE,GAzBM,aAAa,IAyBnB;AAEL"}

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

@@ -1,4 +1,4 @@
-import { CartAlertIcon, CartAlertRoot, CartAlertText, CartAppliedCoupons, CartCheckoutGuard, CartContinueShopping, CartCount, CartCouponError, CartCouponForm, CartCouponRemove, CartDisclaimer, CartEmpty, CartEmptyMessage, CartError, CartFilled, CartGoCheckout, CartItemSkeleton, CartList, CartLoading, CartOpenOnAdd, CartRedirectOnAdd, CartRemoveUnavailable, CartRoot, CartTotal, CartUnavailableCount } from "./cart.js";
+import { CartAlertIcon, CartAlertRoot, CartAlertText, CartAppliedCoupons, CartCheckoutGuard, CartContinueShopping, CartCount, CartCouponEmpty, CartCouponError, CartCouponForm, CartCouponRemove, CartCouponSavings, CartCouponUnmatched, CartDisclaimer, CartEmpty, CartEmptyMessage, CartError, CartFilled, CartGoCheckout, CartItemSkeleton, CartList, CartLoading, CartOpenOnAdd, CartRedirectOnAdd, CartRemoveUnavailable, CartRoot, CartTotal, CartUnavailableCount, ClearCartButton } from "./cart.js";
 import { CartItemAvailable, CartItemDiscountPercentage, CartItemGift, CartItemImage, CartItemLineTotal, CartItemListPrice, CartItemName, CartItemPrice, CartItemProductLink, CartItemQuantity, CartItemQuantityValue, CartItemRemove, CartItemRoot, CartItemSku, CartItemUnavailable, CartItemVariant } from "../cart-item/cart-item.js";
 //#region src/matter/cart/cart-namespace.d.ts
 export declare const Cart: {
@@ -28,6 +28,7 @@ export declare const Cart: {
   CheckoutGuard: typeof CartCheckoutGuard;
   UnavailableCount: typeof CartUnavailableCount;
   RemoveUnavailable: typeof CartRemoveUnavailable;
+  ClearCart: typeof ClearCartButton;
   OpenOnAdd: typeof CartOpenOnAdd;
   RedirectOnAdd: typeof CartRedirectOnAdd;
   Loading: typeof CartLoading;
@@ -40,6 +41,9 @@ export declare const Cart: {
   AppliedCoupons: typeof CartAppliedCoupons;
   CouponRemove: typeof CartCouponRemove;
   CouponError: typeof CartCouponError;
+  CouponEmpty: typeof CartCouponEmpty;
+  CouponSavings: typeof CartCouponSavings;
+  CouponUnmatched: typeof CartCouponUnmatched;
   AlertRoot: typeof CartAlertRoot;
   AlertIcon: typeof CartAlertIcon;
   AlertText: typeof CartAlertText;

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

@@ -1,4 +1,4 @@
-import { CartAlertIcon, CartAlertRoot, CartAlertText, CartAppliedCoupons, CartCheckoutGuard, CartContinueShopping, CartCount, CartCouponError, CartCouponForm, CartCouponRemove, CartDisclaimer, CartEmpty, CartEmptyMessage, CartError, CartFilled, CartGoCheckout, CartItemSkeleton, CartList, CartLoading, CartOpenOnAdd, CartRedirectOnAdd, CartRemoveUnavailable, CartRoot, CartTotal, CartUnavailableCount } from "./cart.js";
+import { CartAlertIcon, CartAlertRoot, CartAlertText, CartAppliedCoupons, CartCheckoutGuard, CartContinueShopping, CartCount, CartCouponEmpty, CartCouponError, CartCouponForm, CartCouponRemove, CartCouponSavings, CartCouponUnmatched, CartDisclaimer, CartEmpty, CartEmptyMessage, CartError, CartFilled, CartGoCheckout, CartItemSkeleton, CartList, CartLoading, CartOpenOnAdd, CartRedirectOnAdd, CartRemoveUnavailable, CartRoot, CartTotal, CartUnavailableCount, ClearCartButton } from "./cart.js";
 import { CartItemAvailable, CartItemDiscountPercentage, CartItemGift, CartItemImage, CartItemLineTotal, CartItemListPrice, CartItemName, CartItemPrice, CartItemProductLink, CartItemQuantity, CartItemQuantityValue, CartItemRemove, CartItemRoot, CartItemSku, CartItemUnavailable, CartItemVariant } from "../cart-item/cart-item.js";
 //#region src/matter/cart/cart-namespace.ts
 const Cart = {
@@ -28,6 +28,7 @@ const Cart = {
 	CheckoutGuard: CartCheckoutGuard,
 	UnavailableCount: CartUnavailableCount,
 	RemoveUnavailable: CartRemoveUnavailable,
+	ClearCart: ClearCartButton,
 	OpenOnAdd: CartOpenOnAdd,
 	RedirectOnAdd: CartRedirectOnAdd,
 	Loading: CartLoading,
@@ -40,6 +41,9 @@ const Cart = {
 	AppliedCoupons: CartAppliedCoupons,
 	CouponRemove: CartCouponRemove,
 	CouponError: CartCouponError,
+	CouponEmpty: CartCouponEmpty,
+	CouponSavings: CartCouponSavings,
+	CouponUnmatched: CartCouponUnmatched,
 	AlertRoot: CartAlertRoot,
 	AlertIcon: CartAlertIcon,
 	AlertText: CartAlertText

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

@@ -1 +1 @@
-{"version":3,"file":"cart-namespace.js","names":[],"sources":["../../../src/matter/cart/cart-namespace.ts"],"sourcesContent":["import {\n  CartItemAvailable,\n  CartItemDiscountPercentage,\n  CartItemGift,\n  CartItemImage,\n  CartItemLineTotal,\n  CartItemListPrice,\n  CartItemName,\n  CartItemPrice,\n  CartItemProductLink,\n  CartItemQuantity,\n  CartItemQuantityValue,\n  CartItemRemove,\n  CartItemRoot,\n  CartItemSku,\n  CartItemUnavailable,\n  CartItemVariant,\n} from '../cart-item/cart-item.js';\nimport {\n  CartAlertIcon,\n  CartAlertRoot,\n  CartAlertText,\n  CartAppliedCoupons,\n  CartCheckoutGuard,\n  CartContinueShopping,\n  CartCount,\n  CartCouponError,\n  CartCouponForm,\n  CartCouponRemove,\n  CartDisclaimer,\n  CartEmpty,\n  CartEmptyMessage,\n  CartError,\n  CartFilled,\n  CartGoCheckout,\n  CartItemSkeleton,\n  CartList,\n  CartLoading,\n  CartOpenOnAdd,\n  CartRedirectOnAdd,\n  CartRemoveUnavailable,\n  CartRoot,\n  CartTotal,\n  CartUnavailableCount,\n} from './cart.js';\n\n// The `Cart.*` namespace combines the aggregate components (matter/cart) with the line-item\n// components (matter/cart-item). It lives in its own module so neither matter file imports the\n// other, keeping the read root and its per-item line template decoupled (ADR-0012 Option B).\nexport const Cart = {\n  Root: CartRoot,\n  List: CartList,\n  ItemRoot: CartItemRoot,\n  ItemImage: CartItemImage,\n  ItemProductLink: CartItemProductLink,\n  ItemName: CartItemName,\n  ItemVariant: CartItemVariant,\n  ItemSku: CartItemSku,\n  ItemPrice: CartItemPrice,\n  ItemListPrice: CartItemListPrice,\n  ItemDiscountPercentage: CartItemDiscountPercentage,\n  ItemLineTotal: CartItemLineTotal,\n  ItemQuantity: CartItemQuantity,\n  ItemQuantityValue: CartItemQuantityValue,\n  ItemRemove: CartItemRemove,\n  ItemAvailable: CartItemAvailable,\n  ItemUnavailable: CartItemUnavailable,\n  ItemGift: CartItemGift,\n  ItemSkeleton: CartItemSkeleton,\n  Total: CartTotal,\n  Count: CartCount,\n  Error: CartError,\n  GoCheckout: CartGoCheckout,\n  CheckoutGuard: CartCheckoutGuard,\n  UnavailableCount: CartUnavailableCount,\n  RemoveUnavailable: CartRemoveUnavailable,\n  OpenOnAdd: CartOpenOnAdd,\n  RedirectOnAdd: CartRedirectOnAdd,\n  Loading: CartLoading,\n  Empty: CartEmpty,\n  EmptyMessage: CartEmptyMessage,\n  ContinueShopping: CartContinueShopping,\n  Filled: CartFilled,\n  Disclaimer: CartDisclaimer,\n  CouponForm: CartCouponForm,\n  AppliedCoupons: CartAppliedCoupons,\n  CouponRemove: CartCouponRemove,\n  CouponError: CartCouponError,\n  AlertRoot: CartAlertRoot,\n  AlertIcon: CartAlertIcon,\n  AlertText: CartAlertText,\n};\n"],"mappings":";;;AAiDA,MAAa,OAAO;CAClB,MAAM;CACN,MAAM;CACN,UAAU;CACV,WAAW;CACX,iBAAiB;CACjB,UAAU;CACV,aAAa;CACb,SAAS;CACT,WAAW;CACX,eAAe;CACf,wBAAwB;CACxB,eAAe;CACf,cAAc;CACd,mBAAmB;CACnB,YAAY;CACZ,eAAe;CACf,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,OAAO;CACP,OAAO;CACP,OAAO;CACP,YAAY;CACZ,eAAe;CACf,kBAAkB;CAClB,mBAAmB;CACnB,WAAW;CACX,eAAe;CACf,SAAS;CACT,OAAO;CACP,cAAc;CACd,kBAAkB;CAClB,QAAQ;CACR,YAAY;CACZ,YAAY;CACZ,gBAAgB;CAChB,cAAc;CACd,aAAa;CACb,WAAW;CACX,WAAW;CACX,WAAW;AACb"}
+{"version":3,"file":"cart-namespace.js","names":[],"sources":["../../../src/matter/cart/cart-namespace.ts"],"sourcesContent":["import {\n  CartItemAvailable,\n  CartItemDiscountPercentage,\n  CartItemGift,\n  CartItemImage,\n  CartItemLineTotal,\n  CartItemListPrice,\n  CartItemName,\n  CartItemPrice,\n  CartItemProductLink,\n  CartItemQuantity,\n  CartItemQuantityValue,\n  CartItemRemove,\n  CartItemRoot,\n  CartItemSku,\n  CartItemUnavailable,\n  CartItemVariant,\n} from '../cart-item/cart-item.js';\nimport {\n  CartAlertIcon,\n  CartAlertRoot,\n  CartAlertText,\n  CartAppliedCoupons,\n  CartCheckoutGuard,\n  CartContinueShopping,\n  CartCount,\n  CartCouponEmpty,\n  CartCouponError,\n  CartCouponForm,\n  CartCouponRemove,\n  CartCouponSavings,\n  CartCouponUnmatched,\n  CartDisclaimer,\n  CartEmpty,\n  CartEmptyMessage,\n  CartError,\n  CartFilled,\n  CartGoCheckout,\n  CartItemSkeleton,\n  CartList,\n  CartLoading,\n  CartOpenOnAdd,\n  CartRedirectOnAdd,\n  CartRemoveUnavailable,\n  CartRoot,\n  CartTotal,\n  CartUnavailableCount,\n  ClearCartButton,\n} from './cart.js';\n\n// The `Cart.*` namespace combines the aggregate components (matter/cart) with the line-item\n// components (matter/cart-item). It lives in its own module so neither matter file imports the\n// other, keeping the read root and its per-item line template decoupled (ADR-0012 Option B).\nexport const Cart = {\n  Root: CartRoot,\n  List: CartList,\n  ItemRoot: CartItemRoot,\n  ItemImage: CartItemImage,\n  ItemProductLink: CartItemProductLink,\n  ItemName: CartItemName,\n  ItemVariant: CartItemVariant,\n  ItemSku: CartItemSku,\n  ItemPrice: CartItemPrice,\n  ItemListPrice: CartItemListPrice,\n  ItemDiscountPercentage: CartItemDiscountPercentage,\n  ItemLineTotal: CartItemLineTotal,\n  ItemQuantity: CartItemQuantity,\n  ItemQuantityValue: CartItemQuantityValue,\n  ItemRemove: CartItemRemove,\n  ItemAvailable: CartItemAvailable,\n  ItemUnavailable: CartItemUnavailable,\n  ItemGift: CartItemGift,\n  ItemSkeleton: CartItemSkeleton,\n  Total: CartTotal,\n  Count: CartCount,\n  Error: CartError,\n  GoCheckout: CartGoCheckout,\n  CheckoutGuard: CartCheckoutGuard,\n  UnavailableCount: CartUnavailableCount,\n  RemoveUnavailable: CartRemoveUnavailable,\n  ClearCart: ClearCartButton,\n  OpenOnAdd: CartOpenOnAdd,\n  RedirectOnAdd: CartRedirectOnAdd,\n  Loading: CartLoading,\n  Empty: CartEmpty,\n  EmptyMessage: CartEmptyMessage,\n  ContinueShopping: CartContinueShopping,\n  Filled: CartFilled,\n  Disclaimer: CartDisclaimer,\n  CouponForm: CartCouponForm,\n  AppliedCoupons: CartAppliedCoupons,\n  CouponRemove: CartCouponRemove,\n  CouponError: CartCouponError,\n  CouponEmpty: CartCouponEmpty,\n  CouponSavings: CartCouponSavings,\n  CouponUnmatched: CartCouponUnmatched,\n  AlertRoot: CartAlertRoot,\n  AlertIcon: CartAlertIcon,\n  AlertText: CartAlertText,\n};\n"],"mappings":";;;AAqDA,MAAa,OAAO;CAClB,MAAM;CACN,MAAM;CACN,UAAU;CACV,WAAW;CACX,iBAAiB;CACjB,UAAU;CACV,aAAa;CACb,SAAS;CACT,WAAW;CACX,eAAe;CACf,wBAAwB;CACxB,eAAe;CACf,cAAc;CACd,mBAAmB;CACnB,YAAY;CACZ,eAAe;CACf,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,OAAO;CACP,OAAO;CACP,OAAO;CACP,YAAY;CACZ,eAAe;CACf,kBAAkB;CAClB,mBAAmB;CACnB,WAAW;CACX,WAAW;CACX,eAAe;CACf,SAAS;CACT,OAAO;CACP,cAAc;CACd,kBAAkB;CAClB,QAAQ;CACR,YAAY;CACZ,YAAY;CACZ,gBAAgB;CAChB,cAAc;CACd,aAAa;CACb,aAAa;CACb,eAAe;CACf,iBAAiB;CACjB,WAAW;CACX,WAAW;CACX,WAAW;AACb"}

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

@@ -2,6 +2,7 @@ import { ContentValue } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import "../../sdk/generated/graphql.js";
+import { PageRef } from "../../sdk/navigation/types.js";
 import { CartEntity } from "../../sdk/cart/operations.js";
 import { ComponentActions } from "../../sdk/actions/types.js";
 import { NavigationLinkProps } from "../../particles/navigation-link/navigation-link.js";
@@ -58,6 +59,8 @@ export type CartRootProps = ComponentPropsWithRef<'div'> & {
    * session, or `orderFormIdVar` is still null).
    */
   $data?: CartEntity | null;
+  /** Injected by the compiler from `actions: { cart: ['syncSalesChannel'] }`. */
+  $actions?: ComponentActions;
 };
 export type CartListProps = ComponentPropsWithRef<'div'> & {
   /** Number of CartItemSkeleton rows to render while the cart is still loading (FR-7). */
@@ -67,11 +70,14 @@ export type CartTotalProps = ComponentPropsWithRef<'span'> & {
   label?: string;
 };
 export type CartCountProps = ComponentPropsWithRef<'span'> & {
+  /** Output format; `{count}` is replaced by the count. Used for every count without a `templateOne` match. */
   template?: string;
+  /** Output format used only when the count is exactly 1; falls back to `template` when unset or blank. */
+  templateOne?: string;
 };
 export type CartErrorProps = ComponentPropsWithRef<'div'>;
 export type CartGoCheckoutProps = Omit<NavigationLinkProps, 'href' | '$content'> & {
-  href?: string;
+  href?: PageRef | string;
   /** Authored fallback for the button label; `children` still works for stores that label it there. */
   label?: string;
   /** Merchant-authored label, sliced from the page/layout content entry; wins over the label prop and
@@ -83,6 +89,8 @@ export type CartGoCheckoutProps = Omit<NavigationLinkProps, 'href' | '$content'>
 export type CartCouponFormProps = ComponentPropsWithRef<'form'> & {
   placeholder?: string;
   applyLabel?: string;
+  /** Title of the toast raised after an apply whose code comes back matched; blank raises none. */
+  appliedMessage?: string;
   /** Injected by the compiler from `actions: { cart: ['applyCoupon'] }`; the cart write surface. */
   $actions?: ComponentActions;
 };
@@ -100,6 +108,15 @@ export type CartCouponRemoveProps = ComponentPropsWithRef<'button'> & {
   $actions?: ComponentActions;
 };
 export type CartCouponErrorProps = ComponentPropsWithRef<'div'>;
+export type CartCouponEmptyProps = ComponentPropsWithRef<'div'>;
+export type CartCouponUnmatchedProps = ComponentPropsWithRef<'output'> & {
+  /** Notice copy shown while the enclosing chip's coupon is unmatched; blank renders nothing. */
+  message?: string;
+};
+export type CartCouponSavingsProps = Omit<ComponentPropsWithRef<'span'>, 'children'> & {
+  /** Chip text; every `{amount}` is the formatted saving, every `{code}` the chip's code. Blank counts as unset. */
+  template?: string;
+};
 export type CartDisclaimerProps = ComponentPropsWithRef<'p'> & {
   /**
    * Authored fallback, rendered when no CMS entry supplies the notice. Ranks below `children`:
@@ -128,6 +145,12 @@ export type CartContinueShoppingProps = ComponentPropsWithRef<'button'> & {
 export type CartUnavailableCountProps = ComponentPropsWithRef<'span'> & {
   /** Output format; `{count}` is replaced by the integer count. */
   template?: string;
+  /** Output format used only when exactly one line is unavailable; falls back to `template` when unset or blank. */
+  templateOne?: string;
+};
+export type ClearCartButtonProps = ComponentPropsWithRef<'button'> & {
+  /** Injected by the compiler from `actions: { cart: ['removeItems'] }`; the cart write surface. */
+  $actions?: ComponentActions;
 };
 export type CartRemoveUnavailableProps = ComponentPropsWithRef<'button'> & {
   /** Injected by the compiler from `actions: { cart: ['removeItems'] }`; the cart write surface. */
@@ -139,7 +162,7 @@ export type CartOpenOnAddProps = {
   $actions?: ComponentActions;
 };
 export type CartRedirectOnAddProps = {
-  href?: string;
+  href?: PageRef | string;
   children?: ReactNode;
 };
 export declare const CartDataContext: React.Context<CartDataContextValue>;
@@ -162,25 +185,33 @@ export declare const CartCouponFormDefinition: ComponentDefinition<CartCouponFor
 export declare const CartAppliedCouponsDefinition: ComponentDefinition<CartAppliedCouponsProps>;
 export declare const CartCouponRemoveDefinition: ComponentDefinition<CartCouponRemoveProps>;
 export declare const CartCouponErrorDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
-export declare function CartRoot({ $data: $dataProp, className, children, ...props }: CartRootProps): import("react/jsx-runtime").JSX.Element;
+export declare const CartCouponEmptyDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const CartCouponUnmatchedDefinition: ComponentDefinition<CartCouponUnmatchedProps>;
+export declare const CartCouponSavingsDefinition: ComponentDefinition<CartCouponSavingsProps>;
+export declare function CartRoot({ $data: $dataProp, $actions: $actionsProp, className, children, ...props }: CartRootProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartList({ className, children, skeletonCount, ...props }: CartListProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartTotal({ label, className, children, ...props }: CartTotalProps): import("react/jsx-runtime").JSX.Element;
-export declare function CartCount({ className, children, template, ...props }: CartCountProps): import("react/jsx-runtime").JSX.Element;
+export declare function CartCount({ className, children, template, templateOne, ...props }: CartCountProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartError({ className, children, ...props }: CartErrorProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartGoCheckout({ href, label, className, children, onClick, $content, $actions: $actionsProp, ...props }: CartGoCheckoutProps): import("react/jsx-runtime").JSX.Element;
-export declare function CartCouponForm({ placeholder, applyLabel, className, children, onSubmit, $actions: $actionsProp, ...props }: CartCouponFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function CartCouponForm({ placeholder, applyLabel, appliedMessage, className, children, onSubmit, $actions: $actionsProp, ...props }: CartCouponFormProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartAppliedCoupons({ className, children, $actions: $actionsProp, ...props }: CartAppliedCouponsProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartCouponRemove({ code, className, children, onClick, $actions: $actionsProp, ...props }: CartCouponRemoveProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartCouponError({ className, children, ...props }: CartCouponErrorProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartCouponEmpty({ className, children, ...props }: CartCouponEmptyProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartCouponUnmatched({ message, className, children, ...props }: CartCouponUnmatchedProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartCouponSavings({ className, template, ...props }: CartCouponSavingsProps): import("react/jsx-runtime").JSX.Element | null;
 export declare const CartCheckoutGuardDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
 export declare const CartLoadingDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
 export declare const CartEmptyDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
 export declare const CartFilledDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
 export declare const CartUnavailableCountDefinition: ComponentDefinition<CartUnavailableCountProps>;
 export declare const CartRemoveUnavailableDefinition: ComponentDefinition<CartRemoveUnavailableProps>;
+export declare const ClearCartButtonDefinition: ComponentDefinition<ClearCartButtonProps>;
 export declare function CartCheckoutGuard({ className, children, ...props }: CartCheckoutGuardProps): import("react/jsx-runtime").JSX.Element;
-export declare function CartUnavailableCount({ className, children, template, ...props }: CartUnavailableCountProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartUnavailableCount({ className, children, template, templateOne, ...props }: CartUnavailableCountProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartRemoveUnavailable({ className, children, onClick, $actions: $actionsProp, ...props }: CartRemoveUnavailableProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ClearCartButton({ className, children, disabled, onClick, $actions: $actionsProp, ...props }: ClearCartButtonProps): import("react/jsx-runtime").JSX.Element | null;
 export declare const CartOpenOnAddDefinition: ComponentDefinition<CartOpenOnAddProps>;
 export declare const CartRedirectOnAddDefinition: ComponentDefinition<CartRedirectOnAddProps>;
 /**
@@ -198,6 +229,10 @@ export declare function CartOpenOnAdd({ children, $actions: $actionsProp }: Cart
  * redirect is post-resolve and success-gated. The initial `0` is ignored, so a fresh mount never
  * navigates. Context-free — no `CartRoot` ancestor (ADR-0010). Renders its passthrough children (or
  * nothing); it carries no drawer.
+ *
+ * The effect keys on the serialized `href`, not on its identity: a reference authored in a schema
+ * arrives as a new object on every server render, and keying on it would push to checkout again on a
+ * `router.refresh()` long after the add.
  */
 export declare function CartRedirectOnAdd({ href, children }: CartRedirectOnAddProps): ReactNode;
 export declare function CartLoading({ className, children, ...props }: CartLoadingProps): import("react/jsx-runtime").JSX.Element | null;