@vtex/faststore 0.0.1

package/dist/matter/region/region.js

@@ -0,0 +1,579 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import { defineContentType } from "../../core/dist/define-content-type.js";
+import "../../core/dist/index.js";
+import { useIntl } from "../../sdk/i18n/client.js";
+import { graphql } from "../../sdk/generated/gql.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { resolveSafeHref } from "../../utils/safe-href.js";
+import { ReactiveRootContext } from "../../sdk/data/page-reactive-data-root.js";
+import { PostalCodeField } from "../../particles/postal-code-field/postal-code-field.js";
+import { cloneElement, createContext, isValidElement, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/region/region.tsx
+const fragment = graphql(`
+  fragment RegionData on Query {
+    region {
+      ...RegionFragment
+    }
+  }
+`);
+const RegionTriggerContent = defineContentType({
+	id: "region-trigger",
+	title: "Region Trigger",
+	description: "Copy for the control that opens the region modal.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			unsetLabel: {
+				type: "string",
+				title: "Label when no region is set"
+			},
+			ariaLabel: {
+				type: "string",
+				title: "Accessible label"
+			}
+		}
+	}
+});
+const RegionSubmitContent = defineContentType({
+	id: "region-submit",
+	title: "Region Submit",
+	description: "Copy for the region submit control.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			label: {
+				type: "string",
+				title: "Button label"
+			},
+			pendingLabel: {
+				type: "string",
+				title: "Pending label"
+			}
+		}
+	}
+});
+const RegionUnknownLinkContent = defineContentType({
+	id: "region-unknown-link",
+	title: "Region \"I don't know my postal code\" Link",
+	description: "Copy and destination for the postal-code lookup link. Absent href omits the link.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			text: {
+				type: "string",
+				minLength: 1,
+				title: "Link text"
+			},
+			href: {
+				type: "string",
+				title: "Destination",
+				format: "uri-reference",
+				pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$"
+			}
+		}
+	}
+});
+const RegionErrorContent = defineContentType({
+	id: "region-error",
+	title: "Region Error",
+	description: "Fallback message shown when a write fails without a server message.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { genericMessage: {
+			type: "string",
+			title: "Generic failure message"
+		} }
+	}
+});
+const REGION_CONTEXT_UNSET = Symbol("RegionContextUnset");
+const RegionContextInternal = createContext(REGION_CONTEXT_UNSET);
+const RegionContext = RegionContextInternal;
+/**
+* Read the active region and the modal's write state from the nearest `RegionRoot`. Throws when
+* called outside a `RegionRoot` subtree, mirroring `useSession()` and `useCart()`: a misplaced part
+* is a composition bug the author should see immediately, not a silent degrade to "no region". The
+* compiler catches the same mistake earlier through `requiresContext: 'region'` (ADR-0009).
+*/
+function useRegion() {
+	const ctx = useContext(RegionContextInternal);
+	if (ctx === REGION_CONTEXT_UNSET) throw new Error("Region components must be used inside a <RegionRoot> subtree.");
+	return ctx;
+}
+/**
+* Whether a `RegionForm` encloses the subtree. `RegionSubmit` is independently placeable, so it
+* cannot assume a form owner: with one it is a real submit button, which is what makes Enter in the
+* field submit; without one a `type="submit"` button would have nothing to submit and its click
+* would do nothing. Reading this keeps the form composable rather than load-bearing.
+*/
+const RegionFormContext = createContext(false);
+const RegionRootDefinition = defineComponent({
+	name: "RegionRoot",
+	importPath: "@vtex/faststore/components",
+	component: RegionRoot,
+	fragment,
+	fetchStrategy: "reactive",
+	providesContext: "region",
+	actions: { region: ["setPostalCode"] },
+	editor: {
+		label: "Region Root",
+		category: "content"
+	},
+	schema: {},
+	guideline: "Provides region context and reads the active postal code and city reactively. Place it in the shared header layout and compose RegionTrigger, RegionValue, RegionLoading, and a RegionModalController inside it. Every Region* component must be a descendant. See region.md."
+});
+const RegionTriggerDefinition = defineComponent({
+	name: "RegionTrigger",
+	importPath: "@vtex/faststore/components",
+	component: RegionTrigger,
+	content: RegionTriggerContent,
+	requiresContext: "region",
+	editor: {
+		label: "Region Trigger",
+		category: "action"
+	},
+	schema: { unsetLabel: {
+		type: "string",
+		default: "Informe seu CEP",
+		label: "Label when no region is set"
+	} },
+	guideline: "Opens the region modal. Shows its unset label while no region is set; compose RegionValue as its child so the active region reads inside the control once one is. Its accessible name carries the active region, so a screen reader announces where the shopper is shopping. Must be inside RegionRoot."
+});
+const RegionValueDefinition = defineComponent({
+	name: "RegionValue",
+	importPath: "@vtex/faststore/components",
+	component: RegionValue,
+	requiresContext: "region",
+	editor: {
+		label: "Region Value",
+		category: "content"
+	},
+	schema: {},
+	guideline: "The active region, as city plus postal code. Renders nothing while the region is unresolved or unset, so it needs no visibility prop — place it inside RegionTrigger, or anywhere in the header that should echo the region. The city is wrapped in its own element (data-fs-region-value-city) so a store can style or hide it; when the contract resolves no city, the postal code renders alone with no separator. A plain space separates the two in the text, so the accessible name reads \"São Paulo 01310-100\"; a flex container strips it, so a gap swatch still sets the visible spacing. Must be inside RegionRoot."
+});
+const RegionLoadingDefinition = defineComponent({
+	name: "RegionLoading",
+	importPath: "@vtex/faststore/components",
+	component: RegionLoading,
+	requiresContext: "region",
+	editor: {
+		label: "Region Loading",
+		category: "content"
+	},
+	schema: {},
+	guideline: "Renders its children only while the region read has not resolved. Supply a skeleton placeholder as its child, sized like the resolved display so the header does not reflow when the region arrives. RegionValue renders nothing while this branch is showing, so the two never double up. Must be inside RegionRoot."
+});
+const RegionModalControllerDefinition = defineComponent({
+	name: "RegionModalController",
+	importPath: "@vtex/faststore/components",
+	component: RegionModalController,
+	requiresContext: "region",
+	editor: {
+		label: "Region Modal Controller",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Wraps a single DialogRoot child (the region modal) and makes it controlled by the region state: RegionTrigger opens it, Escape and the backdrop close it, and a successful write closes it. Do not set raw open/onOpenChange on the wrapped DialogRoot. Compose DialogPortal, DialogBackdrop, DialogViewport and DialogPopup inside it, with DialogTitle and DialogDescription naming the dialog, and place a RegionForm holding RegionPostalCodeControl and RegionSubmit in the popup, alongside RegionError and RegionUnknownLink. Same pattern as CartOpenOnAdd wrapping the mini-cart DrawerRoot. Must be inside RegionRoot."
+});
+const RegionFormDefinition = defineComponent({
+	name: "RegionForm",
+	importPath: "@vtex/faststore/components",
+	component: RegionForm,
+	requiresContext: "region",
+	editor: {
+		label: "Region Form",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Form wrapper holding RegionPostalCodeControl and RegionSubmit inside the region modal, so pressing Enter in the field submits. Same role as ShippingSimulatorForm. Compose it whenever both parts sit together; without it the shopper must reach the button, which still works but is not what a one-field form leads them to expect. Must be inside a RegionModalController dialog."
+});
+const RegionPostalCodeControlDefinition = defineComponent({
+	name: "RegionPostalCodeControl",
+	importPath: "@vtex/faststore/components",
+	component: RegionPostalCodeControl,
+	requiresContext: "region",
+	editor: {
+		label: "Region Postal Code Control",
+		category: "content"
+	},
+	schema: {
+		mask: {
+			type: "string",
+			default: "99999-999",
+			label: "Mask pattern"
+		},
+		label: {
+			type: "string",
+			label: "Label"
+		},
+		placeholder: {
+			type: "string",
+			label: "Placeholder"
+		},
+		errorMessage: {
+			type: "string",
+			label: "Incomplete-value message"
+		}
+	},
+	guideline: "The postal-code input inside the region modal: a PostalCodeField bound to the region draft, seeded from the persisted value every time the modal opens. Set mask to the country format at build time (default 99999-999, BR CEP). Server rejections mark the field invalid and take focus back to it; their message is shown by RegionError, not repeated here, and the first keystroke after one clears it. Must be inside a RegionModalController dialog."
+});
+const RegionSubmitDefinition = defineComponent({
+	name: "RegionSubmit",
+	importPath: "@vtex/faststore/components",
+	component: RegionSubmit,
+	content: RegionSubmitContent,
+	requiresContext: "region",
+	editor: {
+		label: "Region Submit",
+		category: "action"
+	},
+	schema: {
+		label: {
+			type: "string",
+			default: "Aplicar",
+			label: "Button label"
+		},
+		pendingLabel: {
+			type: "string",
+			default: "Aplicando...",
+			label: "Pending label"
+		}
+	},
+	guideline: "Submits the region draft. Inside a RegionForm it is the form's submit button, which is what makes Enter in the field work; on its own it dispatches directly. Inert while empty and while a write is in flight, so a double activation dispatches one mutation; the pending state is exposed as aria-busy with no built-in spinner. On success the modal closes; on a rejection it stays open and RegionError explains why. Must be inside a RegionModalController dialog."
+});
+const RegionErrorDefinition = defineComponent({
+	name: "RegionError",
+	importPath: "@vtex/faststore/components",
+	component: RegionError,
+	content: RegionErrorContent,
+	requiresContext: "region",
+	editor: {
+		label: "Region Error",
+		category: "content"
+	},
+	schema: {},
+	guideline: "Shows why the latest region write was refused, announced as an alert when it appears. Renders nothing when there is no error, so it needs no visibility prop. The server's own message is shown verbatim; the authored generic message covers a transport failure, where there is no server message to show. Must be inside a RegionModalController dialog."
+});
+const RegionUnknownLinkDefinition = defineComponent({
+	name: "RegionUnknownLink",
+	importPath: "@vtex/faststore/components",
+	component: RegionUnknownLink,
+	content: RegionUnknownLinkContent,
+	requiresContext: "region",
+	editor: {
+		label: "Region Unknown Postal Code Link",
+		category: "navigation"
+	},
+	schema: {
+		href: {
+			type: "string",
+			label: "Lookup service URL"
+		},
+		target: {
+			type: ["_self", "_blank"],
+			default: "_self",
+			label: "Open in"
+		}
+	},
+	guideline: "The \"I don't know my postal code\" escape hatch, pointing at a postal-code lookup service. Renders nothing until a destination is set, so a store without a lookup service composes it and simply gets no link rather than a dead one. Its text comes from authored content or its children. Must be inside a RegionModalController dialog."
+});
+/**
+* Reads the active region reactively and publishes it, the modal's draft, and the write state as
+* `region` context.
+*
+* The resolved value is never copied into state: `RegionValue` renders only what the fragment
+* resolves, and a successful write updates the display solely by the mutation payload normalizing
+* into the Apollo cache (Decision 5). That is why a rejected write needs no rollback and cannot
+* leave the header showing a postal code the server refused.
+*/
+function RegionRoot({ $data: $dataProp, $actions, className, children, ...props }) {
+	const region = useDataOverride($dataProp) ?? null;
+	const { loading: rootLoading } = useContext(ReactiveRootContext);
+	const loading = rootLoading && region == null;
+	const postalCode = region?.postalCode ?? null;
+	const [open, setOpenState] = useState(false);
+	const [draft, setDraftState] = useState("");
+	const [pending, setPending] = useState(false);
+	const [errors, setErrors] = useState([]);
+	const inFlightRef = useRef(false);
+	/**
+	* Seeds the draft from the persisted value on open and clears it on close (Decision 6), so a
+	* reopened modal always shows the truth rather than an abandoned edit.
+	*/
+	const setOpen = useCallback((next) => {
+		setOpenState(next);
+		setDraftState(next ? postalCode ?? "" : "");
+		setErrors([]);
+	}, [postalCode]);
+	/**
+	* Editing is the shopper's answer to a rejection, so the message and the invalid flag go with the
+	* first keystroke. Left standing, they describe a value that is no longer in the field — and
+	* `RegionPostalCodeControl`, which withholds its own incomplete-value copy while a rejection
+	* stands, would stay silent for the whole edit. Returns the same array when there is nothing to
+	* clear, so ordinary typing does not re-render the error subtree.
+	*/
+	const setDraft = useCallback((value) => {
+		setDraftState(value);
+		setErrors((current) => current.length === 0 ? current : []);
+	}, []);
+	const submit = useCallback(() => {
+		if (inFlightRef.current) return;
+		const setPostalCode = $actions?.region?.setPostalCode;
+		if (!setPostalCode) return;
+		inFlightRef.current = true;
+		setPending(true);
+		setErrors([]);
+		setPostalCode(draft).then((writeErrors) => {
+			if (writeErrors.length > 0) {
+				setErrors(writeErrors);
+				return;
+			}
+			setOpenState(false);
+			setDraftState("");
+		}).finally(() => {
+			inFlightRef.current = false;
+			setPending(false);
+		});
+	}, [$actions, draft]);
+	const value = useMemo(() => ({
+		postalCode,
+		city: region?.city ?? null,
+		loading,
+		draft,
+		setDraft,
+		pending,
+		errors,
+		open,
+		setOpen,
+		submit
+	}), [
+		postalCode,
+		region?.city,
+		loading,
+		draft,
+		setDraft,
+		pending,
+		errors,
+		open,
+		setOpen,
+		submit
+	]);
+	return /* @__PURE__ */ jsx(RegionContextInternal, {
+		value,
+		children: /* @__PURE__ */ jsx("div", {
+			...props,
+			className,
+			"data-fs-region-root": "",
+			children
+		})
+	});
+}
+function RegionTrigger({ unsetLabel = "Informe seu CEP", $content, className, children, ...props }) {
+	const { postalCode, city, loading, setOpen } = useRegion();
+	const isUnset = postalCode == null;
+	const resolvedUnsetLabel = $content?.unsetLabel?.trim() ? $content.unsetLabel : unsetLabel;
+	const authoredAriaLabel = $content?.ariaLabel?.trim() ? $content.ariaLabel : props["aria-label"];
+	/**
+	* WCAG 2.5.3 wants the accessible name to contain the visible label, so an authored label prefixes
+	* the text on screen rather than replacing it: a name of "Alterar região" over text reading
+	* "Informe seu CEP" leaves a voice-control user nothing to say. The region is spaced the way
+	* `RegionValue` spaces it, since the name has to carry that text verbatim. Empty while the region
+	* is unresolved, when the button reads nothing, and with no authored label the name falls back to
+	* the text itself, which already satisfies the rule.
+	*/
+	let visibleLabel = "";
+	if (!loading) visibleLabel = isUnset ? resolvedUnsetLabel : [city, postalCode].filter(Boolean).join(" ");
+	const ariaLabel = authoredAriaLabel && visibleLabel ? `${authoredAriaLabel}: ${visibleLabel}` : authoredAriaLabel;
+	return /* @__PURE__ */ jsxs("button", {
+		...props,
+		type: "button",
+		onClick: () => setOpen(true),
+		disabled: loading || props.disabled,
+		"aria-label": ariaLabel,
+		className,
+		"data-fs-region-trigger": "",
+		...isUnset ? { "data-fs-region-trigger-unset": "" } : {},
+		children: [isUnset && !loading ? resolvedUnsetLabel : null, children]
+	});
+}
+function RegionValue({ className, ...props }) {
+	const { postalCode, city, loading } = useRegion();
+	if (loading || postalCode == null) return null;
+	return /* @__PURE__ */ jsxs("span", {
+		...props,
+		className,
+		"data-fs-region-value": "",
+		children: [
+			city ? /* @__PURE__ */ jsx("span", {
+				"data-fs-region-value-city": "",
+				children: city
+			}) : null,
+			city ? " " : null,
+			postalCode
+		]
+	});
+}
+function RegionLoading({ className, children, ...props }) {
+	const { loading } = useRegion();
+	if (!loading) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-region-loading": "",
+		children
+	});
+}
+/**
+* Makes the wrapped `DialogRoot` controlled by the region state. Mirrors
+* `ShippingAddressSavedAddressDrawerController`'s `cloneElement` mechanism; expects a single
+* `DialogRoot` child. Dismissal is never blocked — the Phase 1 modal is always dismissible.
+*/
+function RegionModalController({ children }) {
+	const { open, setOpen } = useRegion();
+	if (!isValidElement(children)) return children;
+	return cloneElement(children, {
+		open,
+		onOpenChange: (next) => setOpen(next)
+	});
+}
+/**
+* Gives the field and the submit a form owner, so Enter in the postal code submits the way it does
+* in every other short form in the repo. Mirrors `ShippingSimulatorForm`: the form's only job is to
+* route native submission to the context's `submit()`.
+*/
+function RegionForm({ className, children, ...props }) {
+	const { submit } = useRegion();
+	return /* @__PURE__ */ jsx(RegionFormContext, {
+		value: true,
+		children: /* @__PURE__ */ jsx("form", {
+			...props,
+			className,
+			"data-fs-region-form": "",
+			onSubmit: (event) => {
+				event.preventDefault();
+				submit();
+			},
+			children
+		})
+	});
+}
+function RegionPostalCodeControl({ className, mask, label, placeholder, errorMessage }) {
+	const { draft, setDraft, errors, pending } = useRegion();
+	const rootRef = useRef(null);
+	const refused = errors.length > 0;
+	/**
+	* A refusal has to leave the shopper on the value they need to correct. Disabling the input while
+	* the write is in flight blurs it and the browser drops focus to the document body, so a rejection
+	* otherwise lands with nothing focused inside an open dialog — Enter does nothing and Tab restarts
+	* from the top. Waits for `pending` to clear, because focusing a still-disabled input is a no-op:
+	* the errors and the pending flag settle in separate microtasks, so there is a render in between
+	* where the rejection is known and the field is not yet editable. The field is reached through the
+	* root the way ClientProfileForm reaches its own fields.
+	*/
+	useEffect(() => {
+		if (!refused || pending) return;
+		rootRef.current?.querySelector("[data-fs-postal-code-field-input]")?.focus();
+	}, [refused, pending]);
+	return /* @__PURE__ */ jsx(PostalCodeField, {
+		ref: rootRef,
+		className,
+		"data-fs-region-postal-code-control": "",
+		mask,
+		label,
+		placeholder,
+		errorMessage: errors.length > 0 ? void 0 : errorMessage,
+		value: draft,
+		onValueChange: setDraft,
+		invalid: errors.length > 0,
+		disabled: pending
+	});
+}
+function RegionSubmit({ label = "Aplicar", pendingLabel = "Aplicando...", $content, className, children, ...props }) {
+	const { draft, pending, submit } = useRegion();
+	const inForm = useContext(RegionFormContext);
+	const resolvedLabel = $content?.label?.trim() ? $content.label : label;
+	const resolvedPendingLabel = $content?.pendingLabel?.trim() ? $content.pendingLabel : pendingLabel;
+	return /* @__PURE__ */ jsx("button", {
+		...props,
+		type: inForm ? "submit" : "button",
+		onClick: inForm ? props.onClick : submit,
+		disabled: pending || draft.trim() === "" || props.disabled,
+		"aria-busy": pending || void 0,
+		className,
+		"data-fs-region-submit": "",
+		...pending ? { "data-fs-region-submit-pending": "" } : {},
+		children: children ?? (pending ? resolvedPendingLabel : resolvedLabel)
+	});
+}
+/**
+* The catalog copy for each rejection the client can name: the server's `RegionErrorCode` values plus
+* the client-minted transport failure. The server's own `message` is English, so it is shown only for
+* a code this map does not know — a newer server than this package.
+*/
+const REGION_ERROR_MESSAGE_IDS = {
+	INVALID_POSTAL_CODE: "fs/region.error.invalid-postal-code",
+	UNSERVED_POSTAL_CODE: "fs/region.error.unserved-postal-code",
+	NETWORK_ERROR: "fs/region.error.network"
+};
+function RegionError({ $content, className, ...props }) {
+	const { errors } = useRegion();
+	const intl = useIntl();
+	if (errors.length === 0) return null;
+	const genericMessage = $content?.genericMessage?.trim() ? $content.genericMessage : null;
+	function copyFor(error) {
+		if (error.code === "NETWORK_ERROR" && genericMessage) return genericMessage;
+		const id = error.code ? REGION_ERROR_MESSAGE_IDS[error.code] : void 0;
+		return id ? intl.formatMessage({ id }) : error.message;
+	}
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		role: "alert",
+		className,
+		"data-fs-region-error": "",
+		children: errors.map((error) => /* @__PURE__ */ jsx("div", { children: copyFor(error) }, `${error.code ?? ""}${error.message}`))
+	});
+}
+function RegionUnknownLink({ $content, className, children, href, rel, ...props }) {
+	useRegion();
+	const authoredHref = $content?.href?.trim() ? $content.href : href?.trim();
+	if (!authoredHref) return null;
+	const destination = resolveSafeHref(authoredHref);
+	if (!destination.safe) {
+		console.warn("[RegionUnknownLink] link destination rejected", { reason: destination.reason });
+		return null;
+	}
+	const text = $content?.text?.trim() ? $content.text : children;
+	if (!text) return null;
+	const relTokens = rel?.split(/\s+/).filter(Boolean) ?? [];
+	const present = new Set(relTokens.map((token) => token.toLowerCase()));
+	const safeRel = props.target?.toLowerCase() === "_blank" ? [...relTokens, ...["noopener", "noreferrer"].filter((token) => !present.has(token))].join(" ") : rel;
+	return /* @__PURE__ */ jsx("a", {
+		...props,
+		href: destination.href,
+		rel: safeRel,
+		className,
+		"data-fs-region-unknown-link": "",
+		children: text
+	});
+}
+const Region = {
+	Root: RegionRoot,
+	Trigger: RegionTrigger,
+	Value: RegionValue,
+	Loading: RegionLoading,
+	ModalController: RegionModalController,
+	Form: RegionForm,
+	PostalCodeControl: RegionPostalCodeControl,
+	Submit: RegionSubmit,
+	Error: RegionError,
+	UnknownLink: RegionUnknownLink
+};
+//#endregion
+export { Region, RegionContext, RegionError, RegionErrorContent, RegionErrorDefinition, RegionForm, RegionFormDefinition, RegionLoading, RegionLoadingDefinition, RegionModalController, RegionModalControllerDefinition, RegionPostalCodeControl, RegionPostalCodeControlDefinition, RegionRoot, RegionRootDefinition, RegionSubmit, RegionSubmitContent, RegionSubmitDefinition, RegionTrigger, RegionTriggerContent, RegionTriggerDefinition, RegionUnknownLink, RegionUnknownLinkContent, RegionUnknownLinkDefinition, RegionValue, RegionValueDefinition, useRegion };
+
+//# sourceMappingURL=region.js.map

package/dist/matter/region/region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.js","names":[],"sources":["../../../src/matter/region/region.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport {\n  type ComponentPropsWithRef,\n  cloneElement,\n  createContext,\n  isValidElement,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport type { DialogRootProps } from '../../particles/dialog/dialog.js';\nimport { PostalCodeField } from '../../particles/postal-code-field/postal-code-field.js';\nimport type { ComponentActions } from '../../sdk/actions/types.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { ReactiveRootContext } from '../../sdk/data/page-reactive-data-root.js';\nimport { graphql } from '../../sdk/generated/gql.js';\nimport { type MessageId, useIntl } from '../../sdk/i18n/client.js';\nimport type { RegionEntity } from '../../sdk/region/operations.js';\nimport type { RegionUserError } from '../../sdk/region/region-operations.js';\nimport { resolveSafeHref } from '../../utils/safe-href.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset\n// ---------------------------------------------------------------------------\n\nconst fragment = graphql(`\n  fragment RegionData on Query {\n    region {\n      ...RegionFragment\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Content models — one per copy-bearing part (Decision 7)\n// ---------------------------------------------------------------------------\n\nexport const RegionTriggerContent = defineContentType({\n  id: 'region-trigger',\n  title: 'Region Trigger',\n  description: 'Copy for the control that opens the region modal.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      unsetLabel: { type: 'string', title: 'Label when no region is set' },\n      ariaLabel: { type: 'string', title: 'Accessible label' },\n    },\n  },\n});\n\nexport const RegionSubmitContent = defineContentType({\n  id: 'region-submit',\n  title: 'Region Submit',\n  description: 'Copy for the region submit control.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      label: { type: 'string', title: 'Button label' },\n      pendingLabel: { type: 'string', title: 'Pending label' },\n    },\n  },\n});\n\nexport const RegionUnknownLinkContent = defineContentType({\n  id: 'region-unknown-link',\n  title: 'Region \"I don\\'t know my postal code\" Link',\n  description: 'Copy and destination for the postal-code lookup link. Absent href omits the link.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      text: { type: 'string', minLength: 1, title: 'Link text' },\n      href: {\n        type: 'string',\n        title: 'Destination',\n        format: 'uri-reference',\n        // The set `resolveSafeHref` admits, so the Admin form cannot reject a destination the render\n        // gate would have kept. Author-time only and lookahead-free, as in the link-bearing particles.\n        pattern: '^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$',\n      },\n    },\n  },\n});\n\nexport const RegionErrorContent = defineContentType({\n  id: 'region-error',\n  title: 'Region Error',\n  description: 'Fallback message shown when a write fails without a server message.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      genericMessage: { type: 'string', title: 'Generic failure message' },\n    },\n  },\n});\n\n// ---------------------------------------------------------------------------\n// Region context\n// ---------------------------------------------------------------------------\n\nexport type RegionContextValue = Readonly<{\n  /** Persisted postal code, formatted; null until a region is set. */\n  postalCode: string | null;\n  /** Persisted city; null when the contract does not resolve one. */\n  city: string | null;\n  /** The reactive read has not resolved and no cached value is available. */\n  loading: boolean;\n  /** The modal's draft value, masked as the shopper typed it. */\n  draft: string;\n  setDraft: (value: string) => void;\n  /** A write is in flight. */\n  pending: boolean;\n  /** Errors from the latest write; empty when there are none. */\n  errors: readonly RegionUserError[];\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  /** Dispatches setPostalCode with the current draft. No-op while pending. */\n  submit: () => void;\n}>;\n\nconst REGION_CONTEXT_UNSET = Symbol('RegionContextUnset');\n\nconst RegionContextInternal = createContext<RegionContextValue | typeof REGION_CONTEXT_UNSET>(REGION_CONTEXT_UNSET);\n\nexport const RegionContext = RegionContextInternal as React.Context<RegionContextValue>;\n\n/**\n * Read the active region and the modal's write state from the nearest `RegionRoot`. Throws when\n * called outside a `RegionRoot` subtree, mirroring `useSession()` and `useCart()`: a misplaced part\n * is a composition bug the author should see immediately, not a silent degrade to \"no region\". The\n * compiler catches the same mistake earlier through `requiresContext: 'region'` (ADR-0009).\n */\nexport function useRegion(): RegionContextValue {\n  const ctx = useContext(RegionContextInternal);\n  if (ctx === REGION_CONTEXT_UNSET) {\n    throw new Error('Region components must be used inside a <RegionRoot> subtree.');\n  }\n  return ctx;\n}\n\n/**\n * Whether a `RegionForm` encloses the subtree. `RegionSubmit` is independently placeable, so it\n * cannot assume a form owner: with one it is a real submit button, which is what makes Enter in the\n * field submit; without one a `type=\"submit\"` button would have nothing to submit and its click\n * would do nothing. Reading this keeps the form composable rather than load-bearing.\n */\nconst RegionFormContext = createContext(false);\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type RegionRootProps = ComponentPropsWithRef<'div'> & {\n  /**\n   * Region entity slice forwarded by the reactive runtime (`ReactiveDataProvider`) — the value of the\n   * `region` top-level field on `RegionData on Query`, not the wrapping `{ region: … }` shape.\n   * Receives `null` while the entity has not resolved and when no region is set.\n   */\n  $data?: RegionEntity | null;\n  /** Injected by the compiler from `actions: { region: ['setPostalCode'] }`; the region write surface. */\n  $actions?: ComponentActions;\n  children?: ReactNode;\n};\n\nexport type RegionTriggerProps = ComponentPropsWithRef<'button'> & {\n  /** Shown when no region is set. */\n  unsetLabel?: string;\n  /** Merchant-authored copy; wins over the props when present. */\n  $content?: ContentValue<typeof RegionTriggerContent>;\n};\n\n/** Children are omitted: what this renders is the resolved region, never authored content. */\nexport type RegionValueProps = Omit<ComponentPropsWithRef<'span'>, 'children'>;\n\nexport type RegionLoadingProps = ComponentPropsWithRef<'div'>;\n\nexport type RegionModalControllerProps = {\n  children?: ReactNode;\n};\n\nexport type RegionFormProps = ComponentPropsWithRef<'form'>;\n\nexport type RegionPostalCodeControlProps = {\n  className?: string;\n  /** Mask template forwarded to `PostalCodeField`; defaults to that particle's BR CEP mask. */\n  mask?: string;\n  label?: string;\n  placeholder?: string;\n  /** The field's own incomplete-value message. Server rejections surface through `RegionError`. */\n  errorMessage?: string;\n};\n\nexport type RegionSubmitProps = ComponentPropsWithRef<'button'> & {\n  label?: string;\n  pendingLabel?: string;\n  /** Merchant-authored copy; wins over the props when present. */\n  $content?: ContentValue<typeof RegionSubmitContent>;\n};\n\n/** Children are omitted: what this renders is the write's own error, never authored content. */\nexport type RegionErrorProps = Omit<ComponentPropsWithRef<'div'>, 'children'> & {\n  /** Merchant-authored fallback copy; wins over the prop when present. */\n  $content?: ContentValue<typeof RegionErrorContent>;\n};\n\nexport type RegionUnknownLinkProps = ComponentPropsWithRef<'a'> & {\n  /** Merchant-authored text and destination; each wins over its prop when present. */\n  $content?: ContentValue<typeof RegionUnknownLinkContent>;\n};\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const RegionRootDefinition = defineComponent<RegionRootProps>({\n  name: 'RegionRoot',\n  importPath: '@vtex/faststore/components',\n  component: RegionRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  providesContext: 'region',\n  actions: { region: ['setPostalCode'] },\n  editor: { label: 'Region Root', category: 'content' },\n  schema: {},\n  guideline:\n    'Provides region context and reads the active postal code and city reactively. Place it in the shared header layout and compose RegionTrigger, RegionValue, RegionLoading, and a RegionModalController inside it. Every Region* component must be a descendant. See region.md.',\n});\n\nexport const RegionTriggerDefinition = defineComponent<RegionTriggerProps>({\n  name: 'RegionTrigger',\n  importPath: '@vtex/faststore/components',\n  component: RegionTrigger,\n  content: RegionTriggerContent,\n  requiresContext: 'region',\n  editor: { label: 'Region Trigger', category: 'action' },\n  schema: {\n    unsetLabel: { type: 'string', default: 'Informe seu CEP', label: 'Label when no region is set' },\n  },\n  guideline:\n    'Opens the region modal. Shows its unset label while no region is set; compose RegionValue as its child so the active region reads inside the control once one is. Its accessible name carries the active region, so a screen reader announces where the shopper is shopping. Must be inside RegionRoot.',\n});\n\nexport const RegionValueDefinition = defineComponent<RegionValueProps>({\n  name: 'RegionValue',\n  importPath: '@vtex/faststore/components',\n  component: RegionValue,\n  requiresContext: 'region',\n  editor: { label: 'Region Value', category: 'content' },\n  schema: {},\n  guideline:\n    'The active region, as city plus postal code. Renders nothing while the region is unresolved or unset, so it needs no visibility prop — place it inside RegionTrigger, or anywhere in the header that should echo the region. The city is wrapped in its own element (data-fs-region-value-city) so a store can style or hide it; when the contract resolves no city, the postal code renders alone with no separator. A plain space separates the two in the text, so the accessible name reads \"São Paulo 01310-100\"; a flex container strips it, so a gap swatch still sets the visible spacing. Must be inside RegionRoot.',\n});\n\nexport const RegionLoadingDefinition = defineComponent<RegionLoadingProps>({\n  name: 'RegionLoading',\n  importPath: '@vtex/faststore/components',\n  component: RegionLoading,\n  requiresContext: 'region',\n  editor: { label: 'Region Loading', category: 'content' },\n  schema: {},\n  guideline:\n    'Renders its children only while the region read has not resolved. Supply a skeleton placeholder as its child, sized like the resolved display so the header does not reflow when the region arrives. RegionValue renders nothing while this branch is showing, so the two never double up. Must be inside RegionRoot.',\n});\n\nexport const RegionModalControllerDefinition = defineComponent<RegionModalControllerProps>({\n  name: 'RegionModalController',\n  importPath: '@vtex/faststore/components',\n  component: RegionModalController,\n  requiresContext: 'region',\n  editor: { label: 'Region Modal Controller', category: 'action' },\n  schema: {},\n  guideline:\n    'Wraps a single DialogRoot child (the region modal) and makes it controlled by the region state: RegionTrigger opens it, Escape and the backdrop close it, and a successful write closes it. Do not set raw open/onOpenChange on the wrapped DialogRoot. Compose DialogPortal, DialogBackdrop, DialogViewport and DialogPopup inside it, with DialogTitle and DialogDescription naming the dialog, and place a RegionForm holding RegionPostalCodeControl and RegionSubmit in the popup, alongside RegionError and RegionUnknownLink. Same pattern as CartOpenOnAdd wrapping the mini-cart DrawerRoot. Must be inside RegionRoot.',\n});\n\nexport const RegionFormDefinition = defineComponent<RegionFormProps>({\n  name: 'RegionForm',\n  importPath: '@vtex/faststore/components',\n  component: RegionForm,\n  requiresContext: 'region',\n  editor: { label: 'Region Form', category: 'action' },\n  schema: {},\n  guideline:\n    'Form wrapper holding RegionPostalCodeControl and RegionSubmit inside the region modal, so pressing Enter in the field submits. Same role as ShippingSimulatorForm. Compose it whenever both parts sit together; without it the shopper must reach the button, which still works but is not what a one-field form leads them to expect. Must be inside a RegionModalController dialog.',\n});\n\nexport const RegionPostalCodeControlDefinition = defineComponent<RegionPostalCodeControlProps>({\n  name: 'RegionPostalCodeControl',\n  importPath: '@vtex/faststore/components',\n  component: RegionPostalCodeControl,\n  requiresContext: 'region',\n  editor: { label: 'Region Postal Code Control', category: 'content' },\n  schema: {\n    mask: { type: 'string', default: '99999-999', label: 'Mask pattern' },\n    label: { type: 'string', label: 'Label' },\n    placeholder: { type: 'string', label: 'Placeholder' },\n    errorMessage: { type: 'string', label: 'Incomplete-value message' },\n  },\n  guideline:\n    'The postal-code input inside the region modal: a PostalCodeField bound to the region draft, seeded from the persisted value every time the modal opens. Set mask to the country format at build time (default 99999-999, BR CEP). Server rejections mark the field invalid and take focus back to it; their message is shown by RegionError, not repeated here, and the first keystroke after one clears it. Must be inside a RegionModalController dialog.',\n});\n\nexport const RegionSubmitDefinition = defineComponent<RegionSubmitProps>({\n  name: 'RegionSubmit',\n  importPath: '@vtex/faststore/components',\n  component: RegionSubmit,\n  content: RegionSubmitContent,\n  requiresContext: 'region',\n  editor: { label: 'Region Submit', category: 'action' },\n  schema: {\n    label: { type: 'string', default: 'Aplicar', label: 'Button label' },\n    pendingLabel: { type: 'string', default: 'Aplicando...', label: 'Pending label' },\n  },\n  guideline:\n    \"Submits the region draft. Inside a RegionForm it is the form's submit button, which is what makes Enter in the field work; on its own it dispatches directly. Inert while empty and while a write is in flight, so a double activation dispatches one mutation; the pending state is exposed as aria-busy with no built-in spinner. On success the modal closes; on a rejection it stays open and RegionError explains why. Must be inside a RegionModalController dialog.\",\n});\n\nexport const RegionErrorDefinition = defineComponent<RegionErrorProps>({\n  name: 'RegionError',\n  importPath: '@vtex/faststore/components',\n  component: RegionError,\n  content: RegionErrorContent,\n  requiresContext: 'region',\n  editor: { label: 'Region Error', category: 'content' },\n  schema: {},\n  guideline:\n    \"Shows why the latest region write was refused, announced as an alert when it appears. Renders nothing when there is no error, so it needs no visibility prop. The server's own message is shown verbatim; the authored generic message covers a transport failure, where there is no server message to show. Must be inside a RegionModalController dialog.\",\n});\n\nexport const RegionUnknownLinkDefinition = defineComponent<RegionUnknownLinkProps>({\n  name: 'RegionUnknownLink',\n  importPath: '@vtex/faststore/components',\n  component: RegionUnknownLink,\n  content: RegionUnknownLinkContent,\n  requiresContext: 'region',\n  editor: { label: 'Region Unknown Postal Code Link', category: 'navigation' },\n  schema: {\n    href: { type: 'string', label: 'Lookup service URL' },\n    target: { type: ['_self', '_blank'] as const, default: '_self', label: 'Open in' },\n  },\n  guideline:\n    'The \"I don\\'t know my postal code\" escape hatch, pointing at a postal-code lookup service. Renders nothing until a destination is set, so a store without a lookup service composes it and simply gets no link rather than a dead one. Its text comes from authored content or its children. Must be inside a RegionModalController dialog.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\n/**\n * Reads the active region reactively and publishes it, the modal's draft, and the write state as\n * `region` context.\n *\n * The resolved value is never copied into state: `RegionValue` renders only what the fragment\n * resolves, and a successful write updates the display solely by the mutation payload normalizing\n * into the Apollo cache (Decision 5). That is why a rejected write needs no rollback and cannot\n * leave the header showing a postal code the server refused.\n */\nexport function RegionRoot({ $data: $dataProp, $actions, className, children, ...props }: RegionRootProps) {\n  const $data = useDataOverride($dataProp);\n  const region = $data ?? null;\n  const { loading: rootLoading } = useContext(ReactiveRootContext);\n  // A null region is ambiguous on its own — an unresolved read and a shopper who never set one look\n  // the same — so the root query's in-flight flag is what separates \"loading\" from \"unset\". Without\n  // it a first-time shopper would sit under a skeleton forever instead of seeing the unset prompt.\n  const loading = rootLoading && region == null;\n\n  const postalCode = region?.postalCode ?? null;\n\n  const [open, setOpenState] = useState(false);\n  const [draft, setDraftState] = useState('');\n  const [pending, setPending] = useState(false);\n  const [errors, setErrors] = useState<readonly RegionUserError[]>([]);\n  // State is batched, so two activations in one tick would both pass a `pending` check. The ref is\n  // what makes \"exactly one mutation per activation\" hold.\n  const inFlightRef = useRef(false);\n\n  /**\n   * Seeds the draft from the persisted value on open and clears it on close (Decision 6), so a\n   * reopened modal always shows the truth rather than an abandoned edit.\n   */\n  const setOpen = useCallback(\n    (next: boolean) => {\n      setOpenState(next);\n      setDraftState(next ? (postalCode ?? '') : '');\n      setErrors([]);\n    },\n    [postalCode],\n  );\n\n  /**\n   * Editing is the shopper's answer to a rejection, so the message and the invalid flag go with the\n   * first keystroke. Left standing, they describe a value that is no longer in the field — and\n   * `RegionPostalCodeControl`, which withholds its own incomplete-value copy while a rejection\n   * stands, would stay silent for the whole edit. Returns the same array when there is nothing to\n   * clear, so ordinary typing does not re-render the error subtree.\n   */\n  const setDraft = useCallback((value: string) => {\n    setDraftState(value);\n    setErrors((current) => (current.length === 0 ? current : []));\n  }, []);\n\n  const submit = useCallback(() => {\n    if (inFlightRef.current) return;\n    const setPostalCode = $actions?.region?.setPostalCode;\n    if (!setPostalCode) return;\n\n    inFlightRef.current = true;\n    setPending(true);\n    setErrors([]);\n\n    void setPostalCode(draft)\n      .then((writeErrors) => {\n        if (writeErrors.length > 0) {\n          // A rejection keeps the modal open so the message has somewhere to show (US-3).\n          setErrors(writeErrors);\n          return;\n        }\n        setOpenState(false);\n        setDraftState('');\n      })\n      .finally(() => {\n        inFlightRef.current = false;\n        setPending(false);\n      });\n  }, [$actions, draft]);\n\n  const value: RegionContextValue = useMemo(\n    () => ({\n      postalCode,\n      city: region?.city ?? null,\n      loading,\n      draft,\n      setDraft,\n      pending,\n      errors,\n      open,\n      setOpen,\n      submit,\n    }),\n    [postalCode, region?.city, loading, draft, setDraft, pending, errors, open, setOpen, submit],\n  );\n\n  return (\n    <RegionContextInternal value={value}>\n      <div {...props} className={className} data-fs-region-root=\"\">\n        {children}\n      </div>\n    </RegionContextInternal>\n  );\n}\n\nexport function RegionTrigger({\n  unsetLabel = 'Informe seu CEP',\n  $content,\n  className,\n  children,\n  ...props\n}: RegionTriggerProps) {\n  const { postalCode, city, loading, setOpen } = useRegion();\n  const isUnset = postalCode == null;\n\n  const resolvedUnsetLabel = $content?.unsetLabel?.trim() ? $content.unsetLabel : unsetLabel;\n  const authoredAriaLabel = $content?.ariaLabel?.trim() ? $content.ariaLabel : props['aria-label'];\n\n  /**\n   * WCAG 2.5.3 wants the accessible name to contain the visible label, so an authored label prefixes\n   * the text on screen rather than replacing it: a name of \"Alterar região\" over text reading\n   * \"Informe seu CEP\" leaves a voice-control user nothing to say. The region is spaced the way\n   * `RegionValue` spaces it, since the name has to carry that text verbatim. Empty while the region\n   * is unresolved, when the button reads nothing, and with no authored label the name falls back to\n   * the text itself, which already satisfies the rule.\n   */\n  let visibleLabel = '';\n  if (!loading) {\n    visibleLabel = isUnset ? resolvedUnsetLabel : [city, postalCode].filter(Boolean).join(' ');\n  }\n\n  const ariaLabel = authoredAriaLabel && visibleLabel ? `${authoredAriaLabel}: ${visibleLabel}` : authoredAriaLabel;\n\n  return (\n    <button\n      {...props}\n      type=\"button\"\n      onClick={() => setOpen(true)}\n      // Not yet interactive while the region is unresolved: activating it would seed the draft from a\n      // value that has not arrived.\n      disabled={loading || props.disabled}\n      aria-label={ariaLabel}\n      className={className}\n      data-fs-region-trigger=\"\"\n      {...(isUnset ? { 'data-fs-region-trigger-unset': '' } : {})}\n    >\n      {isUnset && !loading ? resolvedUnsetLabel : null}\n      {children}\n    </button>\n  );\n}\n\nexport function RegionValue({ className, ...props }: RegionValueProps) {\n  const { postalCode, city, loading } = useRegion();\n  if (loading || postalCode == null) return null;\n\n  return (\n    <span {...props} className={className} data-fs-region-value=\"\">\n      {city ? <span data-fs-region-value-city=\"\">{city}</span> : null}\n      {/* A real text node, not a styling concern: it is what separates the two values in the\n          accessible name — this is the trigger's name whenever no aria-label is authored — and in any\n          non-flex placement. It must stay a plain space: a flex container strips it as leading\n          whitespace, so a store's `gap` still governs the visible spacing, where an &nbsp; would\n          survive and widen the row. Absent with no city, so the postal code never renders padded. */}\n      {city ? ' ' : null}\n      {postalCode}\n    </span>\n  );\n}\n\nexport function RegionLoading({ className, children, ...props }: RegionLoadingProps) {\n  const { loading } = useRegion();\n  if (!loading) return null;\n\n  return (\n    <div {...props} className={className} data-fs-region-loading=\"\">\n      {children}\n    </div>\n  );\n}\n\n/**\n * Makes the wrapped `DialogRoot` controlled by the region state. Mirrors\n * `ShippingAddressSavedAddressDrawerController`'s `cloneElement` mechanism; expects a single\n * `DialogRoot` child. Dismissal is never blocked — the Phase 1 modal is always dismissible.\n */\nexport function RegionModalController({ children }: RegionModalControllerProps) {\n  const { open, setOpen } = useRegion();\n\n  if (!isValidElement<Pick<DialogRootProps, 'open' | 'onOpenChange'>>(children)) {\n    return children;\n  }\n\n  return cloneElement(children, {\n    open,\n    onOpenChange: (next: boolean) => setOpen(next),\n  });\n}\n\n/**\n * Gives the field and the submit a form owner, so Enter in the postal code submits the way it does\n * in every other short form in the repo. Mirrors `ShippingSimulatorForm`: the form's only job is to\n * route native submission to the context's `submit()`.\n */\nexport function RegionForm({ className, children, ...props }: RegionFormProps) {\n  const { submit } = useRegion();\n\n  return (\n    <RegionFormContext value={true}>\n      <form\n        {...props}\n        className={className}\n        data-fs-region-form=\"\"\n        onSubmit={(event) => {\n          event.preventDefault();\n          submit();\n        }}\n      >\n        {children}\n      </form>\n    </RegionFormContext>\n  );\n}\n\nexport function RegionPostalCodeControl({\n  className,\n  mask,\n  label,\n  placeholder,\n  errorMessage,\n}: RegionPostalCodeControlProps) {\n  const { draft, setDraft, errors, pending } = useRegion();\n  const rootRef = useRef<HTMLDivElement>(null);\n  const refused = errors.length > 0;\n\n  /**\n   * A refusal has to leave the shopper on the value they need to correct. Disabling the input while\n   * the write is in flight blurs it and the browser drops focus to the document body, so a rejection\n   * otherwise lands with nothing focused inside an open dialog — Enter does nothing and Tab restarts\n   * from the top. Waits for `pending` to clear, because focusing a still-disabled input is a no-op:\n   * the errors and the pending flag settle in separate microtasks, so there is a render in between\n   * where the rejection is known and the field is not yet editable. The field is reached through the\n   * root the way ClientProfileForm reaches its own fields.\n   */\n  useEffect(() => {\n    if (!refused || pending) return;\n    rootRef.current?.querySelector<HTMLInputElement>('[data-fs-postal-code-field-input]')?.focus();\n  }, [refused, pending]);\n\n  return (\n    <PostalCodeField\n      ref={rootRef}\n      className={className}\n      data-fs-region-postal-code-control=\"\"\n      mask={mask}\n      label={label}\n      placeholder={placeholder}\n      // The field renders this whenever it is invalid, from either source, so it is withheld while a\n      // server rejection stands: that message is RegionError's, and the field's own copy describes an\n      // incomplete value — wrong for a complete code the server refused, and contradictory stacked\n      // under the real reason.\n      errorMessage={errors.length > 0 ? undefined : errorMessage}\n      value={draft}\n      onValueChange={setDraft}\n      // Still flagged invalid, so the refused value carries aria-invalid and the invalid styling.\n      invalid={errors.length > 0}\n      disabled={pending}\n    />\n  );\n}\n\nexport function RegionSubmit({\n  label = 'Aplicar',\n  pendingLabel = 'Aplicando...',\n  $content,\n  className,\n  children,\n  ...props\n}: RegionSubmitProps) {\n  const { draft, pending, submit } = useRegion();\n  const inForm = useContext(RegionFormContext);\n\n  const resolvedLabel = $content?.label?.trim() ? $content.label : label;\n  const resolvedPendingLabel = $content?.pendingLabel?.trim() ? $content.pendingLabel : pendingLabel;\n\n  return (\n    <button\n      {...props}\n      // The form routes native submission to the same submit(); alone there is no form to submit.\n      type={inForm ? 'submit' : 'button'}\n      onClick={inForm ? props.onClick : submit}\n      disabled={pending || draft.trim() === '' || props.disabled}\n      aria-busy={pending || undefined}\n      className={className}\n      data-fs-region-submit=\"\"\n      {...(pending ? { 'data-fs-region-submit-pending': '' } : {})}\n    >\n      {children ?? (pending ? resolvedPendingLabel : resolvedLabel)}\n    </button>\n  );\n}\n\n/**\n * The catalog copy for each rejection the client can name: the server's `RegionErrorCode` values plus\n * the client-minted transport failure. The server's own `message` is English, so it is shown only for\n * a code this map does not know — a newer server than this package.\n */\nconst REGION_ERROR_MESSAGE_IDS: Readonly<Record<string, MessageId>> = {\n  INVALID_POSTAL_CODE: 'fs/region.error.invalid-postal-code',\n  UNSERVED_POSTAL_CODE: 'fs/region.error.unserved-postal-code',\n  NETWORK_ERROR: 'fs/region.error.network',\n};\n\nexport function RegionError({ $content, className, ...props }: RegionErrorProps) {\n  const { errors } = useRegion();\n  const intl = useIntl();\n  if (errors.length === 0) return null;\n\n  const genericMessage = $content?.genericMessage?.trim() ? $content.genericMessage : null;\n\n  function copyFor(error: RegionUserError): string {\n    // A transport failure carries no server message worth showing a shopper, so the authored\n    // generic copy wins there and only there. Every other code the catalog knows renders in the\n    // store's language; a code it does not know falls back to the server's own message.\n    if (error.code === 'NETWORK_ERROR' && genericMessage) return genericMessage;\n    const id = error.code ? REGION_ERROR_MESSAGE_IDS[error.code] : undefined;\n    return id ? intl.formatMessage({ id }) : error.message;\n  }\n\n  return (\n    <div {...props} role=\"alert\" className={className} data-fs-region-error=\"\">\n      {errors.map((error) => (\n        <div key={`${error.code ?? ''}${error.message}`}>{copyFor(error)}</div>\n      ))}\n    </div>\n  );\n}\n\nexport function RegionUnknownLink({ $content, className, children, href, rel, ...props }: RegionUnknownLinkProps) {\n  // Called for its guard alone: a part placed outside a RegionRoot must fail here the way its\n  // siblings do, even though this one reads nothing from the context.\n  useRegion();\n\n  const authoredHref = $content?.href?.trim() ? $content.href : href?.trim();\n  // Absent is \"no link\", the ordinary shape for a store with no lookup service, so it never reaches\n  // the allowlist or the log.\n  if (!authoredHref) return null;\n\n  // No read-time validator enforces the model's `format` or `pattern`, so this is the only gate on\n  // the CMS value.\n  const destination = resolveSafeHref(authoredHref);\n  if (!destination.safe) {\n    // A bounded reason and no authored value, the convention the content runtime's own log follows.\n    console.warn('[RegionUnknownLink] link destination rejected', { reason: destination.reason });\n    return null;\n  }\n\n  const text = $content?.text?.trim() ? $content.text : children;\n  if (!text) return null;\n\n  // A lookup service is a natural new-tab destination, so a store may pass target. The tab-nabbing\n  // defense is then this component's responsibility, not the composer's — the same contract\n  // NavigationLink states. Target keywords and link types are both ASCII case-insensitive per HTML,\n  // so _BLANK opens a new tab and a caller-passed NOOPENER already counts.\n  const relTokens = rel?.split(/\\s+/).filter(Boolean) ?? [];\n  const present = new Set(relTokens.map((token) => token.toLowerCase()));\n  const safeRel =\n    props.target?.toLowerCase() === '_blank'\n      ? [...relTokens, ...['noopener', 'noreferrer'].filter((token) => !present.has(token))].join(' ')\n      : rel;\n\n  return (\n    <a {...props} href={destination.href} rel={safeRel} className={className} data-fs-region-unknown-link=\"\">\n      {text}\n    </a>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Namespace export\n// ---------------------------------------------------------------------------\n\nexport const Region = {\n  Root: RegionRoot,\n  Trigger: RegionTrigger,\n  Value: RegionValue,\n  Loading: RegionLoading,\n  ModalController: RegionModalController,\n  Form: RegionForm,\n  PostalCodeControl: RegionPostalCodeControl,\n  Submit: RegionSubmit,\n  Error: RegionError,\n  UnknownLink: RegionUnknownLink,\n};\n"],"mappings":"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"}