@cartbase/storefront 0.20.0 → 0.21.0

package/src/checkout/payment-error-copy.ts

@@ -1,154 +1,154 @@
-import { GIFT_CARD_CODE_KEYS, PAYMENT_CODE_KEYS } from "./error-copy-codes"
-import type { GiftCardErrorCopy, PaymentErrorCopy } from "./labels"
-
-/**
- * Recognizes a payment or order-completion failure and picks the copy key
- * for it.
- *
- * THE COPY IS NOT HERE ANY MORE. Until 2026-09-13 this file held 47
- * hardcoded BULGARIAN sentences, so every merchant who installed the
- * package showed Bulgarian at the exact moment a payment failed, with no
- * override. The words now live in the checkout label pack: English by
- * default, translated by whichever locale the store mounts.
- *
- * WHY THIS LAYER EXISTS AT ALL: Stripe and API errors are technical
- * English ("Your card's security code is incorrect.", "fetch failed").
- * Showing that to a shopper makes the site look broken rather than making
- * it look like they mistyped a digit. Unknown errors get the per-context
- * generic, because a half-translated technical string is worse than a
- * clean one.
- *
- * Recognition is CODE-FIRST — the store API throws `StoreApiError` with a
- * structured `code` (docs/storefront/checkout.md lists every code per
- * endpoint) — then the Stripe substring patterns, which still do the heavy
- * lifting on the card path because Stripe.js browser errors carry no
- * Cartbase code, then the legacy Medusa-era substrings.
- *
- * The patterns stay in English on purpose: they match the wire, not the
- * shopper.
- */
-
-export type ErrorContext = "card" | "cod"
-
-/**
- * Stripe error codes, decline codes and common substrings. Matched
- * case-insensitively, first match wins, so the order runs most specific to
- * most generic. Kept verbatim from the production port.
- *
- * Stripe error code reference: https://docs.stripe.com/error-codes
- */
-const STRIPE_PATTERNS: Array<{ match: RegExp; key: keyof PaymentErrorCopy }> = [
-  { match: /card[\s_-]?declined|card_declined/i, key: "cardDeclined" },
-  { match: /insufficient[\s_]?funds/i, key: "insufficientFunds" },
-  { match: /expired[\s_]?card|card[\s_]?has[\s_]?expired/i, key: "expiredCard" },
-  { match: /incorrect[\s_]?cvc|invalid[\s_]?cvc|cvc[\s_]?check/i, key: "incorrectCvc" },
-  { match: /incorrect[\s_]?number|invalid[\s_]?number/i, key: "incorrectCardNumber" },
-  { match: /invalid[\s_]?expir|incorrect[\s_]?expir/i, key: "invalidExpiry" },
-  { match: /authentication[\s_]?required|3d[\s_]?secure/i, key: "authenticationRequired" },
-  { match: /processing[\s_]?error/i, key: "processingError" },
-  { match: /rate[\s_]?limit/i, key: "rateLimited" },
-  // Terminal-state payment intent: the bug class refresh-payment-if-terminal heals.
-  {
-    match: /terminal[\s_]?state|payment[\s_]?intent[\s_]?(?:is|in)[\s_]?(?:a[\s_]?)?terminal/i,
-    key: "paymentExpired",
-  },
-  // Amount mismatch: the cart total drifted from the payment intent's amount.
-  { match: /amount[\s_]?mismatch|amount[\s_]?does[\s_]?not[\s_]?match/i, key: "amountMismatch" },
-  { match: /failed[\s_]?to[\s_]?fetch|network[\s_]?error|networkerror/i, key: "networkError" },
-]
-
-/** Legacy Medusa-era API substrings, the last fallback layer. */
-const API_PATTERNS: Array<{ match: RegExp; key: keyof PaymentErrorCopy }> = [
-  {
-    match: /cart[\s_]?(?:is[\s_]?)?already[\s_]?completed|already[\s_]?an[\s_]?order/i,
-    key: "cartAlreadyCompleted",
-  },
-  {
-    match:
-      /not[\s_]?enough[\s_]?stock|insufficient[\s_]?stock|out[\s_]?of[\s_]?stock|insufficient[\s_]?inventory/i,
-    key: "outOfStock",
-  },
-  { match: /no[\s_]?region|invalid[\s_]?region/i, key: "invalidRegion" },
-  {
-    match: /no[\s_]?shipping[\s_]?method|shipping[\s_]?method[\s_]?not[\s_]?found/i,
-    key: "shippingMethodMissing",
-  },
-]
-
-/** Pull the structured Cartbase error code out of any thrown value. */
-function extractCode(err: unknown): string | null {
-  if (err && typeof err === "object") {
-    const code = (err as { code?: unknown }).code
-    if (typeof code === "string" && code.length > 0) return code
-  }
-  return null
-}
-
-/** Which copy this failure asks for, independent of language. */
-export function paymentErrorKey(
-  err: unknown,
-  context: ErrorContext
-): keyof PaymentErrorCopy {
-  const generic = context === "card" ? "genericCard" : "genericCod"
-
-  const code = extractCode(err)
-  if (code && PAYMENT_CODE_KEYS[code]) return PAYMENT_CODE_KEYS[code]
-
-  const raw = extractMessage(err)
-  if (!raw) return generic
-
-  for (const { match, key } of STRIPE_PATTERNS) if (match.test(raw)) return key
-  for (const { match, key } of API_PATTERNS) if (match.test(raw)) return key
-  return generic
-}
-
-/**
- * Turn any thrown or returned payment error into the sentence a shopper
- * reads, in the store's own language.
- *
- * @param err - the error from a try/catch or a Stripe error response
- * @param context - "card" for the Stripe path, "cod" for the manual path
- * @param copy - the store's payment copy (`labels.paymentErrors`)
- */
-export function translatePaymentError(
-  err: unknown,
-  context: ErrorContext,
-  copy: PaymentErrorCopy
-): string {
-  return copy[paymentErrorKey(err, context)]
-}
-
-/** Which gift-card copy this failure asks for. */
-export function giftCardErrorKey(err: unknown): keyof GiftCardErrorCopy {
-  const code = extractCode(err)
-  if (code && GIFT_CARD_CODE_KEYS[code]) return GIFT_CARD_CODE_KEYS[code]
-  return "generic"
-}
-
-/**
- * Turn a gift-card apply or remove failure into the shopper's sentence.
- * Code-first, falling back to one clean generic: the API's anti-oracle
- * design means there is deliberately nothing more specific to say.
- */
-export function translateGiftCardError(
-  err: unknown,
-  copy: GiftCardErrorCopy
-): string {
-  return copy[giftCardErrorKey(err)]
-}
-
-function extractMessage(err: unknown): string {
-  if (!err) return ""
-  if (typeof err === "string") return err
-  if (err instanceof Error) return err.message
-  if (typeof err === "object" && err !== null) {
-    const e = err as {
-      message?: string
-      code?: string
-      decline_code?: string
-      type?: string
-    }
-    return [e.message, e.code, e.decline_code, e.type].filter(Boolean).join(" ")
-  }
-  return String(err)
-}
+import { GIFT_CARD_CODE_KEYS, PAYMENT_CODE_KEYS } from "./error-copy-codes"
+import type { GiftCardErrorCopy, PaymentErrorCopy } from "./labels"
+
+/**
+ * Recognizes a payment or order-completion failure and picks the copy key
+ * for it.
+ *
+ * THE COPY IS NOT HERE ANY MORE. Until 2026-09-13 this file held 47
+ * hardcoded BULGARIAN sentences, so every merchant who installed the
+ * package showed Bulgarian at the exact moment a payment failed, with no
+ * override. The words now live in the checkout label pack: English by
+ * default, translated by whichever locale the store mounts.
+ *
+ * WHY THIS LAYER EXISTS AT ALL: Stripe and API errors are technical
+ * English ("Your card's security code is incorrect.", "fetch failed").
+ * Showing that to a shopper makes the site look broken rather than making
+ * it look like they mistyped a digit. Unknown errors get the per-context
+ * generic, because a half-translated technical string is worse than a
+ * clean one.
+ *
+ * Recognition is CODE-FIRST — the store API throws `StoreApiError` with a
+ * structured `code` (docs/storefront/checkout.md lists every code per
+ * endpoint) — then the Stripe substring patterns, which still do the heavy
+ * lifting on the card path because Stripe.js browser errors carry no
+ * Cartbase code, then the legacy Medusa-era substrings.
+ *
+ * The patterns stay in English on purpose: they match the wire, not the
+ * shopper.
+ */
+
+export type ErrorContext = "card" | "cod"
+
+/**
+ * Stripe error codes, decline codes and common substrings. Matched
+ * case-insensitively, first match wins, so the order runs most specific to
+ * most generic. Kept verbatim from the production port.
+ *
+ * Stripe error code reference: https://docs.stripe.com/error-codes
+ */
+const STRIPE_PATTERNS: Array<{ match: RegExp; key: keyof PaymentErrorCopy }> = [
+  { match: /card[\s_-]?declined|card_declined/i, key: "cardDeclined" },
+  { match: /insufficient[\s_]?funds/i, key: "insufficientFunds" },
+  { match: /expired[\s_]?card|card[\s_]?has[\s_]?expired/i, key: "expiredCard" },
+  { match: /incorrect[\s_]?cvc|invalid[\s_]?cvc|cvc[\s_]?check/i, key: "incorrectCvc" },
+  { match: /incorrect[\s_]?number|invalid[\s_]?number/i, key: "incorrectCardNumber" },
+  { match: /invalid[\s_]?expir|incorrect[\s_]?expir/i, key: "invalidExpiry" },
+  { match: /authentication[\s_]?required|3d[\s_]?secure/i, key: "authenticationRequired" },
+  { match: /processing[\s_]?error/i, key: "processingError" },
+  { match: /rate[\s_]?limit/i, key: "rateLimited" },
+  // Terminal-state payment intent: the bug class refresh-payment-if-terminal heals.
+  {
+    match: /terminal[\s_]?state|payment[\s_]?intent[\s_]?(?:is|in)[\s_]?(?:a[\s_]?)?terminal/i,
+    key: "paymentExpired",
+  },
+  // Amount mismatch: the cart total drifted from the payment intent's amount.
+  { match: /amount[\s_]?mismatch|amount[\s_]?does[\s_]?not[\s_]?match/i, key: "amountMismatch" },
+  { match: /failed[\s_]?to[\s_]?fetch|network[\s_]?error|networkerror/i, key: "networkError" },
+]
+
+/** Legacy Medusa-era API substrings, the last fallback layer. */
+const API_PATTERNS: Array<{ match: RegExp; key: keyof PaymentErrorCopy }> = [
+  {
+    match: /cart[\s_]?(?:is[\s_]?)?already[\s_]?completed|already[\s_]?an[\s_]?order/i,
+    key: "cartAlreadyCompleted",
+  },
+  {
+    match:
+      /not[\s_]?enough[\s_]?stock|insufficient[\s_]?stock|out[\s_]?of[\s_]?stock|insufficient[\s_]?inventory/i,
+    key: "outOfStock",
+  },
+  { match: /no[\s_]?region|invalid[\s_]?region/i, key: "invalidRegion" },
+  {
+    match: /no[\s_]?shipping[\s_]?method|shipping[\s_]?method[\s_]?not[\s_]?found/i,
+    key: "shippingMethodMissing",
+  },
+]
+
+/** Pull the structured Cartbase error code out of any thrown value. */
+function extractCode(err: unknown): string | null {
+  if (err && typeof err === "object") {
+    const code = (err as { code?: unknown }).code
+    if (typeof code === "string" && code.length > 0) return code
+  }
+  return null
+}
+
+/** Which copy this failure asks for, independent of language. */
+export function paymentErrorKey(
+  err: unknown,
+  context: ErrorContext
+): keyof PaymentErrorCopy {
+  const generic = context === "card" ? "genericCard" : "genericCod"
+
+  const code = extractCode(err)
+  if (code && PAYMENT_CODE_KEYS[code]) return PAYMENT_CODE_KEYS[code]
+
+  const raw = extractMessage(err)
+  if (!raw) return generic
+
+  for (const { match, key } of STRIPE_PATTERNS) if (match.test(raw)) return key
+  for (const { match, key } of API_PATTERNS) if (match.test(raw)) return key
+  return generic
+}
+
+/**
+ * Turn any thrown or returned payment error into the sentence a shopper
+ * reads, in the store's own language.
+ *
+ * @param err - the error from a try/catch or a Stripe error response
+ * @param context - "card" for the Stripe path, "cod" for the manual path
+ * @param copy - the store's payment copy (`labels.paymentErrors`)
+ */
+export function translatePaymentError(
+  err: unknown,
+  context: ErrorContext,
+  copy: PaymentErrorCopy
+): string {
+  return copy[paymentErrorKey(err, context)]
+}
+
+/** Which gift-card copy this failure asks for. */
+export function giftCardErrorKey(err: unknown): keyof GiftCardErrorCopy {
+  const code = extractCode(err)
+  if (code && GIFT_CARD_CODE_KEYS[code]) return GIFT_CARD_CODE_KEYS[code]
+  return "generic"
+}
+
+/**
+ * Turn a gift-card apply or remove failure into the shopper's sentence.
+ * Code-first, falling back to one clean generic: the API's anti-oracle
+ * design means there is deliberately nothing more specific to say.
+ */
+export function translateGiftCardError(
+  err: unknown,
+  copy: GiftCardErrorCopy
+): string {
+  return copy[giftCardErrorKey(err)]
+}
+
+function extractMessage(err: unknown): string {
+  if (!err) return ""
+  if (typeof err === "string") return err
+  if (err instanceof Error) return err.message
+  if (typeof err === "object" && err !== null) {
+    const e = err as {
+      message?: string
+      code?: string
+      decline_code?: string
+      type?: string
+    }
+    return [e.message, e.code, e.decline_code, e.type].filter(Boolean).join(" ")
+  }
+  return String(err)
+}

package/src/checkout/promotion-error-copy.ts

@@ -1,91 +1,91 @@
-import { PROMOTION_CODE_KEYS } from "./error-copy-codes"
-import type { PromotionErrorCopy } from "./labels"
-
-/**
- * Recognizes a discount-code failure and picks the copy key for it.
- *
- * THE COPY IS NOT HERE ANY MORE. Until 2026-09-13 this file held seven
- * hardcoded BULGARIAN sentences that every merchant shipped and none could
- * override; the words now live in the checkout label pack, English by
- * default. The substring patterns stay in English because they match the
- * API's own error text, which is wire format and never shown.
- *
- * Recognition is code-first (`StoreApiError.code`), then the substrings
- * kept verbatim from the production port.
- */
-
-/**
- * Known promo error substrings. Case-insensitive, first match wins, most
- * specific first.
- */
-const PROMO_PATTERNS: Array<{ match: RegExp; key: keyof PromotionErrorCopy }> = [
-  // Campaign budget needs an email on the cart.
-  { match: /customer_email|campaign[\s_]?budget/i, key: "needsEmail" },
-  // Expired or no-longer-active promotion.
-  { match: /expired|no[\s_]?longer[\s_]?(?:active|valid)|inactive/i, key: "promotionInactive" },
-  // Budget or usage limit reached.
-  {
-    match: /reached[\s_]?its[\s_]?limit|usage[\s_]?limit|budget[\s_]?(?:exceeded|reached)/i,
-    key: "exhausted",
-  },
-  // Invalid or unknown code. Last of the specific set, because it is the
-  // broadest pattern and would otherwise swallow the ones above.
-  {
-    match: /is[\s_]?invalid|invalid[\s_]?data|not[\s_]?found|does(?:n'?t| not)[\s_]?exist/i,
-    key: "promotionNotFound",
-  },
-]
-
-/**
- * Which promotion copy this failure asks for.
- *
- * @param err the error from a try/catch: a StoreApiError with a code, a
- *            network error, or an opaque render error
- * @param opts.hasEmail whether the cart currently has an email. When the
- *            error is opaque and there is no email, the overwhelmingly
- *            likely cause is a campaign-budget promotion, so the shopper
- *            gets the actionable "enter your email" line rather than a
- *            vague fallback.
- */
-export function promotionErrorKey(
-  err: unknown,
-  opts?: { hasEmail?: boolean }
-): keyof PromotionErrorCopy {
-  if (err && typeof err === "object") {
-    const code = (err as { code?: unknown }).code
-    if (typeof code === "string" && PROMOTION_CODE_KEYS[code]) {
-      return PROMOTION_CODE_KEYS[code]
-    }
-  }
-
-  const raw = extractMessage(err)
-  for (const { match, key } of PROMO_PATTERNS) if (match.test(raw)) return key
-
-  // Unknown or opaque. With no email on the cart the campaign-budget case
-  // is by far the most common trigger, so point at the fix, not a dead end.
-  if (opts?.hasEmail === false) return "needsEmail"
-  return "generic"
-}
-
-/**
- * Turn any thrown or returned promotion error into the sentence a shopper
- * reads, in the store's own language.
- */
-export function translatePromotionError(
-  err: unknown,
-  copy: PromotionErrorCopy,
-  opts?: { hasEmail?: boolean }
-): string {
-  return copy[promotionErrorKey(err, opts)]
-}
-
-function extractMessage(err: unknown): string {
-  if (!err) return ""
-  if (typeof err === "string") return err
-  if (err instanceof Error) return err.message
-  if (typeof err === "object" && err !== null) {
-    const e = err as { message?: string; code?: string; type?: string }
-    return [e.message, e.code, e.type].filter(Boolean).join(" ")
-  }
-  return String(err)
-}
+import { PROMOTION_CODE_KEYS } from "./error-copy-codes"
+import type { PromotionErrorCopy } from "./labels"
+
+/**
+ * Recognizes a discount-code failure and picks the copy key for it.
+ *
+ * THE COPY IS NOT HERE ANY MORE. Until 2026-09-13 this file held seven
+ * hardcoded BULGARIAN sentences that every merchant shipped and none could
+ * override; the words now live in the checkout label pack, English by
+ * default. The substring patterns stay in English because they match the
+ * API's own error text, which is wire format and never shown.
+ *
+ * Recognition is code-first (`StoreApiError.code`), then the substrings
+ * kept verbatim from the production port.
+ */
+
+/**
+ * Known promo error substrings. Case-insensitive, first match wins, most
+ * specific first.
+ */
+const PROMO_PATTERNS: Array<{ match: RegExp; key: keyof PromotionErrorCopy }> = [
+  // Campaign budget needs an email on the cart.
+  { match: /customer_email|campaign[\s_]?budget/i, key: "needsEmail" },
+  // Expired or no-longer-active promotion.
+  { match: /expired|no[\s_]?longer[\s_]?(?:active|valid)|inactive/i, key: "promotionInactive" },
+  // Budget or usage limit reached.
+  {
+    match: /reached[\s_]?its[\s_]?limit|usage[\s_]?limit|budget[\s_]?(?:exceeded|reached)/i,
+    key: "exhausted",
+  },
+  // Invalid or unknown code. Last of the specific set, because it is the
+  // broadest pattern and would otherwise swallow the ones above.
+  {
+    match: /is[\s_]?invalid|invalid[\s_]?data|not[\s_]?found|does(?:n'?t| not)[\s_]?exist/i,
+    key: "promotionNotFound",
+  },
+]
+
+/**
+ * Which promotion copy this failure asks for.
+ *
+ * @param err the error from a try/catch: a StoreApiError with a code, a
+ *            network error, or an opaque render error
+ * @param opts.hasEmail whether the cart currently has an email. When the
+ *            error is opaque and there is no email, the overwhelmingly
+ *            likely cause is a campaign-budget promotion, so the shopper
+ *            gets the actionable "enter your email" line rather than a
+ *            vague fallback.
+ */
+export function promotionErrorKey(
+  err: unknown,
+  opts?: { hasEmail?: boolean }
+): keyof PromotionErrorCopy {
+  if (err && typeof err === "object") {
+    const code = (err as { code?: unknown }).code
+    if (typeof code === "string" && PROMOTION_CODE_KEYS[code]) {
+      return PROMOTION_CODE_KEYS[code]
+    }
+  }
+
+  const raw = extractMessage(err)
+  for (const { match, key } of PROMO_PATTERNS) if (match.test(raw)) return key
+
+  // Unknown or opaque. With no email on the cart the campaign-budget case
+  // is by far the most common trigger, so point at the fix, not a dead end.
+  if (opts?.hasEmail === false) return "needsEmail"
+  return "generic"
+}
+
+/**
+ * Turn any thrown or returned promotion error into the sentence a shopper
+ * reads, in the store's own language.
+ */
+export function translatePromotionError(
+  err: unknown,
+  copy: PromotionErrorCopy,
+  opts?: { hasEmail?: boolean }
+): string {
+  return copy[promotionErrorKey(err, opts)]
+}
+
+function extractMessage(err: unknown): string {
+  if (!err) return ""
+  if (typeof err === "string") return err
+  if (err instanceof Error) return err.message
+  if (typeof err === "object" && err !== null) {
+    const e = err as { message?: string; code?: string; type?: string }
+    return [e.message, e.code, e.type].filter(Boolean).join(" ")
+  }
+  return String(err)
+}

package/src/common/country-flag.tsx

@@ -1,52 +1,52 @@
-import "flag-icons/css/flag-icons.min.css"
-
-import { cn } from "../lib/utils"
-
-/**
- * A country's flag, from its ISO-3166 alpha-2 code.
- *
- * WHY A SPRITE AND NOT AN EMOJI: the emoji flag (🇧🇬) costs nothing and is
- * the obvious choice, but Windows ships no flag glyphs in Segoe UI Emoji, so
- * a Windows shopper reads the two letters "BG" instead of a flag. `flag-icons`
- * is SVG under a CSS class, so it renders identically on every platform. It is
- * also the same sprite the Cartbase admin draws its flags with, so a merchant
- * sees one country treatment across the admin and their storefront.
- *
- * The aspect ratio is the sprite's own 4:3, sized in `em` so a flag matches
- * the text it sits beside at any font size.
- *
- * Decorative by default: a flag never carries meaning a shopper cannot get
- * from the name next to it, so it is `aria-hidden` and screen readers read
- * the name. Pass `title` for a tooltip when the flag stands alone.
- */
-export function CountryFlag({
-  code,
-  title,
-  className,
-}: {
-  /** ISO-3166 alpha-2, any case. Unknown or empty renders a neutral placeholder. */
-  code: string | null | undefined
-  title?: string
-  className?: string
-}) {
-  const iso2 = code?.trim().toLowerCase()
-
-  // A placeholder rather than nothing: the box holds its space, so a field
-  // does not jump when a shopper picks their country.
-  if (!iso2 || !/^[a-z]{2}$/.test(iso2)) {
-    return (
-      <span
-        className={cn("inline-block w-[1.33em] h-[1em] rounded-[2px] bg-muted", className)}
-        aria-hidden
-      />
-    )
-  }
-
-  return (
-    <span
-      className={cn(`fi fi-${iso2}`, "inline-block w-[1.33em] h-[1em] rounded-[2px] shrink-0", className)}
-      title={title}
-      aria-hidden
-    />
-  )
-}
+import "flag-icons/css/flag-icons.min.css"
+
+import { cn } from "../lib/utils"
+
+/**
+ * A country's flag, from its ISO-3166 alpha-2 code.
+ *
+ * WHY A SPRITE AND NOT AN EMOJI: the emoji flag (🇧🇬) costs nothing and is
+ * the obvious choice, but Windows ships no flag glyphs in Segoe UI Emoji, so
+ * a Windows shopper reads the two letters "BG" instead of a flag. `flag-icons`
+ * is SVG under a CSS class, so it renders identically on every platform. It is
+ * also the same sprite the Cartbase admin draws its flags with, so a merchant
+ * sees one country treatment across the admin and their storefront.
+ *
+ * The aspect ratio is the sprite's own 4:3, sized in `em` so a flag matches
+ * the text it sits beside at any font size.
+ *
+ * Decorative by default: a flag never carries meaning a shopper cannot get
+ * from the name next to it, so it is `aria-hidden` and screen readers read
+ * the name. Pass `title` for a tooltip when the flag stands alone.
+ */
+export function CountryFlag({
+  code,
+  title,
+  className,
+}: {
+  /** ISO-3166 alpha-2, any case. Unknown or empty renders a neutral placeholder. */
+  code: string | null | undefined
+  title?: string
+  className?: string
+}) {
+  const iso2 = code?.trim().toLowerCase()
+
+  // A placeholder rather than nothing: the box holds its space, so a field
+  // does not jump when a shopper picks their country.
+  if (!iso2 || !/^[a-z]{2}$/.test(iso2)) {
+    return (
+      <span
+        className={cn("inline-block w-[1.33em] h-[1em] rounded-[2px] bg-muted", className)}
+        aria-hidden
+      />
+    )
+  }
+
+  return (
+    <span
+      className={cn(`fi fi-${iso2}`, "inline-block w-[1.33em] h-[1em] rounded-[2px] shrink-0", className)}
+      title={title}
+      aria-hidden
+    />
+  )
+}

package/src/common/country-select.tsx

@@ -1,11 +1,11 @@
-/**
- * `CountrySelect` is now `MarketSelect` (`common/market-select`), renamed on
- * 2026-09-14: it lists the store's MARKETS, and a component is named for what
- * it does (store-package card, finding 6; doctrine 14b). This path and these
- * names are kept for ONE release so an existing import keeps compiling, and
- * go with the release after it.
- *
- * @deprecated import `MarketSelect` from `@cartbase/storefront/common/market-select`.
- */
-export { MarketSelect as CountrySelect } from "./market-select"
-export type { MarketSelectProps as CountrySelectProps } from "./market-select"
+/**
+ * `CountrySelect` is now `MarketSelect` (`common/market-select`), renamed on
+ * 2026-09-14: it lists the store's MARKETS, and a component is named for what
+ * it does (store-package card, finding 6; doctrine 14b). This path and these
+ * names are kept for ONE release so an existing import keeps compiling, and
+ * go with the release after it.
+ *
+ * @deprecated import `MarketSelect` from `@cartbase/storefront/common/market-select`.
+ */
+export { MarketSelect as CountrySelect } from "./market-select"
+export type { MarketSelectProps as CountrySelectProps } from "./market-select"

package/src/common/icons/cartbase-mark.ts

@@ -0,0 +1,9 @@
+/**
+ * GENERATED by scripts/build-icons.mjs from assets/icons/cartbase. Do not
+ * edit: change the SVG file and run the script. The Cartbase wordmark, Cartbase's own.
+ */
+
+export const CARTBASE_WORDMARK = {
+  viewBox: "0 0 378 98",
+  path: "M48.3649 79.4452C29.0672 79.4452 16.5705 66.8635 16.5705 48.5009C16.5705 29.6283 29.6623 17.0465 48.6199 17.0465C57.3762 17.0465 64.8572 20.362 70.638 25.2927L63.242 35.069C58.3113 31.0735 53.8057 29.2032 48.3649 29.2032C37.7384 29.2032 30.5974 36.7693 30.5974 47.9908C30.5974 59.5524 37.9085 67.2035 48.705 67.2035C54.2307 67.2035 58.6513 65.5033 63.667 61.4227L71.0631 71.2841C65.4523 76.2998 57.7162 79.4452 48.3649 79.4452ZM87.1349 79.4452C78.5488 79.4452 72.2579 74.8546 72.2579 65.5033C72.2579 56.577 79.5689 51.3913 89.1752 51.3913C93.1708 51.3913 97.1663 52.1564 100.142 53.6016V51.8164C100.142 46.3756 96.5713 44.3353 90.4504 44.3353C86.3698 44.3353 82.0342 45.2705 77.6986 46.7157L75.2333 37.4494C81.0141 35.2391 86.0298 34.2189 92.4907 34.2189C105.753 34.2189 113.489 38.8946 113.489 50.7962V78H101.332C101.332 75.9597 101.417 73.8344 101.757 70.4339H101.502C99.2066 75.4496 93.8509 79.4452 87.1349 79.4452ZM85.5197 64.3131C85.5197 67.7986 88.1551 69.2438 91.4705 69.2438C96.0612 69.2438 99.7167 66.4384 100.397 61.5927C98.1015 60.4026 94.701 59.4674 91.9806 59.4674C88.1551 59.4674 85.5197 61.2527 85.5197 64.3131ZM120.395 78V35.6641H132.382C132.382 37.6194 132.297 39.4046 131.957 42.7201H132.212C133.827 38.1295 138.163 34.2189 144.283 34.2189C146.664 34.2189 149.044 34.814 150.319 35.3241L147.004 46.6306C145.474 46.1206 144.028 45.8655 142.668 45.8655C137.398 45.8655 133.742 49.266 133.742 55.9819V78H120.395ZM172.797 79.4452C163.106 79.4452 157.92 73.9194 157.92 63.2079V46.2056H150.779V35.6641H157.92V25.5477L171.182 24.1025V35.6641H181.638V46.2056H171.182V62.7829C171.182 66.4384 172.712 68.3087 176.027 68.3087C177.473 68.3087 179.343 67.8836 180.873 67.2035L184.019 76.9799C180.533 78.6801 177.048 79.4452 172.797 79.4452ZM213.752 79.4452C207.121 79.4452 201.935 76.2998 199.47 71.7091H199.215C199.385 74.3445 199.385 76.1297 199.385 78H187.398V18.4917H200.83V27.928C200.83 33.1138 200.575 37.7044 199.385 42.8051H199.555C202.275 37.9594 207.631 34.2189 214.517 34.2189C225.314 34.2189 233.645 42.3801 233.645 56.747C233.645 70.519 225.059 79.4452 213.752 79.4452ZM210.352 68.3937C216.387 68.3937 220.383 63.803 220.383 56.9171C220.383 49.7761 216.387 45.2705 210.267 45.2705C204.401 45.2705 200.49 49.9461 200.49 56.9171C200.49 63.888 204.486 68.3937 210.352 68.3937ZM250.364 79.4452C241.778 79.4452 235.487 74.8546 235.487 65.5033C235.487 56.577 242.798 51.3913 252.405 51.3913C256.4 51.3913 260.396 52.1564 263.371 53.6016V51.8164C263.371 46.3756 259.801 44.3353 253.68 44.3353C249.599 44.3353 245.264 45.2705 240.928 46.7157L238.463 37.4494C244.243 35.2391 249.259 34.2189 255.72 34.2189C268.982 34.2189 276.718 38.8946 276.718 50.7962V78H264.561C264.561 75.9597 264.646 73.8344 264.986 70.4339H264.731C262.436 75.4496 257.08 79.4452 250.364 79.4452ZM248.749 64.3131C248.749 67.7986 251.384 69.2438 254.7 69.2438C259.29 69.2438 262.946 66.4384 263.626 61.5927C261.331 60.4026 257.93 59.4674 255.21 59.4674C251.384 59.4674 248.749 61.2527 248.749 64.3131ZM298.842 79.4452C292.381 79.4452 286.175 78.085 280.479 75.1096L284.475 65.1632C289.745 67.5435 294.251 68.7337 299.182 68.7337C302.752 68.7337 304.707 67.3735 304.707 65.1632C304.707 62.7829 302.837 61.6777 297.481 60.9976C287.365 59.7225 281.924 54.9618 281.924 47.8208C281.924 39.5747 288.98 34.2189 299.692 34.2189C304.707 34.2189 311.168 35.6641 315.419 37.7894L311.848 47.6508C308.193 45.6955 303.092 44.5053 299.522 44.5053C296.291 44.5053 294.421 45.6955 294.421 47.9908C294.421 50.1161 296.206 51.2213 300.372 51.7314C312.188 53.1766 317.289 57.3421 317.289 65.3332C317.289 73.9194 310.148 79.4452 298.842 79.4452ZM342.222 79.4452C329.3 79.4452 318.928 71.4541 318.928 56.407C318.928 41.7 329.98 34.2189 341.711 34.2189C353.528 34.2189 362.369 41.4449 362.369 54.7068C362.369 56.407 362.199 58.2773 361.859 60.0625H332.275C332.615 66.2684 337.631 69.1588 342.902 69.1588C347.067 69.1588 351.063 67.8836 354.293 65.2482L359.904 73.1543C355.568 77.3199 349.022 79.4452 342.222 79.4452ZM332.36 52.4114H349.703C349.788 46.9707 345.962 44.2503 341.371 44.2503C336.781 44.2503 332.955 46.8857 332.36 52.4114Z",
+} as const