@asteby/storefront-react 0.25.0 → 0.26.1

package/dist/checkout.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
-import { Address, CartLine, CartCost, Money, ShippingRate, PickupOption } from '@asteby/storefront';
+import { ReactNode, RefObject } from 'react';
+import { Address, CartLine, CartCost, Money, ShippingRate, PickupOption, DeliveryOptions as DeliveryOptions$1 } from '@asteby/storefront';
 import { F as FieldErrors, g as FieldMessages, a as CheckoutFieldClassNames } from './fields-vnMUi2HB.cjs';
 export { C as CheckoutField, b as CheckoutFieldProps, c as CheckoutSelectProps, E as ErrorSummary, d as ErrorSummaryItem, e as ErrorSummaryProps, f as FieldErrorsState, U as UseFieldErrorsOptions, h as fieldMessages, u as useFieldErrors, v as validationMessage } from './fields-vnMUi2HB.cjs';
 
@@ -290,6 +290,11 @@ type DeliveryMessages = {
     /** The rates could not be quoted (`error`). */
     error: string;
     retry: string;
+    /** The order reaches the free-shipping minimum: nothing to choose. */
+    freeShipping: string;
+    freeShippingNote: string;
+    /** Screen-reader status when the rates are ready (`{n}` = how many). */
+    ratesReady: string;
 };
 /** Messages for a locale (`es*` default, `en*`), with optional overrides. */
 declare function deliveryMessages(locale?: string | null, overrides?: Partial<DeliveryMessages> | null): DeliveryMessages;
@@ -342,7 +347,7 @@ declare function isQuoteChange(err: {
  */
 declare function matchRate<R extends Pick<ShippingRate, 'id' | 'carrier' | 'service_code' | 'title'>>(previous: Pick<ShippingRate, 'carrier' | 'service_code' | 'title'> | null | undefined, rates: readonly R[]): R | null;
 
-type DeliveryOptionsClassNames = Partial<Record<'root' | 'option' | 'radio' | 'mark' | 'body' | 'title' | 'carrier' | 'service' | 'eta' | 'badges' | 'badge' | 'price' | 'free' | 'note' | 'partial' | 'skeleton' | 'more' | 'moreSummary' | 'group' | 'groupTitle' | 'error' | 'retry', string>>;
+type DeliveryOptionsClassNames = Partial<Record<'root' | 'option' | 'radio' | 'mark' | 'body' | 'title' | 'carrier' | 'service' | 'eta' | 'badges' | 'badge' | 'price' | 'free' | 'freeBanner' | 'note' | 'partial' | 'skeleton' | 'more' | 'moreSummary' | 'group' | 'groupTitle' | 'error' | 'retry', string>>;
 type DeliveryOptionsProps = {
     rates: readonly ShippingRate[];
     pickup?: readonly PickupOption[];
@@ -363,6 +368,14 @@ type DeliveryOptionsProps = {
     requoted?: boolean;
     /** Rates are being quoted again: skeleton rows (no rates yet) or the current rows dimmed, `aria-busy`. */
     loading?: boolean;
+    /**
+     * The order reaches the free-shipping minimum (`DeliveryOptions.free`, configured by the organization): no carrier
+     * selector, just "Free shipping" and the rate is submitted by itself so the buyer goes straight to payment.
+     * With pickup branches the plain rows stay (delivery or pickup is still a real choice).
+     */
+    free?: boolean;
+    /** Rates just arrived by themselves (auto quote): a polite screen-reader status says how many. */
+    announceReady?: boolean;
     /** Quote deadline note: `always` (default), only when it is `soon`, or `never`. */
     quoteNote?: 'always' | 'soon' | 'never';
     /** Time zone of the note. Default: the buyer's browser. */
@@ -475,4 +488,91 @@ type FlatRatesOptions = {
  */
 declare function flatRates<R extends ShippingRate>(input: readonly R[], options?: FlatRatesOptions): RecommendedRate<R>[];
 
-export { ADDRESS_FILL_EVENT_FLAG, type AddressFieldKey, AddressFields, type AddressFieldsMessages, type AddressFieldsProps, type Brand, type BrandKind, BrandMark, type BrandMarkProps, type BrandMarkSource, CheckoutFieldClassNames, type ContactFieldKey, ContactFields, type ContactFieldsProps, type DeliveryMessages, DeliveryOptions, type DeliveryOptionsClassNames, type DeliveryOptionsProps, FieldErrors, type FieldLayoutClassNames, FieldMessages, type FlatRatesOptions, OrderSummary, type OrderSummaryClassNames, OrderSummaryDisclosure, type OrderSummaryDisclosureProps, type OrderSummaryMessages, type OrderSummaryProps, type PostalCodeInfo, type QuoteNote, type RateBadge, type RateGroup, type RateTag, type RecommendRatesOptions, type RecommendedRate, type RecommendedRates, addressFieldsMessages, brandKey, brandLogo, brandName, dedupeRates, deliveryMessages, findBrand, flatRates, isAddressFillEvent, isQuoteChange, listBrands, matchRate, orderSummaryMessages, quoteDeadline, quoteNote, rateBadges, rateCarrier, rateEta, rateService, recommendRates };
+/**
+ * One-step delivery: as soon as the address is complete the shipping rates load by themselves (debounced), the default
+ * rate is preselected and payment is ready. No "continue" button, no choosing again.
+ *
+ * The hook is transport-agnostic: the shop gives `quote(address)` (save the address in the cart, read the delivery
+ * options) and renders the result with `<DeliveryOptions>`. Only the fields that change the price re-quote (country,
+ * postal code, state, city): editing the street number, the phone or the reference does not. Free shipping and fixed
+ * prices come from the server (`DeliveryOptions.free` / `.fixed`, configured per organization): nothing here knows an
+ * amount.
+ */
+
+/** What the shop reads from the address fields of the form. Keys follow the `name` of each input. */
+type QuoteAddress = {
+    country_code: string;
+    zip: string;
+    province: string;
+    city: string;
+    neighborhood: string;
+    address1: string;
+    [key: string]: string;
+};
+type AutoQuoteStatus = 
+/** Address incomplete: nothing is quoted yet. */
+'idle'
+/** Complete address, waiting for the buyer to stop typing. */
+ | 'waiting' | 'loading' | 'ready' | 'error';
+type UseAutoQuoteOptions = {
+    /** The form that holds the address inputs (events are listened to on it). */
+    formRef: RefObject<HTMLFormElement | null>;
+    /**
+     * Saves the address and returns the delivery options for it. Receives an `AbortSignal` that fires when a newer
+     * quote replaces this one: ignore its result then (the hook already does).
+     *
+     * Only price fields re-quote, so the address saved here can lag behind the form (street, number, reference): the
+     * shop's submit must save the full address again before choosing the delivery and paying. The server validates the
+     * chosen rate against the saved address (a rate of another postal code is refused), so a stale quote never sets a price.
+     */
+    quote: (address: QuoteAddress, signal: AbortSignal) => Promise<DeliveryOptions$1>;
+    /** `name` of each address input. Default: `country_code`, `zip`, `province`, `city`, `neighborhood`, `address1`. */
+    names?: Partial<Record<'country_code' | 'zip' | 'province' | 'city' | 'neighborhood' | 'address1', string>>;
+    /** Fields that must be filled to quote. Default: all of the six names above except `country_code`. */
+    required?: ReadonlyArray<keyof QuoteAddress>;
+    /** A postal code is valid to quote. Default: 5 digits. */
+    validPostalCode?: (zip: string) => boolean;
+    /** Country used when the form has no country input. Default `MX`. */
+    defaultCountry?: string;
+    /** Quiet time after the last keystroke. Default 600 ms. */
+    debounceMs?: number;
+    /** Picks the preselected rate. Default: {@link defaultRate} (the cheapest). */
+    pickDefault?: (delivery: DeliveryOptions$1) => ShippingRate | null;
+    /** The rate (`rate:<id>`) already saved in the cart: kept when the quote still offers it. */
+    savedValue?: string | null;
+    enabled?: boolean;
+    /** Fires with the options of every successful quote. */
+    onQuoted?: (delivery: DeliveryOptions$1) => void;
+};
+type UseAutoQuoteResult = {
+    status: AutoQuoteStatus;
+    /** The last good quote (kept while a new one loads, so the list does not flash). `null` before the first. */
+    delivery: DeliveryOptions$1 | null;
+    /** `rate:<id>` to preselect (the saved rate if still offered, else the default), `null` when none. */
+    defaultValue: string | null;
+    /** The address the current `delivery` was quoted for. */
+    quotedFor: QuoteAddress | null;
+    /** Quote again now (retry button). */
+    retry: () => void;
+    /** Plain-language status for a live region ("Buscando…", "Listo", …) keys, not text. */
+    announce: 'searching' | 'ready' | 'free' | 'error' | null;
+};
+declare const DEFAULT_QUOTE_NAMES: {
+    readonly country_code: "country_code";
+    readonly zip: "zip";
+    readonly province: "province";
+    readonly city: "city";
+    readonly neighborhood: "neighborhood";
+    readonly address1: "address1";
+};
+/** Only these change the price of a shipment; any other field of the form (street, phone, reference…) never re-quotes. */
+declare const QUOTE_KEYS: readonly ["country_code", "zip", "province", "city"];
+/** Identity of a quote: equal fingerprints share the same rates. */
+declare function quoteFingerprint(a: Pick<QuoteAddress, (typeof QUOTE_KEYS)[number]>): string;
+/** The default rate: the cheapest one that is not a pickup (ties keep the server order, which already puts the best first). */
+declare function defaultRate(delivery: Pick<DeliveryOptions$1, 'rates'>): ShippingRate | null;
+/** Reads the address from the form; `null` when it is not complete yet. */
+declare function readQuoteAddress(form: HTMLFormElement | null, opts?: Pick<UseAutoQuoteOptions, 'names' | 'required' | 'validPostalCode' | 'defaultCountry'>): QuoteAddress | null;
+declare function useAutoQuote(options: UseAutoQuoteOptions): UseAutoQuoteResult;
+
+export { ADDRESS_FILL_EVENT_FLAG, type AddressFieldKey, AddressFields, type AddressFieldsMessages, type AddressFieldsProps, type AutoQuoteStatus, type Brand, type BrandKind, BrandMark, type BrandMarkProps, type BrandMarkSource, CheckoutFieldClassNames, type ContactFieldKey, ContactFields, type ContactFieldsProps, DEFAULT_QUOTE_NAMES, type DeliveryMessages, DeliveryOptions, type DeliveryOptionsClassNames, type DeliveryOptionsProps, FieldErrors, type FieldLayoutClassNames, FieldMessages, type FlatRatesOptions, OrderSummary, type OrderSummaryClassNames, OrderSummaryDisclosure, type OrderSummaryDisclosureProps, type OrderSummaryMessages, type OrderSummaryProps, type PostalCodeInfo, QUOTE_KEYS, type QuoteAddress, type QuoteNote, type RateBadge, type RateGroup, type RateTag, type RecommendRatesOptions, type RecommendedRate, type RecommendedRates, type UseAutoQuoteOptions, type UseAutoQuoteResult, addressFieldsMessages, brandKey, brandLogo, brandName, dedupeRates, defaultRate, deliveryMessages, findBrand, flatRates, isAddressFillEvent, isQuoteChange, listBrands, matchRate, orderSummaryMessages, quoteDeadline, quoteFingerprint, quoteNote, rateBadges, rateCarrier, rateEta, rateService, readQuoteAddress, recommendRates, useAutoQuote };

package/dist/checkout.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
-import { Address, CartLine, CartCost, Money, ShippingRate, PickupOption } from '@asteby/storefront';
+import { ReactNode, RefObject } from 'react';
+import { Address, CartLine, CartCost, Money, ShippingRate, PickupOption, DeliveryOptions as DeliveryOptions$1 } from '@asteby/storefront';
 import { F as FieldErrors, g as FieldMessages, a as CheckoutFieldClassNames } from './fields-vnMUi2HB.js';
 export { C as CheckoutField, b as CheckoutFieldProps, c as CheckoutSelectProps, E as ErrorSummary, d as ErrorSummaryItem, e as ErrorSummaryProps, f as FieldErrorsState, U as UseFieldErrorsOptions, h as fieldMessages, u as useFieldErrors, v as validationMessage } from './fields-vnMUi2HB.js';
 
@@ -290,6 +290,11 @@ type DeliveryMessages = {
     /** The rates could not be quoted (`error`). */
     error: string;
     retry: string;
+    /** The order reaches the free-shipping minimum: nothing to choose. */
+    freeShipping: string;
+    freeShippingNote: string;
+    /** Screen-reader status when the rates are ready (`{n}` = how many). */
+    ratesReady: string;
 };
 /** Messages for a locale (`es*` default, `en*`), with optional overrides. */
 declare function deliveryMessages(locale?: string | null, overrides?: Partial<DeliveryMessages> | null): DeliveryMessages;
@@ -342,7 +347,7 @@ declare function isQuoteChange(err: {
  */
 declare function matchRate<R extends Pick<ShippingRate, 'id' | 'carrier' | 'service_code' | 'title'>>(previous: Pick<ShippingRate, 'carrier' | 'service_code' | 'title'> | null | undefined, rates: readonly R[]): R | null;
 
-type DeliveryOptionsClassNames = Partial<Record<'root' | 'option' | 'radio' | 'mark' | 'body' | 'title' | 'carrier' | 'service' | 'eta' | 'badges' | 'badge' | 'price' | 'free' | 'note' | 'partial' | 'skeleton' | 'more' | 'moreSummary' | 'group' | 'groupTitle' | 'error' | 'retry', string>>;
+type DeliveryOptionsClassNames = Partial<Record<'root' | 'option' | 'radio' | 'mark' | 'body' | 'title' | 'carrier' | 'service' | 'eta' | 'badges' | 'badge' | 'price' | 'free' | 'freeBanner' | 'note' | 'partial' | 'skeleton' | 'more' | 'moreSummary' | 'group' | 'groupTitle' | 'error' | 'retry', string>>;
 type DeliveryOptionsProps = {
     rates: readonly ShippingRate[];
     pickup?: readonly PickupOption[];
@@ -363,6 +368,14 @@ type DeliveryOptionsProps = {
     requoted?: boolean;
     /** Rates are being quoted again: skeleton rows (no rates yet) or the current rows dimmed, `aria-busy`. */
     loading?: boolean;
+    /**
+     * The order reaches the free-shipping minimum (`DeliveryOptions.free`, configured by the organization): no carrier
+     * selector, just "Free shipping" and the rate is submitted by itself so the buyer goes straight to payment.
+     * With pickup branches the plain rows stay (delivery or pickup is still a real choice).
+     */
+    free?: boolean;
+    /** Rates just arrived by themselves (auto quote): a polite screen-reader status says how many. */
+    announceReady?: boolean;
     /** Quote deadline note: `always` (default), only when it is `soon`, or `never`. */
     quoteNote?: 'always' | 'soon' | 'never';
     /** Time zone of the note. Default: the buyer's browser. */
@@ -475,4 +488,91 @@ type FlatRatesOptions = {
  */
 declare function flatRates<R extends ShippingRate>(input: readonly R[], options?: FlatRatesOptions): RecommendedRate<R>[];
 
-export { ADDRESS_FILL_EVENT_FLAG, type AddressFieldKey, AddressFields, type AddressFieldsMessages, type AddressFieldsProps, type Brand, type BrandKind, BrandMark, type BrandMarkProps, type BrandMarkSource, CheckoutFieldClassNames, type ContactFieldKey, ContactFields, type ContactFieldsProps, type DeliveryMessages, DeliveryOptions, type DeliveryOptionsClassNames, type DeliveryOptionsProps, FieldErrors, type FieldLayoutClassNames, FieldMessages, type FlatRatesOptions, OrderSummary, type OrderSummaryClassNames, OrderSummaryDisclosure, type OrderSummaryDisclosureProps, type OrderSummaryMessages, type OrderSummaryProps, type PostalCodeInfo, type QuoteNote, type RateBadge, type RateGroup, type RateTag, type RecommendRatesOptions, type RecommendedRate, type RecommendedRates, addressFieldsMessages, brandKey, brandLogo, brandName, dedupeRates, deliveryMessages, findBrand, flatRates, isAddressFillEvent, isQuoteChange, listBrands, matchRate, orderSummaryMessages, quoteDeadline, quoteNote, rateBadges, rateCarrier, rateEta, rateService, recommendRates };
+/**
+ * One-step delivery: as soon as the address is complete the shipping rates load by themselves (debounced), the default
+ * rate is preselected and payment is ready. No "continue" button, no choosing again.
+ *
+ * The hook is transport-agnostic: the shop gives `quote(address)` (save the address in the cart, read the delivery
+ * options) and renders the result with `<DeliveryOptions>`. Only the fields that change the price re-quote (country,
+ * postal code, state, city): editing the street number, the phone or the reference does not. Free shipping and fixed
+ * prices come from the server (`DeliveryOptions.free` / `.fixed`, configured per organization): nothing here knows an
+ * amount.
+ */
+
+/** What the shop reads from the address fields of the form. Keys follow the `name` of each input. */
+type QuoteAddress = {
+    country_code: string;
+    zip: string;
+    province: string;
+    city: string;
+    neighborhood: string;
+    address1: string;
+    [key: string]: string;
+};
+type AutoQuoteStatus = 
+/** Address incomplete: nothing is quoted yet. */
+'idle'
+/** Complete address, waiting for the buyer to stop typing. */
+ | 'waiting' | 'loading' | 'ready' | 'error';
+type UseAutoQuoteOptions = {
+    /** The form that holds the address inputs (events are listened to on it). */
+    formRef: RefObject<HTMLFormElement | null>;
+    /**
+     * Saves the address and returns the delivery options for it. Receives an `AbortSignal` that fires when a newer
+     * quote replaces this one: ignore its result then (the hook already does).
+     *
+     * Only price fields re-quote, so the address saved here can lag behind the form (street, number, reference): the
+     * shop's submit must save the full address again before choosing the delivery and paying. The server validates the
+     * chosen rate against the saved address (a rate of another postal code is refused), so a stale quote never sets a price.
+     */
+    quote: (address: QuoteAddress, signal: AbortSignal) => Promise<DeliveryOptions$1>;
+    /** `name` of each address input. Default: `country_code`, `zip`, `province`, `city`, `neighborhood`, `address1`. */
+    names?: Partial<Record<'country_code' | 'zip' | 'province' | 'city' | 'neighborhood' | 'address1', string>>;
+    /** Fields that must be filled to quote. Default: all of the six names above except `country_code`. */
+    required?: ReadonlyArray<keyof QuoteAddress>;
+    /** A postal code is valid to quote. Default: 5 digits. */
+    validPostalCode?: (zip: string) => boolean;
+    /** Country used when the form has no country input. Default `MX`. */
+    defaultCountry?: string;
+    /** Quiet time after the last keystroke. Default 600 ms. */
+    debounceMs?: number;
+    /** Picks the preselected rate. Default: {@link defaultRate} (the cheapest). */
+    pickDefault?: (delivery: DeliveryOptions$1) => ShippingRate | null;
+    /** The rate (`rate:<id>`) already saved in the cart: kept when the quote still offers it. */
+    savedValue?: string | null;
+    enabled?: boolean;
+    /** Fires with the options of every successful quote. */
+    onQuoted?: (delivery: DeliveryOptions$1) => void;
+};
+type UseAutoQuoteResult = {
+    status: AutoQuoteStatus;
+    /** The last good quote (kept while a new one loads, so the list does not flash). `null` before the first. */
+    delivery: DeliveryOptions$1 | null;
+    /** `rate:<id>` to preselect (the saved rate if still offered, else the default), `null` when none. */
+    defaultValue: string | null;
+    /** The address the current `delivery` was quoted for. */
+    quotedFor: QuoteAddress | null;
+    /** Quote again now (retry button). */
+    retry: () => void;
+    /** Plain-language status for a live region ("Buscando…", "Listo", …) keys, not text. */
+    announce: 'searching' | 'ready' | 'free' | 'error' | null;
+};
+declare const DEFAULT_QUOTE_NAMES: {
+    readonly country_code: "country_code";
+    readonly zip: "zip";
+    readonly province: "province";
+    readonly city: "city";
+    readonly neighborhood: "neighborhood";
+    readonly address1: "address1";
+};
+/** Only these change the price of a shipment; any other field of the form (street, phone, reference…) never re-quotes. */
+declare const QUOTE_KEYS: readonly ["country_code", "zip", "province", "city"];
+/** Identity of a quote: equal fingerprints share the same rates. */
+declare function quoteFingerprint(a: Pick<QuoteAddress, (typeof QUOTE_KEYS)[number]>): string;
+/** The default rate: the cheapest one that is not a pickup (ties keep the server order, which already puts the best first). */
+declare function defaultRate(delivery: Pick<DeliveryOptions$1, 'rates'>): ShippingRate | null;
+/** Reads the address from the form; `null` when it is not complete yet. */
+declare function readQuoteAddress(form: HTMLFormElement | null, opts?: Pick<UseAutoQuoteOptions, 'names' | 'required' | 'validPostalCode' | 'defaultCountry'>): QuoteAddress | null;
+declare function useAutoQuote(options: UseAutoQuoteOptions): UseAutoQuoteResult;
+
+export { ADDRESS_FILL_EVENT_FLAG, type AddressFieldKey, AddressFields, type AddressFieldsMessages, type AddressFieldsProps, type AutoQuoteStatus, type Brand, type BrandKind, BrandMark, type BrandMarkProps, type BrandMarkSource, CheckoutFieldClassNames, type ContactFieldKey, ContactFields, type ContactFieldsProps, DEFAULT_QUOTE_NAMES, type DeliveryMessages, DeliveryOptions, type DeliveryOptionsClassNames, type DeliveryOptionsProps, FieldErrors, type FieldLayoutClassNames, FieldMessages, type FlatRatesOptions, OrderSummary, type OrderSummaryClassNames, OrderSummaryDisclosure, type OrderSummaryDisclosureProps, type OrderSummaryMessages, type OrderSummaryProps, type PostalCodeInfo, QUOTE_KEYS, type QuoteAddress, type QuoteNote, type RateBadge, type RateGroup, type RateTag, type RecommendRatesOptions, type RecommendedRate, type RecommendedRates, type UseAutoQuoteOptions, type UseAutoQuoteResult, addressFieldsMessages, brandKey, brandLogo, brandName, dedupeRates, defaultRate, deliveryMessages, findBrand, flatRates, isAddressFillEvent, isQuoteChange, listBrands, matchRate, orderSummaryMessages, quoteDeadline, quoteFingerprint, quoteNote, rateBadges, rateCarrier, rateEta, rateService, readQuoteAddress, recommendRates, useAutoQuote };

package/dist/checkout.js

@@ -6,7 +6,7 @@ import { ProductThumb } from './chunk-VHEY5AU3.js';
 import './chunk-6CVKW7F3.js';
 import { useResolvedLocale } from './chunk-T52H5HL3.js';
 import './chunk-DQBL2DFJ.js';
-import { useId, useState, useRef, useEffect, useMemo, useSyncExternalStore } from 'react';
+import { useId, useState, useRef, useEffect, useMemo, useCallback, useSyncExternalStore } from 'react';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { formatMoney } from '@asteby/storefront';
 
@@ -563,7 +563,10 @@ var ES3 = {
   moreOptions: "Ver m\xE1s opciones ({n})",
   otherCarriers: "Otras opciones",
   error: "No pudimos consultar las opciones de env\xEDo en este momento.",
-  retry: "Intentar de nuevo"
+  retry: "Intentar de nuevo",
+  freeShipping: "Env\xEDo gratis",
+  freeShippingNote: "Tu pedido ya incluye el env\xEDo: no tienes que elegir paqueter\xEDa.",
+  ratesReady: "Opciones de env\xEDo listas ({n})."
 };
 var EN3 = {
   etaOne: "Arrives in 1 business day",
@@ -586,7 +589,10 @@ var EN3 = {
   moreOptions: "Show more options ({n})",
   otherCarriers: "Other options",
   error: "We couldn't get delivery options right now.",
-  retry: "Try again"
+  retry: "Try again",
+  freeShipping: "Free shipping",
+  freeShippingNote: "Shipping is included in your order: there is no carrier to choose.",
+  ratesReady: "Delivery options ready ({n})."
 };
 function deliveryMessages(locale, overrides) {
   const base = (locale ?? "es-MX").toLowerCase().startsWith("en") ? EN3 : ES3;
@@ -679,13 +685,13 @@ function isQuoteChange(err) {
 }
 function matchRate(previous, rates) {
   if (!previous) return null;
-  const norm2 = (s) => (s ?? "").trim().toLowerCase();
-  const sameCarrier = (r) => norm2(r.carrier) === norm2(previous.carrier);
+  const norm3 = (s) => (s ?? "").trim().toLowerCase();
+  const sameCarrier = (r) => norm3(r.carrier) === norm3(previous.carrier);
   if (previous.service_code) {
-    const hit = rates.find((r) => sameCarrier(r) && norm2(r.service_code) === norm2(previous.service_code));
+    const hit = rates.find((r) => sameCarrier(r) && norm3(r.service_code) === norm3(previous.service_code));
     if (hit) return hit;
   }
-  return rates.find((r) => sameCarrier(r) && norm2(r.title) === norm2(previous.title)) ?? null;
+  return rates.find((r) => sameCarrier(r) && norm3(r.title) === norm3(previous.title)) ?? null;
 }
 var SR_ONLY = { position: "absolute", width: 1, height: 1, overflow: "hidden", clip: "rect(0 0 0 0)", whiteSpace: "nowrap" };
 var useHydrated = () => useSyncExternalStore(
@@ -722,7 +728,8 @@ function DeliveryOptions(props) {
     children,
     layout = "list",
     error,
-    onRetry
+    onRetry,
+    free = false
   } = props;
   const locale = useResolvedLocale(props.locale);
   const m = useMemo(() => deliveryMessages(locale, props.messages), [locale, props.messages]);
@@ -790,17 +797,24 @@ function DeliveryOptions(props) {
     ] }, rate.id);
   };
   const errorText = error ? typeof error === "string" ? error : m.error : null;
+  const freeRate = free && !loading && pickup.length === 0 ? rates.find((r) => !r.pickup) ?? null : null;
   return /* @__PURE__ */ jsxs("div", { className: cx.root, "data-sf-delivery": true, "data-layout": layout, "aria-busy": loading || void 0, children: [
     partial && !errorText ? /* @__PURE__ */ jsx("p", { role: "status", className: cx.partial, "data-sf-delivery-partial": true, children: m.partial }) : null,
     requoted ? /* @__PURE__ */ jsx("p", { role: "status", className: cx.partial, "data-sf-delivery-requoted": true, children: m.requoted }) : null,
     loading ? /* @__PURE__ */ jsx("span", { style: SR_ONLY, role: "status", "data-sf-delivery-loading": true, children: m.loading }) : null,
+    props.announceReady && !loading && rates.length > 0 ? /* @__PURE__ */ jsx("span", { style: SR_ONLY, role: "status", "data-sf-delivery-ready": true, children: freeRate ? m.freeShipping : m.ratesReady.replace("{n}", String(rates.length)) }) : null,
     errorText && rates.length === 0 && !loading ? /* @__PURE__ */ jsxs("div", { role: "alert", className: cx.error, "data-sf-delivery-error": true, children: [
       /* @__PURE__ */ jsx("p", { children: errorText }),
       onRetry ? /* @__PURE__ */ jsx("button", { type: "button", className: cx.retry, onClick: onRetry, "data-sf-delivery-retry": true, children: m.retry }) : null
     ] }) : null,
+    freeRate ? /* @__PURE__ */ jsxs("div", { className: cx.freeBanner, role: props.announceReady ? void 0 : "status", "data-sf-delivery-free-banner": true, children: [
+      /* @__PURE__ */ jsx("input", { type: "hidden", name, value: rateValue(freeRate), ...testId ? { "data-testid": testId } : {} }),
+      /* @__PURE__ */ jsx("p", { className: cx.free, "data-sf-delivery-free-title": true, children: /* @__PURE__ */ jsx("strong", { children: m.freeShipping }) }),
+      /* @__PURE__ */ jsx("p", { className: cx.note, children: m.freeShippingNote })
+    ] }) : null,
     children,
     loading && rates.length === 0 ? [0, 1, 2].map((i) => /* @__PURE__ */ jsx("div", { className: cx.skeleton, "data-sf-delivery-skeleton": true, "aria-hidden": "true" }, i)) : null,
-    flat ? flat.map(({ rate, tags }) => rateRow(rate, { tags: showBadges ? tags : [] })) : plan ? plan.recommended.map(({ rate, tags }) => rateRow(rate, { tags: showBadges ? tags : [] })) : rates.map((rate) => rateRow(rate, { tags: badges.get(rate.id) ?? [] })),
+    freeRate ? null : flat ? flat.map(({ rate, tags }) => rateRow(rate, { tags: showBadges ? tags : [] })) : plan ? plan.recommended.map(({ rate, tags }) => rateRow(rate, { tags: showBadges ? tags : [] })) : rates.map((rate) => rateRow(rate, { tags: badges.get(rate.id) ?? [] })),
     plan && plan.moreCount > 0 ? /* @__PURE__ */ jsxs("details", { className: cx.more, "data-sf-delivery-more": true, ...inMore ? { open: true } : {}, children: [
       /* @__PURE__ */ jsx("summary", { className: cx.moreSummary, "data-sf-delivery-more-summary": true, children: m.moreOptions.replace("{n}", String(plan.moreCount)) }),
       /* @__PURE__ */ jsx("div", { "data-sf-delivery-groups": true, children: plan.more.map((g) => {
@@ -827,7 +841,141 @@ function DeliveryOptions(props) {
     deadline ? /* @__PURE__ */ jsx("p", { className: cx.note, "data-sf-delivery-note": true, "data-soon": shownNote?.soon || void 0, "aria-live": "polite", children: shownNote?.text ?? "" }) : null
   ] });
 }
+var DEFAULT_QUOTE_NAMES = {
+  country_code: "country_code",
+  zip: "zip",
+  province: "province",
+  city: "city",
+  neighborhood: "neighborhood",
+  address1: "address1"
+};
+var DEFAULT_REQUIRED = ["zip", "province", "city", "neighborhood", "address1"];
+var QUOTE_KEYS = ["country_code", "zip", "province", "city"];
+var norm2 = (v) => v.normalize("NFD").replace(/[̀-ͯ]/g, "").trim().toLowerCase();
+function quoteFingerprint(a) {
+  return QUOTE_KEYS.map((k) => norm2(a[k] ?? "")).join("|");
+}
+function defaultRate(delivery) {
+  let best = null;
+  for (const r of delivery.rates) {
+    if (r.pickup) continue;
+    if (!best || Number(r.cost.amount) < Number(best.cost.amount)) best = r;
+  }
+  return best;
+}
+function readQuoteAddress(form, opts = {}) {
+  if (!form) return null;
+  const names = { ...DEFAULT_QUOTE_NAMES, ...opts.names };
+  const data = new FormData(form);
+  const get = (name) => String(data.get(name) ?? "").trim();
+  const address = {
+    country_code: get(names.country_code) || opts.defaultCountry || "MX",
+    zip: get(names.zip),
+    province: get(names.province),
+    city: get(names.city),
+    neighborhood: get(names.neighborhood),
+    address1: get(names.address1)
+  };
+  const valid = opts.validPostalCode ?? ((z) => /^\d{5}$/.test(z));
+  if (!valid(address.zip)) return null;
+  for (const k of opts.required ?? DEFAULT_REQUIRED) if (!address[k]) return null;
+  return address;
+}
+function useAutoQuote(options) {
+  const { formRef, debounceMs = 600, enabled = true } = options;
+  const [status, setStatus] = useState("idle");
+  const [delivery, setDelivery] = useState(null);
+  const [quotedFor, setQuotedFor] = useState(null);
+  const opts = useRef(options);
+  opts.current = options;
+  const timer = useRef(null);
+  const inflight = useRef(null);
+  const quotedFp = useRef(null);
+  const pendingFp = useRef(null);
+  const run = useCallback((address, fp) => {
+    inflight.current?.abort();
+    const ctl = new AbortController();
+    inflight.current = ctl;
+    pendingFp.current = fp;
+    setStatus("loading");
+    opts.current.quote(address, ctl.signal).then((d) => {
+      if (ctl.signal.aborted) return;
+      quotedFp.current = fp;
+      pendingFp.current = null;
+      setDelivery(d);
+      setQuotedFor(address);
+      setStatus("ready");
+      opts.current.onQuoted?.(d);
+    }).catch(() => {
+      if (ctl.signal.aborted) return;
+      pendingFp.current = null;
+      quotedFp.current = null;
+      setStatus("error");
+    });
+  }, []);
+  const evaluate = useCallback(
+    (force) => {
+      const address = readQuoteAddress(formRef.current, opts.current);
+      if (!address) {
+        if (timer.current) clearTimeout(timer.current);
+        timer.current = null;
+        inflight.current?.abort();
+        pendingFp.current = null;
+        setStatus("idle");
+        return;
+      }
+      const fp = quoteFingerprint(address);
+      if (!force && (fp === quotedFp.current || fp === pendingFp.current)) {
+        if (timer.current) clearTimeout(timer.current);
+        timer.current = null;
+        if (fp === quotedFp.current) setStatus("ready");
+        return;
+      }
+      if (timer.current) clearTimeout(timer.current);
+      if (force) {
+        timer.current = null;
+        run(address, fp);
+        return;
+      }
+      setStatus("waiting");
+      timer.current = setTimeout(() => {
+        timer.current = null;
+        const latest = readQuoteAddress(formRef.current, opts.current);
+        if (latest) run(latest, quoteFingerprint(latest));
+      }, debounceMs);
+    },
+    [debounceMs, formRef, run]
+  );
+  useEffect(() => {
+    const form = formRef.current;
+    if (!enabled || !form) return;
+    const onChange = () => evaluate(false);
+    form.addEventListener("input", onChange);
+    form.addEventListener("change", onChange);
+    const first = setTimeout(onChange, 0);
+    return () => {
+      clearTimeout(first);
+      form.removeEventListener("input", onChange);
+      form.removeEventListener("change", onChange);
+      if (timer.current) clearTimeout(timer.current);
+      inflight.current?.abort();
+    };
+  }, [enabled, evaluate, formRef]);
+  const retry = useCallback(() => evaluate(true), [evaluate]);
+  const defaultValue = useMemo(() => {
+    if (!delivery) return null;
+    const saved = opts.current.savedValue;
+    if (saved?.startsWith("rate:")) {
+      const hit = delivery.rates.find((r) => `rate:${r.id}` === saved);
+      if (hit) return `rate:${hit.id}`;
+    }
+    const pick = (opts.current.pickDefault ?? defaultRate)(delivery);
+    return pick ? `rate:${pick.id}` : null;
+  }, [delivery, options.savedValue]);
+  const announce = status === "loading" || status === "waiting" ? "searching" : status === "error" ? "error" : status === "ready" ? delivery?.free ? "free" : "ready" : null;
+  return { status, delivery, defaultValue, quotedFor, retry, announce };
+}
 
-export { ADDRESS_FILL_EVENT_FLAG, AddressFields, ContactFields, DeliveryOptions, OrderSummary, OrderSummaryDisclosure, addressFieldsMessages, dedupeRates, deliveryMessages, flatRates, isAddressFillEvent, isQuoteChange, matchRate, orderSummaryMessages, quoteDeadline, quoteNote, rateBadges, rateCarrier, rateEta, rateService, recommendRates };
+export { ADDRESS_FILL_EVENT_FLAG, AddressFields, ContactFields, DEFAULT_QUOTE_NAMES, DeliveryOptions, OrderSummary, OrderSummaryDisclosure, QUOTE_KEYS, addressFieldsMessages, dedupeRates, defaultRate, deliveryMessages, flatRates, isAddressFillEvent, isQuoteChange, matchRate, orderSummaryMessages, quoteDeadline, quoteFingerprint, quoteNote, rateBadges, rateCarrier, rateEta, rateService, readQuoteAddress, recommendRates, useAutoQuote };
 //# sourceMappingURL=checkout.js.map
 //# sourceMappingURL=checkout.js.map