create-brainerce-store 1.84.0 → 1.86.0

package/templates/nextjs/designs/atelier/ui/product/frequently-bought-together.tsx

@@ -1,227 +1,232 @@
-'use client';
-
-import { useState } from 'react';
-import { CdnImage as Image } from '@/ui/shared/cdn-image';
-import type { Product, ProductRecommendation } from 'brainerce';
-import { formatPrice } from 'brainerce';
-import { useCart, useStoreInfo } from '@/core/providers/store-provider';
-import { useCurrency } from '@/core/lib/use-currency';
-import { useTranslations } from '@/core/lib/translations';
-import { toAddToCartError, type AddToCartError } from '@/core/lib/add-to-cart-error';
-import { cn } from '@/core/lib/utils';
-import { IconPlus, IconBag } from '@/ui/shared/icons';
-
-interface FrequentlyBoughtTogetherProps {
-  items: ProductRecommendation[];
-  currentProduct: Product;
-  className?: string;
-}
-
-// ⛔ STORE CURRENCY THROUGHOUT, deliberately. The cross-sells are
-// `ProductRecommendation`, a trimmed shape with no displayPrice/displayCurrency,
-// so there is nothing to convert them to. Converting only `currentProduct`
-// (which is a full Product and does carry FX fields) would add a euro amount to
-// two dollar amounts and print the result as one total. One currency wins, and
-// it has to be the one the cart actually charges.
-function getEffectivePrice(item: { basePrice: string; salePrice?: string | null }): number {
-  const sale = item.salePrice ? parseFloat(item.salePrice) : null;
-  const base = parseFloat(item.basePrice);
-  return sale != null && sale < base ? sale : base;
-}
-
-function ProductThumb({
-  name,
-  imageUrl,
-  price,
-  currency,
-  checked,
-  onToggle,
-  disabled,
-}: {
-  name: string;
-  imageUrl: string | null;
-  price: number;
-  currency: string;
-  checked: boolean;
-  onToggle?: () => void;
-  disabled?: boolean;
-}) {
-  return (
-    <label
-      className={cn(
-        'flex w-40 cursor-pointer flex-col gap-2 rounded-xl border bg-background p-3 transition-colors',
-        checked ? 'border-primary' : 'border-border',
-        disabled && 'cursor-default'
-      )}
-    >
-      {/* `relative` + fixed box are layout-critical for next/image fill */}
-      <span className="relative block aspect-square overflow-hidden rounded-lg bg-secondary">
-        {imageUrl ? <Image src={imageUrl} alt={name} fill sizes="160px" className="object-cover" /> : null}
-        {onToggle && (
-          <input
-            type="checkbox"
-            checked={checked}
-            onChange={onToggle}
-            disabled={disabled}
-            className="absolute end-2 top-2 h-[18px] w-[18px] accent-primary"
-            aria-label={name}
-          />
-        )}
-      </span>
-      <span className="line-clamp-2 text-xs font-semibold leading-snug text-foreground">
-        {name}
-      </span>
-      <span className="text-sm font-semibold text-foreground">
-        {formatPrice(price, { currency }) as string}
-      </span>
-    </label>
-  );
-}
-
-/**
- * "Frequently bought together" bundle on the product page: current product +
- * selectable cross-sells + combined total + add-all button; items come from
- * useProductPage().recommendations.crossSells, the feature gate from
- * useStoreInfo().upsell.
- */
-export function FrequentlyBoughtTogether({
-  items,
-  currentProduct,
-  className,
-}: FrequentlyBoughtTogetherProps) {
-  // Hooks must be called unconditionally and in the same order on every
-  // render — keep all of them above any early `return null` branch.
-  const { storeInfo } = useStoreInfo();
-  const { refreshCart } = useCart();
-  const t = useTranslations('productDetail');
-  const currency = useCurrency();
-
-  // ⛔ KITs are dropped, not priced. A recommendation is a `ProductRecommendation`
-  // — an UNRESOLVED list shape, and the recommendations endpoint does not resolve
-  // kits, so `item.basePrice` on a kit is the stored PLACEHOLDER, wrong for every
-  // kit priced SUM / SUM_MINUS_PERCENT. This block sums those numbers into one
-  // "Total" beside a button that adds them all, so a wrong figure here is a
-  // number the shopper commits to. Adding a kit by its own `productId` would in
-  // fact be correct — it is the displayed price that cannot be trusted — so a
-  // kit still sells fine from its own product page, where the API resolves it.
-  // Only show up to 3 cross-sells.
-  const crossSells = items.filter((item) => item.type !== 'KIT').slice(0, 3);
-
-  const [selected, setSelected] = useState<Set<string>>(() => new Set(crossSells.map((i) => i.id)));
-  const [adding, setAdding] = useState(false);
-  const [addError, setAddError] = useState<AddToCartError | null>(null);
-
-  if (!storeInfo?.upsell?.frequentlyBoughtTogetherEnabled) return null;
-  if (crossSells.length === 0) return null;
-
-  const currentPrice = getEffectivePrice(currentProduct);
-  const currentImage = currentProduct.images?.[0];
-  const currentImageUrl = currentImage
-    ? typeof currentImage === 'string'
-      ? currentImage
-      : currentImage.url
-    : null;
-
-  const totalPrice = crossSells
-    .filter((item) => selected.has(item.id))
-    .reduce((sum, item) => sum + getEffectivePrice(item), currentPrice);
-
-  const toggleItem = (id: string) => {
-    setSelected((prev) => {
-      const next = new Set(prev);
-      if (next.has(id)) {
-        next.delete(id);
-      } else {
-        next.add(id);
-      }
-      return next;
-    });
-  };
-
-  async function handleAddAll() {
-    if (adding || selected.size === 0) return;
-    setAddError(null);
-    try {
-      setAdding(true);
-      const { getClient } = await import('@/core/lib/brainerce');
-      const client = getClient();
-      const selectedItems = crossSells.filter((item) => selected.has(item.id));
-      for (const item of selectedItems) {
-        await client.smartAddToCart({ productId: item.id, quantity: 1 });
-      }
-      await refreshCart();
-    } catch (err) {
-      // The loop is not transactional: if the cart hits its 50-line cap
-      // part-way through, the earlier items ARE in the cart and the rest are
-      // not. Saying so beats a silent stop the shopper reads as a dead button.
-      setAddError(toAddToCartError(err));
-      console.error('Failed to add items to cart:', err);
-    } finally {
-      setAdding(false);
-    }
-  }
-
-  return (
-    <section className={cn('rounded-2xl border bg-secondary/50 p-6 sm:p-8', className)}>
-      <h2 className="mb-6 text-2xl">{t('frequentlyBoughtTogether')}</h2>
-
-      <div className="flex flex-wrap items-center gap-3">
-        {/* Current product (always included, no checkbox) */}
-        <ProductThumb
-          name={currentProduct.name}
-          imageUrl={currentImageUrl}
-          price={currentPrice}
-          currency={currency}
-          checked={true}
-          disabled
-        />
-
-        {crossSells.map((item) => {
-          const img = item.images?.[0];
-          const imgUrl = img ? (typeof img === 'string' ? img : img.url) : null;
-          return (
-            <div key={item.id} className="flex items-center gap-3">
-              <span aria-hidden="true" className="text-muted-foreground">
-                <IconPlus size={20} />
-              </span>
-              <ProductThumb
-                name={item.name}
-                imageUrl={imgUrl}
-                price={getEffectivePrice(item)}
-                currency={currency}
-                checked={selected.has(item.id)}
-                onToggle={() => toggleItem(item.id)}
-              />
-            </div>
-          );
-        })}
-      </div>
-
-      {/* Total + Add button */}
-      <div className="mt-6 flex flex-wrap items-center gap-4 border-t pt-5">
-        <span className="text-lg font-semibold text-foreground">
-          {t('totalPrice').replace('{price}', formatPrice(totalPrice, { currency }) as string)}
-        </span>
-        <button
-          type="button"
-          onClick={handleAddAll}
-          disabled={adding || selected.size === 0}
-          className="btn-primary btn-md"
-        >
-          <IconBag size={18} />
-          {adding ? t('addingAll') : t('addSelectedToCart')}
-        </button>
-      </div>
-
-      {/*
-        Why the add was refused. Some items may already be in the cart:
-        the loop above adds one at a time and stops at the first refusal.
-      */}
-      {addError && (
-        <p role="alert" className="text-destructive mt-3 text-sm font-medium">
-          {addError === 'CART_FULL' ? t('cartFull') : t('addToCartFailed')}
-        </p>
-      )}
-    </section>
-  );
-}
+'use client';
+
+import { useState } from 'react';
+import { CdnImage as Image } from '@/ui/shared/cdn-image';
+import { NoPhotoTile } from '@/ui/shared/no-photo-tile';
+import type { Product, ProductRecommendation } from 'brainerce';
+import { formatPrice } from 'brainerce';
+import { useCart, useStoreInfo } from '@/core/providers/store-provider';
+import { useCurrency } from '@/core/lib/use-currency';
+import { useTranslations } from '@/core/lib/translations';
+import { toAddToCartError, type AddToCartError } from '@/core/lib/add-to-cart-error';
+import { cn } from '@/core/lib/utils';
+import { IconPlus, IconBag } from '@/ui/shared/icons';
+
+interface FrequentlyBoughtTogetherProps {
+  items: ProductRecommendation[];
+  currentProduct: Product;
+  className?: string;
+}
+
+// ⛔ STORE CURRENCY THROUGHOUT, deliberately. The cross-sells are
+// `ProductRecommendation`, a trimmed shape with no displayPrice/displayCurrency,
+// so there is nothing to convert them to. Converting only `currentProduct`
+// (which is a full Product and does carry FX fields) would add a euro amount to
+// two dollar amounts and print the result as one total. One currency wins, and
+// it has to be the one the cart actually charges.
+function getEffectivePrice(item: { basePrice: string; salePrice?: string | null }): number {
+  const sale = item.salePrice ? parseFloat(item.salePrice) : null;
+  const base = parseFloat(item.basePrice);
+  return sale != null && sale < base ? sale : base;
+}
+
+function ProductThumb({
+  name,
+  imageUrl,
+  price,
+  currency,
+  checked,
+  onToggle,
+  disabled,
+}: {
+  name: string;
+  imageUrl: string | null;
+  price: number;
+  currency: string;
+  checked: boolean;
+  onToggle?: () => void;
+  disabled?: boolean;
+}) {
+  return (
+    <label
+      className={cn(
+        'flex w-40 cursor-pointer flex-col gap-2 rounded-xl border bg-background p-3 transition-colors',
+        checked ? 'border-primary' : 'border-border',
+        disabled && 'cursor-default'
+      )}
+    >
+      {/* `relative` + fixed box are layout-critical for next/image fill */}
+      <span className="relative block aspect-square overflow-hidden rounded-lg bg-secondary">
+        {imageUrl ? (
+          <Image src={imageUrl} alt={name} fill sizes="160px" className="object-cover" />
+        ) : (
+          <NoPhotoTile name={name} />
+        )}
+        {onToggle && (
+          <input
+            type="checkbox"
+            checked={checked}
+            onChange={onToggle}
+            disabled={disabled}
+            className="absolute end-2 top-2 h-[18px] w-[18px] accent-primary"
+            aria-label={name}
+          />
+        )}
+      </span>
+      <span className="line-clamp-2 text-xs font-semibold leading-snug text-foreground">
+        {name}
+      </span>
+      <span className="text-sm font-semibold text-foreground">
+        {formatPrice(price, { currency }) as string}
+      </span>
+    </label>
+  );
+}
+
+/**
+ * "Frequently bought together" bundle on the product page: current product +
+ * selectable cross-sells + combined total + add-all button; items come from
+ * useProductPage().recommendations.crossSells, the feature gate from
+ * useStoreInfo().upsell.
+ */
+export function FrequentlyBoughtTogether({
+  items,
+  currentProduct,
+  className,
+}: FrequentlyBoughtTogetherProps) {
+  // Hooks must be called unconditionally and in the same order on every
+  // render — keep all of them above any early `return null` branch.
+  const { storeInfo } = useStoreInfo();
+  const { refreshCart } = useCart();
+  const t = useTranslations('productDetail');
+  const currency = useCurrency();
+
+  // ⛔ KITs are dropped, not priced. A recommendation is a `ProductRecommendation`
+  // — an UNRESOLVED list shape, and the recommendations endpoint does not resolve
+  // kits, so `item.basePrice` on a kit is the stored PLACEHOLDER, wrong for every
+  // kit priced SUM / SUM_MINUS_PERCENT. This block sums those numbers into one
+  // "Total" beside a button that adds them all, so a wrong figure here is a
+  // number the shopper commits to. Adding a kit by its own `productId` would in
+  // fact be correct — it is the displayed price that cannot be trusted — so a
+  // kit still sells fine from its own product page, where the API resolves it.
+  // Only show up to 3 cross-sells.
+  const crossSells = items.filter((item) => item.type !== 'KIT').slice(0, 3);
+
+  const [selected, setSelected] = useState<Set<string>>(() => new Set(crossSells.map((i) => i.id)));
+  const [adding, setAdding] = useState(false);
+  const [addError, setAddError] = useState<AddToCartError | null>(null);
+
+  if (!storeInfo?.upsell?.frequentlyBoughtTogetherEnabled) return null;
+  if (crossSells.length === 0) return null;
+
+  const currentPrice = getEffectivePrice(currentProduct);
+  const currentImage = currentProduct.images?.[0];
+  const currentImageUrl = currentImage
+    ? typeof currentImage === 'string'
+      ? currentImage
+      : currentImage.url
+    : null;
+
+  const totalPrice = crossSells
+    .filter((item) => selected.has(item.id))
+    .reduce((sum, item) => sum + getEffectivePrice(item), currentPrice);
+
+  const toggleItem = (id: string) => {
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) {
+        next.delete(id);
+      } else {
+        next.add(id);
+      }
+      return next;
+    });
+  };
+
+  async function handleAddAll() {
+    if (adding || selected.size === 0) return;
+    setAddError(null);
+    try {
+      setAdding(true);
+      const { getClient } = await import('@/core/lib/brainerce');
+      const client = getClient();
+      const selectedItems = crossSells.filter((item) => selected.has(item.id));
+      for (const item of selectedItems) {
+        await client.smartAddToCart({ productId: item.id, quantity: 1 });
+      }
+      await refreshCart();
+    } catch (err) {
+      // The loop is not transactional: if the cart hits its 50-line cap
+      // part-way through, the earlier items ARE in the cart and the rest are
+      // not. Saying so beats a silent stop the shopper reads as a dead button.
+      setAddError(toAddToCartError(err));
+      console.error('Failed to add items to cart:', err);
+    } finally {
+      setAdding(false);
+    }
+  }
+
+  return (
+    <section className={cn('rounded-2xl border bg-secondary/50 p-6 sm:p-8', className)}>
+      <h2 className="mb-6 text-2xl">{t('frequentlyBoughtTogether')}</h2>
+
+      <div className="flex flex-wrap items-center gap-3">
+        {/* Current product (always included, no checkbox) */}
+        <ProductThumb
+          name={currentProduct.name}
+          imageUrl={currentImageUrl}
+          price={currentPrice}
+          currency={currency}
+          checked={true}
+          disabled
+        />
+
+        {crossSells.map((item) => {
+          const img = item.images?.[0];
+          const imgUrl = img ? (typeof img === 'string' ? img : img.url) : null;
+          return (
+            <div key={item.id} className="flex items-center gap-3">
+              <span aria-hidden="true" className="text-muted-foreground">
+                <IconPlus size={20} />
+              </span>
+              <ProductThumb
+                name={item.name}
+                imageUrl={imgUrl}
+                price={getEffectivePrice(item)}
+                currency={currency}
+                checked={selected.has(item.id)}
+                onToggle={() => toggleItem(item.id)}
+              />
+            </div>
+          );
+        })}
+      </div>
+
+      {/* Total + Add button */}
+      <div className="mt-6 flex flex-wrap items-center gap-4 border-t pt-5">
+        <span className="text-lg font-semibold text-foreground">
+          {t('totalPrice').replace('{price}', formatPrice(totalPrice, { currency }) as string)}
+        </span>
+        <button
+          type="button"
+          onClick={handleAddAll}
+          disabled={adding || selected.size === 0}
+          className="btn-primary btn-md"
+        >
+          <IconBag size={18} />
+          {adding ? t('addingAll') : t('addSelectedToCart')}
+        </button>
+      </div>
+
+      {/*
+        Why the add was refused. Some items may already be in the cart:
+        the loop above adds one at a time and stops at the first refusal.
+      */}
+      {addError && (
+        <p role="alert" className="text-destructive mt-3 text-sm font-medium">
+          {addError === 'CART_FULL' ? t('cartFull') : t('addToCartFailed')}
+        </p>
+      )}
+    </section>
+  );
+}

package/templates/nextjs/designs/atelier/ui/product/price-display.tsx

@@ -1,69 +1,90 @@
-'use client';
-
-import { formatPrice } from 'brainerce';
-import { useCurrency } from '@/core/lib/use-currency';
-import { cn } from '@/core/lib/utils';
-
-interface PriceDisplayProps {
-  price: string | number;
-  salePrice?: string | number | null;
-  currency?: string;
-  className?: string;
-  size?: 'sm' | 'md' | 'lg';
-}
-
-const CURRENT: Record<NonNullable<PriceDisplayProps['size']>, string> = {
-  sm: 'text-sm font-semibold',
-  md: 'text-base font-semibold',
-  lg: 'text-2xl font-semibold',
-};
-const STRUCK: Record<NonNullable<PriceDisplayProps['size']>, string> = {
-  sm: 'text-xs',
-  md: 'text-sm',
-  lg: 'text-base',
-};
-
-/**
- * Price renderer used by cards, product page and recommendations; computes
- * sale state + discount % from props (currency via useCurrency()).
- * Never hardcode currency symbols — formatPrice handles them.
- */
-export function PriceDisplay({
-  price,
-  salePrice,
-  currency,
-  className,
-  size = 'md',
-}: PriceDisplayProps) {
-  const currencyCode = useCurrency(currency);
-
-  const basePrice = typeof price === 'string' ? parseFloat(price) : price;
-  const sale =
-    salePrice != null ? (typeof salePrice === 'string' ? parseFloat(salePrice) : salePrice) : null;
-  const isOnSale = sale !== null && sale < basePrice;
-
-  const discountPercent =
-    isOnSale && basePrice > 0 ? Math.round(((basePrice - sale!) / basePrice) * 100) : 0;
-
-  return (
-    <span data-size={size} className={cn('inline-flex flex-wrap items-baseline gap-2', className)}>
-      {isOnSale ? (
-        <>
-          <span className={cn(CURRENT[size], 'text-foreground')}>
-            {formatPrice(sale!, { currency: currencyCode }) as string}
-          </span>
-          <s className={cn(STRUCK[size], 'text-muted-foreground')}>
-            {formatPrice(basePrice, { currency: currencyCode }) as string}
-          </s>
-          {discountPercent > 0 && (
-            <span className="badge-destructive self-center">-{discountPercent}%</span>
-          )}
-        </>
-      ) : (
-        <span className={cn(CURRENT[size], 'text-foreground')}>
-          {formatPrice(basePrice, { currency: currencyCode }) as string}
-        </span>
-      )}
-    </span>
-  );
-}
+'use client';
+
+import { formatPrice } from 'brainerce';
+import { useCurrency } from '@/core/lib/use-currency';
+import { useTranslations } from '@/core/lib/translations';
+import { useStoreInfo } from '@/core/providers/store-provider';
+import { cn } from '@/core/lib/utils';
+
+interface PriceDisplayProps {
+  price: string | number;
+  salePrice?: string | number | null;
+  currency?: string;
+  className?: string;
+  size?: 'sm' | 'md' | 'lg';
+}
+
+const CURRENT: Record<NonNullable<PriceDisplayProps['size']>, string> = {
+  sm: 'text-sm font-semibold',
+  md: 'text-base font-semibold',
+  lg: 'text-2xl font-semibold',
+};
+const STRUCK: Record<NonNullable<PriceDisplayProps['size']>, string> = {
+  sm: 'text-xs',
+  md: 'text-sm',
+  lg: 'text-base',
+};
+
+/**
+ * Price renderer used by cards, product page and recommendations; computes
+ * sale state + discount % from props (currency via useCurrency()).
+ * Never hardcode currency symbols — formatPrice handles them.
+ */
+export function PriceDisplay({
+  price,
+  salePrice,
+  currency,
+  className,
+  size = 'md',
+}: PriceDisplayProps) {
+  const currencyCode = useCurrency(currency);
+  const { storeInfo } = useStoreInfo();
+  const t = useTranslations('common');
+
+  const basePrice = typeof price === 'string' ? parseFloat(price) : price;
+  const sale =
+    salePrice != null ? (typeof salePrice === 'string' ? parseFloat(salePrice) : salePrice) : null;
+  const isOnSale = sale !== null && sale < basePrice;
+
+  const discountPercent =
+    isOnSale && basePrice > 0 ? Math.round(((basePrice - sale!) / basePrice) * 100) : 0;
+
+  // FX overlay disclosure (see core/lib/display-price.ts): `currency` is the
+  // region-converted DISPLAY currency when it differs from the store's own
+  // base currency. The shopper is still charged in the base currency at
+  // checkout, so every converted price needs a visible "estimated" cue.
+  const isConverted = !!currency && !!storeInfo?.currency && currency !== storeInfo.currency;
+
+  return (
+    <span data-size={size} className={cn('inline-flex flex-wrap items-baseline gap-2', className)}>
+      {isOnSale ? (
+        <>
+          <span className={cn(CURRENT[size], 'text-foreground')}>
+            {formatPrice(sale!, { currency: currencyCode }) as string}
+          </span>
+          <s className={cn(STRUCK[size], 'text-muted-foreground')}>
+            {formatPrice(basePrice, { currency: currencyCode }) as string}
+          </s>
+          {discountPercent > 0 && (
+            <span className="badge-destructive self-center">-{discountPercent}%</span>
+          )}
+        </>
+      ) : (
+        <span className={cn(CURRENT[size], 'text-foreground')}>
+          {formatPrice(basePrice, { currency: currencyCode }) as string}
+        </span>
+      )}
+      {isConverted && (
+        <span
+          className="text-muted-foreground cursor-help self-center text-xs font-normal underline decoration-dotted"
+          title={t('estimatedPriceTooltip', {
+            currency: currencyCode,
+            baseCurrency: storeInfo!.currency,
+          })}
+        >
+          {t('estimatedPrice')}
+        </span>
+      )}
+    </span>
+  );
+}