create-brainerce-store 1.73.0 → 1.74.0

package/templates/nextjs/base/src/ui/home/home-client.tsx

@@ -1,29 +1,27 @@
-'use client';
-
-import { useStoreInfo } from '@/core/providers/store-provider';
-import { useHomeData } from '@/core/hooks/use-home-data';
-import { LoadingSpinner } from '@/ui/shared/loading-spinner';
-import { DiscountBannerStrip } from './discount-banner-strip';
-import { HeroSection } from './hero-section';
-import { FeaturedProductsSection } from './featured-products-section';
-
-export function HomeClient() {
-  const { storeInfo, loading: storeLoading } = useStoreInfo();
-  const { products, banners, loading } = useHomeData();
-
-  if (storeLoading || loading) {
-    return (
-      <div className="flex min-h-[60vh] items-center justify-center">
-        <LoadingSpinner size="lg" />
-      </div>
-    );
-  }
-
-  return (
-    <div>
-      <DiscountBannerStrip banners={banners} />
-      <HeroSection storeName={storeInfo?.name} />
-      <FeaturedProductsSection products={products} />
-    </div>
-  );
-}
+'use client';
+
+import { useStoreInfo } from '@/core/providers/store-provider';
+import { useHomeData } from '@/core/hooks/use-home-data';
+import { LoadingSpinner } from '@/ui/shared/loading-spinner';
+import { HeroSection } from './hero-section';
+import { FeaturedProductsSection } from './featured-products-section';
+
+export function HomeClient() {
+  const { storeInfo, loading: storeLoading } = useStoreInfo();
+  const { products, loading } = useHomeData();
+
+  if (storeLoading || loading) {
+    return (
+      <div className="flex min-h-[60vh] items-center justify-center">
+        <LoadingSpinner size="lg" />
+      </div>
+    );
+  }
+
+  return (
+    <div>
+      <HeroSection storeName={storeInfo?.name} />
+      <FeaturedProductsSection products={products} />
+    </div>
+  );
+}

package/templates/nextjs/base/src/ui/layout/header-search.tsx

@@ -0,0 +1,249 @@
+'use client';
+
+/**
+ * Header search with autocomplete.
+ *
+ * The header itself is a server component (merchant-configured Content), so
+ * the search box is a client island — the same bridge `HeaderAccount` uses.
+ *
+ * Behaviour:
+ *   - `useSearch()` supplies the suggestions (300ms debounce, 2-char minimum,
+ *     abort on re-query). This component owns only the input + dropdown.
+ *   - Submitting navigates to `/products?search=<query>`, which is exactly
+ *     what `use-product-listing` reads back off the URL. The listing side
+ *     already works; this is the surface that writes the param.
+ *   - Picking a product suggestion goes straight to its PDP; picking a
+ *     category goes to the listing filtered by `?category=<id>`, because a
+ *     CategorySuggestion carries `id` + `name` + `productCount` and no slug.
+ *
+ * The dropdown auto-hides: `suggestions` is `null` until a query clears the
+ * 2-char minimum, and an empty store answers `{ products: [], categories: [] }`
+ * which renders the "no results" line rather than an empty box.
+ *
+ * Keyboard: ArrowDown / ArrowUp move the active option, Enter opens it (or
+ * submits the raw query when nothing is active), Escape closes the panel and
+ * keeps focus in the field. A blur that lands outside the widget closes it.
+ */
+
+import * as React from 'react';
+import { Search } from 'lucide-react';
+import { useRouter } from '@/core/lib/navigation';
+import { useSearch } from '@/core/hooks/use-search';
+import { useTranslations } from '@/core/lib/translations';
+import { cn } from '@/core/lib/utils';
+
+interface HeaderSearchProps {
+  className?: string;
+}
+
+/** One flattened dropdown row — products first, then categories. */
+type Option =
+  | { kind: 'product'; id: string; label: string; href: string }
+  | { kind: 'category'; id: string; label: string; href: string };
+
+export function HeaderSearch({ className }: HeaderSearchProps) {
+  const router = useRouter();
+  const t = useTranslations('nav');
+  const tc = useTranslations('common');
+  const tp = useTranslations('products');
+
+  const [query, setQuery] = React.useState('');
+  const [open, setOpen] = React.useState(false);
+  const [activeIndex, setActiveIndex] = React.useState(-1);
+  const { suggestions, loading } = useSearch(query);
+
+  const rootRef = React.useRef<HTMLDivElement>(null);
+  const listboxId = React.useId();
+
+  // Products first, then categories — one flat list so the arrow keys can walk
+  // the whole panel without caring which section a row came from.
+  const options: Option[] = React.useMemo(() => {
+    if (!suggestions) return [];
+    const rows: Option[] = [];
+    for (const product of suggestions.products) {
+      rows.push({
+        kind: 'product',
+        id: product.id,
+        label: product.name,
+        // `slug` is nullable on a ProductSuggestion — fall back to the id,
+        // the same way the product cards do.
+        href: `/products/${product.slug || product.id}`,
+      });
+    }
+    for (const category of suggestions.categories) {
+      rows.push({
+        kind: 'category',
+        id: category.id,
+        label: category.name,
+        // CategorySuggestion carries no slug, so filter the listing by id.
+        href: `/products?category=${encodeURIComponent(category.id)}`,
+      });
+    }
+    return rows;
+  }, [suggestions]);
+
+  // A fresh result set invalidates whatever row was highlighted.
+  React.useEffect(() => {
+    setActiveIndex(-1);
+  }, [options]);
+
+  // Close when the click lands outside the widget. Pointerdown rather than
+  // click so the panel is gone before a link underneath activates.
+  React.useEffect(() => {
+    if (!open) return;
+    function onPointerDown(event: PointerEvent) {
+      if (!rootRef.current) return;
+      if (!rootRef.current.contains(event.target as Node)) setOpen(false);
+    }
+    document.addEventListener('pointerdown', onPointerDown);
+    return () => document.removeEventListener('pointerdown', onPointerDown);
+  }, [open]);
+
+  function go(href: string) {
+    setOpen(false);
+    setActiveIndex(-1);
+    router.push(href);
+  }
+
+  function submit() {
+    const trimmed = query.trim();
+    if (!trimmed) return;
+    go(`/products?search=${encodeURIComponent(trimmed)}`);
+  }
+
+  function handleKeyDown(event: React.KeyboardEvent<HTMLInputElement>) {
+    if (event.key === 'Escape') {
+      setOpen(false);
+      setActiveIndex(-1);
+      return;
+    }
+
+    if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+      if (options.length === 0) return;
+      event.preventDefault();
+      setOpen(true);
+      setActiveIndex((prev) => {
+        const step = event.key === 'ArrowDown' ? 1 : -1;
+        const next = prev + step;
+        if (next < 0) return options.length - 1;
+        if (next >= options.length) return 0;
+        return next;
+      });
+      return;
+    }
+
+    if (event.key === 'Enter') {
+      event.preventDefault();
+      const active = activeIndex >= 0 ? options[activeIndex] : undefined;
+      if (active) {
+        go(active.href);
+      } else {
+        submit();
+      }
+    }
+  }
+
+  // The panel is only worth showing once the hook has something to say —
+  // either rows, a spinner, or an explicit "nothing matched".
+  const showPanel = open && (loading || suggestions !== null);
+  const activeOptionId = activeIndex >= 0 ? `${listboxId}-${activeIndex}` : undefined;
+  const productCount = suggestions?.products.length ?? 0;
+
+  return (
+    <div ref={rootRef} className={cn('relative', className)}>
+      <form
+        role="search"
+        onSubmit={(event) => {
+          event.preventDefault();
+          submit();
+        }}
+      >
+        <label htmlFor={`${listboxId}-input`} className="sr-only">
+          {t('search')}
+        </label>
+        <div className="relative">
+          <Search
+            className="text-muted-foreground pointer-events-none absolute start-2.5 top-1/2 h-4 w-4 -translate-y-1/2"
+            aria-hidden="true"
+          />
+          <input
+            id={`${listboxId}-input`}
+            type="search"
+            role="combobox"
+            autoComplete="off"
+            aria-expanded={showPanel}
+            aria-controls={listboxId}
+            aria-activedescendant={activeOptionId}
+            placeholder={t('searchPlaceholder')}
+            value={query}
+            onChange={(event) => {
+              setQuery(event.target.value);
+              setOpen(true);
+            }}
+            onFocus={() => setOpen(true)}
+            onKeyDown={handleKeyDown}
+            className="border-border bg-background text-foreground placeholder:text-muted-foreground focus-visible:ring-primary h-9 w-full rounded-md border pe-3 ps-8 text-sm focus-visible:outline-none focus-visible:ring-2"
+          />
+        </div>
+      </form>
+
+      {showPanel && (
+        <div className="border-border bg-background absolute inset-x-0 top-full z-50 mt-2 overflow-hidden rounded-lg border shadow-lg">
+          {loading && options.length === 0 ? (
+            <p className="text-muted-foreground px-4 py-3 text-sm">{tc('loading')}</p>
+          ) : options.length === 0 ? (
+            <p className="text-muted-foreground px-4 py-3 text-sm">{tc('noResults')}</p>
+          ) : (
+            <ul
+              id={listboxId}
+              role="listbox"
+              aria-label={t('search')}
+              className="max-h-80 overflow-y-auto py-1"
+            >
+              {options.map((option, index) => (
+                <React.Fragment key={`${option.kind}-${option.id}`}>
+                  {index === 0 && productCount > 0 && (
+                    <li
+                      role="presentation"
+                      className="text-muted-foreground px-4 pb-1 pt-2 text-[11px] font-semibold uppercase tracking-wide"
+                    >
+                      {tp('pageTitle')}
+                    </li>
+                  )}
+                  {index === productCount && option.kind === 'category' && (
+                    <li
+                      role="presentation"
+                      className="text-muted-foreground px-4 pb-1 pt-2 text-[11px] font-semibold uppercase tracking-wide"
+                    >
+                      {t('categories')}
+                    </li>
+                  )}
+                  <li
+                    id={`${listboxId}-${index}`}
+                    role="option"
+                    aria-selected={index === activeIndex}
+                    className={cn(
+                      'cursor-pointer px-4 py-2 text-sm transition-colors',
+                      index === activeIndex
+                        ? 'bg-muted text-foreground'
+                        : 'text-foreground/80 hover:bg-muted/60'
+                    )}
+                    onPointerDown={(event) => {
+                      // Keep focus in the input so the blur handler cannot
+                      // close the panel before the navigation runs.
+                      event.preventDefault();
+                      go(option.href);
+                    }}
+                    onMouseEnter={() => setActiveIndex(index)}
+                  >
+                    {option.label}
+                  </li>
+                </React.Fragment>
+              ))}
+            </ul>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}

package/templates/nextjs/base/src/ui/layout/region-switcher.tsx

@@ -0,0 +1,59 @@
+'use client';
+
+/**
+ * Region / currency switcher.
+ *
+ * ⛔ RENDERS NOTHING on a single-region store, which is almost every store.
+ * `regions.length <= 1` returns null before any markup: an empty or
+ * one-option dropdown in the header is worse than no switcher at all, and the
+ * whole regions feature is meant to be invisible until a merchant actually
+ * adds a second region.
+ *
+ * ⛔ It also renders nothing when the regions call FAILED. A brand-new store
+ * is empty and the call can fail (channel not live yet, backend hiccup); the
+ * provider swallows that and leaves `regions` at `[]`, which lands in the same
+ * early return. There is no error box and no skeleton, because a shopper has
+ * no idea what a region is and nothing here is worth interrupting them for.
+ *
+ * Why a manual switcher exists at all when the edge already guesses: the guess
+ * is an IP, and an IP is wrong for travellers, expats, VPNs and anyone behind
+ * a corporate egress. The shopper is the authority on where they are, and
+ * their choice is stored in a cookie so the SERVER renders the same prices on
+ * the next navigation instead of the client re-pricing after hydration.
+ *
+ * The labels are store data (`region.name`, `region.currency`), not UI copy,
+ * so this component needs no translation keys in any locale.
+ */
+
+import { useRegion } from '@/core/providers/store-provider';
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from '@/components/ui/select';
+
+export function RegionSwitcher() {
+  const { regions, region, setRegion } = useRegion();
+
+  if (regions.length <= 1 || !region) return null;
+
+  return (
+    <Select value={region.id} onValueChange={setRegion}>
+      <SelectTrigger
+        className="h-8 w-auto gap-1 rounded border bg-transparent px-2 py-1 text-sm"
+        aria-label="Select region and currency"
+      >
+        <SelectValue />
+      </SelectTrigger>
+      <SelectContent>
+        {regions.map((r) => (
+          <SelectItem key={r.id} value={r.id}>
+            {r.name} ({r.currency})
+          </SelectItem>
+        ))}
+      </SelectContent>
+    </Select>
+  );
+}