create-brainerce-store 1.62.0 → 1.64.0

package/templates/nextjs/ui-canvas/product/modifier-group-selector.tsx

@@ -1,165 +1,165 @@
-'use client';
-
-/**
- * <ModifierGroupSelector> — bare-skeleton renderer for a single modifier
- * group (toppings, sauce, bread type, …) per PRD §8.4.
- *
- * DESIGN ME — modifier group on the product page; the group + selections
- * come from useProductPage() via props. The data contract is what matters:
- *
- *   - SINGLE   → renders as <input type="radio">,    max picks = 1
- *   - MULTIPLE → renders as <input type="checkbox">, picks bounded by min..max
- *   - effectiveMax === 0 → group is hidden entirely (variant-disable convention)
- *   - available === false → modifier is disabled with "Sold out" badge
- *   - free counter shows "{used} of {freeQuantity} free" when freeQuantity > 0
- *   - defaultModifierIds + isDefault drive first-render checked state
- *   - client-side guards mirror min/max (UX); the SERVER is authoritative — wire
- *     `MODIFIER_VALIDATION_FAILED` errors back to the user when add-to-cart fails
- *
- * The price-delta side: this component does NOT compute totals. The server
- * runs the free-allocation policy and returns the line's `unitPrice` /
- * `modifiers[]` / `modifiersTotal` snapshot — render those after add-to-cart.
- *
- * 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.
- */
-
-import type { Modifier, ModifierGroup } from 'brainerce';
-
-// The pure selection logic (defaults, validation, wire-format adapter) lives
-// in core (zero markup) so that `core/hooks/use-product-page` never imports
-// from `ui/`. Re-exported here for backward compatibility with existing imports.
-export {
-  buildInitialSelections,
-  toModifierSelections,
-  validateSelections,
-} from '@/core/lib/product-options';
-
-interface ModifierGroupSelectorProps {
-  /**
-   * Effective group as returned by `GET /products/:id` (overrides already
-   * applied — `min`, `max`, `freeQuantity`, etc. are the values the server
-   * will validate against for the active variant).
-   */
-  group: ModifierGroup;
-  /** Currently-selected modifier IDs in click-order. */
-  value: string[];
-  onChange: (next: string[]) => void;
-  /** Disable all controls (e.g., while add-to-cart is in flight). */
-  disabled?: boolean;
-}
-
-export function ModifierGroupSelector({
-  group,
-  value,
-  onChange,
-  disabled = false,
-}: ModifierGroupSelectorProps) {
-  // PRD §7.2.2: variant-disable convention — group with effectiveMax=0 is hidden.
-  if (group.max === 0) return null;
-
-  const isSingle = group.selectionType === 'SINGLE';
-  // Client-side bound — server is authoritative.
-  const effectiveMax = isSingle ? 1 : (group.max ?? Infinity);
-
-  const handleToggle = (modifierId: string, checked: boolean) => {
-    if (disabled) return;
-
-    if (isSingle) {
-      // Radio behavior: replace the selection.
-      onChange(checked ? [modifierId] : []);
-      return;
-    }
-
-    if (checked) {
-      if (value.length >= effectiveMax) return; // would exceed max — ignore the click
-      if (value.includes(modifierId)) return;
-      onChange([...value, modifierId]);
-    } else {
-      onChange(value.filter((id) => id !== modifierId));
-    }
-  };
-
-  const sortedModifiers = [...group.modifiers].sort((a, b) => a.position - b.position);
-
-  // Counter: how many of the picked items are within the "free" window.
-  const usedFreeSlots = Math.min(value.length, group.freeQuantity);
-  const showFreeCounter = group.freeQuantity > 0;
-
-  return (
-    <fieldset>
-      <legend>
-        <span>{group.name}</span>
-        {group.required && <span aria-hidden="true"> *</span>}
-        <span> {ruleSummary(group)}</span>
-      </legend>
-
-      {group.description && <p>{group.description}</p>}
-
-      {showFreeCounter && (
-        <p aria-live="polite">
-          {usedFreeSlots} of {group.freeQuantity} free
-        </p>
-      )}
-
-      <ul>
-        {sortedModifiers.map((modifier) => {
-          const isChecked = value.includes(modifier.id);
-          const isAtCap = !isSingle && !isChecked && value.length >= effectiveMax;
-          const isDisabled = disabled || !modifier.available || isAtCap;
-
-          return (
-            <li key={modifier.id}>
-              <label className="inline-flex items-center gap-2">
-                <input
-                  type={isSingle ? 'radio' : 'checkbox'}
-                  name={`modifier-group-${group.id}`}
-                  value={modifier.id}
-                  checked={isChecked}
-                  disabled={isDisabled}
-                  onChange={(e) => handleToggle(modifier.id, e.target.checked)}
-                />
-                <span>{modifier.name}</span>
-                <ModifierPriceLabel modifier={modifier} />
-                {!modifier.available && <span aria-label="Sold out">Sold out</span>}
-              </label>
-              {modifier.description && <p>{modifier.description}</p>}
-            </li>
-          );
-        })}
-      </ul>
-    </fieldset>
-  );
-}
-
-/**
- * Renders the modifier's price contribution next to its name.
- *
- * Negative deltas display with a leading minus sign (downsell modifiers per
- * PRD §6.3.4); zero-delta modifiers render nothing — silence is the right
- * affordance for a free option.
- */
-function ModifierPriceLabel({ modifier }: { modifier: Modifier }) {
-  const delta = parseFloat(modifier.priceDelta);
-  if (Number.isNaN(delta) || delta === 0) return null;
-  const sign = delta > 0 ? '+' : '';
-  return (
-    <span>
-      {sign}
-      {modifier.priceDelta}
-    </span>
-  );
-}
-
-function ruleSummary(group: ModifierGroup): string {
-  const parts: string[] = [];
-  if (group.selectionType === 'SINGLE') {
-    parts.push('Pick one');
-  } else if (group.max != null) {
-    if (group.min === 0) parts.push(`Up to ${group.max}`);
-    else if (group.min === group.max) parts.push(`Pick exactly ${group.min}`);
-    else parts.push(`${group.min}–${group.max}`);
-  } else if (group.min > 0) {
-    parts.push(`At least ${group.min}`);
-  }
-  return parts.length ? `(${parts.join(', ')})` : '';
-}
+'use client';
+
+/**
+ * <ModifierGroupSelector> — bare-skeleton renderer for a single modifier
+ * group (toppings, sauce, bread type, …) per PRD §8.4.
+ *
+ * DESIGN ME — modifier group on the product page; the group + selections
+ * come from useProductPage() via props. The data contract is what matters:
+ *
+ *   - SINGLE   → renders as <input type="radio">,    max picks = 1
+ *   - MULTIPLE → renders as <input type="checkbox">, picks bounded by min..max
+ *   - effectiveMax === 0 → group is hidden entirely (variant-disable convention)
+ *   - available === false → modifier is disabled with "Sold out" badge
+ *   - free counter shows "{used} of {freeQuantity} free" when freeQuantity > 0
+ *   - defaultModifierIds + isDefault drive first-render checked state
+ *   - client-side guards mirror min/max (UX); the SERVER is authoritative — wire
+ *     `MODIFIER_VALIDATION_FAILED` errors back to the user when add-to-cart fails
+ *
+ * The price-delta side: this component does NOT compute totals. The server
+ * runs the free-allocation policy and returns the line's `unitPrice` /
+ * `modifiers[]` / `modifiersTotal` snapshot — render those after add-to-cart.
+ *
+ * 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.
+ */
+
+import type { Modifier, ModifierGroup } from 'brainerce';
+
+// The pure selection logic (defaults, validation, wire-format adapter) lives
+// in core (zero markup) so that `core/hooks/use-product-page` never imports
+// from `ui/`. Re-exported here for backward compatibility with existing imports.
+export {
+  buildInitialSelections,
+  toModifierSelections,
+  validateSelections,
+} from '@/core/lib/product-options';
+
+interface ModifierGroupSelectorProps {
+  /**
+   * Effective group as returned by `GET /products/:id` (overrides already
+   * applied — `min`, `max`, `freeQuantity`, etc. are the values the server
+   * will validate against for the active variant).
+   */
+  group: ModifierGroup;
+  /** Currently-selected modifier IDs in click-order. */
+  value: string[];
+  onChange: (next: string[]) => void;
+  /** Disable all controls (e.g., while add-to-cart is in flight). */
+  disabled?: boolean;
+}
+
+export function ModifierGroupSelector({
+  group,
+  value,
+  onChange,
+  disabled = false,
+}: ModifierGroupSelectorProps) {
+  // PRD §7.2.2: variant-disable convention — group with effectiveMax=0 is hidden.
+  if (group.max === 0) return null;
+
+  const isSingle = group.selectionType === 'SINGLE';
+  // Client-side bound — server is authoritative.
+  const effectiveMax = isSingle ? 1 : (group.max ?? Infinity);
+
+  const handleToggle = (modifierId: string, checked: boolean) => {
+    if (disabled) return;
+
+    if (isSingle) {
+      // Radio behavior: replace the selection.
+      onChange(checked ? [modifierId] : []);
+      return;
+    }
+
+    if (checked) {
+      if (value.length >= effectiveMax) return; // would exceed max — ignore the click
+      if (value.includes(modifierId)) return;
+      onChange([...value, modifierId]);
+    } else {
+      onChange(value.filter((id) => id !== modifierId));
+    }
+  };
+
+  const sortedModifiers = [...group.modifiers].sort((a, b) => a.position - b.position);
+
+  // Counter: how many of the picked items are within the "free" window.
+  const usedFreeSlots = Math.min(value.length, group.freeQuantity);
+  const showFreeCounter = group.freeQuantity > 0;
+
+  return (
+    <fieldset>
+      <legend>
+        <span>{group.name}</span>
+        {group.required && <span aria-hidden="true"> *</span>}
+        <span> {ruleSummary(group)}</span>
+      </legend>
+
+      {group.description && <p>{group.description}</p>}
+
+      {showFreeCounter && (
+        <p aria-live="polite">
+          {usedFreeSlots} of {group.freeQuantity} free
+        </p>
+      )}
+
+      <ul>
+        {sortedModifiers.map((modifier) => {
+          const isChecked = value.includes(modifier.id);
+          const isAtCap = !isSingle && !isChecked && value.length >= effectiveMax;
+          const isDisabled = disabled || !modifier.available || isAtCap;
+
+          return (
+            <li key={modifier.id}>
+              <label className="inline-flex items-center gap-2">
+                <input
+                  type={isSingle ? 'radio' : 'checkbox'}
+                  name={`modifier-group-${group.id}`}
+                  value={modifier.id}
+                  checked={isChecked}
+                  disabled={isDisabled}
+                  onChange={(e) => handleToggle(modifier.id, e.target.checked)}
+                />
+                <span>{modifier.name}</span>
+                <ModifierPriceLabel modifier={modifier} />
+                {!modifier.available && <span aria-label="Sold out">Sold out</span>}
+              </label>
+              {modifier.description && <p>{modifier.description}</p>}
+            </li>
+          );
+        })}
+      </ul>
+    </fieldset>
+  );
+}
+
+/**
+ * Renders the modifier's price contribution next to its name.
+ *
+ * Negative deltas display with a leading minus sign (downsell modifiers per
+ * PRD §6.3.4); zero-delta modifiers render nothing — silence is the right
+ * affordance for a free option.
+ */
+function ModifierPriceLabel({ modifier }: { modifier: Modifier }) {
+  const delta = parseFloat(modifier.priceDelta);
+  if (Number.isNaN(delta) || delta === 0) return null;
+  const sign = delta > 0 ? '+' : '';
+  return (
+    <span>
+      {sign}
+      {modifier.priceDelta}
+    </span>
+  );
+}
+
+function ruleSummary(group: ModifierGroup): string {
+  const parts: string[] = [];
+  if (group.selectionType === 'SINGLE') {
+    parts.push('Pick one');
+  } else if (group.max != null) {
+    if (group.min === 0) parts.push(`Up to ${group.max}`);
+    else if (group.min === group.max) parts.push(`Pick exactly ${group.min}`);
+    else parts.push(`${group.min}–${group.max}`);
+  } else if (group.min > 0) {
+    parts.push(`At least ${group.min}`);
+  }
+  return parts.length ? `(${parts.join(', ')})` : '';
+}

package/templates/nextjs/ui-canvas/product/price-display.tsx

@@ -1,52 +1,52 @@
-'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';
-}
-
-/**
- * DESIGN ME — 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.
- *
- * 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 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 items-center gap-2', className)}>
-      {isOnSale ? (
-        <>
-          <span>{formatPrice(sale!, { currency: currencyCode }) as string}</span>
-          <s>{formatPrice(basePrice, { currency: currencyCode }) as string}</s>
-          {discountPercent > 0 && <span>-{discountPercent}%</span>}
-        </>
-      ) : (
-        <span>{formatPrice(basePrice, { currency: currencyCode }) as string}</span>
-      )}
-    </span>
-  );
-}
+'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';
+}
+
+/**
+ * DESIGN ME — 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.
+ *
+ * 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 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 items-center gap-2', className)}>
+      {isOnSale ? (
+        <>
+          <span>{formatPrice(sale!, { currency: currencyCode }) as string}</span>
+          <s>{formatPrice(basePrice, { currency: currencyCode }) as string}</s>
+          {discountPercent > 0 && <span>-{discountPercent}%</span>}
+        </>
+      ) : (
+        <span>{formatPrice(basePrice, { currency: currencyCode }) as string}</span>
+      )}
+    </span>
+  );
+}

package/templates/nextjs/ui-canvas/product/product-card.tsx

@@ -11,6 +11,7 @@ import { StockBadge } from '@/ui/product/stock-badge';
 import { DiscountBadge } from '@/ui/product/discount-badge';
 import { useCart } from '@/core/providers/store-provider';
 import { useCurrency } from '@/core/lib/use-currency';
+import { trackAddToCart } from '@/core/lib/tracking';
 import { cn } from '@/core/lib/utils';
 
 interface ProductCardProps {
@@ -32,8 +33,7 @@ function pickDisplayPrice(
   fallbackCurrency: string
 ): { price: number | undefined; salePrice: number | null; currency: string } {
   if (product.displayPrice != null && product.displayCurrency) {
-    const sale =
-      product.displaySalePrice != null ? parseFloat(product.displaySalePrice) : null;
+    const sale = product.displaySalePrice != null ? parseFloat(product.displaySalePrice) : null;
     return {
       // `displayPrice` is the base price converted to the region currency —
       // it goes into the PriceDisplay `price` (base) slot, NOT the sale slot.
@@ -119,6 +119,11 @@ export function ProductCard({ product, className }: ProductCardProps) {
       const client = getClient();
       await client.smartAddToCart({ productId: product.id, quantity: 1 });
       await refreshCart();
+      // Quick-add from a grid card is a real add_to_cart — without this the
+      // ad platforms only ever see adds made from a product page. Reported in
+      // the DISPLAYED currency (region-converted when the storefront passed a
+      // regionId), because that is what the shopper is actually being charged.
+      trackAddToCart(product, null, 1, display.salePrice ?? display.price, display.currency);
       setAdded(true);
       setTimeout(() => setAdded(false), 2000);
     } catch (err) {