create-brainerce-store 1.73.0 → 1.74.0

package/templates/nextjs/designs/atelier/ui/product/recommendation-section.tsx

@@ -1,95 +1,101 @@
-'use client';
-
-import { Link } from '@/core/lib/navigation';
-import { CdnImage as Image } from '@/ui/shared/cdn-image';
-import type { ProductRecommendation } from 'brainerce';
-import { PriceDisplay } from '@/ui/product/price-display';
-import { cn } from '@/core/lib/utils';
-
-interface RecommendationCardProps {
-  item: ProductRecommendation;
-  className?: string;
-}
-
-function RecommendationCard({ item, className }: RecommendationCardProps) {
-  const firstImage = item.images?.[0];
-  const imageUrl = typeof firstImage === 'string' ? firstImage : firstImage?.url || null;
-  const slug = item.slug || item.id;
-  const basePrice = parseFloat(item.basePrice);
-  const salePrice = item.salePrice ? parseFloat(item.salePrice) : undefined;
-  const isOnSale = salePrice != null && salePrice < basePrice;
-
-  return (
-    <Link
-      href={`/products/${slug}`}
-      className={cn('group card card-hover block overflow-hidden', className)}
-    >
-      {/* `relative` + `aspect-square` are layout-critical for next/image fill */}
-      <span className="relative block aspect-square overflow-hidden bg-secondary">
-        {imageUrl ? (
-          <Image
-            src={imageUrl}
-            alt={item.name}
-            fill
-            sizes="(max-width: 640px) 50vw, (max-width: 1024px) 33vw, 20vw"
-            className="img-zoom object-cover"
-          />
-        ) : null}
-      </span>
-      <span className="block space-y-1 p-4">
-        <span className="block text-sm font-semibold leading-snug text-foreground group-hover:text-primary">
-          {item.name}
-        </span>
-        <PriceDisplay price={basePrice} salePrice={isOnSale ? salePrice : undefined} size="sm" />
-      </span>
-    </Link>
-  );
-}
-
-interface RecommendationSectionProps {
-  title: string;
-  items: ProductRecommendation[];
-  className?: string;
-}
-
-/** Recommendation strip on the product page (upsells / related). */
-export function RecommendationSection({ title, items, className }: RecommendationSectionProps) {
-  if (items.length === 0) return null;
-
-  return (
-    <section className={cn('border-t pt-10', className)}>
-      <h2 className="mb-6 text-2xl">{title}</h2>
-      <div className="grid grid-cols-2 gap-3 sm:gap-5 lg:grid-cols-4">
-        {items.slice(0, 4).map((item) => (
-          <RecommendationCard key={item.id} item={item} />
-        ))}
-      </div>
-    </section>
-  );
-}
-
-interface CartRecommendationSectionProps {
-  title: string;
-  items: ProductRecommendation[];
-  className?: string;
-}
-
-/** Cross-sell strip on the cart page ("you might also need"). */
-export function CartRecommendationSection({
-  title,
-  items,
-  className,
-}: CartRecommendationSectionProps) {
-  if (items.length === 0) return null;
-
-  return (
-    <section className={cn('border-t pt-10', className)}>
-      <h2 className="mb-6 text-2xl">{title}</h2>
-      <div className="grid grid-cols-2 gap-3 sm:gap-5 lg:grid-cols-4">
-        {items.slice(0, 4).map((item) => (
-          <RecommendationCard key={item.id} item={item} />
-        ))}
-      </div>
-    </section>
-  );
-}
+'use client';
+
+import { Link } from '@/core/lib/navigation';
+import { CdnImage as Image } from '@/ui/shared/cdn-image';
+import type { ProductRecommendation } from 'brainerce';
+import { PriceDisplay } from '@/ui/product/price-display';
+import { cn } from '@/core/lib/utils';
+
+interface RecommendationCardProps {
+  item: ProductRecommendation;
+  className?: string;
+}
+
+function RecommendationCard({ item, className }: RecommendationCardProps) {
+  const firstImage = item.images?.[0];
+  const imageUrl = typeof firstImage === 'string' ? firstImage : firstImage?.url || null;
+  const slug = item.slug || item.id;
+  // ⛔ NOT region-converted, and it cannot be. `ProductRecommendation` is a
+  // trimmed shape that carries `basePrice` / `salePrice` only: the backend
+  // attaches no displayPrice/displayCurrency to it, so there is no converted
+  // amount to render and converting here would mean inventing an FX rate.
+  // These tiles stay in the store currency on a multi-region store. Do not
+  // "fix" it with a client-side conversion.
+  const basePrice = parseFloat(item.basePrice);
+  const salePrice = item.salePrice ? parseFloat(item.salePrice) : undefined;
+  const isOnSale = salePrice != null && salePrice < basePrice;
+
+  return (
+    <Link
+      href={`/products/${slug}`}
+      className={cn('group card card-hover block overflow-hidden', className)}
+    >
+      {/* `relative` + `aspect-square` are layout-critical for next/image fill */}
+      <span className="relative block aspect-square overflow-hidden bg-secondary">
+        {imageUrl ? (
+          <Image
+            src={imageUrl}
+            alt={item.name}
+            fill
+            sizes="(max-width: 640px) 50vw, (max-width: 1024px) 33vw, 20vw"
+            className="img-zoom object-cover"
+          />
+        ) : null}
+      </span>
+      <span className="block space-y-1 p-4">
+        <span className="block text-sm font-semibold leading-snug text-foreground group-hover:text-primary">
+          {item.name}
+        </span>
+        <PriceDisplay price={basePrice} salePrice={isOnSale ? salePrice : undefined} size="sm" />
+      </span>
+    </Link>
+  );
+}
+
+interface RecommendationSectionProps {
+  title: string;
+  items: ProductRecommendation[];
+  className?: string;
+}
+
+/** Recommendation strip on the product page (upsells / related). */
+export function RecommendationSection({ title, items, className }: RecommendationSectionProps) {
+  if (items.length === 0) return null;
+
+  return (
+    <section className={cn('border-t pt-10', className)}>
+      <h2 className="mb-6 text-2xl">{title}</h2>
+      <div className="grid grid-cols-2 gap-3 sm:gap-5 lg:grid-cols-4">
+        {items.slice(0, 4).map((item) => (
+          <RecommendationCard key={item.id} item={item} />
+        ))}
+      </div>
+    </section>
+  );
+}
+
+interface CartRecommendationSectionProps {
+  title: string;
+  items: ProductRecommendation[];
+  className?: string;
+}
+
+/** Cross-sell strip on the cart page ("you might also need"). */
+export function CartRecommendationSection({
+  title,
+  items,
+  className,
+}: CartRecommendationSectionProps) {
+  if (items.length === 0) return null;
+
+  return (
+    <section className={cn('border-t pt-10', className)}>
+      <h2 className="mb-6 text-2xl">{title}</h2>
+      <div className="grid grid-cols-2 gap-3 sm:gap-5 lg:grid-cols-4">
+        {items.slice(0, 4).map((item) => (
+          <RecommendationCard key={item.id} item={item} />
+        ))}
+      </div>
+    </section>
+  );
+}

package/templates/nextjs/designs/atelier/ui/product/stock-badge.tsx

@@ -3,9 +3,16 @@
 import type { InventoryInfo } from 'brainerce';
 import { cn } from '@/core/lib/utils';
 import { useTranslations } from '@/core/lib/translations';
+import { useStoreCapabilities } from '@/core/providers/store-provider';
+import { resolveLowStockThreshold } from '@/core/lib/capabilities';
 
 interface StockBadgeProps {
   inventory: InventoryInfo | null | undefined;
+  /**
+   * Override the threshold. Leave it unset — the merchant's configured value
+   * comes from the store's capabilities, and a hardcoded number here shows the
+   * wrong badge on every store that chose a different one.
+   */
   lowStockThreshold?: number;
   className?: string;
 }
@@ -16,9 +23,17 @@ type StockState = 'in' | 'low' | 'out';
  * Stock status pill (in stock / low stock / out of stock) with a colored
  * status dot; derives the label from the product/variant `inventory` prop.
  */
-export function StockBadge({ inventory, lowStockThreshold = 5, className }: StockBadgeProps) {
+export function StockBadge({ inventory, lowStockThreshold, className }: StockBadgeProps) {
   const t = useTranslations('productDetail');
-  const { label, state } = getStock(inventory, lowStockThreshold, t);
+  // Merchant-configured, from the channel's capabilities. Falls back to the
+  // platform default while the fetch is in flight or if it failed, and resolves
+  // to 0 (nothing is ever low) when the merchant turned low-stock warnings off.
+  const { capabilities } = useStoreCapabilities();
+  const { label, state } = getStock(
+    inventory,
+    lowStockThreshold ?? resolveLowStockThreshold(capabilities),
+    t
+  );
 
   return (
     <span

package/templates/nextjs/designs/atelier/ui/shared/icons.tsx

@@ -104,6 +104,15 @@ export function IconCheck(p: IconProps) {
   );
 }
 
+export function IconSearch(p: IconProps) {
+  return (
+    <Base {...p}>
+      <circle cx="11" cy="11" r="6.5" />
+      <path d="m16 16 4.5 4.5" />
+    </Base>
+  );
+}
+
 export function IconStar({ filled = true, ...p }: IconProps & { filled?: boolean }) {
   return (
     <Base {...p} fill={filled ? 'currentColor' : 'none'} strokeWidth={filled ? 0 : 1.5}>

package/templates/nextjs/ui-canvas/cart/cart-summary.tsx

@@ -1,99 +1,98 @@
-'use client';
-
-import { formatPrice } from 'brainerce';
-import { useTranslations } from '@/core/lib/translations';
-import { useCart } from '@/core/providers/store-provider';
-import { useCurrency } from '@/core/lib/use-currency';
-import { cn } from '@/core/lib/utils';
-
-interface CartSummaryProps {
-  className?: string;
-}
-
-/**
- * DESIGN ME — order summary (subtotal, rule/coupon discounts, shipping, tax
- * note, total); all figures come from useCart().totals and useCart().cart.
- * Keep every discount branch — merchants rely on the per-rule breakdown.
- *
- * Building blocks: shadcn/ui primitives in src/components/ui (Button, Card, Badge, Input, Select, Accordion, Dialog, Skeleton, ...) + lucide-react icons are installed and ready to compose with.
- */
-export function CartSummary({ className }: CartSummaryProps) {
-  const t = useTranslations('cart');
-  const tc = useTranslations('common');
-  const { totals, cart } = useCart();
-  const currency = useCurrency();
-
-  const rules = cart?.appliedDiscounts;
-  const ruleAmt = cart?.ruleDiscountAmount ? parseFloat(cart.ruleDiscountAmount) : 0;
-  const couponAmt = totals.discount - ruleAmt;
-
-  return (
-    <section className={cn(className)}>
-      <h3>{t('orderSummary')}</h3>
-
-      <dl>
-        {/* Subtotal */}
-        <div className="flex items-center justify-between gap-4">
-          <dt>{tc('subtotal')}</dt>
-          <dd>{formatPrice(totals.subtotal, { currency }) as string}</dd>
-        </div>
-
-        {/* Rule discounts - show each rule by name */}
-        {rules && rules.length > 0
-          ? rules.map((rule) => (
-              <div key={rule.ruleId} className="flex items-center justify-between gap-4">
-                <dt>{rule.ruleName}</dt>
-                <dd>-{formatPrice(parseFloat(rule.discountAmount), { currency }) as string}</dd>
-              </div>
-            ))
-          : ruleAmt > 0 && (
-              <div className="flex items-center justify-between gap-4">
-                <dt>{tc('generalDiscount')}</dt>
-                <dd>-{formatPrice(ruleAmt, { currency }) as string}</dd>
-              </div>
-            )}
-
-        {/* Coupon discount */}
-        {cart?.couponCode && couponAmt > 0 && (
-          <div className="flex items-center justify-between gap-4">
-            <dt>
-              {tc('couponDiscount')} ({cart.couponCode})
-            </dt>
-            <dd>-{formatPrice(couponAmt, { currency }) as string}</dd>
-          </div>
-        )}
-
-        {/* Fallback: generic discount when no breakdown available */}
-        {totals.discount > 0 &&
-          ruleAmt <= 0 &&
-          !cart?.couponCode &&
-          (!rules || rules.length === 0) && (
-            <div className="flex items-center justify-between gap-4">
-              <dt>{tc('discount')}</dt>
-              <dd>-{formatPrice(totals.discount, { currency }) as string}</dd>
-            </div>
-          )}
-
-        {/* Shipping */}
-        {totals.shipping > 0 && (
-          <div className="flex items-center justify-between gap-4">
-            <dt>{tc('shipping')}</dt>
-            <dd>{formatPrice(totals.shipping, { currency }) as string}</dd>
-          </div>
-        )}
-
-        {/* Tax */}
-        <div className="flex items-center justify-between gap-4">
-          <dt>{tc('tax')}</dt>
-          <dd>{t('taxAtCheckout')}</dd>
-        </div>
-
-        {/* Total */}
-        <div className="flex items-center justify-between gap-4">
-          <dt>{tc('total')}</dt>
-          <dd>{formatPrice(totals.total, { currency }) as string}</dd>
-        </div>
-      </dl>
-    </section>
-  );
-}
+'use client';
+
+import { formatPrice } from 'brainerce';
+import { useTranslations } from '@/core/lib/translations';
+import { useCart } from '@/core/providers/store-provider';
+import { TaxEstimateLine } from '@/ui/cart/tax-estimate-line';
+import { useCurrency } from '@/core/lib/use-currency';
+import { cn } from '@/core/lib/utils';
+
+interface CartSummaryProps {
+  className?: string;
+}
+
+/**
+ * DESIGN ME — order summary (subtotal, rule/coupon discounts, shipping, tax
+ * note, total); all figures come from useCart().totals and useCart().cart.
+ * Keep every discount branch — merchants rely on the per-rule breakdown.
+ *
+ * Building blocks: shadcn/ui primitives in src/components/ui (Button, Card, Badge, Input, Select, Accordion, Dialog, Skeleton, ...) + lucide-react icons are installed and ready to compose with.
+ */
+export function CartSummary({ className }: CartSummaryProps) {
+  const t = useTranslations('cart');
+  const tc = useTranslations('common');
+  const { totals, cart } = useCart();
+  const currency = useCurrency();
+
+  const rules = cart?.appliedDiscounts;
+  const ruleAmt = cart?.ruleDiscountAmount ? parseFloat(cart.ruleDiscountAmount) : 0;
+  const couponAmt = totals.discount - ruleAmt;
+
+  return (
+    <section className={cn(className)}>
+      <h3>{t('orderSummary')}</h3>
+
+      <dl>
+        {/* Subtotal */}
+        <div className="flex items-center justify-between gap-4">
+          <dt>{tc('subtotal')}</dt>
+          <dd>{formatPrice(totals.subtotal, { currency }) as string}</dd>
+        </div>
+
+        {/* Rule discounts - show each rule by name */}
+        {rules && rules.length > 0
+          ? rules.map((rule) => (
+              <div key={rule.ruleId} className="flex items-center justify-between gap-4">
+                <dt>{rule.ruleName}</dt>
+                <dd>-{formatPrice(parseFloat(rule.discountAmount), { currency }) as string}</dd>
+              </div>
+            ))
+          : ruleAmt > 0 && (
+              <div className="flex items-center justify-between gap-4">
+                <dt>{tc('generalDiscount')}</dt>
+                <dd>-{formatPrice(ruleAmt, { currency }) as string}</dd>
+              </div>
+            )}
+
+        {/* Coupon discount */}
+        {cart?.couponCode && couponAmt > 0 && (
+          <div className="flex items-center justify-between gap-4">
+            <dt>
+              {tc('couponDiscount')} ({cart.couponCode})
+            </dt>
+            <dd>-{formatPrice(couponAmt, { currency }) as string}</dd>
+          </div>
+        )}
+
+        {/* Fallback: generic discount when no breakdown available */}
+        {totals.discount > 0 &&
+          ruleAmt <= 0 &&
+          !cart?.couponCode &&
+          (!rules || rules.length === 0) && (
+            <div className="flex items-center justify-between gap-4">
+              <dt>{tc('discount')}</dt>
+              <dd>-{formatPrice(totals.discount, { currency }) as string}</dd>
+            </div>
+          )}
+
+        {/* Shipping */}
+        {totals.shipping > 0 && (
+          <div className="flex items-center justify-between gap-4">
+            <dt>{tc('shipping')}</dt>
+            <dd>{formatPrice(totals.shipping, { currency }) as string}</dd>
+          </div>
+        )}
+
+        {/* Tax: a real estimate when the store has a rate for the buyer's
+            country, and the original "calculated at checkout" row otherwise. */}
+        <TaxEstimateLine />
+
+        {/* Total */}
+        <div className="flex items-center justify-between gap-4">
+          <dt>{tc('total')}</dt>
+          <dd>{formatPrice(totals.total, { currency }) as string}</dd>
+        </div>
+      </dl>
+    </section>
+  );
+}

package/templates/nextjs/ui-canvas/cart/gift-card-input.tsx

@@ -0,0 +1,142 @@
+'use client';
+
+import { useState } from 'react';
+import type { Checkout } from 'brainerce';
+import { getClient } from '@/core/lib/brainerce';
+import { useTranslations } from '@/core/lib/translations';
+import { LoadingSpinner } from '@/ui/shared/loading-spinner';
+import { cn } from '@/core/lib/utils';
+
+interface GiftCardInputProps {
+  checkoutId: string;
+  /** Cards already on this checkout. Each is removed by its own tenderId. */
+  tenders: NonNullable<Checkout['tenders']>;
+  /** Formats an amount in the checkout's currency. */
+  formatAmount: (value: string) => string;
+  onUpdate: () => void;
+  className?: string;
+}
+
+/**
+ * DESIGN ME — gift-card redemption control on the checkout page; `tenders` and
+ * `formatAmount` come from the checkout page's own state.
+ *
+ * ⛔ Do NOT design this as a second coupon field. A coupon reduces what the
+ * order is worth; a gift card PAYS for an order that is still worth what it
+ * was. The total does not move and tax is unchanged — only the amount charged
+ * to the payment provider drops. Style the applied card as its own line near
+ * the total, never inside the discount row, or the shopper is shown one number
+ * and charged another and the receipt misstates the taxable base.
+ *
+ * Keep: the list of applied cards (each removable by `tenderId`), the code
+ * field, and the error message. A checkout can carry several cards at once.
+ *
+ * Keep `dir="ltr"` on the input — the code is Latin even on an RTL storefront.
+ *
+ * Refusals are deliberately identical for "no such code", "expired", "already
+ * spent" and "wrong currency": anything that tells them apart is an oracle
+ * someone walks the code space against. Show what the server said; never guess
+ * a more specific reason.
+ *
+ * Building blocks: shadcn/ui primitives in src/components/ui (Button, Card, Badge, Input, Select, Accordion, Dialog, Skeleton, ...) + lucide-react icons are installed and ready to compose with.
+ */
+export function GiftCardInput({
+  checkoutId,
+  tenders,
+  formatAmount,
+  onUpdate,
+  className,
+}: GiftCardInputProps) {
+  const t = useTranslations('giftCard');
+  const tc = useTranslations('common');
+  const [code, setCode] = useState('');
+  const [applying, setApplying] = useState(false);
+  const [removingId, setRemovingId] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  async function handleApply() {
+    const trimmed = code.trim();
+    if (!trimmed || applying) return;
+
+    try {
+      setApplying(true);
+      setError(null);
+      await getClient().applyGiftCard(checkoutId, trimmed);
+      // Cleared on success only. A rejected code stays in the field so the
+      // shopper can fix a typo instead of re-reading it off the card.
+      setCode('');
+      onUpdate();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : t('invalidCode'));
+    } finally {
+      setApplying(false);
+    }
+  }
+
+  async function handleRemove(tenderId: string) {
+    if (removingId) return;
+
+    try {
+      setRemovingId(tenderId);
+      setError(null);
+      await getClient().removeGiftCard(checkoutId, tenderId);
+      onUpdate();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : t('removeFailed'));
+    } finally {
+      setRemovingId(null);
+    }
+  }
+
+  return (
+    <div className={cn(className)}>
+      {tenders.length > 0 && (
+        <ul>
+          {tenders.map((tender) => (
+            <li key={tender.tenderId}>
+              {/* What was applied, not what the card holds. A ₪200 card on a
+                  ₪50 order applies ₪50 and keeps the rest for next time —
+                  showing the balance here would look like a lost ₪150. */}
+              <span>{t('applied', { amount: formatAmount(tender.amountApplied) })}</span>
+              <button
+                type="button"
+                onClick={() => handleRemove(tender.tenderId)}
+                disabled={removingId === tender.tenderId}
+              >
+                {removingId === tender.tenderId ? tc('removing') : tc('remove')}
+              </button>
+            </li>
+          ))}
+        </ul>
+      )}
+
+      <div className="flex gap-2">
+        <input
+          type="text"
+          value={code}
+          onChange={(e) => {
+            setCode(e.target.value);
+            if (error) setError(null);
+          }}
+          onKeyDown={(e) => {
+            if (e.key === 'Enter') {
+              e.preventDefault();
+              handleApply();
+            }
+          }}
+          placeholder={t('placeholder')}
+          aria-label={t('placeholder')}
+          aria-invalid={error ? true : undefined}
+          dir="ltr"
+          autoComplete="off"
+          spellCheck={false}
+        />
+        <button type="button" onClick={handleApply} disabled={applying || !code.trim()}>
+          {applying ? <LoadingSpinner size="sm" /> : tc('apply')}
+        </button>
+      </div>
+
+      {error && <p role="alert">{error}</p>}
+    </div>
+  );
+}