create-brainerce-store 1.62.0 → 1.64.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (203) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +71 -71
  3. package/dist/index.js +26 -3
  4. package/messages/en.json +502 -502
  5. package/messages/he.json +502 -502
  6. package/package.json +1 -1
  7. package/templates/nextjs/base/.claude/commands/design.md +60 -60
  8. package/templates/nextjs/base/.env.local.ejs +24 -24
  9. package/templates/nextjs/base/.eslintrc.json +57 -57
  10. package/templates/nextjs/base/.mcp.json +8 -8
  11. package/templates/nextjs/base/AI-GUIDE.md +174 -174
  12. package/templates/nextjs/base/TRANSLATIONS.md +200 -200
  13. package/templates/nextjs/base/package.json.ejs +52 -52
  14. package/templates/nextjs/base/src/app/agents.md/route.ts +87 -0
  15. package/templates/nextjs/base/src/app/blog/[slug]/page.tsx.ejs +308 -262
  16. package/templates/nextjs/base/src/app/blog/page.tsx.ejs +276 -276
  17. package/templates/nextjs/base/src/app/blog/rss.xml/route.ts +70 -0
  18. package/templates/nextjs/base/src/app/cart/page.tsx +7 -7
  19. package/templates/nextjs/base/src/app/category/[slug]/page.tsx +29 -3
  20. package/templates/nextjs/base/src/app/checkout/page.tsx +12 -0
  21. package/templates/nextjs/base/src/app/contact/layout.tsx.ejs +14 -0
  22. package/templates/nextjs/base/src/app/globals.css +36 -36
  23. package/templates/nextjs/base/src/app/indexnow-key.txt/route.ts +26 -26
  24. package/templates/nextjs/base/src/app/layout.tsx.ejs +30 -0
  25. package/templates/nextjs/base/src/app/llms.txt/route.ts +28 -5
  26. package/templates/nextjs/base/src/app/not-found.tsx.ejs +35 -0
  27. package/templates/nextjs/base/src/app/opengraph-image.tsx +109 -0
  28. package/templates/nextjs/base/src/app/order-confirmation/page.tsx +295 -278
  29. package/templates/nextjs/base/src/app/order-status/page.tsx +121 -121
  30. package/templates/nextjs/base/src/app/page.tsx +64 -64
  31. package/templates/nextjs/base/src/app/products/[slug]/page.tsx +14 -2
  32. package/templates/nextjs/base/src/app/products/page.tsx +19 -19
  33. package/templates/nextjs/base/src/app/robots.ts +73 -14
  34. package/templates/nextjs/base/src/app/sitemap.ts +89 -66
  35. package/templates/nextjs/base/src/components/account/order-history.tsx +385 -385
  36. package/templates/nextjs/base/src/components/brainerce-bot.tsx +70 -70
  37. package/templates/nextjs/base/src/components/checkout/checkout-form.tsx +612 -612
  38. package/templates/nextjs/base/src/components/checkout/custom-fields-step.tsx +292 -292
  39. package/templates/nextjs/base/src/components/checkout/date-picker.tsx +309 -309
  40. package/templates/nextjs/base/src/components/checkout/datetime-picker.tsx +144 -144
  41. package/templates/nextjs/base/src/components/checkout/order-bump-card.tsx +242 -242
  42. package/templates/nextjs/base/src/components/checkout/pickup-step.tsx +198 -198
  43. package/templates/nextjs/base/src/components/checkout/shipping-step.tsx +125 -125
  44. package/templates/nextjs/base/src/components/checkout/tax-display.tsx +74 -74
  45. package/templates/nextjs/base/src/components/seo/article-json-ld.tsx +59 -59
  46. package/templates/nextjs/base/src/components/seo/breadcrumbs.tsx +37 -37
  47. package/templates/nextjs/base/src/components/seo/category-json-ld.tsx +61 -61
  48. package/templates/nextjs/base/src/components/seo/organization-json-ld.tsx +97 -97
  49. package/templates/nextjs/base/src/components/seo/product-json-ld.tsx +23 -131
  50. package/templates/nextjs/base/src/components/tracking-bootstrap.tsx +62 -0
  51. package/templates/nextjs/base/src/components/ui/accordion.tsx +53 -53
  52. package/templates/nextjs/base/src/components/ui/badge.tsx +32 -32
  53. package/templates/nextjs/base/src/components/ui/button.tsx +49 -49
  54. package/templates/nextjs/base/src/components/ui/card.tsx +55 -55
  55. package/templates/nextjs/base/src/components/ui/checkbox.tsx +28 -28
  56. package/templates/nextjs/base/src/components/ui/dialog.tsx +107 -107
  57. package/templates/nextjs/base/src/components/ui/input.tsx +22 -22
  58. package/templates/nextjs/base/src/components/ui/label.tsx +21 -21
  59. package/templates/nextjs/base/src/components/ui/radio-group.tsx +38 -38
  60. package/templates/nextjs/base/src/components/ui/select.tsx +153 -153
  61. package/templates/nextjs/base/src/components/ui/separator.tsx +26 -26
  62. package/templates/nextjs/base/src/components/ui/sheet.tsx +125 -125
  63. package/templates/nextjs/base/src/components/ui/skeleton.tsx +7 -7
  64. package/templates/nextjs/base/src/components/ui/tabs.tsx +55 -55
  65. package/templates/nextjs/base/src/components/ui/textarea.tsx +21 -21
  66. package/templates/nextjs/base/src/components/ui/tooltip.tsx +32 -32
  67. package/templates/nextjs/base/src/core/hooks/use-cart-page.ts +58 -58
  68. package/templates/nextjs/base/src/core/hooks/use-home-data.ts +51 -51
  69. package/templates/nextjs/base/src/core/hooks/use-product-listing.ts +295 -295
  70. package/templates/nextjs/base/src/core/hooks/use-product-page.ts +20 -2
  71. package/templates/nextjs/base/src/core/lib/image-hosts.ts +7 -7
  72. package/templates/nextjs/base/src/core/lib/product-options.ts +121 -121
  73. package/templates/nextjs/base/src/core/lib/resolve-currency.ts +20 -20
  74. package/templates/nextjs/base/src/core/lib/safe-redirect.ts +38 -38
  75. package/templates/nextjs/base/src/core/lib/seo.ts +46 -46
  76. package/templates/nextjs/base/src/core/lib/store-info.ts +17 -0
  77. package/templates/nextjs/base/src/core/lib/tracking.ts +171 -0
  78. package/templates/nextjs/base/src/core/lib/use-currency.ts +19 -19
  79. package/templates/nextjs/base/src/core/lib/utils.ts +21 -21
  80. package/templates/nextjs/base/src/middleware.ts.ejs +54 -2
  81. package/templates/nextjs/base/src/ui/cart/cart-bundle-offer.tsx +117 -117
  82. package/templates/nextjs/base/src/ui/cart/cart-item.tsx +146 -146
  83. package/templates/nextjs/base/src/ui/cart/cart-nudges.tsx +28 -28
  84. package/templates/nextjs/base/src/ui/cart/cart-summary.tsx +110 -110
  85. package/templates/nextjs/base/src/ui/cart/cart-upgrade-banner.tsx +126 -126
  86. package/templates/nextjs/base/src/ui/cart/cart-view.tsx +140 -140
  87. package/templates/nextjs/base/src/ui/cart/coupon-input.tsx +134 -134
  88. package/templates/nextjs/base/src/ui/cart/free-shipping-bar.tsx +61 -61
  89. package/templates/nextjs/base/src/ui/cart/reservation-countdown.tsx +95 -95
  90. package/templates/nextjs/base/src/ui/home/discount-banner-strip.tsx +22 -20
  91. package/templates/nextjs/base/src/ui/home/featured-products-section.tsx +24 -24
  92. package/templates/nextjs/base/src/ui/home/hero-section.tsx +27 -27
  93. package/templates/nextjs/base/src/ui/home/home-client.tsx +29 -29
  94. package/templates/nextjs/base/src/ui/layout/announcement-bar.tsx.ejs +116 -116
  95. package/templates/nextjs/base/src/ui/layout/faq-section.tsx.ejs +90 -90
  96. package/templates/nextjs/base/src/ui/layout/header-account.tsx +40 -40
  97. package/templates/nextjs/base/src/ui/layout/language-switcher.tsx.ejs +80 -80
  98. package/templates/nextjs/base/src/ui/layout/site-footer.tsx.ejs +144 -144
  99. package/templates/nextjs/base/src/ui/layout/site-header.tsx.ejs +152 -152
  100. package/templates/nextjs/base/src/ui/product/customization-fields.tsx +457 -457
  101. package/templates/nextjs/base/src/ui/product/discount-badge.tsx +18 -18
  102. package/templates/nextjs/base/src/ui/product/frequently-bought-together.tsx +191 -191
  103. package/templates/nextjs/base/src/ui/product/modifier-group-selector.tsx +206 -206
  104. package/templates/nextjs/base/src/ui/product/price-display.tsx +62 -62
  105. package/templates/nextjs/base/src/ui/product/product-card.tsx +7 -2
  106. package/templates/nextjs/base/src/ui/product/product-client-section.tsx +455 -455
  107. package/templates/nextjs/base/src/ui/product/product-listing.tsx +446 -446
  108. package/templates/nextjs/base/src/ui/product/recommendation-section.tsx +102 -102
  109. package/templates/nextjs/base/src/ui/product/review-form.tsx +294 -294
  110. package/templates/nextjs/base/src/ui/product/reviews-section.tsx.ejs +108 -108
  111. package/templates/nextjs/base/src/ui/product/stock-badge.tsx +61 -61
  112. package/templates/nextjs/base/src/ui/product/variant-selector.tsx +291 -291
  113. package/templates/nextjs/base/src/ui/shared/cdn-image.tsx +26 -26
  114. package/templates/nextjs/base/tailwind.config.ts +69 -69
  115. package/templates/nextjs/designs/atelier/app-overlay/layout.tsx.ejs +30 -0
  116. package/templates/nextjs/designs/atelier/globals.css +402 -402
  117. package/templates/nextjs/designs/atelier/messages-patch/en.json +100 -100
  118. package/templates/nextjs/designs/atelier/messages-patch/he.json +100 -100
  119. package/templates/nextjs/designs/atelier/ui/cart/cart-bundle-offer.tsx +110 -110
  120. package/templates/nextjs/designs/atelier/ui/cart/cart-drawer.tsx +163 -163
  121. package/templates/nextjs/designs/atelier/ui/cart/cart-item.tsx +140 -140
  122. package/templates/nextjs/designs/atelier/ui/cart/cart-nudges.tsx +34 -34
  123. package/templates/nextjs/designs/atelier/ui/cart/cart-summary.tsx +107 -107
  124. package/templates/nextjs/designs/atelier/ui/cart/cart-upgrade-banner.tsx +123 -123
  125. package/templates/nextjs/designs/atelier/ui/cart/cart-view.tsx +147 -147
  126. package/templates/nextjs/designs/atelier/ui/cart/coupon-input.tsx +142 -142
  127. package/templates/nextjs/designs/atelier/ui/cart/free-shipping-bar.tsx +77 -77
  128. package/templates/nextjs/designs/atelier/ui/cart/reservation-countdown.tsx +89 -89
  129. package/templates/nextjs/designs/atelier/ui/home/benefits-band.tsx +34 -34
  130. package/templates/nextjs/designs/atelier/ui/home/category-tiles.tsx +151 -151
  131. package/templates/nextjs/designs/atelier/ui/home/discount-banner-strip.tsx +27 -27
  132. package/templates/nextjs/designs/atelier/ui/home/editorial-band.tsx +75 -75
  133. package/templates/nextjs/designs/atelier/ui/home/featured-products-section.tsx +36 -36
  134. package/templates/nextjs/designs/atelier/ui/home/hero-section.tsx +174 -174
  135. package/templates/nextjs/designs/atelier/ui/home/home-client.tsx +54 -54
  136. package/templates/nextjs/designs/atelier/ui/home/newsletter-section.tsx +78 -78
  137. package/templates/nextjs/designs/atelier/ui/home/testimonials-band.tsx +46 -46
  138. package/templates/nextjs/designs/atelier/ui/layout/announcement-bar.tsx +118 -118
  139. package/templates/nextjs/designs/atelier/ui/layout/faq-section.tsx +96 -96
  140. package/templates/nextjs/designs/atelier/ui/layout/header-account.tsx +36 -36
  141. package/templates/nextjs/designs/atelier/ui/layout/header-cart.tsx +36 -36
  142. package/templates/nextjs/designs/atelier/ui/layout/language-switcher.tsx.ejs +137 -137
  143. package/templates/nextjs/designs/atelier/ui/layout/nav-url.ts +14 -14
  144. package/templates/nextjs/designs/atelier/ui/layout/rich-text-block.tsx +34 -34
  145. package/templates/nextjs/designs/atelier/ui/layout/site-footer.tsx.ejs +141 -141
  146. package/templates/nextjs/designs/atelier/ui/layout/site-header.tsx.ejs +138 -138
  147. package/templates/nextjs/designs/atelier/ui/product/customization-fields.tsx +466 -466
  148. package/templates/nextjs/designs/atelier/ui/product/discount-badge.tsx +17 -17
  149. package/templates/nextjs/designs/atelier/ui/product/frequently-bought-together.tsx +196 -196
  150. package/templates/nextjs/designs/atelier/ui/product/modifier-group-selector.tsx +193 -193
  151. package/templates/nextjs/designs/atelier/ui/product/price-display.tsx +69 -69
  152. package/templates/nextjs/designs/atelier/ui/product/product-card.tsx +13 -11
  153. package/templates/nextjs/designs/atelier/ui/product/product-client-section.tsx +477 -477
  154. package/templates/nextjs/designs/atelier/ui/product/product-grid.tsx +42 -42
  155. package/templates/nextjs/designs/atelier/ui/product/product-listing.tsx +260 -260
  156. package/templates/nextjs/designs/atelier/ui/product/recommendation-section.tsx +95 -95
  157. package/templates/nextjs/designs/atelier/ui/product/review-form.tsx +267 -267
  158. package/templates/nextjs/designs/atelier/ui/product/reviews-section.tsx.ejs +148 -148
  159. package/templates/nextjs/designs/atelier/ui/product/stock-badge.tsx +66 -66
  160. package/templates/nextjs/designs/atelier/ui/product/variant-selector.tsx +206 -206
  161. package/templates/nextjs/designs/atelier/ui/shared/cdn-image.tsx +29 -29
  162. package/templates/nextjs/designs/atelier/ui/shared/fly-to-cart.ts +86 -86
  163. package/templates/nextjs/designs/atelier/ui/shared/icons.tsx +276 -276
  164. package/templates/nextjs/designs/atelier/ui/shared/loading-spinner.tsx +63 -63
  165. package/templates/nextjs/designs/atelier/ui/shared/reveal.tsx +71 -71
  166. package/templates/nextjs/designs/atelier/ui/shared/select-menu.tsx +125 -125
  167. package/templates/nextjs/ui-canvas/cart/cart-bundle-offer.tsx +89 -89
  168. package/templates/nextjs/ui-canvas/cart/cart-item.tsx +123 -123
  169. package/templates/nextjs/ui-canvas/cart/cart-nudges.tsx +29 -27
  170. package/templates/nextjs/ui-canvas/cart/cart-summary.tsx +99 -99
  171. package/templates/nextjs/ui-canvas/cart/cart-upgrade-banner.tsx +105 -105
  172. package/templates/nextjs/ui-canvas/cart/cart-view.tsx +106 -106
  173. package/templates/nextjs/ui-canvas/cart/coupon-input.tsx +119 -119
  174. package/templates/nextjs/ui-canvas/cart/free-shipping-bar.tsx +54 -54
  175. package/templates/nextjs/ui-canvas/cart/reservation-countdown.tsx +81 -81
  176. package/templates/nextjs/ui-canvas/home/discount-banner-strip.tsx +21 -19
  177. package/templates/nextjs/ui-canvas/home/featured-products-section.tsx +23 -23
  178. package/templates/nextjs/ui-canvas/home/hero-section.tsx +21 -21
  179. package/templates/nextjs/ui-canvas/home/home-client.tsx +26 -26
  180. package/templates/nextjs/ui-canvas/layout/announcement-bar.tsx.ejs +101 -101
  181. package/templates/nextjs/ui-canvas/layout/faq-section.tsx.ejs +71 -71
  182. package/templates/nextjs/ui-canvas/layout/header-account.tsx +31 -31
  183. package/templates/nextjs/ui-canvas/layout/language-switcher.tsx.ejs +76 -76
  184. package/templates/nextjs/ui-canvas/layout/rich-text-block.tsx.ejs +36 -36
  185. package/templates/nextjs/ui-canvas/layout/site-footer.tsx.ejs +82 -82
  186. package/templates/nextjs/ui-canvas/layout/site-header.tsx.ejs +119 -119
  187. package/templates/nextjs/ui-canvas/product/customization-fields.tsx +445 -445
  188. package/templates/nextjs/ui-canvas/product/discount-badge.tsx +19 -19
  189. package/templates/nextjs/ui-canvas/product/frequently-bought-together.tsx +168 -168
  190. package/templates/nextjs/ui-canvas/product/modifier-group-selector.tsx +165 -165
  191. package/templates/nextjs/ui-canvas/product/price-display.tsx +52 -52
  192. package/templates/nextjs/ui-canvas/product/product-card.tsx +7 -2
  193. package/templates/nextjs/ui-canvas/product/product-client-section.tsx +352 -352
  194. package/templates/nextjs/ui-canvas/product/product-grid.tsx +27 -27
  195. package/templates/nextjs/ui-canvas/product/product-listing.tsx +224 -224
  196. package/templates/nextjs/ui-canvas/product/recommendation-section.tsx +99 -99
  197. package/templates/nextjs/ui-canvas/product/review-form.tsx +266 -266
  198. package/templates/nextjs/ui-canvas/product/reviews-section.tsx.ejs +96 -96
  199. package/templates/nextjs/ui-canvas/product/stock-badge.tsx +45 -45
  200. package/templates/nextjs/ui-canvas/product/variant-selector.tsx +212 -212
  201. package/templates/nextjs/ui-canvas/shared/cdn-image.tsx +31 -31
  202. package/templates/nextjs/ui-canvas/shared/loading-spinner.tsx +27 -27
  203. package/templates/nextjs/base/tsconfig.tsbuildinfo +0 -1
@@ -1,148 +1,148 @@
1
- import type { ProductReview } from 'brainerce';
2
- import { getServerClient } from '@/core/lib/brainerce';
3
- <% if (i18nEnabled) { %>
4
- import { getMessages, defaultLocale } from '@/i18n';
5
- <% } else { %>
6
- import { messages as staticMessages, defaultLocale } from '@/i18n';
7
- <% } %>
8
- import { ReviewForm } from './review-form';
9
- import { IconStar } from '@/ui/shared/icons';
10
-
11
- // Server component — it renders before any client i18n context exists, so the
12
- // wrapper strings (title / empty state / verified badge) are read straight
13
- // from the `reviews` namespace in messages/, keyed by the store locale.
14
- type ReviewStrings = Record<string, string>;
15
-
16
- async function getReviewStrings(locale: string): Promise<ReviewStrings> {
17
- <% if (i18nEnabled) { %>
18
- return ((await getMessages(locale)).reviews ?? {}) as ReviewStrings;
19
- <% } else { %>
20
- return (staticMessages.reviews ?? {}) as ReviewStrings;
21
- <% } %>
22
- }
23
-
24
- interface ReviewsSectionProps {
25
- productId: string;
26
- initialReviews?: ProductReview[];
27
- locale?: string;
28
- /** Where to send users back to after submit (defaults to the current product URL). */
29
- returnUrl?: string;
30
- }
31
-
32
- /**
33
- * Renders the visible reviews for a product plus a submit form.
34
- *
35
- * Server component — fetches with the SDK on the server so reviews are in
36
- * the initial HTML payload (good for SEO; JSON-LD on the same page already
37
- * carries `aggregateRating` when reviewCount > 0).
38
- */
39
- export async function ReviewsSection({
40
- productId,
41
- initialReviews,
42
- locale = defaultLocale,
43
- }: ReviewsSectionProps) {
44
- const t = await getReviewStrings(locale);
45
- let reviews: ProductReview[] = initialReviews ?? [];
46
-
47
- if (!initialReviews) {
48
- try {
49
- const result = await getServerClient().listProductReviews(productId, { page: 1, limit: 20 });
50
- reviews = result.data;
51
- } catch {
52
- // Review listing disabled at store level or network error — render the form anyway.
53
- reviews = [];
54
- }
55
- }
56
-
57
- const avg =
58
- reviews.length > 0
59
- ? Math.round((reviews.reduce((s, r) => s + r.rating, 0) / reviews.length) * 10) / 10
60
- : null;
61
-
62
- return (
63
- <section aria-labelledby="reviews-heading" className="border-t bg-secondary/40">
64
- <div className="container-narrow grid gap-10 py-14 lg:grid-cols-3 lg:py-16">
65
- {/* Summary column */}
66
- <div>
67
- <h2 id="reviews-heading" className="text-2xl sm:text-3xl">
68
- {t.title}
69
- </h2>
70
- {avg !== null && (
71
- <p className="mt-4 flex items-center gap-3">
72
- <span className="font-display text-4xl text-foreground">{avg}</span>
73
- <span className="inline-flex flex-col gap-1">
74
- <Stars rating={Math.round(avg)} />
75
- <span className="text-xs text-muted-foreground">
76
- ({reviews.length})
77
- </span>
78
- </span>
79
- </p>
80
- )}
81
-
82
- {/* Submit / edit form */}
83
- <div className="card mt-6 p-5">
84
- <ReviewForm productId={productId} />
85
- </div>
86
- </div>
87
-
88
- {/* Review list */}
89
- <div className="lg:col-span-2">
90
- {reviews.length === 0 ? (
91
- <div className="card flex h-full min-h-40 flex-col items-center justify-center gap-2 p-8 text-center">
92
- <Stars rating={0} />
93
- <p className="font-medium text-foreground">{t.beFirst ?? t.noReviews}</p>
94
- <p className="text-sm text-muted-foreground">{t.noReviews}</p>
95
- </div>
96
- ) : (
97
- <ul className="space-y-4">
98
- {reviews.map((review) => (
99
- <ReviewCard key={review.id} review={review} verifiedLabel={t.verifiedPurchase} />
100
- ))}
101
- </ul>
102
- )}
103
- </div>
104
- </div>
105
- </section>
106
- );
107
- }
108
-
109
- function ReviewCard({ review, verifiedLabel }: { review: ProductReview; verifiedLabel: string }) {
110
- return (
111
- <li>
112
- <article className="card p-5">
113
- <header className="flex flex-wrap items-center gap-x-3 gap-y-1.5">
114
- <Stars rating={review.rating} />
115
- <span className="text-sm font-semibold text-foreground">{review.authorName}</span>
116
- {review.verifiedPurchase && <span className="badge-soft">{verifiedLabel}</span>}
117
- <time
118
- dateTime={review.createdAt}
119
- className="ms-auto text-xs text-muted-foreground"
120
- >
121
- {new Date(review.createdAt).toLocaleDateString()}
122
- </time>
123
- </header>
124
- {review.body && (
125
- <p className="mt-3 whitespace-pre-line break-words text-sm leading-6 text-foreground">
126
- {review.body}
127
- </p>
128
- )}
129
- </article>
130
- </li>
131
- );
132
- }
133
-
134
- function Stars({ rating }: { rating: number }) {
135
- return (
136
- <span aria-label={`${rating} of 5 stars`} className="inline-flex gap-0.5">
137
- {[1, 2, 3, 4, 5].map((n) => (
138
- <span
139
- key={n}
140
- aria-hidden="true"
141
- className={n <= rating ? 'text-primary' : 'text-border'}
142
- >
143
- <IconStar size={16} filled={n <= rating} />
144
- </span>
145
- ))}
146
- </span>
147
- );
148
- }
1
+ import type { ProductReview } from 'brainerce';
2
+ import { getServerClient } from '@/core/lib/brainerce';
3
+ <% if (i18nEnabled) { %>
4
+ import { getMessages, defaultLocale } from '@/i18n';
5
+ <% } else { %>
6
+ import { messages as staticMessages, defaultLocale } from '@/i18n';
7
+ <% } %>
8
+ import { ReviewForm } from './review-form';
9
+ import { IconStar } from '@/ui/shared/icons';
10
+
11
+ // Server component — it renders before any client i18n context exists, so the
12
+ // wrapper strings (title / empty state / verified badge) are read straight
13
+ // from the `reviews` namespace in messages/, keyed by the store locale.
14
+ type ReviewStrings = Record<string, string>;
15
+
16
+ async function getReviewStrings(locale: string): Promise<ReviewStrings> {
17
+ <% if (i18nEnabled) { %>
18
+ return ((await getMessages(locale)).reviews ?? {}) as ReviewStrings;
19
+ <% } else { %>
20
+ return (staticMessages.reviews ?? {}) as ReviewStrings;
21
+ <% } %>
22
+ }
23
+
24
+ interface ReviewsSectionProps {
25
+ productId: string;
26
+ initialReviews?: ProductReview[];
27
+ locale?: string;
28
+ /** Where to send users back to after submit (defaults to the current product URL). */
29
+ returnUrl?: string;
30
+ }
31
+
32
+ /**
33
+ * Renders the visible reviews for a product plus a submit form.
34
+ *
35
+ * Server component — fetches with the SDK on the server so reviews are in
36
+ * the initial HTML payload (good for SEO; JSON-LD on the same page already
37
+ * carries `aggregateRating` when reviewCount > 0).
38
+ */
39
+ export async function ReviewsSection({
40
+ productId,
41
+ initialReviews,
42
+ locale = defaultLocale,
43
+ }: ReviewsSectionProps) {
44
+ const t = await getReviewStrings(locale);
45
+ let reviews: ProductReview[] = initialReviews ?? [];
46
+
47
+ if (!initialReviews) {
48
+ try {
49
+ const result = await getServerClient().listProductReviews(productId, { page: 1, limit: 20 });
50
+ reviews = result.data;
51
+ } catch {
52
+ // Review listing disabled at store level or network error — render the form anyway.
53
+ reviews = [];
54
+ }
55
+ }
56
+
57
+ const avg =
58
+ reviews.length > 0
59
+ ? Math.round((reviews.reduce((s, r) => s + r.rating, 0) / reviews.length) * 10) / 10
60
+ : null;
61
+
62
+ return (
63
+ <section aria-labelledby="reviews-heading" className="border-t bg-secondary/40">
64
+ <div className="container-narrow grid gap-10 py-14 lg:grid-cols-3 lg:py-16">
65
+ {/* Summary column */}
66
+ <div>
67
+ <h2 id="reviews-heading" className="text-2xl sm:text-3xl">
68
+ {t.title}
69
+ </h2>
70
+ {avg !== null && (
71
+ <p className="mt-4 flex items-center gap-3">
72
+ <span className="font-display text-4xl text-foreground">{avg}</span>
73
+ <span className="inline-flex flex-col gap-1">
74
+ <Stars rating={Math.round(avg)} />
75
+ <span className="text-xs text-muted-foreground">
76
+ ({reviews.length})
77
+ </span>
78
+ </span>
79
+ </p>
80
+ )}
81
+
82
+ {/* Submit / edit form */}
83
+ <div className="card mt-6 p-5">
84
+ <ReviewForm productId={productId} />
85
+ </div>
86
+ </div>
87
+
88
+ {/* Review list */}
89
+ <div className="lg:col-span-2">
90
+ {reviews.length === 0 ? (
91
+ <div className="card flex h-full min-h-40 flex-col items-center justify-center gap-2 p-8 text-center">
92
+ <Stars rating={0} />
93
+ <p className="font-medium text-foreground">{t.beFirst ?? t.noReviews}</p>
94
+ <p className="text-sm text-muted-foreground">{t.noReviews}</p>
95
+ </div>
96
+ ) : (
97
+ <ul className="space-y-4">
98
+ {reviews.map((review) => (
99
+ <ReviewCard key={review.id} review={review} verifiedLabel={t.verifiedPurchase} />
100
+ ))}
101
+ </ul>
102
+ )}
103
+ </div>
104
+ </div>
105
+ </section>
106
+ );
107
+ }
108
+
109
+ function ReviewCard({ review, verifiedLabel }: { review: ProductReview; verifiedLabel: string }) {
110
+ return (
111
+ <li>
112
+ <article className="card p-5">
113
+ <header className="flex flex-wrap items-center gap-x-3 gap-y-1.5">
114
+ <Stars rating={review.rating} />
115
+ <span className="text-sm font-semibold text-foreground">{review.authorName}</span>
116
+ {review.verifiedPurchase && <span className="badge-soft">{verifiedLabel}</span>}
117
+ <time
118
+ dateTime={review.createdAt}
119
+ className="ms-auto text-xs text-muted-foreground"
120
+ >
121
+ {new Date(review.createdAt).toLocaleDateString()}
122
+ </time>
123
+ </header>
124
+ {review.body && (
125
+ <p className="mt-3 whitespace-pre-line break-words text-sm leading-6 text-foreground">
126
+ {review.body}
127
+ </p>
128
+ )}
129
+ </article>
130
+ </li>
131
+ );
132
+ }
133
+
134
+ function Stars({ rating }: { rating: number }) {
135
+ return (
136
+ <span aria-label={`${rating} of 5 stars`} className="inline-flex gap-0.5">
137
+ {[1, 2, 3, 4, 5].map((n) => (
138
+ <span
139
+ key={n}
140
+ aria-hidden="true"
141
+ className={n <= rating ? 'text-primary' : 'text-border'}
142
+ >
143
+ <IconStar size={16} filled={n <= rating} />
144
+ </span>
145
+ ))}
146
+ </span>
147
+ );
148
+ }
@@ -1,66 +1,66 @@
1
- 'use client';
2
-
3
- import type { InventoryInfo } from 'brainerce';
4
- import { cn } from '@/core/lib/utils';
5
- import { useTranslations } from '@/core/lib/translations';
6
-
7
- interface StockBadgeProps {
8
- inventory: InventoryInfo | null | undefined;
9
- lowStockThreshold?: number;
10
- className?: string;
11
- }
12
-
13
- type StockState = 'in' | 'low' | 'out';
14
-
15
- /**
16
- * Stock status pill (in stock / low stock / out of stock) with a colored
17
- * status dot; derives the label from the product/variant `inventory` prop.
18
- */
19
- export function StockBadge({ inventory, lowStockThreshold = 5, className }: StockBadgeProps) {
20
- const t = useTranslations('productDetail');
21
- const { label, state } = getStock(inventory, lowStockThreshold, t);
22
-
23
- return (
24
- <span
25
- data-state={state}
26
- className={cn(
27
- 'inline-flex items-center gap-1.5 text-xs font-medium',
28
- state === 'in' && 'text-primary',
29
- state === 'low' && 'text-foreground',
30
- state === 'out' && 'text-destructive',
31
- className
32
- )}
33
- >
34
- <span
35
- aria-hidden="true"
36
- className={cn(
37
- 'inline-block h-1.5 w-1.5 rounded-full',
38
- state === 'in' && 'bg-primary',
39
- state === 'low' && 'bg-foreground/60',
40
- state === 'out' && 'bg-destructive'
41
- )}
42
- />
43
- {label}
44
- </span>
45
- );
46
- }
47
-
48
- function getStock(
49
- inventory: InventoryInfo | null | undefined,
50
- lowStockThreshold: number,
51
- t: (key: string) => string
52
- ): { label: string; state: StockState } {
53
- if (!inventory) return { label: t('outOfStock'), state: 'out' };
54
-
55
- const { trackingMode, inStock, available } = inventory;
56
-
57
- if (trackingMode === 'DISABLED') return { label: t('unavailable'), state: 'out' };
58
- if (!inStock) return { label: t('outOfStock'), state: 'out' };
59
- if (trackingMode === 'UNLIMITED') return { label: t('inStock'), state: 'in' };
60
-
61
- // TRACKED — show actual quantity
62
- if (available <= lowStockThreshold) {
63
- return { label: t('onlyLeft').replace('{available}', String(available)), state: 'low' };
64
- }
65
- return { label: t('availableInStock').replace('{available}', String(available)), state: 'in' };
66
- }
1
+ 'use client';
2
+
3
+ import type { InventoryInfo } from 'brainerce';
4
+ import { cn } from '@/core/lib/utils';
5
+ import { useTranslations } from '@/core/lib/translations';
6
+
7
+ interface StockBadgeProps {
8
+ inventory: InventoryInfo | null | undefined;
9
+ lowStockThreshold?: number;
10
+ className?: string;
11
+ }
12
+
13
+ type StockState = 'in' | 'low' | 'out';
14
+
15
+ /**
16
+ * Stock status pill (in stock / low stock / out of stock) with a colored
17
+ * status dot; derives the label from the product/variant `inventory` prop.
18
+ */
19
+ export function StockBadge({ inventory, lowStockThreshold = 5, className }: StockBadgeProps) {
20
+ const t = useTranslations('productDetail');
21
+ const { label, state } = getStock(inventory, lowStockThreshold, t);
22
+
23
+ return (
24
+ <span
25
+ data-state={state}
26
+ className={cn(
27
+ 'inline-flex items-center gap-1.5 text-xs font-medium',
28
+ state === 'in' && 'text-primary',
29
+ state === 'low' && 'text-foreground',
30
+ state === 'out' && 'text-destructive',
31
+ className
32
+ )}
33
+ >
34
+ <span
35
+ aria-hidden="true"
36
+ className={cn(
37
+ 'inline-block h-1.5 w-1.5 rounded-full',
38
+ state === 'in' && 'bg-primary',
39
+ state === 'low' && 'bg-foreground/60',
40
+ state === 'out' && 'bg-destructive'
41
+ )}
42
+ />
43
+ {label}
44
+ </span>
45
+ );
46
+ }
47
+
48
+ function getStock(
49
+ inventory: InventoryInfo | null | undefined,
50
+ lowStockThreshold: number,
51
+ t: (key: string) => string
52
+ ): { label: string; state: StockState } {
53
+ if (!inventory) return { label: t('outOfStock'), state: 'out' };
54
+
55
+ const { trackingMode, inStock, available } = inventory;
56
+
57
+ if (trackingMode === 'DISABLED') return { label: t('unavailable'), state: 'out' };
58
+ if (!inStock) return { label: t('outOfStock'), state: 'out' };
59
+ if (trackingMode === 'UNLIMITED') return { label: t('inStock'), state: 'in' };
60
+
61
+ // TRACKED — show actual quantity
62
+ if (available <= lowStockThreshold) {
63
+ return { label: t('onlyLeft').replace('{available}', String(available)), state: 'low' };
64
+ }
65
+ return { label: t('availableInStock').replace('{available}', String(available)), state: 'in' };
66
+ }