@vtex/faststore 0.0.10 → 0.0.11

package/dist/matter/shipping-simulator/shipping-simulator.js.map

@@ -1 +1 @@
-{"version":3,"file":"shipping-simulator.js","names":[],"sources":["../../../src/matter/shipping-simulator/shipping-simulator.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { createContext, useCallback, useContext, useMemo, useRef, useState } from 'react';\nimport { useStorefrontContext } from '../../sdk/context/storefront-context.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { FormattedMessage, type MessageId, useIntl } from '../../sdk/i18n/client.js';\nimport type { CartShippingSimulateInput } from '../../sdk/shipping/cart-operations.js';\nimport type { ShippingSimulateInput } from '../../sdk/shipping/operations.js';\nimport { useCartShippingSimulation } from '../../sdk/shipping/use-cart-shipping-simulation.js';\nimport { useShippingSimulation } from '../../sdk/shipping/use-shipping-simulation.js';\nimport { isFiniteAmount } from '../cart/cart.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment\n// ---------------------------------------------------------------------------\n\nconst fragment = /* GraphQL */ `\n  fragment ShippingSimulatorData on Query {\n    productBySlug(slug: $slug) {\n      variants(first: 1) {\n        edges {\n          node {\n            id\n            sellers {\n              id\n              isDefault\n            }\n          }\n        }\n      }\n    }\n  }\n`;\n\n// ---------------------------------------------------------------------------\n// Raw data types (shape of the fragment result)\n// ---------------------------------------------------------------------------\n\ntype RawShippingSimulatorData = {\n  variants: {\n    edges: Array<{\n      node: {\n        id: string;\n        sellers: Array<{\n          id: string;\n          isDefault: boolean;\n        }>;\n      };\n    }>;\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Domain types (mirror the shippingSimulation GraphQL contract)\n// ---------------------------------------------------------------------------\n\ntype MoneyValue = { amount: string; currencyCode: string };\n\ntype DeliveryChannel = 'DELIVERY' | 'PICKUP' | 'UNKNOWN';\n\nexport type ShippingEstimateUnit = 'BUSINESS_DAYS' | 'DAYS' | 'HOURS' | 'MINUTES';\n\ntype ShippingEstimate = { value: number; unit: ShippingEstimateUnit };\n\n// Exported alongside `ShippingSimulatorContextValue` so `DeliveryOptionsRoot`\n// (matter/delivery-options) can type against the exact shape the reused leaves expect, with no\n// structural duplication (docs/storefront-core/reference-free-particle-model.md § Read side — state).\nexport type ShippingOption = {\n  id: string;\n  name: string;\n  channel: DeliveryChannel;\n  shippingEstimate: ShippingEstimate;\n  price: MoneyValue;\n  listPrice: MoneyValue;\n};\n\ntype ShippingSimulateErrorCode = 'INVALID_POSTAL_CODE' | 'UNKNOWN';\n\n// Exported with `ShippingSimulationPayload` so the `./client` entry can name the simulate callback's\n// whole contract — the SDK hooks return it and a store writing its own `onSimulate` has to name it.\nexport type ShippingSimulateError = {\n  code: ShippingSimulateErrorCode;\n  message: string;\n};\n\nexport type ShippingSimulationPayload = {\n  shippingOptions: ShippingOption[] | null;\n  userErrors: ShippingSimulateError[];\n};\n\ntype Status = 'idle' | 'loading' | 'success' | 'error';\n\nexport type ShippingSimulatorContextValue = {\n  postalCode: string;\n  setPostalCode: (value: string) => void;\n  status: Status;\n  shippingOptions: ShippingOption[] | null;\n  userErrors: ShippingSimulateError[];\n  submit: () => void;\n};\n\nconst SHIPPING_SIMULATOR_CONTEXT_UNSET = Symbol('ShippingSimulatorContextUnset');\n\nexport type ShippingSimulatorRootProps = ComponentPropsWithRef<'div'> & {\n  country?: string;\n  quantity?: number;\n  variantId?: string;\n  seller?: string;\n  $data?: RawShippingSimulatorData | null;\n  shippingOptions?: ShippingOption[];\n  userErrors?: ShippingSimulateError[];\n  onSimulate?: (input: ShippingSimulateInput) => Promise<ShippingSimulationPayload>;\n  onResult?: (result: ShippingSimulationPayload) => void;\n};\n\nexport type CartShippingSimulatorRootProps = ComponentPropsWithRef<'div'> & {\n  country?: string;\n  shippingOptions?: ShippingOption[];\n  userErrors?: ShippingSimulateError[];\n  onSimulate?: (input: CartShippingSimulateInput) => Promise<ShippingSimulationPayload>;\n  onResult?: (result: ShippingSimulationPayload) => void;\n};\n\nexport type ShippingSimulatorFormProps = ComponentPropsWithRef<'form'>;\n\nexport type ShippingSimulatorInputProps = Omit<ComponentPropsWithRef<'input'>, 'value' | 'onChange'> & {\n  format?: boolean;\n};\n\nexport type ShippingSimulatorSubmitProps = ComponentPropsWithRef<'button'>;\n\nexport type ShippingSimulatorLoadingProps = ComponentPropsWithRef<'output'>;\n\nexport type ShippingSimulatorErrorProps = ComponentPropsWithRef<'div'>;\n\nexport type ShippingSimulatorOptionsProps = ComponentPropsWithRef<'ul'> & {\n  sortBy?: 'price' | 'estimate';\n  maxOptions?: number;\n};\n\nexport type ShippingSimulatorOptionProps = ComponentPropsWithRef<'li'>;\n\nexport type ShippingSimulatorOptionNameProps = ComponentPropsWithRef<'span'>;\n\nexport type ShippingSimulatorOptionEstimateProps = ComponentPropsWithRef<'span'>;\n\nexport type ShippingSimulatorOptionPriceProps = ComponentPropsWithRef<'span'>;\n\nexport type ShippingSimulatorOptionFreeBadgeProps = ComponentPropsWithRef<'span'>;\n\nexport type ShippingSimulatorEmptyProps = ComponentPropsWithRef<'output'>;\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\n// Exported so `DeliveryOptionsRoot` can become a third provider by importing these same Context\n// objects directly (context matching is by identity, not shape). The two hooks below stay\n// module-private — providers need the objects, not the consumer API (Decision 2).\nexport const ShippingSimulatorContext = createContext<\n  ShippingSimulatorContextValue | typeof SHIPPING_SIMULATOR_CONTEXT_UNSET\n>(SHIPPING_SIMULATOR_CONTEXT_UNSET);\n\nexport const OptionItemContext = createContext<ShippingOption | null>(null);\n\nfunction useShippingSimulator(): ShippingSimulatorContextValue {\n  const ctx = useContext(ShippingSimulatorContext);\n  if (ctx === SHIPPING_SIMULATOR_CONTEXT_UNSET) {\n    throw new Error('ShippingSimulator components must be used inside ShippingSimulatorRoot.');\n  }\n  return ctx;\n}\n\nfunction useOptionItem(): ShippingOption {\n  const ctx = useContext(OptionItemContext);\n  if (!ctx) {\n    throw new Error('ShippingSimulatorOption components must be used inside ShippingSimulatorOptions.');\n  }\n  return ctx;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction formatPrice(value: number, locale: string, currency: string): string {\n  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value);\n}\n\n// Each unit's whole sentence, and the variable that sentence names.\n//\n// Whole sentence, not a unit fragment interpolated into a wrapper: interpolating a translated\n// fragment into a translated wrapper freezes \"preposition + noun\" order into every language, and\n// hands the translator `em {estimate}` with no way to agree preposition, article or case with a noun\n// they cannot see. The variable is named after what it counts (`{days}`, `{hours}`) rather than a\n// generic `{count}`, for the same reason.\n//\n// A `Record` and not a `switch` with a default: a fifth unit arriving in the GraphQL schema is a\n// type error here, not a silent fallback to the wrong sentence.\n//\n// `variable` is the union of the names those sentences read, never `string`: widened, a typo passes\n// typecheck, lint and every test, and the shopper gets the raw ICU pattern because `onIntlError` is\n// silent in production. The parity assertion in the test file closes the other half of the gap — that\n// the name written here is the one the catalog's message actually names.\nexport const ESTIMATE_MESSAGE: Record<ShippingEstimateUnit, { id: MessageId; variable: 'days' | 'hours' | 'minutes' }> =\n  {\n    BUSINESS_DAYS: { id: 'fs/shipping.estimate.in-business-days', variable: 'days' },\n    DAYS: { id: 'fs/shipping.estimate.in-days', variable: 'days' },\n    HOURS: { id: 'fs/shipping.estimate.in-hours', variable: 'hours' },\n    MINUTES: { id: 'fs/shipping.estimate.in-minutes', variable: 'minutes' },\n  };\n\n// Business days weigh the same as calendar days: exact wall-clock conversion is unknowable and\n// the ranking only needs a consistent order.\nconst ESTIMATE_UNIT_MINUTES: Record<ShippingEstimateUnit, number> = {\n  MINUTES: 1,\n  HOURS: 60,\n  DAYS: 1440,\n  BUSINESS_DAYS: 1440,\n};\n\nfunction sortShippingOptions(options: readonly ShippingOption[], sortBy: 'price' | 'estimate'): ShippingOption[] {\n  const rank =\n    sortBy === 'price'\n      ? (option: ShippingOption) => Number(option.price.amount)\n      : (option: ShippingOption) => option.shippingEstimate.value * ESTIMATE_UNIT_MINUTES[option.shippingEstimate.unit];\n  return [...options].sort((a, b) => rank(a) - rank(b));\n}\n\nfunction normalizePostalCode(value: string): string {\n  return value.replace(/\\D/g, '').slice(0, 8);\n}\n\nfunction formatPostalCode(value: string): string {\n  const digits = normalizePostalCode(value);\n  return digits.length > 5 ? `${digits.slice(0, 5)}-${digits.slice(5)}` : digits;\n}\n\nfunction extractProductFromData(data: RawShippingSimulatorData | null | undefined): {\n  variantId: string | null;\n  seller: string | null;\n} {\n  if (!data) return { variantId: null, seller: null };\n  const edge = data.variants?.edges?.[0];\n  if (!edge) return { variantId: null, seller: null };\n  const { id, sellers } = edge.node;\n  const defaultSeller = sellers?.find((s) => s.isDefault) ?? sellers?.[0];\n  return { variantId: id ?? null, seller: defaultSeller?.id ?? null };\n}\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const ShippingSimulatorRootDefinition = defineComponent<ShippingSimulatorRootProps>({\n  name: 'ShippingSimulatorRoot',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  editor: { label: 'Shipping Simulator', category: 'commerce' },\n  schema: {\n    country: { type: 'string', default: 'BRA', label: 'Country (ISO-3)' },\n    quantity: { type: 'number', default: 1, label: 'Quantity' },\n  },\n  providesContext: 'shipping-simulator',\n  guideline:\n    'Root container for the PDP shipping simulator: a shopper types a postal code and sees a shipping preview for ONE product on a product detail page. Backed by shippingSimulation and a product fragment (productBySlug(slug: $slug)), so it must live on a page with a $slug variable. Use CartShippingSimulatorRoot instead for a whole-cart calculator in the cart/mini-cart. All other ShippingSimulator components must be descendants of this one.',\n});\n\nexport const CartShippingSimulatorRootDefinition = defineComponent<CartShippingSimulatorRootProps>({\n  name: 'CartShippingSimulatorRoot',\n  importPath: '@vtex/faststore/components',\n  component: CartShippingSimulatorRoot,\n  editor: { label: 'Cart Shipping Simulator', category: 'commerce' },\n  schema: {\n    country: { type: 'string', default: 'BRA', label: 'Country (ISO-3)' },\n  },\n  providesContext: 'shipping-simulator',\n  guideline:\n    'Root container for the cart/mini-cart shipping calculator: the shopper types a postal code and sees the shipping options for the WHOLE cart. Backed by cartShippingSimulation (cart sourced server-side via x-order-form-id); needs no CartRoot ancestor and no product fragment. Use ShippingSimulatorRoot instead for a single-product shipping preview on a PDP. All other CartShippingSimulator components must be descendants of this one.',\n});\n\nexport const ShippingSimulatorFormDefinition = defineComponent<ShippingSimulatorFormProps>({\n  name: 'ShippingSimulatorForm',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorForm,\n  editor: { label: 'Shipping Simulator Form', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Form wrapper that holds ShippingSimulatorInput and ShippingSimulatorSubmit; must be a descendant of ShippingSimulatorRoot.',\n});\n\nexport const ShippingSimulatorInputDefinition = defineComponent<ShippingSimulatorInputProps>({\n  name: 'ShippingSimulatorInput',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorInput,\n  editor: { label: 'Shipping Simulator Input', category: 'action' },\n  schema: {\n    format: { type: 'boolean', default: false, label: 'Auto-format CEP (00000-000)' },\n  },\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Postal-code text input; enable `format` to auto-hyphenate the CEP as the user types (e.g. 01310-100). The placeholder comes from the message catalog. Must be a descendant of ShippingSimulatorForm.',\n});\n\nexport const ShippingSimulatorSubmitDefinition = defineComponent<ShippingSimulatorSubmitProps>({\n  name: 'ShippingSimulatorSubmit',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorSubmit,\n  editor: { label: 'Shipping Simulator Submit', category: 'action' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline: 'Submit button for the postal-code form; must be a descendant of ShippingSimulatorForm.',\n});\n\nexport const ShippingSimulatorLoadingDefinition = defineComponent<ShippingSimulatorLoadingProps>({\n  name: 'ShippingSimulatorLoading',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorLoading,\n  editor: { label: 'Shipping Simulator Loading', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Loading indicator shown while a simulation is in progress; must be a descendant of ShippingSimulatorRoot.',\n});\n\nexport const ShippingSimulatorErrorDefinition = defineComponent<ShippingSimulatorErrorProps>({\n  name: 'ShippingSimulatorError',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorError,\n  editor: { label: 'Shipping Simulator Error', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Error banner shown when the simulation returns validation errors; must be a descendant of ShippingSimulatorRoot.',\n});\n\nexport const ShippingSimulatorOptionsDefinition = defineComponent<ShippingSimulatorOptionsProps>({\n  name: 'ShippingSimulatorOptions',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptions,\n  editor: { label: 'Shipping Simulator Options', category: 'commerce' },\n  schema: {\n    sortBy: { type: ['price', 'estimate'] as const, label: 'Sort by' },\n    maxOptions: { type: 'number', label: 'Max options' },\n  },\n  requiresContext: 'shipping-simulator',\n  providesContext: 'shipping-simulator-option',\n  guideline:\n    'List that renders one ShippingSimulatorOption per available shipping option; must be a descendant of a shipping-simulator Root (PDP or cart). Renders every option in API order by default; set sortBy (\"price\" = cheapest first, \"estimate\" = fastest first) and maxOptions to cap the list — sortBy=\"price\" with maxOptions=1 shows only the cheapest option. See shipping-simulator.md.',\n});\n\nexport const ShippingSimulatorOptionDefinition = defineComponent<ShippingSimulatorOptionProps>({\n  name: 'ShippingSimulatorOption',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOption,\n  editor: { label: 'Shipping Simulator Option', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Container for a single shipping option row; holds ShippingSimulatorOptionName, ShippingSimulatorOptionEstimate, and ShippingSimulatorOptionPrice. Must be a descendant of ShippingSimulatorOptions.',\n});\n\nexport const ShippingSimulatorOptionNameDefinition = defineComponent<ShippingSimulatorOptionNameProps>({\n  name: 'ShippingSimulatorOptionName',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionName,\n  editor: { label: 'Option Name', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Displays the shipping option name (e.g. \"Entrega Normal\"); must be a descendant of ShippingSimulatorOption.',\n});\n\nexport const ShippingSimulatorOptionEstimateDefinition = defineComponent<ShippingSimulatorOptionEstimateProps>({\n  name: 'ShippingSimulatorOptionEstimate',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionEstimate,\n  editor: { label: 'Option Estimate', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Displays the delivery estimate in the active locale, one whole sentence per unit from the message catalog; a zero-value estimate (any unit) reads as an arrival-today message instead, since \"chega em 0 dias úteis\" reads wrong. Must be a descendant of ShippingSimulatorOption.',\n});\n\nexport const ShippingSimulatorOptionPriceDefinition = defineComponent<ShippingSimulatorOptionPriceProps>({\n  name: 'ShippingSimulatorOptionPrice',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionPrice,\n  editor: { label: 'Option Price', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Displays the shipping price, showing the free-shipping label from the message catalog when the amount is zero; must be a descendant of ShippingSimulatorOption.',\n});\n\nexport const ShippingSimulatorOptionFreeBadgeDefinition = defineComponent<ShippingSimulatorOptionFreeBadgeProps>({\n  name: 'ShippingSimulatorOptionFreeBadge',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionFreeBadge,\n  editor: { label: 'Option Free Badge', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Badge shown only when the current option price is zero (free shipping); renders nothing otherwise. Must be a descendant of ShippingSimulatorOption. Orthogonal to the free-price replacement text owned by ShippingSimulatorOptionPrice.',\n});\n\nexport const ShippingSimulatorEmptyDefinition = defineComponent<ShippingSimulatorEmptyProps>({\n  name: 'ShippingSimulatorEmpty',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorEmpty,\n  editor: { label: 'Shipping Simulator Empty', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Message shown when a simulation ran and returned no shipping options (e.g. no carrier common to the whole cart). Renders nothing before the first submit and nothing when options or an error are present. The copy comes from the message catalog; pass children to override. Must be a descendant of a shipping-simulator Root.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\nexport function ShippingSimulatorRoot({\n  country = 'BRA',\n  quantity = 1,\n  variantId: variantIdProp,\n  seller: sellerProp,\n  $data: $dataProp,\n  shippingOptions: shippingOptionsProp,\n  userErrors: userErrorsProp,\n  onSimulate: onSimulateProp,\n  onResult,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorRootProps) {\n  const defaultSimulate = useShippingSimulation();\n  const onSimulate = onSimulateProp ?? defaultSimulate;\n  const intl = useIntl();\n\n  const $data = useDataOverride($dataProp);\n  const extracted = extractProductFromData($data);\n  const variantId = variantIdProp ?? extracted.variantId;\n  const seller = sellerProp ?? extracted.seller;\n\n  const [postalCode, setPostalCode] = useState('');\n  const [status, setStatus] = useState<Status>(() => {\n    if (userErrorsProp?.length) return 'error';\n    if (shippingOptionsProp) return 'success';\n    return 'idle';\n  });\n  const [shippingOptions, setShippingOptions] = useState<ShippingOption[] | null>(shippingOptionsProp ?? null);\n  const [userErrors, setUserErrors] = useState<ShippingSimulateError[]>(userErrorsProp ?? []);\n\n  const submissionToken = useRef(0);\n\n  const submit = useCallback(() => {\n    if (!onSimulate || !variantId || !seller) return;\n\n    const normalizedCep = normalizePostalCode(postalCode);\n    if (normalizedCep.length !== 8) return;\n\n    const token = ++submissionToken.current;\n    setStatus('loading');\n    setShippingOptions(null);\n    setUserErrors([]);\n\n    onSimulate({ postalCode: normalizedCep, country, variantId, quantity, seller })\n      .then((result) => {\n        if (submissionToken.current !== token) return;\n        setShippingOptions(result.shippingOptions);\n        setUserErrors(result.userErrors);\n        setStatus(result.userErrors.length > 0 ? 'error' : 'success');\n        onResult?.(result);\n      })\n      .catch(() => {\n        if (submissionToken.current !== token) return;\n        // In a handler, not a render: the message goes into state, where only a string fits.\n        const fallback: ShippingSimulateError = {\n          code: 'UNKNOWN',\n          message: intl.formatMessage({ id: 'fs/shipping.calculation-failed' }),\n        };\n        setShippingOptions(null);\n        setUserErrors([fallback]);\n        setStatus('error');\n        onResult?.({ shippingOptions: null, userErrors: [fallback] });\n      });\n  }, [country, intl, onResult, onSimulate, postalCode, quantity, seller, variantId]);\n\n  const contextValue = useMemo<ShippingSimulatorContextValue>(\n    () => ({\n      postalCode,\n      setPostalCode,\n      status,\n      shippingOptions,\n      userErrors,\n      submit,\n    }),\n    [postalCode, status, shippingOptions, userErrors, submit],\n  );\n\n  return (\n    <ShippingSimulatorContext value={contextValue}>\n      <div {...props} className={className} data-fs-shipping-simulator=\"\">\n        {children}\n      </div>\n    </ShippingSimulatorContext>\n  );\n}\n\nexport function CartShippingSimulatorRoot({\n  country = 'BRA',\n  shippingOptions: shippingOptionsProp,\n  userErrors: userErrorsProp,\n  onSimulate: onSimulateProp,\n  onResult,\n  className,\n  children,\n  ...props\n}: CartShippingSimulatorRootProps) {\n  const defaultSimulate = useCartShippingSimulation();\n  const onSimulate = onSimulateProp ?? defaultSimulate;\n  const intl = useIntl();\n\n  const [postalCode, setPostalCode] = useState('');\n  const [status, setStatus] = useState<Status>(() => {\n    if (userErrorsProp?.length) return 'error';\n    if (shippingOptionsProp) return 'success';\n    return 'idle';\n  });\n  const [shippingOptions, setShippingOptions] = useState<ShippingOption[] | null>(shippingOptionsProp ?? null);\n  const [userErrors, setUserErrors] = useState<ShippingSimulateError[]>(userErrorsProp ?? []);\n\n  const submissionToken = useRef(0);\n\n  const submit = useCallback(() => {\n    const normalizedCep = normalizePostalCode(postalCode);\n    if (normalizedCep.length !== 8) return;\n\n    const token = ++submissionToken.current;\n    setStatus('loading');\n    setShippingOptions(null);\n    setUserErrors([]);\n\n    onSimulate({ postalCode: normalizedCep, country })\n      .then((result) => {\n        if (submissionToken.current !== token) return;\n        setShippingOptions(result.shippingOptions);\n        setUserErrors(result.userErrors);\n        setStatus(result.userErrors.length > 0 ? 'error' : 'success');\n        onResult?.(result);\n      })\n      .catch(() => {\n        if (submissionToken.current !== token) return;\n        // In a handler, not a render: the message goes into state, where only a string fits.\n        const fallback: ShippingSimulateError = {\n          code: 'UNKNOWN',\n          message: intl.formatMessage({ id: 'fs/shipping.calculation-failed' }),\n        };\n        setShippingOptions(null);\n        setUserErrors([fallback]);\n        setStatus('error');\n        onResult?.({ shippingOptions: null, userErrors: [fallback] });\n      });\n  }, [country, intl, onResult, onSimulate, postalCode]);\n\n  const contextValue = useMemo<ShippingSimulatorContextValue>(\n    () => ({\n      postalCode,\n      setPostalCode,\n      status,\n      shippingOptions,\n      userErrors,\n      submit,\n    }),\n    [postalCode, status, shippingOptions, userErrors, submit],\n  );\n\n  return (\n    <ShippingSimulatorContext value={contextValue}>\n      <div {...props} className={className} data-fs-shipping-simulator=\"\">\n        {children}\n      </div>\n    </ShippingSimulatorContext>\n  );\n}\n\nexport function ShippingSimulatorForm({ className, children, ...props }: ShippingSimulatorFormProps) {\n  const { submit } = useShippingSimulator();\n\n  return (\n    <form\n      {...props}\n      className={className}\n      data-fs-shipping-simulator-form=\"\"\n      onSubmit={(event) => {\n        event.preventDefault();\n        submit();\n      }}\n    >\n      {children}\n    </form>\n  );\n}\n\nexport function ShippingSimulatorInput({\n  className,\n  placeholder,\n  'aria-label': ariaLabel,\n  format = false,\n  ...props\n}: ShippingSimulatorInputProps) {\n  const { postalCode, setPostalCode } = useShippingSimulator();\n  const intl = useIntl();\n  const displayValue = format ? formatPostalCode(postalCode) : postalCode;\n\n  return (\n    <input\n      {...props}\n      aria-label={ariaLabel ?? intl.formatMessage({ id: 'fs/shipping.postal-code.aria-label' })}\n      className={className}\n      data-fs-shipping-simulator-input=\"\"\n      type=\"text\"\n      value={displayValue}\n      onChange={(event) => setPostalCode(normalizePostalCode(event.target.value))}\n      placeholder={placeholder ?? intl.formatMessage({ id: 'fs/shipping.postal-code.placeholder' })}\n      pattern=\"\\d{5}-?\\d{3}\"\n      maxLength={9}\n      inputMode=\"numeric\"\n      required\n    />\n  );\n}\n\nexport function ShippingSimulatorSubmit({ className, children, disabled, ...props }: ShippingSimulatorSubmitProps) {\n  const { status } = useShippingSimulator();\n  const isLoading = status === 'loading';\n\n  return (\n    <button\n      {...props}\n      type=\"submit\"\n      className={className}\n      data-fs-shipping-simulator-submit=\"\"\n      disabled={disabled || isLoading}\n      aria-busy={isLoading}\n    >\n      {children}\n    </button>\n  );\n}\n\nexport function ShippingSimulatorLoading({ className, children, ...props }: ShippingSimulatorLoadingProps) {\n  const { status } = useShippingSimulator();\n  if (status !== 'loading') return null;\n\n  return (\n    <output {...props} aria-live=\"polite\" className={className} data-fs-shipping-simulator-loading=\"\">\n      {children ?? <FormattedMessage id=\"fs/shipping.calculating\" />}\n    </output>\n  );\n}\n\nexport function ShippingSimulatorError({ className, children, ...props }: ShippingSimulatorErrorProps) {\n  const { userErrors } = useShippingSimulator();\n  const [firstError] = userErrors;\n  if (!firstError) return null;\n\n  return (\n    <div {...props} role=\"alert\" className={className} data-fs-shipping-simulator-error=\"\">\n      {children ?? firstError.message}\n    </div>\n  );\n}\n\nexport function ShippingSimulatorOptions({\n  sortBy,\n  maxOptions,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionsProps) {\n  const { shippingOptions } = useShippingSimulator();\n\n  const visibleOptions = useMemo(() => {\n    if (!shippingOptions) return null;\n    const sorted = sortBy ? sortShippingOptions(shippingOptions, sortBy) : shippingOptions;\n    return maxOptions && maxOptions > 0 ? sorted.slice(0, maxOptions) : sorted;\n  }, [shippingOptions, sortBy, maxOptions]);\n\n  if (!visibleOptions || visibleOptions.length === 0) return null;\n\n  return (\n    <ul {...props} className={className} data-fs-shipping-simulator-options=\"\">\n      {visibleOptions.map((option) => (\n        <OptionItemContext key={option.id} value={option}>\n          {children}\n        </OptionItemContext>\n      ))}\n    </ul>\n  );\n}\n\nexport function ShippingSimulatorOption({ className, children, ...props }: ShippingSimulatorOptionProps) {\n  const option = useOptionItem();\n\n  return (\n    <li\n      {...props}\n      className={className}\n      data-fs-shipping-simulator-option=\"\"\n      data-fs-shipping-simulator-option-channel={option.channel}\n    >\n      {children}\n    </li>\n  );\n}\n\nexport function ShippingSimulatorOptionName({ className, children, ...props }: ShippingSimulatorOptionNameProps) {\n  const option = useOptionItem();\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-name=\"\">\n      {children ?? option.name}\n    </span>\n  );\n}\n\nexport function ShippingSimulatorOptionEstimate({\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionEstimateProps) {\n  const option = useOptionItem();\n  const intl = useIntl();\n  const { value, unit } = option.shippingEstimate;\n  const { id, variable } = ESTIMATE_MESSAGE[unit];\n  const text =\n    value === 0\n      ? intl.formatMessage({ id: 'fs/shipping.estimate.today' })\n      : intl.formatMessage({ id }, { [variable]: value });\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-estimate=\"\">\n      {children ?? text}\n    </span>\n  );\n}\n\nfunction isFreeAmount(amount: unknown): boolean {\n  return isFiniteAmount(amount) && Number(amount) === 0;\n}\n\nexport function ShippingSimulatorOptionPrice({ className, children, ...props }: ShippingSimulatorOptionPriceProps) {\n  const option = useOptionItem();\n  const intl = useIntl();\n  const { locale, currency } = useStorefrontContext();\n  const text = isFreeAmount(option.price.amount)\n    ? intl.formatMessage({ id: 'fs/shipping.free-price' })\n    : formatPrice(Number(option.price.amount), locale, currency);\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-price=\"\">\n      {children ?? text}\n    </span>\n  );\n}\n\nexport function ShippingSimulatorOptionFreeBadge({\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionFreeBadgeProps) {\n  const option = useOptionItem();\n  if (!isFreeAmount(option.price.amount)) return null;\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-free-badge=\"\">\n      {children ?? <FormattedMessage id=\"fs/shipping.free-badge\" />}\n    </span>\n  );\n}\n\nexport function ShippingSimulatorEmpty({ className, children, ...props }: ShippingSimulatorEmptyProps) {\n  const { shippingOptions, userErrors } = useShippingSimulator();\n  // Idle (null) → nothing; error → nothing (Error owns it); options present → nothing.\n  const simulatedEmpty = Array.isArray(shippingOptions) && shippingOptions.length === 0 && userErrors.length === 0;\n  if (!simulatedEmpty) return null;\n\n  return (\n    <output {...props} aria-live=\"polite\" className={className} data-fs-shipping-simulator-empty=\"\">\n      {children ?? <FormattedMessage id=\"fs/shipping.no-options\" />}\n    </output>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Namespace export\n// ---------------------------------------------------------------------------\n\nexport const ShippingSimulator = {\n  Root: ShippingSimulatorRoot,\n  Form: ShippingSimulatorForm,\n  Input: ShippingSimulatorInput,\n  Submit: ShippingSimulatorSubmit,\n  Loading: ShippingSimulatorLoading,\n  Error: ShippingSimulatorError,\n  Options: ShippingSimulatorOptions,\n  Option: ShippingSimulatorOption,\n  OptionName: ShippingSimulatorOptionName,\n  OptionEstimate: ShippingSimulatorOptionEstimate,\n  OptionPrice: ShippingSimulatorOptionPrice,\n  OptionFreeBadge: ShippingSimulatorOptionFreeBadge,\n  Empty: ShippingSimulatorEmpty,\n};\n\nexport const CartShippingSimulator = {\n  Root: CartShippingSimulatorRoot,\n  Form: ShippingSimulatorForm,\n  Input: ShippingSimulatorInput,\n  Submit: ShippingSimulatorSubmit,\n  Loading: ShippingSimulatorLoading,\n  Error: ShippingSimulatorError,\n  Options: ShippingSimulatorOptions,\n  Option: ShippingSimulatorOption,\n  OptionName: ShippingSimulatorOptionName,\n  OptionEstimate: ShippingSimulatorOptionEstimate,\n  OptionPrice: ShippingSimulatorOptionPrice,\n  OptionFreeBadge: ShippingSimulatorOptionFreeBadge,\n  Empty: ShippingSimulatorEmpty,\n};\n"],"mappings":"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"}
+{"version":3,"file":"shipping-simulator.js","names":[],"sources":["../../../src/matter/shipping-simulator/shipping-simulator.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 type { ComponentPropsWithRef, ReactElement } from 'react';\nimport { createContext, createElement, useCallback, useContext, useMemo, useRef, useState } from 'react';\nimport { useStorefrontContext } from '../../sdk/context/storefront-context.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { formatErrorCode } from '../../sdk/i18n/format-error-code.js';\nimport { useMessageFormatter } from '../../sdk/i18n/use-message-formatter.js';\nimport type { CartShippingSimulateInput } from '../../sdk/shipping/cart-operations.js';\nimport type { ShippingSimulateInput } from '../../sdk/shipping/operations.js';\nimport { useCartShippingSimulation } from '../../sdk/shipping/use-cart-shipping-simulation.js';\nimport { useShippingSimulation } from '../../sdk/shipping/use-shipping-simulation.js';\nimport { isFiniteAmount } from '../cart/cart.js';\nimport type { OrderPlacedDeliveryGroupContent } from '../order-placed/order-placed-deliveries.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment\n// ---------------------------------------------------------------------------\n\nconst fragment = /* GraphQL */ `\n  fragment ShippingSimulatorData on Query {\n    productBySlug(slug: $slug) {\n      variants(first: 1) {\n        edges {\n          node {\n            id\n            sellers {\n              id\n              isDefault\n            }\n          }\n        }\n      }\n    }\n  }\n`;\n\n// ---------------------------------------------------------------------------\n// Raw data types (shape of the fragment result)\n// ---------------------------------------------------------------------------\n\ntype RawShippingSimulatorData = {\n  variants: {\n    edges: Array<{\n      node: {\n        id: string;\n        sellers: Array<{\n          id: string;\n          isDefault: boolean;\n        }>;\n      };\n    }>;\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Domain types (mirror the shippingSimulation GraphQL contract)\n// ---------------------------------------------------------------------------\n\ntype MoneyValue = { amount: string; currencyCode: string };\n\ntype DeliveryChannel = 'DELIVERY' | 'PICKUP' | 'UNKNOWN';\n\nexport type ShippingEstimateUnit = 'BUSINESS_DAYS' | 'DAYS' | 'HOURS' | 'MINUTES';\n\ntype ShippingEstimate = { value: number; unit: ShippingEstimateUnit };\n\n// Exported alongside `ShippingSimulatorContextValue` so `DeliveryOptionsRoot`\n// (matter/delivery-options) can type against the exact shape the reused leaves expect, with no\n// structural duplication (docs/storefront-core/reference-free-particle-model.md § Read side — state).\nexport type ShippingOption = {\n  id: string;\n  name: string;\n  channel: DeliveryChannel;\n  shippingEstimate: ShippingEstimate;\n  price: MoneyValue;\n  listPrice: MoneyValue;\n};\n\n// `CALCULATION_FAILED` is client-side: a Root sets it when `onSimulate` rejects, with an empty `message`.\ntype ShippingSimulateErrorCode = 'INVALID_POSTAL_CODE' | 'UNKNOWN' | 'CALCULATION_FAILED';\n\n// Exported with `ShippingSimulationPayload` so the `./client` entry can name the simulate callback's\n// whole contract — the SDK hooks return it and a store writing its own `onSimulate` has to name it.\nexport type ShippingSimulateError = {\n  code: ShippingSimulateErrorCode;\n  message: string;\n};\n\nexport type ShippingSimulationPayload = {\n  shippingOptions: ShippingOption[] | null;\n  userErrors: ShippingSimulateError[];\n};\n\ntype Status = 'idle' | 'loading' | 'success' | 'error';\n\nexport type ShippingSimulatorContextValue = {\n  postalCode: string;\n  setPostalCode: (value: string) => void;\n  status: Status;\n  shippingOptions: ShippingOption[] | null;\n  userErrors: ShippingSimulateError[];\n  submit: () => void;\n};\n\nconst SHIPPING_SIMULATOR_CONTEXT_UNSET = Symbol('ShippingSimulatorContextUnset');\n\nexport type ShippingSimulatorRootProps = ComponentPropsWithRef<'div'> & {\n  country?: string;\n  quantity?: number;\n  variantId?: string;\n  seller?: string;\n  $data?: RawShippingSimulatorData | null;\n  shippingOptions?: ShippingOption[];\n  userErrors?: ShippingSimulateError[];\n  onSimulate?: (input: ShippingSimulateInput) => Promise<ShippingSimulationPayload>;\n  onResult?: (result: ShippingSimulationPayload) => void;\n};\n\nexport type CartShippingSimulatorRootProps = ComponentPropsWithRef<'div'> & {\n  country?: string;\n  shippingOptions?: ShippingOption[];\n  userErrors?: ShippingSimulateError[];\n  onSimulate?: (input: CartShippingSimulateInput) => Promise<ShippingSimulationPayload>;\n  onResult?: (result: ShippingSimulationPayload) => void;\n};\n\nexport type ShippingSimulatorFormProps = ComponentPropsWithRef<'form'>;\n\nexport type ShippingSimulatorInputProps = Omit<\n  ComponentPropsWithRef<'input'>,\n  'value' | 'onChange' | 'placeholder' | 'aria-label'\n> &\n  MessageLocaleProp & {\n    format?: boolean;\n    $content?: ContentValue<typeof ShippingSimulatorInputContent>;\n  };\n\nexport type ShippingSimulatorSubmitProps = ComponentPropsWithRef<'button'>;\n\nexport type ShippingSimulatorLoadingProps = ComponentPropsWithRef<'output'> &\n  MessageLocaleProp & {\n    $content?: ContentValue<typeof ShippingSimulatorLoadingContent>;\n  };\n\nexport type ShippingSimulatorErrorProps = ComponentPropsWithRef<'div'> &\n  MessageLocaleProp & {\n    $content?: ContentValue<typeof ShippingSimulatorErrorContent>;\n  };\n\nexport type ShippingSimulatorOptionsProps = ComponentPropsWithRef<'ul'> & {\n  sortBy?: 'price' | 'estimate';\n  maxOptions?: number;\n};\n\n/** An option under `ShippingSimulatorOptions` renders an `li`. */\nexport type ShippingSimulatorOptionProps = ComponentPropsWithRef<'li'>;\n\n/** An option outside `ShippingSimulatorOptions`, such as under `DeliveryOptionsRoot`, renders a `div`. */\nexport type ShippingSimulatorOptionBlockProps = ComponentPropsWithRef<'div'>;\n\nexport type ShippingSimulatorOptionNameProps = ComponentPropsWithRef<'span'>;\n\nexport type ShippingSimulatorOptionEstimateProps = ComponentPropsWithRef<'span'> &\n  MessageLocaleProp & {\n    $content?: ContentValue<typeof ShippingSimulatorOptionEstimateContent>;\n  };\n\nexport type ShippingSimulatorOptionPriceProps = ComponentPropsWithRef<'span'> &\n  MessageLocaleProp & {\n    $content?: ContentValue<typeof ShippingSimulatorOptionPriceContent>;\n  };\n\nexport type ShippingSimulatorOptionFreeBadgeProps = ComponentPropsWithRef<'span'> &\n  MessageLocaleProp & {\n    $content?: ContentValue<typeof ShippingSimulatorOptionFreeBadgeContent>;\n  };\n\nexport type ShippingSimulatorEmptyProps = ComponentPropsWithRef<'output'> &\n  MessageLocaleProp & {\n    $content?: ContentValue<typeof ShippingSimulatorEmptyContent>;\n  };\n\n/** An estimate sentence field, declared alike by the simulator's and the placed order's content types. */\ntype EstimateField = MessageFieldName<typeof ShippingSimulatorOptionEstimateContent> &\n  MessageFieldName<typeof OrderPlacedDeliveryGroupContent>;\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\n// Exported so `DeliveryOptionsRoot` can become a third provider by importing these same Context\n// objects directly (context matching is by identity, not shape). The two hooks below stay\n// module-private — providers need the objects, not the consumer API (Decision 2).\nexport const ShippingSimulatorContext = createContext<\n  ShippingSimulatorContextValue | typeof SHIPPING_SIMULATOR_CONTEXT_UNSET\n>(SHIPPING_SIMULATOR_CONTEXT_UNSET);\n\nexport const OptionItemContext = createContext<ShippingOption | null>(null);\n\n/**\n * True under `ShippingSimulatorOptions`, whose `ul` makes each option an `li`. Where another root\n * (a radio group) provides the option, an `li` has no list around it, so the option is a `div`.\n * Module-private: the roots that reuse the option leaves do not provide it.\n */\nconst OptionListContext = createContext(false);\n\nfunction useShippingSimulator(): ShippingSimulatorContextValue {\n  const ctx = useContext(ShippingSimulatorContext);\n  if (ctx === SHIPPING_SIMULATOR_CONTEXT_UNSET) {\n    throw new Error('ShippingSimulator components must be used inside ShippingSimulatorRoot.');\n  }\n  return ctx;\n}\n\nfunction useOptionItem(): ShippingOption {\n  const ctx = useContext(OptionItemContext);\n  if (!ctx) {\n    throw new Error('ShippingSimulatorOption components must be used inside ShippingSimulatorOptions.');\n  }\n  return ctx;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction formatPrice(value: number, locale: string, currency: string): string {\n  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value);\n}\n\n// Each unit's whole sentence, and the variable that sentence names.\n//\n// Whole sentence, not a unit fragment interpolated into a wrapper: interpolating a translated\n// fragment into a translated wrapper freezes \"preposition + noun\" order into every language, and\n// hands the translator `em {estimate}` with no way to agree preposition, article or case with a noun\n// they cannot see. The variable is named after what it counts (`{days}`, `{hours}`) rather than a\n// generic `{count}`, for the same reason.\n//\n// A `Record` and not a `switch` with a default: a fifth unit arriving in the GraphQL schema is a\n// type error here, not a silent fallback to the wrong sentence.\n//\n// `field` is a message field of both estimate content types. `variable` is the union of the names\n// those sentences read, never `string`; the parity assertion in the test file checks that each field's\n// `messageArguments` declares it.\nexport const ESTIMATE_MESSAGE: Record<\n  ShippingEstimateUnit,\n  { field: Exclude<EstimateField, 'today'>; variable: 'days' | 'hours' | 'minutes' }\n> = {\n  BUSINESS_DAYS: { field: 'inBusinessDays', variable: 'days' },\n  DAYS: { field: 'inDays', variable: 'days' },\n  HOURS: { field: 'inHours', variable: 'hours' },\n  MINUTES: { field: 'inMinutes', variable: 'minutes' },\n};\n\n// Business days weigh the same as calendar days: exact wall-clock conversion is unknowable and\n// the ranking only needs a consistent order.\nconst ESTIMATE_UNIT_MINUTES: Record<ShippingEstimateUnit, number> = {\n  MINUTES: 1,\n  HOURS: 60,\n  DAYS: 1440,\n  BUSINESS_DAYS: 1440,\n};\n\nfunction sortShippingOptions(options: readonly ShippingOption[], sortBy: 'price' | 'estimate'): ShippingOption[] {\n  const rank =\n    sortBy === 'price'\n      ? (option: ShippingOption) => Number(option.price.amount)\n      : (option: ShippingOption) => option.shippingEstimate.value * ESTIMATE_UNIT_MINUTES[option.shippingEstimate.unit];\n  return [...options].sort((a, b) => rank(a) - rank(b));\n}\n\nfunction normalizePostalCode(value: string): string {\n  return value.replace(/\\D/g, '').slice(0, 8);\n}\n\nfunction formatPostalCode(value: string): string {\n  const digits = normalizePostalCode(value);\n  return digits.length > 5 ? `${digits.slice(0, 5)}-${digits.slice(5)}` : digits;\n}\n\nfunction extractProductFromData(data: RawShippingSimulatorData | null | undefined): {\n  variantId: string | null;\n  seller: string | null;\n} {\n  if (!data) return { variantId: null, seller: null };\n  const edge = data.variants?.edges?.[0];\n  if (!edge) return { variantId: null, seller: null };\n  const { id, sellers } = edge.node;\n  const defaultSeller = sellers?.find((s) => s.isDefault) ?? sellers?.[0];\n  return { variantId: id ?? null, seller: defaultSeller?.id ?? null };\n}\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const ShippingSimulatorRootDefinition = defineComponent<ShippingSimulatorRootProps>({\n  name: 'ShippingSimulatorRoot',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  editor: { label: 'Shipping Simulator', category: 'commerce' },\n  schema: {\n    country: { type: 'string', default: 'BRA', label: 'Country (ISO-3)' },\n    quantity: { type: 'number', default: 1, label: 'Quantity' },\n  },\n  providesContext: 'shipping-simulator',\n  guideline:\n    'Root container for the PDP shipping simulator: a shopper types a postal code and sees a shipping preview for ONE product on a product detail page. Backed by shippingSimulation and a product fragment (productBySlug(slug: $slug)), so it must live on a page with a $slug variable. Use CartShippingSimulatorRoot instead for a whole-cart calculator in the cart/mini-cart. All other ShippingSimulator components must be descendants of this one.',\n});\n\nexport const CartShippingSimulatorRootDefinition = defineComponent<CartShippingSimulatorRootProps>({\n  name: 'CartShippingSimulatorRoot',\n  importPath: '@vtex/faststore/components',\n  component: CartShippingSimulatorRoot,\n  editor: { label: 'Cart Shipping Simulator', category: 'commerce' },\n  schema: {\n    country: { type: 'string', default: 'BRA', label: 'Country (ISO-3)' },\n  },\n  providesContext: 'shipping-simulator',\n  guideline:\n    'Root container for the cart/mini-cart shipping calculator: the shopper types a postal code and sees the shipping options for the WHOLE cart. Backed by cartShippingSimulation (cart sourced server-side via x-order-form-id); needs no CartRoot ancestor and no product fragment. Use ShippingSimulatorRoot instead for a single-product shipping preview on a PDP. All other CartShippingSimulator components must be descendants of this one.',\n});\n\nexport const ShippingSimulatorFormDefinition = defineComponent<ShippingSimulatorFormProps>({\n  name: 'ShippingSimulatorForm',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorForm,\n  editor: { label: 'Shipping Simulator Form', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Form wrapper that holds ShippingSimulatorInput and ShippingSimulatorSubmit; must be a descendant of ShippingSimulatorRoot.',\n});\n\nexport const ShippingSimulatorInputContent = defineContentType({\n  id: 'shipping-simulator-input',\n  title: 'Shipping Simulator Input',\n  description: \"The postal code input's accessible name and placeholder.\",\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      ariaLabel: { type: 'string', title: 'Accessible name', format: 'icu-message', messageSource: 'Postal code' },\n      placeholder: {\n        type: 'string',\n        title: 'Placeholder',\n        format: 'icu-message',\n        messageSource: 'Enter your postal code',\n      },\n    },\n  },\n});\n\nexport const ShippingSimulatorInputDefinition = defineComponent<ShippingSimulatorInputProps>({\n  name: 'ShippingSimulatorInput',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorInput,\n  content: ShippingSimulatorInputContent,\n  editor: { label: 'Shipping Simulator Input', category: 'action' },\n  schema: {\n    format: { type: 'boolean', default: false, label: 'Auto-format CEP (00000-000)' },\n  },\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Postal-code text input; enable `format` to auto-hyphenate the CEP as the user types (e.g. 01310-100). Its $content holds the ariaLabel and placeholder. Must be a descendant of ShippingSimulatorForm.',\n});\n\nexport const ShippingSimulatorSubmitDefinition = defineComponent<ShippingSimulatorSubmitProps>({\n  name: 'ShippingSimulatorSubmit',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorSubmit,\n  editor: { label: 'Shipping Simulator Submit', category: 'action' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline: 'Submit button for the postal-code form; must be a descendant of ShippingSimulatorForm.',\n});\n\nexport const ShippingSimulatorLoadingContent = defineContentType({\n  id: 'shipping-simulator-loading',\n  title: 'Shipping Simulator Loading',\n  description: 'Text shown while a simulation runs.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      text: { type: 'string', title: 'Loading text', format: 'icu-message', messageSource: 'Calculating…' },\n    },\n  },\n});\n\nexport const ShippingSimulatorLoadingDefinition = defineComponent<ShippingSimulatorLoadingProps>({\n  name: 'ShippingSimulatorLoading',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorLoading,\n  content: ShippingSimulatorLoadingContent,\n  editor: { label: 'Shipping Simulator Loading', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Loading indicator shown while a simulation is in progress; must be a descendant of ShippingSimulatorRoot.',\n});\n\nexport const ShippingSimulatorErrorContent = defineContentType({\n  id: 'shipping-simulator-error',\n  title: 'Shipping Simulator Error',\n  description: 'Messages shown when the shipping cannot be calculated, one per error code.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      calculationFailed: {\n        type: 'string',\n        title: 'Calculation failed message',\n        description: 'Shown when a store-supplied simulation callback fails.',\n        format: 'icu-message',\n        messageSource: 'Unable to calculate shipping. Try again.',\n      },\n      invalidPostalCode: {\n        type: 'string',\n        title: 'Invalid postal code',\n        description: 'Shown when the postal code is not found or is rejected.',\n        format: 'icu-message',\n        messageSource: 'Enter a valid postal code.',\n      },\n      genericErrorMessage: {\n        type: 'string',\n        title: 'Generic 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 calculate shipping. Try again.',\n      },\n    },\n  },\n});\n\nexport const ShippingSimulatorErrorDefinition = defineComponent<ShippingSimulatorErrorProps>({\n  name: 'ShippingSimulatorError',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorError,\n  content: ShippingSimulatorErrorContent,\n  editor: { label: 'Shipping Simulator Error', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Error banner shown when the simulation returns errors; renders nothing otherwise. Words each error code from its $content: invalidPostalCode for a rejected postal code, genericErrorMessage for a network failure and every other refusal, calculationFailed for a failed simulation callback. An unknown code shows genericErrorMessage; authored children replace the message. Must be a descendant of ShippingSimulatorRoot.',\n});\n\nexport const ShippingSimulatorOptionsDefinition = defineComponent<ShippingSimulatorOptionsProps>({\n  name: 'ShippingSimulatorOptions',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptions,\n  editor: { label: 'Shipping Simulator Options', category: 'commerce' },\n  schema: {\n    sortBy: { type: ['price', 'estimate'] as const, label: 'Sort by' },\n    maxOptions: { type: 'number', label: 'Max options' },\n  },\n  requiresContext: 'shipping-simulator',\n  providesContext: 'shipping-simulator-option',\n  guideline:\n    'List that renders one ShippingSimulatorOption per available shipping option; must be a descendant of a shipping-simulator Root (PDP or cart). Renders every option in API order by default; set sortBy (\"price\" = cheapest first, \"estimate\" = fastest first) and maxOptions to cap the list — sortBy=\"price\" with maxOptions=1 shows only the cheapest option. See shipping-simulator.md.',\n});\n\nexport const ShippingSimulatorOptionDefinition = defineComponent<ShippingSimulatorOptionProps>({\n  name: 'ShippingSimulatorOption',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOption,\n  editor: { label: 'Shipping Simulator Option', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Container for a single shipping option row; holds ShippingSimulatorOptionName, ShippingSimulatorOptionEstimate, and ShippingSimulatorOptionPrice. Must be a descendant of ShippingSimulatorOptions.',\n});\n\nexport const ShippingSimulatorOptionNameDefinition = defineComponent<ShippingSimulatorOptionNameProps>({\n  name: 'ShippingSimulatorOptionName',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionName,\n  editor: { label: 'Option Name', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Displays the shipping option name (e.g. \"Entrega Normal\"); must be a descendant of ShippingSimulatorOption.',\n});\n\nexport const ShippingSimulatorOptionEstimateContent = defineContentType({\n  id: 'shipping-simulator-option-estimate',\n  title: 'Shipping Simulator Option Estimate',\n  description: 'Delivery estimate sentences, one per unit.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      today: { type: 'string', title: 'Arrives today', format: 'icu-message', messageSource: 'arrives today' },\n      inBusinessDays: {\n        type: 'string',\n        title: 'In business days',\n        format: 'icu-message',\n        messageSource: 'in {days, plural, one {# business day} other {# business days}}',\n        messageArguments: { type: 'object', properties: { days: { type: 'integer' } } },\n        messageExample: { days: 3 },\n      },\n      inDays: {\n        type: 'string',\n        title: 'In days',\n        format: 'icu-message',\n        messageSource: 'in {days, plural, one {# day} other {# days}}',\n        messageArguments: { type: 'object', properties: { days: { type: 'integer' } } },\n        messageExample: { days: 3 },\n      },\n      inHours: {\n        type: 'string',\n        title: 'In hours',\n        format: 'icu-message',\n        messageSource: 'in {hours, plural, one {# hour} other {# hours}}',\n        messageArguments: { type: 'object', properties: { hours: { type: 'integer' } } },\n        messageExample: { hours: 4 },\n      },\n      inMinutes: {\n        type: 'string',\n        title: 'In minutes',\n        format: 'icu-message',\n        messageSource: 'in {minutes, plural, one {# minute} other {# minutes}}',\n        messageArguments: { type: 'object', properties: { minutes: { type: 'integer' } } },\n        messageExample: { minutes: 30 },\n      },\n    },\n  },\n});\n\nexport const ShippingSimulatorOptionEstimateDefinition = defineComponent<ShippingSimulatorOptionEstimateProps>({\n  name: 'ShippingSimulatorOptionEstimate',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionEstimate,\n  content: ShippingSimulatorOptionEstimateContent,\n  editor: { label: 'Option Estimate', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Displays the delivery estimate in the active locale, one whole sentence per unit from its $content; a zero-value estimate (any unit) reads as an arrival-today message instead, since \"chega em 0 dias úteis\" reads wrong. Must be a descendant of ShippingSimulatorOption.',\n});\n\nexport const ShippingSimulatorOptionPriceContent = defineContentType({\n  id: 'shipping-simulator-option-price',\n  title: 'Shipping Simulator Option Price',\n  description: 'Text shown instead of a zero shipping price.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      freeLabel: { type: 'string', title: 'Free price label', format: 'icu-message', messageSource: 'Free' },\n    },\n  },\n});\n\nexport const ShippingSimulatorOptionPriceDefinition = defineComponent<ShippingSimulatorOptionPriceProps>({\n  name: 'ShippingSimulatorOptionPrice',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionPrice,\n  content: ShippingSimulatorOptionPriceContent,\n  editor: { label: 'Option Price', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Displays the shipping price, showing its $content.freeLabel when the amount is zero; must be a descendant of ShippingSimulatorOption.',\n});\n\nexport const ShippingSimulatorOptionFreeBadgeContent = defineContentType({\n  id: 'shipping-simulator-option-free-badge',\n  title: 'Shipping Simulator Option Free Badge',\n  description: 'Badge text of a free shipping option.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      text: { type: 'string', title: 'Badge text', format: 'icu-message', messageSource: 'Free shipping' },\n    },\n  },\n});\n\nexport const ShippingSimulatorOptionFreeBadgeDefinition = defineComponent<ShippingSimulatorOptionFreeBadgeProps>({\n  name: 'ShippingSimulatorOptionFreeBadge',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorOptionFreeBadge,\n  content: ShippingSimulatorOptionFreeBadgeContent,\n  editor: { label: 'Option Free Badge', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator-option',\n  guideline:\n    'Badge shown only when the current option price is zero (free shipping); renders nothing otherwise. Must be a descendant of ShippingSimulatorOption. Orthogonal to the free-price replacement text owned by ShippingSimulatorOptionPrice.',\n});\n\nexport const ShippingSimulatorEmptyContent = defineContentType({\n  id: 'shipping-simulator-empty',\n  title: 'Shipping Simulator Empty',\n  description: 'Message shown when a simulation returns no shipping options.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      text: {\n        type: 'string',\n        title: 'Empty message',\n        format: 'icu-message',\n        messageSource: 'No delivery options available for this address.',\n      },\n    },\n  },\n});\n\nexport const ShippingSimulatorEmptyDefinition = defineComponent<ShippingSimulatorEmptyProps>({\n  name: 'ShippingSimulatorEmpty',\n  importPath: '@vtex/faststore/components',\n  component: ShippingSimulatorEmpty,\n  content: ShippingSimulatorEmptyContent,\n  editor: { label: 'Shipping Simulator Empty', category: 'commerce' },\n  schema: {},\n  requiresContext: 'shipping-simulator',\n  guideline:\n    'Message shown when a simulation ran and returned no shipping options (e.g. no carrier common to the whole cart). Renders nothing before the first submit and nothing when options or an error are present. The copy is its $content.text; pass children to override. Must be a descendant of a shipping-simulator Root.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\nexport function ShippingSimulatorRoot({\n  country = 'BRA',\n  quantity = 1,\n  variantId: variantIdProp,\n  seller: sellerProp,\n  $data: $dataProp,\n  shippingOptions: shippingOptionsProp,\n  userErrors: userErrorsProp,\n  onSimulate: onSimulateProp,\n  onResult,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorRootProps) {\n  const defaultSimulate = useShippingSimulation();\n  const onSimulate = onSimulateProp ?? defaultSimulate;\n\n  const $data = useDataOverride($dataProp);\n  const extracted = extractProductFromData($data);\n  const variantId = variantIdProp ?? extracted.variantId;\n  const seller = sellerProp ?? extracted.seller;\n\n  const [postalCode, setPostalCode] = useState('');\n  const [status, setStatus] = useState<Status>(() => {\n    if (userErrorsProp?.length) return 'error';\n    if (shippingOptionsProp) return 'success';\n    return 'idle';\n  });\n  const [shippingOptions, setShippingOptions] = useState<ShippingOption[] | null>(shippingOptionsProp ?? null);\n  const [userErrors, setUserErrors] = useState<ShippingSimulateError[]>(userErrorsProp ?? []);\n\n  const submissionToken = useRef(0);\n\n  const submit = useCallback(() => {\n    if (!onSimulate || !variantId || !seller) return;\n\n    const normalizedCep = normalizePostalCode(postalCode);\n    if (normalizedCep.length !== 8) return;\n\n    const token = ++submissionToken.current;\n    setStatus('loading');\n    setShippingOptions(null);\n    setUserErrors([]);\n\n    onSimulate({ postalCode: normalizedCep, country, variantId, quantity, seller })\n      .then((result) => {\n        if (submissionToken.current !== token) return;\n        setShippingOptions(result.shippingOptions);\n        setUserErrors(result.userErrors);\n        setStatus(result.userErrors.length > 0 ? 'error' : 'success');\n        onResult?.(result);\n      })\n      .catch(() => {\n        if (submissionToken.current !== token) return;\n        // `ShippingSimulatorError` words this code from its own `$content`.\n        const fallback: ShippingSimulateError = { code: 'CALCULATION_FAILED', message: '' };\n        setShippingOptions(null);\n        setUserErrors([fallback]);\n        setStatus('error');\n        onResult?.({ shippingOptions: null, userErrors: [fallback] });\n      });\n  }, [country, onResult, onSimulate, postalCode, quantity, seller, variantId]);\n\n  const contextValue = useMemo<ShippingSimulatorContextValue>(\n    () => ({\n      postalCode,\n      setPostalCode,\n      status,\n      shippingOptions,\n      userErrors,\n      submit,\n    }),\n    [postalCode, status, shippingOptions, userErrors, submit],\n  );\n\n  return (\n    <ShippingSimulatorContext value={contextValue}>\n      <div {...props} className={className} data-fs-shipping-simulator=\"\">\n        {children}\n      </div>\n    </ShippingSimulatorContext>\n  );\n}\n\nexport function CartShippingSimulatorRoot({\n  country = 'BRA',\n  shippingOptions: shippingOptionsProp,\n  userErrors: userErrorsProp,\n  onSimulate: onSimulateProp,\n  onResult,\n  className,\n  children,\n  ...props\n}: CartShippingSimulatorRootProps) {\n  const defaultSimulate = useCartShippingSimulation();\n  const onSimulate = onSimulateProp ?? defaultSimulate;\n\n  const [postalCode, setPostalCode] = useState('');\n  const [status, setStatus] = useState<Status>(() => {\n    if (userErrorsProp?.length) return 'error';\n    if (shippingOptionsProp) return 'success';\n    return 'idle';\n  });\n  const [shippingOptions, setShippingOptions] = useState<ShippingOption[] | null>(shippingOptionsProp ?? null);\n  const [userErrors, setUserErrors] = useState<ShippingSimulateError[]>(userErrorsProp ?? []);\n\n  const submissionToken = useRef(0);\n\n  const submit = useCallback(() => {\n    const normalizedCep = normalizePostalCode(postalCode);\n    if (normalizedCep.length !== 8) return;\n\n    const token = ++submissionToken.current;\n    setStatus('loading');\n    setShippingOptions(null);\n    setUserErrors([]);\n\n    onSimulate({ postalCode: normalizedCep, country })\n      .then((result) => {\n        if (submissionToken.current !== token) return;\n        setShippingOptions(result.shippingOptions);\n        setUserErrors(result.userErrors);\n        setStatus(result.userErrors.length > 0 ? 'error' : 'success');\n        onResult?.(result);\n      })\n      .catch(() => {\n        if (submissionToken.current !== token) return;\n        // `ShippingSimulatorError` words this code from its own `$content`.\n        const fallback: ShippingSimulateError = { code: 'CALCULATION_FAILED', message: '' };\n        setShippingOptions(null);\n        setUserErrors([fallback]);\n        setStatus('error');\n        onResult?.({ shippingOptions: null, userErrors: [fallback] });\n      });\n  }, [country, onResult, onSimulate, postalCode]);\n\n  const contextValue = useMemo<ShippingSimulatorContextValue>(\n    () => ({\n      postalCode,\n      setPostalCode,\n      status,\n      shippingOptions,\n      userErrors,\n      submit,\n    }),\n    [postalCode, status, shippingOptions, userErrors, submit],\n  );\n\n  return (\n    <ShippingSimulatorContext value={contextValue}>\n      <div {...props} className={className} data-fs-shipping-simulator=\"\">\n        {children}\n      </div>\n    </ShippingSimulatorContext>\n  );\n}\n\nexport function ShippingSimulatorForm({ className, children, ...props }: ShippingSimulatorFormProps) {\n  const { submit } = useShippingSimulator();\n\n  return (\n    <form\n      {...props}\n      className={className}\n      data-fs-shipping-simulator-form=\"\"\n      onSubmit={(event) => {\n        event.preventDefault();\n        submit();\n      }}\n    >\n      {children}\n    </form>\n  );\n}\n\nexport function ShippingSimulatorInput({\n  $content,\n  $locale,\n  className,\n  format = false,\n  ...props\n}: ShippingSimulatorInputProps) {\n  const { postalCode, setPostalCode } = useShippingSimulator();\n  const messages = useMessageFormatter(ShippingSimulatorInputContent, $content);\n  const displayValue = format ? formatPostalCode(postalCode) : postalCode;\n\n  return (\n    <input\n      {...props}\n      aria-label={messages.format('ariaLabel')}\n      className={className}\n      data-fs-shipping-simulator-input=\"\"\n      type=\"text\"\n      value={displayValue}\n      onChange={(event) => setPostalCode(normalizePostalCode(event.target.value))}\n      placeholder={messages.format('placeholder')}\n      pattern=\"\\d{5}-?\\d{3}\"\n      maxLength={9}\n      inputMode=\"numeric\"\n      required\n    />\n  );\n}\n\nexport function ShippingSimulatorSubmit({ className, children, disabled, ...props }: ShippingSimulatorSubmitProps) {\n  const { status } = useShippingSimulator();\n  const isLoading = status === 'loading';\n\n  return (\n    <button\n      {...props}\n      type=\"submit\"\n      className={className}\n      data-fs-shipping-simulator-submit=\"\"\n      disabled={disabled || isLoading}\n      aria-busy={isLoading}\n    >\n      {children}\n    </button>\n  );\n}\n\nexport function ShippingSimulatorLoading({\n  $content,\n  $locale,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorLoadingProps) {\n  const { status } = useShippingSimulator();\n  const { format } = useMessageFormatter(ShippingSimulatorLoadingContent, $content);\n  if (status !== 'loading') return null;\n\n  return (\n    <output {...props} aria-live=\"polite\" className={className} data-fs-shipping-simulator-loading=\"\">\n      {children ?? format('text')}\n    </output>\n  );\n}\n\n/**\n * The message for each code a simulation can return. The default hooks collapse every server code but\n * `INVALID_POSTAL_CODE`, and every transport failure, into `UNKNOWN`.\n */\nexport const SHIPPING_SIMULATOR_ERROR_FIELDS = {\n  INVALID_POSTAL_CODE: 'invalidPostalCode',\n  UNKNOWN: 'genericErrorMessage',\n  CALCULATION_FAILED: 'calculationFailed',\n} as const satisfies Record<ShippingSimulateErrorCode, MessageFieldName<typeof ShippingSimulatorErrorContent>>;\n\nexport function ShippingSimulatorError({\n  $content,\n  $locale,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorErrorProps) {\n  const { userErrors } = useShippingSimulator();\n  const { format } = useMessageFormatter(ShippingSimulatorErrorContent, $content);\n  const [firstError] = userErrors;\n  if (!firstError) return null;\n\n  return (\n    <div {...props} role=\"alert\" className={className} data-fs-shipping-simulator-error=\"\">\n      {children ??\n        formatErrorCode(\n          ShippingSimulatorErrorContent,\n          SHIPPING_SIMULATOR_ERROR_FIELDS,\n          firstError,\n          format,\n          'genericErrorMessage',\n        )}\n    </div>\n  );\n}\n\nexport function ShippingSimulatorOptions({\n  sortBy,\n  maxOptions,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionsProps) {\n  const { shippingOptions } = useShippingSimulator();\n\n  const visibleOptions = useMemo(() => {\n    if (!shippingOptions) return null;\n    const sorted = sortBy ? sortShippingOptions(shippingOptions, sortBy) : shippingOptions;\n    return maxOptions && maxOptions > 0 ? sorted.slice(0, maxOptions) : sorted;\n  }, [shippingOptions, sortBy, maxOptions]);\n\n  if (!visibleOptions || visibleOptions.length === 0) return null;\n\n  return (\n    <ul {...props} className={className} data-fs-shipping-simulator-options=\"\">\n      <OptionListContext value>\n        {visibleOptions.map((option) => (\n          <OptionItemContext key={option.id} value={option}>\n            {children}\n          </OptionItemContext>\n        ))}\n      </OptionListContext>\n    </ul>\n  );\n}\n\nexport function ShippingSimulatorOption(props: ShippingSimulatorOptionProps): ReactElement;\nexport function ShippingSimulatorOption(props: ShippingSimulatorOptionBlockProps): ReactElement;\n// Callers see the two overloads; the implementation takes either shape, so no cast is needed.\nexport function ShippingSimulatorOption({\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionProps | ShippingSimulatorOptionBlockProps): ReactElement {\n  const option = useOptionItem();\n  const inList = useContext(OptionListContext);\n\n  return createElement(\n    inList ? 'li' : 'div',\n    {\n      ...props,\n      className,\n      'data-fs-shipping-simulator-option': '',\n      'data-fs-shipping-simulator-option-channel': option.channel,\n    },\n    children,\n  );\n}\n\nexport function ShippingSimulatorOptionName({ className, children, ...props }: ShippingSimulatorOptionNameProps) {\n  const option = useOptionItem();\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-name=\"\">\n      {children ?? option.name}\n    </span>\n  );\n}\n\nexport function ShippingSimulatorOptionEstimate({\n  $content,\n  $locale,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionEstimateProps) {\n  const option = useOptionItem();\n  const { format } = useMessageFormatter(ShippingSimulatorOptionEstimateContent, $content);\n\n  function estimate() {\n    const { value, unit } = option.shippingEstimate;\n    if (value === 0) return format('today');\n    const { field, variable } = ESTIMATE_MESSAGE[unit];\n    // A computed key widens to an index signature; the parity test pins `variable` to `field`.\n    return format(field, { [variable]: value } as Record<typeof variable, number>);\n  }\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-estimate=\"\">\n      {children ?? estimate()}\n    </span>\n  );\n}\n\nexport function isFreeAmount(amount: unknown): boolean {\n  return isFiniteAmount(amount) && Number(amount) === 0;\n}\n\nexport function ShippingSimulatorOptionPrice({\n  $content,\n  $locale,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionPriceProps) {\n  const option = useOptionItem();\n  const { format } = useMessageFormatter(ShippingSimulatorOptionPriceContent, $content);\n  const { locale, currency } = useStorefrontContext();\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-price=\"\">\n      {children ??\n        (isFreeAmount(option.price.amount)\n          ? format('freeLabel')\n          : formatPrice(Number(option.price.amount), locale, currency))}\n    </span>\n  );\n}\n\nexport function ShippingSimulatorOptionFreeBadge({\n  $content,\n  $locale,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorOptionFreeBadgeProps) {\n  const option = useOptionItem();\n  const { format } = useMessageFormatter(ShippingSimulatorOptionFreeBadgeContent, $content);\n  if (!isFreeAmount(option.price.amount)) return null;\n\n  return (\n    <span {...props} className={className} data-fs-shipping-simulator-option-free-badge=\"\">\n      {children ?? format('text')}\n    </span>\n  );\n}\n\nexport function ShippingSimulatorEmpty({\n  $content,\n  $locale,\n  className,\n  children,\n  ...props\n}: ShippingSimulatorEmptyProps) {\n  const { shippingOptions, userErrors } = useShippingSimulator();\n  const { format } = useMessageFormatter(ShippingSimulatorEmptyContent, $content);\n  // Idle (null) → nothing; error → nothing (Error owns it); options present → nothing.\n  const simulatedEmpty = Array.isArray(shippingOptions) && shippingOptions.length === 0 && userErrors.length === 0;\n  if (!simulatedEmpty) return null;\n\n  return (\n    <output {...props} aria-live=\"polite\" className={className} data-fs-shipping-simulator-empty=\"\">\n      {children ?? format('text')}\n    </output>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Namespace export\n// ---------------------------------------------------------------------------\n\nexport const ShippingSimulator = {\n  Root: ShippingSimulatorRoot,\n  Form: ShippingSimulatorForm,\n  Input: ShippingSimulatorInput,\n  Submit: ShippingSimulatorSubmit,\n  Loading: ShippingSimulatorLoading,\n  Error: ShippingSimulatorError,\n  Options: ShippingSimulatorOptions,\n  Option: ShippingSimulatorOption,\n  OptionName: ShippingSimulatorOptionName,\n  OptionEstimate: ShippingSimulatorOptionEstimate,\n  OptionPrice: ShippingSimulatorOptionPrice,\n  OptionFreeBadge: ShippingSimulatorOptionFreeBadge,\n  Empty: ShippingSimulatorEmpty,\n};\n\nexport const CartShippingSimulator = {\n  Root: CartShippingSimulatorRoot,\n  Form: ShippingSimulatorForm,\n  Input: ShippingSimulatorInput,\n  Submit: ShippingSimulatorSubmit,\n  Loading: ShippingSimulatorLoading,\n  Error: ShippingSimulatorError,\n  Options: ShippingSimulatorOptions,\n  Option: ShippingSimulatorOption,\n  OptionName: ShippingSimulatorOptionName,\n  OptionEstimate: ShippingSimulatorOptionEstimate,\n  OptionPrice: ShippingSimulatorOptionPrice,\n  OptionFreeBadge: ShippingSimulatorOptionFreeBadge,\n  Empty: ShippingSimulatorEmpty,\n};\n"],"mappings":";;;;;;;;;;;;;;AA0BA,MAAM,WAAyB;;;;;;;;;;;;;;;;;AAsF/B,MAAM,mCAAmC,OAAO,+BAA+B;AAyF/E,MAAa,2BAA2B,cAEtC,gCAAgC;AAElC,MAAa,oBAAoB,cAAqC,IAAI;;;;;;AAO1E,MAAM,oBAAoB,cAAc,KAAK;AAE7C,SAAS,uBAAsD;CAC7D,MAAM,MAAM,WAAW,wBAAwB;CAC/C,IAAI,QAAQ,kCACV,MAAM,IAAI,MAAM,yEAAyE;CAE3F,OAAO;AACT;AAEA,SAAS,gBAAgC;CACvC,MAAM,MAAM,WAAW,iBAAiB;CACxC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,kFAAkF;CAEpG,OAAO;AACT;AAMA,SAAS,YAAY,OAAe,QAAgB,UAA0B;CAC5E,OAAO,IAAI,KAAK,aAAa,QAAQ;EAAE,OAAO;EAAY;CAAS,CAAC,CAAC,CAAC,OAAO,KAAK;AACpF;AAgBA,MAAa,mBAGT;CACF,eAAe;EAAE,OAAO;EAAkB,UAAU;CAAO;CAC3D,MAAM;EAAE,OAAO;EAAU,UAAU;CAAO;CAC1C,OAAO;EAAE,OAAO;EAAW,UAAU;CAAQ;CAC7C,SAAS;EAAE,OAAO;EAAa,UAAU;CAAU;AACrD;AAIA,MAAM,wBAA8D;CAClE,SAAS;CACT,OAAO;CACP,MAAM;CACN,eAAe;AACjB;AAEA,SAAS,oBAAoB,SAAoC,QAAgD;CAC/G,MAAM,OACJ,WAAW,WACN,WAA2B,OAAO,OAAO,MAAM,MAAM,KACrD,WAA2B,OAAO,iBAAiB,QAAQ,sBAAsB,OAAO,iBAAiB;CAChH,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;AACtD;AAEA,SAAS,oBAAoB,OAAuB;CAClD,OAAO,MAAM,QAAQ,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;AAC5C;AAEA,SAAS,iBAAiB,OAAuB;CAC/C,MAAM,SAAS,oBAAoB,KAAK;CACxC,OAAO,OAAO,SAAS,IAAI,GAAG,OAAO,MAAM,GAAG,CAAC,EAAE,GAAG,OAAO,MAAM,CAAC,MAAM;AAC1E;AAEA,SAAS,uBAAuB,MAG9B;CACA,IAAI,CAAC,MAAM,OAAO;EAAE,WAAW;EAAM,QAAQ;CAAK;CAClD,MAAM,OAAO,KAAK,UAAU,QAAQ;CACpC,IAAI,CAAC,MAAM,OAAO;EAAE,WAAW;EAAM,QAAQ;CAAK;CAClD,MAAM,EAAE,IAAI,YAAY,KAAK;CAC7B,MAAM,gBAAgB,SAAS,MAAM,MAAM,EAAE,SAAS,KAAK,UAAU;CACrE,OAAO;EAAE,WAAW,MAAM;EAAM,QAAQ,eAAe,MAAM;CAAK;AACpE;AAMA,MAAa,kCAAkC,gBAA4C;CACzF,MAAM;CACN,YAAY;CACZ,WAAW;CACX;CACA,eAAe;CACf,QAAQ;EAAE,OAAO;EAAsB,UAAU;CAAW;CAC5D,QAAQ;EACN,SAAS;GAAE,MAAM;GAAU,SAAS;GAAO,OAAO;EAAkB;EACpE,UAAU;GAAE,MAAM;GAAU,SAAS;GAAG,OAAO;EAAW;CAC5D;CACA,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,sCAAsC,gBAAgD;CACjG,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAA2B,UAAU;CAAW;CACjE,QAAQ,EACN,SAAS;EAAE,MAAM;EAAU,SAAS;EAAO,OAAO;CAAkB,EACtE;CACA,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,kCAAkC,gBAA4C;CACzF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAA2B,UAAU;CAAW;CACjE,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,gCAAgC,kBAAkB;CAC7D,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY;GACV,WAAW;IAAE,MAAM;IAAU,OAAO;IAAmB,QAAQ;IAAe,eAAe;GAAc;GAC3G,aAAa;IACX,MAAM;IACN,OAAO;IACP,QAAQ;IACR,eAAe;GACjB;EACF;CACF;AACF,CAAC;AAED,MAAa,mCAAmC,gBAA6C;CAC3F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAA4B,UAAU;CAAS;CAChE,QAAQ,EACN,QAAQ;EAAE,MAAM;EAAW,SAAS;EAAO,OAAO;CAA8B,EAClF;CACA,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,oCAAoC,gBAA8C;CAC7F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAA6B,UAAU;CAAS;CACjE,QAAQ,CAAC;CACT,iBAAiB;CACjB,WAAW;AACb,CAAC;AAED,MAAa,kCAAkC,kBAAkB;CAC/D,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY,EACV,MAAM;GAAE,MAAM;GAAU,OAAO;GAAgB,QAAQ;GAAe,eAAe;EAAe,EACtG;CACF;AACF,CAAC;AAED,MAAa,qCAAqC,gBAA+C;CAC/F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAA8B,UAAU;CAAW;CACpE,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,gCAAgC,kBAAkB;CAC7D,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY;GACV,mBAAmB;IACjB,MAAM;IACN,OAAO;IACP,aAAa;IACb,QAAQ;IACR,eAAe;GACjB;GACA,mBAAmB;IACjB,MAAM;IACN,OAAO;IACP,aAAa;IACb,QAAQ;IACR,eAAe;GACjB;GACA,qBAAqB;IACnB,MAAM;IACN,OAAO;IACP,aAAa;IACb,QAAQ;IACR,eAAe;GACjB;EACF;CACF;AACF,CAAC;AAED,MAAa,mCAAmC,gBAA6C;CAC3F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAA4B,UAAU;CAAW;CAClE,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,qCAAqC,gBAA+C;CAC/F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAA8B,UAAU;CAAW;CACpE,QAAQ;EACN,QAAQ;GAAE,MAAM,CAAC,SAAS,UAAU;GAAY,OAAO;EAAU;EACjE,YAAY;GAAE,MAAM;GAAU,OAAO;EAAc;CACrD;CACA,iBAAiB;CACjB,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,oCAAoC,gBAA8C;CAC7F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAA6B,UAAU;CAAW;CACnE,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,wCAAwC,gBAAkD;CACrG,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAe,UAAU;CAAW;CACrD,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,yCAAyC,kBAAkB;CACtE,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY;GACV,OAAO;IAAE,MAAM;IAAU,OAAO;IAAiB,QAAQ;IAAe,eAAe;GAAgB;GACvG,gBAAgB;IACd,MAAM;IACN,OAAO;IACP,QAAQ;IACR,eAAe;IACf,kBAAkB;KAAE,MAAM;KAAU,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,EAAE;IAAE;IAC9E,gBAAgB,EAAE,MAAM,EAAE;GAC5B;GACA,QAAQ;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,eAAe;IACf,kBAAkB;KAAE,MAAM;KAAU,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,EAAE;IAAE;IAC9E,gBAAgB,EAAE,MAAM,EAAE;GAC5B;GACA,SAAS;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,eAAe;IACf,kBAAkB;KAAE,MAAM;KAAU,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,EAAE;IAAE;IAC/E,gBAAgB,EAAE,OAAO,EAAE;GAC7B;GACA,WAAW;IACT,MAAM;IACN,OAAO;IACP,QAAQ;IACR,eAAe;IACf,kBAAkB;KAAE,MAAM;KAAU,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,EAAE;IAAE;IACjF,gBAAgB,EAAE,SAAS,GAAG;GAChC;EACF;CACF;AACF,CAAC;AAED,MAAa,4CAA4C,gBAAsD;CAC7G,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAmB,UAAU;CAAW;CACzD,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,sCAAsC,kBAAkB;CACnE,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY,EACV,WAAW;GAAE,MAAM;GAAU,OAAO;GAAoB,QAAQ;GAAe,eAAe;EAAO,EACvG;CACF;AACF,CAAC;AAED,MAAa,yCAAyC,gBAAmD;CACvG,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAgB,UAAU;CAAW;CACtD,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,0CAA0C,kBAAkB;CACvE,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY,EACV,MAAM;GAAE,MAAM;GAAU,OAAO;GAAc,QAAQ;GAAe,eAAe;EAAgB,EACrG;CACF;AACF,CAAC;AAED,MAAa,6CAA6C,gBAAuD;CAC/G,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAqB,UAAU;CAAW;CAC3D,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,gCAAgC,kBAAkB;CAC7D,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY,EACV,MAAM;GACJ,MAAM;GACN,OAAO;GACP,QAAQ;GACR,eAAe;EACjB,EACF;CACF;AACF,CAAC;AAED,MAAa,mCAAmC,gBAA6C;CAC3F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAA4B,UAAU;CAAW;CAClE,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAMD,SAAgB,sBAAsB,EACpC,UAAU,OACV,WAAW,GACX,WAAW,eACX,QAAQ,YACR,OAAO,WACP,iBAAiB,qBACjB,YAAY,gBACZ,YAAY,gBACZ,UACA,WACA,UACA,GAAG,SAC0B;CAC7B,MAAM,kBAAkB,sBAAsB;CAC9C,MAAM,aAAa,kBAAkB;CAGrC,MAAM,YAAY,uBADJ,gBAAgB,SACe,CAAC;CAC9C,MAAM,YAAY,iBAAiB,UAAU;CAC7C,MAAM,SAAS,cAAc,UAAU;CAEvC,MAAM,CAAC,YAAY,iBAAiB,SAAS,EAAE;CAC/C,MAAM,CAAC,QAAQ,aAAa,eAAuB;EACjD,IAAI,gBAAgB,QAAQ,OAAO;EACnC,IAAI,qBAAqB,OAAO;EAChC,OAAO;CACT,CAAC;CACD,MAAM,CAAC,iBAAiB,sBAAsB,SAAkC,uBAAuB,IAAI;CAC3G,MAAM,CAAC,YAAY,iBAAiB,SAAkC,kBAAkB,CAAC,CAAC;CAE1F,MAAM,kBAAkB,OAAO,CAAC;CAEhC,MAAM,SAAS,kBAAkB;EAC/B,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,QAAQ;EAE1C,MAAM,gBAAgB,oBAAoB,UAAU;EACpD,IAAI,cAAc,WAAW,GAAG;EAEhC,MAAM,QAAQ,EAAE,gBAAgB;EAChC,UAAU,SAAS;EACnB,mBAAmB,IAAI;EACvB,cAAc,CAAC,CAAC;EAEhB,WAAW;GAAE,YAAY;GAAe;GAAS;GAAW;GAAU;EAAO,CAAC,CAAC,CAC5E,MAAM,WAAW;GAChB,IAAI,gBAAgB,YAAY,OAAO;GACvC,mBAAmB,OAAO,eAAe;GACzC,cAAc,OAAO,UAAU;GAC/B,UAAU,OAAO,WAAW,SAAS,IAAI,UAAU,SAAS;GAC5D,WAAW,MAAM;EACnB,CAAC,CAAC,CACD,YAAY;GACX,IAAI,gBAAgB,YAAY,OAAO;GAEvC,MAAM,WAAkC;IAAE,MAAM;IAAsB,SAAS;GAAG;GAClF,mBAAmB,IAAI;GACvB,cAAc,CAAC,QAAQ,CAAC;GACxB,UAAU,OAAO;GACjB,WAAW;IAAE,iBAAiB;IAAM,YAAY,CAAC,QAAQ;GAAE,CAAC;EAC9D,CAAC;CACL,GAAG;EAAC;EAAS;EAAU;EAAY;EAAY;EAAU;EAAQ;CAAS,CAAC;CAE3E,MAAM,eAAe,eACZ;EACL;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EAAC;EAAY;EAAQ;EAAiB;EAAY;CAAM,CAC1D;CAEA,OACE,oBAAC,0BAAD;EAA0B,OAAO;EAC/B,UAAA,oBAAC,OAAD;GAAK,GAAI;GAAkB;GAAW,8BAA2B;GAC9D;EACE,CAAA;CACmB,CAAA;AAE9B;AAEA,SAAgB,0BAA0B,EACxC,UAAU,OACV,iBAAiB,qBACjB,YAAY,gBACZ,YAAY,gBACZ,UACA,WACA,UACA,GAAG,SAC8B;CACjC,MAAM,kBAAkB,0BAA0B;CAClD,MAAM,aAAa,kBAAkB;CAErC,MAAM,CAAC,YAAY,iBAAiB,SAAS,EAAE;CAC/C,MAAM,CAAC,QAAQ,aAAa,eAAuB;EACjD,IAAI,gBAAgB,QAAQ,OAAO;EACnC,IAAI,qBAAqB,OAAO;EAChC,OAAO;CACT,CAAC;CACD,MAAM,CAAC,iBAAiB,sBAAsB,SAAkC,uBAAuB,IAAI;CAC3G,MAAM,CAAC,YAAY,iBAAiB,SAAkC,kBAAkB,CAAC,CAAC;CAE1F,MAAM,kBAAkB,OAAO,CAAC;CAEhC,MAAM,SAAS,kBAAkB;EAC/B,MAAM,gBAAgB,oBAAoB,UAAU;EACpD,IAAI,cAAc,WAAW,GAAG;EAEhC,MAAM,QAAQ,EAAE,gBAAgB;EAChC,UAAU,SAAS;EACnB,mBAAmB,IAAI;EACvB,cAAc,CAAC,CAAC;EAEhB,WAAW;GAAE,YAAY;GAAe;EAAQ,CAAC,CAAC,CAC/C,MAAM,WAAW;GAChB,IAAI,gBAAgB,YAAY,OAAO;GACvC,mBAAmB,OAAO,eAAe;GACzC,cAAc,OAAO,UAAU;GAC/B,UAAU,OAAO,WAAW,SAAS,IAAI,UAAU,SAAS;GAC5D,WAAW,MAAM;EACnB,CAAC,CAAC,CACD,YAAY;GACX,IAAI,gBAAgB,YAAY,OAAO;GAEvC,MAAM,WAAkC;IAAE,MAAM;IAAsB,SAAS;GAAG;GAClF,mBAAmB,IAAI;GACvB,cAAc,CAAC,QAAQ,CAAC;GACxB,UAAU,OAAO;GACjB,WAAW;IAAE,iBAAiB;IAAM,YAAY,CAAC,QAAQ;GAAE,CAAC;EAC9D,CAAC;CACL,GAAG;EAAC;EAAS;EAAU;EAAY;CAAU,CAAC;CAE9C,MAAM,eAAe,eACZ;EACL;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EAAC;EAAY;EAAQ;EAAiB;EAAY;CAAM,CAC1D;CAEA,OACE,oBAAC,0BAAD;EAA0B,OAAO;EAC/B,UAAA,oBAAC,OAAD;GAAK,GAAI;GAAkB;GAAW,8BAA2B;GAC9D;EACE,CAAA;CACmB,CAAA;AAE9B;AAEA,SAAgB,sBAAsB,EAAE,WAAW,UAAU,GAAG,SAAqC;CACnG,MAAM,EAAE,WAAW,qBAAqB;CAExC,OACE,oBAAC,QAAD;EACE,GAAI;EACO;EACX,mCAAgC;EAChC,WAAW,UAAU;GACnB,MAAM,eAAe;GACrB,OAAO;EACT;EAEC;CACG,CAAA;AAEV;AAEA,SAAgB,uBAAuB,EACrC,UACA,SACA,WACA,SAAS,OACT,GAAG,SAC2B;CAC9B,MAAM,EAAE,YAAY,kBAAkB,qBAAqB;CAC3D,MAAM,WAAW,oBAAoB,+BAA+B,QAAQ;CAC5E,MAAM,eAAe,SAAS,iBAAiB,UAAU,IAAI;CAE7D,OACE,oBAAC,SAAD;EACE,GAAI;EACJ,cAAY,SAAS,OAAO,WAAW;EAC5B;EACX,oCAAiC;EACjC,MAAK;EACL,OAAO;EACP,WAAW,UAAU,cAAc,oBAAoB,MAAM,OAAO,KAAK,CAAC;EAC1E,aAAa,SAAS,OAAO,aAAa;EAC1C,SAAQ;EACR,WAAW;EACX,WAAU;EACV,UAAA;CACD,CAAA;AAEL;AAEA,SAAgB,wBAAwB,EAAE,WAAW,UAAU,UAAU,GAAG,SAAuC;CACjH,MAAM,EAAE,WAAW,qBAAqB;CACxC,MAAM,YAAY,WAAW;CAE7B,OACE,oBAAC,UAAD;EACE,GAAI;EACJ,MAAK;EACM;EACX,qCAAkC;EAClC,UAAU,YAAY;EACtB,aAAW;EAEV;CACK,CAAA;AAEZ;AAEA,SAAgB,yBAAyB,EACvC,UACA,SACA,WACA,UACA,GAAG,SAC6B;CAChC,MAAM,EAAE,WAAW,qBAAqB;CACxC,MAAM,EAAE,WAAW,oBAAoB,iCAAiC,QAAQ;CAChF,IAAI,WAAW,WAAW,OAAO;CAEjC,OACE,oBAAC,UAAD;EAAQ,GAAI;EAAO,aAAU;EAAoB;EAAW,sCAAmC;EAC5F,UAAA,YAAY,OAAO,MAAM;CACpB,CAAA;AAEZ;;;;;AAMA,MAAa,kCAAkC;CAC7C,qBAAqB;CACrB,SAAS;CACT,oBAAoB;AACtB;AAEA,SAAgB,uBAAuB,EACrC,UACA,SACA,WACA,UACA,GAAG,SAC2B;CAC9B,MAAM,EAAE,eAAe,qBAAqB;CAC5C,MAAM,EAAE,WAAW,oBAAoB,+BAA+B,QAAQ;CAC9E,MAAM,CAAC,cAAc;CACrB,IAAI,CAAC,YAAY,OAAO;CAExB,OACE,oBAAC,OAAD;EAAK,GAAI;EAAO,MAAK;EAAmB;EAAW,oCAAiC;EACjF,UAAA,YACC,gBACE,+BACA,iCACA,YACA,QACA,qBACF;CACC,CAAA;AAET;AAEA,SAAgB,yBAAyB,EACvC,QACA,YACA,WACA,UACA,GAAG,SAC6B;CAChC,MAAM,EAAE,oBAAoB,qBAAqB;CAEjD,MAAM,iBAAiB,cAAc;EACnC,IAAI,CAAC,iBAAiB,OAAO;EAC7B,MAAM,SAAS,SAAS,oBAAoB,iBAAiB,MAAM,IAAI;EACvE,OAAO,cAAc,aAAa,IAAI,OAAO,MAAM,GAAG,UAAU,IAAI;CACtE,GAAG;EAAC;EAAiB;EAAQ;CAAU,CAAC;CAExC,IAAI,CAAC,kBAAkB,eAAe,WAAW,GAAG,OAAO;CAE3D,OACE,oBAAC,MAAD;EAAI,GAAI;EAAkB;EAAW,sCAAmC;EACtE,UAAA,oBAAC,mBAAD;GAAmB,OAAA;GAChB,UAAA,eAAe,KAAK,WACnB,oBAAC,mBAAD;IAAmC,OAAO;IACvC;GACgB,GAFK,OAAO,EAEZ,CACpB;EACgB,CAAA;CACjB,CAAA;AAER;AAKA,SAAgB,wBAAwB,EACtC,WACA,UACA,GAAG,SAC8E;CACjF,MAAM,SAAS,cAAc;CAC7B,MAAM,SAAS,WAAW,iBAAiB;CAE3C,OAAO,cACL,SAAS,OAAO,OAChB;EACE,GAAG;EACH;EACA,qCAAqC;EACrC,6CAA6C,OAAO;CACtD,GACA,QACF;AACF;AAEA,SAAgB,4BAA4B,EAAE,WAAW,UAAU,GAAG,SAA2C;CAC/G,MAAM,SAAS,cAAc;CAE7B,OACE,oBAAC,QAAD;EAAM,GAAI;EAAkB;EAAW,0CAAuC;EAC3E,UAAA,YAAY,OAAO;CAChB,CAAA;AAEV;AAEA,SAAgB,gCAAgC,EAC9C,UACA,SACA,WACA,UACA,GAAG,SACoC;CACvC,MAAM,SAAS,cAAc;CAC7B,MAAM,EAAE,WAAW,oBAAoB,wCAAwC,QAAQ;CAEvF,SAAS,WAAW;EAClB,MAAM,EAAE,OAAO,SAAS,OAAO;EAC/B,IAAI,UAAU,GAAG,OAAO,OAAO,OAAO;EACtC,MAAM,EAAE,OAAO,aAAa,iBAAiB;EAE7C,OAAO,OAAO,OAAO,GAAG,WAAW,MAAM,CAAoC;CAC/E;CAEA,OACE,oBAAC,QAAD;EAAM,GAAI;EAAkB;EAAW,8CAA2C;EAC/E,UAAA,YAAY,SAAS;CAClB,CAAA;AAEV;AAEA,SAAgB,aAAa,QAA0B;CACrD,OAAO,eAAe,MAAM,KAAK,OAAO,MAAM,MAAM;AACtD;AAEA,SAAgB,6BAA6B,EAC3C,UACA,SACA,WACA,UACA,GAAG,SACiC;CACpC,MAAM,SAAS,cAAc;CAC7B,MAAM,EAAE,WAAW,oBAAoB,qCAAqC,QAAQ;CACpF,MAAM,EAAE,QAAQ,aAAa,qBAAqB;CAElD,OACE,oBAAC,QAAD;EAAM,GAAI;EAAkB;EAAW,2CAAwC;EAC5E,UAAA,aACE,aAAa,OAAO,MAAM,MAAM,IAC7B,OAAO,WAAW,IAClB,YAAY,OAAO,OAAO,MAAM,MAAM,GAAG,QAAQ,QAAQ;CAC3D,CAAA;AAEV;AAEA,SAAgB,iCAAiC,EAC/C,UACA,SACA,WACA,UACA,GAAG,SACqC;CACxC,MAAM,SAAS,cAAc;CAC7B,MAAM,EAAE,WAAW,oBAAoB,yCAAyC,QAAQ;CACxF,IAAI,CAAC,aAAa,OAAO,MAAM,MAAM,GAAG,OAAO;CAE/C,OACE,oBAAC,QAAD;EAAM,GAAI;EAAkB;EAAW,gDAA6C;EACjF,UAAA,YAAY,OAAO,MAAM;CACtB,CAAA;AAEV;AAEA,SAAgB,uBAAuB,EACrC,UACA,SACA,WACA,UACA,GAAG,SAC2B;CAC9B,MAAM,EAAE,iBAAiB,eAAe,qBAAqB;CAC7D,MAAM,EAAE,WAAW,oBAAoB,+BAA+B,QAAQ;CAG9E,IAAI,EADmB,MAAM,QAAQ,eAAe,KAAK,gBAAgB,WAAW,KAAK,WAAW,WAAW,IAC1F,OAAO;CAE5B,OACE,oBAAC,UAAD;EAAQ,GAAI;EAAO,aAAU;EAAoB;EAAW,oCAAiC;EAC1F,UAAA,YAAY,OAAO,MAAM;CACpB,CAAA;AAEZ;AAMA,MAAa,oBAAoB;CAC/B,MAAM;CACN,MAAM;CACN,OAAO;CACP,QAAQ;CACR,SAAS;CACT,OAAO;CACP,SAAS;CACT,QAAQ;CACR,YAAY;CACZ,gBAAgB;CAChB,aAAa;CACb,iBAAiB;CACjB,OAAO;AACT;AAEA,MAAa,wBAAwB;CACnC,MAAM;CACN,MAAM;CACN,OAAO;CACP,QAAQ;CACR,SAAS;CACT,OAAO;CACP,SAAS;CACT,QAAQ;CACR,YAAY;CACZ,gBAAgB;CAChB,aAAa;CACb,iBAAiB;CACjB,OAAO;AACT"}

package/dist/matter/sign-in/sign-in.d.ts

@@ -0,0 +1,108 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef, ReactNode } from "react";
+//#region src/matter/sign-in/sign-in.d.ts
+/** Colocated fragment slice forwarded by the reactive runtime — one key per root field. */
+export type SignInSlice = {
+  clientProfile: {
+    email: string | null;
+  } | null;
+  sessionAuthProviders: {
+    passwordAuthentication: boolean;
+    accessKeyAuthentication: boolean;
+  } | null;
+};
+export type SignInMethod = 'password' | 'accessCode';
+export type SignInContextValue = Readonly<{
+  /** The one email draft every sign-in method shares. Seeded from `clientProfile.email` until the shopper edits it. */
+  email: string;
+  /** Updates the draft; marks it as shopper-touched so the seed no longer overwrites it. */
+  setEmail: (email: string) => void;
+  /** The active method: the shopper's choice, else the access code when enabled, else the password. */
+  method: SignInMethod;
+  setMethod: (method: SignInMethod) => void;
+  passwordEnabled: boolean;
+  accessCodeEnabled: boolean;
+  anyMethodEnabled: boolean;
+  bothMethodsEnabled: boolean;
+  /** Whether the account configuration has arrived. Gate on this before reading any flag above. */
+  resolved: boolean;
+}>;
+export type SignInRootProps = Readonly<{
+  $data?: SignInSlice | null;
+  children?: ReactNode;
+}>;
+export type SignInEmailControlProps = ComponentPropsWithRef<'div'> & {
+  label?: string;
+  placeholder?: string;
+  invalidEmailMessage?: string;
+  /** The input's `name`. Defaults to `EmailField`'s own (`'email'`). */
+  name?: string;
+  /** The input's `autocomplete` token. Defaults to `'username'`, the identifier half of the credential pair. */
+  autoComplete?: string;
+};
+export type SignInMethodSwitchProps = ComponentPropsWithRef<'div'> & {
+  toAccessCodeLabel?: string;
+  toPasswordLabel?: string;
+};
+export type SignInMethodOptionProps = ComponentPropsWithRef<'div'> & {
+  /** Which method this option selects. Required — the option has no meaning without it. */
+  method: SignInMethod;
+  label?: string;
+};
+/**
+ * Read the shared email draft, active method and account flags from the nearest `SignInRoot`.
+ * Throws outside that subtree — a misplaced part is a composition bug that should surface
+ * immediately, mirroring `useSession()`/`useAccessCodeSignIn()`.
+ */
+export declare function useSignIn(): SignInContextValue;
+export declare const SignInRootDefinition: ComponentDefinition<Readonly<{
+  $data?: SignInSlice | null;
+  children?: ReactNode;
+}>>;
+export declare const SignInEmailControlDefinition: ComponentDefinition<SignInEmailControlProps>;
+export declare const SignInMethodSwitchDefinition: ComponentDefinition<SignInMethodSwitchProps>;
+export declare const SignInMethodOptionDefinition: ComponentDefinition<SignInMethodOptionProps>;
+/**
+ * Data-owning provider of the sign-in surface. Reads `sessionAuthProviders` once, owns the shared
+ * email draft and the active method, and publishes all of it as the `sign-in` context. It renders no
+ * element of its own and always renders `children` — a provider that returned `null` while hosted in
+ * a shared layout would take the page with it.
+ *
+ * `resolved` is the three-condition gate the entity fieldsets use: a reactive `$data` is never `null`
+ * at runtime (it falls back to a placeholder slice), so only the two resolution signals plus the
+ * presence of `sessionAuthProviders` tell "not arrived yet" from "arrived and disabled".
+ */
+export declare function SignInRoot({ $data: $dataProp, children }: SignInRootProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Catalog metadata only: `SignInRoot` has no loading look because it always renders its children, so
+ * this declares that by rendering nothing. The compiler records the `skeleton` name and never renders
+ * it; no component body references it.
+ */
+export declare function SignInRootSkeleton(): null;
+export declare function SignInEmailControlSkeleton({ className, ...props }: ComponentPropsWithRef<'div'>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The one email field, bound to the Root's shared draft. Renders its skeleton while the account
+ * configuration is unresolved, so a slow read does not look like a store with no sign-in, and nothing
+ * once the shopper is signed in or the account enables no method.
+ */
+export declare function SignInEmailControl({ label, placeholder, invalidEmailMessage, name, autoComplete, className, ...props }: SignInEmailControlProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * One toggle button that moves the active method. Renders only when the account enables both
+ * methods; the button is labelled with the method it moves to.
+ */
+export declare function SignInMethodSwitch({ toAccessCodeLabel, toPasswordLabel, className, ...props }: SignInMethodSwitchProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * One selectable method. Renders only when the account enables the method named by `method`, and
+ * carries a selected state while that method is the active one — so one option per method gives a
+ * store exactly the options its account enables.
+ */
+export declare function SignInMethodOption({ method, label, className, ...props }: SignInMethodOptionProps): import("react/jsx-runtime").JSX.Element | null;
+export declare const SignIn: {
+  Root: typeof SignInRoot;
+  EmailControl: typeof SignInEmailControl;
+  MethodSwitch: typeof SignInMethodSwitch;
+  MethodOption: typeof SignInMethodOption;
+};
+//#endregion
+//# sourceMappingURL=sign-in.d.ts.map

package/dist/matter/sign-in/sign-in.js

@@ -0,0 +1,285 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { EmailField } from "../../particles/email-field/email-field.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { useSession } from "../session/session.js";
+import { Button } from "../../particles/button/button.js";
+import { useEntityDataResolved } from "../../sdk/data/entity-resolution-context.js";
+import { useReactiveDataSettled } from "../../sdk/data/use-reactive-data-settled.js";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/matter/sign-in/sign-in.tsx
+const fragment = `
+  fragment SignInData on Query {
+    clientProfile {
+      __typename
+      id
+      email
+    }
+    sessionAuthProviders {
+      __typename
+      id
+      passwordAuthentication
+      accessKeyAuthentication
+    }
+  }
+`;
+const SIGN_IN_CONTEXT_UNSET = Symbol("SignInContextUnset");
+const SignInContext = createContext(SIGN_IN_CONTEXT_UNSET);
+/**
+* Read the shared email draft, active method and account flags from the nearest `SignInRoot`.
+* Throws outside that subtree — a misplaced part is a composition bug that should surface
+* immediately, mirroring `useSession()`/`useAccessCodeSignIn()`.
+*/
+function useSignIn() {
+	const ctx = useContext(SignInContext);
+	if (ctx === SIGN_IN_CONTEXT_UNSET) throw new Error("useSignIn() must be used inside a <SignInRoot> subtree.");
+	return ctx;
+}
+const SignInRootDefinition = defineComponent({
+	name: "SignInRoot",
+	importPath: "@vtex/faststore/components",
+	component: SignInRoot,
+	fragment,
+	fetchStrategy: "reactive",
+	skeleton: SignInRootSkeleton,
+	requiresContext: "session",
+	providesContext: "sign-in",
+	editor: {
+		label: "Sign-In Root",
+		category: "identity"
+	},
+	schema: {},
+	guideline: "Provider of the sign-in surface: the single read of which sign-in methods the account enables, plus one shared email draft and the active method, published to the SignIn parts below it. Renders no element of its own and always renders its children, whatever the session state or the account configuration. Compose SignInEmailControl and either SignInMethodSwitch or SignInMethodOption inside it. Must be inside SessionRoot. See sign-in.md."
+});
+const SignInEmailControlDefinition = defineComponent({
+	name: "SignInEmailControl",
+	importPath: "@vtex/faststore/components",
+	component: SignInEmailControl,
+	skeleton: SignInEmailControlSkeleton,
+	requiresContext: "sign-in",
+	editor: {
+		label: "Sign-In Email",
+		category: "identity"
+	},
+	schema: {
+		label: {
+			type: "string",
+			label: "Label"
+		},
+		placeholder: {
+			type: "string",
+			label: "Placeholder"
+		},
+		invalidEmailMessage: {
+			type: "string",
+			label: "Invalid email message"
+		}
+	},
+	guideline: "The one email field shared by every sign-in method. Draws a placeholder while the account configuration loads, and renders nothing once signed in or when the account enables no method. Must be inside SignInRoot. See sign-in.md."
+});
+const SignInMethodSwitchDefinition = defineComponent({
+	name: "SignInMethodSwitch",
+	importPath: "@vtex/faststore/components",
+	component: SignInMethodSwitch,
+	requiresContext: "sign-in",
+	editor: {
+		label: "Sign-In Method Switch",
+		category: "identity"
+	},
+	schema: {
+		toAccessCodeLabel: {
+			type: "string",
+			label: "Switch to access code label"
+		},
+		toPasswordLabel: {
+			type: "string",
+			label: "Switch to password label"
+		}
+	},
+	guideline: "One toggle button that moves the active sign-in method between the access code and the password. Renders nothing unless the account enables both methods. Must be inside SignInRoot. See sign-in.md."
+});
+const SignInMethodOptionDefinition = defineComponent({
+	name: "SignInMethodOption",
+	importPath: "@vtex/faststore/components",
+	component: SignInMethodOption,
+	requiresContext: "sign-in",
+	editor: {
+		label: "Sign-In Method Option",
+		category: "identity"
+	},
+	schema: {
+		method: {
+			type: ["password", "accessCode"],
+			label: "Method"
+		},
+		label: {
+			type: "string",
+			label: "Label"
+		}
+	},
+	guideline: "One selectable sign-in method. Renders nothing when the account disables the method it names, so composing one per method gives a store exactly the options its account enables. Compose it instead of SignInMethodSwitch when both methods should be visible at once, or beside the default method as an escape hatch. Must be inside SignInRoot. See sign-in.md."
+});
+/**
+* Data-owning provider of the sign-in surface. Reads `sessionAuthProviders` once, owns the shared
+* email draft and the active method, and publishes all of it as the `sign-in` context. It renders no
+* element of its own and always renders `children` — a provider that returned `null` while hosted in
+* a shared layout would take the page with it.
+*
+* `resolved` is the three-condition gate the entity fieldsets use: a reactive `$data` is never `null`
+* at runtime (it falls back to a placeholder slice), so only the two resolution signals plus the
+* presence of `sessionAuthProviders` tell "not arrived yet" from "arrived and disabled".
+*/
+function SignInRoot({ $data: $dataProp, children }) {
+	const $data = useDataOverride($dataProp);
+	const settled = useReactiveDataSettled();
+	const sliceResolved = useEntityDataResolved();
+	const providers = $data?.sessionAuthProviders ?? null;
+	const resolved = settled && sliceResolved && providers != null;
+	const { state } = useSession();
+	const passwordEnabled = resolved && providers.passwordAuthentication;
+	const accessCodeEnabled = resolved && providers.accessKeyAuthentication;
+	const savedEmail = $data?.clientProfile?.email ?? "";
+	const [email, setEmail] = useState("");
+	const [touched, setTouched] = useState(false);
+	useEffect(() => {
+		if (!touched) setEmail(savedEmail);
+	}, [savedEmail, touched]);
+	useEffect(() => {
+		if (state === "loggedIn") setTouched(false);
+	}, [state]);
+	const editEmail = useCallback((next) => {
+		setTouched(true);
+		setEmail(next);
+	}, []);
+	const [chosenMethod, setChosenMethod] = useState(null);
+	const method = chosenMethod !== null && (!resolved || (chosenMethod === "password" ? passwordEnabled : accessCodeEnabled)) ? chosenMethod : accessCodeEnabled ? "accessCode" : "password";
+	const contextValue = useMemo(() => ({
+		email,
+		setEmail: editEmail,
+		method,
+		setMethod: setChosenMethod,
+		passwordEnabled,
+		accessCodeEnabled,
+		anyMethodEnabled: passwordEnabled || accessCodeEnabled,
+		bothMethodsEnabled: passwordEnabled && accessCodeEnabled,
+		resolved
+	}), [
+		email,
+		editEmail,
+		method,
+		passwordEnabled,
+		accessCodeEnabled,
+		resolved
+	]);
+	return /* @__PURE__ */ jsx(SignInContext, {
+		value: contextValue,
+		children
+	});
+}
+/**
+* Catalog metadata only: `SignInRoot` has no loading look because it always renders its children, so
+* this declares that by rendering nothing. The compiler records the `skeleton` name and never renders
+* it; no component body references it.
+*/
+function SignInRootSkeleton() {
+	return null;
+}
+function SignInEmailControlSkeleton({ className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-sign-in-email-skeleton": "",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("span", { "data-fs-sign-in-email-skeleton-line": "" })
+	});
+}
+/**
+* The one email field, bound to the Root's shared draft. Renders its skeleton while the account
+* configuration is unresolved, so a slow read does not look like a store with no sign-in, and nothing
+* once the shopper is signed in or the account enables no method.
+*/
+function SignInEmailControl({ label, placeholder, invalidEmailMessage, name, autoComplete = "username", className, ...props }) {
+	const signIn = useSignIn();
+	const { state } = useSession();
+	if (state === "loggedIn") return null;
+	if (!signIn.resolved) return /* @__PURE__ */ jsx(SignInEmailControlSkeleton, {
+		...props,
+		className
+	});
+	if (!signIn.anyMethodEnabled) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-sign-in-email": "",
+		children: /* @__PURE__ */ jsx(EmailField, {
+			label,
+			placeholder,
+			value: signIn.email,
+			onValueChange: signIn.setEmail,
+			errorMessage: invalidEmailMessage,
+			name,
+			autoComplete
+		})
+	});
+}
+/**
+* One toggle button that moves the active method. Renders only when the account enables both
+* methods; the button is labelled with the method it moves to.
+*/
+function SignInMethodSwitch({ toAccessCodeLabel, toPasswordLabel, className, ...props }) {
+	const signIn = useSignIn();
+	const { state } = useSession();
+	if (state === "loggedIn" || !signIn.resolved) return null;
+	if (!signIn.bothMethodsEnabled) return null;
+	const { method, setMethod } = signIn;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-sign-in-method-switch": "",
+		"data-fs-sign-in-method": method,
+		children: /* @__PURE__ */ jsx(Button, {
+			type: "button",
+			onClick: () => setMethod(method === "accessCode" ? "password" : "accessCode"),
+			"data-fs-sign-in-method-switch-button": "",
+			children: method === "password" ? toAccessCodeLabel : toPasswordLabel
+		})
+	});
+}
+/**
+* One selectable method. Renders only when the account enables the method named by `method`, and
+* carries a selected state while that method is the active one — so one option per method gives a
+* store exactly the options its account enables.
+*/
+function SignInMethodOption({ method, label, className, ...props }) {
+	const signIn = useSignIn();
+	const { state } = useSession();
+	if (state === "loggedIn" || !signIn.resolved) return null;
+	if (method !== "password" && method !== "accessCode") return null;
+	if (!(method === "password" ? signIn.passwordEnabled : signIn.accessCodeEnabled)) return null;
+	const selected = signIn.method === method;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-sign-in-method-option": method,
+		...selected ? { "data-fs-sign-in-method-option-selected": "" } : {},
+		children: /* @__PURE__ */ jsx(Button, {
+			type: "button",
+			"aria-pressed": selected,
+			onClick: () => signIn.setMethod(method),
+			"data-fs-sign-in-method-option-button": "",
+			children: label
+		})
+	});
+}
+const SignIn = {
+	Root: SignInRoot,
+	EmailControl: SignInEmailControl,
+	MethodSwitch: SignInMethodSwitch,
+	MethodOption: SignInMethodOption
+};
+//#endregion
+export { SignIn, SignInEmailControl, SignInEmailControlDefinition, SignInEmailControlSkeleton, SignInMethodOption, SignInMethodOptionDefinition, SignInMethodSwitch, SignInMethodSwitchDefinition, SignInRoot, SignInRootDefinition, SignInRootSkeleton, useSignIn };
+
+//# sourceMappingURL=sign-in.js.map