@vtex/faststore 0.0.7 → 0.0.10

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

@@ -0,0 +1,72 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.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 { NavigationLink } from "../../particles/navigation-link/navigation-link.js";
+import { AccountAddressBookSkeleton } from "./account-address-book.js";
+import { checkoutReadiness } from "../../sdk/address/checkout-readiness.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+const AccountAddressBookProfileNoticeDefinition = defineComponent({
+	name: "AccountAddressBookProfileNotice",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookProfileNotice,
+	fragment: `
+  fragment AccountAddressBookProfileNoticeData on Query {
+    customerProfile {
+      __typename
+      id
+      homePhone
+    }
+  }
+`,
+	fetchStrategy: "reactive",
+	requiresContext: "session",
+	skeleton: AccountAddressBookSkeleton,
+	editor: {
+		label: "Account Address Book Profile Notice",
+		category: "identity"
+	},
+	schema: {
+		href: {
+			type: "link",
+			default: { standard: "profile" },
+			label: "Profile page"
+		},
+		message: {
+			type: "string",
+			label: "Notice message"
+		},
+		linkLabel: {
+			type: "string",
+			label: "Link label"
+		}
+	},
+	guideline: "Tells a signed-in shopper that their saved addresses will not be offered at checkout until their profile has a phone number, with a link to the profile page (href defaults to the store's profile page). Renders nothing when the profile is complete, still loading, or failed to load. Independent of the address book root: place it anywhere under a SessionRoot, typically above AccountAddressBookRoot."
+});
+const PROFILE_PAGE = { standard: "profile" };
+function AccountAddressBookProfileNotice({ $data: $dataProp, href, message, linkLabel, className, ...props }) {
+	const profile = useDataOverride($dataProp) ?? null;
+	const { state } = useSession();
+	const intl = useIntl();
+	if (state !== "loggedIn" || profile === null || checkoutReadiness(profile).ready) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		className,
+		"data-fs-account-address-book-profile-notice": "",
+		children: [/* @__PURE__ */ jsx("p", {
+			"data-fs-account-address-book-profile-notice-message": "",
+			children: resolveAuthoredCopy(message, intl.formatMessage({ id: "fs/address-book.profile-notice" }))
+		}), /* @__PURE__ */ jsx(NavigationLink, {
+			href: typeof href === "string" && href.trim().length === 0 ? PROFILE_PAGE : href ?? PROFILE_PAGE,
+			"data-fs-account-address-book-profile-notice-link": "",
+			children: resolveAuthoredCopy(linkLabel, intl.formatMessage({ id: "fs/address-book.profile-notice.link" }))
+		})]
+	});
+}
+//#endregion
+export { AccountAddressBookProfileNotice, AccountAddressBookProfileNoticeDefinition };
+
+//# sourceMappingURL=account-address-book-profile-notice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-book-profile-notice.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-book-profile-notice.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { NavigationLink } from '../../particles/navigation-link/navigation-link.js';\nimport { checkoutReadiness } from '../../sdk/address/checkout-readiness.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { useIntl } from '../../sdk/i18n/client.js';\nimport type { PageRef } from '../../sdk/navigation/types.js';\nimport { resolveAuthoredCopy } from '../../utils/resolve-authored-copy.js';\nimport { useSession } from '../session/session.js';\nimport { AccountAddressBookSkeleton } from './account-address-book.js';\n\n/**\n * Tells the shopper why their saved addresses will not reach the checkout (RFC REQ-01, \"Checkout\n * readiness\"). The checkout imports saved addresses into a cart only when the profile meets its\n * minimums, and otherwise drops them without an error, so a shopper with an incomplete profile sees\n * addresses here that they never see there.\n *\n * Its own matter with its own `customerProfile` fragment (ADR-0011): it needs nothing from the address\n * book's root, so a store places it anywhere under a `SessionRoot`. It renders nothing when the\n * profile is complete, when the profile has not resolved, or when its read failed. The minimums are\n * `checkoutReadiness`'s, so this notice and the checkout agree on them.\n */\n\nconst fragment = /* GraphQL */ `\n  fragment AccountAddressBookProfileNoticeData on Query {\n    customerProfile {\n      __typename\n      id\n      homePhone\n    }\n  }\n`;\n\n/** The profile fields the notice reads. */\nexport type AccountAddressBookProfileNoticeSlice = Readonly<{\n  __typename?: 'CustomerProfile';\n  id: string;\n  homePhone?: string | null;\n}>;\n\nexport type AccountAddressBookProfileNoticeProps = ComponentPropsWithRef<'div'> & {\n  /** Unwrapped `customerProfile` from the reactive runtime (arity-1 fragment); `null` until resolved. */\n  $data?: AccountAddressBookProfileNoticeSlice | null;\n  /** Where the link goes. A blank value falls back to the default. */\n  href?: PageRef | string;\n  /** The notice text. A blank value falls back to the catalog copy. */\n  message?: string;\n  /** The link's label. A blank value falls back to the catalog copy. */\n  linkLabel?: string;\n};\n\nexport const AccountAddressBookProfileNoticeDefinition = defineComponent<AccountAddressBookProfileNoticeProps>({\n  name: 'AccountAddressBookProfileNotice',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookProfileNotice,\n  fragment,\n  fetchStrategy: 'reactive',\n  requiresContext: 'session',\n  skeleton: AccountAddressBookSkeleton,\n  editor: { label: 'Account Address Book Profile Notice', category: 'identity' },\n  schema: {\n    // An inline literal, never an identifier: the native catalog builder extracts `schema` statically\n    // and silently drops an identifier-valued default.\n    href: { type: 'link', default: { standard: 'profile' }, label: 'Profile page' },\n    message: { type: 'string', label: 'Notice message' },\n    linkLabel: { type: 'string', label: 'Link label' },\n  },\n  guideline:\n    \"Tells a signed-in shopper that their saved addresses will not be offered at checkout until their profile has a phone number, with a link to the profile page (href defaults to the store's profile page). Renders nothing when the profile is complete, still loading, or failed to load. Independent of the address book root: place it anywhere under a SessionRoot, typically above AccountAddressBookRoot.\",\n});\n\nconst PROFILE_PAGE: PageRef = { standard: 'profile' };\n\nexport function AccountAddressBookProfileNotice({\n  $data: $dataProp,\n  href,\n  message,\n  linkLabel,\n  className,\n  ...props\n}: AccountAddressBookProfileNoticeProps) {\n  const profile = useDataOverride<AccountAddressBookProfileNoticeSlice | null | undefined>($dataProp) ?? null;\n  const { state } = useSession();\n  const intl = useIntl();\n\n  if (state !== 'loggedIn' || profile === null || checkoutReadiness(profile).ready) return null;\n\n  return (\n    <div {...props} className={className} data-fs-account-address-book-profile-notice=\"\">\n      <p data-fs-account-address-book-profile-notice-message=\"\">\n        {resolveAuthoredCopy(message, intl.formatMessage({ id: 'fs/address-book.profile-notice' }))}\n      </p>\n      <NavigationLink\n        href={typeof href === 'string' && href.trim().length === 0 ? PROFILE_PAGE : (href ?? PROFILE_PAGE)}\n        data-fs-account-address-book-profile-notice-link=\"\"\n      >\n        {resolveAuthoredCopy(linkLabel, intl.formatMessage({ id: 'fs/address-book.profile-notice.link' }))}\n      </NavigationLink>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;AAqDA,MAAa,4CAA4C,gBAAsD;CAC7G,MAAM;CACN,YAAY;CACZ,WAAW;CACX;;;;;;;;;CACA,eAAe;CACf,iBAAiB;CACjB,UAAU;CACV,QAAQ;EAAE,OAAO;EAAuC,UAAU;CAAW;CAC7E,QAAQ;EAGN,MAAM;GAAE,MAAM;GAAQ,SAAS,EAAE,UAAU,UAAU;GAAG,OAAO;EAAe;EAC9E,SAAS;GAAE,MAAM;GAAU,OAAO;EAAiB;EACnD,WAAW;GAAE,MAAM;GAAU,OAAO;EAAa;CACnD;CACA,WACE;AACJ,CAAC;AAED,MAAM,eAAwB,EAAE,UAAU,UAAU;AAEpD,SAAgB,gCAAgC,EAC9C,OAAO,WACP,MACA,SACA,WACA,WACA,GAAG,SACoC;CACvC,MAAM,UAAU,gBAAyE,SAAS,KAAK;CACvG,MAAM,EAAE,UAAU,WAAW;CAC7B,MAAM,OAAO,QAAQ;CAErB,IAAI,UAAU,cAAc,YAAY,QAAQ,kBAAkB,OAAO,CAAC,CAAC,OAAO,OAAO;CAEzF,OACE,qBAAC,OAAD;EAAK,GAAI;EAAkB;EAAW,+CAA4C;EAAlF,UAAA,CACE,oBAAC,KAAD;GAAG,uDAAoD;GACpD,UAAA,oBAAoB,SAAS,KAAK,cAAc,EAAE,IAAI,iCAAiC,CAAC,CAAC;EACzF,CAAA,GACH,oBAAC,gBAAD;GACE,MAAM,OAAO,SAAS,YAAY,KAAK,KAAK,CAAC,CAAC,WAAW,IAAI,eAAgB,QAAQ;GACrF,oDAAiD;GAEhD,UAAA,oBAAoB,WAAW,KAAK,cAAc,EAAE,IAAI,sCAAsC,CAAC,CAAC;EACnF,CAAA,CACb;;AAET"}

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

@@ -0,0 +1,120 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/account-address-book/account-address-book.d.ts
+/** The minimal per-address identifiers the root needs to iterate. */
+export type AccountAddressBookRootSlice = Readonly<{
+  __typename?: 'CustomerAddressBook';
+  id: string;
+  addresses: readonly Readonly<{
+    __typename?: 'CustomerAddress';
+    id: string;
+  }>[];
+}>;
+/** The full per-address slice `AccountAddressBookItem` resolves on its own. */
+export type AccountAddressBookItemSlice = Readonly<{
+  __typename?: 'CustomerAddress';
+  id: string;
+  country?: string | null;
+  recipientName?: string | null;
+  street?: string | null;
+  number?: string | null;
+  complement?: string | null;
+  neighborhood?: string | null;
+  city?: string | null;
+  state?: string | null;
+  postalCode?: string | null;
+  reference?: string | null;
+}>;
+/**
+ * Where the book is. `null` is the frame before anything resolved, loaded, or failed: it shows
+ * nothing, so no state is ever claimed that the data has not earned.
+ */
+export type AccountAddressBookState = 'loading' | 'error' | 'empty' | 'ready';
+/** The form the book has open. `address` is the item's raw slice, so the form can seed itself from it. */
+export type AccountAddressBookOpenForm = Readonly<{
+  mode: 'add';
+}> | Readonly<{
+  mode: 'edit';
+  address: AccountAddressBookItemSlice;
+}>;
+/** The address a delete confirmation is open for. `null` when none is. */
+export type AccountAddressBookPendingDelete = AccountAddressBookItemSlice | null;
+export type AccountAddressBookContextValue = Readonly<{
+  book: AccountAddressBookRootSlice | null;
+  state: AccountAddressBookState | null;
+  openForm: AccountAddressBookOpenForm | null;
+  /** Opens a form, replacing any open one. `opener` is where focus returns when the form closes. */
+  open: (form: AccountAddressBookOpenForm, opener: HTMLElement | null) => void;
+  close: () => void;
+  /** True while the open form has a save in flight. The dialog stays open until it settles. */
+  formPending: boolean;
+  /** Reported by the open form as its save starts and settles. */
+  setFormPending: (pending: boolean) => void;
+  /** The address waiting for the shopper's answer to a delete confirmation, or `null`. */
+  pendingDelete: AccountAddressBookPendingDelete;
+  /** Asks for a confirmation. `opener` is where focus returns when it is declined. */
+  requestDelete: (address: AccountAddressBookItemSlice, opener: HTMLElement | null) => void;
+  endDelete: () => void;
+  /** True from an in-place retry until the book resolves. The error part stays mounted meanwhile. */
+  retrying: boolean;
+  /** Loads the book again: in place through the page root's `refetch`, else by reloading the page. */
+  retry: () => void;
+}>;
+export type AccountAddressBookRootProps = ComponentPropsWithRef<'div'> & {
+  /** Unwrapped `customerAddressBook` from the reactive runtime (arity-1 fragment); `null` until resolved. */
+  $data?: AccountAddressBookRootSlice | null;
+};
+export type AccountAddressBookListProps = ComponentPropsWithRef<'ul'>;
+export type AccountAddressBookItemProps = ComponentPropsWithRef<'div'> & {
+  /** Per-address slice from the reactive-list-item runtime; passed directly in tests. */
+  $data?: AccountAddressBookItemSlice | null;
+};
+export type AccountAddressBookItemLinesProps = Readonly<{
+  className?: string;
+}>;
+export type AccountAddressBookLoadingProps = ComponentPropsWithRef<'output'> & {
+  /** Announced while the book loads. A blank value falls back to the catalog copy. */
+  message?: string;
+};
+export type AccountAddressBookEmptyProps = ComponentPropsWithRef<'p'> & {
+  /** Shown once the book resolved to zero addresses. A blank value falls back to the catalog copy. */
+  message?: string;
+};
+export type AccountAddressBookErrorProps = ComponentPropsWithRef<'div'> & {
+  /** Shown when the read failed. A blank value falls back to the catalog copy. */
+  message?: string;
+  /** The retry control's label. A blank value falls back to the catalog copy. */
+  retryLabel?: string;
+};
+/** The resolved book and its state, for any part composed under `AccountAddressBookRoot`. */
+export declare function useAccountAddressBook(): AccountAddressBookContextValue;
+/**
+ * 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.
+ */
+export declare function useAccountAddressBookItem(): AccountAddressBookItemSlice;
+export declare function AccountAddressBookRoot({ $data: $dataProp, className, children, ...props }: AccountAddressBookRootProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressBookList({ className, children, ...props }: AccountAddressBookListProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressBookItem({ $data: $dataProp, className, children, ...props }: AccountAddressBookItemProps): import("react/jsx-runtime").JSX.Element | null;
+/** One `p` per line the address's country prints, each field in that country's order. */
+export declare function AccountAddressBookItemLines({ className }: AccountAddressBookItemLinesProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 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).
+ */
+export declare function AccountAddressBookLoading({ message, className, children, ...props }: AccountAddressBookLoadingProps): import("react/jsx-runtime").JSX.Element;
+export declare function AccountAddressBookEmpty({ message, className, ...props }: AccountAddressBookEmptyProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressBookError({ message, retryLabel, className, ...props }: AccountAddressBookErrorProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressBookSkeleton({ className, ...props }: ComponentPropsWithRef<'div'>): import("react/jsx-runtime").JSX.Element;
+export declare const AccountAddressBookRootDefinition: ComponentDefinition<AccountAddressBookRootProps>;
+export declare const AccountAddressBookListDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLUListElement>, HTMLUListElement>>;
+export declare const AccountAddressBookItemDefinition: ComponentDefinition<AccountAddressBookItemProps>;
+export declare const AccountAddressBookItemLinesDefinition: ComponentDefinition<Readonly<{
+  className?: string;
+}>>;
+export declare const AccountAddressBookLoadingDefinition: ComponentDefinition<AccountAddressBookLoadingProps>;
+export declare const AccountAddressBookEmptyDefinition: ComponentDefinition<AccountAddressBookEmptyProps>;
+export declare const AccountAddressBookErrorDefinition: ComponentDefinition<AccountAddressBookErrorProps>;
+//#endregion
+//# sourceMappingURL=account-address-book.d.ts.map

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