@vtex/faststore 0.0.7 → 0.0.8

package/dist/matter/account-address-book/account-address-book.js

@@ -0,0 +1,469 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { useStorefrontFormatters } from "../../sdk/format/client.js";
+import { useIntl } from "../../sdk/i18n/client.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { resolveAuthoredCopy } from "../../utils/resolve-authored-copy.js";
+import { useSession } from "../session/session.js";
+import { AddressSummary, AddressSummaryCountry, AddressSummaryField, AddressSummaryRecipient, AddressSummaryRoot } from "../../particles/address-summary/address-summary.js";
+import { Button } from "../../particles/button/button.js";
+import { countryDisplayName } from "../../sdk/address/country-display.js";
+import { formatAddress } from "../../sdk/address/format-address.js";
+import { ListItemRefContext } from "../../sdk/data/list-item-ref-context.js";
+import { ReactiveRootContext } from "../../sdk/data/page-reactive-data-root.js";
+import { Fragment, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/account-address-book/account-address-book.tsx
+/**
+* The shopper's saved addresses, listed (specs/sfs-3440-address-book-list.md, RFC REQ-01). One family
+* split by data-fetch role, in the pattern `SavedCards` and `CartRoot` use:
+*
+* - `AccountAddressBookRoot` reads the book once through the page's reactive query, owns the four
+*   states, and gates on a signed-in session.
+* - `AccountAddressBookList` fans the addresses out by entity ref, one `li` per address.
+* - `AccountAddressBookItem` subscribes to its own `CustomerAddress` entity (`reactive-list-item`) and
+*   bridges it onto the generic `AddressSummary` particle.
+* - `Loading`, `Empty` and `Error` are composed parts, so a store chooses where each sits.
+*
+* Every rule the components apply lives in `sdk/address/`: line order is `formatAddress`'s and the
+* country name is `countryDisplayName`'s. The components only compose them.
+*/
+const fragment = `
+  fragment AccountAddressBookRootData on Query {
+    customerAddressBook {
+      __typename
+      id
+      addresses {
+        __typename
+        id
+      }
+    }
+  }
+`;
+const itemFragment = `
+  fragment AccountAddressBookItemData on Query {
+    customerAddressBook {
+      addresses {
+        __typename
+        id
+        country
+        recipientName
+        street
+        number
+        complement
+        neighborhood
+        city
+        state
+        postalCode
+        reference
+      }
+    }
+  }
+`;
+const AccountAddressBookContext = createContext(null);
+/** The resolved book and its state, for any part composed under `AccountAddressBookRoot`. */
+function useAccountAddressBook() {
+	const value = useContext(AccountAddressBookContext);
+	if (!value) throw new Error("Address book parts must be used inside an AccountAddressBookRoot.");
+	return value;
+}
+/** The book's context, or `null` outside a root: the form also stands alone, in add mode. */
+function useOptionalAccountAddressBook() {
+	return useContext(AccountAddressBookContext);
+}
+const AccountAddressBookItemContext = createContext(null);
+/**
+* The raw address an entry renders, with its alpha-3 `country`. Delete, edit and the deliverability
+* marker read this rather than the summary, whose country is already a display name.
+*/
+function useAccountAddressBookItem() {
+	const value = useContext(AccountAddressBookItemContext);
+	if (!value) throw new Error("Address book entry parts must be used inside an AccountAddressBookItem.");
+	return value;
+}
+/**
+* Each state gates on the resolved book, never on `loading` alone: `loading` is false on the first
+* client frame before the seed effect runs, and the book is null both while loading and after a
+* failure. So empty needs a book that resolved to zero addresses, and error needs no book and a
+* settled read that reported one.
+*/
+function resolveState({ book, loading, error }) {
+	if (book != null) return book.addresses.length === 0 ? "empty" : "ready";
+	if (loading) return "loading";
+	return error ? "error" : null;
+}
+const BOOK_SELECTOR = "[data-fs-account-address-book]";
+/**
+* Where focus goes once an overlay the book opened has closed: back to the control that opened it,
+* and, when a save or a removal took that control out of the document, to the book itself rather
+* than the page's top. `active` is true while the overlay is open; `remember` runs as it opens.
+*/
+function useFocusReturn(active) {
+	const target = useRef(null);
+	const remember = useCallback((opener) => {
+		target.current = {
+			opener,
+			root: opener?.closest(BOOK_SELECTOR) ?? null
+		};
+	}, []);
+	useEffect(() => {
+		if (active) return;
+		const current = target.current;
+		target.current = null;
+		if (!current) return;
+		const { opener, root } = current;
+		(opener?.isConnected ? opener : root)?.focus();
+	}, [active]);
+	return remember;
+}
+/**
+* The retry loads the book again in place through the page root's `refetch`. A root with none falls
+* back to reloading the page: the read changes nothing, so that is safe, and the page re-runs its
+* query.
+*/
+function reloadPage() {
+	globalThis.location.reload();
+}
+/**
+* A retry keeps the error part, and so its button, mounted while the book loads: focus stays on the
+* button, and the same button is offered again if the read fails again. `retrying` lasts as long as
+* the retry's own `refetch`, so a later load from another trigger is never read as this retry.
+* Once the book resolves, the list or the empty message replaces the button, so focus moves to the
+* book, but only when focus was inside the book at the retry and has fallen to the page's top since.
+* A failed read drops that mark.
+*/
+function useRetry(refetch, state) {
+	const [retrying, setRetrying] = useState(false);
+	const focusRoot = useRef(null);
+	const retry = useCallback(() => {
+		if (!refetch) {
+			reloadPage();
+			return;
+		}
+		const { activeElement } = document;
+		focusRoot.current = activeElement instanceof HTMLElement ? activeElement.closest(BOOK_SELECTOR) : null;
+		setRetrying(true);
+		refetch().catch(() => {}).finally(() => setRetrying(false));
+	}, [refetch]);
+	useEffect(() => {
+		if (state === "error") {
+			focusRoot.current = null;
+			return;
+		}
+		if (state !== "ready" && state !== "empty") return;
+		const root = focusRoot.current;
+		focusRoot.current = null;
+		const { activeElement } = document;
+		if (root && (!activeElement || activeElement === document.body)) root.focus();
+	}, [state]);
+	return {
+		retrying,
+		retry
+	};
+}
+function AccountAddressBookRoot({ $data: $dataProp, className, children, ...props }) {
+	const book = useDataOverride($dataProp) ?? null;
+	const { loading, error, refetch } = useContext(ReactiveRootContext);
+	const { state: sessionState } = useSession();
+	const state = resolveState({
+		book,
+		loading,
+		error
+	});
+	const [openForm, setOpenForm] = useState(null);
+	const [formPending, setFormPending] = useState(false);
+	const [pendingDelete, setPendingDelete] = useState(null);
+	const rememberFormOpener = useFocusReturn(openForm !== null);
+	const rememberDeleteOpener = useFocusReturn(pendingDelete !== null);
+	const { retrying, retry } = useRetry(refetch, state);
+	const open = useCallback((form, opener) => {
+		rememberFormOpener(opener);
+		setOpenForm(form);
+	}, [rememberFormOpener]);
+	const close = useCallback(() => setOpenForm(null), []);
+	const requestDelete = useCallback((address, opener) => {
+		rememberDeleteOpener(opener);
+		setPendingDelete(address);
+	}, [rememberDeleteOpener]);
+	const endDelete = useCallback(() => setPendingDelete(null), []);
+	const value = useMemo(() => ({
+		book,
+		state,
+		openForm,
+		open,
+		close,
+		formPending,
+		setFormPending,
+		pendingDelete,
+		requestDelete,
+		endDelete,
+		retrying,
+		retry
+	}), [
+		book,
+		state,
+		openForm,
+		open,
+		close,
+		formPending,
+		pendingDelete,
+		requestDelete,
+		endDelete,
+		retrying,
+		retry
+	]);
+	if (sessionState !== "loggedIn") return null;
+	return /* @__PURE__ */ jsx(AccountAddressBookContext, {
+		value,
+		children: /* @__PURE__ */ jsx("div", {
+			tabIndex: -1,
+			...props,
+			className,
+			"data-fs-account-address-book": "",
+			...state ? { "data-fs-account-address-book-state": state } : {},
+			children
+		})
+	});
+}
+function AccountAddressBookList({ className, children, ...props }) {
+	const { book } = useAccountAddressBook();
+	const addresses = book?.addresses ?? [];
+	if (addresses.length === 0) return null;
+	return /* @__PURE__ */ jsx("ul", {
+		...props,
+		className,
+		"data-fs-account-address-book-list": "",
+		children: addresses.map(({ id }) => /* @__PURE__ */ jsx("li", {
+			"data-fs-account-address-book-list-item": "",
+			children: /* @__PURE__ */ jsx(ListItemRefContext, {
+				value: {
+					__typename: "CustomerAddress",
+					id,
+					fallbackData: void 0
+				},
+				children
+			})
+		}, id))
+	});
+}
+function AccountAddressBookItem({ $data: $dataProp, className, children, ...props }) {
+	const slice = useDataOverride($dataProp) ?? null;
+	const { displayName } = useStorefrontFormatters();
+	if (!slice) return null;
+	const summary = {
+		recipientName: slice.recipientName,
+		street: slice.street,
+		number: slice.number,
+		complement: slice.complement,
+		neighborhood: slice.neighborhood,
+		city: slice.city,
+		state: slice.state,
+		postalCode: slice.postalCode,
+		reference: slice.reference,
+		country: countryDisplayName(slice.country, displayName)
+	};
+	return /* @__PURE__ */ jsx(AccountAddressBookItemContext, {
+		value: slice,
+		children: /* @__PURE__ */ jsx(AddressSummaryRoot, {
+			address: summary,
+			children: /* @__PURE__ */ jsx("div", {
+				...props,
+				className,
+				"data-fs-account-address-book-item": "",
+				children: children ?? /* @__PURE__ */ jsxs(AddressSummary, { children: [
+					/* @__PURE__ */ jsx(AddressSummaryRecipient, {}),
+					/* @__PURE__ */ jsx(AccountAddressBookItemLines, {}),
+					/* @__PURE__ */ jsx(AddressSummaryCountry, {})
+				] })
+			})
+		})
+	});
+}
+/** One `p` per line the address's country prints, each field in that country's order. */
+function AccountAddressBookItemLines({ className }) {
+	const address = useAccountAddressBookItem();
+	return /* @__PURE__ */ jsx(Fragment$1, { children: formatAddress(address, address.country ?? "").map((line) => /* @__PURE__ */ jsx("p", {
+		className,
+		"data-fs-account-address-book-line": "",
+		children: line.map(({ field, separator }) => /* @__PURE__ */ jsxs(Fragment, { children: [separator, /* @__PURE__ */ jsx(AddressSummaryField, { field })] }, field))
+	}, line.map(({ field }) => field).join())) });
+}
+/**
+* The polite live region stays mounted whether or not the book is loading, so the message is
+* announced when it lands (the region has to exist before its text does).
+*/
+function AccountAddressBookLoading({ message, className, children, ...props }) {
+	const { state } = useAccountAddressBook();
+	const intl = useIntl();
+	return /* @__PURE__ */ jsx("output", {
+		...props,
+		"aria-live": "polite",
+		className,
+		"data-fs-account-address-book-loading": "",
+		children: state === "loading" ? /* @__PURE__ */ jsxs(Fragment$1, { children: [children ?? /* @__PURE__ */ jsx(AccountAddressBookSkeleton, {}), /* @__PURE__ */ jsx("span", {
+			"data-fs-account-address-book-loading-message": "",
+			"data-fs-sr-only": "",
+			className: "sr-only",
+			children: resolveAuthoredCopy(message, intl.formatMessage({ id: "fs/address-book.loading" }))
+		})] }) : null
+	});
+}
+function AccountAddressBookEmpty({ message, className, ...props }) {
+	const { state } = useAccountAddressBook();
+	const intl = useIntl();
+	if (state !== "empty") return null;
+	return /* @__PURE__ */ jsx("p", {
+		...props,
+		className,
+		"data-fs-account-address-book-empty": "",
+		children: resolveAuthoredCopy(message, intl.formatMessage({ id: "fs/address-book.empty" }))
+	});
+}
+function AccountAddressBookError({ message, retryLabel, className, ...props }) {
+	const { state, retrying, retry } = useAccountAddressBook();
+	const intl = useIntl();
+	const busy = retrying && state === "loading";
+	if (state !== "error" && !busy) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		role: "alert",
+		className,
+		"data-fs-account-address-book-error": "",
+		children: [/* @__PURE__ */ jsx("p", {
+			"data-fs-account-address-book-error-message": "",
+			children: resolveAuthoredCopy(message, intl.formatMessage({ id: "fs/address-book.error" }))
+		}), /* @__PURE__ */ jsx(Button, {
+			type: "button",
+			onClick: busy ? void 0 : retry,
+			"aria-disabled": busy || void 0,
+			"aria-busy": busy || void 0,
+			"data-fs-account-address-book-retry": "",
+			children: resolveAuthoredCopy(retryLabel, intl.formatMessage({ id: "fs/address-book.retry" }))
+		})]
+	});
+}
+function AccountAddressBookSkeleton({ className, ...props }) {
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		className,
+		"aria-hidden": "true",
+		"data-fs-account-address-book-skeleton": "",
+		children: [
+			/* @__PURE__ */ jsx("span", { "data-fs-account-address-book-skeleton-line": "" }),
+			/* @__PURE__ */ jsx("span", { "data-fs-account-address-book-skeleton-line": "" }),
+			/* @__PURE__ */ jsx("span", { "data-fs-account-address-book-skeleton-line": "" })
+		]
+	});
+}
+const AccountAddressBookRootDefinition = defineComponent({
+	name: "AccountAddressBookRoot",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookRoot,
+	fragment,
+	fetchStrategy: "reactive",
+	requiresContext: "session",
+	providesContext: "account-address-book",
+	skeleton: AccountAddressBookSkeleton,
+	editor: {
+		label: "Account Address Book",
+		category: "identity"
+	},
+	schema: {},
+	guideline: "Root of the signed-in shopper's saved addresses: reads the address book once and owns its four states (loading, error, empty, ready), exposed as data-fs-account-address-book-state. Renders nothing unless the session is logged in, so it needs a SessionRoot ancestor. Compose AccountAddressBookLoading, AccountAddressBookError, AccountAddressBookEmpty and an AccountAddressBookList holding one AccountAddressBookItem, in any order. Reading the book starts no cart. See account-address-book.md."
+});
+const AccountAddressBookListDefinition = defineComponent({
+	name: "AccountAddressBookList",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookList,
+	requiresContext: "account-address-book",
+	editor: {
+		label: "Account Address Book List",
+		category: "content"
+	},
+	schema: {},
+	guideline: "The saved addresses as a list, one entry per address in the order the book returns them. Place one AccountAddressBookItem inside as the per-address template; it is repeated once per address. Renders nothing until the book has at least one address. Must be inside AccountAddressBookRoot."
+});
+const AccountAddressBookItemDefinition = defineComponent({
+	name: "AccountAddressBookItem",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookItem,
+	fragment: itemFragment,
+	fetchStrategy: "reactive-list-item",
+	requiresContext: "account-address-book",
+	providesContext: ["account-address-book-item", "address-summary"],
+	skeleton: AccountAddressBookSkeleton,
+	editor: {
+		label: "Account Address Book Item",
+		category: "content"
+	},
+	schema: {},
+	guideline: "One saved address, written the way its country writes it, with the recipient first and the country's name last. With no children it renders that default entry; give it children to compose the entry yourself, using the AddressSummary parts and AccountAddressBookItemLines. Provides the address-summary contract and the raw address for triggers placed inside it. Must be inside AccountAddressBookList."
+});
+const AccountAddressBookItemLinesDefinition = defineComponent({
+	name: "AccountAddressBookItemLines",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookItemLines,
+	requiresContext: "account-address-book-item",
+	editor: {
+		label: "Account Address Book Item Lines",
+		category: "content"
+	},
+	schema: {},
+	guideline: "The address's lines in its country's order, one paragraph per line with each field in sequence and its separator (a United States address reads number before street). A field the address lacks is dropped along with its separator. Must be inside AccountAddressBookItem."
+});
+const AccountAddressBookLoadingDefinition = defineComponent({
+	name: "AccountAddressBookLoading",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookLoading,
+	requiresContext: "account-address-book",
+	editor: {
+		label: "Account Address Book Loading",
+		category: "content"
+	},
+	schema: { message: {
+		type: "string",
+		label: "Loading message"
+	} },
+	guideline: "Shown only while the book is loading and has not resolved: a placeholder plus a loading message. The wrapper is a polite live region that stays mounted, and the message is visually hidden so it is heard and not seen. Pass children to replace the default placeholder. Must be inside AccountAddressBookRoot."
+});
+const AccountAddressBookEmptyDefinition = defineComponent({
+	name: "AccountAddressBookEmpty",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookEmpty,
+	requiresContext: "account-address-book",
+	editor: {
+		label: "Account Address Book Empty",
+		category: "content"
+	},
+	schema: { message: {
+		type: "string",
+		label: "Empty message"
+	} },
+	guideline: "Shown only once the book has resolved to zero addresses, never while it loads or after it fails, so it never invites the shopper to add an address they already have. Must be inside AccountAddressBookRoot."
+});
+const AccountAddressBookErrorDefinition = defineComponent({
+	name: "AccountAddressBookError",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookError,
+	requiresContext: "account-address-book",
+	editor: {
+		label: "Account Address Book Error",
+		category: "content"
+	},
+	schema: {
+		message: {
+			type: "string",
+			label: "Error message"
+		},
+		retryLabel: {
+			type: "string",
+			label: "Retry label"
+		}
+	},
+	guideline: "Shown when the book failed to load, as an alert with a retry control that loads the book again in place. Stays, with its retry disabled, while that retry loads. Never shown for a first load or an empty book. Must be inside AccountAddressBookRoot."
+});
+//#endregion
+export { AccountAddressBookEmpty, AccountAddressBookEmptyDefinition, AccountAddressBookError, AccountAddressBookErrorDefinition, AccountAddressBookItem, AccountAddressBookItemDefinition, AccountAddressBookItemLines, AccountAddressBookItemLinesDefinition, AccountAddressBookList, AccountAddressBookListDefinition, AccountAddressBookLoading, AccountAddressBookLoadingDefinition, AccountAddressBookRoot, AccountAddressBookRootDefinition, AccountAddressBookSkeleton, useAccountAddressBook, useAccountAddressBookItem, useOptionalAccountAddressBook };
+
+//# sourceMappingURL=account-address-book.js.map

package/dist/matter/account-address-book/account-address-book.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-book.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-book.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport {\n  type ComponentPropsWithRef,\n  createContext,\n  Fragment,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {\n  AddressSummary,\n  AddressSummaryCountry,\n  AddressSummaryField,\n  AddressSummaryRecipient,\n  AddressSummaryRoot,\n} from '../../particles/address-summary/address-summary.js';\nimport { Button } from '../../particles/button/button.js';\nimport { countryDisplayName } from '../../sdk/address/country-display.js';\nimport { formatAddress } from '../../sdk/address/format-address.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { ListItemRefContext } from '../../sdk/data/list-item-ref-context.js';\nimport { ReactiveRootContext } from '../../sdk/data/page-reactive-data-root.js';\nimport { useStorefrontFormatters } from '../../sdk/format/client.js';\nimport { useIntl } from '../../sdk/i18n/client.js';\nimport { resolveAuthoredCopy } from '../../utils/resolve-authored-copy.js';\nimport { useSession } from '../session/session.js';\n\n/**\n * The shopper's saved addresses, listed (specs/sfs-3440-address-book-list.md, RFC REQ-01). One family\n * split by data-fetch role, in the pattern `SavedCards` and `CartRoot` use:\n *\n * - `AccountAddressBookRoot` reads the book once through the page's reactive query, owns the four\n *   states, and gates on a signed-in session.\n * - `AccountAddressBookList` fans the addresses out by entity ref, one `li` per address.\n * - `AccountAddressBookItem` subscribes to its own `CustomerAddress` entity (`reactive-list-item`) and\n *   bridges it onto the generic `AddressSummary` particle.\n * - `Loading`, `Empty` and `Error` are composed parts, so a store chooses where each sits.\n *\n * Every rule the components apply lives in `sdk/address/`: line order is `formatAddress`'s and the\n * country name is `countryDisplayName`'s. The components only compose them.\n */\n\n// ---------------------------------------------------------------------------\n// GraphQL fragments — raw template literals, as `saved-cards.tsx` does: the codegen `documents` glob\n// does not scan `src/matter/account-address-book*`. Both drill `customerAddressBook` and merge at\n// compile time (ADR-0011/ADR-0012); `data-component-contract.test.ts` validates each against the real\n// schema. The book is an object with an `id` rather than a bare list under `Query`, which is the\n// shape the compiler can deliver per item.\n// ---------------------------------------------------------------------------\n\nconst fragment = /* GraphQL */ `\n  fragment AccountAddressBookRootData on Query {\n    customerAddressBook {\n      __typename\n      id\n      addresses {\n        __typename\n        id\n      }\n    }\n  }\n`;\n\nconst itemFragment = /* GraphQL */ `\n  fragment AccountAddressBookItemData on Query {\n    customerAddressBook {\n      addresses {\n        __typename\n        id\n        country\n        recipientName\n        street\n        number\n        complement\n        neighborhood\n        city\n        state\n        postalCode\n        reference\n      }\n    }\n  }\n`;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** The minimal per-address identifiers the root needs to iterate. */\nexport type AccountAddressBookRootSlice = Readonly<{\n  __typename?: 'CustomerAddressBook';\n  id: string;\n  addresses: readonly Readonly<{ __typename?: 'CustomerAddress'; id: string }>[];\n}>;\n\n/** The full per-address slice `AccountAddressBookItem` resolves on its own. */\nexport type AccountAddressBookItemSlice = Readonly<{\n  __typename?: 'CustomerAddress';\n  id: string;\n  country?: string | null;\n  recipientName?: string | null;\n  street?: string | null;\n  number?: string | null;\n  complement?: string | null;\n  neighborhood?: string | null;\n  city?: string | null;\n  state?: string | null;\n  postalCode?: string | null;\n  reference?: string | null;\n}>;\n\n/**\n * Where the book is. `null` is the frame before anything resolved, loaded, or failed: it shows\n * nothing, so no state is ever claimed that the data has not earned.\n */\nexport type AccountAddressBookState = 'loading' | 'error' | 'empty' | 'ready';\n\n/** The form the book has open. `address` is the item's raw slice, so the form can seed itself from it. */\nexport type AccountAddressBookOpenForm =\n  | Readonly<{ mode: 'add' }>\n  | Readonly<{ mode: 'edit'; address: AccountAddressBookItemSlice }>;\n\n/** The address a delete confirmation is open for. `null` when none is. */\nexport type AccountAddressBookPendingDelete = AccountAddressBookItemSlice | null;\n\nexport type AccountAddressBookContextValue = Readonly<{\n  book: AccountAddressBookRootSlice | null;\n  state: AccountAddressBookState | null;\n  openForm: AccountAddressBookOpenForm | null;\n  /** Opens a form, replacing any open one. `opener` is where focus returns when the form closes. */\n  open: (form: AccountAddressBookOpenForm, opener: HTMLElement | null) => void;\n  close: () => void;\n  /** True while the open form has a save in flight. The dialog stays open until it settles. */\n  formPending: boolean;\n  /** Reported by the open form as its save starts and settles. */\n  setFormPending: (pending: boolean) => void;\n  /** The address waiting for the shopper's answer to a delete confirmation, or `null`. */\n  pendingDelete: AccountAddressBookPendingDelete;\n  /** Asks for a confirmation. `opener` is where focus returns when it is declined. */\n  requestDelete: (address: AccountAddressBookItemSlice, opener: HTMLElement | null) => void;\n  endDelete: () => void;\n  /** True from an in-place retry until the book resolves. The error part stays mounted meanwhile. */\n  retrying: boolean;\n  /** Loads the book again: in place through the page root's `refetch`, else by reloading the page. */\n  retry: () => void;\n}>;\n\nexport type AccountAddressBookRootProps = ComponentPropsWithRef<'div'> & {\n  /** Unwrapped `customerAddressBook` from the reactive runtime (arity-1 fragment); `null` until resolved. */\n  $data?: AccountAddressBookRootSlice | null;\n};\n\nexport type AccountAddressBookListProps = ComponentPropsWithRef<'ul'>;\n\nexport type AccountAddressBookItemProps = ComponentPropsWithRef<'div'> & {\n  /** Per-address slice from the reactive-list-item runtime; passed directly in tests. */\n  $data?: AccountAddressBookItemSlice | null;\n};\n\nexport type AccountAddressBookItemLinesProps = Readonly<{ className?: string }>;\n\nexport type AccountAddressBookLoadingProps = ComponentPropsWithRef<'output'> & {\n  /** Announced while the book loads. A blank value falls back to the catalog copy. */\n  message?: string;\n};\n\nexport type AccountAddressBookEmptyProps = ComponentPropsWithRef<'p'> & {\n  /** Shown once the book resolved to zero addresses. A blank value falls back to the catalog copy. */\n  message?: string;\n};\n\nexport type AccountAddressBookErrorProps = ComponentPropsWithRef<'div'> & {\n  /** Shown when the read failed. A blank value falls back to the catalog copy. */\n  message?: string;\n  /** The retry control's label. A blank value falls back to the catalog copy. */\n  retryLabel?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Contexts\n// ---------------------------------------------------------------------------\n\nconst AccountAddressBookContext = createContext<AccountAddressBookContextValue | null>(null);\n\n/** The resolved book and its state, for any part composed under `AccountAddressBookRoot`. */\nexport function useAccountAddressBook(): AccountAddressBookContextValue {\n  const value = useContext(AccountAddressBookContext);\n  if (!value) {\n    throw new Error('Address book parts must be used inside an AccountAddressBookRoot.');\n  }\n  return value;\n}\n\n/** The book's context, or `null` outside a root: the form also stands alone, in add mode. */\nexport function useOptionalAccountAddressBook(): AccountAddressBookContextValue | null {\n  return useContext(AccountAddressBookContext);\n}\n\nconst AccountAddressBookItemContext = createContext<AccountAddressBookItemSlice | null>(null);\n\n/**\n * The raw address an entry renders, with its alpha-3 `country`. Delete, edit and the deliverability\n * marker read this rather than the summary, whose country is already a display name.\n */\nexport function useAccountAddressBookItem(): AccountAddressBookItemSlice {\n  const value = useContext(AccountAddressBookItemContext);\n  if (!value) {\n    throw new Error('Address book entry parts must be used inside an AccountAddressBookItem.');\n  }\n  return value;\n}\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\n/**\n * Each state gates on the resolved book, never on `loading` alone: `loading` is false on the first\n * client frame before the seed effect runs, and the book is null both while loading and after a\n * failure. So empty needs a book that resolved to zero addresses, and error needs no book and a\n * settled read that reported one.\n */\nfunction resolveState({\n  book,\n  loading,\n  error,\n}: {\n  book: AccountAddressBookRootSlice | null;\n  loading: boolean;\n  error: unknown;\n}): AccountAddressBookState | null {\n  if (book != null) return book.addresses.length === 0 ? 'empty' : 'ready';\n  if (loading) return 'loading';\n  return error ? 'error' : null;\n}\n\nconst BOOK_SELECTOR = '[data-fs-account-address-book]';\n\n/**\n * Where focus goes once an overlay the book opened has closed: back to the control that opened it,\n * and, when a save or a removal took that control out of the document, to the book itself rather\n * than the page's top. `active` is true while the overlay is open; `remember` runs as it opens.\n */\nfunction useFocusReturn(active: boolean): (opener: HTMLElement | null) => void {\n  const target = useRef<{ opener: HTMLElement | null; root: HTMLElement | null } | null>(null);\n\n  const remember = useCallback((opener: HTMLElement | null) => {\n    target.current = { opener, root: opener?.closest<HTMLElement>(BOOK_SELECTOR) ?? null };\n  }, []);\n\n  useEffect(() => {\n    if (active) return;\n    const current = target.current;\n    target.current = null;\n    if (!current) return;\n    const { opener, root } = current;\n    (opener?.isConnected ? opener : root)?.focus();\n  }, [active]);\n\n  return remember;\n}\n\n/**\n * The retry loads the book again in place through the page root's `refetch`. A root with none falls\n * back to reloading the page: the read changes nothing, so that is safe, and the page re-runs its\n * query.\n */\nfunction reloadPage() {\n  globalThis.location.reload();\n}\n\n/**\n * A retry keeps the error part, and so its button, mounted while the book loads: focus stays on the\n * button, and the same button is offered again if the read fails again. `retrying` lasts as long as\n * the retry's own `refetch`, so a later load from another trigger is never read as this retry.\n * Once the book resolves, the list or the empty message replaces the button, so focus moves to the\n * book, but only when focus was inside the book at the retry and has fallen to the page's top since.\n * A failed read drops that mark.\n */\nfunction useRetry(refetch: (() => Promise<void>) | undefined, state: AccountAddressBookState | null) {\n  const [retrying, setRetrying] = useState(false);\n  const focusRoot = useRef<HTMLElement | null>(null);\n\n  const retry = useCallback(() => {\n    if (!refetch) {\n      reloadPage();\n      return;\n    }\n    const { activeElement } = document;\n    focusRoot.current = activeElement instanceof HTMLElement ? activeElement.closest<HTMLElement>(BOOK_SELECTOR) : null;\n    setRetrying(true);\n    refetch()\n      .catch(() => {\n        // A provider's own `refetch` may reject. The book's error state already shows the failure.\n      })\n      .finally(() => setRetrying(false));\n  }, [refetch]);\n\n  useEffect(() => {\n    if (state === 'error') {\n      focusRoot.current = null;\n      return;\n    }\n    if (state !== 'ready' && state !== 'empty') return;\n    const root = focusRoot.current;\n    focusRoot.current = null;\n    const { activeElement } = document;\n    if (root && (!activeElement || activeElement === document.body)) root.focus();\n  }, [state]);\n\n  return { retrying, retry };\n}\n\nexport function AccountAddressBookRoot({\n  $data: $dataProp,\n  className,\n  children,\n  ...props\n}: AccountAddressBookRootProps) {\n  const $data = useDataOverride<AccountAddressBookRootSlice | null | undefined>($dataProp);\n  const book = $data ?? null;\n  const { loading, error, refetch } = useContext(ReactiveRootContext);\n  const { state: sessionState } = useSession();\n  const state = resolveState({ book, loading, error });\n  const [openForm, setOpenForm] = useState<AccountAddressBookOpenForm | null>(null);\n  const [formPending, setFormPending] = useState(false);\n  const [pendingDelete, setPendingDelete] = useState<AccountAddressBookPendingDelete>(null);\n  const rememberFormOpener = useFocusReturn(openForm !== null);\n  const rememberDeleteOpener = useFocusReturn(pendingDelete !== null);\n  const { retrying, retry } = useRetry(refetch, state);\n\n  const open = useCallback(\n    (form: AccountAddressBookOpenForm, opener: HTMLElement | null) => {\n      rememberFormOpener(opener);\n      setOpenForm(form);\n    },\n    [rememberFormOpener],\n  );\n  const close = useCallback(() => setOpenForm(null), []);\n\n  const requestDelete = useCallback(\n    (address: AccountAddressBookItemSlice, opener: HTMLElement | null) => {\n      rememberDeleteOpener(opener);\n      setPendingDelete(address);\n    },\n    [rememberDeleteOpener],\n  );\n  const endDelete = useCallback(() => setPendingDelete(null), []);\n\n  const value = useMemo(\n    () => ({\n      book,\n      state,\n      openForm,\n      open,\n      close,\n      formPending,\n      setFormPending,\n      pendingDelete,\n      requestDelete,\n      endDelete,\n      retrying,\n      retry,\n    }),\n    [book, state, openForm, open, close, formPending, pendingDelete, requestDelete, endDelete, retrying, retry],\n  );\n\n  if (sessionState !== 'loggedIn') return null;\n\n  return (\n    <AccountAddressBookContext value={value}>\n      <div\n        tabIndex={-1}\n        {...props}\n        className={className}\n        data-fs-account-address-book=\"\"\n        {...(state ? { 'data-fs-account-address-book-state': state } : {})}\n      >\n        {children}\n      </div>\n    </AccountAddressBookContext>\n  );\n}\n\nexport function AccountAddressBookList({ className, children, ...props }: AccountAddressBookListProps) {\n  const { book } = useAccountAddressBook();\n  const addresses = book?.addresses ?? [];\n\n  if (addresses.length === 0) return null;\n\n  return (\n    <ul {...props} className={className} data-fs-account-address-book-list=\"\">\n      {addresses.map(({ id }) => (\n        <li key={id} data-fs-account-address-book-list-item=\"\">\n          <ListItemRefContext\n            // No fallback slice: the root's fragment selects only `{ id }`, so there is no complete\n            // row to fall back to. An incomplete cache slice renders nothing until it resolves.\n            value={{ __typename: 'CustomerAddress', id, fallbackData: undefined }}\n          >\n            {children}\n          </ListItemRefContext>\n        </li>\n      ))}\n    </ul>\n  );\n}\n\nexport function AccountAddressBookItem({\n  $data: $dataProp,\n  className,\n  children,\n  ...props\n}: AccountAddressBookItemProps) {\n  // Delivery-agnostic: the slice arrives through the DataOverrideContext seam the reactive-list-item\n  // wrapper publishes (or via $data in tests); this component calls no data hook of its own.\n  const slice = useDataOverride<AccountAddressBookItemSlice | null | undefined>($dataProp) ?? null;\n  const { displayName } = useStorefrontFormatters();\n\n  if (!slice) return null;\n\n  // The summary shows a name, the raw slice keeps the code, and an address carries no name of its own.\n  const summary = {\n    recipientName: slice.recipientName,\n    street: slice.street,\n    number: slice.number,\n    complement: slice.complement,\n    neighborhood: slice.neighborhood,\n    city: slice.city,\n    state: slice.state,\n    postalCode: slice.postalCode,\n    reference: slice.reference,\n    country: countryDisplayName(slice.country, displayName),\n  };\n\n  return (\n    <AccountAddressBookItemContext value={slice}>\n      <AddressSummaryRoot address={summary}>\n        <div {...props} className={className} data-fs-account-address-book-item=\"\">\n          {children ?? (\n            <AddressSummary>\n              <AddressSummaryRecipient />\n              <AccountAddressBookItemLines />\n              <AddressSummaryCountry />\n            </AddressSummary>\n          )}\n        </div>\n      </AddressSummaryRoot>\n    </AccountAddressBookItemContext>\n  );\n}\n\n/** One `p` per line the address's country prints, each field in that country's order. */\nexport function AccountAddressBookItemLines({ className }: AccountAddressBookItemLinesProps) {\n  const address = useAccountAddressBookItem();\n\n  return (\n    <>\n      {formatAddress(address, address.country ?? '').map((line) => (\n        <p key={line.map(({ field }) => field).join()} className={className} data-fs-account-address-book-line=\"\">\n          {line.map(({ field, separator }) => (\n            <Fragment key={field}>\n              {separator}\n              <AddressSummaryField field={field} />\n            </Fragment>\n          ))}\n        </p>\n      ))}\n    </>\n  );\n}\n\n/**\n * The polite live region stays mounted whether or not the book is loading, so the message is\n * announced when it lands (the region has to exist before its text does).\n */\nexport function AccountAddressBookLoading({ message, className, children, ...props }: AccountAddressBookLoadingProps) {\n  const { state } = useAccountAddressBook();\n  const intl = useIntl();\n\n  return (\n    <output {...props} aria-live=\"polite\" className={className} data-fs-account-address-book-loading=\"\">\n      {state === 'loading' ? (\n        <>\n          {children ?? <AccountAddressBookSkeleton />}\n          <span data-fs-account-address-book-loading-message=\"\" data-fs-sr-only=\"\" className=\"sr-only\">\n            {resolveAuthoredCopy(message, intl.formatMessage({ id: 'fs/address-book.loading' }))}\n          </span>\n        </>\n      ) : null}\n    </output>\n  );\n}\n\nexport function AccountAddressBookEmpty({ message, className, ...props }: AccountAddressBookEmptyProps) {\n  const { state } = useAccountAddressBook();\n  const intl = useIntl();\n\n  if (state !== 'empty') return null;\n\n  return (\n    <p {...props} className={className} data-fs-account-address-book-empty=\"\">\n      {resolveAuthoredCopy(message, intl.formatMessage({ id: 'fs/address-book.empty' }))}\n    </p>\n  );\n}\n\nexport function AccountAddressBookError({ message, retryLabel, className, ...props }: AccountAddressBookErrorProps) {\n  const { state, retrying, retry } = useAccountAddressBook();\n  const intl = useIntl();\n  const busy = retrying && state === 'loading';\n\n  if (state !== 'error' && !busy) return null;\n\n  return (\n    <div {...props} role=\"alert\" className={className} data-fs-account-address-book-error=\"\">\n      <p data-fs-account-address-book-error-message=\"\">\n        {resolveAuthoredCopy(message, intl.formatMessage({ id: 'fs/address-book.error' }))}\n      </p>\n      {/* `aria-disabled`, not `disabled`: a disabled button loses focus, and the shopper's is on it. */}\n      <Button\n        type=\"button\"\n        onClick={busy ? undefined : retry}\n        aria-disabled={busy || undefined}\n        aria-busy={busy || undefined}\n        data-fs-account-address-book-retry=\"\"\n      >\n        {resolveAuthoredCopy(retryLabel, intl.formatMessage({ id: 'fs/address-book.retry' }))}\n      </Button>\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Skeleton — no context: `AccountAddressBookLoading` renders it before the root has anything to\n// provide, and the definitions reference it for the lint rule that asks every fetching component\n// for one. The compiler does not render it on the reactive path.\n// ---------------------------------------------------------------------------\n\nexport function AccountAddressBookSkeleton({ className, ...props }: ComponentPropsWithRef<'div'>) {\n  return (\n    <div {...props} className={className} aria-hidden=\"true\" data-fs-account-address-book-skeleton=\"\">\n      <span data-fs-account-address-book-skeleton-line=\"\" />\n      <span data-fs-account-address-book-skeleton-line=\"\" />\n      <span data-fs-account-address-book-skeleton-line=\"\" />\n    </div>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const AccountAddressBookRootDefinition = defineComponent<AccountAddressBookRootProps>({\n  name: 'AccountAddressBookRoot',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  requiresContext: 'session',\n  providesContext: 'account-address-book',\n  skeleton: AccountAddressBookSkeleton,\n  editor: { label: 'Account Address Book', category: 'identity' },\n  schema: {},\n  guideline:\n    \"Root of the signed-in shopper's saved addresses: reads the address book once and owns its four states (loading, error, empty, ready), exposed as data-fs-account-address-book-state. Renders nothing unless the session is logged in, so it needs a SessionRoot ancestor. Compose AccountAddressBookLoading, AccountAddressBookError, AccountAddressBookEmpty and an AccountAddressBookList holding one AccountAddressBookItem, in any order. Reading the book starts no cart. See account-address-book.md.\",\n});\n\nexport const AccountAddressBookListDefinition = defineComponent<AccountAddressBookListProps>({\n  name: 'AccountAddressBookList',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookList,\n  requiresContext: 'account-address-book',\n  editor: { label: 'Account Address Book List', category: 'content' },\n  schema: {},\n  guideline:\n    'The saved addresses as a list, one entry per address in the order the book returns them. Place one AccountAddressBookItem inside as the per-address template; it is repeated once per address. Renders nothing until the book has at least one address. Must be inside AccountAddressBookRoot.',\n});\n\nexport const AccountAddressBookItemDefinition = defineComponent<AccountAddressBookItemProps>({\n  name: 'AccountAddressBookItem',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookItem,\n  fragment: itemFragment,\n  fetchStrategy: 'reactive-list-item',\n  requiresContext: 'account-address-book',\n  providesContext: ['account-address-book-item', 'address-summary'],\n  skeleton: AccountAddressBookSkeleton,\n  editor: { label: 'Account Address Book Item', category: 'content' },\n  schema: {},\n  guideline:\n    \"One saved address, written the way its country writes it, with the recipient first and the country's name last. With no children it renders that default entry; give it children to compose the entry yourself, using the AddressSummary parts and AccountAddressBookItemLines. Provides the address-summary contract and the raw address for triggers placed inside it. Must be inside AccountAddressBookList.\",\n});\n\nexport const AccountAddressBookItemLinesDefinition = defineComponent<AccountAddressBookItemLinesProps>({\n  name: 'AccountAddressBookItemLines',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookItemLines,\n  requiresContext: 'account-address-book-item',\n  editor: { label: 'Account Address Book Item Lines', category: 'content' },\n  schema: {},\n  guideline:\n    \"The address's lines in its country's order, one paragraph per line with each field in sequence and its separator (a United States address reads number before street). A field the address lacks is dropped along with its separator. Must be inside AccountAddressBookItem.\",\n});\n\nexport const AccountAddressBookLoadingDefinition = defineComponent<AccountAddressBookLoadingProps>({\n  name: 'AccountAddressBookLoading',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookLoading,\n  requiresContext: 'account-address-book',\n  editor: { label: 'Account Address Book Loading', category: 'content' },\n  schema: {\n    message: { type: 'string', label: 'Loading message' },\n  },\n  guideline:\n    'Shown only while the book is loading and has not resolved: a placeholder plus a loading message. The wrapper is a polite live region that stays mounted, and the message is visually hidden so it is heard and not seen. Pass children to replace the default placeholder. Must be inside AccountAddressBookRoot.',\n});\n\nexport const AccountAddressBookEmptyDefinition = defineComponent<AccountAddressBookEmptyProps>({\n  name: 'AccountAddressBookEmpty',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookEmpty,\n  requiresContext: 'account-address-book',\n  editor: { label: 'Account Address Book Empty', category: 'content' },\n  schema: {\n    message: { type: 'string', label: 'Empty message' },\n  },\n  guideline:\n    'Shown only once the book has resolved to zero addresses, never while it loads or after it fails, so it never invites the shopper to add an address they already have. Must be inside AccountAddressBookRoot.',\n});\n\nexport const AccountAddressBookErrorDefinition = defineComponent<AccountAddressBookErrorProps>({\n  name: 'AccountAddressBookError',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookError,\n  requiresContext: 'account-address-book',\n  editor: { label: 'Account Address Book Error', category: 'content' },\n  schema: {\n    message: { type: 'string', label: 'Error message' },\n    retryLabel: { type: 'string', label: 'Retry label' },\n  },\n  guideline:\n    'Shown when the book failed to load, as an alert with a retry control that loads the book again in place. Stays, with its retry disabled, while that retry loads. Never shown for a first load or an empty book. Must be inside AccountAddressBookRoot.',\n});\n"],"mappings":"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"}

package/dist/matter/account-address-book/account-address-country-switch.js

@@ -0,0 +1,59 @@
+import { isCountryField } from "../../sdk/address/constants.js";
+import { resolveLabelId } from "../../sdk/address/messages.js";
+import { addressFields } from "../../sdk/address/address-fields.js";
+import { switchCountry } from "../../sdk/address/switch-country.js";
+//#region src/matter/account-address-book/account-address-country-switch.ts
+function isBlank(value) {
+	return value === null || value === void 0 || value.trim() === "";
+}
+/**
+* The country a new address starts in: the preferred one when the store ships there or the list is
+* unknown, else the first country of the list, in the platform's order. `defaultCountry` comes
+* trimmed and upper-cased.
+*/
+function initialAddressCountry(countries, defaultCountry) {
+	if (!countries || countries.includes(defaultCountry)) return defaultCountry;
+	return countries[0] ?? defaultCountry;
+}
+/**
+* Applies a country switch to the draft. What the new country cannot take is kept for the old one,
+* and what was kept for the new one comes back in every field the switch leaves empty, when it
+* passes the new country's rules with the rest of the draft: a city returns with its state. The
+* change lists the draft's values that stayed behind, with the old country's labels.
+*/
+function applyCountrySwitch({ draft, aside, from, to }) {
+	const stored = aside[to.country] ?? {};
+	const carried = switchCountry(draft, from, to);
+	const offered = Object.keys(stored).filter((name) => !isBlank(stored[name]) && isBlank(carried.values[name]));
+	const { values } = switchCountry({
+		...draft,
+		...Object.fromEntries(offered.map((name) => [name, stored[name]]))
+	}, from, to);
+	const next = {};
+	for (const [name, value] of Object.entries(values)) if (name !== "name") next[name] = value;
+	const left = (name, value) => values[name] !== value;
+	const labels = new Map(addressFields(from, draft).map(({ name, labelId }) => [name, labelId]));
+	return {
+		draft: next,
+		aside: {
+			...aside,
+			[from.country]: Object.fromEntries(Object.entries(carried.setAside).filter(([name, value]) => left(name, value))),
+			[to.country]: Object.fromEntries(Object.entries(stored).filter(([name, value]) => left(name, value)))
+		},
+		change: {
+			from: from.country,
+			to: to.country,
+			notCarried: carried.notCarried.flatMap((field) => {
+				if (!isCountryField(field) || !left(field, draft[field])) return [];
+				return [{
+					field,
+					labelId: labels.get(field) ?? resolveLabelId("", field, from.country)
+				}];
+			})
+		}
+	};
+}
+//#endregion
+export { applyCountrySwitch, initialAddressCountry };
+
+//# sourceMappingURL=account-address-country-switch.js.map

package/dist/matter/account-address-book/account-address-country-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-country-switch.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-country-switch.ts"],"sourcesContent":["import { addressFields } from '../../sdk/address/address-fields.js';\nimport { isCountryField } from '../../sdk/address/constants.js';\nimport { resolveLabelId } from '../../sdk/address/messages.js';\nimport { switchCountry } from '../../sdk/address/switch-country.js';\nimport type { AddressFieldName, AddressValues, CountryRules } from '../../sdk/address/types.js';\nimport type { MessageId } from '../../sdk/i18n/client.js';\nimport type {\n  AccountAddressCountryChange,\n  AccountAddressFormDraft,\n  EditableField,\n} from './account-address-form-context.js';\n\n/** The values each country's switch set aside, by ISO 3166-1 alpha-3. Never sent. */\nexport type AddressCountryMemory = Readonly<Record<string, AddressValues>>;\n\ntype CountrySwitchInput = Readonly<{\n  draft: AccountAddressFormDraft;\n  aside: AddressCountryMemory;\n  from: CountryRules;\n  to: CountryRules;\n}>;\n\ntype CountrySwitchResult = Readonly<{\n  draft: AccountAddressFormDraft;\n  aside: AddressCountryMemory;\n  change: AccountAddressCountryChange;\n}>;\n\nfunction isBlank(value: string | null | undefined): boolean {\n  return value === null || value === undefined || value.trim() === '';\n}\n\n/**\n * The country a new address starts in: the preferred one when the store ships there or the list is\n * unknown, else the first country of the list, in the platform's order. `defaultCountry` comes\n * trimmed and upper-cased.\n */\nexport function initialAddressCountry(countries: readonly string[] | null, defaultCountry: string): string {\n  if (!countries || countries.includes(defaultCountry)) return defaultCountry;\n  return countries[0] ?? defaultCountry;\n}\n\n/**\n * Applies a country switch to the draft. What the new country cannot take is kept for the old one,\n * and what was kept for the new one comes back in every field the switch leaves empty, when it\n * passes the new country's rules with the rest of the draft: a city returns with its state. The\n * change lists the draft's values that stayed behind, with the old country's labels.\n */\nexport function applyCountrySwitch({ draft, aside, from, to }: CountrySwitchInput): CountrySwitchResult {\n  const stored = aside[to.country] ?? {};\n  const carried = switchCountry(draft, from, to);\n  const offered = (Object.keys(stored) as AddressFieldName[]).filter(\n    (name) => !isBlank(stored[name]) && isBlank(carried.values[name]),\n  );\n  const { values } = switchCountry(\n    { ...draft, ...Object.fromEntries(offered.map((name) => [name, stored[name]])) },\n    from,\n    to,\n  );\n\n  const next: Partial<Record<EditableField, string>> = {};\n  for (const [name, value] of Object.entries(values) as [AddressFieldName, string][]) {\n    if (name !== 'name') next[name] = value;\n  }\n\n  const left = (name: AddressFieldName, value: string | null | undefined) => values[name] !== value;\n  const labels = new Map(addressFields(from, draft).map(({ name, labelId }) => [name, labelId]));\n\n  return {\n    draft: next,\n    aside: {\n      ...aside,\n      [from.country]: Object.fromEntries(\n        Object.entries(carried.setAside).filter(([name, value]) => left(name as AddressFieldName, value)),\n      ),\n      [to.country]: Object.fromEntries(\n        Object.entries(stored).filter(([name, value]) => left(name as AddressFieldName, value)),\n      ),\n    },\n    change: {\n      from: from.country,\n      to: to.country,\n      notCarried: carried.notCarried.flatMap((field) => {\n        if (!isCountryField(field) || !left(field, draft[field])) return [];\n        const labelId: MessageId = labels.get(field) ?? resolveLabelId('', field, from.country);\n        return [{ field, labelId }];\n      }),\n    },\n  };\n}\n"],"mappings":";;;;;AA4BA,SAAS,QAAQ,OAA2C;CAC1D,OAAO,UAAU,QAAQ,UAAU,KAAA,KAAa,MAAM,KAAK,MAAM;AACnE;;;;;;AAOA,SAAgB,sBAAsB,WAAqC,gBAAgC;CACzG,IAAI,CAAC,aAAa,UAAU,SAAS,cAAc,GAAG,OAAO;CAC7D,OAAO,UAAU,MAAM;AACzB;;;;;;;AAQA,SAAgB,mBAAmB,EAAE,OAAO,OAAO,MAAM,MAA+C;CACtG,MAAM,SAAS,MAAM,GAAG,YAAY,CAAC;CACrC,MAAM,UAAU,cAAc,OAAO,MAAM,EAAE;CAC7C,MAAM,UAAW,OAAO,KAAK,MAAM,CAAC,CAAwB,QACzD,SAAS,CAAC,QAAQ,OAAO,KAAK,KAAK,QAAQ,QAAQ,OAAO,KAAK,CAClE;CACA,MAAM,EAAE,WAAW,cACjB;EAAE,GAAG;EAAO,GAAG,OAAO,YAAY,QAAQ,KAAK,SAAS,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;CAAE,GAC/E,MACA,EACF;CAEA,MAAM,OAA+C,CAAC;CACtD,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,GAC/C,IAAI,SAAS,QAAQ,KAAK,QAAQ;CAGpC,MAAM,QAAQ,MAAwB,UAAqC,OAAO,UAAU;CAC5F,MAAM,SAAS,IAAI,IAAI,cAAc,MAAM,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,cAAc,CAAC,MAAM,OAAO,CAAC,CAAC;CAE7F,OAAO;EACL,OAAO;EACP,OAAO;GACL,GAAG;IACF,KAAK,UAAU,OAAO,YACrB,OAAO,QAAQ,QAAQ,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,WAAW,KAAK,MAA0B,KAAK,CAAC,CAClG;IACC,GAAG,UAAU,OAAO,YACnB,OAAO,QAAQ,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,WAAW,KAAK,MAA0B,KAAK,CAAC,CACxF;EACF;EACA,QAAQ;GACN,MAAM,KAAK;GACX,IAAI,GAAG;GACP,YAAY,QAAQ,WAAW,SAAS,UAAU;IAChD,IAAI,CAAC,eAAe,KAAK,KAAK,CAAC,KAAK,OAAO,MAAM,MAAM,GAAG,OAAO,CAAC;IAElE,OAAO,CAAC;KAAE;KAAO,SADU,OAAO,IAAI,KAAK,KAAK,eAAe,IAAI,OAAO,KAAK,OAAO;IAC7D,CAAC;GAC5B,CAAC;EACH;CACF;AACF"}

package/dist/matter/account-address-book/account-address-country.d.ts

@@ -0,0 +1,36 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+//#region src/matter/account-address-book/account-address-country.d.ts
+/** The shipping countries the control reads. `countries` is ISO 3166-1 alpha-3, in the platform's order. */
+export type AddressCountryControlSlice = Readonly<{
+  countries: readonly string[];
+  source: 'PLATFORM' | 'SALES_CHANNEL_FALLBACK';
+}>;
+export type AddressCountryControlProps = Readonly<{
+  /** Unwrapped `shippingCountries` from the reactive runtime: `null` when the read failed, absent outside the page query. */
+  $data?: AddressCountryControlSlice | null;
+  /** The select's label. A blank value falls back to the catalog copy. */
+  label?: string;
+  className?: string;
+}>;
+export type AccountAddressCountryNoticeProps = Readonly<{
+  /** Replaces the whole sentence, with the same ICU arguments. A blank value falls back to the catalog copy. */
+  message?: string;
+  className?: string;
+}>;
+export declare const AddressCountryControlDefinition: ComponentDefinition<Readonly<{
+  /** Unwrapped `shippingCountries` from the reactive runtime: `null` when the read failed, absent outside the page query. */
+  $data?: AddressCountryControlSlice | null;
+  /** The select's label. A blank value falls back to the catalog copy. */
+  label?: string;
+  className?: string;
+}>>;
+export declare const AccountAddressCountryNoticeDefinition: ComponentDefinition<Readonly<{
+  /** Replaces the whole sentence, with the same ICU arguments. A blank value falls back to the catalog copy. */
+  message?: string;
+  className?: string;
+}>>;
+export declare function AddressCountryControl({ $data: $dataProp, label, className }: AddressCountryControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressCountryNotice({ message, className }: AccountAddressCountryNoticeProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=account-address-country.d.ts.map