create-brainerce-store 1.71.0 → 1.73.0

package/templates/nextjs/designs/atelier/ui/cart/cart-item.tsx

@@ -1,140 +1,158 @@
-'use client';
-
-import { useState } from 'react';
-import { CdnImage as Image } from '@/ui/shared/cdn-image';
-import type { CartItem as CartItemType } from 'brainerce';
-import { getCartItemImage, formatPrice } from 'brainerce';
-import { getClient } from '@/core/lib/brainerce';
-import { useTranslations } from '@/core/lib/translations';
-import { useCurrency } from '@/core/lib/use-currency';
-import { LoadingSpinner } from '@/ui/shared/loading-spinner';
-import { cn } from '@/core/lib/utils';
-import { IconMinus, IconPlus, IconTrash } from '@/ui/shared/icons';
-
-interface CartItemProps {
-  item: CartItemType;
-  onUpdate: () => void;
-  className?: string;
-}
-
-/**
- * Single cart line: image, name, variant, unit price, quantity controls,
- * remove, line total; the `item` prop comes from useCartPage().cart.
- */
-export function CartItem({ item, onUpdate, className }: CartItemProps) {
-  const t = useTranslations('common');
-  const td = useTranslations('productDetail');
-  const currency = useCurrency();
-  const [updating, setUpdating] = useState(false);
-  const [removing, setRemoving] = useState(false);
-
-  const productName = item.product.name;
-  const imageUrl = getCartItemImage(item);
-  const variantName = item.variant?.name;
-  const unitPrice = parseFloat(item.unitPrice);
-  const lineTotal = unitPrice * item.quantity;
-
-  async function handleQuantityChange(newQuantity: number) {
-    if (newQuantity < 1 || updating) return;
-
-    try {
-      setUpdating(true);
-      const client = getClient();
-      await client.smartUpdateCartItem(item.productId, newQuantity, item.variantId || undefined);
-      onUpdate();
-    } catch (err) {
-      console.error('Failed to update quantity:', err);
-    } finally {
-      setUpdating(false);
-    }
-  }
-
-  async function handleRemove() {
-    if (removing) return;
-
-    try {
-      setRemoving(true);
-      const client = getClient();
-      await client.smartRemoveFromCart(item.productId, item.variantId || undefined);
-      onUpdate();
-    } catch (err) {
-      console.error('Failed to remove item:', err);
-    } finally {
-      setRemoving(false);
-    }
-  }
-
-  return (
-    <div className={cn('flex items-start gap-4', className)}>
-      {/* Image — `relative` + fixed box are layout-critical for next/image fill */}
-      <div className="relative h-20 w-20 shrink-0 overflow-hidden rounded-lg border bg-secondary sm:h-24 sm:w-24">
-        {imageUrl ? (
-          <Image src={imageUrl} alt={productName} fill sizes="96px" className="object-cover" />
-        ) : (
-          <span className="sr-only">{productName}</span>
-        )}
-      </div>
-
-      {/* Details */}
-      <div className="min-w-0 flex-1">
-        <h3 className="font-sans text-[15px] font-semibold leading-snug text-foreground">
-          {productName}
-        </h3>
-
-        {/* Variant name */}
-        {variantName && <p className="mt-0.5 text-xs text-muted-foreground">{variantName}</p>}
-
-        {/* Unit price */}
-        <p className="mt-1 text-sm text-muted-foreground">
-          {formatPrice(unitPrice, { currency }) as string}
-        </p>
-
-        {/* Quantity controls + remove */}
-        <div className="mt-3 flex flex-wrap items-center gap-3">
-          <div
-            className="flex h-9 items-center rounded-full border"
-            role="group"
-            aria-label={td('quantityLabel')}
-          >
-            <button
-              type="button"
-              onClick={() => handleQuantityChange(item.quantity - 1)}
-              disabled={updating || item.quantity <= 1}
-              aria-label={td('decreaseQuantity')}
-              className="flex h-full w-9 items-center justify-center rounded-s-full transition-colors hover:bg-secondary disabled:opacity-40"
-            >
-              <IconMinus size={16} />
-            </button>
-            <span aria-live="polite" className="min-w-7 text-center text-sm font-semibold">
-              {updating ? <LoadingSpinner size="sm" /> : item.quantity}
-            </span>
-            <button
-              type="button"
-              onClick={() => handleQuantityChange(item.quantity + 1)}
-              disabled={updating}
-              aria-label={td('increaseQuantity')}
-              className="flex h-full w-9 items-center justify-center rounded-e-full transition-colors hover:bg-secondary disabled:opacity-40"
-            >
-              <IconPlus size={16} />
-            </button>
-          </div>
-
-          <button
-            type="button"
-            onClick={handleRemove}
-            disabled={removing}
-            className="inline-flex items-center gap-1.5 text-xs font-medium text-muted-foreground transition-colors hover:text-destructive disabled:opacity-50"
-          >
-            <IconTrash size={16} />
-            {removing ? t('removing') : t('remove')}
-          </button>
-        </div>
-      </div>
-
-      {/* Line total */}
-      <span className="text-base font-semibold text-foreground">
-        {formatPrice(lineTotal, { currency }) as string}
-      </span>
-    </div>
-  );
-}
+'use client';
+
+import { useState } from 'react';
+import { CdnImage as Image } from '@/ui/shared/cdn-image';
+import type { CartItem as CartItemType } from 'brainerce';
+import { getCartItemImage, formatPrice } from 'brainerce';
+import { getClient } from '@/core/lib/brainerce';
+import { useTranslations } from '@/core/lib/translations';
+import { useCurrency } from '@/core/lib/use-currency';
+import { LoadingSpinner } from '@/ui/shared/loading-spinner';
+import { cn } from '@/core/lib/utils';
+import { IconMinus, IconPlus, IconTrash } from '@/ui/shared/icons';
+
+interface CartItemProps {
+  item: CartItemType;
+  onUpdate: () => void;
+  className?: string;
+}
+
+/**
+ * Single cart line: image, name, variant, unit price, quantity controls,
+ * remove, line total; the `item` prop comes from useCartPage().cart.
+ */
+export function CartItem({ item, onUpdate, className }: CartItemProps) {
+  const t = useTranslations('common');
+  const td = useTranslations('productDetail');
+  const currency = useCurrency();
+  const [updating, setUpdating] = useState(false);
+  const [removing, setRemoving] = useState(false);
+
+  const productName = item.product.name;
+  const imageUrl = getCartItemImage(item);
+  const variantName = item.variant?.name;
+  const unitPrice = parseFloat(item.unitPrice);
+  const lineTotal = unitPrice * item.quantity;
+
+  // The server decides purchasability, per line. `isAvailable === false` means
+  // this line blocks checkout until it is removed, whether the stock ran out
+  // (a released reservation is the common cause) or the product/variant was
+  // withdrawn from sale. `unavailableReason` separates the two for the label.
+  const isUnavailable = item.isAvailable === false;
+  const unavailableLabel = isUnavailable
+    ? item.unavailableReason === 'OUT_OF_STOCK'
+      ? td('outOfStock')
+      : td('unavailable')
+    : null;
+
+  async function handleQuantityChange(newQuantity: number) {
+    if (newQuantity < 1 || updating) return;
+
+    try {
+      setUpdating(true);
+      const client = getClient();
+      await client.smartUpdateCartItem(item.productId, newQuantity, item.variantId || undefined);
+      onUpdate();
+    } catch (err) {
+      console.error('Failed to update quantity:', err);
+    } finally {
+      setUpdating(false);
+    }
+  }
+
+  async function handleRemove() {
+    if (removing) return;
+
+    try {
+      setRemoving(true);
+      const client = getClient();
+      await client.smartRemoveFromCart(item.productId, item.variantId || undefined);
+      onUpdate();
+    } catch (err) {
+      console.error('Failed to remove item:', err);
+    } finally {
+      setRemoving(false);
+    }
+  }
+
+  return (
+    <div className={cn('flex items-start gap-4', className)}>
+      {/* Image — `relative` + fixed box are layout-critical for next/image fill */}
+      <div className="bg-secondary relative h-20 w-20 shrink-0 overflow-hidden rounded-lg border sm:h-24 sm:w-24">
+        {imageUrl ? (
+          <Image src={imageUrl} alt={productName} fill sizes="96px" className="object-cover" />
+        ) : (
+          <span className="sr-only">{productName}</span>
+        )}
+      </div>
+
+      {/* Details */}
+      <div className="min-w-0 flex-1">
+        <h3 className="text-foreground font-sans text-[15px] font-semibold leading-snug">
+          {productName}
+        </h3>
+
+        {/* Availability badge. This line blocks checkout while it shows. */}
+        {unavailableLabel && (
+          <span className="bg-destructive/10 text-destructive mt-1 inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium">
+            {unavailableLabel}
+          </span>
+        )}
+
+        {/* Variant name */}
+        {variantName && <p className="text-muted-foreground mt-0.5 text-xs">{variantName}</p>}
+
+        {/* Unit price */}
+        <p className="text-muted-foreground mt-1 text-sm">
+          {formatPrice(unitPrice, { currency }) as string}
+        </p>
+
+        {/* Quantity controls + remove */}
+        <div className="mt-3 flex flex-wrap items-center gap-3">
+          <div
+            className="flex h-9 items-center rounded-full border"
+            role="group"
+            aria-label={td('quantityLabel')}
+          >
+            <button
+              type="button"
+              onClick={() => handleQuantityChange(item.quantity - 1)}
+              disabled={updating || item.quantity <= 1}
+              aria-label={td('decreaseQuantity')}
+              className="hover:bg-secondary flex h-full w-9 items-center justify-center rounded-s-full transition-colors disabled:opacity-40"
+            >
+              <IconMinus size={16} />
+            </button>
+            <span aria-live="polite" className="min-w-7 text-center text-sm font-semibold">
+              {updating ? <LoadingSpinner size="sm" /> : item.quantity}
+            </span>
+            <button
+              type="button"
+              onClick={() => handleQuantityChange(item.quantity + 1)}
+              disabled={updating || isUnavailable}
+              aria-label={td('increaseQuantity')}
+              className="hover:bg-secondary flex h-full w-9 items-center justify-center rounded-e-full transition-colors disabled:opacity-40"
+            >
+              <IconPlus size={16} />
+            </button>
+          </div>
+
+          <button
+            type="button"
+            onClick={handleRemove}
+            disabled={removing}
+            className="text-muted-foreground hover:text-destructive inline-flex items-center gap-1.5 text-xs font-medium transition-colors disabled:opacity-50"
+          >
+            <IconTrash size={16} />
+            {removing ? t('removing') : t('remove')}
+          </button>
+        </div>
+      </div>
+
+      {/* Line total */}
+      <span className="text-foreground text-base font-semibold">
+        {formatPrice(lineTotal, { currency }) as string}
+      </span>
+    </div>
+  );
+}

package/templates/nextjs/designs/atelier/ui/cart/cart-view.tsx

@@ -1,147 +1,184 @@
-'use client';
-
-import { Link } from '@/core/lib/navigation';
-import { useCartPage } from '@/core/hooks/use-cart-page';
-import { CartItem } from '@/ui/cart/cart-item';
-import { CartUpgradeBanner } from '@/ui/cart/cart-upgrade-banner';
-import { CartBundleOfferCard } from '@/ui/cart/cart-bundle-offer';
-import { CartSummary } from '@/ui/cart/cart-summary';
-import { CouponInput } from '@/ui/cart/coupon-input';
-import { CartNudges } from '@/ui/cart/cart-nudges';
-import { FreeShippingBar } from '@/ui/cart/free-shipping-bar';
-import { ReservationCountdown } from '@/ui/cart/reservation-countdown';
-import { CartRecommendationSection } from '@/ui/product/recommendation-section';
-import { LoadingSpinner } from '@/ui/shared/loading-spinner';
-import { useTranslations } from '@/core/lib/translations';
-import { IconBag, IconArrowEnd, IconShield } from '@/ui/shared/icons';
-
-export function CartView() {
-  const t = useTranslations('cart');
-  const tc = useTranslations('common');
-  const { cart, cartLoading, refreshCart, itemCount, cartRecs, upgrades, bundles } = useCartPage();
-
-  if (cartLoading) {
-    return <LoadingSpinner size="lg" className="min-h-[60vh]" />;
-  }
-
-  // Empty cart state — designed, never a bare sentence in blank space.
-  if (!cart || cart.items.length === 0) {
-    return (
-      <section className="container-narrow flex min-h-[60vh] items-center justify-center py-16">
-        <div className="card flex w-full max-w-md flex-col items-center gap-3 px-8 py-14 text-center">
-          <span className="flex h-16 w-16 items-center justify-center rounded-full bg-secondary text-primary">
-            <IconBag size={32} />
-          </span>
-          <h1 className="text-2xl sm:text-3xl">{t('emptyTitle')}</h1>
-          <p className="text-muted-foreground">{t('emptySubtitle')}</p>
-          <Link href="/products" className="btn-primary btn-md mt-3">
-            {tc('continueShopping')}
-            <IconArrowEnd size={18} className="rtl-flip" />
-          </Link>
-        </div>
-      </section>
-    );
-  }
-
-  return (
-    <section className="container-narrow py-8 lg:py-12">
-      <h1 className="text-3xl sm:text-4xl">
-        {t('title')}{' '}
-        <span className="font-sans text-base font-normal text-muted-foreground">
-          ({itemCount} {itemCount === 1 ? tc('item') : tc('items')})
-        </span>
-      </h1>
-
-      {/* Reservation countdown */}
-      {cart.reservation?.hasReservation && (
-        <ReservationCountdown reservation={cart.reservation} className="mt-4" />
-      )}
-
-      <div className="mt-6 grid grid-cols-1 items-start gap-8 lg:grid-cols-3 lg:gap-10">
-        {/* Cart Items */}
-        <div className="lg:col-span-2">
-          {/* Nudges */}
-          {cart.nudges && cart.nudges.length > 0 && (
-            <CartNudges nudges={cart.nudges} className="mb-4" />
-          )}
-
-          {/* Cart items */}
-          <ul className="card divide-y overflow-hidden">
-            {cart.items.map((item) => (
-              <li key={item.id} className="p-4 sm:p-5">
-                <CartItem item={item} onUpdate={refreshCart} />
-                {upgrades?.upgrades?.[item.productId] && (
-                  <CartUpgradeBanner
-                    suggestion={upgrades.upgrades[item.productId]}
-                    cartItem={item}
-                    onUpgrade={refreshCart}
-                    className="mt-4"
-                  />
-                )}
-              </li>
-            ))}
-          </ul>
-
-          {/* Bundle offers */}
-          {bundles?.bundles && bundles.bundles.length > 0 && (
-            <section className="mt-6">
-              <h3 className="mb-3 text-xl">{t('bundleOffers')}</h3>
-              <div className="space-y-4">
-                {bundles.bundles.map((offer) => (
-                  <CartBundleOfferCard
-                    key={offer.id}
-                    offer={offer}
-                    cartId={cart.id}
-                    onAdd={refreshCart}
-                  />
-                ))}
-              </div>
-            </section>
-          )}
-
-          {/* Coupon input */}
-          <div className="mt-6">
-            <p className="mb-2 text-sm font-semibold text-foreground">{t('couponTitle')}</p>
-            <CouponInput cart={cart} onUpdate={refreshCart} />
-          </div>
-        </div>
-
-        {/* Summary sidebar */}
-        <aside className="lg:sticky lg:top-24">
-          <div className="card space-y-5 p-5 sm:p-6">
-            <FreeShippingBar />
-            <CartSummary />
-
-            <Link href="/checkout" className="btn-primary btn-lg w-full">
-              {t('proceedToCheckout')}
-              <IconArrowEnd size={20} className="rtl-flip" />
-            </Link>
-
-            <p className="flex items-center justify-center gap-1.5 text-xs text-muted-foreground">
-              <IconShield size={16} />
-              {t('secureCheckoutNote')}
-            </p>
-          </div>
-
-          <p className="mt-4 text-center">
-            <Link
-              href="/products"
-              className="text-sm font-medium text-primary underline-offset-2 hover:underline"
-            >
-              {tc('continueShopping')}
-            </Link>
-          </p>
-        </aside>
-      </div>
-
-      {/* Cross-sell recommendations */}
-      {cartRecs?.recommendations && cartRecs.recommendations.length > 0 && (
-        <CartRecommendationSection
-          title={t('youMightAlsoNeed')}
-          items={cartRecs.recommendations}
-          className="mt-12"
-        />
-      )}
-    </section>
-  );
-}
+'use client';
+
+import { Link } from '@/core/lib/navigation';
+import { useCartPage } from '@/core/hooks/use-cart-page';
+import { CartItem } from '@/ui/cart/cart-item';
+import { CartUpgradeBanner } from '@/ui/cart/cart-upgrade-banner';
+import { CartBundleOfferCard } from '@/ui/cart/cart-bundle-offer';
+import { CartSummary } from '@/ui/cart/cart-summary';
+import { CouponInput } from '@/ui/cart/coupon-input';
+import { CartNudges } from '@/ui/cart/cart-nudges';
+import { FreeShippingBar } from '@/ui/cart/free-shipping-bar';
+import { ReservationCountdown } from '@/ui/cart/reservation-countdown';
+import { CartRecommendationSection } from '@/ui/product/recommendation-section';
+import { LoadingSpinner } from '@/ui/shared/loading-spinner';
+import { useTranslations } from '@/core/lib/translations';
+import { IconBag, IconArrowEnd, IconShield } from '@/ui/shared/icons';
+
+export function CartView() {
+  const t = useTranslations('cart');
+  const tc = useTranslations('common');
+  const tr = useTranslations('reservation');
+  const {
+    cart,
+    cartLoading,
+    refreshCart,
+    itemCount,
+    cartRecs,
+    upgrades,
+    bundles,
+    reservationExpired,
+    unavailableItems,
+    canProceedToCheckout,
+    onReservationExpired,
+  } = useCartPage();
+
+  if (cartLoading) {
+    return <LoadingSpinner size="lg" className="min-h-[60vh]" />;
+  }
+
+  // Empty cart state — designed, never a bare sentence in blank space.
+  if (!cart || cart.items.length === 0) {
+    return (
+      <section className="container-narrow flex min-h-[60vh] items-center justify-center py-16">
+        <div className="card flex w-full max-w-md flex-col items-center gap-3 px-8 py-14 text-center">
+          <span className="bg-secondary text-primary flex h-16 w-16 items-center justify-center rounded-full">
+            <IconBag size={32} />
+          </span>
+          <h1 className="text-2xl sm:text-3xl">{t('emptyTitle')}</h1>
+          <p className="text-muted-foreground">{t('emptySubtitle')}</p>
+          <Link href="/products" className="btn-primary btn-md mt-3">
+            {tc('continueShopping')}
+            <IconArrowEnd size={18} className="rtl-flip" />
+          </Link>
+        </div>
+      </section>
+    );
+  }
+
+  return (
+    <section className="container-narrow py-8 lg:py-12">
+      <h1 className="text-3xl sm:text-4xl">
+        {t('title')}{' '}
+        <span className="text-muted-foreground font-sans text-base font-normal">
+          ({itemCount} {itemCount === 1 ? tc('item') : tc('items')})
+        </span>
+      </h1>
+
+      {/* Reservation countdown. onExpire refreshes the cart and closes the
+          checkout gate below. Passing it is what makes expiry mean anything. */}
+      {cart.reservation?.hasReservation && (
+        <ReservationCountdown
+          reservation={cart.reservation}
+          onExpire={onReservationExpired}
+          className="mt-4"
+        />
+      )}
+
+      <div className="mt-6 grid grid-cols-1 items-start gap-8 lg:grid-cols-3 lg:gap-10">
+        {/* Cart Items */}
+        <div className="lg:col-span-2">
+          {/* Nudges */}
+          {cart.nudges && cart.nudges.length > 0 && (
+            <CartNudges nudges={cart.nudges} className="mb-4" />
+          )}
+
+          {/* Cart items */}
+          <ul className="card divide-y overflow-hidden">
+            {cart.items.map((item) => (
+              <li key={item.id} className="p-4 sm:p-5">
+                <CartItem item={item} onUpdate={refreshCart} />
+                {upgrades?.upgrades?.[item.productId] && (
+                  <CartUpgradeBanner
+                    suggestion={upgrades.upgrades[item.productId]}
+                    cartItem={item}
+                    onUpgrade={refreshCart}
+                    className="mt-4"
+                  />
+                )}
+              </li>
+            ))}
+          </ul>
+
+          {/* Bundle offers */}
+          {bundles?.bundles && bundles.bundles.length > 0 && (
+            <section className="mt-6">
+              <h3 className="mb-3 text-xl">{t('bundleOffers')}</h3>
+              <div className="space-y-4">
+                {bundles.bundles.map((offer) => (
+                  <CartBundleOfferCard
+                    key={offer.id}
+                    offer={offer}
+                    cartId={cart.id}
+                    onAdd={refreshCart}
+                  />
+                ))}
+              </div>
+            </section>
+          )}
+
+          {/* Coupon input */}
+          <div className="mt-6">
+            <p className="text-foreground mb-2 text-sm font-semibold">{t('couponTitle')}</p>
+            <CouponInput cart={cart} onUpdate={refreshCart} />
+          </div>
+        </div>
+
+        {/* Summary sidebar */}
+        <aside className="lg:sticky lg:top-24">
+          <div className="card space-y-5 p-5 sm:p-6">
+            <FreeShippingBar />
+            <CartSummary />
+
+            {/* Proceed to checkout. When the gate is closed this must be a
+                real disabled control, never a styled-down link: an anchor
+                ignores `disabled` and would still navigate. */}
+            {canProceedToCheckout ? (
+              <Link href="/checkout" className="btn-primary btn-lg w-full">
+                {t('proceedToCheckout')}
+                <IconArrowEnd size={20} className="rtl-flip" />
+              </Link>
+            ) : (
+              <div>
+                <button type="button" disabled className="btn-primary btn-lg w-full opacity-50">
+                  {t('proceedToCheckout')}
+                  <IconArrowEnd size={20} className="rtl-flip" />
+                </button>
+                <p className="text-destructive mt-2 text-center text-xs">
+                  {unavailableItems.length > 0
+                    ? t('unavailableItemsHint')
+                    : reservationExpired
+                      ? tr('expiredHint')
+                      : null}
+                </p>
+              </div>
+            )}
+
+            <p className="text-muted-foreground flex items-center justify-center gap-1.5 text-xs">
+              <IconShield size={16} />
+              {t('secureCheckoutNote')}
+            </p>
+          </div>
+
+          <p className="mt-4 text-center">
+            <Link
+              href="/products"
+              className="text-primary text-sm font-medium underline-offset-2 hover:underline"
+            >
+              {tc('continueShopping')}
+            </Link>
+          </p>
+        </aside>
+      </div>
+
+      {/* Cross-sell recommendations */}
+      {cartRecs?.recommendations && cartRecs.recommendations.length > 0 && (
+        <CartRecommendationSection
+          title={t('youMightAlsoNeed')}
+          items={cartRecs.recommendations}
+          className="mt-12"
+        />
+      )}
+    </section>
+  );
+}