@vtex/faststore 0.0.1

package/dist/matter/shipping-address/shipping-address.js

@@ -0,0 +1,1036 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { Field } from "../../particles/field/field.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { AddressSummary, AddressSummaryRoot } from "../../particles/address-summary/address-summary.js";
+import { Select } from "../../particles/select/select.js";
+import "../../sdk/shipping/shipping-operations.js";
+import { getAvailableCountries, getCountryDescriptor } from "./country-descriptors.js";
+import { cloneElement, createContext, isValidElement, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/shipping-address/shipping-address.tsx
+/**
+* Shipping address step (T2 — Enter and save the delivery address).
+* Single-file matter per ADR-0001; batches form state and writes once via shipping.setAddress.
+* Controls are thin context-bound components that read/write draft state (specs/shipping-address-step.md).
+*/
+const fragment = `
+  fragment ShippingAddressData on Query {
+    shipping {
+      __typename
+      id
+      address {
+        __typename
+        id
+        recipientName
+        postalCode
+        country
+        street
+        number
+        complement
+        neighborhood
+        city
+        state
+      }
+      savedAddresses {
+        __typename
+        id
+        recipientName
+        postalCode
+        country
+        street
+        number
+        complement
+        neighborhood
+        city
+        state
+      }
+    }
+    clientProfile {
+      __typename
+      firstName
+      lastName
+    }
+  }
+`;
+const SHIPPING_ADDRESS_CONTEXT_UNSET = Symbol("ShippingAddressContextUnset");
+const ShippingAddressContext = createContext(SHIPPING_ADDRESS_CONTEXT_UNSET);
+function useShippingAddressContext() {
+	const ctx = useContext(ShippingAddressContext);
+	if (ctx === SHIPPING_ADDRESS_CONTEXT_UNSET) throw new Error("ShippingAddress components must be used inside ShippingAddressRoot.");
+	return ctx;
+}
+const SHIPPING_ADDRESS_DRAWER_CONTEXT_UNSET = Symbol("ShippingAddressDrawerContextUnset");
+const ShippingAddressDrawerContext = createContext(SHIPPING_ADDRESS_DRAWER_CONTEXT_UNSET);
+function useShippingAddressDrawerContext() {
+	const ctx = useContext(ShippingAddressDrawerContext);
+	if (ctx === SHIPPING_ADDRESS_DRAWER_CONTEXT_UNSET) throw new Error("ShippingAddressSavedAddressDrawerController and ShippingAddressSavedAddressSubmit must be used inside ShippingAddressRoot.");
+	return ctx;
+}
+const SHIPPING_ADDRESS_SECTION_CONTEXT_UNSET = Symbol("ShippingAddressSectionContextUnset");
+const ShippingAddressSectionContext = createContext(SHIPPING_ADDRESS_SECTION_CONTEXT_UNSET);
+function useShippingAddressSectionContext() {
+	const ctx = useContext(ShippingAddressSectionContext);
+	if (ctx === SHIPPING_ADDRESS_SECTION_CONTEXT_UNSET) throw new Error("ShippingAddressSummaryView, ShippingAddressEditForm, ShippingAddressEditButton and ShippingAddressCancelButton must be used inside ShippingAddressEditController.");
+	return ctx;
+}
+const ShippingAddressRootDefinition = defineComponent({
+	name: "ShippingAddressRoot",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressRoot,
+	fragment,
+	fetchStrategy: "reactive",
+	providesContext: "shipping-address",
+	actions: { shipping: ["setAddress"] },
+	editor: {
+		label: "Shipping Address Root",
+		category: "content"
+	},
+	schema: { defaultCountry: {
+		type: "string",
+		default: "BRA",
+		label: "Default country (ISO-3)"
+	} },
+	guideline: "Country-adaptive single-address delivery form; batches all fields and writes once via shipping.setAddress. See shipping-address.md."
+});
+const ShippingAddressRecipientNameControlDefinition = defineComponent({
+	name: "ShippingAddressRecipientNameControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressRecipientNameControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Recipient Name Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Recipient-name input field; required for submit. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressStreetControlDefinition = defineComponent({
+	name: "ShippingAddressStreetControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressStreetControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Street Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Street name input field. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressNumberControlDefinition = defineComponent({
+	name: "ShippingAddressNumberControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressNumberControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Number Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Street number input field. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressCityControlDefinition = defineComponent({
+	name: "ShippingAddressCityControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressCityControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "City Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "City name input field. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressStateControlDefinition = defineComponent({
+	name: "ShippingAddressStateControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressStateControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "State Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "State/province input field. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressPostalCodeControlDefinition = defineComponent({
+	name: "ShippingAddressPostalCodeControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressPostalCodeControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Postal Code Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Postal code input field. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressComplementControlDefinition = defineComponent({
+	name: "ShippingAddressComplementControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressComplementControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Complement Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Complement (apartment, suite, etc.) input field. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressNeighborhoodControlDefinition = defineComponent({
+	name: "ShippingAddressNeighborhoodControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressNeighborhoodControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Neighborhood Control",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Neighborhood (bairro) input field; shown only for countries that have this field (BR in v1). Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressCountryControlDefinition = defineComponent({
+	name: "ShippingAddressCountryControl",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressCountryControl,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Country Control",
+		category: "action"
+	},
+	schema: { label: {
+		type: "string",
+		default: "país",
+		label: "Field label"
+	} },
+	guideline: "Country selector; lists only countries with an implemented descriptor. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressSavedListDefinition = defineComponent({
+	name: "ShippingAddressSavedList",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressSavedList,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Saved Address List",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "List of saved addresses for logged-in shoppers; renders only if savedAddresses is non-empty. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressSavedOptionDefinition = defineComponent({
+	name: "ShippingAddressSavedOption",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressSavedOption,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Saved Address Option",
+		category: "commerce"
+	},
+	schema: { id: {
+		type: "string",
+		label: "Saved address ID"
+	} },
+	guideline: "A single saved address option; renders its address via the same AddressSummary particle (through its own AddressSummaryRoot) used by ShippingAddressSelectedSummary, so both share one formatting implementation. Must be a descendant of ShippingAddressSavedList."
+});
+const ShippingAddressSubmitDefinition = defineComponent({
+	name: "ShippingAddressSubmit",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressSubmit,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Shipping Address Submit",
+		category: "action"
+	},
+	schema: {
+		label: {
+			type: "string",
+			default: "salvar endereço",
+			label: "Button label"
+		},
+		pendingLabel: {
+			type: "string",
+			default: "salvando...",
+			label: "Pending label"
+		}
+	},
+	guideline: "Submit button; dispatches the batched address write. Disabled until recipient name is non-blank. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressErrorDefinition = defineComponent({
+	name: "ShippingAddressError",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressError,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Shipping Address Error",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Error banner; shows domain validation errors inline or a generic upstream-error state. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressSavedAddressDrawerControllerDefinition = defineComponent({
+	name: "ShippingAddressSavedAddressDrawerController",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressSavedAddressDrawerController,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Saved Address Drawer Controller",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Wraps a single DrawerRoot child (the saved-address selection drawer) and makes it controlled by the shipping-address drawer state: open state and blocked-dismissal-while-submitting are handled here, so do not set raw open/onOpenChange on the wrapped DrawerRoot. Compose as the parent of DrawerRoot, with the drawer trigger and popup as DrawerRoot descendants, same pattern as CartOpenOnAdd wrapping the mini-cart DrawerRoot. Must be inside ShippingAddressRoot."
+});
+const ShippingAddressSavedAddressSubmitDefinition = defineComponent({
+	name: "ShippingAddressSavedAddressSubmit",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressSavedAddressSubmit,
+	requiresContext: "shipping-address",
+	editor: {
+		label: "Saved Address Submit",
+		category: "action"
+	},
+	schema: {
+		label: {
+			type: "string",
+			default: "selecionar",
+			label: "Button label"
+		},
+		pendingLabel: {
+			type: "string",
+			default: "selecionando...",
+			label: "Pending label"
+		}
+	},
+	guideline: "The drawer's \"selecionar\" submit button; independent submitting state from the main form's Submit (Decision 7); no-ops when the selected saved address is already the current one (Decision 8). Must be inside the saved-address drawer's DrawerPopup and inside ShippingAddressRoot."
+});
+const ShippingAddressSelectedSummaryDefinition = defineComponent({
+	name: "ShippingAddressSelectedSummary",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressSelectedSummary,
+	requiresContext: "shipping-address",
+	providesContext: "address-summary",
+	editor: {
+		label: "Selected Address Summary",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Provides the current delivery address to the generic AddressSummary particle via AddressSummaryRoot context, and renders the default AddressSummary when composed with no children. Compose AddressSummaryRecipient / Street / Locality directly to choose the order or drop a line. Self-gates to null when there is no current address yet. Must be a descendant of ShippingAddressRoot."
+});
+const ShippingAddressEditControllerDefinition = defineComponent({
+	name: "ShippingAddressEditController",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressEditController,
+	requiresContext: "shipping-address",
+	providesContext: "shipping-address-section",
+	editor: {
+		label: "Shipping Address Edit Controller",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Owns the view/edit toggle for the delivery address section: defaults to view when a current address exists, edit otherwise; switches back to view automatically whenever setAddress succeeds (main form submit or saved-address drawer submit), without ShippingAddressSubmit/ShippingAddressSavedAddressSubmit needing to know about this mode. Compose a ShippingAddressSummaryView holding SelectedSummary + EditButton and a ShippingAddressEditForm holding the form Controls/Submit/Error. Self-contained: it decides from its own data and the shopper's own presses, so no other section opens it and finishing it opens nothing. Must be inside ShippingAddressRoot."
+});
+const ShippingAddressSummaryViewDefinition = defineComponent({
+	name: "ShippingAddressSummaryView",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressSummaryView,
+	requiresContext: "shipping-address-section",
+	editor: {
+		label: "Shipping Address Summary View",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders its children only while the delivery section shows the saved-address summary, and nothing while it shows the form. Compose SelectedSummary and a ShippingAddressEditButton inside. Takes no props: which state it gates is which component it is. Must be inside a ShippingAddressEditController."
+});
+const ShippingAddressEditFormDefinition = defineComponent({
+	name: "ShippingAddressEditForm",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressEditForm,
+	requiresContext: "shipping-address-section",
+	editor: {
+		label: "Shipping Address Edit Form",
+		category: "commerce"
+	},
+	schema: {},
+	guideline: "Renders its children only while the delivery section shows the address form, and nothing while it shows the summary. Compose the Controls, Submit and Error parts inside. Must be inside a ShippingAddressEditController."
+});
+const ShippingAddressEditButtonDefinition = defineComponent({
+	name: "ShippingAddressEditButton",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressEditButton,
+	requiresContext: "shipping-address-section",
+	editor: {
+		label: "Shipping Address Edit Button",
+		category: "action"
+	},
+	schema: { label: {
+		type: "string",
+		default: "editar",
+		label: "Button label"
+	} },
+	guideline: "CTA that switches the view/edit mode to edit. Typically placed inside a ShippingAddressSummaryView, next to SelectedSummary. Must be inside ShippingAddressEditController."
+});
+const ShippingAddressCancelButtonDefinition = defineComponent({
+	name: "ShippingAddressCancelButton",
+	importPath: "@vtex/faststore/components",
+	component: ShippingAddressCancelButton,
+	requiresContext: "shipping-address-section",
+	editor: {
+		label: "Shipping Address Cancel Button",
+		category: "action"
+	},
+	schema: { label: {
+		type: "string",
+		default: "cancelar",
+		label: "Button label"
+	} },
+	guideline: "Returns the delivery section to its summary without saving. Place it inside a ShippingAddressEditForm so a shopper who opened the form has a way back that does not depend on a successful write. Must be inside ShippingAddressEditController."
+});
+/**
+* ShippingAddressRoot owns the batched form state, manages the current descriptor,
+* and provides context to child Controls. It handles submit dispatch and error tracking.
+*/
+function ShippingAddressRoot({ defaultCountry = "BRA", className, children, $data: $dataProp, $actions }) {
+	const $data = useDataOverride($dataProp);
+	const currentAddress = $data?.shipping?.address;
+	const savedAddresses = $data?.shipping?.savedAddresses ?? [];
+	const clientProfile = $data?.clientProfile;
+	const joinedProfileName = [clientProfile?.firstName, clientProfile?.lastName].filter(Boolean).join(" ");
+	const seedDraft = useCallback(() => ({
+		recipientName: currentAddress?.recipientName ?? joinedProfileName,
+		postalCode: currentAddress?.postalCode ?? "",
+		country: currentAddress?.country ?? defaultCountry,
+		street: currentAddress?.street ?? "",
+		number: currentAddress?.number ?? "",
+		complement: currentAddress?.complement ?? "",
+		neighborhood: currentAddress?.neighborhood ?? "",
+		city: currentAddress?.city ?? "",
+		state: currentAddress?.state ?? ""
+	}), [
+		currentAddress,
+		joinedProfileName,
+		defaultCountry
+	]);
+	const [draft, setDraft] = useState(seedDraft);
+	const [submitting, setSubmitting] = useState(false);
+	const [errors, setErrors] = useState([]);
+	const [upstreamError, setUpstreamError] = useState(false);
+	const [selectedSavedId, setSelectedSavedId] = useState();
+	const [savedAddressDrawerOpen, setSavedAddressDrawerOpen] = useState(false);
+	const [drawerSubmitting, setDrawerSubmitting] = useState(false);
+	const [submitSuccessSignal, setSubmitSuccessSignal] = useState(0);
+	const [touchedFields, setTouchedFields] = useState(() => /* @__PURE__ */ new Set());
+	const discardDraft = useCallback(() => {
+		setTouchedFields(/* @__PURE__ */ new Set());
+		setDraft(seedDraft());
+		setErrors([]);
+		setUpstreamError(false);
+	}, [seedDraft]);
+	const currentAddressSnapshot = JSON.stringify(currentAddress ?? null);
+	const clientProfileSnapshot = JSON.stringify(clientProfile ?? null);
+	useEffect(() => {
+		setDraft((prev) => {
+			return {
+				recipientName: touchedFields.has("recipientName") ? prev.recipientName : currentAddress?.recipientName ?? (joinedProfileName || prev.recipientName),
+				postalCode: touchedFields.has("postalCode") ? prev.postalCode : currentAddress?.postalCode ?? prev.postalCode,
+				country: touchedFields.has("country") ? prev.country : currentAddress?.country ?? prev.country,
+				street: touchedFields.has("street") ? prev.street : currentAddress?.street ?? prev.street,
+				number: touchedFields.has("number") ? prev.number : currentAddress?.number ?? prev.number,
+				complement: touchedFields.has("complement") ? prev.complement : currentAddress?.complement ?? prev.complement,
+				neighborhood: touchedFields.has("neighborhood") ? prev.neighborhood : currentAddress?.neighborhood ?? prev.neighborhood,
+				city: touchedFields.has("city") ? prev.city : currentAddress?.city ?? prev.city,
+				state: touchedFields.has("state") ? prev.state : currentAddress?.state ?? prev.state
+			};
+		});
+	}, [
+		currentAddressSnapshot,
+		clientProfileSnapshot,
+		touchedFields
+	]);
+	const currentAddressId = currentAddress?.id ?? void 0;
+	const formattedCurrentAddress = useMemo(() => {
+		if (!currentAddress) return void 0;
+		return {
+			recipientName: currentAddress.recipientName ?? "",
+			postalCode: currentAddress.postalCode ?? "",
+			country: currentAddress.country ?? "",
+			street: currentAddress.street ?? "",
+			number: currentAddress.number ?? "",
+			complement: currentAddress.complement ?? "",
+			neighborhood: currentAddress.neighborhood ?? "",
+			city: currentAddress.city ?? "",
+			state: currentAddress.state ?? ""
+		};
+	}, [currentAddress]);
+	const descriptor = getCountryDescriptor(draft.country);
+	const mappedSavedAddresses = useMemo(() => savedAddresses.map((saved) => ({
+		id: saved.id ?? "",
+		address: {
+			recipientName: saved.recipientName ?? "",
+			postalCode: saved.postalCode ?? "",
+			country: saved.country ?? "",
+			street: saved.street ?? "",
+			number: saved.number ?? "",
+			complement: saved.complement ?? "",
+			neighborhood: saved.neighborhood ?? "",
+			city: saved.city ?? "",
+			state: saved.state ?? ""
+		}
+	})), [savedAddresses]);
+	const setDraftField = useCallback((field, value) => {
+		setTouchedFields((prev) => prev.has(field) ? prev : new Set(prev).add(field));
+		setDraft((prev) => ({
+			...prev,
+			[field]: value
+		}));
+	}, []);
+	const selectSavedAddress = useCallback((id) => {
+		setSelectedSavedId(id);
+		if (id) {
+			const saved = mappedSavedAddresses.find((s) => s.id === id);
+			if (saved?.address) {
+				setTouchedFields((prev) => /* @__PURE__ */ new Set([...prev, ...Object.keys(saved.address)]));
+				setDraft((prev) => ({
+					...prev,
+					...saved.address,
+					recipientName: saved.address.recipientName || joinedProfileName
+				}));
+			}
+		}
+	}, [mappedSavedAddresses, joinedProfileName]);
+	const isFormValid = draft.recipientName.trim().length > 0;
+	const handleSubmit = useCallback(async () => {
+		if (!isFormValid || submitting) return;
+		if (!$actions?.shipping?.setAddress) return;
+		setSubmitting(true);
+		setErrors([]);
+		setUpstreamError(false);
+		try {
+			const isFieldActive = (field) => descriptor?.fields.some((f) => f.name === field) ?? false;
+			const addressFields = {
+				recipientName: draft.recipientName.trim(),
+				postalCode: draft.postalCode,
+				country: draft.country,
+				...isFieldActive("street") ? { street: draft.street } : {},
+				...isFieldActive("number") ? { number: draft.number } : {},
+				...isFieldActive("complement") ? { complement: draft.complement } : {},
+				...isFieldActive("neighborhood") ? { neighborhood: draft.neighborhood } : {},
+				...isFieldActive("city") ? { city: draft.city } : {},
+				...isFieldActive("state") ? { state: draft.state } : {}
+			};
+			const input = selectedSavedId ? {
+				savedAddressId: selectedSavedId,
+				...addressFields
+			} : addressFields;
+			const userErrors = await $actions.shipping.setAddress(input);
+			if (userErrors.length === 0) {
+				setErrors([]);
+				setSubmitSuccessSignal((n) => n + 1);
+			} else if (userErrors.some((e) => e.code === "NETWORK_ERROR")) {
+				setErrors([]);
+				setUpstreamError(true);
+			} else setErrors(userErrors);
+		} catch (error) {
+			console.error("[ShippingAddress] setAddress failed:", error);
+			setUpstreamError(true);
+			setErrors([]);
+		} finally {
+			setSubmitting(false);
+		}
+	}, [
+		isFormValid,
+		submitting,
+		$actions?.shipping?.setAddress,
+		draft,
+		selectedSavedId,
+		descriptor
+	]);
+	const handleDrawerSubmit = useCallback(async () => {
+		if (!selectedSavedId) return;
+		if (currentAddressId !== void 0 && selectedSavedId === currentAddressId) {
+			setSavedAddressDrawerOpen(false);
+			return;
+		}
+		const selectedAddress = mappedSavedAddresses.find((s) => s.id === selectedSavedId);
+		if (!selectedAddress) return;
+		if (!selectedAddress.address.recipientName?.trim()) {
+			setSavedAddressDrawerOpen(false);
+			return;
+		}
+		if (!$actions?.shipping?.setAddress) return;
+		setDrawerSubmitting(true);
+		setErrors([]);
+		setUpstreamError(false);
+		try {
+			const input = {
+				savedAddressId: selectedSavedId,
+				recipientName: selectedAddress.address.recipientName || "",
+				postalCode: selectedAddress.address.postalCode || "",
+				country: selectedAddress.address.country || "",
+				street: selectedAddress.address.street || "",
+				number: selectedAddress.address.number || "",
+				complement: selectedAddress.address.complement || "",
+				neighborhood: selectedAddress.address.neighborhood || "",
+				city: selectedAddress.address.city || "",
+				state: selectedAddress.address.state || ""
+			};
+			const userErrors = await $actions.shipping.setAddress(input);
+			if (userErrors.length === 0) {
+				setErrors([]);
+				setSavedAddressDrawerOpen(false);
+				setSubmitSuccessSignal((n) => n + 1);
+			} else if (userErrors.some((e) => e.code === "NETWORK_ERROR")) {
+				setErrors([]);
+				setUpstreamError(true);
+			} else setErrors(userErrors);
+		} catch (error) {
+			console.error("[ShippingAddress] drawer submit failed:", error);
+			setUpstreamError(true);
+			setErrors([]);
+		} finally {
+			setDrawerSubmitting(false);
+		}
+	}, [
+		selectedSavedId,
+		currentAddressId,
+		mappedSavedAddresses,
+		$actions?.shipping?.setAddress
+	]);
+	const contextValue = {
+		draft,
+		setDraftField,
+		descriptor,
+		savedAddresses: mappedSavedAddresses,
+		selectedSavedId,
+		setSelectedSavedId: selectSavedAddress,
+		submitting,
+		errors,
+		upstreamError,
+		handleSubmit,
+		currentAddressId,
+		currentAddress: formattedCurrentAddress,
+		submitSuccessSignal,
+		isFormValid,
+		discardDraft
+	};
+	const drawerContextValue = {
+		savedAddressDrawerOpen,
+		setSavedAddressDrawerOpen,
+		drawerSubmitting,
+		handleDrawerSubmit
+	};
+	return /* @__PURE__ */ jsx(ShippingAddressContext.Provider, {
+		value: contextValue,
+		children: /* @__PURE__ */ jsx(ShippingAddressDrawerContext.Provider, {
+			value: drawerContextValue,
+			children: /* @__PURE__ */ jsx("div", {
+				className,
+				"data-fs-shipping-address": "",
+				children
+			})
+		})
+	});
+}
+/**
+* RecipientNameControl — the only client-validated field (US-4, US-6).
+* Pre-filled from clientProfile, editable, required.
+*/
+function ShippingAddressRecipientNameControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	if (!descriptor?.fields.some((f) => f.name === "recipientName")) return null;
+	const label = (descriptor?.fields.find((f) => f.name === "recipientName"))?.label ?? "nome do destinatário";
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "recipient-name",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.recipientName,
+			onChange: (e) => setDraftField("recipientName", e.currentTarget.value)
+		})]
+	});
+}
+/** StreetControl */
+function ShippingAddressStreetControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	const fieldDescriptor = descriptor?.fields.find((f) => f.name === "street");
+	if (!fieldDescriptor) return null;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "street",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: fieldDescriptor.label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.street,
+			onChange: (e) => setDraftField("street", e.currentTarget.value)
+		})]
+	});
+}
+/** NumberControl */
+function ShippingAddressNumberControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	const fieldDescriptor = descriptor?.fields.find((f) => f.name === "number");
+	if (!fieldDescriptor) return null;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "number",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: fieldDescriptor.label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.number,
+			onChange: (e) => setDraftField("number", e.currentTarget.value)
+		})]
+	});
+}
+/** CityControl */
+function ShippingAddressCityControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	const fieldDescriptor = descriptor?.fields.find((f) => f.name === "city");
+	if (!fieldDescriptor) return null;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "city",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: fieldDescriptor.label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.city,
+			onChange: (e) => setDraftField("city", e.currentTarget.value)
+		})]
+	});
+}
+/** StateControl */
+function ShippingAddressStateControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	const fieldDescriptor = descriptor?.fields.find((f) => f.name === "state");
+	if (!fieldDescriptor) return null;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "state",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: fieldDescriptor.label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.state,
+			onChange: (e) => setDraftField("state", e.currentTarget.value)
+		})]
+	});
+}
+/** PostalCodeControl */
+function ShippingAddressPostalCodeControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	const fieldDescriptor = descriptor?.fields.find((f) => f.name === "postalCode");
+	if (!fieldDescriptor) return null;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "postal-code",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: fieldDescriptor.label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.postalCode,
+			onChange: (e) => setDraftField("postalCode", e.currentTarget.value)
+		})]
+	});
+}
+/** ComplementControl */
+function ShippingAddressComplementControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	const fieldDescriptor = descriptor?.fields.find((f) => f.name === "complement");
+	if (!fieldDescriptor) return null;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "complement",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: fieldDescriptor.label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.complement,
+			onChange: (e) => setDraftField("complement", e.currentTarget.value)
+		})]
+	});
+}
+/** NeighborhoodControl (BR-specific in v1) */
+function ShippingAddressNeighborhoodControl({ className }) {
+	const { draft, setDraftField, descriptor, submitting } = useShippingAddressContext();
+	const fieldDescriptor = descriptor?.fields.find((f) => f.name === "neighborhood");
+	if (!fieldDescriptor) return null;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "neighborhood",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: fieldDescriptor.label }), /* @__PURE__ */ jsx(Field.Control, {
+			value: draft.neighborhood,
+			onChange: (e) => setDraftField("neighborhood", e.currentTarget.value)
+		})]
+	});
+}
+/** CountryControl — lists only countries with a descriptor (US-2, first criterion) */
+function ShippingAddressCountryControl({ className, label = "país" }) {
+	const { draft, setDraftField, setSelectedSavedId, submitting } = useShippingAddressContext();
+	const countryOptions = getAvailableCountries().map((iso) => {
+		return {
+			value: iso,
+			label: getCountryDescriptor(iso)?.label ?? iso
+		};
+	});
+	const handleCountryChange = (value) => {
+		if (!value) return;
+		if (getCountryDescriptor(value)) {
+			setDraftField("country", value);
+			setSelectedSavedId(void 0);
+		}
+	};
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className,
+		"data-fs-shipping-address-field": "country",
+		disabled: submitting,
+		children: [/* @__PURE__ */ jsx(Field.Label, { children: label }), /* @__PURE__ */ jsxs(Select.Root, {
+			value: draft.country,
+			onValueChange: handleCountryChange,
+			disabled: submitting,
+			children: [/* @__PURE__ */ jsxs(Select.Trigger, { children: [/* @__PURE__ */ jsx(Select.Value, { children: (value) => value ? getCountryDescriptor(value)?.label ?? value : value }), /* @__PURE__ */ jsx(Select.Icon, { children: "▾" })] }), /* @__PURE__ */ jsx(Select.Portal, { children: /* @__PURE__ */ jsx(Select.Positioner, { children: /* @__PURE__ */ jsx(Select.Popup, { children: /* @__PURE__ */ jsx(Select.List, { children: countryOptions.map((option) => /* @__PURE__ */ jsx(Select.Item, {
+				value: option.value,
+				label: option.label,
+				children: option.label
+			}, option.value)) }) }) }) })]
+		})]
+	});
+}
+/**
+* ShippingAddressSavedList — renders only when savedAddresses is non-empty (logged-in signal).
+*/
+function ShippingAddressSavedList({ className }) {
+	const { savedAddresses } = useShippingAddressContext();
+	if (savedAddresses.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className,
+		"data-fs-shipping-address-saved-list": "",
+		children: savedAddresses.map((saved) => /* @__PURE__ */ jsx(ShippingAddressSavedOption, { id: saved.id }, saved.id))
+	});
+}
+/**
+* ShippingAddressSavedOption — selectable saved address; populates draft on selection.
+* Includes isCurrent visual variant to mark the address matching the current cart address (Decision 8).
+*/
+function ShippingAddressSavedOption({ id, className }) {
+	const { savedAddresses, selectedSavedId, setSelectedSavedId, currentAddressId } = useShippingAddressContext();
+	const saved = savedAddresses.find((s) => s.id === id);
+	if (!saved) return null;
+	const isSelected = selectedSavedId === id;
+	const isCurrent = currentAddressId !== void 0 && currentAddressId === id;
+	const hasAddressContent = Boolean(saved.address.recipientName || saved.address.street || saved.address.city || saved.address.neighborhood);
+	const inputId = `saved-address-${id}`;
+	return /* @__PURE__ */ jsxs("div", {
+		className,
+		"data-fs-shipping-address-saved-option": "",
+		...isSelected ? { "data-fs-shipping-address-saved-option-selected": "" } : {},
+		...isCurrent ? { "data-fs-shipping-address-saved-option-current": "" } : {},
+		children: [/* @__PURE__ */ jsx("input", {
+			id: inputId,
+			type: "radio",
+			name: "saved-address",
+			value: id,
+			checked: isSelected,
+			onChange: () => setSelectedSavedId(id)
+		}), /* @__PURE__ */ jsx("label", {
+			htmlFor: inputId,
+			children: hasAddressContent ? /* @__PURE__ */ jsx(AddressSummaryRoot, {
+				address: saved.address,
+				children: /* @__PURE__ */ jsx(AddressSummary, {})
+			}) : `Endereço ${id}`
+		})]
+	});
+}
+/**
+* ShippingAddressSubmit — dispatches the batched submit; reflects pending state.
+*/
+function ShippingAddressSubmit({ className, label = "salvar endereço", pendingLabel = "salvando..." }) {
+	const { submitting, handleSubmit, isFormValid } = useShippingAddressContext();
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: handleSubmit,
+		disabled: submitting || !isFormValid,
+		className,
+		"data-fs-shipping-address-submit": "",
+		...submitting ? { "data-fs-shipping-address-submit-pending": "" } : {},
+		children: submitting ? pendingLabel : label
+	});
+}
+/**
+* ShippingAddressSavedAddressDrawerController — makes the wrapped DrawerRoot controlled by the
+* shipping-address context's savedAddressDrawerOpen state, and blocks dismissal (Escape, backdrop
+* click, close button) while drawerSubmitting is true by simply not forwarding the close request
+* to the setter. Mirrors CartOpenOnAdd's cloneElement mechanism. Expects a single DrawerRoot child.
+*/
+function ShippingAddressSavedAddressDrawerController({ children }) {
+	const { savedAddressDrawerOpen, setSavedAddressDrawerOpen, drawerSubmitting } = useShippingAddressDrawerContext();
+	if (!isValidElement(children)) return children;
+	return cloneElement(children, {
+		open: savedAddressDrawerOpen,
+		onOpenChange: (next) => {
+			if (!next && drawerSubmitting) return;
+			setSavedAddressDrawerOpen(next);
+		}
+	});
+}
+/**
+* ShippingAddressSavedAddressSubmit — the drawer's "selecionar" submit button; independent
+* submitting state from the main form's Submit (Decision 7); no-ops when the selected saved
+* address is already the current one (Decision 8).
+*/
+function ShippingAddressSavedAddressSubmit({ className, label = "selecionar", pendingLabel = "selecionando..." }) {
+	const { selectedSavedId } = useShippingAddressContext();
+	const { drawerSubmitting, handleDrawerSubmit } = useShippingAddressDrawerContext();
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: handleDrawerSubmit,
+		disabled: drawerSubmitting || !selectedSavedId,
+		className,
+		"data-fs-shipping-address-saved-address-submit": "",
+		...drawerSubmitting ? { "data-fs-shipping-address-saved-address-submit-pending": "" } : {},
+		children: drawerSubmitting ? pendingLabel : label
+	});
+}
+/**
+* ShippingAddressSelectedSummary — provides the current delivery address via AddressSummaryRoot's
+* context and renders it through AddressSummary. Composed lines go through that same wrapper rather
+* than replacing it, because AddressSummaryRoot renders no DOM and `className` would have nowhere to
+* land. Self-gating on currentAddress: renders null when there is none yet, rather than an empty
+* provider with nothing meaningful to show.
+*/
+function ShippingAddressSelectedSummary({ className, children }) {
+	const { currentAddress } = useShippingAddressContext();
+	if (!currentAddress) return null;
+	return /* @__PURE__ */ jsx(AddressSummaryRoot, {
+		address: currentAddress,
+		children: /* @__PURE__ */ jsx(AddressSummary, {
+			className,
+			children
+		})
+	});
+}
+/**
+* ShippingAddressEditController — owns the view/edit mode. Defaults to 'view' when a current
+* address exists, 'edit' otherwise (derived reactively from currentAddressId, so it self-corrects
+* if the address arrives asynchronously after mount, same issue as the draft-sync effect above).
+* Once the shopper explicitly toggles (via ShippingAddressEditButton) or a submit succeeds, the
+* explicit mode takes over. Does not render any DOM itself; provides ShippingAddressSectionContext
+* to ShippingAddressSummaryView/ShippingAddressEditForm/ShippingAddressEditButton descendants.
+*/
+function ShippingAddressEditController({ children }) {
+	const { currentAddressId, submitSuccessSignal } = useShippingAddressContext();
+	const [explicitMode, setExplicitMode] = useState(void 0);
+	const lastHandledSignal = useRef(submitSuccessSignal);
+	useEffect(() => {
+		if (submitSuccessSignal !== lastHandledSignal.current) {
+			lastHandledSignal.current = submitSuccessSignal;
+			setExplicitMode("view");
+		}
+	}, [submitSuccessSignal]);
+	const mode = explicitMode ?? (currentAddressId !== void 0 ? "view" : "edit");
+	const modeContextValue = useMemo(() => ({
+		mode,
+		setMode: setExplicitMode
+	}), [mode]);
+	return /* @__PURE__ */ jsx(ShippingAddressSectionContext.Provider, {
+		value: modeContextValue,
+		children
+	});
+}
+/** Renders its children only while the section shows the saved-address summary. */
+function ShippingAddressSummaryView({ children }) {
+	const { mode } = useShippingAddressSectionContext();
+	if (mode !== "view") return null;
+	return /* @__PURE__ */ jsx(Fragment, { children });
+}
+/** Renders its children only while the section shows the address form. */
+function ShippingAddressEditForm({ children }) {
+	const { mode } = useShippingAddressSectionContext();
+	if (mode !== "edit") return null;
+	return /* @__PURE__ */ jsx(Fragment, { children });
+}
+/**
+* ShippingAddressEditButton — CTA that switches the mode to 'edit'. Has no knowledge of why the
+* mode might currently be 'view' (a current address, or a just-completed submit) — it only writes
+* the mode forward.
+*/
+function ShippingAddressEditButton({ className, label = "editar", children }) {
+	const { setMode } = useShippingAddressSectionContext();
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: () => setMode("edit"),
+		className,
+		"data-fs-shipping-address-edit-button": "",
+		children: children ?? label
+	});
+}
+/**
+* ShippingAddressCancelButton — returns the section to its summary without writing. Without it a
+* shopper who opens the form can only leave through a successful `setAddress`, and blanking the
+* recipient disables Submit, which leaves the section stuck open over the summary it replaced.
+*/
+function ShippingAddressCancelButton({ className, label = "cancelar", children }) {
+	const { setMode } = useShippingAddressSectionContext();
+	const { discardDraft } = useShippingAddressContext();
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: () => {
+			discardDraft();
+			setMode("view");
+		},
+		className,
+		"data-fs-shipping-address-cancel-button": "",
+		children: children ?? label
+	});
+}
+/**
+* ShippingAddressError — renders domain userErrors inline, or generic upstream error state.
+*/
+function ShippingAddressError({ className }) {
+	const { errors, upstreamError } = useShippingAddressContext();
+	if (errors.length === 0 && !upstreamError) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className,
+		"data-fs-shipping-address-error": "",
+		children: upstreamError ? /* @__PURE__ */ jsx("div", { children: "Não foi possível salvar este endereço. Revise os dados e tente novamente." }) : /* @__PURE__ */ jsx("ul", { children: errors.map((error, idx) => /* @__PURE__ */ jsx("li", { children: error.message }, idx)) })
+	});
+}
+const ShippingAddress = {
+	Root: ShippingAddressRoot,
+	RootDefinition: ShippingAddressRootDefinition,
+	RecipientNameControl: ShippingAddressRecipientNameControl,
+	RecipientNameControlDefinition: ShippingAddressRecipientNameControlDefinition,
+	StreetControl: ShippingAddressStreetControl,
+	StreetControlDefinition: ShippingAddressStreetControlDefinition,
+	NumberControl: ShippingAddressNumberControl,
+	NumberControlDefinition: ShippingAddressNumberControlDefinition,
+	CityControl: ShippingAddressCityControl,
+	CityControlDefinition: ShippingAddressCityControlDefinition,
+	StateControl: ShippingAddressStateControl,
+	StateControlDefinition: ShippingAddressStateControlDefinition,
+	PostalCodeControl: ShippingAddressPostalCodeControl,
+	PostalCodeControlDefinition: ShippingAddressPostalCodeControlDefinition,
+	ComplementControl: ShippingAddressComplementControl,
+	ComplementControlDefinition: ShippingAddressComplementControlDefinition,
+	NeighborhoodControl: ShippingAddressNeighborhoodControl,
+	NeighborhoodControlDefinition: ShippingAddressNeighborhoodControlDefinition,
+	CountryControl: ShippingAddressCountryControl,
+	CountryControlDefinition: ShippingAddressCountryControlDefinition,
+	SavedList: ShippingAddressSavedList,
+	SavedListDefinition: ShippingAddressSavedListDefinition,
+	SavedOption: ShippingAddressSavedOption,
+	SavedOptionDefinition: ShippingAddressSavedOptionDefinition,
+	Submit: ShippingAddressSubmit,
+	SubmitDefinition: ShippingAddressSubmitDefinition,
+	SavedAddressDrawerController: ShippingAddressSavedAddressDrawerController,
+	SavedAddressDrawerControllerDefinition: ShippingAddressSavedAddressDrawerControllerDefinition,
+	SavedAddressSubmit: ShippingAddressSavedAddressSubmit,
+	SavedAddressSubmitDefinition: ShippingAddressSavedAddressSubmitDefinition,
+	SelectedSummary: ShippingAddressSelectedSummary,
+	SelectedSummaryDefinition: ShippingAddressSelectedSummaryDefinition,
+	EditController: ShippingAddressEditController,
+	EditControllerDefinition: ShippingAddressEditControllerDefinition,
+	SummaryView: ShippingAddressSummaryView,
+	SummaryViewDefinition: ShippingAddressSummaryViewDefinition,
+	EditForm: ShippingAddressEditForm,
+	EditFormDefinition: ShippingAddressEditFormDefinition,
+	EditButton: ShippingAddressEditButton,
+	EditButtonDefinition: ShippingAddressEditButtonDefinition,
+	CancelButton: ShippingAddressCancelButton,
+	CancelButtonDefinition: ShippingAddressCancelButtonDefinition,
+	Error: ShippingAddressError,
+	ErrorDefinition: ShippingAddressErrorDefinition
+};
+//#endregion
+export { ShippingAddress, ShippingAddressCancelButton, ShippingAddressCancelButtonDefinition, ShippingAddressCityControl, ShippingAddressCityControlDefinition, ShippingAddressComplementControl, ShippingAddressComplementControlDefinition, ShippingAddressCountryControl, ShippingAddressCountryControlDefinition, ShippingAddressEditButton, ShippingAddressEditButtonDefinition, ShippingAddressEditController, ShippingAddressEditControllerDefinition, ShippingAddressEditForm, ShippingAddressEditFormDefinition, ShippingAddressError, ShippingAddressErrorDefinition, ShippingAddressNeighborhoodControl, ShippingAddressNeighborhoodControlDefinition, ShippingAddressNumberControl, ShippingAddressNumberControlDefinition, ShippingAddressPostalCodeControl, ShippingAddressPostalCodeControlDefinition, ShippingAddressRecipientNameControl, ShippingAddressRecipientNameControlDefinition, ShippingAddressRoot, ShippingAddressRootDefinition, ShippingAddressSavedAddressDrawerController, ShippingAddressSavedAddressDrawerControllerDefinition, ShippingAddressSavedAddressSubmit, ShippingAddressSavedAddressSubmitDefinition, ShippingAddressSavedList, ShippingAddressSavedListDefinition, ShippingAddressSavedOption, ShippingAddressSavedOptionDefinition, ShippingAddressSelectedSummary, ShippingAddressSelectedSummaryDefinition, ShippingAddressStateControl, ShippingAddressStateControlDefinition, ShippingAddressStreetControl, ShippingAddressStreetControlDefinition, ShippingAddressSubmit, ShippingAddressSubmitDefinition, ShippingAddressSummaryView, ShippingAddressSummaryViewDefinition };
+
+//# sourceMappingURL=shipping-address.js.map