@vtex/faststore 0.0.8 → 0.0.10

package/dist/content-types.json

@@ -591,6 +591,227 @@
       }
     }
   },
+  "account-saved-cards-heading": {
+    "id": "account-saved-cards-heading",
+    "title": "Account Saved Cards Heading",
+    "description": "Heading of the account's saved-cards section.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Heading",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-card-expiry": {
+    "id": "account-saved-card-expiry",
+    "title": "Account Saved Card Expiry",
+    "description": "A saved card's expiry line. The date follows the label and is never authored.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "expiresLabel": {
+          "type": "string",
+          "title": "Label before a working card's date",
+          "minLength": 1
+        },
+        "expiredLabel": {
+          "type": "string",
+          "title": "Label before an expired card's date",
+          "minLength": 1
+        },
+        "expiredText": {
+          "type": "string",
+          "title": "Expired card with no date",
+          "minLength": 1
+        },
+        "unusableText": {
+          "type": "string",
+          "title": "Unusable card",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-cards-empty": {
+    "id": "account-saved-cards-empty",
+    "title": "Account Saved Cards Empty",
+    "description": "Statement shown when the shopper has no saved cards.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Empty statement",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-cards-loading": {
+    "id": "account-saved-cards-loading",
+    "title": "Account Saved Cards Loading",
+    "description": "Announcement read to assistive technology while the saved cards load.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Loading announcement",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-cards-error": {
+    "id": "account-saved-cards-error",
+    "title": "Account Saved Cards Error",
+    "description": "Messages shown when the saved cards cannot be read.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Load failure message",
+          "minLength": 1
+        },
+        "sessionExpiredText": {
+          "type": "string",
+          "title": "Session expired message",
+          "minLength": 1
+        },
+        "signInLabel": {
+          "type": "string",
+          "title": "Sign-in link label",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-card-remove-trigger": {
+    "id": "account-saved-card-remove-trigger",
+    "title": "Account Saved Card Remove Trigger",
+    "description": "Label of the control that opens a saved card's removal prompt.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Trigger label",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-card-remove-title": {
+    "id": "account-saved-card-remove-title",
+    "title": "Account Saved Card Remove Title",
+    "description": "Question that titles the removal prompt.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Prompt title",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-card-remove-description": {
+    "id": "account-saved-card-remove-description",
+    "title": "Account Saved Card Remove Description",
+    "description": "What removing the card means, shown after the card in the removal prompt.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Consequence",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-card-remove-cancel": {
+    "id": "account-saved-card-remove-cancel",
+    "title": "Account Saved Card Remove Cancel",
+    "description": "Label of the control that keeps the card.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Cancel label",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-card-remove-confirm": {
+    "id": "account-saved-card-remove-confirm",
+    "title": "Account Saved Card Remove Confirm",
+    "description": "Label of the control that removes the card, and its label while the removal runs.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "title": "Confirm label",
+          "minLength": 1
+        },
+        "pendingText": {
+          "type": "string",
+          "title": "Label while removing",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "account-saved-cards-remove-feedback": {
+    "id": "account-saved-cards-remove-feedback",
+    "title": "Account Saved Cards Remove Feedback",
+    "description": "Messages that tell the shopper how a card removal ended.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "successText": {
+          "type": "string",
+          "title": "Card removed",
+          "minLength": 1
+        },
+        "failureText": {
+          "type": "string",
+          "title": "Card not removed",
+          "minLength": 1
+        },
+        "sessionExpiredText": {
+          "type": "string",
+          "title": "Session expired message",
+          "minLength": 1
+        },
+        "signInLabel": {
+          "type": "string",
+          "title": "Sign-in link label",
+          "minLength": 1
+        }
+      }
+    }
+  },
   "buy-button-labels": {
     "id": "buy-button-labels",
     "title": "Buy Button Labels",
@@ -736,6 +957,85 @@
       }
     }
   },
+  "cart-destination-value": {
+    "id": "cart-destination-value",
+    "title": "Cart Destination Value",
+    "description": "Copy that precedes the destination in read mode.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "prefix": {
+          "type": "string",
+          "title": "Prefix"
+        }
+      }
+    }
+  },
+  "cart-destination-change": {
+    "id": "cart-destination-change",
+    "title": "Cart Destination Change",
+    "description": "Copy for the control that opens edit mode.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "label": {
+          "type": "string",
+          "title": "Button label"
+        }
+      }
+    }
+  },
+  "cart-destination-submit": {
+    "id": "cart-destination-submit",
+    "title": "Cart Destination Submit",
+    "description": "Copy for the control that writes the destination.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "label": {
+          "type": "string",
+          "title": "Button label"
+        },
+        "pendingLabel": {
+          "type": "string",
+          "title": "Pending label"
+        }
+      }
+    }
+  },
+  "cart-destination-cancel": {
+    "id": "cart-destination-cancel",
+    "title": "Cart Destination Cancel",
+    "description": "Copy for the control that closes edit mode without writing.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "label": {
+          "type": "string",
+          "title": "Button label"
+        }
+      }
+    }
+  },
+  "cart-destination-error": {
+    "id": "cart-destination-error",
+    "title": "Cart Destination Error",
+    "description": "Message shown when the destination write fails.",
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "genericMessage": {
+          "type": "string",
+          "title": "Failure message"
+        }
+      }
+    }
+  },
   "order-cancel": {
     "id": "order-cancel",
     "title": "Order Cancel",

package/dist/core/dist/define-component.d.ts

@@ -31,7 +31,12 @@ export type PropSchemaField = {
   label?: string;
 };
 export type PropSchema = Record<string, PropSchemaField>;
-export type FetchStrategy = 'static' | 'lazy' | 'reactive' | 'reactive-list-item';
+export type FetchStrategy = 'static' | 'lazy' | 'reactive' | 'reactive-list-item' |
+/**
+ * The component's data is fetched by the client when the element mounts, in its own operation:
+ * never in the page query, and absent from the server HTML. Meant for a conditional branch.
+ */
+'lazy-on-mount';
 /**
  * How one fragment variable reads the element's configuration when the by-name convention cannot
  * express it (config-sourced fragment variables RFC). By convention `$first` reads the content-model

package/dist/docs/account-entry-point.md

@@ -53,10 +53,10 @@ Content model (`account-entry-point`) fields, edited in the CMS:
 |-------|------|----------|-------|
 | `signedOutLabel` | string | no | Cleared or absent keeps the authored prop |
 | `signedInLabel` | string | no | Same |
-| `icon` | string | no | Same, but the name must be listed in `global.json → icons.include` — see below |
+| `icon` | string | no | Same, but the name must be listed in `foundation.json → icons.include` — see below |
 | `loadingLabel` | string | no | Same |
 
-**An icon chosen in the CMS has to be declared in the store first.** Icon references resolve at compile time: the compiler collects every value of every `icon`-typed prop across the page and layout schemas and emits one sprite per route. A name that arrives at runtime from a CMS entry is never seen by that pass, so it renders a `<use>` pointing at a symbol the route's sprite does not carry — no build error, no runtime error, no glyph. For a merchant to be able to pick the icon in the Admin, the store must list the candidates under `global.json → icons.include`, which puts them in the root sprite regardless of what any schema references.
+**An icon chosen in the CMS has to be declared in the store first.** Icon references resolve at compile time: the compiler collects every value of every `icon`-typed prop across the page and layout schemas and emits one sprite per route. A name that arrives at runtime from a CMS entry is never seen by that pass, so it renders a `<use>` pointing at a symbol the route's sprite does not carry — no build error, no runtime error, no glyph. For a merchant to be able to pick the icon in the Admin, the store must list the candidates under `foundation.json → icons.include`, which puts them in the root sprite regardless of what any schema references.
 
 **One element, two links, chosen by the session.** `loggedIn` renders the signed-in link; `anonymous` and `identified` both render the signed-out one, because an identified but unauthenticated shopper cannot reach their account yet. There is no prop that selects between them — the merchant authors one element and the session decides.
 
@@ -98,7 +98,7 @@ Bound to a CMS entry, the element authors no content props at all — the entry
 - **Placing it outside a `SessionRoot`.** The compiler rejects it, and the runtime throws.
 - **Authoring `$content` in the schema.** `$content` is compiler-injected from the page's or layout's content entry; naming it in `props` fails the build.
 - **Expecting a default glyph.** The base icon dialect has no account icon, so a store that authors no `icon` gets a label-only link. Author one from the store's own collection.
-- **Letting a merchant pick the icon without declaring it.** An `icon` supplied by a CMS entry renders nothing at all unless the store lists the name in `global.json → icons.include`: the compiler builds each route's sprite from the schemas, and a runtime value never reaches that pass.
+- **Letting a merchant pick the icon without declaring it.** An `icon` supplied by a CMS entry renders nothing at all unless the store lists the name in `foundation.json → icons.include`: the compiler builds each route's sprite from the schemas, and a runtime value never reaches that pass.
 - **Hiding the announced text with `display:none`.** That removes it from the accessibility tree and defeats the announcement; use a clipping technique instead.
 
 ---
@@ -123,7 +123,7 @@ Bound to a CMS entry, the element authors no content props at all — the entry
 ```
 
 The glyph carries a fixed intrinsic size, so reach it through the root when the header needs another.
-Author that once per store as the `AccountEntryPoint` base swatch in `global.json → styles`:
+Author that once per store as the `AccountEntryPoint` base swatch in `foundation.json → styles`:
 
 ```json
 {

package/dist/docs/account-menu.md

@@ -161,7 +161,7 @@ Returns `{ items, current }` — the resolved sections and the current one as `{
 
 Bound to a CMS entry, the Root authors no `items` at all — the entry supplies the whole list.
 
-No part carries a `style` reference: each takes its type's `base` swatch from `global.json → styles` on its own. Reference a named swatch only when the store defines one, since a `$name` the store does not define expands to nothing, without an error.
+No part carries a `style` reference: each takes its type's `base` swatch from `foundation.json → styles` on its own. Reference a named swatch only when the store defines one, since a `$name` the store does not define expands to nothing, without an error.
 
 The account root's page, whose only content is the redirect:
 
@@ -207,7 +207,7 @@ The account root's page, whose only content is the redirect:
 | Sign-out button | `data-fs-account-menu-sign-out-button` is the `<button>`; style `:disabled` for the wait | `text-left text-sm underline` |
 | Sign-out failure | `data-fs-account-menu-sign-out-error` is the alert | `text-sm text-red-600` |
 
-The vertical-to-horizontal switch and the scroll affordance are one DOM styled two ways, in CSS alone. A store authors them as `AccountMenuList.base` in `global.json → styles`, abridged here:
+The vertical-to-horizontal switch and the scroll affordance are one DOM styled two ways, in CSS alone. A store authors them as `AccountMenuList.base` in `foundation.json → styles`, abridged here:
 
 ```json
 {