@vtex/faststore 0.0.6 → 0.0.8

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.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";
@@ -71,7 +72,7 @@ export type CartCountProps = ComponentPropsWithRef<'span'> & {
 };
 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
@@ -139,7 +140,7 @@ export type CartOpenOnAddProps = {
   $actions?: ComponentActions;
 };
 export type CartRedirectOnAddProps = {
-  href?: string;
+  href?: PageRef | string;
   children?: ReactNode;
 };
 export declare const CartDataContext: React.Context<CartDataContextValue>;
@@ -198,6 +199,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;

package/dist/matter/cart/cart.js

@@ -3,10 +3,13 @@ import { defineComponent } from "../../core/dist/define-component.js";
 import { defineContentType } from "../../core/dist/define-content-type.js";
 import "../../core/dist/index.js";
 import { useStorefrontContext } from "../../sdk/context/storefront-context.js";
+import { useStorefrontNavigation } from "../../sdk/navigation/use-storefront-navigation.js";
 import { graphql } from "../../sdk/generated/gql.js";
 import { useActionsOverride } from "../../sdk/actions/actions-override-context.js";
 import { useDataOverride } from "../../sdk/data/data-override-context.js";
 import { NavigationLink } from "../../particles/navigation-link/navigation-link.js";
+import { ListItemRefContext } from "../../sdk/data/list-item-ref-context.js";
+import { ReactiveRootContext } from "../../sdk/data/page-reactive-data-root.js";
 import { Icon } from "../../particles/icon/icon.js";
 import { DrawerClose } from "../../particles/drawer/drawer.js";
 import { Image } from "../../particles/image/image.js";
@@ -14,12 +17,9 @@ import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar
 import { awaitCartWrites } from "../../sdk/cart/write-gate.js";
 import { readCartFromCache } from "../../sdk/cart/use-cart-actions.js";
 import { useCartValidateOnOpen } from "../../sdk/cart/use-cart-validate-on-open.js";
-import { ListItemRefContext } from "../../sdk/data/list-item-ref-context.js";
-import { ReactiveRootContext } from "../../sdk/data/page-reactive-data-root.js";
 import { useApolloClient, useReactiveVar } from "@apollo/client/react";
 import { cloneElement, createContext, isValidElement, useContext, useEffect, useMemo, useRef, useState } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useRouter } from "next/navigation";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useLinkStatus } from "next/link";
 //#region src/matter/cart/cart.tsx
 const CartDisclaimerContent = defineContentType({
@@ -195,8 +195,8 @@ const CartGoCheckoutDefinition = defineComponent({
 	},
 	schema: {
 		href: {
-			type: "string",
-			default: "/checkout",
+			type: "link",
+			default: { standard: "checkout" },
 			label: "Checkout URL"
 		},
 		label: {
@@ -206,7 +206,7 @@ const CartGoCheckoutDefinition = defineComponent({
 		}
 	},
 	actions: { cart: ["validate"] },
-	guideline: "Navigation link to the checkout page (default href /checkout); use as the checkout CTA inside the cart summary. In a mini-cart it is the DrawerPopup footer CTA, next to CartTotal. The button wording is merchant-editable content: a CMS entry wins, then the label prop (default \"Checkout\"), then children — so a store that labels the button through children keeps working and a CMS save overrides it without a deploy. The destination is not content-editable: href stays an authored prop, because re-pointing checkout is not a copy decision. Before routing it runs a stock validation and only navigates when the re-checked cart has no unavailable line; a validation that cannot run falls open and navigates anyway. During a client-side route transition to checkout it surfaces a loading state on its content wrapper as aria-busy plus data-fs-cart-go-checkout-pending, and while the pre-checkout validation runs it exposes data-fs-cart-go-checkout-validating — there is no built-in spinner, so opt into one by styling those attributes (e.g. composing a Spinner). For an external or hard checkout navigation there is no client-side transition, so the loading state simply does not show (a graceful no-op). The enriched footer checkout CTA is CartCheckoutGuard wrapping CartTotal and this CartGoCheckout: the guard makes the CTA inert (data-fs-cart-checkout-blocked) while any item is unavailable, and CartTotal shows the grand total at the button. Must be inside CartRoot."
+	guideline: "Navigation link to the checkout page (default href the checkout page); use as the checkout CTA inside the cart summary. In a mini-cart it is the DrawerPopup footer CTA, next to CartTotal. The button wording is merchant-editable content: a CMS entry wins, then the label prop (default \"Checkout\"), then children — so a store that labels the button through children keeps working and a CMS save overrides it without a deploy. The destination is not content-editable: href stays an authored prop, because re-pointing checkout is not a copy decision. Before routing it runs a stock validation and only navigates when the re-checked cart has no unavailable line; a validation that cannot run falls open and navigates anyway. During a client-side route transition to checkout it surfaces a loading state on its content wrapper as aria-busy plus data-fs-cart-go-checkout-pending, and while the pre-checkout validation runs it exposes data-fs-cart-go-checkout-validating — there is no built-in spinner, so opt into one by styling those attributes (e.g. composing a Spinner). For an external or hard checkout navigation there is no client-side transition, so the loading state simply does not show (a graceful no-op). The enriched footer checkout CTA is CartCheckoutGuard wrapping CartTotal and this CartGoCheckout: the guard makes the CTA inert (data-fs-cart-checkout-blocked) while any item is unavailable, and CartTotal shows the grand total at the button. Must be inside CartRoot."
 });
 const CartCouponFormDefinition = defineComponent({
 	name: "CartCouponForm",
@@ -324,7 +324,7 @@ function CartTotal({ label, className, children, ...props }) {
 		className,
 		"data-fs-cart-total": "",
 		"data-fs-text": "",
-		children: label == null ? value : /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", { children: label }), /* @__PURE__ */ jsx("span", { children: value })] })
+		children: label == null ? value : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", { children: label }), /* @__PURE__ */ jsx("span", { children: value })] })
 	});
 }
 function CartCount({ className, children, template = "{count}", ...props }) {
@@ -362,14 +362,12 @@ function CartGoCheckoutPending({ children }) {
 function configuredLabel(value) {
 	return value?.trim() ? value : void 0;
 }
-function navigateToCheckout(href, push) {
-	if (/^https?:\/\//i.test(href)) globalThis.location.assign(href);
-	else push(href);
-}
-function CartGoCheckout({ href = "/checkout", label, className, children, onClick, $content, $actions: $actionsProp, ...props }) {
+/** The default destination of both checkout navigations. Module-level, so an effect keyed on it is stable. */
+const CHECKOUT_PAGE = { standard: "checkout" };
+function CartGoCheckout({ href = CHECKOUT_PAGE, label, className, children, onClick, $content, $actions: $actionsProp, ...props }) {
 	const $actions = useActionsOverride($actionsProp);
 	const client = useApolloClient();
-	const router = useRouter();
+	const { push } = useStorefrontNavigation();
 	const [validating, setValidating] = useState(false);
 	const inFlight = useRef(false);
 	const resolvedChildren = typeof children === "string" ? configuredLabel(children) : children;
@@ -386,10 +384,10 @@ function CartGoCheckout({ href = "/checkout", label, className, children, onClic
 		try {
 			await awaitCartWrites();
 			if ((await validate()).length > 0) {
-				navigateToCheckout(href, router.push);
+				push(href);
 				return;
 			}
-			if (!(readCartFromCache(client)?.items ?? []).some((item) => item.variant.availability !== "AVAILABLE")) navigateToCheckout(href, router.push);
+			if (!(readCartFromCache(client)?.items ?? []).some((item) => item.variant.availability !== "AVAILABLE")) push(href);
 		} finally {
 			inFlight.current = false;
 			setValidating(false);
@@ -428,7 +426,7 @@ function CartCouponForm({ placeholder = "Coupon code", applyLabel = "Apply", cla
 		onSubmit: handleSubmit,
 		"data-fs-cart-coupon-form": "",
 		...pending ? { "data-fs-cart-coupon-pending": "" } : {},
-		children: children ?? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("input", {
+		children: children ?? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("input", {
 			type: "text",
 			value: code,
 			placeholder,
@@ -649,11 +647,11 @@ const CartRedirectOnAddDefinition = defineComponent({
 		category: "commerce"
 	},
 	schema: { href: {
-		type: "string",
-		default: "/checkout",
+		type: "link",
+		default: { standard: "checkout" },
 		label: "Checkout URL"
 	} },
-	guideline: "No-mini-cart post-add behavior: navigates the shopper to checkout (href, default /checkout) after each successful add to cart. Compose it once in the layout for a store that has no mini-cart drawer; it renders no UI of its own. Use this instead of a mini-cart when adding a product should go straight to checkout. Mutually exclusive with CartOpenOnAdd — compose exactly one, and omit the drawer when using this. See cart.md."
+	guideline: "No-mini-cart post-add behavior: navigates the shopper to checkout (href, default the checkout page) after each successful add to cart. Compose it once in the layout for a store that has no mini-cart drawer; it renders no UI of its own. Use this instead of a mini-cart when adding a product should go straight to checkout. Mutually exclusive with CartOpenOnAdd — compose exactly one, and omit the drawer when using this. See cart.md."
 });
 /**
 * Makes the wrapped mini-cart `DrawerRoot` controlled by `miniCartOpenVar` and opens it on each
@@ -683,16 +681,21 @@ function CartOpenOnAdd({ children, $actions: $actionsProp }) {
 * 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.
 */
-function CartRedirectOnAdd({ href = "/checkout", children }) {
-	const router = useRouter();
+function CartRedirectOnAdd({ href = CHECKOUT_PAGE, children }) {
+	const { push } = useStorefrontNavigation();
 	const pulse = useReactiveVar(cartLastAddVar);
+	const hrefKey = JSON.stringify(href);
 	useEffect(() => {
-		if (pulse > 0) router.push(href);
+		if (pulse > 0) push(JSON.parse(hrefKey));
 	}, [
 		pulse,
-		href,
-		router
+		hrefKey,
+		push
 	]);
 	return children;
 }
@@ -920,7 +923,7 @@ function CartAlertRoot({ text, icon, iconUrl, iconAlt, className, children, $con
 			...props,
 			className,
 			"data-fs-cart-alert": "",
-			children: children ?? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(CartAlertIcon, {}), /* @__PURE__ */ jsx(CartAlertText, {})] })
+			children: children ?? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(CartAlertIcon, {}), /* @__PURE__ */ jsx(CartAlertText, {})] })
 		})
 	});
 }