@cartbase/storefront 0.20.0 → 0.21.0

package/src/checkout/labels.ts

@@ -1,495 +1,495 @@
-/**
- * Checkout labels — default English copy.
- *
- * Ported from `@1click/ui/src/checkout/labels.ts` (v2.3.1) with the
- * Cartbase additions: gift-card tender labels (`giftCard*`) for the new
- * GiftCardSection (gift cards are a Cartbase feature with no @1click
- * equivalent — docs/storefront/gift-cards.md).
- *
- * Every user-facing string in the checkout module comes from a
- * `CheckoutLabels` object. Stores override strings by passing a partial
- * labels object to `CheckoutProvider`. English is the baseline; stores
- * wanting Bulgarian, German, etc. pass their own translations.
- */
-
-export type CheckoutLabels = {
-  // Section headings
-  deliveryInfo: string
-  shippingServices: string
-  paymentMethod: string
-  orderSummary: string
-
-  // Form fields
-  email: string
-  country: string
-  /**
-   * Localized name of the single-region country (e.g. "България"). When
-   * the checkout renders with exactly one country, the country select
-   * collapses to a readonly field showing this name instead of the
-   * dropdown's English `display_name`. Optional — falls back to the
-   * country's `display_name` when omitted.
-   */
-  singleCountryName?: string
-  firstName: string
-  lastName: string
-  address: string
-  apartment: string
-  city: string
-  postalCode: string
-  phone: string
-  province: string
-
-  // Buttons
-  saveAddress: string
-  updateAddress: string
-  addToOrder: string
-  addCode: string
-
-  // States / empty / disabled
-  deliveryDisabled: string
-  noShippingOptions: string
-  paymentDisabled: string
-  /** Shown above the shipping options when they render as a read-only
-   * price preview before the address is entered (stores that opt into
-   * `previewWhenAddressNotReady`). */
-  deliveryPreviewHint: string
-  /** Hint under the disabled Buy button explaining what's still missing. */
-  buyNeedsAddress: string
-  buyNeedsDelivery: string
-
-  // Payment tabs
-  codNote: string
-  /** Online-payment radio label. Covers every Stripe-enabled method
-   * (card + Apple Pay + Google Pay + Link + whatever else is turned on
-   * in the Stripe Dashboard). Replaces the old `payByCard`. */
-  payOnline: string
-  cashOnDelivery: string
-  termsText: string
-
-  // Address reuse
-  useSavedAddress: string
-  saveInfo: string
-
-  // Saved address picker
-  chooseAddress: string
-
-  // Order summary
-  items: string
-  qty: string
-  subtotal: string
-  shipping: string
-  shippingCalc: string
-  shippingFree: string
-  tax: string
-  /**
-   * What the tax is, in the store's words. OPTIONAL and undefined by
-   * default: a rate ("20% VAT") or a regime ("included in prices") is the
-   * store's fact, and the tooltip is simply absent when the store says
-   * nothing.
-   */
-  taxTooltip?: string
-  total: string
-  discount: string
-  discountCode: string
-  discountSub: string
-  /** Default label for the cash-on-delivery fee row. Used as the third-
-   *  level fallback when neither the cart's `payment_method_fee_label` (Cartbase
-   *  server truth) nor a per-store override is available. */
-  paymentMethodFee: string
-  recommended: string
-  recommendedSoon: string
-  recommendedSoonSub: string
-  remove: string
-  secureCheckout: string
-
-  // Gift cards (Cartbase gift-card tender — docs/storefront/gift-cards.md)
-  giftCard: string
-  giftCardSub: string
-  giftCardPlaceholder: string
-  /** Row label for the summary's gift-card tender line ("Gift cards −X"). */
-  giftCardApplied: string
-  /** Label for the remainder row ("Remaining to pay"). Rendered only when
-   * gift cards cover part of the total (`gift_card_total > 0`). */
-  giftCardRemaining: string
-  /** Prefix for an applied card chip, followed by the masked last4
-   * (e.g. "Gift card ••••1234"). */
-  giftCardEnding: string
-
-  // Company invoice
-  companyInvoice: string
-  companyName: string
-  companyVat: string
-  companyMol: string
-  companyAddress: string
-
-  // Place order button
-  placeOrder: string
-  selectPaymentMethod: string
-
-  /**
-   * Processing-state messages shown beneath the spinning Buy button
-   * while `performBuyClick` is in flight. Cycle through with a fade
-   * transition every ~1.8s; on long flows (3DS challenges, slow
-   * networks) the cycle loops back to index 0.
-   *
-   * Two arrays so card and COD show different micro-narratives — card
-   * mentions the bank handshake (the slow part), COD jumps straight
-   * to delivery + order. The closing entry should be a brand-flavored
-   * line that's still honest to the "processing" moment (don't say
-   * "packing" — nothing is being packed yet).
-   */
-  processingCard: string[]
-  processingCod: string[]
-
-  // Econt office selector
-  econtLoadingOffices: string
-  econtNearestOffices: string
-  econtSearchAnother: string
-  econtSearchPlaceholder: string
-  econtNoResults: string
-  econtChange: string
-
-  // BoxNow locker selector
-  boxnowLoadingLockers: string
-  boxnowNearestLockers: string
-  boxnowSearchAnother: string
-  boxnowSearchPlaceholder: string
-  boxnowNoResults: string
-  boxnowChange: string
-  boxnowUnavailable: string
-  boxnowNoLockersInCity: string
-  /**
-   * What a shopper reads when saving the address fails. It used to be
-   * hardcoded BULGARIAN inside `address-error-copy.ts` with no way to
-   * override it, so a merchant anywhere on earth showed Bulgarian on the
-   * one screen where a shopper is about to pay (found 2026-09-13). It is
-   * copy, so it belongs in the label pack like all other copy.
-   *
-   * The PATTERNS that recognize each failure stay in code: they match the
-   * API's own English error text, which is not translated and must not be.
-   */
-  addressErrors: AddressErrorCopy
-  /**
-   * The rest of the checkout's failure copy, lifted out of
-   * `payment-error-copy.ts` and `promotion-error-copy.ts` on 2026-09-13
-   * for the same reason as `addressErrors`: they held 54 hardcoded
-   * Bulgarian sentences that every merchant shipped and none could
-   * override. The recognition stays in those modules; only the words
-   * live here.
-   */
-  paymentErrors: PaymentErrorCopy
-  giftCardErrors: GiftCardErrorCopy
-  promotionErrors: PromotionErrorCopy
-}
-
-/** The eleven things that can go wrong saving a checkout address. */
-export type AddressErrorCopy = {
-  /** Anything unrecognized. Never leaks the technical message. */
-  generic: string
-  network: string
-  validationFailed: string
-  invalidRegion: string
-  regionRequired: string
-  cartCompleted: string
-  cartNotFound: string
-  invalidEmail: string
-  invalidPostalCode: string
-  invalidPhone: string
-  invalidCountry: string
-}
-
-export type PaymentErrorCopy = {
-  genericCard: string
-  genericCod: string
-  cartEmailRequired: string
-  cartEmpty: string
-  shippingAddressRequired: string
-  shippingMethodRequired: string
-  paymentCollectionRequired: string
-  paymentSessionRequired: string
-  insufficientInventory: string
-  checkoutMethodHidden: string
-  requiresAction: string
-  paymentNotAuthorized: string
-  paymentNotInitiated: string
-  paymentIncomplete: string
-  giftCardInsufficientBalance: string
-  giftCardNotRedeemable: string
-  accountRequired: string
-  cartLocked: string
-  cartCompleted: string
-  cartNotFound: string
-  shippingOptionNotFound: string
-  invalidProvider: string
-  shippingPriceMissing: string
-  stripeNotConfigured: string
-  validationFailed: string
-  cardDeclined: string
-  insufficientFunds: string
-  expiredCard: string
-  incorrectCvc: string
-  incorrectCardNumber: string
-  invalidExpiry: string
-  authenticationRequired: string
-  processingError: string
-  rateLimited: string
-  paymentExpired: string
-  amountMismatch: string
-  networkError: string
-  cartAlreadyCompleted: string
-  outOfStock: string
-  invalidRegion: string
-  shippingMethodMissing: string
-}
-
-export type GiftCardErrorCopy = {
-  invalidGiftCard: string
-  rateLimited: string
-  cartCompleted: string
-  cartNotFound: string
-  validationFailed: string
-  generic: string
-}
-
-export type PromotionErrorCopy = {
-  generic: string
-  needsEmail: string
-  exhausted: string
-  promotionNotFound: string
-  promotionInactive: string
-  promotionMisconfigured: string
-  promotionUnsupportedType: string
-  cartCompleted: string
-  cartNotFound: string
-  validationFailed: string
-}
-
-export const defaultCheckoutLabels: CheckoutLabels = {
-  deliveryInfo: "Delivery information",
-  shippingServices: "Shipping method",
-  paymentMethod: "Payment method",
-  orderSummary: "Order summary",
-
-  email: "Email",
-  country: "Country",
-  singleCountryName: undefined,
-  firstName: "First name",
-  lastName: "Last name",
-  address: "Address",
-  apartment: "Apartment, suite, etc. (optional)",
-  city: "City",
-  postalCode: "Postal code",
-  phone: "Phone",
-  province: "State / province",
-
-  saveAddress: "Save and continue",
-  updateAddress: "Update address",
-  addToOrder: "+ Add to order",
-  addCode: "Apply",
-
-  deliveryDisabled:
-    "Enter your delivery address to see available shipping options.",
-  noShippingOptions: "No shipping options available for your address.",
-  paymentDisabled: "Select a shipping method to continue.",
-  deliveryPreviewHint: "Enter your address to choose a delivery method.",
-  buyNeedsAddress: "Enter your delivery address",
-  buyNeedsDelivery: "Choose a delivery method",
-
-  codNote: "Cash on delivery. Additional fees may apply.",
-  payOnline: "Pay online",
-  cashOnDelivery: "Cash on delivery",
-  termsText:
-    "By placing your order you accept our Terms and Privacy Policy.",
-
-  useSavedAddress: "Use a saved address?",
-  saveInfo: "Save this information for next time",
-
-  chooseAddress: "Choose an address",
-
-  items: "items",
-  qty: "Qty",
-  subtotal: "Subtotal",
-  shipping: "Shipping",
-  shippingCalc: "Calculated at checkout",
-  shippingFree: "Free",
-  // The row NAME, neutral on purpose: it sits beside a number, so it must
-  // say something, but "VAT incl." names one tax regime and asserts that
-  // prices include it. That is Bulgaria's answer, not Germany's, and not any
-  // US state's. A store that wants its own word sets it in its pack.
-  tax: "Tax",
-  // NO DEFAULT. The explanation used to read "20% VAT is included in
-  // prices", a rate and a regime the library cannot know, translated into
-  // three languages. A store writes it or the tooltip does not appear at
-  // all, which costs a shopper nothing.
-  taxTooltip: undefined,
-  total: "Total",
-  discount: "Discount",
-  discountCode: "Discount code",
-  discountSub: "Save with a promo code",
-  paymentMethodFee: "Payment method fee",
-  recommended: "Recommended for you",
-  recommendedSoon: "Coming soon",
-  recommendedSoonSub: "Personalized recommendations",
-  remove: "Remove",
-  secureCheckout: "Secure checkout",
-
-  giftCard: "Gift card",
-  giftCardSub: "Redeem a gift card",
-  giftCardPlaceholder: "GIFT-XXXX-XXXX",
-  giftCardApplied: "Gift cards",
-  giftCardRemaining: "Remaining to pay",
-  giftCardEnding: "Gift card ending in",
-
-  companyInvoice: "Company invoice",
-  companyName: "Company name",
-  companyVat: "VAT / Company number",
-  companyMol: "Responsible person",
-  companyAddress: "Company address",
-
-  placeOrder: "Place order",
-  selectPaymentMethod: "Select a payment method",
-
-  processingCard: [
-    "Connecting to the bank...",
-    "Confirming the payment...",
-    "Recording the order...",
-    "Attending to every detail...",
-  ],
-  processingCod: [
-    "Reserving the delivery...",
-    "Preparing the order...",
-    "Attending to every detail...",
-  ],
-
-  econtLoadingOffices: "Loading offices...",
-  econtNearestOffices: "Nearest offices",
-  econtSearchAnother: "Search for another office",
-  econtSearchPlaceholder: "Search by name, city, or address...",
-  econtNoResults: "No offices found for",
-  econtChange: "Change",
-
-  boxnowLoadingLockers: "Loading lockers...",
-  boxnowNearestLockers: "Nearest lockers",
-  boxnowSearchAnother: "Search for another locker",
-  boxnowSearchPlaceholder: "Search by name, address, or postal code...",
-  boxnowNoResults: "No lockers found for",
-  boxnowChange: "Change",
-  boxnowUnavailable:
-    "BoxNow is temporarily unavailable, please choose a different shipping method.",
-  boxnowNoLockersInCity:
-    "No BoxNow lockers found in your city. Please choose a different shipping method.",
-  addressErrors: {
-    generic:
-      "We could not save your address. Please check the details and try again.",
-    network:
-      "We cannot reach the server. Please check your connection and try again.",
-    validationFailed:
-      "One of the fields is not valid. Please check the details and try again.",
-    invalidRegion: "That country is not valid. Please reload the page.",
-    regionRequired: "The delivery region is not valid. Please reload the page.",
-    cartCompleted:
-      "This order is already placed. Please check your email for the confirmation.",
-    cartNotFound: "Your cart session expired. Please reload the page.",
-    invalidEmail: "That email address is not valid. Please check the spelling.",
-    // NOT "four digits": the postcode length is the country's business, and
-    // the Bulgarian original said four, which is wrong everywhere else.
-    invalidPostalCode: "That postal code is not valid. Please check it.",
-    invalidPhone: "That phone number is not valid. Please check the digits.",
-    invalidCountry: "That country is not valid. Please reload the page.",
-  },
-  paymentErrors: {
-    genericCard:
-      "The payment could not be processed right now. Try again or choose another payment method.",
-    genericCod: "The order could not be placed right now. Try again in a moment.",
-    cartEmailRequired:
-      "An email address is needed to place the order. Add one to continue.",
-    cartEmpty: "Your cart is empty. Add a product to continue.",
-    shippingAddressRequired:
-      "A delivery address is needed to place the order. Add one to continue.",
-    shippingMethodRequired: "Choose a delivery method to continue.",
-    paymentCollectionRequired: "The payment is not ready yet. Try again.",
-    paymentSessionRequired: "The payment is not ready yet. Try again.",
-    insufficientInventory:
-      "One of the products is no longer available in the quantity you chose. Update your cart to continue.",
-    checkoutMethodHidden:
-      "The method you chose is no longer available for this order. Choose another one and try again.",
-    requiresAction:
-      "Your bank needs to confirm this payment. Follow the steps it shows to continue.",
-    paymentNotAuthorized:
-      "The payment was not approved. Try again or choose another payment method.",
-    paymentNotInitiated:
-      "The payment expired before it went through. Reload the page and try again.",
-    paymentIncomplete:
-      "Your gift cards no longer cover the full amount. Choose a payment method for the rest.",
-    giftCardInsufficientBalance:
-      "The balance on that gift card no longer covers the amount. Remove it or choose another payment method.",
-    giftCardNotRedeemable:
-      "That gift card can no longer be used. Remove it and try again.",
-    accountRequired: "This order needs you to be signed in. Sign in to continue.",
-    cartLocked:
-      "This order is being processed right now. Wait a few seconds before trying again.",
-    cartCompleted:
-      "This order has already gone through. Check your email for the confirmation.",
-    cartNotFound: "Your cart is no longer available. Reload the page to start again.",
-    shippingOptionNotFound:
-      "The delivery method you chose is no longer available. Choose another one.",
-    invalidProvider: "The payment method you chose cannot be used. Choose another one.",
-    shippingPriceMissing:
-      "The delivery cost could not be worked out. Choose another delivery method.",
-    stripeNotConfigured:
-      "Card payments are unavailable at the moment. Choose another payment method.",
-    validationFailed: "Some order details are missing. Check the form and try again.",
-    cardDeclined:
-      "That card was declined by the bank. Try another card or contact your bank.",
-    insufficientFunds: "That card does not have enough funds. Try another card.",
-    expiredCard: "That card has expired. Try another card.",
-    incorrectCvc:
-      "The security code does not match. Check the security code on your card and try again.",
-    incorrectCardNumber:
-      "That card number does not look right. Check the digits and try again.",
-    invalidExpiry: "The expiry date does not look right. Check the month and the year.",
-    authenticationRequired:
-      "Your bank needs to confirm this payment. Follow the steps it shows to continue.",
-    processingError: "The card could not be processed. Try again in a moment.",
-    rateLimited:
-      "There have been too many payment attempts. Wait a few minutes and try again.",
-    paymentExpired:
-      "The payment expired before it went through. Reload the page and try again.",
-    amountMismatch: "The order total changed. Reload the page and try again.",
-    networkError:
-      "The connection was lost. Check your internet connection and try again.",
-    cartAlreadyCompleted:
-      "This order has already gone through. Check your email for the confirmation.",
-    outOfStock:
-      "One of the products is no longer available in the quantity you chose. Update your cart to continue.",
-    invalidRegion:
-      "This delivery destination is not available. Reload the page and try again.",
-    shippingMethodMissing: "Choose a delivery method to continue.",
-  },
-  giftCardErrors: {
-    invalidGiftCard: "That gift card code is not valid. Check the code and try again.",
-    rateLimited: "Too many attempts. Wait a few minutes and try again.",
-    cartCompleted:
-      "This order is already placed. Check your email for the confirmation.",
-    cartNotFound: "Your cart timed out. Reload the page and try again.",
-    validationFailed: "That code is not valid. Check it and try again.",
-    generic: "The gift card could not be applied right now. Try again in a moment.",
-  },
-  promotionErrors: {
-    generic:
-      "This discount code can't be applied right now. Check the code and try again.",
-    needsEmail:
-      "This discount code needs an email address. Add yours above and try again.",
-    exhausted: "This promotion has been fully used and is no longer available.",
-    promotionNotFound: "This discount code isn't valid. Check it and try again.",
-    promotionInactive: "This discount code is no longer active.",
-    promotionMisconfigured:
-      "This discount code can't be applied right now. Check the code and try again.",
-    promotionUnsupportedType:
-      "This discount code can't be applied right now. Check the code and try again.",
-    cartCompleted:
-      "This order has already been placed. Check your email for the confirmation.",
-    cartNotFound: "We couldn't find your cart. Reload the page and try again.",
-    validationFailed: "This discount code isn't valid. Check it and try again.",
-  },
-}
+/**
+ * Checkout labels — default English copy.
+ *
+ * Ported from `@1click/ui/src/checkout/labels.ts` (v2.3.1) with the
+ * Cartbase additions: gift-card tender labels (`giftCard*`) for the new
+ * GiftCardSection (gift cards are a Cartbase feature with no @1click
+ * equivalent — docs/storefront/gift-cards.md).
+ *
+ * Every user-facing string in the checkout module comes from a
+ * `CheckoutLabels` object. Stores override strings by passing a partial
+ * labels object to `CheckoutProvider`. English is the baseline; stores
+ * wanting Bulgarian, German, etc. pass their own translations.
+ */
+
+export type CheckoutLabels = {
+  // Section headings
+  deliveryInfo: string
+  shippingServices: string
+  paymentMethod: string
+  orderSummary: string
+
+  // Form fields
+  email: string
+  country: string
+  /**
+   * Localized name of the single-region country (e.g. "България"). When
+   * the checkout renders with exactly one country, the country select
+   * collapses to a readonly field showing this name instead of the
+   * dropdown's English `display_name`. Optional — falls back to the
+   * country's `display_name` when omitted.
+   */
+  singleCountryName?: string
+  firstName: string
+  lastName: string
+  address: string
+  apartment: string
+  city: string
+  postalCode: string
+  phone: string
+  province: string
+
+  // Buttons
+  saveAddress: string
+  updateAddress: string
+  addToOrder: string
+  addCode: string
+
+  // States / empty / disabled
+  deliveryDisabled: string
+  noShippingOptions: string
+  paymentDisabled: string
+  /** Shown above the shipping options when they render as a read-only
+   * price preview before the address is entered (stores that opt into
+   * `previewWhenAddressNotReady`). */
+  deliveryPreviewHint: string
+  /** Hint under the disabled Buy button explaining what's still missing. */
+  buyNeedsAddress: string
+  buyNeedsDelivery: string
+
+  // Payment tabs
+  codNote: string
+  /** Online-payment radio label. Covers every Stripe-enabled method
+   * (card + Apple Pay + Google Pay + Link + whatever else is turned on
+   * in the Stripe Dashboard). Replaces the old `payByCard`. */
+  payOnline: string
+  cashOnDelivery: string
+  termsText: string
+
+  // Address reuse
+  useSavedAddress: string
+  saveInfo: string
+
+  // Saved address picker
+  chooseAddress: string
+
+  // Order summary
+  items: string
+  qty: string
+  subtotal: string
+  shipping: string
+  shippingCalc: string
+  shippingFree: string
+  tax: string
+  /**
+   * What the tax is, in the store's words. OPTIONAL and undefined by
+   * default: a rate ("20% VAT") or a regime ("included in prices") is the
+   * store's fact, and the tooltip is simply absent when the store says
+   * nothing.
+   */
+  taxTooltip?: string
+  total: string
+  discount: string
+  discountCode: string
+  discountSub: string
+  /** Default label for the cash-on-delivery fee row. Used as the third-
+   *  level fallback when neither the cart's `payment_method_fee_label` (Cartbase
+   *  server truth) nor a per-store override is available. */
+  paymentMethodFee: string
+  recommended: string
+  recommendedSoon: string
+  recommendedSoonSub: string
+  remove: string
+  secureCheckout: string
+
+  // Gift cards (Cartbase gift-card tender — docs/storefront/gift-cards.md)
+  giftCard: string
+  giftCardSub: string
+  giftCardPlaceholder: string
+  /** Row label for the summary's gift-card tender line ("Gift cards −X"). */
+  giftCardApplied: string
+  /** Label for the remainder row ("Remaining to pay"). Rendered only when
+   * gift cards cover part of the total (`gift_card_total > 0`). */
+  giftCardRemaining: string
+  /** Prefix for an applied card chip, followed by the masked last4
+   * (e.g. "Gift card ••••1234"). */
+  giftCardEnding: string
+
+  // Company invoice
+  companyInvoice: string
+  companyName: string
+  companyVat: string
+  companyMol: string
+  companyAddress: string
+
+  // Place order button
+  placeOrder: string
+  selectPaymentMethod: string
+
+  /**
+   * Processing-state messages shown beneath the spinning Buy button
+   * while `performBuyClick` is in flight. Cycle through with a fade
+   * transition every ~1.8s; on long flows (3DS challenges, slow
+   * networks) the cycle loops back to index 0.
+   *
+   * Two arrays so card and COD show different micro-narratives — card
+   * mentions the bank handshake (the slow part), COD jumps straight
+   * to delivery + order. The closing entry should be a brand-flavored
+   * line that's still honest to the "processing" moment (don't say
+   * "packing" — nothing is being packed yet).
+   */
+  processingCard: string[]
+  processingCod: string[]
+
+  // Econt office selector
+  econtLoadingOffices: string
+  econtNearestOffices: string
+  econtSearchAnother: string
+  econtSearchPlaceholder: string
+  econtNoResults: string
+  econtChange: string
+
+  // BoxNow locker selector
+  boxnowLoadingLockers: string
+  boxnowNearestLockers: string
+  boxnowSearchAnother: string
+  boxnowSearchPlaceholder: string
+  boxnowNoResults: string
+  boxnowChange: string
+  boxnowUnavailable: string
+  boxnowNoLockersInCity: string
+  /**
+   * What a shopper reads when saving the address fails. It used to be
+   * hardcoded BULGARIAN inside `address-error-copy.ts` with no way to
+   * override it, so a merchant anywhere on earth showed Bulgarian on the
+   * one screen where a shopper is about to pay (found 2026-09-13). It is
+   * copy, so it belongs in the label pack like all other copy.
+   *
+   * The PATTERNS that recognize each failure stay in code: they match the
+   * API's own English error text, which is not translated and must not be.
+   */
+  addressErrors: AddressErrorCopy
+  /**
+   * The rest of the checkout's failure copy, lifted out of
+   * `payment-error-copy.ts` and `promotion-error-copy.ts` on 2026-09-13
+   * for the same reason as `addressErrors`: they held 54 hardcoded
+   * Bulgarian sentences that every merchant shipped and none could
+   * override. The recognition stays in those modules; only the words
+   * live here.
+   */
+  paymentErrors: PaymentErrorCopy
+  giftCardErrors: GiftCardErrorCopy
+  promotionErrors: PromotionErrorCopy
+}
+
+/** The eleven things that can go wrong saving a checkout address. */
+export type AddressErrorCopy = {
+  /** Anything unrecognized. Never leaks the technical message. */
+  generic: string
+  network: string
+  validationFailed: string
+  invalidRegion: string
+  regionRequired: string
+  cartCompleted: string
+  cartNotFound: string
+  invalidEmail: string
+  invalidPostalCode: string
+  invalidPhone: string
+  invalidCountry: string
+}
+
+export type PaymentErrorCopy = {
+  genericCard: string
+  genericCod: string
+  cartEmailRequired: string
+  cartEmpty: string
+  shippingAddressRequired: string
+  shippingMethodRequired: string
+  paymentCollectionRequired: string
+  paymentSessionRequired: string
+  insufficientInventory: string
+  checkoutMethodHidden: string
+  requiresAction: string
+  paymentNotAuthorized: string
+  paymentNotInitiated: string
+  paymentIncomplete: string
+  giftCardInsufficientBalance: string
+  giftCardNotRedeemable: string
+  accountRequired: string
+  cartLocked: string
+  cartCompleted: string
+  cartNotFound: string
+  shippingOptionNotFound: string
+  invalidProvider: string
+  shippingPriceMissing: string
+  stripeNotConfigured: string
+  validationFailed: string
+  cardDeclined: string
+  insufficientFunds: string
+  expiredCard: string
+  incorrectCvc: string
+  incorrectCardNumber: string
+  invalidExpiry: string
+  authenticationRequired: string
+  processingError: string
+  rateLimited: string
+  paymentExpired: string
+  amountMismatch: string
+  networkError: string
+  cartAlreadyCompleted: string
+  outOfStock: string
+  invalidRegion: string
+  shippingMethodMissing: string
+}
+
+export type GiftCardErrorCopy = {
+  invalidGiftCard: string
+  rateLimited: string
+  cartCompleted: string
+  cartNotFound: string
+  validationFailed: string
+  generic: string
+}
+
+export type PromotionErrorCopy = {
+  generic: string
+  needsEmail: string
+  exhausted: string
+  promotionNotFound: string
+  promotionInactive: string
+  promotionMisconfigured: string
+  promotionUnsupportedType: string
+  cartCompleted: string
+  cartNotFound: string
+  validationFailed: string
+}
+
+export const defaultCheckoutLabels: CheckoutLabels = {
+  deliveryInfo: "Delivery information",
+  shippingServices: "Shipping method",
+  paymentMethod: "Payment method",
+  orderSummary: "Order summary",
+
+  email: "Email",
+  country: "Country",
+  singleCountryName: undefined,
+  firstName: "First name",
+  lastName: "Last name",
+  address: "Address",
+  apartment: "Apartment, suite, etc. (optional)",
+  city: "City",
+  postalCode: "Postal code",
+  phone: "Phone",
+  province: "State / province",
+
+  saveAddress: "Save and continue",
+  updateAddress: "Update address",
+  addToOrder: "+ Add to order",
+  addCode: "Apply",
+
+  deliveryDisabled:
+    "Enter your delivery address to see available shipping options.",
+  noShippingOptions: "No shipping options available for your address.",
+  paymentDisabled: "Select a shipping method to continue.",
+  deliveryPreviewHint: "Enter your address to choose a delivery method.",
+  buyNeedsAddress: "Enter your delivery address",
+  buyNeedsDelivery: "Choose a delivery method",
+
+  codNote: "Cash on delivery. Additional fees may apply.",
+  payOnline: "Pay online",
+  cashOnDelivery: "Cash on delivery",
+  termsText:
+    "By placing your order you accept our Terms and Privacy Policy.",
+
+  useSavedAddress: "Use a saved address?",
+  saveInfo: "Save this information for next time",
+
+  chooseAddress: "Choose an address",
+
+  items: "items",
+  qty: "Qty",
+  subtotal: "Subtotal",
+  shipping: "Shipping",
+  shippingCalc: "Calculated at checkout",
+  shippingFree: "Free",
+  // The row NAME, neutral on purpose: it sits beside a number, so it must
+  // say something, but "VAT incl." names one tax regime and asserts that
+  // prices include it. That is Bulgaria's answer, not Germany's, and not any
+  // US state's. A store that wants its own word sets it in its pack.
+  tax: "Tax",
+  // NO DEFAULT. The explanation used to read "20% VAT is included in
+  // prices", a rate and a regime the library cannot know, translated into
+  // three languages. A store writes it or the tooltip does not appear at
+  // all, which costs a shopper nothing.
+  taxTooltip: undefined,
+  total: "Total",
+  discount: "Discount",
+  discountCode: "Discount code",
+  discountSub: "Save with a promo code",
+  paymentMethodFee: "Payment method fee",
+  recommended: "Recommended for you",
+  recommendedSoon: "Coming soon",
+  recommendedSoonSub: "Personalized recommendations",
+  remove: "Remove",
+  secureCheckout: "Secure checkout",
+
+  giftCard: "Gift card",
+  giftCardSub: "Redeem a gift card",
+  giftCardPlaceholder: "GIFT-XXXX-XXXX",
+  giftCardApplied: "Gift cards",
+  giftCardRemaining: "Remaining to pay",
+  giftCardEnding: "Gift card ending in",
+
+  companyInvoice: "Company invoice",
+  companyName: "Company name",
+  companyVat: "VAT / Company number",
+  companyMol: "Responsible person",
+  companyAddress: "Company address",
+
+  placeOrder: "Place order",
+  selectPaymentMethod: "Select a payment method",
+
+  processingCard: [
+    "Connecting to the bank...",
+    "Confirming the payment...",
+    "Recording the order...",
+    "Attending to every detail...",
+  ],
+  processingCod: [
+    "Reserving the delivery...",
+    "Preparing the order...",
+    "Attending to every detail...",
+  ],
+
+  econtLoadingOffices: "Loading offices...",
+  econtNearestOffices: "Nearest offices",
+  econtSearchAnother: "Search for another office",
+  econtSearchPlaceholder: "Search by name, city, or address...",
+  econtNoResults: "No offices found for",
+  econtChange: "Change",
+
+  boxnowLoadingLockers: "Loading lockers...",
+  boxnowNearestLockers: "Nearest lockers",
+  boxnowSearchAnother: "Search for another locker",
+  boxnowSearchPlaceholder: "Search by name, address, or postal code...",
+  boxnowNoResults: "No lockers found for",
+  boxnowChange: "Change",
+  boxnowUnavailable:
+    "BoxNow is temporarily unavailable, please choose a different shipping method.",
+  boxnowNoLockersInCity:
+    "No BoxNow lockers found in your city. Please choose a different shipping method.",
+  addressErrors: {
+    generic:
+      "We could not save your address. Please check the details and try again.",
+    network:
+      "We cannot reach the server. Please check your connection and try again.",
+    validationFailed:
+      "One of the fields is not valid. Please check the details and try again.",
+    invalidRegion: "That country is not valid. Please reload the page.",
+    regionRequired: "The delivery region is not valid. Please reload the page.",
+    cartCompleted:
+      "This order is already placed. Please check your email for the confirmation.",
+    cartNotFound: "Your cart session expired. Please reload the page.",
+    invalidEmail: "That email address is not valid. Please check the spelling.",
+    // NOT "four digits": the postcode length is the country's business, and
+    // the Bulgarian original said four, which is wrong everywhere else.
+    invalidPostalCode: "That postal code is not valid. Please check it.",
+    invalidPhone: "That phone number is not valid. Please check the digits.",
+    invalidCountry: "That country is not valid. Please reload the page.",
+  },
+  paymentErrors: {
+    genericCard:
+      "The payment could not be processed right now. Try again or choose another payment method.",
+    genericCod: "The order could not be placed right now. Try again in a moment.",
+    cartEmailRequired:
+      "An email address is needed to place the order. Add one to continue.",
+    cartEmpty: "Your cart is empty. Add a product to continue.",
+    shippingAddressRequired:
+      "A delivery address is needed to place the order. Add one to continue.",
+    shippingMethodRequired: "Choose a delivery method to continue.",
+    paymentCollectionRequired: "The payment is not ready yet. Try again.",
+    paymentSessionRequired: "The payment is not ready yet. Try again.",
+    insufficientInventory:
+      "One of the products is no longer available in the quantity you chose. Update your cart to continue.",
+    checkoutMethodHidden:
+      "The method you chose is no longer available for this order. Choose another one and try again.",
+    requiresAction:
+      "Your bank needs to confirm this payment. Follow the steps it shows to continue.",
+    paymentNotAuthorized:
+      "The payment was not approved. Try again or choose another payment method.",
+    paymentNotInitiated:
+      "The payment expired before it went through. Reload the page and try again.",
+    paymentIncomplete:
+      "Your gift cards no longer cover the full amount. Choose a payment method for the rest.",
+    giftCardInsufficientBalance:
+      "The balance on that gift card no longer covers the amount. Remove it or choose another payment method.",
+    giftCardNotRedeemable:
+      "That gift card can no longer be used. Remove it and try again.",
+    accountRequired: "This order needs you to be signed in. Sign in to continue.",
+    cartLocked:
+      "This order is being processed right now. Wait a few seconds before trying again.",
+    cartCompleted:
+      "This order has already gone through. Check your email for the confirmation.",
+    cartNotFound: "Your cart is no longer available. Reload the page to start again.",
+    shippingOptionNotFound:
+      "The delivery method you chose is no longer available. Choose another one.",
+    invalidProvider: "The payment method you chose cannot be used. Choose another one.",
+    shippingPriceMissing:
+      "The delivery cost could not be worked out. Choose another delivery method.",
+    stripeNotConfigured:
+      "Card payments are unavailable at the moment. Choose another payment method.",
+    validationFailed: "Some order details are missing. Check the form and try again.",
+    cardDeclined:
+      "That card was declined by the bank. Try another card or contact your bank.",
+    insufficientFunds: "That card does not have enough funds. Try another card.",
+    expiredCard: "That card has expired. Try another card.",
+    incorrectCvc:
+      "The security code does not match. Check the security code on your card and try again.",
+    incorrectCardNumber:
+      "That card number does not look right. Check the digits and try again.",
+    invalidExpiry: "The expiry date does not look right. Check the month and the year.",
+    authenticationRequired:
+      "Your bank needs to confirm this payment. Follow the steps it shows to continue.",
+    processingError: "The card could not be processed. Try again in a moment.",
+    rateLimited:
+      "There have been too many payment attempts. Wait a few minutes and try again.",
+    paymentExpired:
+      "The payment expired before it went through. Reload the page and try again.",
+    amountMismatch: "The order total changed. Reload the page and try again.",
+    networkError:
+      "The connection was lost. Check your internet connection and try again.",
+    cartAlreadyCompleted:
+      "This order has already gone through. Check your email for the confirmation.",
+    outOfStock:
+      "One of the products is no longer available in the quantity you chose. Update your cart to continue.",
+    invalidRegion:
+      "This delivery destination is not available. Reload the page and try again.",
+    shippingMethodMissing: "Choose a delivery method to continue.",
+  },
+  giftCardErrors: {
+    invalidGiftCard: "That gift card code is not valid. Check the code and try again.",
+    rateLimited: "Too many attempts. Wait a few minutes and try again.",
+    cartCompleted:
+      "This order is already placed. Check your email for the confirmation.",
+    cartNotFound: "Your cart timed out. Reload the page and try again.",
+    validationFailed: "That code is not valid. Check it and try again.",
+    generic: "The gift card could not be applied right now. Try again in a moment.",
+  },
+  promotionErrors: {
+    generic:
+      "This discount code can't be applied right now. Check the code and try again.",
+    needsEmail:
+      "This discount code needs an email address. Add yours above and try again.",
+    exhausted: "This promotion has been fully used and is no longer available.",
+    promotionNotFound: "This discount code isn't valid. Check it and try again.",
+    promotionInactive: "This discount code is no longer active.",
+    promotionMisconfigured:
+      "This discount code can't be applied right now. Check the code and try again.",
+    promotionUnsupportedType:
+      "This discount code can't be applied right now. Check the code and try again.",
+    cartCompleted:
+      "This order has already been placed. Check your email for the confirmation.",
+    cartNotFound: "We couldn't find your cart. Reload the page and try again.",
+    validationFailed: "This discount code isn't valid. Check it and try again.",
+  },
+}