@vtex/faststore 0.0.7 → 0.0.10

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

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

@@ -0,0 +1,151 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { useStorefrontContext } from "../../sdk/context/storefront-context.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 { countryDisplayName } from "../../sdk/address/country-display.js";
+import { AccountAddressBookSkeleton } from "./account-address-book.js";
+import { Select } from "../../particles/select/select.js";
+import { useAccountAddressForm } from "./account-address-form-context.js";
+import { useEffect, useMemo } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+const AddressCountryControlDefinition = defineComponent({
+	name: "AddressCountryControl",
+	importPath: "@vtex/faststore/components",
+	component: AddressCountryControl,
+	fragment: `
+  fragment AddressCountryControlData on Query {
+    shippingCountries {
+      countries
+      source
+    }
+  }
+`,
+	fetchStrategy: "reactive",
+	requiresContext: "account-address-form",
+	skeleton: AccountAddressBookSkeleton,
+	editor: {
+		label: "Address Country Control",
+		category: "input"
+	},
+	schema: { label: {
+		type: "string",
+		label: "Field label"
+	} },
+	guideline: "The country of the address. A new address picks it from the countries the store ships to, in a list sorted by name, when there are two or more; with one it shows nothing, and the address takes that country. A saved address keeps its country, shown as text, and so does a new one when the list could not be read. Changing it keeps the fields the new country takes, and brings back what was typed for that country before. Compose it explicitly under AccountAddressFormRoot to offer the choice: in the root's default composition it gets no list and shows the root's defaultCountry as text. Place AccountAddressCountryNotice next to it. Must be inside AccountAddressFormRoot."
+});
+const AccountAddressCountryNoticeDefinition = defineComponent({
+	name: "AccountAddressCountryNotice",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressCountryNotice,
+	requiresContext: "account-address-form",
+	editor: {
+		label: "Account Address Country Notice",
+		category: "content"
+	},
+	schema: { message: {
+		type: "string",
+		label: "Notice message"
+	} },
+	guideline: "Says which fields a country change left behind, and that they come back on switching back. Announced politely, and empty until a change leaves something behind. The message takes count, country, previous and fields as ICU arguments. Place it right after AddressCountryControl. Must be inside AccountAddressFormRoot."
+});
+function AddressCountryControl({ $data: $dataProp, label, className }) {
+	const slice = useDataOverride($dataProp);
+	const { mode, country, pending, countryChoice: { offer, selected, change } } = useAccountAddressForm();
+	const { displayName } = useStorefrontFormatters();
+	const { locale } = useStorefrontContext();
+	const intl = useIntl();
+	const countries = slice?.countries ?? null;
+	const reported = countries?.join(",") ?? null;
+	useEffect(() => offer(reported === null ? null : reported.split(",").filter(Boolean)), [offer, reported]);
+	const options = useMemo(() => {
+		const collator = new Intl.Collator(locale);
+		return (countries ?? []).map((code) => ({
+			value: code,
+			label: countryDisplayName(code, displayName) ?? code
+		})).sort((a, b) => collator.compare(a.label, b.label));
+	}, [
+		countries,
+		locale,
+		displayName
+	]);
+	const wrapper = {
+		className,
+		"data-fs-address-country-control": "",
+		...selected !== country ? { "data-fs-address-country-control-pending": "" } : {}
+	};
+	if (mode === "add" && countries?.length === 1) return null;
+	if (mode === "add" && countries && countries.length > 1) return /* @__PURE__ */ jsx("div", {
+		...wrapper,
+		"data-fs-address-country-control-mode": "select",
+		children: /* @__PURE__ */ jsxs(Select.Root, {
+			value: selected,
+			disabled: pending,
+			onValueChange: (value) => value && change(value),
+			children: [
+				/* @__PURE__ */ jsx(Select.Label, { children: resolveAuthoredCopy(label, intl.formatMessage({ id: "fs/address-form.country" })) }),
+				/* @__PURE__ */ jsxs(Select.Trigger, {
+					"data-fs-account-address-form-control": "",
+					disabled: pending,
+					children: [/* @__PURE__ */ jsx(Select.Value, { children: (value) => options.find((option) => option.value === value)?.label ?? countryDisplayName(value, displayName) ?? value }), /* @__PURE__ */ jsx(Select.Icon, {})]
+				}),
+				/* @__PURE__ */ jsx(Select.Portal, { children: /* @__PURE__ */ jsx(Select.Positioner, { children: /* @__PURE__ */ jsx(Select.Popup, { children: /* @__PURE__ */ jsx(Select.List, { children: options.map((option) => /* @__PURE__ */ jsx(Select.Item, {
+					value: option.value,
+					label: option.label,
+					children: /* @__PURE__ */ jsx(Select.ItemText, { children: option.label })
+				}, option.value)) }) }) }) })
+			]
+		})
+	});
+	const name = countryDisplayName(country, displayName);
+	if (!name) return null;
+	return /* @__PURE__ */ jsx("div", {
+		...wrapper,
+		"data-fs-address-country-control-mode": "text",
+		children: /* @__PURE__ */ jsx("p", {
+			"data-fs-address-country-control-text": "",
+			children: name
+		})
+	});
+}
+function describeChange({ change, message, intl, formatters }) {
+	if (!change || change.notCarried.length === 0) return "";
+	const { displayName, formatList } = formatters;
+	const values = {
+		count: change.notCarried.length,
+		country: countryDisplayName(change.to, displayName) ?? change.to,
+		previous: countryDisplayName(change.from, displayName) ?? change.from,
+		fields: formatList(change.notCarried.map(({ labelId }) => intl.formatMessage({ id: labelId })))
+	};
+	const fallback = intl.formatMessage({ id: "fs/address-form.country-notice" }, values);
+	const authored = resolveAuthoredCopy(message, "");
+	if (!authored) return fallback;
+	try {
+		return String(intl.formatters.getMessageFormat(authored, intl.locale).format(values));
+	} catch {
+		return fallback;
+	}
+}
+function AccountAddressCountryNotice({ message, className }) {
+	const { countryChoice: { lastChange } } = useAccountAddressForm();
+	const intl = useIntl();
+	const formatters = useStorefrontFormatters();
+	return /* @__PURE__ */ jsx("output", {
+		"aria-live": "polite",
+		className,
+		"data-fs-account-address-country-notice": "",
+		children: describeChange({
+			change: lastChange,
+			message,
+			intl,
+			formatters
+		})
+	});
+}
+//#endregion
+export { AccountAddressCountryNotice, AccountAddressCountryNoticeDefinition, AddressCountryControl, AddressCountryControlDefinition };
+
+//# sourceMappingURL=account-address-country.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-country.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-country.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { useEffect, useMemo } from 'react';\nimport { Select } from '../../particles/select/select.js';\nimport { countryDisplayName } from '../../sdk/address/country-display.js';\nimport { useStorefrontContext } from '../../sdk/context/storefront-context.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { useStorefrontFormatters } from '../../sdk/format/client.js';\nimport { useIntl } from '../../sdk/i18n/client.js';\nimport { resolveAuthoredCopy } from '../../utils/resolve-authored-copy.js';\nimport { AccountAddressBookSkeleton } from './account-address-book.js';\nimport { type AccountAddressCountryChange, useAccountAddressForm } from './account-address-form-context.js';\n\n/**\n * The country of a new address, chosen from where the store ships, and the notice that says what a switch\n * left behind. The control reads `shippingCountries` through its own fragment and reports the list to the\n * form, which owns the country, the switch and the values set aside. Neither part touches the draft.\n */\n\nconst fragment = /* GraphQL */ `\n  fragment AddressCountryControlData on Query {\n    shippingCountries {\n      countries\n      source\n    }\n  }\n`;\n\n/** The shipping countries the control reads. `countries` is ISO 3166-1 alpha-3, in the platform's order. */\nexport type AddressCountryControlSlice = Readonly<{\n  countries: readonly string[];\n  source: 'PLATFORM' | 'SALES_CHANNEL_FALLBACK';\n}>;\n\nexport type AddressCountryControlProps = Readonly<{\n  /** Unwrapped `shippingCountries` from the reactive runtime: `null` when the read failed, absent outside the page query. */\n  $data?: AddressCountryControlSlice | null;\n  /** The select's label. A blank value falls back to the catalog copy. */\n  label?: string;\n  className?: string;\n}>;\n\nexport type AccountAddressCountryNoticeProps = Readonly<{\n  /** Replaces the whole sentence, with the same ICU arguments. A blank value falls back to the catalog copy. */\n  message?: string;\n  className?: string;\n}>;\n\nexport const AddressCountryControlDefinition = defineComponent<AddressCountryControlProps>({\n  name: 'AddressCountryControl',\n  importPath: '@vtex/faststore/components',\n  component: AddressCountryControl,\n  fragment,\n  fetchStrategy: 'reactive',\n  requiresContext: 'account-address-form',\n  skeleton: AccountAddressBookSkeleton,\n  editor: { label: 'Address Country Control', category: 'input' },\n  schema: {\n    label: { type: 'string', label: 'Field label' },\n  },\n  guideline:\n    \"The country of the address. A new address picks it from the countries the store ships to, in a list sorted by name, when there are two or more; with one it shows nothing, and the address takes that country. A saved address keeps its country, shown as text, and so does a new one when the list could not be read. Changing it keeps the fields the new country takes, and brings back what was typed for that country before. Compose it explicitly under AccountAddressFormRoot to offer the choice: in the root's default composition it gets no list and shows the root's defaultCountry as text. Place AccountAddressCountryNotice next to it. Must be inside AccountAddressFormRoot.\",\n});\n\nexport const AccountAddressCountryNoticeDefinition = defineComponent<AccountAddressCountryNoticeProps>({\n  name: 'AccountAddressCountryNotice',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressCountryNotice,\n  requiresContext: 'account-address-form',\n  editor: { label: 'Account Address Country Notice', category: 'content' },\n  schema: {\n    message: { type: 'string', label: 'Notice message' },\n  },\n  guideline:\n    'Says which fields a country change left behind, and that they come back on switching back. Announced politely, and empty until a change leaves something behind. The message takes count, country, previous and fields as ICU arguments. Place it right after AddressCountryControl. Must be inside AccountAddressFormRoot.',\n});\n\ntype CountryOption = Readonly<{ value: string; label: string }>;\n\nexport function AddressCountryControl({ $data: $dataProp, label, className }: AddressCountryControlProps) {\n  const slice = useDataOverride<AddressCountryControlSlice | null | undefined>($dataProp);\n  const {\n    mode,\n    country,\n    pending,\n    countryChoice: { offer, selected, change },\n  } = useAccountAddressForm();\n  const { displayName } = useStorefrontFormatters();\n  const { locale } = useStorefrontContext();\n  const intl = useIntl();\n\n  // A slice from another ancestor's provider has no `countries`: the list is unknown then.\n  const countries = slice?.countries ?? null;\n  const reported = countries?.join(',') ?? null;\n\n  useEffect(() => offer(reported === null ? null : reported.split(',').filter(Boolean)), [offer, reported]);\n\n  const options = useMemo<readonly CountryOption[]>(() => {\n    const collator = new Intl.Collator(locale);\n    return (countries ?? [])\n      .map((code) => ({ value: code, label: countryDisplayName(code, displayName) ?? code }))\n      .sort((a, b) => collator.compare(a.label, b.label));\n  }, [countries, locale, displayName]);\n\n  const switching = selected !== country;\n  const wrapper = {\n    className,\n    'data-fs-address-country-control': '',\n    ...(switching ? { 'data-fs-address-country-control-pending': '' } : {}),\n  };\n\n  if (mode === 'add' && countries?.length === 1) return null;\n\n  if (mode === 'add' && countries && countries.length > 1) {\n    return (\n      <div {...wrapper} data-fs-address-country-control-mode=\"select\">\n        <Select.Root value={selected} disabled={pending} onValueChange={(value) => value && change(value)}>\n          <Select.Label>\n            {resolveAuthoredCopy(label, intl.formatMessage({ id: 'fs/address-form.country' }))}\n          </Select.Label>\n          <Select.Trigger data-fs-account-address-form-control=\"\" disabled={pending}>\n            <Select.Value>\n              {(value) =>\n                options.find((option) => option.value === value)?.label ??\n                countryDisplayName(value, displayName) ??\n                value\n              }\n            </Select.Value>\n            <Select.Icon />\n          </Select.Trigger>\n          <Select.Portal>\n            <Select.Positioner>\n              <Select.Popup>\n                <Select.List>\n                  {options.map((option) => (\n                    <Select.Item key={option.value} value={option.value} label={option.label}>\n                      <Select.ItemText>{option.label}</Select.ItemText>\n                    </Select.Item>\n                  ))}\n                </Select.List>\n              </Select.Popup>\n            </Select.Positioner>\n          </Select.Portal>\n        </Select.Root>\n      </div>\n    );\n  }\n\n  const name = countryDisplayName(country, displayName);\n  if (!name) return null;\n\n  return (\n    <div {...wrapper} data-fs-address-country-control-mode=\"text\">\n      <p data-fs-address-country-control-text=\"\">{name}</p>\n    </div>\n  );\n}\n\ntype DescribeChangeInput = Readonly<{\n  change: AccountAddressCountryChange | null;\n  message: string | undefined;\n  intl: ReturnType<typeof useIntl>;\n  formatters: ReturnType<typeof useStorefrontFormatters>;\n}>;\n\nfunction describeChange({ change, message, intl, formatters }: DescribeChangeInput): string {\n  if (!change || change.notCarried.length === 0) return '';\n  const { displayName, formatList } = formatters;\n  const values = {\n    count: change.notCarried.length,\n    country: countryDisplayName(change.to, displayName) ?? change.to,\n    previous: countryDisplayName(change.from, displayName) ?? change.from,\n    fields: formatList(change.notCarried.map(({ labelId }) => intl.formatMessage({ id: labelId }))),\n  };\n  const fallback = intl.formatMessage({ id: 'fs/address-form.country-notice' }, values);\n  const authored = resolveAuthoredCopy(message, '');\n  if (!authored) return fallback;\n  try {\n    return String(intl.formatters.getMessageFormat(authored, intl.locale).format(values));\n  } catch {\n    // An authored message is free text: a malformed ICU pattern falls back to the catalog copy.\n    return fallback;\n  }\n}\n\nexport function AccountAddressCountryNotice({ message, className }: AccountAddressCountryNoticeProps) {\n  const {\n    countryChoice: { lastChange },\n  } = useAccountAddressForm();\n  const intl = useIntl();\n  const formatters = useStorefrontFormatters();\n\n  return (\n    <output aria-live=\"polite\" className={className} data-fs-account-address-country-notice=\"\">\n      {describeChange({ change: lastChange, message, intl, formatters })}\n    </output>\n  );\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import { formatAddress } from "../../sdk/address/format-address.js";
+//#region src/matter/account-address-book/account-address-first-line.ts
+/** The text of the address's first printed line, so a button says which address it acts on. */
+function firstLine(address) {
+	const [line] = formatAddress(address, address.country ?? "");
+	return (line ?? []).map(({ field, separator }) => `${separator ?? ""}${address[field] ?? ""}`).join("");
+}
+//#endregion
+export { firstLine };
+
+//# sourceMappingURL=account-address-first-line.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-first-line.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-first-line.ts"],"sourcesContent":["import { formatAddress } from '../../sdk/address/format-address.js';\nimport type { AccountAddressBookItemSlice } from './account-address-book.js';\n\n/** The text of the address's first printed line, so a button says which address it acts on. */\nexport function firstLine(address: AccountAddressBookItemSlice): string {\n  const [line] = formatAddress(address, address.country ?? '');\n  return (line ?? []).map(({ field, separator }) => `${separator ?? ''}${address[field] ?? ''}`).join('');\n}\n"],"mappings":";;;AAIA,SAAgB,UAAU,SAA8C;CACtE,MAAM,CAAC,QAAQ,cAAc,SAAS,QAAQ,WAAW,EAAE;CAC3D,QAAQ,QAAQ,CAAC,EAAA,CAAG,KAAK,EAAE,OAAO,gBAAgB,GAAG,aAAa,KAAK,QAAQ,UAAU,IAAI,CAAC,CAAC,KAAK,EAAE;AACxG"}

package/dist/matter/account-address-book/account-address-form-context.d.ts

@@ -0,0 +1,55 @@
+import { MessageId } from "../../sdk/i18n/locales.js";
+import "../../sdk/i18n/client.js";
+import { AddressFieldError, AddressFieldName, CountryRules } from "../../sdk/address/types.js";
+//#region src/matter/account-address-book/account-address-form-context.d.ts
+export type EditableField = Exclude<AddressFieldName, 'name'>;
+/** The draft: the address fields the form edits. `name` is not edited, as `CustomerAddress` has none. */
+export type AccountAddressFormDraft = Readonly<Partial<Record<EditableField, string>>>;
+export type AccountAddressFormFieldErrors = Readonly<Partial<Record<AddressFieldName, AddressFieldError>>>;
+/** What a refusal that names no field on screen says. */
+export type AccountAddressFormErrorKind = 'unrenderedField' | 'notFound' | 'unauthorized' | 'saveFailed' | 'rulesFailed' | 'countrySwitchFailed' | 'unsupportedCountry';
+/** What the last applied switch did not carry, for AccountAddressCountryNotice. */
+export type AccountAddressCountryChange = Readonly<{
+  /** ISO 3166-1 alpha-3. */
+  from: string;
+  to: string;
+  /** In the old country's field order; empty when everything was carried. */
+  notCarried: readonly Readonly<{
+    field: AddressFieldName;
+    labelId: MessageId;
+  }>[];
+}>;
+/**
+ * The country choice, the only part of the form the country control and the notice touch. The
+ * values set aside on a switch stay with the draft's owner, behind `change`.
+ */
+export type AccountAddressFormCountryChoice = Readonly<{
+  /** AddressCountryControl reports its shipping countries; `null` means unknown. Returns the withdrawal. */
+  offer: (countries: readonly string[] | null) => () => void;
+  /** The country the control shows as chosen: a switch in flight, else `country`. */
+  selected: string;
+  /** Starts a switch in add mode. Ignored in edit mode. `change(country)` cancels a switch in flight. */
+  change: (to: string) => void;
+  /** `null` until a switch applies, and always in edit mode. */
+  lastChange: AccountAddressCountryChange | null;
+}>;
+export type AccountAddressFormContextValue = Readonly<{
+  mode: 'add' | 'edit';
+  /** ISO 3166-1 alpha-3, upper case. Empty while a new address's country is not resolved yet. */
+  country: string;
+  /** `null` until the country's rules loaded. */
+  rules: CountryRules | null;
+  draft: AccountAddressFormDraft;
+  fieldErrors: AccountAddressFormFieldErrors;
+  formError: AccountAddressFormErrorKind | null;
+  pending: boolean;
+  setField: (name: EditableField, value: string) => void;
+  /** A field part calls this while it is on screen, so a refusal on a field with no control is told apart. */
+  registerField: (name: AddressFieldName) => () => void;
+  close: () => void;
+  countryChoice: AccountAddressFormCountryChoice;
+}>;
+/** The form's draft, errors and state, for any part composed under `AccountAddressFormRoot`. */
+export declare function useAccountAddressForm(): AccountAddressFormContextValue;
+//#endregion
+//# sourceMappingURL=account-address-form-context.d.ts.map

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

@@ -0,0 +1,14 @@
+"use client";
+import { createContext, useContext } from "react";
+//#region src/matter/account-address-book/account-address-form-context.ts
+const AccountAddressFormContext = createContext(null);
+/** The form's draft, errors and state, for any part composed under `AccountAddressFormRoot`. */
+function useAccountAddressForm() {
+	const value = useContext(AccountAddressFormContext);
+	if (!value) throw new Error("Address form parts must be used inside an AccountAddressFormRoot.");
+	return value;
+}
+//#endregion
+export { AccountAddressFormContext, useAccountAddressForm };
+
+//# sourceMappingURL=account-address-form-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-form-context.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-form-context.ts"],"sourcesContent":["'use client';\n\nimport { createContext, useContext } from 'react';\nimport type { AddressFieldError, AddressFieldName, CountryRules } from '../../sdk/address/types.js';\nimport type { MessageId } from '../../sdk/i18n/client.js';\n\nexport type EditableField = Exclude<AddressFieldName, 'name'>;\n\n/** The draft: the address fields the form edits. `name` is not edited, as `CustomerAddress` has none. */\nexport type AccountAddressFormDraft = Readonly<Partial<Record<EditableField, string>>>;\n\nexport type AccountAddressFormFieldErrors = Readonly<Partial<Record<AddressFieldName, AddressFieldError>>>;\n\n/** What a refusal that names no field on screen says. */\nexport type AccountAddressFormErrorKind =\n  | 'unrenderedField'\n  | 'notFound'\n  | 'unauthorized'\n  | 'saveFailed'\n  | 'rulesFailed'\n  | 'countrySwitchFailed'\n  | 'unsupportedCountry';\n\n/** What the last applied switch did not carry, for AccountAddressCountryNotice. */\nexport type AccountAddressCountryChange = Readonly<{\n  /** ISO 3166-1 alpha-3. */\n  from: string;\n  to: string;\n  /** In the old country's field order; empty when everything was carried. */\n  notCarried: readonly Readonly<{ field: AddressFieldName; labelId: MessageId }>[];\n}>;\n\n/**\n * The country choice, the only part of the form the country control and the notice touch. The\n * values set aside on a switch stay with the draft's owner, behind `change`.\n */\nexport type AccountAddressFormCountryChoice = Readonly<{\n  /** AddressCountryControl reports its shipping countries; `null` means unknown. Returns the withdrawal. */\n  offer: (countries: readonly string[] | null) => () => void;\n  /** The country the control shows as chosen: a switch in flight, else `country`. */\n  selected: string;\n  /** Starts a switch in add mode. Ignored in edit mode. `change(country)` cancels a switch in flight. */\n  change: (to: string) => void;\n  /** `null` until a switch applies, and always in edit mode. */\n  lastChange: AccountAddressCountryChange | null;\n}>;\n\nexport type AccountAddressFormContextValue = Readonly<{\n  mode: 'add' | 'edit';\n  /** ISO 3166-1 alpha-3, upper case. Empty while a new address's country is not resolved yet. */\n  country: string;\n  /** `null` until the country's rules loaded. */\n  rules: CountryRules | null;\n  draft: AccountAddressFormDraft;\n  fieldErrors: AccountAddressFormFieldErrors;\n  formError: AccountAddressFormErrorKind | null;\n  pending: boolean;\n  setField: (name: EditableField, value: string) => void;\n  /** A field part calls this while it is on screen, so a refusal on a field with no control is told apart. */\n  registerField: (name: AddressFieldName) => () => void;\n  close: () => void;\n  countryChoice: AccountAddressFormCountryChoice;\n}>;\n\nexport const AccountAddressFormContext = createContext<AccountAddressFormContextValue | null>(null);\n\n/** The form's draft, errors and state, for any part composed under `AccountAddressFormRoot`. */\nexport function useAccountAddressForm(): AccountAddressFormContextValue {\n  const value = useContext(AccountAddressFormContext);\n  if (!value) {\n    throw new Error('Address form parts must be used inside an AccountAddressFormRoot.');\n  }\n  return value;\n}\n"],"mappings":";;;AAgEA,MAAa,4BAA4B,cAAqD,IAAI;;AAGlG,SAAgB,wBAAwD;CACtE,MAAM,QAAQ,WAAW,yBAAyB;CAClD,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,mEAAmE;CAErF,OAAO;AACT"}

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

@@ -0,0 +1,85 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { PageRef } from "../../sdk/navigation/types.js";
+import { ComponentActions } from "../../sdk/actions/types.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/account-address-book/account-address-form.d.ts
+/**
+ * The form that adds an address and corrects a saved one (specs/sfs-3441-address-book-form.md, RFC
+ * REQ-02 and REQ-03). The Root renders `FormRoot` and registers one fieldset with it, under the
+ * `accountAddress` namespace: react-hook-form holds the draft and knows what is dirty, and the
+ * fieldset owns the field errors, the form-level error, the status message and the save. It holds no
+ * country rule: the fields come from `addressFields`, the verdict from `validateAddress`, and the
+ * writes go through `$actions.address`.
+ */
+export type AccountAddressFormRootProps = ComponentPropsWithRef<'form'> & {
+  /**
+   * ISO 3166-1 alpha-3 country a new address prefers: taken when the store ships there or its list
+   * is unknown. A blank value falls back to `BRA`.
+   */
+  defaultCountry?: string;
+  /** Toast after an address is added. A blank value falls back to the catalog copy. */
+  addedMessage?: string;
+  /** Toast after an address is saved. A blank value falls back to the catalog copy. */
+  savedMessage?: string;
+  /** Announced when a save is blocked. A blank value falls back to the catalog copy. */
+  blockedMessage?: string;
+  /** Where leaving the form goes when it stands on its own page. A page reference, or a site-relative string. A blank value falls back to the address page. */
+  returnHref?: PageRef | string;
+  /** Injected by the compiler from `actions: { address: [...] }`; the address write surface. */
+  $actions?: ComponentActions;
+};
+/** `className` goes on every field's wrapper. */
+export type AccountAddressFormFieldsProps = Readonly<{
+  className?: string;
+}>;
+export type AccountAddressFormLabelProps = Readonly<{
+  /** The field's label. A blank value falls back to the catalog copy. */
+  label?: string;
+  className?: string;
+}>;
+export type AccountAddressFormErrorProps = ComponentPropsWithRef<'div'> & {
+  /** Each message below falls back to the catalog copy when blank. */
+  unrenderedFieldMessage?: string;
+  notFoundMessage?: string;
+  unauthorizedMessage?: string;
+  saveFailedMessage?: string;
+  rulesFailedMessage?: string;
+  countrySwitchFailedMessage?: string;
+  unsupportedCountryMessage?: string;
+};
+export type AccountAddressFormButtonProps = Omit<ComponentPropsWithRef<'button'>, 'type'> & {
+  /** The button's text. A blank value falls back to the catalog copy. */
+  label?: string;
+};
+export declare function AccountAddressFormRoot({ defaultCountry, addedMessage, savedMessage, blockedMessage, returnHref, $actions, className, children, ...props }: AccountAddressFormRootProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressFormRecipientName({ label, className }: AccountAddressFormLabelProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressFormReference({ label, className }: AccountAddressFormLabelProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * One field per descriptor the country's rules give for the draft, in the order the country's form lists them.
+ * A complete postal code fills the empty state, city, neighborhood and street the shopper has not typed;
+ * the fill is announced once.
+ */
+export declare function AccountAddressFormFields({ className }: AccountAddressFormFieldsProps): import("react/jsx-runtime").JSX.Element[] | null;
+export declare function AccountAddressFormError({ unrenderedFieldMessage, notFoundMessage, unauthorizedMessage, saveFailedMessage, rulesFailedMessage, countrySwitchFailedMessage, unsupportedCountryMessage, className, ...props }: AccountAddressFormErrorProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressFormSubmit({ label, className, children, ...props }: AccountAddressFormButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function AccountAddressFormCancel({ label, className, children, onClick, ...props }: AccountAddressFormButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare const AccountAddressFormRootDefinition: ComponentDefinition<AccountAddressFormRootProps>;
+export declare const AccountAddressFormRecipientNameDefinition: ComponentDefinition<Readonly<{
+  /** The field's label. A blank value falls back to the catalog copy. */
+  label?: string;
+  className?: string;
+}>>;
+export declare const AccountAddressFormFieldsDefinition: ComponentDefinition<Readonly<{
+  className?: string;
+}>>;
+export declare const AccountAddressFormReferenceDefinition: ComponentDefinition<Readonly<{
+  /** The field's label. A blank value falls back to the catalog copy. */
+  label?: string;
+  className?: string;
+}>>;
+export declare const AccountAddressFormErrorDefinition: ComponentDefinition<AccountAddressFormErrorProps>;
+export declare const AccountAddressFormSubmitDefinition: ComponentDefinition<AccountAddressFormButtonProps>;
+export declare const AccountAddressFormCancelDefinition: ComponentDefinition<AccountAddressFormButtonProps>;
+//#endregion
+//# sourceMappingURL=account-address-form.d.ts.map