npm - @cartbase/storefront - Versions diffs - 0.17.0 → 0.18.1 - Mend

@cartbase/storefront 0.17.0 → 0.18.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (108) hide show

package/LICENSE +21 -21
package/package.json +3 -1
package/src/api/auth.ts +108 -108
package/src/api/carts.ts +523 -523
package/src/api/categories.ts +184 -184
package/src/api/checkout.ts +526 -526
package/src/api/collections.ts +130 -130
package/src/api/consent.ts +75 -75
package/src/api/content.ts +125 -125
package/src/api/customers.ts +303 -303
package/src/api/gift-cards.ts +112 -112
package/src/api/http.ts +180 -180
package/src/api/index.ts +30 -30
package/src/api/menus.ts +77 -77
package/src/api/metaobjects.ts +136 -136
package/src/api/orders.ts +290 -290
package/src/api/products.ts +43 -1
package/src/api/redirects.ts +37 -37
package/src/api/regions.ts +200 -200
package/src/api/reviews.ts +259 -259
package/src/api/search.ts +163 -163
package/src/api/store.ts +35 -35
package/src/api/types.ts +91 -91
package/src/cart-drawer/context.tsx +367 -168
package/src/cart-drawer/cross-sell-carousel.tsx +211 -211
package/src/cart-drawer/cross-sell-sidebar.tsx +158 -158
package/src/cart-drawer/gift-wrap.tsx +82 -82
package/src/cart-drawer/index.ts +73 -68
package/src/cart-drawer/item/index.tsx +162 -162
package/src/cart-drawer/item/quantity.tsx +8 -14
package/src/cart-drawer/item/upsell.tsx +110 -110
package/src/cart-drawer/labels.ts +123 -123
package/src/cart-drawer/mutation-queue.ts +78 -0
package/src/cart-drawer/notes.tsx +131 -131
package/src/cart-drawer/sticky-footer.tsx +73 -73
package/src/cart-drawer/summary-breakdown.tsx +197 -197
package/src/checkout/address-error-copy.ts +117 -117
package/src/checkout/boxnow-locker-selector.tsx +410 -410
package/src/checkout/compare-addresses.ts +40 -40
package/src/checkout/discount-section.tsx +218 -218
package/src/checkout/error-copy-codes.ts +63 -63
package/src/checkout/geocode.ts +154 -154
package/src/checkout/gift-card-section.tsx +224 -224
package/src/checkout/index.ts +72 -72
package/src/checkout/labels.ts +495 -495
package/src/checkout/payment-button.tsx +372 -372
package/src/checkout/payment-error-copy.ts +154 -154
package/src/checkout/promotion-error-copy.ts +91 -91
package/src/checkout/use-checkout-orchestration.ts +1604 -1592
package/src/common/country-flag.tsx +52 -52
package/src/common/country-select.tsx +11 -11
package/src/common/index.ts +20 -20
package/src/common/market-select.tsx +57 -57
package/src/index.ts +12 -12
package/src/lib/cookie-names.ts +14 -0
package/src/lib/country-name.ts +59 -59
package/src/lib/get-product-price.ts +133 -133
package/src/lib/media-image.tsx +39 -39
package/src/lib/payment-constants.ts +53 -53
package/src/lib/platform.ts +13 -13
package/src/lib/price.tsx +39 -39
package/src/lib/store-api-error.ts +36 -36
package/src/lib/variant-caption.ts +32 -32
package/src/locales/bg.ts +467 -467
package/src/locales/context.ts +37 -37
package/src/locales/en.ts +26 -26
package/src/locales/es.ts +466 -466
package/src/locales/index.ts +19 -19
package/src/locales/provider.tsx +59 -59
package/src/locales/types.ts +77 -77
package/src/order/index.ts +62 -62
package/src/order/labels.ts +79 -79
package/src/order/order-totals.tsx +250 -250
package/src/primitives/select-field.tsx +93 -93
package/src/products/image-gallery.tsx +43 -43
package/src/products/index.ts +68 -59
package/src/products/option-select.tsx +67 -67
package/src/products/product-actions-wrapper.tsx +63 -62
package/src/products/product-actions.tsx +151 -150
package/src/products/product-price.tsx +69 -69
package/src/products/product-promises.tsx +61 -61
package/src/products/product-specs.tsx +65 -65
package/src/products/product-tabs.tsx +123 -123
package/src/products/product-template.tsx +163 -162
package/src/products/purchase-options.tsx +130 -130
package/src/products/sets.ts +110 -0
package/src/products/use-product-actions.ts +199 -164
package/src/products/variant-matching.ts +71 -71
package/src/products/variant-url.ts +74 -74
package/src/reviews-ui/index.ts +73 -73
package/src/store/category-template.tsx +136 -136
package/src/store/index.ts +40 -40
package/src/tracking/chatgpt-pixel.tsx +99 -99
package/src/tracking/consent-init.tsx +62 -62
package/src/tracking/events.ts +348 -348
package/src/tracking/ga4.tsx +93 -93
package/src/tracking/google-ads.ts +84 -84
package/src/tracking/gtm.tsx +60 -60
package/src/tracking/inline-script.ts +49 -49
package/src/tracking/oaiq.ts +206 -206
package/src/tracking/tiktok-pixel.tsx +91 -91
package/src/tracking/track-init.tsx +56 -56
package/src/tracking/track-order-purchase.tsx +122 -122
package/src/tracking/ttq.ts +180 -180
package/src/tracking/use-tracking-config.ts +54 -54
package/theme/index.css +25 -25
package/theme/theme.css +150 -150
package/theme/tokens.css +106 -106

package/src/locales/index.ts CHANGED Viewed

@@ -1,19 +1,19 @@
-/**
- * THE LOCALE LAYER.
- *
- * The library speaks international ENGLISH by default and knows nothing
- * about any other language. A language is a PACK the store imports:
- *
- *   import { es } from "@cartbase/storefront/locales/es"
- *   <StorefrontLocaleProvider locale={es}>{children}</StorefrontLocaleProvider>
- *
- * Import a pack by its own subpath (`/locales/es`, `/locales/bg`) rather
- * than from here, so a store that ships one language does not bundle the
- * others. This barrel carries the type, the provider and English only.
- *
- * Shipping: English, Spanish, Bulgarian (2026-09-13). Adding a language is
- * one file in this folder plus its export path, and nothing else.
- */
-export { en } from "./en"
-export { StorefrontLocaleProvider, useStorefrontLocale } from "./provider"
-export type { PropLabelAreas, StorefrontLocale } from "./types"
+/**
+ * THE LOCALE LAYER.
+ *
+ * The library speaks international ENGLISH by default and knows nothing
+ * about any other language. A language is a PACK the store imports:
+ *
+ *   import { es } from "@cartbase/storefront/locales/es"
+ *   <StorefrontLocaleProvider locale={es}>{children}</StorefrontLocaleProvider>
+ *
+ * Import a pack by its own subpath (`/locales/es`, `/locales/bg`) rather
+ * than from here, so a store that ships one language does not bundle the
+ * others. This barrel carries the type, the provider and English only.
+ *
+ * Shipping: English, Spanish, Bulgarian (2026-09-13). Adding a language is
+ * one file in this folder plus its export path, and nothing else.
+ */
+export { en } from "./en"
+export { StorefrontLocaleProvider, useStorefrontLocale } from "./provider"
+export type { PropLabelAreas, StorefrontLocale } from "./types"

package/src/locales/provider.tsx CHANGED Viewed

@@ -1,59 +1,59 @@
-"use client"
-import { useContext, type ReactNode } from "react"
-import { CheckoutProvider } from "../checkout/context"
-import { OrderLabelsProvider } from "../order/context"
-import { ProductLabelsProvider } from "../products/context"
-import { StorefrontLocaleContext } from "./context"
-import type { StorefrontLocale } from "./types"
-import { en } from "./en"
-/**
- * ONE PROVIDER FOR THE STORE'S LANGUAGE.
- *
- *   import { es } from "@cartbase/storefront/locales/es"
- *   <StorefrontLocaleProvider locale={es}>{children}</StorefrontLocaleProvider>
- *
- * Every CLIENT component inside it speaks the pack, and nothing else has to
- * be wired: it mounts the three label contexts (products, checkout, order),
- * and the cart drawer and the reviews family read the language from it
- * directly (`useLocaleArea`, since 2026-09-14). It does not MOUNT the cart
- * drawer, because that provider carries the cart's state, its client and its
- * persistence callbacks, which belong where the app owns that state; the
- * drawer only reads the language from here.
- *
- * What it cannot reach is a SERVER component, because a server component has
- * no context. The store, product and order templates render on the server,
- * so each page hands them their area of the pack as a REQUIRED prop:
- * `PropLabelAreas` in ./types names them, with the mounts written out.
- *
- * DEFAULT IS ENGLISH. A component rendered outside this provider reads the
- * library's own English defaults, so nothing renders blank or crashes for
- * want of a provider.
- */
-export function StorefrontLocaleProvider({
-  locale,
-  children,
-}: {
-  locale: StorefrontLocale
-  children: ReactNode
-}) {
-  return (
-    <StorefrontLocaleContext.Provider value={locale}>
-      <ProductLabelsProvider labels={locale.products}>
-        <CheckoutProvider labels={locale.checkout}>
-          <OrderLabelsProvider labels={locale.order}>{children}</OrderLabelsProvider>
-        </CheckoutProvider>
-      </ProductLabelsProvider>
-    </StorefrontLocaleContext.Provider>
-  )
-}
-/**
- * The whole mounted locale, English when none is mounted: for the code that
- * needs the language itself, e.g. `<html lang={locale.code}>`, and for a
- * client shell that hands a server template its pack.
- */
-export function useStorefrontLocale(): StorefrontLocale {
-  return useContext(StorefrontLocaleContext) ?? en
-}
+"use client"
+import { useContext, type ReactNode } from "react"
+import { CheckoutProvider } from "../checkout/context"
+import { OrderLabelsProvider } from "../order/context"
+import { ProductLabelsProvider } from "../products/context"
+import { StorefrontLocaleContext } from "./context"
+import type { StorefrontLocale } from "./types"
+import { en } from "./en"
+/**
+ * ONE PROVIDER FOR THE STORE'S LANGUAGE.
+ *
+ *   import { es } from "@cartbase/storefront/locales/es"
+ *   <StorefrontLocaleProvider locale={es}>{children}</StorefrontLocaleProvider>
+ *
+ * Every CLIENT component inside it speaks the pack, and nothing else has to
+ * be wired: it mounts the three label contexts (products, checkout, order),
+ * and the cart drawer and the reviews family read the language from it
+ * directly (`useLocaleArea`, since 2026-09-14). It does not MOUNT the cart
+ * drawer, because that provider carries the cart's state, its client and its
+ * persistence callbacks, which belong where the app owns that state; the
+ * drawer only reads the language from here.
+ *
+ * What it cannot reach is a SERVER component, because a server component has
+ * no context. The store, product and order templates render on the server,
+ * so each page hands them their area of the pack as a REQUIRED prop:
+ * `PropLabelAreas` in ./types names them, with the mounts written out.
+ *
+ * DEFAULT IS ENGLISH. A component rendered outside this provider reads the
+ * library's own English defaults, so nothing renders blank or crashes for
+ * want of a provider.
+ */
+export function StorefrontLocaleProvider({
+  locale,
+  children,
+}: {
+  locale: StorefrontLocale
+  children: ReactNode
+}) {
+  return (
+    <StorefrontLocaleContext.Provider value={locale}>
+      <ProductLabelsProvider labels={locale.products}>
+        <CheckoutProvider labels={locale.checkout}>
+          <OrderLabelsProvider labels={locale.order}>{children}</OrderLabelsProvider>
+        </CheckoutProvider>
+      </ProductLabelsProvider>
+    </StorefrontLocaleContext.Provider>
+  )
+}
+/**
+ * The whole mounted locale, English when none is mounted: for the code that
+ * needs the language itself, e.g. `<html lang={locale.code}>`, and for a
+ * client shell that hands a server template its pack.
+ */
+export function useStorefrontLocale(): StorefrontLocale {
+  return useContext(StorefrontLocaleContext) ?? en
+}

package/src/locales/types.ts CHANGED Viewed

@@ -1,77 +1,77 @@
-import type { CartDrawerLabels } from "../cart-drawer/labels"
-import type { CheckoutLabels } from "../checkout/labels"
-import type { OrderLabels } from "../order/labels"
-import type { ProductLabels } from "../products/labels"
-import type { ReviewsUiLabels } from "../reviews-ui/labels"
-import type { StoreLabels } from "../store/labels"
-/**
- * A LOCALE IS ONE OBJECT COVERING THE WHOLE STOREFRONT.
- *
- * Before this (2026-09-13) every area shipped its own English defaults and
- * its own Bulgarian file, so localizing a store meant importing six packs
- * and mounting four separate providers, and a global package shipped
- * Bulgarian copy to every merchant on earth. Alexander's ruling: the
- * library is international ENGLISH, and a language is a pack the store
- * opts into.
- *
- * So: English is the library's own default and lives in each area's
- * `labels.ts` beside its type. Every other language is a locale pack
- * imported by subpath — `@cartbase/storefront/locales/es`,
- * `/locales/bg` — and is typed against these six shapes, which means a
- * missing translation is a COMPILE ERROR rather than a silent fall back to
- * English in the middle of a Spanish checkout.
- *
- * Adding a language is one file in `src/locales/` plus its export path.
- * Nothing else in the package changes, and no component knows a language
- * exists.
- */
-export interface StorefrontLocale {
-  /** BCP 47 code, for the app's own persistence and for `<html lang>`. */
-  code: string
-  /** The language's own name, for a switcher that does not want Intl. */
-  name: string
-  products: ProductLabels
-  store: StoreLabels
-  cartDrawer: CartDrawerLabels
-  checkout: CheckoutLabels
-  order: OrderLabels
-  reviews: ReviewsUiLabels
-}
-/**
- * THE AREAS WHOSE PACK THE APP MUST HAND OVER AS A PROP, and the prop is
- * REQUIRED.
- *
- * Not a style choice and not a gap in this layer: a React SERVER component
- * cannot read a client context, and these areas are rendered on the server.
- * `StorefrontLocaleProvider` therefore reaches the client components and
- * nothing else, and a server-rendered heading would stay English however
- * many providers were mounted above it.
- *
- * Since 2026-09-14 the page-level templates of these areas REQUIRE the pack
- * (`labels: StoreLabels`, never `labels?`), so a page that forgets it fails
- * to compile instead of shipping silent English. That was the defect: on
- * 2026-09-13 evoo, a Bulgarian store, ended a product page in the English
- * "Related products / You might also want to check out these products", and
- * its search page and order confirmation stayed English, with no error, no
- * warning and no failing test. English is not a special case: an English
- * store passes `en.store`. The scaffold declares `STORE_LOCALE` once in its
- * config and every page reads its area from it.
- *
- * Hand the pack to each page-level template once and everything inside it
- * follows:
- *
- *   <StoreTemplate          labels={STORE_LOCALE.store} />
- *   <SearchTemplate         labels={STORE_LOCALE.store} />
- *   <CollectionTemplate     labels={STORE_LOCALE.store} />
- *   <CategoryTemplate       labels={STORE_LOCALE.store} />
- *   <ProductTemplate        labels={STORE_LOCALE.products} />   // + the related strip
- *   <OrderCompletedTemplate labels={STORE_LOCALE.order} />
- *
- * The cart drawer and the reviews family were listed here until 2026-09-14.
- * They are client components, so they now read the mounted language
- * themselves (`useLocaleArea` in ./context); their `labels` prop is an
- * override, never a requirement.
- */
-export type PropLabelAreas = Pick<StorefrontLocale, "products" | "store" | "order">
+import type { CartDrawerLabels } from "../cart-drawer/labels"
+import type { CheckoutLabels } from "../checkout/labels"
+import type { OrderLabels } from "../order/labels"
+import type { ProductLabels } from "../products/labels"
+import type { ReviewsUiLabels } from "../reviews-ui/labels"
+import type { StoreLabels } from "../store/labels"
+/**
+ * A LOCALE IS ONE OBJECT COVERING THE WHOLE STOREFRONT.
+ *
+ * Before this (2026-09-13) every area shipped its own English defaults and
+ * its own Bulgarian file, so localizing a store meant importing six packs
+ * and mounting four separate providers, and a global package shipped
+ * Bulgarian copy to every merchant on earth. Alexander's ruling: the
+ * library is international ENGLISH, and a language is a pack the store
+ * opts into.
+ *
+ * So: English is the library's own default and lives in each area's
+ * `labels.ts` beside its type. Every other language is a locale pack
+ * imported by subpath — `@cartbase/storefront/locales/es`,
+ * `/locales/bg` — and is typed against these six shapes, which means a
+ * missing translation is a COMPILE ERROR rather than a silent fall back to
+ * English in the middle of a Spanish checkout.
+ *
+ * Adding a language is one file in `src/locales/` plus its export path.
+ * Nothing else in the package changes, and no component knows a language
+ * exists.
+ */
+export interface StorefrontLocale {
+  /** BCP 47 code, for the app's own persistence and for `<html lang>`. */
+  code: string
+  /** The language's own name, for a switcher that does not want Intl. */
+  name: string
+  products: ProductLabels
+  store: StoreLabels
+  cartDrawer: CartDrawerLabels
+  checkout: CheckoutLabels
+  order: OrderLabels
+  reviews: ReviewsUiLabels
+}
+/**
+ * THE AREAS WHOSE PACK THE APP MUST HAND OVER AS A PROP, and the prop is
+ * REQUIRED.
+ *
+ * Not a style choice and not a gap in this layer: a React SERVER component
+ * cannot read a client context, and these areas are rendered on the server.
+ * `StorefrontLocaleProvider` therefore reaches the client components and
+ * nothing else, and a server-rendered heading would stay English however
+ * many providers were mounted above it.
+ *
+ * Since 2026-09-14 the page-level templates of these areas REQUIRE the pack
+ * (`labels: StoreLabels`, never `labels?`), so a page that forgets it fails
+ * to compile instead of shipping silent English. That was the defect: on
+ * 2026-09-13 evoo, a Bulgarian store, ended a product page in the English
+ * "Related products / You might also want to check out these products", and
+ * its search page and order confirmation stayed English, with no error, no
+ * warning and no failing test. English is not a special case: an English
+ * store passes `en.store`. The scaffold declares `STORE_LOCALE` once in its
+ * config and every page reads its area from it.
+ *
+ * Hand the pack to each page-level template once and everything inside it
+ * follows:
+ *
+ *   <StoreTemplate          labels={STORE_LOCALE.store} />
+ *   <SearchTemplate         labels={STORE_LOCALE.store} />
+ *   <CollectionTemplate     labels={STORE_LOCALE.store} />
+ *   <CategoryTemplate       labels={STORE_LOCALE.store} />
+ *   <ProductTemplate        labels={STORE_LOCALE.products} />   // + the related strip
+ *   <OrderCompletedTemplate labels={STORE_LOCALE.order} />
+ *
+ * The cart drawer and the reviews family were listed here until 2026-09-14.
+ * They are client components, so they now read the mounted language
+ * themselves (`useLocaleArea` in ./context); their `labels` prop is an
+ * override, never a requirement.
+ */
+export type PropLabelAreas = Pick<StorefrontLocale, "products" | "store" | "order">

package/src/order/index.ts CHANGED Viewed

@@ -1,62 +1,62 @@
-/**
- * @cartbase/storefront/order — order confirmation + account order views.
- * Ported from `@1click/ui/src/order` (v2.3.1) with Cartbase data seams; see
- * per-module JSDoc and docs/storefront/components.md for the contracts.
- */
-export { OrderLabelsProvider, useOrderLabels } from "./context"
-export { defaultOrderLabels, type OrderLabels } from "./labels"
-export {
-  OrderConfirmationHeader,
-  type OrderConfirmationHeaderProps,
-  type OrderHeaderData,
-} from "./order-confirmation-header"
-export {
-  OrderItem,
-  displayItemFromOrderItem,
-  displayItemFromCartLine,
-  variantLabelFrom,
-  type OrderItemProps,
-  type OrderDisplayItem,
-  type CartLineLike,
-} from "./order-item"
-export { OrderItemsList, type OrderItemsListProps } from "./order-items-list"
-export {
-  OrderTotals,
-  selectOrderTotalsRows,
-  orderTotalsFromSummary,
-  type OrderTotalsProps,
-  type OrderTotalsSource,
-  type OrderTotalsRow,
-} from "./order-totals"
-export {
-  OrderAddressCard,
-  type OrderAddressCardProps,
-  type OrderContactData,
-} from "./order-address-card"
-export {
-  OrderDeliveryCard,
-  pickTrackingLabels,
-  type OrderDeliveryCardProps,
-  type OrderDeliveryData,
-  type ShippingMethodDisplay,
-  type TrackingLabel,
-} from "./order-delivery-card"
-export {
-  OrderPaymentCard,
-  resolvePaymentTitle,
-  type OrderPaymentCardProps,
-} from "./order-payment-card"
-export {
-  OrderTimeline,
-  deriveFulfillmentStatus,
-  type OrderTimelineProps,
-} from "./order-timeline"
-export {
-  OrderHelpSection,
-  type OrderHelpSectionProps,
-} from "./order-help-section"
-export {
-  OrderCompletedTemplate,
-  type OrderCompletedTemplateProps,
-} from "./order-completed-template"
+/**
+ * @cartbase/storefront/order — order confirmation + account order views.
+ * Ported from `@1click/ui/src/order` (v2.3.1) with Cartbase data seams; see
+ * per-module JSDoc and docs/storefront/components.md for the contracts.
+ */
+export { OrderLabelsProvider, useOrderLabels } from "./context"
+export { defaultOrderLabels, type OrderLabels } from "./labels"
+export {
+  OrderConfirmationHeader,
+  type OrderConfirmationHeaderProps,
+  type OrderHeaderData,
+} from "./order-confirmation-header"
+export {
+  OrderItem,
+  displayItemFromOrderItem,
+  displayItemFromCartLine,
+  variantLabelFrom,
+  type OrderItemProps,
+  type OrderDisplayItem,
+  type CartLineLike,
+} from "./order-item"
+export { OrderItemsList, type OrderItemsListProps } from "./order-items-list"
+export {
+  OrderTotals,
+  selectOrderTotalsRows,
+  orderTotalsFromSummary,
+  type OrderTotalsProps,
+  type OrderTotalsSource,
+  type OrderTotalsRow,
+} from "./order-totals"
+export {
+  OrderAddressCard,
+  type OrderAddressCardProps,
+  type OrderContactData,
+} from "./order-address-card"
+export {
+  OrderDeliveryCard,
+  pickTrackingLabels,
+  type OrderDeliveryCardProps,
+  type OrderDeliveryData,
+  type ShippingMethodDisplay,
+  type TrackingLabel,
+} from "./order-delivery-card"
+export {
+  OrderPaymentCard,
+  resolvePaymentTitle,
+  type OrderPaymentCardProps,
+} from "./order-payment-card"
+export {
+  OrderTimeline,
+  deriveFulfillmentStatus,
+  type OrderTimelineProps,
+} from "./order-timeline"
+export {
+  OrderHelpSection,
+  type OrderHelpSectionProps,
+} from "./order-help-section"
+export {
+  OrderCompletedTemplate,
+  type OrderCompletedTemplateProps,
+} from "./order-completed-template"

package/src/order/labels.ts CHANGED Viewed

@@ -1,79 +1,79 @@
-/**
- * Order family label pack. Ported from `@1click/ui/src/order/labels.ts`
- * (v2.3.1) unchanged, plus `tracking` — new in the Cartbase port because the
- * Cartbase order surface exposes fulfillment tracking labels
- * (`StoreOrderDetail.fulfillments[].fulfillment.labels`) that
- * `OrderDeliveryCard` now renders.
- */
-export type OrderLabels = {
-  orderConfirmed: string
-  confirmationSent: string
-  orderNumber: string
-  orderDate: string
-  summary: string
-  subtotal: string
-  shipping: string
-  discount: string
-  tax: string
-  total: string
-  /** Default label for the cash-on-delivery fee row. Used as the third-
-   *  level fallback when neither a per-store override nor the server's
-   *  `payment_method_fee_label` / fee line title is available. */
-  paymentMethodFee: string
-  contactInfo: string
-  delivery: string
-  paymentMethod: string
-  paymentMethodTitles: {
-    card: string
-    cod: string
-    /** Offline manual payments (pp_manual) — NOT cash on delivery. */
-    manual: string
-    paypal: string
-  }
-  needHelp: string
-  contactUs: string
-  returnsExchanges: string
-  orderPlaced: string
-  processing: string
-  shipped: string
-  delivered: string
-  free: string
-  continueShopping: string
-  qty: string
-  /** Heading for the fulfillment tracking-numbers block (Cartbase addition). */
-  tracking: string
-}
-export const defaultOrderLabels: OrderLabels = {
-  orderConfirmed: "Order confirmed",
-  confirmationSent: "We sent a confirmation to",
-  orderNumber: "Order",
-  orderDate: "Date",
-  summary: "Order summary",
-  subtotal: "Subtotal",
-  shipping: "Shipping",
-  discount: "Discount",
-  tax: "Tax",
-  total: "Total",
-  paymentMethodFee: "Payment method fee",
-  contactInfo: "Contact info",
-  delivery: "Delivery",
-  paymentMethod: "Payment method",
-  paymentMethodTitles: {
-    card: "Credit / debit card",
-    cod: "Cash on delivery",
-    manual: "Manual payment",
-    paypal: "PayPal",
-  },
-  needHelp: "Need help?",
-  contactUs: "Contact us",
-  returnsExchanges: "Returns & exchanges",
-  orderPlaced: "Placed",
-  processing: "Processing",
-  shipped: "Shipped",
-  delivered: "Delivered",
-  free: "FREE",
-  continueShopping: "Continue shopping",
-  qty: "qty.",
-  tracking: "Tracking",
-}
+/**
+ * Order family label pack. Ported from `@1click/ui/src/order/labels.ts`
+ * (v2.3.1) unchanged, plus `tracking` — new in the Cartbase port because the
+ * Cartbase order surface exposes fulfillment tracking labels
+ * (`StoreOrderDetail.fulfillments[].fulfillment.labels`) that
+ * `OrderDeliveryCard` now renders.
+ */
+export type OrderLabels = {
+  orderConfirmed: string
+  confirmationSent: string
+  orderNumber: string
+  orderDate: string
+  summary: string
+  subtotal: string
+  shipping: string
+  discount: string
+  tax: string
+  total: string
+  /** Default label for the cash-on-delivery fee row. Used as the third-
+   *  level fallback when neither a per-store override nor the server's
+   *  `payment_method_fee_label` / fee line title is available. */
+  paymentMethodFee: string
+  contactInfo: string
+  delivery: string
+  paymentMethod: string
+  paymentMethodTitles: {
+    card: string
+    cod: string
+    /** Offline manual payments (pp_manual) — NOT cash on delivery. */
+    manual: string
+    paypal: string
+  }
+  needHelp: string
+  contactUs: string
+  returnsExchanges: string
+  orderPlaced: string
+  processing: string
+  shipped: string
+  delivered: string
+  free: string
+  continueShopping: string
+  qty: string
+  /** Heading for the fulfillment tracking-numbers block (Cartbase addition). */
+  tracking: string
+}
+export const defaultOrderLabels: OrderLabels = {
+  orderConfirmed: "Order confirmed",
+  confirmationSent: "We sent a confirmation to",
+  orderNumber: "Order",
+  orderDate: "Date",
+  summary: "Order summary",
+  subtotal: "Subtotal",
+  shipping: "Shipping",
+  discount: "Discount",
+  tax: "Tax",
+  total: "Total",
+  paymentMethodFee: "Payment method fee",
+  contactInfo: "Contact info",
+  delivery: "Delivery",
+  paymentMethod: "Payment method",
+  paymentMethodTitles: {
+    card: "Credit / debit card",
+    cod: "Cash on delivery",
+    manual: "Manual payment",
+    paypal: "PayPal",
+  },
+  needHelp: "Need help?",
+  contactUs: "Contact us",
+  returnsExchanges: "Returns & exchanges",
+  orderPlaced: "Placed",
+  processing: "Processing",
+  shipped: "Shipped",
+  delivered: "Delivered",
+  free: "FREE",
+  continueShopping: "Continue shopping",
+  qty: "qty.",
+  tracking: "Tracking",
+}