npm - @cartbase/storefront - Versions diffs - 0.20.0 → 0.20.1 - Mend

@cartbase/storefront 0.20.0 → 0.20.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 (99) hide show

package/LICENSE +21 -21
package/package.json +258 -258
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/redirects.ts +37 -37
package/src/api/regions.ts +200 -200
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 +778 -778
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/item/index.tsx +162 -162
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 -78
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/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/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/context.ts +37 -37
package/src/locales/en.ts +26 -26
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/option-select.tsx +67 -67
package/src/products/product-info.tsx +5 -5
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/purchase-options.tsx +130 -130
package/src/products/sets.ts +110 -110
package/src/products/variant-matching.ts +71 -71
package/src/products/variant-url.ts +74 -74
package/src/reviews-ui/lightbox-state.ts +46 -46
package/src/reviews-ui/review-header.tsx +166 -166
package/src/reviews-ui/review-lightbox.tsx +271 -271
package/src/reviews-ui/review-list.tsx +193 -193
package/src/reviews-ui/review-widget.tsx +219 -218
package/src/reviews-ui/widget-options.ts +55 -55
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/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",
+}