@vtex/faststore 0.0.8 → 0.0.11

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-destination.js","names":[],"sources":["../../../src/matter/cart-destination/cart-destination.tsx"],"sourcesContent":["'use client';\n\nimport {\n  type ContentValue,\n  defineComponent,\n  defineContentType,\n  type MessageFieldName,\n  type MessageLocaleProp,\n} from '@vtex/fs-core';\nimport {\n  type ChangeEvent,\n  type ComponentPropsWithRef,\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { Field } from '../../particles/field/field.js';\nimport { Input } from '../../particles/input/input.js';\nimport { useActionsOverride } from '../../sdk/actions/actions-override-context.js';\nimport type { ComponentActions } from '../../sdk/actions/types.js';\nimport { addressFields } from '../../sdk/address/address-fields.js';\nimport { loadCountryRules } from '../../sdk/address/country-rules.js';\nimport { normalizePostalCode } from '../../sdk/address/postal-code.js';\nimport type { CountryRules } from '../../sdk/address/types.js';\nimport { validateAddress } from '../../sdk/address/validate-address.js';\nimport { awaitCartWrites } from '../../sdk/cart/write-gate.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { ReactiveRootContext } from '../../sdk/data/page-reactive-data-root.js';\nimport type { ShippingAddressUpdateErrorCode } from '../../sdk/generated/graphql.js';\nimport { formatErrorCode } from '../../sdk/i18n/format-error-code.js';\nimport { useMessageFormatter } from '../../sdk/i18n/use-message-formatter.js';\nimport type { ShippingAddressUpdateErrorEntity } from '../../sdk/shipping/shipping-operations.js';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — the destination only, never a name or a street\n// ---------------------------------------------------------------------------\n\nconst fragment = /* GraphQL */ `\n  fragment CartDestinationData on Query {\n    shipping {\n      __typename\n      id\n      address {\n        __typename\n        id\n        postalCode\n        country\n        city\n        state\n      }\n    }\n  }\n`;\n\n// ---------------------------------------------------------------------------\n// Content models — one per copy-bearing part\n// ---------------------------------------------------------------------------\n\nexport const CartDestinationValueContent = defineContentType({\n  id: 'cart-destination-value',\n  title: 'Cart Destination Value',\n  description: 'Copy that precedes the destination in read mode.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      prefix: { type: 'string', title: 'Prefix' },\n    },\n  },\n});\n\nexport const CartDestinationChangeContent = defineContentType({\n  id: 'cart-destination-change',\n  title: 'Cart Destination Change',\n  description: 'Copy for the control that opens edit mode.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      label: { type: 'string', title: 'Button label' },\n    },\n  },\n});\n\nexport const CartDestinationSubmitContent = defineContentType({\n  id: 'cart-destination-submit',\n  title: 'Cart Destination Submit',\n  description: 'Copy for the control that writes the destination.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      label: { type: 'string', title: 'Button label' },\n      pendingLabel: { type: 'string', title: 'Pending label' },\n    },\n  },\n});\n\nexport const CartDestinationCancelContent = defineContentType({\n  id: 'cart-destination-cancel',\n  title: 'Cart Destination Cancel',\n  description: 'Copy for the control that closes edit mode without writing.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      label: { type: 'string', title: 'Button label' },\n    },\n  },\n});\n\nexport const CartDestinationErrorContent = defineContentType({\n  id: 'cart-destination-error',\n  title: 'Cart Destination Error',\n  description: 'Messages shown when the destination write is refused, one per error code the shopper can act on.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      genericMessage: {\n        type: 'string',\n        title: 'Failure message',\n        description: 'Shown for a network failure and for every refusal the shopper cannot act on.',\n        format: 'icu-message',\n        messageSource: 'Unable to update the delivery location. Please try again.',\n      },\n      invalidPostalCodeMessage: {\n        type: 'string',\n        title: 'Invalid postal code message',\n        description: 'Shown when the server rejects the postal code.',\n        format: 'icu-message',\n        messageSource: 'Enter a valid postal code.',\n      },\n    },\n  },\n});\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * The `shipping` slice forwarded by the reactive runtime: the value of the `shipping` top-level field\n * of `CartDestinationData on Query`, `null` while it has not resolved.\n */\nexport type CartDestinationEntity = {\n  __typename?: 'Shipping';\n  id?: string;\n  address?: {\n    __typename?: 'Address';\n    id?: string | null;\n    postalCode?: string | null;\n    country?: string | null;\n    city?: string | null;\n    state?: string | null;\n  } | null;\n};\n\nexport type CartDestinationRootProps = ComponentPropsWithRef<'div'> & {\n  /** Country used while the cart has no address yet. */\n  defaultCountry?: string;\n  $data?: CartDestinationEntity | null;\n  /** Injected by the compiler from `actions: { shipping: ['setAddress'] }`. */\n  $actions?: ComponentActions;\n  children?: ReactNode;\n};\n\nexport type CartDestinationReadProps = ComponentPropsWithRef<'div'>;\n\n/** Children are omitted: what this renders is the cart's destination, never authored content. */\nexport type CartDestinationValueProps = Omit<ComponentPropsWithRef<'span'>, 'children'> & {\n  prefix?: string;\n  /** Merchant-authored copy; wins over the prop when present. */\n  $content?: ContentValue<typeof CartDestinationValueContent>;\n};\n\nexport type CartDestinationUnsetProps = ComponentPropsWithRef<'button'>;\n\nexport type CartDestinationChangeProps = ComponentPropsWithRef<'button'> & {\n  label?: string;\n  $content?: ContentValue<typeof CartDestinationChangeContent>;\n};\n\nexport type CartDestinationFormProps = ComponentPropsWithRef<'form'>;\n\nexport type CartDestinationPostalCodeControlProps = {\n  className?: string;\n  label?: string;\n  /** Wins over the example the country's rules give. */\n  placeholder?: string;\n  /** The field's own message for a draft that fails the country's postal code rules. */\n  invalidMessage?: string;\n};\n\nexport type CartDestinationSubmitProps = ComponentPropsWithRef<'button'> & {\n  label?: string;\n  pendingLabel?: string;\n  $content?: ContentValue<typeof CartDestinationSubmitContent>;\n};\n\nexport type CartDestinationCancelProps = ComponentPropsWithRef<'button'> & {\n  label?: string;\n  $content?: ContentValue<typeof CartDestinationCancelContent>;\n};\n\n/** Children are omitted: what this renders is the message for the write's error code. */\nexport type CartDestinationErrorProps = Omit<ComponentPropsWithRef<'div'>, 'children'> &\n  MessageLocaleProp & {\n    $content?: ContentValue<typeof CartDestinationErrorContent>;\n  };\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nexport type CartDestinationContextValue = Readonly<{\n  /** The cart's postal code, from `$data` only; null until a destination is set. */\n  postalCode: string | null;\n  city: string | null;\n  state: string | null;\n  /** The address country, else the root's `defaultCountry`. */\n  country: string;\n  /** The root query is in flight and no address is cached yet. */\n  loading: boolean;\n  /** Edit mode. Local to the root, `false` on mount. */\n  editing: boolean;\n  startEditing: () => void;\n  /** Closes edit mode and discards the draft and the errors; writes nothing. */\n  cancel: () => void;\n  draft: string;\n  setDraft: (value: string) => void;\n  /**\n   * The country's rules for edit mode. `null` while they load, and when the load failed or the\n   * country is outside the library: the draft is then free text and nothing validates it.\n   */\n  rules: CountryRules | null;\n  /** The rules are still loading: the field and Submit stay disabled. */\n  rulesLoading: boolean;\n  /** The draft is valid for the country, different from the current one, and no write is pending. */\n  canSubmit: boolean;\n  pending: boolean;\n  errors: readonly ShippingAddressUpdateErrorEntity[];\n  /** The last submit was refused locally. */\n  invalid: boolean;\n  submit: () => void;\n}>;\n\nconst CART_DESTINATION_CONTEXT_UNSET = Symbol('CartDestinationContextUnset');\n\nconst CartDestinationContextInternal = createContext<\n  CartDestinationContextValue | typeof CART_DESTINATION_CONTEXT_UNSET\n>(CART_DESTINATION_CONTEXT_UNSET);\n\n/**\n * Read the destination and the edit-mode state from the nearest `CartDestinationRoot`. Throws outside\n * one: a misplaced part is a composition bug the author should see at once.\n */\nexport function useCartDestination(): CartDestinationContextValue {\n  const ctx = useContext(CartDestinationContextInternal);\n  if (ctx === CART_DESTINATION_CONTEXT_UNSET) {\n    throw new Error('CartDestination components must be used inside a <CartDestinationRoot> subtree.');\n  }\n  return ctx;\n}\n\n/** Whether a `CartDestinationForm` encloses the subtree, so `CartDestinationSubmit` knows its form owner. */\nconst CartDestinationFormContext = createContext(false);\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_COUNTRY = 'BRA';\n\n/** Whether the country's rules refuse the value. A country the library does not cover refuses nothing. */\nfunction isPostalCodeRefused(value: string, rules: CountryRules | null): boolean {\n  if (!rules?.covered) return false;\n  return validateAddress({ postalCode: value.trim() }, rules).postalCode !== undefined;\n}\n\n/** The form the write sends and the comparison uses: the country's own, else the trimmed text. */\nfunction toStoredPostalCode(value: string, rules: CountryRules | null): string {\n  return rules ? normalizePostalCode(value, rules) : value.trim();\n}\n\nfunction isDraftSubmittable(draft: string, current: string | null, rules: CountryRules | null): boolean {\n  if (draft.trim() === '' || isPostalCodeRefused(draft, rules)) return false;\n  return toStoredPostalCode(draft, rules) !== toStoredPostalCode(current ?? '', rules);\n}\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const CartDestinationRootDefinition = defineComponent<CartDestinationRootProps>({\n  name: 'CartDestinationRoot',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  providesContext: 'cartDestination',\n  actions: { shipping: ['setAddress'] },\n  editor: { label: 'Cart Destination Root', category: 'content' },\n  schema: {\n    defaultCountry: { type: 'string', default: 'BRA', label: 'Default country (ISO alpha-3)' },\n  },\n  guideline:\n    'Where the cart is delivered, with a postal-code-only form that writes the cart destination so the free-shipping bar follows. Compose CartDestinationRead (CartDestinationValue, CartDestinationUnset, CartDestinationChange) for read mode and CartDestinationForm (PostalCodeControl, Submit, Cancel, Error) for edit mode. Starts in read mode; the store cannot open edit mode from outside. See cart-destination.md.',\n});\n\nexport const CartDestinationReadDefinition = defineComponent<CartDestinationReadProps>({\n  name: 'CartDestinationRead',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationRead,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Read', category: 'layout' },\n  schema: {},\n  guideline:\n    'Wraps what read mode shows: the value, the invitation when no destination is set, and the change control. Renders nothing while edit mode is open. Must be inside CartDestinationRoot.',\n});\n\nexport const CartDestinationValueDefinition = defineComponent<CartDestinationValueProps>({\n  name: 'CartDestinationValue',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationValue,\n  content: CartDestinationValueContent,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Value', category: 'content' },\n  schema: {\n    prefix: { type: 'string', label: 'Prefix' },\n  },\n  guideline:\n    'The cart destination as postal code, city and state, each in its own element. Renders nothing while loading or when no destination is set. Must be inside CartDestinationRoot.',\n});\n\nexport const CartDestinationUnsetDefinition = defineComponent<CartDestinationUnsetProps>({\n  name: 'CartDestinationUnset',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationUnset,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Unset', category: 'content' },\n  schema: {},\n  guideline:\n    'A button that opens edit mode when pressed, like CartDestinationChange, with aria-expanded tied to the mode. Renders only once the destination resolved and none is set. Its children are the store-authored invitation (for example an Icon and a Text reading \"Informe seu CEP\"). Never place a CartDestinationChange, a link or another button inside it: a button cannot hold another. The regular CartDestinationChange repeats it, so the store usually hides that one while this shows. Place it within CartDestinationRead. Must be inside CartDestinationRoot.',\n});\n\nexport const CartDestinationChangeDefinition = defineComponent<CartDestinationChangeProps>({\n  name: 'CartDestinationChange',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationChange,\n  content: CartDestinationChangeContent,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Change', category: 'action' },\n  schema: {\n    label: { type: 'string', label: 'Button label' },\n  },\n  guideline:\n    'Button that opens edit mode, styled as a link by the store. Place it inside CartDestinationRead. Must be inside CartDestinationRoot.',\n});\n\nexport const CartDestinationFormDefinition = defineComponent<CartDestinationFormProps>({\n  name: 'CartDestinationForm',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationForm,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Form', category: 'action' },\n  schema: {},\n  guideline:\n    'Edit mode: renders only while editing and routes Enter to the submit. Holds the postal code control, Submit, Cancel and Error, and any help text the store places. Must be inside CartDestinationRoot.',\n});\n\nexport const CartDestinationPostalCodeControlDefinition = defineComponent<CartDestinationPostalCodeControlProps>({\n  name: 'CartDestinationPostalCodeControl',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationPostalCodeControl,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Postal Code Control', category: 'content' },\n  schema: {\n    label: { type: 'string', label: 'Label' },\n    placeholder: { type: 'string', label: 'Placeholder' },\n    invalidMessage: { type: 'string', label: 'Invalid-value message' },\n  },\n  guideline:\n    \"The postal code input of edit mode, empty each time edit mode opens and focused once enabled. A plain text field whose limits and example come from the cart country's postal code rules; it stays disabled while they load, and a country the rules do not cover takes free text. Must be inside CartDestinationForm.\",\n});\n\nexport const CartDestinationSubmitDefinition = defineComponent<CartDestinationSubmitProps>({\n  name: 'CartDestinationSubmit',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationSubmit,\n  content: CartDestinationSubmitContent,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Submit', category: 'action' },\n  schema: {\n    label: { type: 'string', label: 'Button label' },\n    pendingLabel: { type: 'string', label: 'Pending label' },\n  },\n  guideline:\n    \"Writes the typed postal code. Disabled until the country's rules have loaded, the typed code is valid for the country (any text for a country the rules do not cover) and different from the current one, and while a write is pending (aria-busy). Must be inside CartDestinationForm.\",\n});\n\nexport const CartDestinationCancelDefinition = defineComponent<CartDestinationCancelProps>({\n  name: 'CartDestinationCancel',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationCancel,\n  content: CartDestinationCancelContent,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Cancel', category: 'action' },\n  schema: {\n    label: { type: 'string', label: 'Button label' },\n  },\n  guideline:\n    'Closes edit mode, discards what was typed and writes nothing. Disabled while a write is pending. Must be inside CartDestinationForm.',\n});\n\nexport const CartDestinationErrorDefinition = defineComponent<CartDestinationErrorProps>({\n  name: 'CartDestinationError',\n  importPath: '@vtex/faststore/components',\n  component: CartDestinationError,\n  content: CartDestinationErrorContent,\n  requiresContext: 'cartDestination',\n  editor: { label: 'Cart Destination Error', category: 'content' },\n  schema: {},\n  guideline:\n    'Announces why the destination write failed, as an alert, and renders nothing otherwise. Words each error code from its $content: invalidPostalCodeMessage for a postal code the server rejects, genericMessage for a network failure and every refusal the shopper cannot act on. A postal code the platform refuses upstream also reaches the client as a network failure, so write genericMessage to cover it. An unknown code also shows genericMessage. Must be inside CartDestinationForm.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\n/**\n * Reads the cart destination reactively and publishes it, the edit-mode flag, the draft and the write\n * state as `cartDestination` context.\n *\n * The destination is never copied into state: the Value renders only what `$data` resolves, and a\n * successful write updates it solely by the mutation payload normalizing into the Apollo cache. A\n * rejected write therefore needs no rollback.\n */\nexport function CartDestinationRoot({\n  defaultCountry = DEFAULT_COUNTRY,\n  $data: $dataProp,\n  $actions: $actionsProp,\n  className,\n  children,\n  ...props\n}: CartDestinationRootProps) {\n  const $data = useDataOverride($dataProp);\n  const $actions = useActionsOverride($actionsProp);\n  const address = $data?.address ?? null;\n  const { loading: rootLoading } = useContext(ReactiveRootContext);\n\n  const postalCode = address?.postalCode ?? null;\n  // A null destination is ambiguous alone: an unresolved read and a cart with none look the same, so\n  // the root query's in-flight flag tells \"loading\" from \"unset\".\n  const loading = rootLoading && postalCode == null;\n  const country = address?.country ?? defaultCountry;\n\n  const [editing, setEditing] = useState(false);\n  const [draft, setDraft] = useState('');\n  const [pending, setPending] = useState(false);\n  const [errors, setErrors] = useState<readonly ShippingAddressUpdateErrorEntity[]>([]);\n  const [invalid, setInvalid] = useState(false);\n  // State is batched, so two activations in one tick would both pass a `pending` check.\n  const inFlightRef = useRef(false);\n  const rootRef = useRef<HTMLDivElement>(null);\n  const wasEditingRef = useRef(false);\n\n  /**\n   * Leaving edit mode moves focus back to the control that opens it, which only mounts once read mode\n   * renders again, hence an effect on the flag rather than a call at the event. With no destination that\n   * is the invitation; the change control is hidden then, so the invitation wins when both exist.\n   * Opening it focuses the field, which `CartDestinationPostalCodeControl` does once the rules have loaded and enabled it.\n   */\n  useEffect(() => {\n    if (wasEditingRef.current === editing) return;\n    wasEditingRef.current = editing;\n    if (editing) return;\n    const trigger =\n      rootRef.current?.querySelector<HTMLElement>('[data-fs-cart-destination-unset]') ??\n      rootRef.current?.querySelector<HTMLElement>('[data-fs-cart-destination-change]');\n    trigger?.focus();\n  }, [editing]);\n\n  // The rules load when edit mode opens. A failed load is not remembered by `loadCountryRules`, so the\n  // next opening retries it; `rules: null` in the settled entry means the load failed.\n  const [loaded, setLoaded] = useState<{ country: string; rules: CountryRules | null } | null>(null);\n  useEffect(() => {\n    if (!editing) {\n      setLoaded((current) => (current?.rules ? current : null));\n      return;\n    }\n    let active = true;\n    loadCountryRules(country).then(\n      (rules) => {\n        if (active) setLoaded({ country, rules });\n      },\n      (error) => {\n        if (!active) return;\n        console.warn('[CartDestinationRoot] country rules failed to load', {\n          country,\n          error: loggableErrorName(error),\n        });\n        setLoaded({ country, rules: null });\n      },\n    );\n    return () => {\n      active = false;\n    };\n  }, [editing, country]);\n\n  const rulesLoading = editing && loaded?.country !== country;\n  const rules = loaded?.country === country ? loaded.rules : null;\n  const canSubmit = !pending && !rulesLoading && isDraftSubmittable(draft, postalCode, rules);\n\n  const startEditing = useCallback(() => setEditing(true), []);\n\n  const cancel = useCallback(() => {\n    setEditing(false);\n    setDraft('');\n    setErrors([]);\n    setInvalid(false);\n  }, []);\n\n  /** Typing is the shopper's answer to a refusal, so the message and the invalid flag go with it. */\n  const updateDraft = useCallback((value: string) => {\n    setDraft(value);\n    setErrors((current) => (current.length === 0 ? current : []));\n    setInvalid(false);\n  }, []);\n\n  const submit = useCallback(() => {\n    if (inFlightRef.current) return;\n    const setAddress = $actions?.shipping?.setAddress;\n    if (!setAddress) return;\n    if (!canSubmit) {\n      setInvalid(true);\n      return;\n    }\n\n    inFlightRef.current = true;\n    setPending(true);\n    setErrors([]);\n    setInvalid(false);\n\n    // The resolver builds `logisticsInfo` from the order form it reads, so a line write still in\n    // flight has to land first.\n    void awaitCartWrites()\n      .then(() => setAddress({ postalCode: toStoredPostalCode(draft, rules), country }))\n      .then((writeErrors) => {\n        if (writeErrors.length > 0) {\n          // A refusal keeps edit mode open so the message has somewhere to show.\n          setErrors(writeErrors);\n          return;\n        }\n        setEditing(false);\n        setDraft('');\n      })\n      .finally(() => {\n        inFlightRef.current = false;\n        setPending(false);\n      });\n  }, [$actions, canSubmit, draft, country, rules]);\n\n  const value: CartDestinationContextValue = useMemo(\n    () => ({\n      postalCode,\n      city: address?.city ?? null,\n      state: address?.state ?? null,\n      country,\n      loading,\n      editing,\n      startEditing,\n      cancel,\n      draft,\n      setDraft: updateDraft,\n      rules,\n      rulesLoading,\n      canSubmit,\n      pending,\n      errors,\n      invalid,\n      submit,\n    }),\n    [\n      postalCode,\n      address?.city,\n      address?.state,\n      country,\n      loading,\n      editing,\n      startEditing,\n      cancel,\n      draft,\n      updateDraft,\n      rules,\n      rulesLoading,\n      canSubmit,\n      pending,\n      errors,\n      invalid,\n      submit,\n    ],\n  );\n\n  return (\n    <CartDestinationContextInternal value={value}>\n      <div\n        {...props}\n        ref={rootRef}\n        className={className}\n        data-fs-cart-destination=\"\"\n        {...(pending ? { 'data-fs-cart-destination-pending': '' } : {})}\n        {...(editing ? { 'data-fs-cart-destination-editing': '' } : {})}\n      >\n        {children}\n      </div>\n    </CartDestinationContextInternal>\n  );\n}\n\nexport function CartDestinationRead({ className, children, ...props }: CartDestinationReadProps) {\n  const { editing } = useCartDestination();\n  if (editing) return null;\n\n  return (\n    <div {...props} className={className} data-fs-cart-destination-read=\"\">\n      {children}\n    </div>\n  );\n}\n\nfunction pickAuthored(content: string | undefined, prop: string | undefined): string | null {\n  if (content?.trim()) return content;\n  if (prop?.trim()) return prop;\n  return null;\n}\n\nexport function CartDestinationValue({ prefix, $content, className, ...props }: CartDestinationValueProps) {\n  const { postalCode, city, state, loading } = useCartDestination();\n  if (loading || postalCode == null) return null;\n\n  const resolvedPrefix = pickAuthored($content?.prefix, prefix);\n\n  return (\n    <span {...props} className={className} data-fs-cart-destination-value=\"\">\n      {resolvedPrefix ? <span data-fs-cart-destination-value-prefix=\"\">{resolvedPrefix}</span> : null}\n      {/* Plain text nodes between the pieces: they keep the accessible name readable and a flex\n          container strips them, so a store's `gap` still governs the visible spacing. */}\n      {resolvedPrefix ? ' ' : null}\n      <span data-fs-cart-destination-value-postal-code=\"\">{postalCode}</span>\n      {city || state ? ' · ' : null}\n      {city ? <span data-fs-cart-destination-value-city=\"\">{city}</span> : null}\n      {city && state ? ', ' : null}\n      {state ? <span data-fs-cart-destination-value-state=\"\">{state}</span> : null}\n    </span>\n  );\n}\n\nexport function CartDestinationUnset({ className, children, onClick, ...props }: CartDestinationUnsetProps) {\n  const { postalCode, loading, editing, startEditing } = useCartDestination();\n  if (loading || postalCode != null) return null;\n\n  return (\n    <button\n      {...props}\n      type=\"button\"\n      onClick={(event) => {\n        onClick?.(event);\n        startEditing();\n      }}\n      aria-expanded={editing}\n      className={className}\n      data-fs-cart-destination-unset=\"\"\n    >\n      {children}\n    </button>\n  );\n}\n\nexport function CartDestinationChange({ label, $content, className, children, ...props }: CartDestinationChangeProps) {\n  const { editing, startEditing } = useCartDestination();\n  const resolvedLabel = pickAuthored($content?.label, label);\n\n  return (\n    <button\n      {...props}\n      type=\"button\"\n      onClick={startEditing}\n      aria-expanded={editing}\n      className={className}\n      data-fs-cart-destination-change=\"\"\n    >\n      {children ?? resolvedLabel}\n    </button>\n  );\n}\n\nexport function CartDestinationForm({ className, children, ...props }: CartDestinationFormProps) {\n  const { editing, submit } = useCartDestination();\n  if (!editing) return null;\n\n  return (\n    <CartDestinationFormContext value={true}>\n      <form // react-doctor-disable-line no-prevent-default -- submit() is the only handler, so a native submit would reload the page\n        {...props}\n        className={className}\n        data-fs-cart-destination-form=\"\"\n        // Submit is disabled for an invalid draft, so the browser skips implicit submission on Enter\n        // and the field would never be flagged; the key is routed to submit() here instead.\n        onKeyDown={(event) => {\n          if (event.key !== 'Enter' || !(event.target instanceof HTMLInputElement)) return;\n          event.preventDefault();\n          submit();\n        }}\n        onSubmit={(event) => {\n          event.preventDefault();\n          submit();\n        }}\n      >\n        {children}\n      </form>\n    </CartDestinationFormContext>\n  );\n}\n\nexport function CartDestinationPostalCodeControl({\n  className,\n  label,\n  placeholder,\n  invalidMessage,\n}: Readonly<CartDestinationPostalCodeControlProps>) {\n  const { draft, setDraft, errors, invalid, pending, rules, rulesLoading } = useCartDestination();\n  const rootRef = useRef<HTMLDivElement>(null);\n  const focusedOnOpenRef = useRef(false);\n  const [blurInvalid, setBlurInvalid] = useState(false);\n  const refused = errors.length > 0;\n\n  const descriptor = useMemo(\n    () => (rules ? addressFields(rules, {}).find(({ name }) => name === 'postalCode') : undefined),\n    [rules],\n  );\n  /** The country's example postal code: address data, not a message. */\n  const example = descriptor?.placeholder?.values.example;\n\n  /** A disabled input cannot take focus, so opening edit mode focuses the field once the rules enable it. */\n  useEffect(() => {\n    if (rulesLoading || focusedOnOpenRef.current) return;\n    focusedOnOpenRef.current = true;\n    rootRef.current?.querySelector<HTMLInputElement>('[data-fs-postal-code-field-input]')?.focus();\n  }, [rulesLoading]);\n\n  /**\n   * Disabling the input while the write is in flight drops focus to the body, so a refusal otherwise\n   * lands with nothing focused. Waits for `pending` to clear: focusing a disabled input is a no-op.\n   */\n  useEffect(() => {\n    if (!refused || pending) return;\n    rootRef.current?.querySelector<HTMLInputElement>('[data-fs-postal-code-field-input]')?.focus();\n  }, [refused, pending]);\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    setBlurInvalid(false);\n    setDraft(event.target.value);\n  }\n\n  const showInvalid = invalid || refused || blurInvalid;\n\n  return (\n    <Field.Root\n      ref={rootRef}\n      className={className}\n      name=\"postalCode\"\n      invalid={showInvalid}\n      disabled={pending || rulesLoading}\n      data-fs-postal-code-field=\"\"\n      data-fs-cart-destination-postal-code-control=\"\"\n    >\n      {label ? <Field.Label data-fs-postal-code-field-label=\"\">{label}</Field.Label> : null}\n      <Input\n        data-fs-postal-code-field-input=\"\"\n        type=\"text\"\n        name=\"postalCode\"\n        autoComplete=\"postal-code\"\n        value={draft}\n        maxLength={descriptor?.maxLength}\n        inputMode={descriptor?.inputMode}\n        placeholder={placeholder ?? example}\n        onChange={handleChange}\n        onBlur={() => setBlurInvalid(draft.trim() !== '' && isPostalCodeRefused(draft, rules))}\n      />\n      {/* While a refusal stands, the message is `CartDestinationError`'s. */}\n      {showInvalid && !refused && invalidMessage ? (\n        <Field.Error match data-fs-postal-code-field-error=\"\">\n          {invalidMessage}\n        </Field.Error>\n      ) : null}\n    </Field.Root>\n  );\n}\n\nexport function CartDestinationSubmit({\n  label,\n  pendingLabel,\n  $content,\n  className,\n  children,\n  ...props\n}: CartDestinationSubmitProps) {\n  const { canSubmit, pending, submit } = useCartDestination();\n  const inForm = useContext(CartDestinationFormContext);\n\n  const resolvedLabel = pickAuthored($content?.label, label);\n  const resolvedPendingLabel = pickAuthored($content?.pendingLabel, pendingLabel);\n\n  return (\n    <button\n      {...props}\n      // The form routes native submission to the same submit(); alone there is no form to submit.\n      type={inForm ? 'submit' : 'button'}\n      onClick={inForm ? props.onClick : submit}\n      disabled={!canSubmit || props.disabled}\n      aria-busy={pending || undefined}\n      className={className}\n      data-fs-cart-destination-submit=\"\"\n      {...(pending ? { 'data-fs-cart-destination-submit-pending': '' } : {})}\n    >\n      {children ?? (pending ? (resolvedPendingLabel ?? resolvedLabel) : resolvedLabel)}\n    </button>\n  );\n}\n\nexport function CartDestinationCancel({ label, $content, className, children, ...props }: CartDestinationCancelProps) {\n  const { cancel, pending } = useCartDestination();\n  const resolvedLabel = pickAuthored($content?.label, label);\n\n  return (\n    <button\n      {...props}\n      type=\"button\"\n      onClick={cancel}\n      disabled={pending || props.disabled}\n      className={className}\n      data-fs-cart-destination-cancel=\"\"\n    >\n      {children ?? resolvedLabel}\n    </button>\n  );\n}\n\n/**\n * The message for each code `shippingAddressUpdate` can return, plus the client-minted transport failure.\n * This form writes only the postal code and the country, so every other refusal is one the shopper\n * cannot act on here.\n */\nexport const CART_DESTINATION_ERROR_FIELDS = {\n  INVALID_POSTAL_CODE: 'invalidPostalCodeMessage',\n  INVALID_ADDRESS: 'genericMessage',\n  INVALID_COUNTRY_CODE: 'genericMessage',\n  MISSING_RECIPIENT_NAME: 'genericMessage',\n  INVALID_SAVED_ADDRESS_ID: 'genericMessage',\n  MISSING_CART_CONTEXT: 'genericMessage',\n  CART_NOT_FOUND: 'genericMessage',\n  NETWORK_ERROR: 'genericMessage',\n} as const satisfies Record<\n  ShippingAddressUpdateErrorCode | 'NETWORK_ERROR',\n  MessageFieldName<typeof CartDestinationErrorContent>\n>;\n\nexport function CartDestinationError({ $content, $locale, className, ...props }: CartDestinationErrorProps) {\n  const { errors } = useCartDestination();\n  const { format } = useMessageFormatter(CartDestinationErrorContent, $content);\n  const [firstError] = errors;\n  if (!firstError) return null;\n\n  return (\n    <div {...props} role=\"alert\" className={className} data-fs-cart-destination-error=\"\">\n      {formatErrorCode(\n        CartDestinationErrorContent,\n        CART_DESTINATION_ERROR_FIELDS,\n        firstError,\n        format,\n        'genericMessage',\n      )}\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Namespace export\n// ---------------------------------------------------------------------------\n\nexport const CartDestination = {\n  Root: CartDestinationRoot,\n  Read: CartDestinationRead,\n  Value: CartDestinationValue,\n  Unset: CartDestinationUnset,\n  Change: CartDestinationChange,\n  Form: CartDestinationForm,\n  PostalCodeControl: CartDestinationPostalCodeControl,\n  Submit: CartDestinationSubmit,\n  Cancel: CartDestinationCancel,\n  Error: CartDestinationError,\n};\n"],"mappings":"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"}

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

@@ -1,3 +1,4 @@
+import { ContentValue, MessageLocaleProp } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import { CartItemEntity } from "../../sdk/cart/operations.js";
@@ -5,6 +6,128 @@ import { ComponentActions } from "../../sdk/actions/types.js";
 import { NavigationLinkProps } from "../../particles/navigation-link/navigation-link.js";
 import { ComponentPropsWithRef, ReactNode } from "react";
 //#region src/matter/cart-item/cart-item.d.ts
+export declare const CartItemDiscountPercentageContent: {
+  readonly id: "cart-item-discount-percentage";
+  readonly title: "Cart Item Discount Percentage";
+  readonly description: "The per-line discount badge.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly template: {
+        readonly type: "string";
+        readonly title: "Badge text";
+        readonly description: "percentage is the integer percent off the list price.";
+        readonly format: "icu-message";
+        readonly messageSource: "-{percentage}%";
+        readonly messageArguments: {
+          readonly type: "object";
+          readonly properties: {
+            readonly percentage: {
+              readonly type: "integer";
+            };
+          };
+        };
+        readonly messageExample: {
+          readonly percentage: 20;
+        };
+      };
+    };
+  };
+};
+export declare const CartItemQuantityContent: {
+  readonly id: "cart-item-quantity";
+  readonly title: "Cart Item Quantity";
+  readonly description: "The notice shown when a typed quantity is corrected.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly validationMessage: {
+        readonly type: "string";
+        readonly title: "Adjusted quantity notice";
+        readonly description: "value is the corrected amount, in the unit shown to the shopper.";
+        readonly format: "icu-message";
+        readonly messageSource: "Quantity adjusted to {value}.";
+        readonly messageArguments: {
+          readonly type: "object";
+          readonly properties: {
+            readonly value: {
+              readonly type: "number";
+            };
+          };
+        };
+        readonly messageExample: {
+          readonly value: 3;
+        };
+      };
+    };
+  };
+};
+export declare const CartItemRemoveContent: {
+  readonly id: "cart-item-remove";
+  readonly title: "Cart Item Remove";
+  readonly description: "The toast raised after a line is removed.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly removedMessage: {
+        readonly type: "string";
+        readonly title: "Removed message";
+        readonly format: "icu-message";
+        readonly messageSource: "Item removed";
+      };
+    };
+  };
+};
+export declare const CartItemUnavailableContent: {
+  readonly id: "cart-item-unavailable";
+  readonly title: "Cart Item Unavailable";
+  readonly description: "The status label of a line that cannot be bought, one per availability state.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly outOfStockLabel: {
+        readonly type: "string";
+        readonly title: "Out of stock label";
+        readonly format: "icu-message";
+        readonly messageSource: "Out of stock";
+      };
+      readonly cannotBeDeliveredLabel: {
+        readonly type: "string";
+        readonly title: "Cannot be delivered label";
+        readonly format: "icu-message";
+        readonly messageSource: "Cannot be delivered";
+      };
+      readonly unavailableLabel: {
+        readonly type: "string";
+        readonly title: "Unavailable label";
+        readonly description: "Any other state the line cannot be bought in.";
+        readonly format: "icu-message";
+        readonly messageSource: "Unavailable";
+      };
+    };
+  };
+};
+export declare const CartItemGiftContent: {
+  readonly id: "cart-item-gift";
+  readonly title: "Cart Item Gift";
+  readonly description: "The marker of a promotional gift line.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly label: {
+        readonly type: "string";
+        readonly title: "Gift label";
+        readonly format: "icu-message";
+        readonly messageSource: "Free";
+      };
+    };
+  };
+};
 export type CartItemRootProps = ComponentPropsWithRef<'div'> & {
   /**
    * Per-line slice delivered by the `reactive-list-item` runtime (`ReactiveListItemDataProvider`) —
@@ -23,8 +146,8 @@ export type CartItemVariantProps = ComponentPropsWithRef<'span'>;
 export type CartItemSkuProps = ComponentPropsWithRef<'span'>;
 export type CartItemPriceProps = ComponentPropsWithRef<'span'>;
 export type CartItemListPriceProps = ComponentPropsWithRef<'span'>;
-export type CartItemDiscountPercentageProps = ComponentPropsWithRef<'span'> & {
-  template?: string;
+export type CartItemDiscountPercentageProps = ComponentPropsWithRef<'span'> & MessageLocaleProp & {
+  $content?: ContentValue<typeof CartItemDiscountPercentageContent>;
 };
 export type CartItemLineTotalProps = ComponentPropsWithRef<'span'>;
 export type CartItemOwnTotalProps = ComponentPropsWithRef<'span'>;
@@ -39,7 +162,7 @@ export type CartItemQuantitySlice = {
     unitMultiplier: number;
   } | null;
 };
-export type CartItemQuantityProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'value'> & {
+export type CartItemQuantityProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'value'> & MessageLocaleProp & {
   /** Minimum, in purchasable units — not in the unit shown to the shopper. */
   min?: number;
   /** Maximum, in purchasable units. Unbounded when unset. */
@@ -47,22 +170,28 @@ export type CartItemQuantityProps = Omit<ComponentPropsWithRef<'div'>, 'defaultV
   /** Step, in purchasable units: one step moves the display by one unit multiplier. */
   step?: number;
   removeOnDecrement?: boolean;
-  /** Snap-notice template; `{value}` is replaced with the corrected displayed amount. */
-  validationMessage?: string;
   children?: ReactNode;
   /** Per-line slice from the reactive-list-item runtime; injected/overridden by the wrapper. */
   $data?: CartItemQuantitySlice | null;
   /** Injected by the compiler from `actions: { cart: [...] }`; the cart write surface. */
   $actions?: ComponentActions;
+  /** The snap notice; its `value` argument is the corrected displayed amount. */
+  $content?: ContentValue<typeof CartItemQuantityContent>;
 };
 export type CartItemQuantityValueProps = ComponentPropsWithRef<'span'>;
-export type CartItemRemoveProps = ComponentPropsWithRef<'button'> & {
+export type CartItemRemoveProps = ComponentPropsWithRef<'button'> & MessageLocaleProp & {
   /** Injected by the compiler from `actions: { cart: ['removeItem'] }`; the cart write surface. */
   $actions?: ComponentActions;
+  /** The title of the toast raised after a removal that returns no errors. */
+  $content?: ContentValue<typeof CartItemRemoveContent>;
 };
 export type CartItemAvailableProps = ComponentPropsWithRef<'div'>;
-export type CartItemUnavailableProps = ComponentPropsWithRef<'div'>;
-export type CartItemGiftProps = ComponentPropsWithRef<'span'>;
+export type CartItemUnavailableProps = ComponentPropsWithRef<'div'> & MessageLocaleProp & {
+  $content?: ContentValue<typeof CartItemUnavailableContent>;
+};
+export type CartItemGiftProps = ComponentPropsWithRef<'span'> & MessageLocaleProp & {
+  $content?: ContentValue<typeof CartItemGiftContent>;
+};
 export declare const CartItemRootDefinition: ComponentDefinition<CartItemRootProps>;
 export declare const CartItemImageDefinition: ComponentDefinition<CartItemImageProps>;
 export declare const CartItemProductLinkDefinition: ComponentDefinition<CartItemProductLinkProps>;
@@ -79,25 +208,25 @@ export declare const CartItemQuantityDefinition: ComponentDefinition<CartItemQua
 export declare const CartItemQuantityValueDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>>;
 export declare const CartItemRemoveDefinition: ComponentDefinition<CartItemRemoveProps>;
 export declare const CartItemAvailableDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
-export declare const CartItemUnavailableDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
-export declare const CartItemGiftDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>>;
+export declare const CartItemUnavailableDefinition: ComponentDefinition<CartItemUnavailableProps>;
+export declare const CartItemGiftDefinition: ComponentDefinition<CartItemGiftProps>;
 export declare function CartItemRoot({ $data: $dataProp, className, children, ...props }: CartItemRootProps): import("react/jsx-runtime").JSX.Element;
-export declare function CartItemImage({ className, objectFit, ...props }: CartItemImageProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartItemImage({ className, objectFit, ref, onError, ...props }: CartItemImageProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartItemProductLink({ className, children, ...props }: Readonly<CartItemProductLinkProps>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
 export declare function CartItemName({ className, children, ...props }: CartItemNameProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartItemVariant({ className, children, ...props }: CartItemVariantProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartItemSku({ className, children, ...props }: CartItemSkuProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartItemPrice({ className, children, ...props }: CartItemPriceProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartItemListPrice({ className, children, ...props }: CartItemListPriceProps): import("react/jsx-runtime").JSX.Element | null;
-export declare function CartItemDiscountPercentage({ template, className, children, ...props }: CartItemDiscountPercentageProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartItemDiscountPercentage({ $content, $locale, className, children, ...props }: CartItemDiscountPercentageProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartItemLineTotal({ className, children, ...props }: CartItemLineTotalProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartItemOwnTotal({ className, children, ...props }: CartItemOwnTotalProps): import("react/jsx-runtime").JSX.Element;
 export declare function CartItemAggregateTotal({ className, children, ...props }: CartItemAggregateTotalProps): import("react/jsx-runtime").JSX.Element;
-export declare function CartItemQuantity({ className, children, min, max, step, removeOnDecrement, validationMessage, $data: $dataProp, $actions: $actionsProp, ...props }: CartItemQuantityProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartItemQuantity({ className, children, min, max, step, removeOnDecrement, $data: $dataProp, $actions: $actionsProp, $content, $locale, ...props }: CartItemQuantityProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartItemQuantityValue({ className, children, ...props }: CartItemQuantityValueProps): import("react/jsx-runtime").JSX.Element;
-export declare function CartItemRemove({ className, children, onClick, $actions: $actionsProp, ...props }: CartItemRemoveProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartItemRemove({ className, children, onClick, disabled, $actions: $actionsProp, $content, $locale, ...props }: CartItemRemoveProps): import("react/jsx-runtime").JSX.Element | null;
 export declare function CartItemAvailable({ className, children, ...props }: CartItemAvailableProps): import("react/jsx-runtime").JSX.Element | null;
-export declare function CartItemUnavailable({ className, children, ...props }: CartItemUnavailableProps): import("react/jsx-runtime").JSX.Element | null;
-export declare function CartItemGift({ className, children, ...props }: CartItemGiftProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartItemUnavailable({ $content, $locale, className, children, ...props }: CartItemUnavailableProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CartItemGift({ $content, $locale, className, children, ...props }: CartItemGiftProps): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
 //# sourceMappingURL=cart-item.d.ts.map