@vtex/faststore 0.0.7 → 0.0.8

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

@@ -0,0 +1,19 @@
+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-deliverability.d.ts
+/** The shipping countries the marker reads. */
+export type AccountAddressBookItemDeliverabilitySlice = Readonly<{
+  countries: readonly string[];
+  source: 'PLATFORM' | 'SALES_CHANNEL_FALLBACK';
+}>;
+export type AccountAddressBookItemDeliverabilityProps = ComponentPropsWithRef<'p'> & {
+  /** Unwrapped `shippingCountries` from the reactive runtime: `null` when the read failed, `undefined` outside the page query. */
+  $data?: AccountAddressBookItemDeliverabilitySlice | null;
+  /** The marker text. A blank value falls back to the catalog copy. */
+  message?: string;
+};
+export declare const AccountAddressBookItemDeliverabilityDefinition: ComponentDefinition<AccountAddressBookItemDeliverabilityProps>;
+export declare function AccountAddressBookItemDeliverability({ $data: $dataProp, message, className, ...props }: AccountAddressBookItemDeliverabilityProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=account-address-book-deliverability.d.ts.map

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

@@ -0,0 +1,50 @@
+"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 { AccountAddressBookSkeleton, useAccountAddressBookItem } from "./account-address-book.js";
+import { jsx } from "react/jsx-runtime";
+const AccountAddressBookItemDeliverabilityDefinition = defineComponent({
+	name: "AccountAddressBookItemDeliverability",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookItemDeliverability,
+	fragment: `
+  fragment AccountAddressBookItemDeliverabilityData on Query {
+    shippingCountries {
+      countries
+      source
+    }
+  }
+`,
+	fetchStrategy: "reactive",
+	requiresContext: "account-address-book-item",
+	skeleton: AccountAddressBookSkeleton,
+	editor: {
+		label: "Account Address Book Item Deliverability",
+		category: "content"
+	},
+	schema: { message: {
+		type: "string",
+		label: "Marker message"
+	} },
+	guideline: "Marks a saved address the store does not ship to, as text read with the address. Place it inside AccountAddressBookItem, which repeats it per address. Renders nothing unless the store's shipping countries are known and the address's country is not among them: a failed read, a single-country fallback list, or an address with no country all leave it empty. Set message to replace the default copy."
+});
+function AccountAddressBookItemDeliverability({ $data: $dataProp, message, className, ...props }) {
+	const { country } = useAccountAddressBookItem();
+	const shippingCountries = useDataOverride($dataProp);
+	const intl = useIntl();
+	const code = country?.trim().toUpperCase() ?? "";
+	if (shippingCountries?.source !== "PLATFORM" || code === "" || shippingCountries.countries.includes(code)) return null;
+	return /* @__PURE__ */ jsx("p", {
+		...props,
+		className,
+		"data-fs-account-address-book-item-deliverability": "",
+		children: resolveAuthoredCopy(message, intl.formatMessage({ id: "fs/address-book.undeliverable" }))
+	});
+}
+//#endregion
+export { AccountAddressBookItemDeliverability, AccountAddressBookItemDeliverabilityDefinition };
+
+//# sourceMappingURL=account-address-book-deliverability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-book-deliverability.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-book-deliverability.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { useIntl } from '../../sdk/i18n/client.js';\nimport { resolveAuthoredCopy } from '../../utils/resolve-authored-copy.js';\nimport { AccountAddressBookSkeleton, useAccountAddressBookItem } from './account-address-book.js';\n\n/**\n * Marks a saved address the store does not ship to (specs/sfs-3436-address-deliverability-marker.md,\n * RFC REQ-01). The checkout refuses such an address, and the shopper otherwise finds out mid-purchase.\n *\n * It renders only when it can tell for sure: the store's own shipping countries (`PLATFORM`, never\n * the single-country `SALES_CHANNEL_FALLBACK` guess), a non-blank country on the address, and a\n * country that is not in the list. A failed read, a page that does not carry the marker, and an\n * address with no country all render nothing, so the marker never claims what the data has not earned.\n *\n * Its fragment is the one `AddressCountryControl` (SFS-3442) shares: the same selection, with no alias\n * and no argument, so the compiler merges both into one root read. `ShippingCountries` has no `id`,\n * so the marker keeps the server-rendered value for the whole page.\n */\n\nconst fragment = /* GraphQL */ `\n  fragment AccountAddressBookItemDeliverabilityData on Query {\n    shippingCountries {\n      countries\n      source\n    }\n  }\n`;\n\n/** The shipping countries the marker reads. */\nexport type AccountAddressBookItemDeliverabilitySlice = Readonly<{\n  countries: readonly string[];\n  source: 'PLATFORM' | 'SALES_CHANNEL_FALLBACK';\n}>;\n\nexport type AccountAddressBookItemDeliverabilityProps = ComponentPropsWithRef<'p'> & {\n  /** Unwrapped `shippingCountries` from the reactive runtime: `null` when the read failed, `undefined` outside the page query. */\n  $data?: AccountAddressBookItemDeliverabilitySlice | null;\n  /** The marker text. A blank value falls back to the catalog copy. */\n  message?: string;\n};\n\nexport const AccountAddressBookItemDeliverabilityDefinition =\n  defineComponent<AccountAddressBookItemDeliverabilityProps>({\n    name: 'AccountAddressBookItemDeliverability',\n    importPath: '@vtex/faststore/components',\n    component: AccountAddressBookItemDeliverability,\n    fragment,\n    fetchStrategy: 'reactive',\n    requiresContext: 'account-address-book-item',\n    skeleton: AccountAddressBookSkeleton,\n    editor: { label: 'Account Address Book Item Deliverability', category: 'content' },\n    schema: {\n      message: { type: 'string', label: 'Marker message' },\n    },\n    guideline:\n      \"Marks a saved address the store does not ship to, as text read with the address. Place it inside AccountAddressBookItem, which repeats it per address. Renders nothing unless the store's shipping countries are known and the address's country is not among them: a failed read, a single-country fallback list, or an address with no country all leave it empty. Set message to replace the default copy.\",\n  });\n\nexport function AccountAddressBookItemDeliverability({\n  $data: $dataProp,\n  message,\n  className,\n  ...props\n}: AccountAddressBookItemDeliverabilityProps) {\n  const { country } = useAccountAddressBookItem();\n  const shippingCountries = useDataOverride<AccountAddressBookItemDeliverabilitySlice | null | undefined>($dataProp);\n  const intl = useIntl();\n\n  const code = country?.trim().toUpperCase() ?? '';\n  if (shippingCountries?.source !== 'PLATFORM' || code === '' || shippingCountries.countries.includes(code)) {\n    return null;\n  }\n\n  return (\n    <p {...props} className={className} data-fs-account-address-book-item-deliverability=\"\">\n      {resolveAuthoredCopy(message, intl.formatMessage({ id: 'fs/address-book.undeliverable' }))}\n    </p>\n  );\n}\n"],"mappings":";;;;;;;;AA6CA,MAAa,iDACX,gBAA2D;CACzD,MAAM;CACN,YAAY;CACZ,WAAW;CACX;;;;;;;;CACA,eAAe;CACf,iBAAiB;CACjB,UAAU;CACV,QAAQ;EAAE,OAAO;EAA4C,UAAU;CAAU;CACjF,QAAQ,EACN,SAAS;EAAE,MAAM;EAAU,OAAO;CAAiB,EACrD;CACA,WACE;AACJ,CAAC;AAEH,SAAgB,qCAAqC,EACnD,OAAO,WACP,SACA,WACA,GAAG,SACyC;CAC5C,MAAM,EAAE,YAAY,0BAA0B;CAC9C,MAAM,oBAAoB,gBAA8E,SAAS;CACjH,MAAM,OAAO,QAAQ;CAErB,MAAM,OAAO,SAAS,KAAK,CAAC,CAAC,YAAY,KAAK;CAC9C,IAAI,mBAAmB,WAAW,cAAc,SAAS,MAAM,kBAAkB,UAAU,SAAS,IAAI,GACtG,OAAO;CAGT,OACE,oBAAC,KAAD;EAAG,GAAI;EAAkB;EAAW,oDAAiD;EAClF,UAAA,oBAAoB,SAAS,KAAK,cAAc,EAAE,IAAI,gCAAgC,CAAC,CAAC;CACxF,CAAA;AAEP"}

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

@@ -0,0 +1,42 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef, ReactNode } from "react";
+//#region src/matter/account-address-book/account-address-book-form-parts.d.ts
+/**
+ * Where the address form opens (specs/sfs-3441-address-book-form.md, RFC REQ-02 and REQ-03). The book's
+ * root holds which form is open; these parts read it. A trigger opens a form, and a placement part
+ * shows it: `AccountAddressBookFormSlot` in place, `AccountAddressBookFormDialog` in a dialog. A store
+ * chooses by composition, and no prop selects a layout.
+ */
+export type AccountAddressBookAddTriggerProps = ComponentPropsWithRef<'button'> & {
+  /** The button's text. A blank value falls back to the catalog copy. */
+  label?: string;
+};
+export type AccountAddressBookEditTriggerProps = ComponentPropsWithRef<'button'> & {
+  /** The button's visible text. A blank value falls back to the catalog copy. */
+  label?: string;
+};
+export type AccountAddressBookFormSlotProps = ComponentPropsWithRef<'div'>;
+export type AccountAddressBookFormDialogProps = Readonly<{
+  children?: ReactNode;
+  /** Goes on the dialog's popup, the one element a store can size and place: the dialog renders in a portal. */
+  className?: string;
+  /** The dialog's title. A blank value falls back to the catalog copy for the open mode. */
+  title?: string;
+}>;
+export declare function AccountAddressBookAddTrigger({ label, className, children, onClick, ...props }: AccountAddressBookAddTriggerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AccountAddressBookEditTrigger({ label, className, children, onClick, ...props }: AccountAddressBookEditTriggerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AccountAddressBookFormSlot({ children, ...props }: AccountAddressBookFormSlotProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AccountAddressBookFormDialog({ title, className, children }: AccountAddressBookFormDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare const AccountAddressBookAddTriggerDefinition: ComponentDefinition<AccountAddressBookAddTriggerProps>;
+export declare const AccountAddressBookEditTriggerDefinition: ComponentDefinition<AccountAddressBookEditTriggerProps>;
+export declare const AccountAddressBookFormSlotDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const AccountAddressBookFormDialogDefinition: ComponentDefinition<Readonly<{
+  children?: ReactNode;
+  /** Goes on the dialog's popup, the one element a store can size and place: the dialog renders in a portal. */
+  className?: string;
+  /** The dialog's title. A blank value falls back to the catalog copy for the open mode. */
+  title?: string;
+}>>;
+//#endregion
+//# sourceMappingURL=account-address-book-form-parts.d.ts.map

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

@@ -0,0 +1,146 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { useIntl } from "../../sdk/i18n/client.js";
+import { resolveAuthoredCopy } from "../../utils/resolve-authored-copy.js";
+import { Button } from "../../particles/button/button.js";
+import { useAccountAddressBook, useAccountAddressBookItem } from "./account-address-book.js";
+import { firstLine } from "./account-address-first-line.js";
+import { Dialog } from "../../particles/dialog/dialog.js";
+import { createElement } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/account-address-book/account-address-book-form-parts.tsx
+/** A new key starts a new draft: a different address, or an add after an edit. */
+function formKey(form) {
+	return form.mode === "edit" ? `edit:${form.address.id}` : "add";
+}
+function AccountAddressBookAddTrigger({ label, className, children, onClick, ...props }) {
+	const { open } = useAccountAddressBook();
+	const intl = useIntl();
+	return /* @__PURE__ */ jsx(Button, {
+		...props,
+		type: "button",
+		className,
+		onClick: (event) => {
+			onClick?.(event);
+			open({ mode: "add" }, event.currentTarget);
+		},
+		"data-fs-account-address-book-add": "",
+		children: children ?? resolveAuthoredCopy(label, intl.formatMessage({ id: "fs/address-form.add" }))
+	});
+}
+function AccountAddressBookEditTrigger({ label, className, children, onClick, ...props }) {
+	const { open } = useAccountAddressBook();
+	const address = useAccountAddressBookItem();
+	const intl = useIntl();
+	const text = resolveAuthoredCopy(label, intl.formatMessage({ id: "fs/address-form.edit" }));
+	const line = firstLine(address);
+	return /* @__PURE__ */ jsx(Button, {
+		"aria-label": line === "" ? void 0 : `${text} ${line}`,
+		...props,
+		type: "button",
+		className,
+		onClick: (event) => {
+			onClick?.(event);
+			open({
+				mode: "edit",
+				address
+			}, event.currentTarget);
+		},
+		"data-fs-account-address-book-edit": "",
+		children: children ?? text
+	});
+}
+function AccountAddressBookFormSlot({ children, ...props }) {
+	const { openForm } = useAccountAddressBook();
+	if (openForm === null) return null;
+	return /* @__PURE__ */ createElement("div", {
+		...props,
+		key: formKey(openForm),
+		"data-fs-account-address-book-form-slot": ""
+	}, children);
+}
+function AccountAddressBookFormDialog({ title, className, children }) {
+	const { openForm, close, formPending } = useAccountAddressBook();
+	const intl = useIntl();
+	const defaultTitle = intl.formatMessage({ id: openForm?.mode === "edit" ? "fs/address-form.title.edit" : "fs/address-form.title.add" });
+	return /* @__PURE__ */ jsx(Dialog.Root, {
+		open: openForm !== null,
+		onOpenChange: (next) => {
+			if (!next && !formPending) close();
+		},
+		children: /* @__PURE__ */ jsxs(Dialog.Portal, { children: [/* @__PURE__ */ jsx(Dialog.Backdrop, {}), /* @__PURE__ */ jsx(Dialog.Viewport, { children: /* @__PURE__ */ jsxs(Dialog.Popup, {
+			className,
+			"data-fs-account-address-book-form-dialog": "",
+			children: [
+				/* @__PURE__ */ jsx(Dialog.Title, { children: resolveAuthoredCopy(title, defaultTitle) }),
+				/* @__PURE__ */ jsx(Dialog.Close, {
+					"aria-label": intl.formatMessage({ id: "fs/a11y.close" }),
+					children: "×"
+				}),
+				openForm === null ? null : /* @__PURE__ */ jsx("div", { children }, formKey(openForm))
+			]
+		}) })] })
+	});
+}
+const AccountAddressBookAddTriggerDefinition = defineComponent({
+	name: "AccountAddressBookAddTrigger",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookAddTrigger,
+	requiresContext: "account-address-book",
+	editor: {
+		label: "Account Address Book Add Trigger",
+		category: "action"
+	},
+	schema: { label: {
+		type: "string",
+		label: "Button label"
+	} },
+	guideline: "Opens the address form in add mode. Shown in every state of the book, the empty one included, since that is where a first address is added. Place an AccountAddressBookFormSlot or an AccountAddressBookFormDialog beside it to show the form. Must be inside AccountAddressBookRoot."
+});
+const AccountAddressBookEditTriggerDefinition = defineComponent({
+	name: "AccountAddressBookEditTrigger",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookEditTrigger,
+	requiresContext: "account-address-book-item",
+	editor: {
+		label: "Account Address Book Edit Trigger",
+		category: "action"
+	},
+	schema: { label: {
+		type: "string",
+		label: "Button label"
+	} },
+	guideline: "Opens the address form in edit mode for the address of the entry it sits in. Its accessible name adds the address's first line, so a list of them is told apart. Place it inside AccountAddressBookItem, and an AccountAddressBookFormSlot or an AccountAddressBookFormDialog under the root to show the form."
+});
+const AccountAddressBookFormSlotDefinition = defineComponent({
+	name: "AccountAddressBookFormSlot",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookFormSlot,
+	requiresContext: "account-address-book",
+	editor: {
+		label: "Account Address Book Form Slot",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "Shows its children, an AccountAddressFormRoot, in place while a form is open, and nothing otherwise. Each open starts a new draft. Use it to open the form inline under the list; use AccountAddressBookFormDialog for an overlay. Must be inside AccountAddressBookRoot."
+});
+const AccountAddressBookFormDialogDefinition = defineComponent({
+	name: "AccountAddressBookFormDialog",
+	importPath: "@vtex/faststore/components",
+	component: AccountAddressBookFormDialog,
+	requiresContext: "account-address-book",
+	editor: {
+		label: "Account Address Book Form Dialog",
+		category: "layout"
+	},
+	schema: { title: {
+		type: "string",
+		label: "Dialog title"
+	} },
+	guideline: "Shows its children, an AccountAddressFormRoot, in a modal dialog while a form is open. Escape and the close button cancel the form and drop the draft, and focus returns to the control that opened it. Use AccountAddressBookFormSlot instead to open the form in place. Must be inside AccountAddressBookRoot."
+});
+//#endregion
+export { AccountAddressBookAddTrigger, AccountAddressBookAddTriggerDefinition, AccountAddressBookEditTrigger, AccountAddressBookEditTriggerDefinition, AccountAddressBookFormDialog, AccountAddressBookFormDialogDefinition, AccountAddressBookFormSlot, AccountAddressBookFormSlotDefinition };
+
+//# sourceMappingURL=account-address-book-form-parts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-address-book-form-parts.js","names":[],"sources":["../../../src/matter/account-address-book/account-address-book-form-parts.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef, ReactNode } from 'react';\nimport { Button } from '../../particles/button/button.js';\nimport { Dialog } from '../../particles/dialog/dialog.js';\nimport { useIntl } from '../../sdk/i18n/client.js';\nimport { resolveAuthoredCopy } from '../../utils/resolve-authored-copy.js';\nimport {\n  type AccountAddressBookOpenForm,\n  useAccountAddressBook,\n  useAccountAddressBookItem,\n} from './account-address-book.js';\nimport { firstLine } from './account-address-first-line.js';\n\n/**\n * Where the address form opens (specs/sfs-3441-address-book-form.md, RFC REQ-02 and REQ-03). The book's\n * root holds which form is open; these parts read it. A trigger opens a form, and a placement part\n * shows it: `AccountAddressBookFormSlot` in place, `AccountAddressBookFormDialog` in a dialog. A store\n * chooses by composition, and no prop selects a layout.\n */\n\nexport type AccountAddressBookAddTriggerProps = ComponentPropsWithRef<'button'> & {\n  /** The button's text. A blank value falls back to the catalog copy. */\n  label?: string;\n};\n\nexport type AccountAddressBookEditTriggerProps = ComponentPropsWithRef<'button'> & {\n  /** The button's visible text. A blank value falls back to the catalog copy. */\n  label?: string;\n};\n\nexport type AccountAddressBookFormSlotProps = ComponentPropsWithRef<'div'>;\n\nexport type AccountAddressBookFormDialogProps = Readonly<{\n  children?: ReactNode;\n  /** Goes on the dialog's popup, the one element a store can size and place: the dialog renders in a portal. */\n  className?: string;\n  /** The dialog's title. A blank value falls back to the catalog copy for the open mode. */\n  title?: string;\n}>;\n\n/** A new key starts a new draft: a different address, or an add after an edit. */\nfunction formKey(form: AccountAddressBookOpenForm): string {\n  return form.mode === 'edit' ? `edit:${form.address.id}` : 'add';\n}\n\nexport function AccountAddressBookAddTrigger({\n  label,\n  className,\n  children,\n  onClick,\n  ...props\n}: AccountAddressBookAddTriggerProps) {\n  const { open } = useAccountAddressBook();\n  const intl = useIntl();\n\n  return (\n    <Button\n      {...props}\n      type=\"button\"\n      className={className}\n      onClick={(event) => {\n        onClick?.(event);\n        open({ mode: 'add' }, event.currentTarget);\n      }}\n      data-fs-account-address-book-add=\"\"\n    >\n      {children ?? resolveAuthoredCopy(label, intl.formatMessage({ id: 'fs/address-form.add' }))}\n    </Button>\n  );\n}\n\nexport function AccountAddressBookEditTrigger({\n  label,\n  className,\n  children,\n  onClick,\n  ...props\n}: AccountAddressBookEditTriggerProps) {\n  const { open } = useAccountAddressBook();\n  const address = useAccountAddressBookItem();\n  const intl = useIntl();\n  const text = resolveAuthoredCopy(label, intl.formatMessage({ id: 'fs/address-form.edit' }));\n  const line = firstLine(address);\n\n  return (\n    <Button\n      aria-label={line === '' ? undefined : `${text} ${line}`}\n      {...props}\n      type=\"button\"\n      className={className}\n      onClick={(event) => {\n        onClick?.(event);\n        open({ mode: 'edit', address }, event.currentTarget);\n      }}\n      data-fs-account-address-book-edit=\"\"\n    >\n      {children ?? text}\n    </Button>\n  );\n}\n\nexport function AccountAddressBookFormSlot({ children, ...props }: AccountAddressBookFormSlotProps) {\n  const { openForm } = useAccountAddressBook();\n\n  if (openForm === null) return null;\n\n  return (\n    <div {...props} key={formKey(openForm)} data-fs-account-address-book-form-slot=\"\">\n      {children}\n    </div>\n  );\n}\n\nexport function AccountAddressBookFormDialog({ title, className, children }: AccountAddressBookFormDialogProps) {\n  const { openForm, close, formPending } = useAccountAddressBook();\n  const intl = useIntl();\n  const defaultTitle = intl.formatMessage({\n    id: openForm?.mode === 'edit' ? 'fs/address-form.title.edit' : 'fs/address-form.title.add',\n  });\n\n  return (\n    <Dialog.Root\n      open={openForm !== null}\n      onOpenChange={(next) => {\n        // A save in flight keeps the form open: its refusal has to land where the shopper can see it.\n        if (!next && !formPending) close();\n      }}\n    >\n      <Dialog.Portal>\n        <Dialog.Backdrop />\n        <Dialog.Viewport>\n          <Dialog.Popup className={className} data-fs-account-address-book-form-dialog=\"\">\n            <Dialog.Title>{resolveAuthoredCopy(title, defaultTitle)}</Dialog.Title>\n            <Dialog.Close aria-label={intl.formatMessage({ id: 'fs/a11y.close' })}>×</Dialog.Close>\n            {openForm === null ? null : <div key={formKey(openForm)}>{children}</div>}\n          </Dialog.Popup>\n        </Dialog.Viewport>\n      </Dialog.Portal>\n    </Dialog.Root>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const AccountAddressBookAddTriggerDefinition = defineComponent<AccountAddressBookAddTriggerProps>({\n  name: 'AccountAddressBookAddTrigger',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookAddTrigger,\n  requiresContext: 'account-address-book',\n  editor: { label: 'Account Address Book Add Trigger', category: 'action' },\n  schema: {\n    label: { type: 'string', label: 'Button label' },\n  },\n  guideline:\n    'Opens the address form in add mode. Shown in every state of the book, the empty one included, since that is where a first address is added. Place an AccountAddressBookFormSlot or an AccountAddressBookFormDialog beside it to show the form. Must be inside AccountAddressBookRoot.',\n});\n\nexport const AccountAddressBookEditTriggerDefinition = defineComponent<AccountAddressBookEditTriggerProps>({\n  name: 'AccountAddressBookEditTrigger',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookEditTrigger,\n  requiresContext: 'account-address-book-item',\n  editor: { label: 'Account Address Book Edit Trigger', category: 'action' },\n  schema: {\n    label: { type: 'string', label: 'Button label' },\n  },\n  guideline:\n    \"Opens the address form in edit mode for the address of the entry it sits in. Its accessible name adds the address's first line, so a list of them is told apart. Place it inside AccountAddressBookItem, and an AccountAddressBookFormSlot or an AccountAddressBookFormDialog under the root to show the form.\",\n});\n\nexport const AccountAddressBookFormSlotDefinition = defineComponent<AccountAddressBookFormSlotProps>({\n  name: 'AccountAddressBookFormSlot',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookFormSlot,\n  requiresContext: 'account-address-book',\n  editor: { label: 'Account Address Book Form Slot', category: 'layout' },\n  schema: {},\n  guideline:\n    'Shows its children, an AccountAddressFormRoot, in place while a form is open, and nothing otherwise. Each open starts a new draft. Use it to open the form inline under the list; use AccountAddressBookFormDialog for an overlay. Must be inside AccountAddressBookRoot.',\n});\n\nexport const AccountAddressBookFormDialogDefinition = defineComponent<AccountAddressBookFormDialogProps>({\n  name: 'AccountAddressBookFormDialog',\n  importPath: '@vtex/faststore/components',\n  component: AccountAddressBookFormDialog,\n  requiresContext: 'account-address-book',\n  editor: { label: 'Account Address Book Form Dialog', category: 'layout' },\n  schema: {\n    title: { type: 'string', label: 'Dialog title' },\n  },\n  guideline:\n    'Shows its children, an AccountAddressFormRoot, in a modal dialog while a form is open. Escape and the close button cancel the form and drop the draft, and focus returns to the control that opened it. Use AccountAddressBookFormSlot instead to open the form in place. Must be inside AccountAddressBookRoot.',\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,25 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { PageRef } from "../../sdk/navigation/types.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/account-address-book/account-address-book-profile-notice.d.ts
+/** The profile fields the notice reads. */
+export type AccountAddressBookProfileNoticeSlice = Readonly<{
+  __typename?: 'CustomerProfile';
+  id: string;
+  homePhone?: string | null;
+}>;
+export type AccountAddressBookProfileNoticeProps = ComponentPropsWithRef<'div'> & {
+  /** Unwrapped `customerProfile` from the reactive runtime (arity-1 fragment); `null` until resolved. */
+  $data?: AccountAddressBookProfileNoticeSlice | null;
+  /** Where the link goes. A blank value falls back to the default. */
+  href?: PageRef | string;
+  /** The notice text. A blank value falls back to the catalog copy. */
+  message?: string;
+  /** The link's label. A blank value falls back to the catalog copy. */
+  linkLabel?: string;
+};
+export declare const AccountAddressBookProfileNoticeDefinition: ComponentDefinition<AccountAddressBookProfileNoticeProps>;
+export declare function AccountAddressBookProfileNotice({ $data: $dataProp, href, message, linkLabel, className, ...props }: AccountAddressBookProfileNoticeProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=account-address-book-profile-notice.d.ts.map

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