@vtex/faststore 0.0.7 → 0.0.8

package/dist/catalog.json

@@ -519,6 +519,38 @@
     "schema": {},
     "docPath": "src/particles/container/container.md"
   },
+  "CopyText": {
+    "name": "CopyText",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Copy Text",
+      "category": "action"
+    },
+    "schema": {
+      "accessibleName": {
+        "type": "string",
+        "default": "Copy",
+        "label": "Accessible name"
+      },
+      "successMessage": {
+        "type": "string",
+        "default": "Copied",
+        "label": "Success message"
+      },
+      "failureMessage": {
+        "type": "string",
+        "default": "Could not copy",
+        "label": "Failure message"
+      },
+      "dismissLabel": {
+        "type": "string",
+        "default": "Dismiss",
+        "label": "Dismiss label"
+      }
+    },
+    "guideline": "Copies the text it is given and confirms the result inline. Pass the identifier as text and the visible icon or label as children. Do not pass surrounding heading text.",
+    "docPath": "src/particles/copy-text/copy-text.md"
+  },
   "DialogRoot": {
     "name": "DialogRoot",
     "importPath": "@vtex/faststore/components",
@@ -654,7 +686,7 @@
         "label": "Disabled"
       }
     },
-    "guideline": "Presentational tax-document input composing the Field particle; applies the locale mask on change and runs check-digit validation on blur/submit. Data-agnostic (value/defaultValue/onValueChange); a host wires it to the shopper profile. CPF is optional by default: requirement only ever raises the field to required, announced as aria-required, and bound to a fieldset whose rule already says required it cannot lower it back. Recomposable (RFC:503): given children, they replace the default Field.Label + DocumentFieldInput + Field.Error anatomy, in any order.",
+    "guideline": "Presentational tax-document input composing the Field particle; applies the mask of its document type on change and runs the matching validation on blur/submit; documentType is one of CPF, SSN, SIN or RFC. Data-agnostic (value/defaultValue/onValueChange); a host wires it to the shopper profile. The document is optional by default: requirement only ever raises the field to required, announced as aria-required, and bound to a fieldset whose rule already says required it cannot lower it back. Recomposable (RFC:503): given children, they replace the default Field.Label + DocumentFieldInput + Field.Error anatomy, in any order.",
     "docPath": "src/particles/document-field/document-field.md"
   },
   "DocumentFieldInput": {
@@ -1552,8 +1584,10 @@
         "label": "Alt Text"
       },
       "href": {
-        "type": "string",
-        "default": "/",
+        "type": "link",
+        "default": {
+          "standard": "home"
+        },
         "label": "Link Destination"
       },
       "loading": {
@@ -1906,7 +1940,7 @@
     },
     "schema": {
       "href": {
-        "type": "string",
+        "type": "link",
         "label": "URL"
       },
       "target": {
@@ -1918,7 +1952,7 @@
         "label": "Target"
       }
     },
-    "guideline": "Client-side navigation link built on Next.js Link. Use for all internal navigation to avoid full-page reloads. Set target to _blank to open the destination in a new tab; when you do, write an \"(opens in new tab)\" cue into the link text, because the component adds no announcement of its own. A CMS entry overrides the link text, href, and target at runtime; a destination it supplies that is not an http, https, mailto, tel, or site-relative URL is refused and the authored href stands.",
+    "guideline": "Client-side navigation link that renders StorefrontLink, where href is a page reference or a logical path. Use for all internal navigation to avoid full-page reloads. Set target to _blank to open the destination in a new tab; when you do, write an \"(opens in new tab)\" cue into the link text, because the component adds no announcement of its own. A CMS entry overrides the link text, href, and target at runtime; a destination it supplies that is not an http, https, mailto, tel, or site-relative URL is refused and the authored href stands.",
     "docPath": "src/particles/navigation-link/navigation-link.md"
   },
   "NavigationLinkList": {
@@ -2202,6 +2236,29 @@
     "schema": {},
     "guideline": "Button inside NumberField.Group that increments the value by step. Disabled automatically when max is reached."
   },
+  "OrderDetailsBack": {
+    "name": "OrderDetailsBack",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-details-back",
+    "editor": {
+      "label": "Order Details Back",
+      "category": "action"
+    },
+    "schema": {},
+    "guideline": "The return from one order to the order list. Place it first on the order page when the layout has no account breadcrumb. The label is content; a blank field keeps the catalogue.",
+    "docPath": "src/particles/order-details-back/order-details-back.md"
+  },
+  "OrderStatusBadge": {
+    "name": "OrderStatusBadge",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Order Status Badge",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "Shopper-facing order status. Pass the completion view, the label id, and a tone. A messages entry replaces the catalogue sentence for that label; a blank entry and an unknown label keep the catalogue.",
+    "docPath": "src/particles/order-status-badge/order-status-badge.md"
+  },
   "PasswordField": {
     "name": "PasswordField",
     "importPath": "@vtex/faststore/components",
@@ -2870,7 +2927,7 @@
           "center",
           "end"
         ],
-        "default": "center",
+        "default": "start",
         "label": "Align"
       },
       "sideOffset": {
@@ -2880,11 +2937,11 @@
       },
       "alignItemWithTrigger": {
         "type": "boolean",
-        "default": true,
+        "default": false,
         "label": "Align Item With Trigger"
       }
     },
-    "guideline": "Positions the popup relative to the trigger. Use side and align to control placement; alignItemWithTrigger=true overlaps the trigger to align the selected item visually.",
+    "guideline": "Positions the popup relative to the trigger. Use side and align to control placement. The popup opens below the trigger by default; alignItemWithTrigger=true makes it cover the trigger to align the selected item with it.",
     "docPath": "src/particles/select/select.md"
   },
   "SelectScrollUpArrow": {
@@ -2912,7 +2969,7 @@
       "category": "layout"
     },
     "schema": {},
-    "guideline": "Visible container for the select list. Apply background, shadow, and border styles here.",
+    "guideline": "Visible container for the select list. Apply background, shadow, and border styles here. The base stylesheet bounds it to the viewport (max-height from --available-height, as a flex column) so the list scrolls inside it; a utility class such as max-h-60 overrides that bound.",
     "docPath": "src/particles/select/select.md"
   },
   "SelectArrow": {
@@ -2934,7 +2991,7 @@
       "category": "layout"
     },
     "schema": {},
-    "guideline": "Scrollable container for all Select.Item elements. Apply max-height and overflow for scrolling.",
+    "guideline": "Scrollable container for all Select.Item elements. The base stylesheet makes it scroll (overflow-y: auto) inside the popup bound; an overflow-* utility class overrides that.",
     "docPath": "src/particles/select/select.md"
   },
   "SelectItem": {
@@ -3224,7 +3281,7 @@
         "label": "Default Auto-Dismiss (ms)"
       }
     },
-    "guideline": "Mount once at the layout root to enable toasts anywhere in the tree. Compose as: ToastProvider > ToastPortal > ToastViewport > (ToastRoot per active toast). Components trigger toasts via the useToast() hook, not through page-schema composition.",
+    "guideline": "Mount once at the layout root to enable toasts anywhere in the tree. Compose as: ToastProvider > ToastPortal > ToastViewport (a childless viewport renders the active toasts itself; add ToastRoot children only to override). Components trigger toasts via the useToast() hook, not through page-schema composition.",
     "docPath": "src/particles/toast/toast.md"
   },
   "ToastPortal": {
@@ -3246,7 +3303,7 @@
       "category": "layout"
     },
     "schema": {},
-    "guideline": "The fixed-position stack container for all active toasts. Position it with a swatch on data-fs-toast-viewport (e.g. bottom-right vs. top-center). Direct child of ToastPortal.",
+    "guideline": "The fixed-position stack container for all active toasts. With no children it renders every active toast itself (title, description, action and a localized close button), so a page schema needs only ToastProvider > ToastPortal > ToastViewport. Pass children (a ToastRoot per useToast().toasts entry) to take control of the markup. Position it with a swatch on data-fs-toast-viewport (e.g. bottom-right vs. top-center). Direct child of ToastPortal.",
     "docPath": "src/particles/toast/toast.md"
   },
   "ToastRoot": {
@@ -3257,7 +3314,7 @@
       "category": "layout"
     },
     "schema": {},
-    "guideline": "One instance per active toast, rendered by mapping over useToast().toasts. Compose as: ToastRoot > (Icon + ToastTitle + ToastDescription + ToastAction + ToastClose), all optional except at least one of Title/Description.",
+    "guideline": "One instance per active toast. A childless ToastViewport renders these itself; compose ToastRoot only to override that, by mapping over useToast().toasts. Compose as: ToastRoot > (Icon + ToastTitle + ToastDescription + ToastAction + ToastClose), all optional except at least one of Title/Description.",
     "docPath": "src/particles/toast/toast.md"
   },
   "ToastTitle": {
@@ -3630,190 +3687,701 @@
         "label": "Sign-in Link Label"
       }
     },
-    "guideline": "The account's single access decision: place it once in the account layout, wrapping the body, and every page that declares that layout inherits it — never restate it per section. It renders its children only for a logged-in shopper; it shows a composed loading look while the session resolves, replaces the current history entry with the sign-in destination for a visitor who arrived signed out (identified counts as signed out), tells a shopper whose session ended mid-visit rather than bouncing them, and stands down while AccountMenuSignOut navigates. It redirects at most once per visit: a shopper who comes back from sign-in still signed out gets a message and a link rather than a second hop. Must be inside SessionRoot, which the same layout hosts. Never place the /login route under it — the gate redirects there, and a gated /login would redirect to itself.",
+    "guideline": "The account's single access decision: place it once in the account layout, wrapping the body, and every page that declares that layout inherits it — never restate it per section. It renders its children only for a logged-in shopper; it shows a composed loading look while the session resolves, replaces the current history entry with the sign-in destination for a visitor who arrived signed out (identified counts as signed out), tells a shopper whose session ended mid-visit rather than bouncing them, and stands down while AccountMenuSignOut navigates. It redirects at most once per visit: a shopper who comes back from sign-in still signed out gets a message and a link rather than a second hop. Must be inside SessionRoot, which the same layout hosts. Never place the sign-in page under it — the gate redirects there, and a gated sign-in page would redirect to itself.",
     "docPath": "src/matter/account-access-gate/account-access-gate.md"
   },
-  "AccountEntryPoint": {
-    "name": "AccountEntryPoint",
+  "AccountAddressBookDeleteTrigger": {
+    "name": "AccountAddressBookDeleteTrigger",
     "importPath": "@vtex/faststore/components",
-    "contentTypeId": "account-entry-point",
+    "requiresContext": "account-address-book-item",
     "editor": {
-      "label": "Account Entry Point",
-      "category": "identity"
+      "label": "Account Address Book Delete Trigger",
+      "category": "action"
     },
-    "requiresContext": "session",
     "schema": {
-      "signedOutLabel": {
+      "label": {
         "type": "string",
-        "label": "Signed-out Label"
+        "label": "Button label"
+      }
+    },
+    "guideline": "Asks to delete the address of the entry it sits in. Nothing is deleted until the shopper confirms in an AccountAddressBookDeleteConfirm. Its accessible name adds the address's first line, so a list of them is told apart. Place it inside AccountAddressBookItem, and one AccountAddressBookDeleteConfirm under the root to ask the question."
+  },
+  "AccountAddressBookDeleteConfirm": {
+    "name": "AccountAddressBookDeleteConfirm",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-book",
+    "actions": {
+      "address": [
+        "remove"
+      ]
+    },
+    "editor": {
+      "label": "Account Address Book Delete Confirm",
+      "category": "layout"
+    },
+    "schema": {
+      "title": {
+        "type": "string",
+        "label": "Question"
       },
-      "signedInLabel": {
+      "description": {
         "type": "string",
-        "label": "Signed-in Label"
+        "label": "What deleting means"
       },
-      "icon": {
-        "type": "icon",
-        "label": "Icon"
+      "cancelLabel": {
+        "type": "string",
+        "label": "Cancel label"
       },
-      "loadingLabel": {
+      "confirmLabel": {
         "type": "string",
-        "label": "Loading Announcement"
+        "label": "Delete label"
+      },
+      "deletedMessage": {
+        "type": "string",
+        "label": "Address deleted message"
+      },
+      "failedMessage": {
+        "type": "string",
+        "label": "Not deleted message"
+      },
+      "unauthorizedMessage": {
+        "type": "string",
+        "label": "Session expired message"
       }
     },
-    "guideline": "Session-aware header control rendering one link: the signed-out label toward /login for anonymous and identified shoppers, the signed-in label toward the account route for logged-in ones, and a politely announced placeholder while the session resolves. Both destinations are fixed conventions, not props, so no authored value can misroute the auth flow. Must be inside a SessionRoot, normally the one hosted by the shared layout; a page-hosted provider also works, since the server-side session fetch forwards the shopper cookie. Author the label for a state or that state renders nothing; the labels are optional in the type only because a CMS entry may supply them, and an entry overrides all four fields at runtime. Style it through data-fs-account-entry-point and switch on data-fs-account-entry-point-state.",
-    "docPath": "src/matter/account-entry-point/account-entry-point.md"
+    "guideline": "The alert dialog that asks before an address is deleted, one per address book, opened by AccountAddressBookDeleteTrigger. Names the address, takes focus on Cancel, and closes only on Cancel or Escape: a click outside does nothing. Confirming removes the address, shows a toast and closes; a refusal keeps the dialog open with a message and lets the shopper try again. While the call runs, nothing closes it. Deleting the last address leaves the book empty, so compose an AccountAddressBookEmpty. Requires a ToastProvider ancestor, since the success toast throws without one. Place it under AccountAddressBookRoot. See account-address-book.md."
   },
-  "AccountMenuRoot": {
-    "name": "AccountMenuRoot",
+  "AccountAddressBookItemDeliverability": {
+    "name": "AccountAddressBookItemDeliverability",
     "importPath": "@vtex/faststore/components",
-    "contentTypeId": "account-menu",
-    "providesContext": "account-menu",
+    "fragment": "\n  fragment AccountAddressBookItemDeliverabilityData on Query {\n    shippingCountries {\n      countries\n      source\n    }\n  }\n",
+    "fetchStrategy": "reactive",
+    "requiresContext": "account-address-book-item",
+    "skeleton": "AccountAddressBookSkeleton",
     "editor": {
-      "label": "Account Menu Root",
-      "category": "navigation"
+      "label": "Account Address Book Item Deliverability",
+      "category": "content"
     },
     "schema": {
-      "items": {
-        "type": "array",
-        "label": "Sections"
+      "message": {
+        "type": "string",
+        "label": "Marker message"
       }
     },
-    "guideline": "The account menu's provider, and deliberately not its landmark: it resolves the section list, derives which section the shopper is reading, publishes both, and renders its children. Compose it in the my-account layout around both AccountMenuList and the Slot holding the section's own page — its context has to reach the consumers inside the slot, and a nav stretched that far would announce every section's content as navigation. The list comes from a published entry, else the authored items prop, else the library's five defaults; a channel supplying an empty list resolves to empty rather than falling through, because a merchant who cleared the list cleared it. Style it through data-fs-account-menu.",
-    "docPath": "src/matter/account-menu/account-menu.md"
+    "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."
   },
-  "AccountMenuList": {
-    "name": "AccountMenuList",
+  "AccountAddressBookAddTrigger": {
+    "name": "AccountAddressBookAddTrigger",
     "importPath": "@vtex/faststore/components",
-    "requiresContext": "account-menu",
+    "requiresContext": "account-address-book",
     "editor": {
-      "label": "Account Menu List",
-      "category": "navigation"
+      "label": "Account Address Book Add Trigger",
+      "category": "action"
     },
     "schema": {
       "label": {
         "type": "string",
-        "default": "Account",
-        "label": "Aria Label"
+        "label": "Button label"
       }
     },
-    "guideline": "The account menu's navigation landmark and its items, and nothing else — it surrounds the items alone so the section's own content stays outside the navigation region. Author the label: a landmark with no accessible name is one a screen-reader user cannot tell from any other. The current section carries aria-current, page for the section itself and true for a page inside it, with data-fs-account-menu-item-current beside it as a style target and never as the only signal. When the list scrolls, the current item is brought into view on mount and on every route change. Must be a descendant of AccountMenuRoot.",
-    "docPath": "src/matter/account-menu/account-menu.md"
+    "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."
   },
-  "AccountMenuIndexRedirect": {
-    "name": "AccountMenuIndexRedirect",
+  "AccountAddressBookEditTrigger": {
+    "name": "AccountAddressBookEditTrigger",
     "importPath": "@vtex/faststore/components",
-    "contentTypeId": "account-menu-index-redirect",
-    "requiresContext": "account-menu",
+    "requiresContext": "account-address-book-item",
     "editor": {
-      "label": "Account Menu Index Redirect",
-      "category": "navigation"
+      "label": "Account Address Book Edit Trigger",
+      "category": "action"
     },
     "schema": {
-      "loadingLabel": {
-        "type": "string",
-        "label": "Loading Announcement"
-      },
-      "emptyMessage": {
+      "label": {
         "type": "string",
-        "default": "No account section is configured.",
-        "label": "No Section Message"
+        "label": "Button label"
       }
     },
-    "guideline": "The whole of the account's root page: it replaces the current history entry with the first section of the merchant's list that stays in the account, skipping one marked external, one whose destination was refused or is not site-relative, and the root itself. It shows the access gate's loading look until the section opens. A list with no such section leaves the root terminal — no navigation, and the no-section message in its place — rather than falling back to the library's defaults. Place it alone on the /pvt/account page, inside AccountMenuRoot and under AccountAccessGate, which the my-account layout provides; never on a section's own page, which it would navigate away from.",
-    "docPath": "src/matter/account-menu/account-menu.md"
+    "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."
   },
-  "AccountMenuSignOut": {
-    "name": "AccountMenuSignOut",
+  "AccountAddressBookFormSlot": {
+    "name": "AccountAddressBookFormSlot",
     "importPath": "@vtex/faststore/components",
-    "contentTypeId": "account-menu-sign-out",
-    "actions": {
-      "session": [
-        "logout"
-      ]
+    "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."
+  },
+  "AccountAddressBookFormDialog": {
+    "name": "AccountAddressBookFormDialog",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-book",
     "editor": {
-      "label": "Account Menu Sign Out",
-      "category": "navigation"
+      "label": "Account Address Book Form Dialog",
+      "category": "layout"
     },
     "schema": {
-      "label": {
+      "title": {
         "type": "string",
-        "default": "Sign out",
-        "label": "Label"
+        "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."
+  },
+  "AccountAddressBookProfileNotice": {
+    "name": "AccountAddressBookProfileNotice",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment AccountAddressBookProfileNoticeData on Query {\n    customerProfile {\n      __typename\n      id\n      homePhone\n    }\n  }\n",
+    "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"
       },
-      "errorMessage": {
+      "message": {
         "type": "string",
-        "default": "We couldn't sign you out. Please try again.",
-        "label": "Sign-out Failed Message"
+        "label": "Notice message"
+      },
+      "linkLabel": {
+        "type": "string",
+        "label": "Link label"
       }
     },
-    "guideline": "The account sidebar's way out: it dispatches $actions.session.logout, tells AccountAccessGate the departure is deliberate so the gate stands down instead of sending the shopper to sign in, and then loads the storefront home as a new document, which is what keeps the account out of the client router's cache. A logout that reports an error keeps the shopper on the account page with the failure message rather than landing a still-signed-in shopper on the home page. Compose it inside AccountMenuRoot beside AccountMenuList, under the gate the my-account layout provides — the back-forward cache is the gate's to revalidate, not this control's.",
-    "docPath": "src/matter/account-menu/account-menu.md"
+    "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."
   },
-  "AccountMenuIdentity": {
-    "name": "AccountMenuIdentity",
+  "AccountAddressBookRoot": {
+    "name": "AccountAddressBookRoot",
     "importPath": "@vtex/faststore/components",
-    "fragment": "\n  fragment AccountMenuIdentityData on Query {\n    customerProfile {\n      __typename\n      id\n      firstName\n      lastName\n      email\n    }\n  }\n",
+    "fragment": "\n  fragment AccountAddressBookRootData on Query {\n    customerAddressBook {\n      __typename\n      id\n      addresses {\n        __typename\n        id\n      }\n    }\n  }\n",
     "fetchStrategy": "reactive",
     "requiresContext": "session",
-    "skeleton": "AccountMenuIdentitySkeleton",
+    "providesContext": "account-address-book",
+    "skeleton": "AccountAddressBookSkeleton",
     "editor": {
-      "label": "Account Menu Identity",
+      "label": "Account Address Book",
       "category": "identity"
     },
     "schema": {},
-    "guideline": "The shopper's name and initials avatar, read reactively from the persistent profile. Compose it in the my-account layout, never on a page, so its fragment joins the layout's query, which runs in the browser where the shopper's cookie is; place it under AccountAccessGate, inside AccountMenuRoot beside AccountMenuList and never inside it, so it stays outside the navigation landmark. It reads the session, so a SessionRoot must be an ancestor. It renders a skeleton until the layout's query settles, and nothing for a session that is not loggedIn, for a read that returned no profile, or for a profile with neither a name nor an email. Style it through data-fs-account-menu-identity, and hide it below the md breakpoint with the store's swatch.",
-    "docPath": "src/matter/account-menu-identity/account-menu-identity.md"
+    "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.",
+    "docPath": "src/matter/account-address-book/account-address-book.md"
   },
-  "AccountMenuIdentitySkeleton": {
-    "name": "AccountMenuIdentitySkeleton",
+  "AccountAddressBookList": {
+    "name": "AccountAddressBookList",
     "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-book",
     "editor": {
-      "label": "Account Menu Identity Skeleton",
-      "category": "identity"
+      "label": "Account Address Book List",
+      "category": "content"
     },
     "schema": {},
-    "guideline": "Loading placeholder rendered by AccountMenuIdentity while the profile is unresolved. Declares no context requirement — it renders before the matter has anything to show.",
-    "docPath": "src/matter/account-menu-identity/account-menu-identity.md"
+    "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.",
+    "docPath": "src/matter/account-address-book/account-address-book.md"
   },
-  "BillingAddress": {
-    "name": "BillingAddress",
+  "AccountAddressBookItem": {
+    "name": "AccountAddressBookItem",
     "importPath": "@vtex/faststore/components",
-    "requiresContext": "payment",
-    "actions": {
-      "payment": [
-        "setBillingAddress"
-      ]
+    "fragment": "\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",
+    "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.",
+    "docPath": "src/matter/account-address-book/account-address-book.md"
+  },
+  "AccountAddressBookItemLines": {
+    "name": "AccountAddressBookItemLines",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-book-item",
     "editor": {
-      "label": "Billing Address",
-      "category": "commerce"
+      "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.",
+    "docPath": "src/matter/account-address-book/account-address-book.md"
+  },
+  "AccountAddressBookLoading": {
+    "name": "AccountAddressBookLoading",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-book",
+    "editor": {
+      "label": "Account Address Book Loading",
+      "category": "content"
     },
     "schema": {
-      "sameAsDeliveryLabel": {
+      "message": {
         "type": "string",
-        "default": "Billing address same as delivery address",
-        "label": "Same-as-delivery toggle label"
+        "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.",
+    "docPath": "src/matter/account-address-book/account-address-book.md"
+  },
+  "AccountAddressBookEmpty": {
+    "name": "AccountAddressBookEmpty",
+    "importPath": "@vtex/faststore/components",
+    "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.",
+    "docPath": "src/matter/account-address-book/account-address-book.md"
+  },
+  "AccountAddressBookError": {
+    "name": "AccountAddressBookError",
+    "importPath": "@vtex/faststore/components",
+    "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.",
+    "docPath": "src/matter/account-address-book/account-address-book.md"
+  },
+  "AddressCountryControl": {
+    "name": "AddressCountryControl",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment AddressCountryControlData on Query {\n    shippingCountries {\n      countries\n      source\n    }\n  }\n",
+    "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."
+  },
+  "AccountAddressCountryNotice": {
+    "name": "AccountAddressCountryNotice",
+    "importPath": "@vtex/faststore/components",
+    "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."
+  },
+  "AccountAddressFormRoot": {
+    "name": "AccountAddressFormRoot",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "session",
+    "providesContext": "account-address-form",
+    "actions": {
+      "address": [
+        "create",
+        "update"
+      ]
+    },
+    "editor": {
+      "label": "Account Address Form",
+      "category": "identity"
+    },
+    "schema": {
       "defaultCountry": {
         "type": "string",
         "default": "BRA",
-        "label": "Default country (ISO-3)"
+        "label": "Preferred country (ISO-3)"
       },
-      "countryLabel": {
+      "addedMessage": {
         "type": "string",
-        "default": "Country",
-        "label": "Country field label"
+        "label": "Address added message"
       },
-      "submitLabel": {
+      "savedMessage": {
         "type": "string",
-        "default": "Save billing address",
-        "label": "Submit button label"
+        "label": "Address saved message"
       },
-      "submitPendingLabel": {
+      "blockedMessage": {
         "type": "string",
-        "default": "Saving...",
-        "label": "Submit button pending label"
+        "label": "Save blocked message"
+      },
+      "returnHref": {
+        "type": "link",
+        "default": {
+          "standard": "address"
+        },
+        "label": "Return page"
+      }
+    },
+    "guideline": "The form that adds an address or corrects a saved one, with the fields, order and options of the address's country. Opens through AccountAddressBookAddTrigger and AccountAddressBookEditTrigger, placed by AccountAddressBookFormSlot or AccountAddressBookFormDialog. Requires a SessionRoot and a mounted ToastProvider ancestor: saving shows a toast and closes the form. On its own page (add: no ancestor; edit: inside AccountAddressRecord) leaving the form, by a save, a save with no changes or Cancel, goes to returnHref instead, so mount the ToastProvider in the layout for the toast to outlive the navigation. A new address takes defaultCountry when the store ships there or the list is unknown, else the first country the store ships to; the shopper picks another through AddressCountryControl. A saved address keeps its own country, shown as text. A save the form or the server blocks marks each field, moves focus to the first one and announces it, and keeps what was typed. With no children it renders AddressCountryControl, AccountAddressCountryNotice, RecipientName, Fields, Reference, Error, Submit and Cancel; that control gets no list there and shows defaultCountry as text, so compose AddressCountryControl explicitly to offer the choice. See account-address-book.md."
+  },
+  "AccountAddressFormRecipientName": {
+    "name": "AccountAddressFormRecipientName",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-form",
+    "editor": {
+      "label": "Account Address Form Recipient Name",
+      "category": "input"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Field label"
+      }
+    },
+    "guideline": "The name of the person who receives the order. Required for every country. Place it first, before AccountAddressFormFields. Shown once the country's rules have loaded. Must be inside AccountAddressFormRoot."
+  },
+  "AccountAddressFormFields": {
+    "name": "AccountAddressFormFields",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-form",
+    "editor": {
+      "label": "Account Address Form Fields",
+      "category": "input"
+    },
+    "schema": {},
+    "guideline": "One field per field the address's country asks for, in the order that country's form lists them, with its labels, limits and lists: Brazil's city is a list that follows its state. Changing a list clears the fields that depend on it. Shown once the country's rules have loaded. Must be inside AccountAddressFormRoot."
+  },
+  "AccountAddressFormReference": {
+    "name": "AccountAddressFormReference",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-form",
+    "editor": {
+      "label": "Account Address Form Reference",
+      "category": "input"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Field label"
+      }
+    },
+    "guideline": "A landmark that helps the carrier find the address. Optional. Place it after AccountAddressFormFields. Shown once the country's rules have loaded. Must be inside AccountAddressFormRoot."
+  },
+  "AccountAddressFormError": {
+    "name": "AccountAddressFormError",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-form",
+    "editor": {
+      "label": "Account Address Form Error",
+      "category": "content"
+    },
+    "schema": {
+      "unrenderedFieldMessage": {
+        "type": "string",
+        "label": "Field not shown message"
+      },
+      "notFoundMessage": {
+        "type": "string",
+        "label": "Address gone message"
+      },
+      "unauthorizedMessage": {
+        "type": "string",
+        "label": "Session expired message"
+      },
+      "saveFailedMessage": {
+        "type": "string",
+        "label": "Save failed message"
+      },
+      "rulesFailedMessage": {
+        "type": "string",
+        "label": "Form failed to load message"
+      },
+      "countrySwitchFailedMessage": {
+        "type": "string",
+        "label": "Country change failed message"
+      },
+      "unsupportedCountryMessage": {
+        "type": "string",
+        "label": "Country not delivered message"
+      }
+    },
+    "guideline": "The error about the whole form, as an alert: a refusal on a field this form does not show, an address that no longer exists, an expired session, a failed save, a form that could not load, a country change that could not load, or a country the store doesn't deliver to. Renders nothing when there is none. Must be inside AccountAddressFormRoot."
+  },
+  "AccountAddressFormSubmit": {
+    "name": "AccountAddressFormSubmit",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-form",
+    "editor": {
+      "label": "Account Address Form Submit",
+      "category": "action"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Button label"
+      }
+    },
+    "guideline": "Saves the form. Disabled until the country's rules have loaded, while a country change loads, and while a save is in flight, and marked busy then. Must be inside AccountAddressFormRoot."
+  },
+  "AccountAddressFormCancel": {
+    "name": "AccountAddressFormCancel",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-form",
+    "editor": {
+      "label": "Account Address Form Cancel",
+      "category": "action"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Button label"
+      }
+    },
+    "guideline": "Closes the form and drops what was typed. On its own page it goes to the returnHref of its root. Must be inside AccountAddressFormRoot."
+  },
+  "AccountAddressRecord": {
+    "name": "AccountAddressRecord",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment AccountAddressRecordData on Query {\n    customerAddress(id: $id) {\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",
+    "fetchStrategy": "reactive",
+    "requiresContext": "session",
+    "providesContext": "account-address-record",
+    "skeleton": "AccountAddressBookSkeleton",
+    "editor": {
+      "label": "Account Address Record",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "The one saved address the page's route names, read by the route's [id] segment: place it on a page whose route ends in [id], around an AccountAddressFormRoot, which then opens in edit mode seeded with it. Renders nothing unless the session is logged in, so it needs a SessionRoot ancestor. An id that is not the shopper's, or that never existed, answers with the layout's not-found page and never reaches this component. Add AccountAddressRecordError to show a read that failed. While no address has resolved, the form beneath renders nothing, so it never falls back to adding. See account-address-book.md."
+  },
+  "AccountAddressRecordError": {
+    "name": "AccountAddressRecordError",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-address-record",
+    "editor": {
+      "label": "Account Address Record Error",
+      "category": "content"
+    },
+    "schema": {
+      "message": {
+        "type": "string",
+        "label": "Error message"
+      },
+      "retryLabel": {
+        "type": "string",
+        "label": "Retry label"
+      }
+    },
+    "guideline": "Shown only when the address could not be read and none resolved: a message and a retry that reloads the page. Never shown for an id that does not exist, which is a not-found page. Must be inside AccountAddressRecord."
+  },
+  "AccountEntryPoint": {
+    "name": "AccountEntryPoint",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-entry-point",
+    "editor": {
+      "label": "Account Entry Point",
+      "category": "identity"
+    },
+    "requiresContext": "session",
+    "schema": {
+      "signedOutLabel": {
+        "type": "string",
+        "label": "Signed-out Label"
+      },
+      "signedInLabel": {
+        "type": "string",
+        "label": "Signed-in Label"
+      },
+      "icon": {
+        "type": "icon",
+        "label": "Icon"
+      },
+      "loadingLabel": {
+        "type": "string",
+        "label": "Loading Announcement"
+      }
+    },
+    "guideline": "Session-aware header control rendering one link: the signed-out label toward the sign-in page for anonymous and identified shoppers, the signed-in label toward the account page for logged-in ones, and a politely announced placeholder while the session resolves. Both destinations are fixed conventions, not props, so no authored value can misroute the auth flow. Must be inside a SessionRoot, normally the one hosted by the shared layout; a page-hosted provider also works, since the server-side session fetch forwards the shopper cookie. Author the label for a state or that state renders nothing; the labels are optional in the type only because a CMS entry may supply them, and an entry overrides all four fields at runtime. Style it through data-fs-account-entry-point and switch on data-fs-account-entry-point-state.",
+    "docPath": "src/matter/account-entry-point/account-entry-point.md"
+  },
+  "AccountMenuRoot": {
+    "name": "AccountMenuRoot",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-menu",
+    "providesContext": "account-menu",
+    "editor": {
+      "label": "Account Menu Root",
+      "category": "navigation"
+    },
+    "schema": {
+      "items": {
+        "type": "array",
+        "label": "Sections"
+      }
+    },
+    "guideline": "The account menu's provider, and deliberately not its landmark: it resolves the section list, derives which section the shopper is reading, publishes both, and renders its children. Compose it in the my-account layout around both AccountMenuList and the Slot holding the section's own page — its context has to reach the consumers inside the slot, and a nav stretched that far would announce every section's content as navigation. The list comes from a published entry, else the authored items prop, else the library's five defaults; a channel supplying an empty list resolves to empty rather than falling through, because a merchant who cleared the list cleared it. Style it through data-fs-account-menu.",
+    "docPath": "src/matter/account-menu/account-menu.md"
+  },
+  "AccountMenuList": {
+    "name": "AccountMenuList",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "account-menu",
+    "editor": {
+      "label": "Account Menu List",
+      "category": "navigation"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "default": "Account",
+        "label": "Aria Label"
+      }
+    },
+    "guideline": "The account menu's navigation landmark and its items, and nothing else — it surrounds the items alone so the section's own content stays outside the navigation region. Author the label: a landmark with no accessible name is one a screen-reader user cannot tell from any other. The current section carries aria-current, page for the section itself and true for a page inside it, with data-fs-account-menu-item-current beside it as a style target and never as the only signal. When the list scrolls, the current item is brought into view on mount and on every route change. Must be a descendant of AccountMenuRoot.",
+    "docPath": "src/matter/account-menu/account-menu.md"
+  },
+  "AccountMenuIndexRedirect": {
+    "name": "AccountMenuIndexRedirect",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-menu-index-redirect",
+    "requiresContext": "account-menu",
+    "editor": {
+      "label": "Account Menu Index Redirect",
+      "category": "navigation"
+    },
+    "schema": {
+      "loadingLabel": {
+        "type": "string",
+        "label": "Loading Announcement"
+      },
+      "emptyMessage": {
+        "type": "string",
+        "default": "No account section is configured.",
+        "label": "No Section Message"
+      }
+    },
+    "guideline": "The whole of the account's root page: it replaces the current history entry with the first section of the merchant's list that stays in the account, skipping one marked external, one whose destination was refused or is not site-relative, and the root itself. It shows the access gate's loading look until the section opens. A list with no such section leaves the root terminal — no navigation, and the no-section message in its place — rather than falling back to the library's defaults. Place it alone on the account page, inside AccountMenuRoot and under AccountAccessGate, which the my-account layout provides; never on a section's own page, which it would navigate away from.",
+    "docPath": "src/matter/account-menu/account-menu.md"
+  },
+  "AccountMenuSignOut": {
+    "name": "AccountMenuSignOut",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "account-menu-sign-out",
+    "actions": {
+      "session": [
+        "logout"
+      ]
+    },
+    "editor": {
+      "label": "Account Menu Sign Out",
+      "category": "navigation"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "default": "Sign out",
+        "label": "Label"
+      },
+      "errorMessage": {
+        "type": "string",
+        "default": "We couldn't sign you out. Please try again.",
+        "label": "Sign-out Failed Message"
+      }
+    },
+    "guideline": "The account sidebar's way out: it dispatches $actions.session.logout, tells AccountAccessGate the departure is deliberate so the gate stands down instead of sending the shopper to sign in, and then loads the storefront home as a new document, which is what keeps the account out of the client router's cache. A logout that reports an error keeps the shopper on the account page with the failure message rather than landing a still-signed-in shopper on the home page. Compose it inside AccountMenuRoot beside AccountMenuList, under the gate the my-account layout provides — the back-forward cache is the gate's to revalidate, not this control's.",
+    "docPath": "src/matter/account-menu/account-menu.md"
+  },
+  "AccountMenuIdentity": {
+    "name": "AccountMenuIdentity",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment AccountMenuIdentityData on Query {\n    customerProfile {\n      __typename\n      id\n      firstName\n      lastName\n      email\n    }\n  }\n",
+    "fetchStrategy": "reactive",
+    "requiresContext": "session",
+    "skeleton": "AccountMenuIdentitySkeleton",
+    "editor": {
+      "label": "Account Menu Identity",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "The shopper's name and initials avatar, read reactively from the persistent profile. Compose it in the my-account layout, never on a page, so its fragment joins the layout's query, which runs in the browser where the shopper's cookie is; place it under AccountAccessGate, inside AccountMenuRoot beside AccountMenuList and never inside it, so it stays outside the navigation landmark. It reads the session, so a SessionRoot must be an ancestor. It renders a skeleton until the layout's query settles, and nothing for a session that is not loggedIn, for a read that returned no profile, or for a profile with neither a name nor an email. Style it through data-fs-account-menu-identity, and hide it below the md breakpoint with the store's swatch.",
+    "docPath": "src/matter/account-menu-identity/account-menu-identity.md"
+  },
+  "AccountMenuIdentitySkeleton": {
+    "name": "AccountMenuIdentitySkeleton",
+    "importPath": "@vtex/faststore/components",
+    "editor": {
+      "label": "Account Menu Identity Skeleton",
+      "category": "identity"
+    },
+    "schema": {},
+    "guideline": "Loading placeholder rendered by AccountMenuIdentity while the profile is unresolved. Declares no context requirement — it renders before the matter has anything to show.",
+    "docPath": "src/matter/account-menu-identity/account-menu-identity.md"
+  },
+  "BillingAddress": {
+    "name": "BillingAddress",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "payment",
+    "actions": {
+      "payment": [
+        "setBillingAddress"
+      ]
+    },
+    "editor": {
+      "label": "Billing Address",
+      "category": "commerce"
+    },
+    "schema": {
+      "sameAsDeliveryLabel": {
+        "type": "string",
+        "default": "Billing address same as delivery address",
+        "label": "Same-as-delivery toggle label"
+      },
+      "defaultCountry": {
+        "type": "string",
+        "default": "BRA",
+        "label": "Default country (ISO-3)"
+      },
+      "countryLabel": {
+        "type": "string",
+        "default": "Country",
+        "label": "Country field label"
+      },
+      "submitLabel": {
+        "type": "string",
+        "default": "Save billing address",
+        "label": "Submit button label"
+      },
+      "submitPendingLabel": {
+        "type": "string",
+        "default": "Saving...",
+        "label": "Submit button pending label"
       },
       "requiredNoticeLabel": {
         "type": "string",
@@ -3880,6 +4448,11 @@
         "default": "This field is required.",
         "label": "Field required message"
       },
+      "postalCodeInvalidMessage": {
+        "type": "string",
+        "default": "Enter a valid postal code.",
+        "label": "Postal code format message"
+      },
       "disabled": {
         "type": "boolean",
         "default": false,
@@ -4049,6 +4622,11 @@
         "default": "Enter a valid card number",
         "label": "Number invalid message"
       },
+      "networkNotAcceptedMessage": {
+        "type": "string",
+        "default": "This card is not from a network the store accepts",
+        "label": "Network not accepted message"
+      },
       "holderNameRequiredMessage": {
         "type": "string",
         "default": "Cardholder name is required",
@@ -4099,17 +4677,14 @@
     "schema": {
       "label": {
         "type": "string",
-        "default": "CPF",
         "label": "Label"
       },
       "placeholder": {
         "type": "string",
-        "default": "000.000.000-00",
         "label": "Placeholder"
       },
       "errorMessage": {
         "type": "string",
-        "default": "Invalid CPF",
         "label": "Error message"
       },
       "disabled": {
@@ -4118,7 +4693,7 @@
         "label": "Disabled"
       }
     },
-    "guideline": "Cardholder tax-document field for the currently selected payment method (CPF only in this build): renders only when that method's validator marks a document displayable, and marks the input required when the validator marks the document required — the particle, not this leaf, decides whether a typed value is well-formed. Place as a sibling of CardEntry and SavedCards inside a PaymentSectionRoot or PaymentSectionController; renders nothing before a method is selected or when the selected method has no document to collect. The collected value is a plain draft fact — never a schema prop, a fragment field, or an action payload — and is unrelated to the shopper's saved profile document, which this component never reads. See cardholder-document.md.",
+    "guideline": "Cardholder tax-document field for the currently selected payment method: the store's country picks the document (SSN for the United States, CPF for Brazil, SIN for Canada, RFC for Mexico) with its own label, mask and validation, so leave label, placeholder and errorMessage unset unless the store serves one country. Renders only when that method's validator marks a document displayable and the country has a document type, and marks the input required when the validator marks the document required — the particle, not this leaf, decides whether a typed value is well-formed. Place as a sibling of CardEntry and SavedCards inside a PaymentSectionRoot or PaymentSectionController; renders nothing before a method is selected or when the selected method has no document to collect. The collected value is a plain draft fact — never a schema prop, a fragment field, or an action payload — and is unrelated to the shopper's saved profile document, which this component never reads. See cardholder-document.md.",
     "docPath": "src/matter/cardholder-document/cardholder-document.md"
   },
   "CartRoot": {
@@ -4206,8 +4781,10 @@
     },
     "schema": {
       "href": {
-        "type": "string",
-        "default": "/checkout",
+        "type": "link",
+        "default": {
+          "standard": "checkout"
+        },
         "label": "Checkout URL"
       },
       "label": {
@@ -4221,7 +4798,7 @@
         "validate"
       ]
     },
-    "guideline": "Navigation link to the checkout page (default href /checkout); use as the checkout CTA inside the cart summary. In a mini-cart it is the DrawerPopup footer CTA, next to CartTotal. The button wording is merchant-editable content: a CMS entry wins, then the label prop (default \"Checkout\"), then children — so a store that labels the button through children keeps working and a CMS save overrides it without a deploy. The destination is not content-editable: href stays an authored prop, because re-pointing checkout is not a copy decision. Before routing it runs a stock validation and only navigates when the re-checked cart has no unavailable line; a validation that cannot run falls open and navigates anyway. During a client-side route transition to checkout it surfaces a loading state on its content wrapper as aria-busy plus data-fs-cart-go-checkout-pending, and while the pre-checkout validation runs it exposes data-fs-cart-go-checkout-validating — there is no built-in spinner, so opt into one by styling those attributes (e.g. composing a Spinner). For an external or hard checkout navigation there is no client-side transition, so the loading state simply does not show (a graceful no-op). The enriched footer checkout CTA is CartCheckoutGuard wrapping CartTotal and this CartGoCheckout: the guard makes the CTA inert (data-fs-cart-checkout-blocked) while any item is unavailable, and CartTotal shows the grand total at the button. Must be inside CartRoot.",
+    "guideline": "Navigation link to the checkout page (default href the checkout page); use as the checkout CTA inside the cart summary. In a mini-cart it is the DrawerPopup footer CTA, next to CartTotal. The button wording is merchant-editable content: a CMS entry wins, then the label prop (default \"Checkout\"), then children — so a store that labels the button through children keeps working and a CMS save overrides it without a deploy. The destination is not content-editable: href stays an authored prop, because re-pointing checkout is not a copy decision. Before routing it runs a stock validation and only navigates when the re-checked cart has no unavailable line; a validation that cannot run falls open and navigates anyway. During a client-side route transition to checkout it surfaces a loading state on its content wrapper as aria-busy plus data-fs-cart-go-checkout-pending, and while the pre-checkout validation runs it exposes data-fs-cart-go-checkout-validating — there is no built-in spinner, so opt into one by styling those attributes (e.g. composing a Spinner). For an external or hard checkout navigation there is no client-side transition, so the loading state simply does not show (a graceful no-op). The enriched footer checkout CTA is CartCheckoutGuard wrapping CartTotal and this CartGoCheckout: the guard makes the CTA inert (data-fs-cart-checkout-blocked) while any item is unavailable, and CartTotal shows the grand total at the button. Must be inside CartRoot.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartCouponForm": {
@@ -4399,12 +4976,14 @@
     },
     "schema": {
       "href": {
-        "type": "string",
-        "default": "/checkout",
+        "type": "link",
+        "default": {
+          "standard": "checkout"
+        },
         "label": "Checkout URL"
       }
     },
-    "guideline": "No-mini-cart post-add behavior: navigates the shopper to checkout (href, default /checkout) after each successful add to cart. Compose it once in the layout for a store that has no mini-cart drawer; it renders no UI of its own. Use this instead of a mini-cart when adding a product should go straight to checkout. Mutually exclusive with CartOpenOnAdd — compose exactly one, and omit the drawer when using this. See cart.md.",
+    "guideline": "No-mini-cart post-add behavior: navigates the shopper to checkout (href, default the checkout page) after each successful add to cart. Compose it once in the layout for a store that has no mini-cart drawer; it renders no UI of its own. Use this instead of a mini-cart when adding a product should go straight to checkout. Mutually exclusive with CartOpenOnAdd — compose exactly one, and omit the drawer when using this. See cart.md.",
     "docPath": "src/matter/cart/cart.md"
   },
   "CartDisclaimer": {
@@ -6040,7 +6619,7 @@
         "label": "Locked reason"
       }
     },
-    "guideline": "Draft-bound, optional national tax-ID field (CPF in V0). Self-gates on the Root's active document type. A saved value renders as a disabled, locked input in the edit state rather than disappearing (Decision 4); an unsaved value renders as an editable field. Must be a descendant of MyAccountProfileRoot.",
+    "guideline": "Draft-bound, optional national tax-ID field for the Root's active document type: CPF, SSN, SIN or RFC, each with its own mask and validation. Self-gates on that type and renders nothing when it is unset or unknown. A saved value renders as a disabled, locked input in the edit state rather than disappearing (Decision 4); an unsaved value renders as an editable field. Must be a descendant of MyAccountProfileRoot.",
     "docPath": "src/matter/my-account-profile/my-account-profile.md"
   },
   "MyAccountProfileBirthDateControl": {
@@ -6089,10 +6668,513 @@
     "guideline": "Draft-bound, optional gender field over a store-configurable set of options (the options prop). Free-string storage — no server-side enum. A Clear button erases a selected value back to empty, since the Select itself offers no such option. Must be a descendant of MyAccountProfileRoot.",
     "docPath": "src/matter/my-account-profile/my-account-profile.md"
   },
+  "OrderCancel": {
+    "name": "OrderCancel",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment OrderCancelData on Query {\n    customerOrder(id: $orderId) {\n      id\n      status\n      allowCancellation\n    }\n  }\n",
+    "skeleton": "OrderCancelSkeleton",
+    "actions": {
+      "order": [
+        "cancel"
+      ]
+    },
+    "contentTypeId": "order-cancel",
+    "editor": {
+      "label": "Order Cancel",
+      "category": "action"
+    },
+    "schema": {},
+    "guideline": "Cancels one eligible order after the shopper confirms in an alert dialog. Place it on the order page. It hides when the order cannot be cancelled or a cancellation is already requested. Reasons and the dialog copy are content; a blank field uses the message catalog. Other is always offered. See order-cancel.md.",
+    "docPath": "src/matter/order-cancel/order-cancel.md"
+  },
+  "OrderDeliveryAddress": {
+    "name": "OrderDeliveryAddress",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-delivery-address",
+    "fragment": "\n  fragment OrderDeliveryAddressData on Query {\n    customerOrder(id: $orderId) {\n      deliveryOptions {\n        addressId\n        deliveryChannel\n        address {\n          receiverName\n          street\n          number\n          complement\n          neighborhood\n          reference\n          city\n          state\n          postalCode\n          country\n        }\n      }\n    }\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderDeliveryAddressSkeleton",
+    "requiresContext": "order-delivery-option",
+    "editor": {
+      "label": "Order Delivery Address",
+      "category": "content"
+    },
+    "schema": {
+      "deliveryLabel": {
+        "type": "string",
+        "label": "Delivery address label"
+      },
+      "storeLabel": {
+        "type": "string",
+        "label": "Store address label"
+      }
+    },
+    "guideline": "The address the order recorded for one delivery option: the recipient and the delivery-address label for a delivery, the store-address label for a pickup, and every non-empty address field. Place it inside OrderDeliveryGroup, after the rows; it renders the address of the option it sits in.",
+    "docPath": "src/matter/order-delivery-address/order-delivery-address.md"
+  },
+  "OrderDeliveryGroup": {
+    "name": "OrderDeliveryGroup",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-delivery-group",
+    "fragment": "\n  fragment OrderDeliveryGroupData on Query {\n    customerOrder(id: $orderId) {\n      deliveryOptions {\n        selectedSla\n        deliveryChannel\n        shippingEstimateDate\n        items {\n          id\n          name\n          quantity\n          image {\n            url\n            altText\n          }\n          sellingPrice {\n            amount\n            currencyCode\n          }\n          listPrice {\n            amount\n            currencyCode\n          }\n          total {\n            amount\n            currencyCode\n          }\n          tax {\n            amount\n            currencyCode\n          }\n          customFields {\n            name\n            value\n          }\n        }\n      }\n    }\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderDeliveryGroupSkeleton",
+    "editor": {
+      "label": "Order Delivery Group",
+      "category": "content"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "label": "Accessible name"
+      }
+    },
+    "providesContext": "order-delivery-option",
+    "guideline": "The products of one order grouped by delivery option, one collapsible group per option with the option name, the delivery estimate when the order has one, the item count, and the subtotal in its header. Labels are content; a blank field keeps the catalogue. A single option arrives open; two or more arrive closed. Reads customerOrder by the orderId route segment; place it once on the order details page. Children such as OrderDeliveryAddress render once per option, after its rows.",
+    "docPath": "src/matter/order-delivery-group/order-delivery-group.md"
+  },
+  "OrderDetailsHeader": {
+    "name": "OrderDetailsHeader",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-details-header",
+    "fragment": "\n  fragment OrderDetailsHeaderData on Query {\n    customerOrder(id: $orderId) {\n      orderNumber\n      completion {\n        view\n        label\n      }\n    }\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderDetailsHeaderSkeleton",
+    "editor": {
+      "label": "Order Details Header",
+      "category": "content"
+    },
+    "schema": {
+      "prefix": {
+        "type": "string",
+        "default": "Order #",
+        "label": "Prefix"
+      },
+      "copyLabel": {
+        "type": "string",
+        "default": "Copy",
+        "label": "Copy label"
+      },
+      "copyAccessibleName": {
+        "type": "string",
+        "default": "Copy order number",
+        "label": "Copy accessible name"
+      }
+    },
+    "guideline": "The top of the order details page: the order number as the page h1 beside a prefix, a copy action bound to the number alone, and the shared status badge. Prefix, copy, and status sentences are content; a blank field keeps the catalogue or the schema prop. Place it once, first on the page; it renders nothing when the read returns no order.",
+    "docPath": "src/matter/order-details-header/order-details-header.md"
+  },
+  "OrderList": {
+    "name": "OrderList",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-list",
+    "fragment": "\n  fragment OrderListData on Query {\n    customerOrders(first: 25, after: $after, filter: $filter) {\n      edges {\n        node {\n          ...OrderListRowData\n        }\n      }\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n      totalCount\n      totalIncomplete\n    }\n  }\n\n  fragment OrderListRowData on CustomerOrderListItem {\n    id\n    placedAt\n    total {\n      amount\n      currencyCode\n    }\n    itemCount\n    completion {\n      view\n      label\n    }\n    shippingEstimatedDateMin\n    shippingEstimatedDateMax\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderListSkeleton",
+    "editor": {
+      "label": "Order List",
+      "category": "content"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "default": "Orders",
+        "label": "Accessible name"
+      },
+      "advance": {
+        "type": [
+          "pages",
+          "load-more"
+        ],
+        "default": "pages",
+        "label": "Advance"
+      },
+      "startShoppingHref": {
+        "type": "link",
+        "default": {
+          "standard": "home"
+        },
+        "label": "Start shopping link"
+      },
+      "orderHref": {
+        "type": "link",
+        "default": {
+          "standard": "order"
+        },
+        "fills": [
+          "orderId"
+        ],
+        "label": "Order link"
+      }
+    },
+    "guideline": "One page of the shopper orders. The read is fixed at 25 and the cursor, view, search, and placed dates come from the page URL. Pages and load-more both link to the next cursor and load that page again.",
+    "docPath": "src/matter/order-list/order-list.md"
+  },
+  "OrderListRow": {
+    "name": "OrderListRow",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment OrderListRowData on CustomerOrderListItem {\n    id\n    placedAt\n    total {\n      amount\n      currencyCode\n    }\n    itemCount\n    completion {\n      view\n      label\n    }\n    shippingEstimatedDateMin\n    shippingEstimatedDateMax\n  }\n",
+    "skeleton": "OrderListRowSkeleton",
+    "editor": {
+      "label": "Order List Row",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "One order as a link to that order, showing its number, placed date, total, item count, and status badge, plus a delivery estimate while it is ongoing. The list renders it; do not place it on a page alone.",
+    "docPath": "src/matter/order-list-row/order-list-row.md"
+  },
+  "OrderListSearch": {
+    "name": "OrderListSearch",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-list-search",
+    "editor": {
+      "label": "Order List Search",
+      "category": "action"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "default": "Order number",
+        "label": "Order number"
+      },
+      "fromLabel": {
+        "type": "string",
+        "default": "Placed from",
+        "label": "Placed from"
+      },
+      "toLabel": {
+        "type": "string",
+        "default": "Placed to",
+        "label": "Placed to"
+      },
+      "submitLabel": {
+        "type": "string",
+        "default": "Search",
+        "label": "Search"
+      },
+      "clearLabel": {
+        "type": "string",
+        "default": "Clear search",
+        "label": "Clear search"
+      },
+      "invalidRangeMessage": {
+        "type": "string",
+        "default": "The start date is after the end date.",
+        "label": "Invalid range"
+      }
+    },
+    "guideline": "A text field and a placed-date range that write search, placedFrom, and placedTo, keep the current view, and drop the cursor. An inverted range is not written.",
+    "docPath": "src/matter/order-list-search/order-list-search.md"
+  },
+  "OrderListViews": {
+    "name": "OrderListViews",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-list-views",
+    "editor": {
+      "label": "Order List Views",
+      "category": "navigation"
+    },
+    "schema": {
+      "label": {
+        "type": "string",
+        "default": "Order views",
+        "label": "Accessible name"
+      },
+      "allLabel": {
+        "type": "string",
+        "default": "All orders",
+        "label": "All orders"
+      },
+      "ongoingLabel": {
+        "type": "string",
+        "default": "Ongoing",
+        "label": "Ongoing"
+      },
+      "completedLabel": {
+        "type": "string",
+        "default": "Completed",
+        "label": "Completed"
+      },
+      "cancelledLabel": {
+        "type": "string",
+        "default": "Cancelled",
+        "label": "Cancelled"
+      }
+    },
+    "guideline": "Four links that switch the orders page among all orders, ongoing, completed, and cancelled. Choosing one writes the view search param and keeps an existing search and placed-date range. It does not filter the orders already on the page.",
+    "docPath": "src/matter/order-list-views/order-list-views.md"
+  },
+  "OrderPayment": {
+    "name": "OrderPayment",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-payment",
+    "fragment": "\n  fragment OrderPaymentData on Query {\n    customerOrder(id: $orderId) {\n      id\n      allowCancellation\n      payments {\n        methodName\n        lastDigits\n        amount {\n          amount\n          currencyCode\n        }\n        installments\n        redemptionCode\n        bankInvoiceNumber\n        bankInvoicePrintUrl\n      }\n    }\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderPaymentSkeleton",
+    "editor": {
+      "label": "Order Payment",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "The payments recorded on one of the shopper orders: method, last four digits when recorded, brand icon when known, amount, installments, gift-card code, and bank-invoice number. Labels are content; a blank field keeps the catalogue. The print link shows only while the order can still be cancelled. Place it on the order details page.",
+    "docPath": "src/matter/order-payment/order-payment.md"
+  },
+  "OrderPlacedDeliveryList": {
+    "name": "OrderPlacedDeliveryList",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment OrderPlacedDeliveryListData on Query {\n    order(orderGroup: $orderGroup) {\n      __typename\n      id\n      deliveries {\n        id\n        shippingOption {\n          id\n          name\n          channel\n          shippingEstimate {\n            value\n            unit\n          }\n        }\n        estimatedDate\n        itemCount\n        pickupPointName\n        address {\n          id\n          recipientName\n          street\n          number\n          complement\n          neighborhood\n          city\n          state\n          postalCode\n          country\n        }\n        items {\n          __typename\n          id\n          quantity\n          price {\n            amount\n            currencyCode\n          }\n          listPrice {\n            amount\n            currencyCode\n          }\n          sellingPrice {\n            amount\n            currencyCode\n          }\n          gift\n          ownTotal {\n            amount\n            currencyCode\n          }\n          total {\n            amount\n            currencyCode\n          }\n          variant {\n            __typename\n            variantId\n            sku\n            name\n            image {\n              url\n              altText\n            }\n            availability\n          }\n          product {\n            __typename\n            productId\n            title\n            detailUrl\n            categories {\n              categoryId\n              name\n            }\n            brand {\n              brandId\n              name\n            }\n          }\n          compositions {\n            id\n            name\n            quantity\n            price {\n              amount\n              currencyCode\n            }\n            availability\n            assemblyId\n            ownTotal {\n              amount\n              currencyCode\n            }\n            total {\n              amount\n              currencyCode\n            }\n            customizations {\n              id\n              entries {\n                name\n                value\n              }\n            }\n            compositions {\n              id\n              name\n              quantity\n              price {\n                amount\n                currencyCode\n              }\n              availability\n              assemblyId\n              ownTotal {\n                amount\n                currencyCode\n              }\n              total {\n                amount\n                currencyCode\n              }\n              customizations {\n                id\n                entries {\n                  name\n                  value\n                }\n              }\n              compositions {\n                id\n                name\n                quantity\n                price {\n                  amount\n                  currencyCode\n                }\n                availability\n                assemblyId\n                ownTotal {\n                  amount\n                  currencyCode\n                }\n                total {\n                  amount\n                  currencyCode\n                }\n                customizations {\n                  id\n                  entries {\n                    name\n                    value\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n",
+    "fetchStrategy": "reactive",
+    "requiresContext": "order-placed",
+    "providesContext": "order-delivery",
+    "editor": {
+      "label": "Order Placed Delivery List",
+      "category": "commerce"
+    },
+    "schema": {},
+    "guideline": "The placed order grouped by delivery: one entry per way the items arrive (shipping method, channel and estimate), across sellers. Compose exactly one OrderPlacedDeliveryGroup as its child; the list renders it once per delivery, in the order the API returns them, and renders nothing when the order has no delivery. Must be inside OrderPlacedRoot. See order-placed.md."
+  },
+  "OrderPlacedDeliveryGroup": {
+    "name": "OrderPlacedDeliveryGroup",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "order-delivery",
+    "providesContext": "address-summary",
+    "editor": {
+      "label": "Order Placed Delivery Group",
+      "category": "commerce"
+    },
+    "schema": {
+      "dateTemplate": {
+        "type": "string",
+        "default": "Arrives by {date}",
+        "label": "Date template"
+      },
+      "itemCountTemplate": {
+        "type": "string",
+        "default": "{count} items",
+        "label": "Item count template"
+      },
+      "itemCountOneTemplate": {
+        "type": "string",
+        "default": "{count} item",
+        "label": "Single item count template"
+      },
+      "pickupPointTemplate": {
+        "type": "string",
+        "default": "Pickup at {name}",
+        "label": "Pickup point template"
+      }
+    },
+    "guideline": "One delivery of the placed order: its shipping method, its promise (the date under dateTemplate once the order system set one, otherwise the relative estimate sentence the checkout's delivery step showed, e.g. \"in 2 business days\"), its item count and, for a pickup, the pickup point's name. Compose AddressSummaryRecipient, AddressSummaryStreet and AddressSummaryLocality as children for the address (the shipping address, or the pickup point's for a pickup, masked as the order system returns it; nothing when the order carries none), and one OrderPlacedItemRow for the items. Style it through data-fs-order-placed-delivery-group and switch on data-fs-order-placed-delivery-group-channel (delivery, pickup, unknown). Must be the child of OrderPlacedDeliveryList. See order-placed.md."
+  },
+  "OrderPlacedItemRow": {
+    "name": "OrderPlacedItemRow",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "order-placed",
+    "providesContext": [
+      "cart-item-data",
+      "order-placed-item"
+    ],
+    "editor": {
+      "label": "Order Placed Item Row",
+      "category": "commerce"
+    },
+    "schema": {},
+    "guideline": "One purchased item of the delivery, presented with the cart's own item leaves, so it reads as it did in the cart. Compose read-only cart leaves as children: CartItemImage, CartItemProductLink, CartItemName, CartItemVariant, CartItemSku, CartItemPrice, CartItemListPrice, CartItemDiscountPercentage, CartItemLineTotal, CartItemOwnTotal, CartItemAggregateTotal, CartItemQuantityValue, CartItemGift, and OrderPlacedItemCompositions for its add-ons. Never compose CartItemQuantity, CartItemRemove, CartItemVariations, CartItemAvailable or CartItemUnavailable here: they read or change the live cart, not the placed order. Renders once per item of the nearest delivery; nothing outside a delivery. Must be inside OrderPlacedDeliveryGroup. See order-placed.md."
+  },
+  "OrderPlacedItemCompositions": {
+    "name": "OrderPlacedItemCompositions",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "order-placed-item",
+    "editor": {
+      "label": "Order Placed Item Compositions",
+      "category": "commerce"
+    },
+    "schema": {},
+    "guideline": "The add-on services of a placed item, nested under it with the cart's own composition markup (data-fs-cart-item-composition*): each one's name, quantity, unit price and customizations, children nested by depth. Renders nothing when the item has none, as every item of a purchase split across sellers. Never compose CartItemCompositions on this page instead: it reads the live cart. Must be inside OrderPlacedItemRow. See order-placed.md."
+  },
+  "OrderPlacedRoot": {
+    "name": "OrderPlacedRoot",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment OrderPlacedRootData on Query {\n    order(orderGroup: $orderGroup) {\n      __typename\n      id\n      reference\n      status\n      total {\n        amount\n        currencyCode\n      }\n      totals {\n        id\n        name\n        value {\n          amount\n          currencyCode\n        }\n      }\n    }\n  }\n",
+    "fetchStrategy": "reactive",
+    "skeleton": "OrderPlacedRootSkeleton",
+    "providesContext": "order-placed",
+    "editor": {
+      "label": "Order Placed Root",
+      "category": "commerce"
+    },
+    "schema": {
+      "refusedOrderLabel": {
+        "type": "string",
+        "default": "This order can no longer be shown here",
+        "label": "Refused order label"
+      },
+      "unresolvedOrderLabel": {
+        "type": "string",
+        "default": "Could not load this order",
+        "label": "Unresolved order label"
+      }
+    },
+    "guideline": "Owner of an order confirmation page: reads the placed order (Query.order, keyed on the order group from the route) once and provides it as the order-placed context to OrderPlacedStatus, OrderPlacedReference, OrderPlacedCustomer, OrderPlacedTotals and the other order-placed blocks composed as its children. Renders its children only once the order resolves. While the read is in flight it shows a skeleton; when the API refuses the read (after 15 minutes, or from another browser) it shows refusedOrderLabel; when the read fails or the order group resolves to no order it shows unresolvedOrderLabel. Each message replaces every child. Never reads the cart or the live profile. See order-placed.md.",
+    "docPath": "src/matter/order-placed/order-placed.md"
+  },
+  "OrderPlacedStatus": {
+    "name": "OrderPlacedStatus",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "order-placed",
+    "editor": {
+      "label": "Order Placed Status",
+      "category": "commerce"
+    },
+    "schema": {
+      "approvedTitle": {
+        "type": "string",
+        "default": "Your order is confirmed",
+        "label": "Approved title"
+      },
+      "approvedMessage": {
+        "type": "string",
+        "default": "Your payment was approved.",
+        "label": "Approved message"
+      },
+      "pendingTitle": {
+        "type": "string",
+        "default": "We're confirming your payment",
+        "label": "Pending title"
+      },
+      "pendingMessage": {
+        "type": "string",
+        "default": "Your order was placed, and its payment is still being processed or reviewed.",
+        "label": "Pending message"
+      },
+      "deniedTitle": {
+        "type": "string",
+        "default": "Your payment was not approved",
+        "label": "Denied title"
+      },
+      "deniedMessage": {
+        "type": "string",
+        "default": "This purchase did not go through. You can place a new order with another payment method.",
+        "label": "Denied message"
+      }
+    },
+    "guideline": "The payment outcome of the placed order, as a banner with a title and a message: approved, pending (which also covers a payment under anti-fraud review) or denied. Renders nothing when the outcome is unknown, so the page shows the order without asserting success or failure. Author the title and message of each outcome through the props (approvedTitle, approvedMessage, pendingTitle, pendingMessage, deniedTitle, deniedMessage); a blank value omits its line. Marks the outcome with data-fs-order-placed-status-approved, -pending or -denied, so the page styles each tone. An Icon composed as its child shows on every outcome, so never compose one that implies success. Must be inside OrderPlacedRoot. See order-placed.md.",
+    "docPath": "src/matter/order-placed/order-placed.md"
+  },
+  "OrderPlacedReference": {
+    "name": "OrderPlacedReference",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "order-placed",
+    "editor": {
+      "label": "Order Placed Reference",
+      "category": "commerce"
+    },
+    "schema": {
+      "template": {
+        "type": "string",
+        "default": "Order #{reference}",
+        "label": "Template"
+      }
+    },
+    "guideline": "The order number the shopper gives support: the order group, one per purchase even when it was split across sellers. Set template with a {reference} placeholder (e.g. \"Order #{reference}\"). Plain text, so it can be selected and copied. Must be inside OrderPlacedRoot. See order-placed.md.",
+    "docPath": "src/matter/order-placed/order-placed.md"
+  },
+  "OrderPlacedCustomer": {
+    "name": "OrderPlacedCustomer",
+    "importPath": "@vtex/faststore/components",
+    "fragment": "\n  fragment OrderPlacedCustomerData on Query {\n    order(orderGroup: $orderGroup) {\n      __typename\n      id\n      customer {\n        firstName\n        lastName\n        email\n        phone\n        document\n      }\n    }\n  }\n",
+    "fetchStrategy": "reactive",
+    "requiresContext": "order-placed",
+    "editor": {
+      "label": "Order Placed Customer",
+      "category": "commerce"
+    },
+    "schema": {
+      "nameLabel": {
+        "type": "string",
+        "default": "Name",
+        "label": "Name label"
+      },
+      "emailLabel": {
+        "type": "string",
+        "default": "Email",
+        "label": "Email label"
+      },
+      "phoneLabel": {
+        "type": "string",
+        "default": "Phone",
+        "label": "Phone label"
+      },
+      "documentLabel": {
+        "type": "string",
+        "default": "Document",
+        "label": "Document label"
+      }
+    },
+    "guideline": "Who the order is for, as the order recorded them at placement, never the live profile: name, email, phone and document as label/value rows, each left out when empty. Selects the customer through its own fragment, so a page without this block never fetches the customer. Shows the values as the order system returns them, masked included (e.g. \"J*** D***\"). Must be inside OrderPlacedRoot. See order-placed.md.",
+    "docPath": "src/matter/order-placed/order-placed.md"
+  },
+  "OrderPlacedTotals": {
+    "name": "OrderPlacedTotals",
+    "importPath": "@vtex/faststore/components",
+    "requiresContext": "order-placed",
+    "editor": {
+      "label": "Order Placed Totals",
+      "category": "commerce"
+    },
+    "schema": {
+      "itemsLabel": {
+        "type": "string",
+        "default": "Subtotal",
+        "label": "Items label"
+      },
+      "shippingLabel": {
+        "type": "string",
+        "default": "Shipping",
+        "label": "Shipping label"
+      },
+      "discountsLabel": {
+        "type": "string",
+        "default": "Discounts",
+        "label": "Discounts label"
+      },
+      "taxLabel": {
+        "type": "string",
+        "default": "Tax",
+        "label": "Tax label"
+      },
+      "totalLabel": {
+        "type": "string",
+        "default": "Total",
+        "label": "Total label"
+      },
+      "shippingZeroLabel": {
+        "type": "string",
+        "label": "Shipping zero label"
+      }
+    },
+    "guideline": "What the shopper was charged: each money line of the placed order in the order the API returns them (subtotal, discounts, shipping, tax, any custom tax under its own name), then the total, each in the order's own currency. A zero discount line is left out; set shippingZeroLabel (e.g. \"Free\") to show it instead of a zero shipping value. No total row when the order has no total. Reads the order, never the cart, so it composes no CartTotalizerLine. Must be inside OrderPlacedRoot. See order-placed.md.",
+    "docPath": "src/matter/order-placed/order-placed.md"
+  },
+  "OrderPlacedDate": {
+    "name": "OrderPlacedDate",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-placed-date",
+    "fragment": "\n  fragment OrderPlacedDateData on Query {\n    customerOrder(id: $orderId) {\n      id\n      placedAt\n    }\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderPlacedDateSkeleton",
+    "editor": {
+      "label": "Order Placed Date",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "The date and time one order was placed, formatted for the page locale. The label is content; a blank field keeps the catalogue. Place it anywhere on the order details page; it renders nothing when the order has no placed date.",
+    "docPath": "src/matter/order-placed-date/order-placed-date.md"
+  },
   "OrderPlacedPaymentSummary": {
     "name": "OrderPlacedPaymentSummary",
     "importPath": "@vtex/faststore/components",
-    "fragment": "\n  fragment OrderPlacedPaymentSummaryData on Query {\n    order(orderGroup: $orderGroup) {\n      __typename\n      id\n      network\n      lastFourDigits\n      label\n      installment {\n        count\n        total {\n          amount\n          currencyCode\n        }\n      }\n    }\n  }\n",
+    "fragment": "\n  fragment OrderPlacedPaymentSummaryData on Query {\n    order(orderGroup: $orderGroup) {\n      __typename\n      id\n      network\n      lastFourDigits\n      installment {\n        count\n        total {\n          amount\n          currencyCode\n        }\n      }\n    }\n  }\n",
     "fetchStrategy": "reactive",
     "editor": {
       "label": "Order Placed Payment Summary",
@@ -6114,24 +7196,49 @@
         "default": "Could not load the payment details",
         "label": "Unresolved order label"
       },
-      "multiSellerNotice": {
-        "type": "string",
-        "default": "This order was split across {count} sellers; the payment summary does not cover split orders",
-        "label": "Multi-seller notice"
-      },
       "installmentTemplate": {
         "type": "string",
         "default": "{count}x of {total}",
         "label": "Installment template"
       }
     },
-    "guideline": "Read-only recap, on a post-purchase confirmation surface, of the card the shopper paid with — sourced from the settled order (Query.order), never the live order form. Owns its own fragment; requires no ancestor context, so it composes standalone. Renders exactly one of five states, in strict precedence: a role=\"alert\" notice for a split (multi-seller) order — the projection never covers one; nothing while the query is in flight; a role=\"alert\" notice when the order group does not resolve; an informational line when the order resolves with no payment record; or the recap itself (network, plus last four whenever the projection carries one, plus the saved-card label when set, plus an installment line — count and settled total only, never a per-installment amount or interest rate — whenever the settled record reports one). Never compose it in checkout — the order group it reads does not exist until the order is placed, and no component renders a payment recap there. Never renders a full card number or CVV. See order-placed-payment-summary.md.",
+    "guideline": "Read-only recap, on a post-purchase confirmation surface, of the card the shopper paid with — sourced from the settled order (Query.order), never the live order form. Owns its own fragment; requires no ancestor context, so it composes standalone. Renders exactly one of four states, in strict precedence: nothing while the query is in flight; a role=\"alert\" notice when the order group does not resolve; an informational line when the order resolves with no payment record; or the recap itself (network, plus last four whenever the projection carries one, plus an installment line — count and settled total only, never a per-installment amount or interest rate — whenever the settled record reports one). Never compose it in checkout — the order group it reads does not exist until the order is placed, and no component renders a payment recap there. Never renders a full card number or CVV. See order-placed-payment-summary.md.",
     "docPath": "src/matter/order-placed-payment-summary/order-placed-payment-summary.md"
   },
+  "OrderProgress": {
+    "name": "OrderProgress",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-progress",
+    "fragment": "\n  fragment OrderProgressData on Query {\n    customerOrder(id: $orderId) {\n      id\n      completion {\n        view\n        label\n      }\n      progress {\n        stage\n        paymentFailed\n        cancelled\n      }\n    }\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderProgressSkeleton",
+    "editor": {
+      "label": "Order Progress",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "Four stages of one order on the order page: placed, payment, processing, shipping, with a line up to the current one. Stage names and state sentences are content; a blank field keeps the catalogue. Reads the stage the API resolved; style each stage through its state hook.",
+    "docPath": "src/matter/order-progress/order-progress.md"
+  },
+  "OrderSummary": {
+    "name": "OrderSummary",
+    "importPath": "@vtex/faststore/components",
+    "contentTypeId": "order-summary",
+    "fragment": "\n  fragment OrderSummaryData on Query {\n    customerOrder(id: $orderId) {\n      id\n      total {\n        amount\n        currencyCode\n      }\n      totals {\n        id\n        name\n        value {\n          amount\n          currencyCode\n        }\n      }\n    }\n  }\n",
+    "fetchStrategy": "static",
+    "skeleton": "OrderSummarySkeleton",
+    "editor": {
+      "label": "Order Summary",
+      "category": "content"
+    },
+    "schema": {},
+    "guideline": "The total lines of one placed order (items, shipping, discounts, and any other line OMS recorded, zero and negative included) followed by the grand total the API returns. Known labels are content; a blank field keeps the catalogue, and an unknown total id keeps the name the API sent. Place it on the order page; it never adds the lines up itself.",
+    "docPath": "src/matter/order-summary/order-summary.md"
+  },
   "PaymentSectionController": {
     "name": "PaymentSectionController",
     "importPath": "@vtex/faststore/components",
-    "fragment": "\n  fragment PaymentSectionControllerData on Query {\n    payment {\n      __typename\n      id\n      methods {\n        __typename\n        id\n        name\n        groupName\n        validator {\n          __typename\n          numberMask\n          numberRegex\n          cvvMask\n          cvvRegex\n          cvvRequired\n          expirationRequired\n          holderNameRequired\n          billingAddressRequired\n          documentDisplayable\n          documentRequired\n        }\n      }\n      selectedMethodId\n      selectedAccountId\n      selectedBin\n    }\n    cart {\n      __typename\n      id\n      total {\n        __typename\n        amount\n        currencyCode\n      }\n    }\n  }\n",
+    "fragment": "\n  fragment PaymentSectionControllerData on Query {\n    payment {\n      __typename\n      id\n      methods {\n        __typename\n        id\n        name\n        groupName\n        validator {\n          __typename\n          numberMask\n          numberRegex\n          cvvMask\n          cvvRegex\n          cvvRequired\n          expirationRequired\n          holderNameRequired\n          billingAddressRequired\n          documentDisplayable\n          documentRequired\n        }\n      }\n      selectedMethodId\n      selectedAccountId\n      selectedBin\n      storeCountryCode\n      countries {\n        __typename\n        countryCode\n        documents {\n          __typename\n          type\n          displayable\n          required\n        }\n      }\n    }\n    cart {\n      __typename\n      id\n      total {\n        __typename\n        amount\n        currencyCode\n      }\n    }\n  }\n",
     "fetchStrategy": "reactive",
     "actions": {
       "payment": [
@@ -6202,7 +7309,7 @@
   "PaymentSectionRoot": {
     "name": "PaymentSectionRoot",
     "importPath": "@vtex/faststore/components",
-    "fragment": "\n  fragment PaymentSectionData on Query {\n    payment {\n      __typename\n      id\n      methods {\n        __typename\n        id\n        name\n        groupName\n        validator {\n          __typename\n          numberMask\n          numberRegex\n          cvvMask\n          cvvRegex\n          cvvRequired\n          expirationRequired\n          holderNameRequired\n          billingAddressRequired\n          documentDisplayable\n          documentRequired\n        }\n      }\n      selectedMethodId\n      selectedAccountId\n      selectedBin\n    }\n    cart {\n      __typename\n      id\n      total {\n        __typename\n        amount\n        currencyCode\n      }\n    }\n  }\n",
+    "fragment": "\n  fragment PaymentSectionData on Query {\n    payment {\n      __typename\n      id\n      methods {\n        __typename\n        id\n        name\n        groupName\n        validator {\n          __typename\n          numberMask\n          numberRegex\n          cvvMask\n          cvvRegex\n          cvvRequired\n          expirationRequired\n          holderNameRequired\n          billingAddressRequired\n          documentDisplayable\n          documentRequired\n        }\n      }\n      selectedMethodId\n      selectedAccountId\n      selectedBin\n      storeCountryCode\n      countries {\n        __typename\n        countryCode\n        documents {\n          __typename\n          type\n          displayable\n          required\n        }\n      }\n    }\n    cart {\n      __typename\n      id\n      total {\n        __typename\n        amount\n        currencyCode\n      }\n    }\n  }\n",
     "fetchStrategy": "reactive",
     "actions": {
       "payment": [
@@ -6288,6 +7395,10 @@
         "default": "Placing order...",
         "label": "Button label while placing"
       },
+      "placingMessage": {
+        "type": "string",
+        "label": "Message shown while placing the order"
+      },
       "resumeLabel": {
         "type": "string",
         "default": "Complete your order",
@@ -6343,6 +7454,11 @@
         "default": "Enter valid card details before placing the order.",
         "label": "Invalid card data message"
       },
+      "unsupportedNetworkMessage": {
+        "type": "string",
+        "default": "This card is not from a network the store accepts. Use another card or choose another payment method.",
+        "label": "Unsupported card network message"
+      },
       "invalidSecurityCodeMessage": {
         "type": "string",
         "default": "Enter a valid security code before placing the order.",
@@ -6364,11 +7480,17 @@
         "label": "Unconfirmed order message"
       },
       "successHref": {
-        "type": "string",
-        "label": "Confirmation route template ({orderGroup} token)"
+        "type": "link",
+        "default": {
+          "standard": "order-placed"
+        },
+        "fills": [
+          "orderGroup"
+        ],
+        "label": "Confirmation Page"
       }
     },
-    "guideline": "The place-order CTA: invokes usePlaceOrder's three-call sequence (start transaction, the registered submission's own direct-to-gateway leg, then the gateway callback) and blocks interaction while it runs. Compose it as a sibling — never a child — of every other payment-entry leaf under the same PaymentSectionRoot or PaymentSectionController, so the one CTA serves every entry path. Renders one inline outcome after settling: the first userError's message, or successMessage on a clean settle. This component reaches no payment-sensitive input. Must be inside a payment root. See place-order.md.",
+    "guideline": "The place-order CTA: invokes usePlaceOrder's three-call sequence (start transaction, the registered submission's own direct-to-gateway leg, then the gateway callback) and blocks interaction while it runs. Compose it as a sibling — never a child — of every other payment-entry leaf under the same PaymentSectionRoot or PaymentSectionController, so the one CTA serves every entry path. Renders one inline outcome after settling: the first userError's message, or successMessage on a clean settle. While the order is being placed it renders nothing but the button, unless placingMessage is set: then a status message shows beside the button, and the rest of the payment form is blocked for as long as it shows. This component reaches no payment-sensitive input. Must be inside a payment root. See place-order.md.",
     "docPath": "src/matter/place-order/place-order.md"
   },
   "PricingRoot": {
@@ -7996,7 +9118,7 @@
         "label": "Waiting Message"
       }
     },
-    "guideline": "The whole of the /login route: on mount it replaces the document with the account's platform login, forwarding a validated returnUrl from the incoming query. It is a handover, not a block — place it alone on its own page, never inside a header, drawer, or any page a shopper is meant to read, because anything composed beside it is navigated away from before it can be seen. Never place it under an account shell or behind AccountAccessGate, whose redirect targets this route. It renders no sign-in fields of its own and collects no credentials — the shopper types them on the platform, after this component has already left the page. platformLoginUrl is required and per-account (absolute URL or site-relative path), and must not be the storefront's own /login, which would hand this route to itself — with no usable value the component renders nothing and warns.",
+    "guideline": "The whole of the sign-in page: on mount it replaces the document with the account's platform login, forwarding a validated returnUrl from the incoming query. It is a handover, not a block — place it alone on its own page, never inside a header, drawer, or any page a shopper is meant to read, because anything composed beside it is navigated away from before it can be seen. Never place it under an account shell or behind AccountAccessGate, whose redirect targets this page. It renders no sign-in fields of its own and collects no credentials — the shopper types them on the platform, after this component has already left the page. platformLoginUrl is required and per-account (absolute URL or site-relative path), and must not be the storefront's own sign-in page, which would hand this page to itself — with no usable value the component renders nothing and warns.",
     "docPath": "src/matter/sign-in-redirect/sign-in-redirect.md"
   },
   "VariantSelectorRoot": {