create-brainerce-store 1.61.0 → 1.63.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 (196) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +71 -71
  3. package/dist/index.js +10 -2
  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/blog/[slug]/page.tsx.ejs +262 -262
  15. package/templates/nextjs/base/src/app/blog/page.tsx.ejs +276 -276
  16. package/templates/nextjs/base/src/app/cart/page.tsx +7 -7
  17. package/templates/nextjs/base/src/app/category/[slug]/page.tsx +106 -106
  18. package/templates/nextjs/base/src/app/checkout/page.tsx +12 -0
  19. package/templates/nextjs/base/src/app/globals.css +36 -36
  20. package/templates/nextjs/base/src/app/indexnow-key.txt/route.ts +26 -26
  21. package/templates/nextjs/base/src/app/layout.tsx.ejs +10 -0
  22. package/templates/nextjs/base/src/app/llms.txt/route.ts +44 -44
  23. package/templates/nextjs/base/src/app/order-confirmation/page.tsx +295 -278
  24. package/templates/nextjs/base/src/app/order-status/page.tsx +121 -121
  25. package/templates/nextjs/base/src/app/page.tsx +64 -64
  26. package/templates/nextjs/base/src/app/products/[slug]/page.tsx +175 -175
  27. package/templates/nextjs/base/src/app/products/page.tsx +19 -19
  28. package/templates/nextjs/base/src/components/account/order-history.tsx +385 -385
  29. package/templates/nextjs/base/src/components/brainerce-bot.tsx +70 -70
  30. package/templates/nextjs/base/src/components/checkout/checkout-form.tsx +612 -564
  31. package/templates/nextjs/base/src/components/checkout/custom-fields-step.tsx +292 -292
  32. package/templates/nextjs/base/src/components/checkout/date-picker.tsx +309 -309
  33. package/templates/nextjs/base/src/components/checkout/datetime-picker.tsx +144 -144
  34. package/templates/nextjs/base/src/components/checkout/order-bump-card.tsx +242 -242
  35. package/templates/nextjs/base/src/components/checkout/pickup-step.tsx +198 -198
  36. package/templates/nextjs/base/src/components/checkout/shipping-step.tsx +125 -125
  37. package/templates/nextjs/base/src/components/checkout/tax-display.tsx +74 -74
  38. package/templates/nextjs/base/src/components/seo/article-json-ld.tsx +59 -59
  39. package/templates/nextjs/base/src/components/seo/breadcrumbs.tsx +37 -37
  40. package/templates/nextjs/base/src/components/seo/category-json-ld.tsx +61 -61
  41. package/templates/nextjs/base/src/components/seo/organization-json-ld.tsx +97 -97
  42. package/templates/nextjs/base/src/components/seo/product-json-ld.tsx +179 -179
  43. package/templates/nextjs/base/src/components/tracking-bootstrap.tsx +62 -0
  44. package/templates/nextjs/base/src/components/ui/accordion.tsx +53 -53
  45. package/templates/nextjs/base/src/components/ui/badge.tsx +32 -32
  46. package/templates/nextjs/base/src/components/ui/button.tsx +49 -49
  47. package/templates/nextjs/base/src/components/ui/card.tsx +55 -55
  48. package/templates/nextjs/base/src/components/ui/checkbox.tsx +28 -28
  49. package/templates/nextjs/base/src/components/ui/dialog.tsx +107 -107
  50. package/templates/nextjs/base/src/components/ui/input.tsx +22 -22
  51. package/templates/nextjs/base/src/components/ui/label.tsx +21 -21
  52. package/templates/nextjs/base/src/components/ui/radio-group.tsx +38 -38
  53. package/templates/nextjs/base/src/components/ui/select.tsx +153 -153
  54. package/templates/nextjs/base/src/components/ui/separator.tsx +26 -26
  55. package/templates/nextjs/base/src/components/ui/sheet.tsx +125 -125
  56. package/templates/nextjs/base/src/components/ui/skeleton.tsx +7 -7
  57. package/templates/nextjs/base/src/components/ui/tabs.tsx +55 -55
  58. package/templates/nextjs/base/src/components/ui/textarea.tsx +21 -21
  59. package/templates/nextjs/base/src/components/ui/tooltip.tsx +32 -32
  60. package/templates/nextjs/base/src/core/hooks/use-cart-page.ts +58 -58
  61. package/templates/nextjs/base/src/core/hooks/use-home-data.ts +51 -51
  62. package/templates/nextjs/base/src/core/hooks/use-product-listing.ts +295 -295
  63. package/templates/nextjs/base/src/core/hooks/use-product-page.ts +20 -2
  64. package/templates/nextjs/base/src/core/lib/image-hosts.ts +7 -7
  65. package/templates/nextjs/base/src/core/lib/product-options.ts +121 -121
  66. package/templates/nextjs/base/src/core/lib/resolve-currency.ts +20 -20
  67. package/templates/nextjs/base/src/core/lib/safe-redirect.ts +38 -38
  68. package/templates/nextjs/base/src/core/lib/seo.ts +46 -46
  69. package/templates/nextjs/base/src/core/lib/store-info.ts +9 -0
  70. package/templates/nextjs/base/src/core/lib/tracking.ts +171 -0
  71. package/templates/nextjs/base/src/core/lib/use-currency.ts +19 -19
  72. package/templates/nextjs/base/src/core/lib/utils.ts +21 -21
  73. package/templates/nextjs/base/src/middleware.ts.ejs +54 -2
  74. package/templates/nextjs/base/src/ui/cart/cart-bundle-offer.tsx +117 -117
  75. package/templates/nextjs/base/src/ui/cart/cart-item.tsx +146 -146
  76. package/templates/nextjs/base/src/ui/cart/cart-nudges.tsx +28 -28
  77. package/templates/nextjs/base/src/ui/cart/cart-summary.tsx +110 -110
  78. package/templates/nextjs/base/src/ui/cart/cart-upgrade-banner.tsx +126 -126
  79. package/templates/nextjs/base/src/ui/cart/cart-view.tsx +140 -140
  80. package/templates/nextjs/base/src/ui/cart/coupon-input.tsx +134 -134
  81. package/templates/nextjs/base/src/ui/cart/free-shipping-bar.tsx +61 -61
  82. package/templates/nextjs/base/src/ui/cart/reservation-countdown.tsx +95 -95
  83. package/templates/nextjs/base/src/ui/home/discount-banner-strip.tsx +20 -20
  84. package/templates/nextjs/base/src/ui/home/featured-products-section.tsx +24 -24
  85. package/templates/nextjs/base/src/ui/home/hero-section.tsx +27 -27
  86. package/templates/nextjs/base/src/ui/home/home-client.tsx +29 -29
  87. package/templates/nextjs/base/src/ui/layout/announcement-bar.tsx.ejs +116 -116
  88. package/templates/nextjs/base/src/ui/layout/faq-section.tsx.ejs +90 -90
  89. package/templates/nextjs/base/src/ui/layout/header-account.tsx +40 -40
  90. package/templates/nextjs/base/src/ui/layout/language-switcher.tsx.ejs +80 -80
  91. package/templates/nextjs/base/src/ui/layout/site-footer.tsx.ejs +144 -144
  92. package/templates/nextjs/base/src/ui/layout/site-header.tsx.ejs +152 -152
  93. package/templates/nextjs/base/src/ui/product/customization-fields.tsx +457 -457
  94. package/templates/nextjs/base/src/ui/product/discount-badge.tsx +18 -18
  95. package/templates/nextjs/base/src/ui/product/frequently-bought-together.tsx +191 -191
  96. package/templates/nextjs/base/src/ui/product/modifier-group-selector.tsx +206 -206
  97. package/templates/nextjs/base/src/ui/product/price-display.tsx +62 -62
  98. package/templates/nextjs/base/src/ui/product/product-card.tsx +7 -2
  99. package/templates/nextjs/base/src/ui/product/product-client-section.tsx +455 -455
  100. package/templates/nextjs/base/src/ui/product/product-listing.tsx +446 -446
  101. package/templates/nextjs/base/src/ui/product/recommendation-section.tsx +102 -102
  102. package/templates/nextjs/base/src/ui/product/review-form.tsx +294 -294
  103. package/templates/nextjs/base/src/ui/product/reviews-section.tsx.ejs +108 -108
  104. package/templates/nextjs/base/src/ui/product/stock-badge.tsx +61 -61
  105. package/templates/nextjs/base/src/ui/product/variant-selector.tsx +291 -291
  106. package/templates/nextjs/base/src/ui/shared/cdn-image.tsx +26 -26
  107. package/templates/nextjs/base/tailwind.config.ts +69 -69
  108. package/templates/nextjs/designs/atelier/app-overlay/layout.tsx.ejs +10 -0
  109. package/templates/nextjs/designs/atelier/globals.css +402 -402
  110. package/templates/nextjs/designs/atelier/messages-patch/en.json +100 -100
  111. package/templates/nextjs/designs/atelier/messages-patch/he.json +100 -100
  112. package/templates/nextjs/designs/atelier/ui/cart/cart-bundle-offer.tsx +110 -110
  113. package/templates/nextjs/designs/atelier/ui/cart/cart-drawer.tsx +163 -163
  114. package/templates/nextjs/designs/atelier/ui/cart/cart-item.tsx +140 -140
  115. package/templates/nextjs/designs/atelier/ui/cart/cart-nudges.tsx +34 -34
  116. package/templates/nextjs/designs/atelier/ui/cart/cart-summary.tsx +107 -107
  117. package/templates/nextjs/designs/atelier/ui/cart/cart-upgrade-banner.tsx +123 -123
  118. package/templates/nextjs/designs/atelier/ui/cart/cart-view.tsx +147 -147
  119. package/templates/nextjs/designs/atelier/ui/cart/coupon-input.tsx +142 -142
  120. package/templates/nextjs/designs/atelier/ui/cart/free-shipping-bar.tsx +77 -77
  121. package/templates/nextjs/designs/atelier/ui/cart/reservation-countdown.tsx +89 -89
  122. package/templates/nextjs/designs/atelier/ui/home/benefits-band.tsx +34 -34
  123. package/templates/nextjs/designs/atelier/ui/home/category-tiles.tsx +151 -151
  124. package/templates/nextjs/designs/atelier/ui/home/discount-banner-strip.tsx +27 -27
  125. package/templates/nextjs/designs/atelier/ui/home/editorial-band.tsx +75 -75
  126. package/templates/nextjs/designs/atelier/ui/home/featured-products-section.tsx +36 -36
  127. package/templates/nextjs/designs/atelier/ui/home/hero-section.tsx +174 -174
  128. package/templates/nextjs/designs/atelier/ui/home/home-client.tsx +54 -54
  129. package/templates/nextjs/designs/atelier/ui/home/newsletter-section.tsx +78 -78
  130. package/templates/nextjs/designs/atelier/ui/home/testimonials-band.tsx +46 -46
  131. package/templates/nextjs/designs/atelier/ui/layout/announcement-bar.tsx +118 -118
  132. package/templates/nextjs/designs/atelier/ui/layout/faq-section.tsx +96 -96
  133. package/templates/nextjs/designs/atelier/ui/layout/header-account.tsx +36 -36
  134. package/templates/nextjs/designs/atelier/ui/layout/header-cart.tsx +36 -36
  135. package/templates/nextjs/designs/atelier/ui/layout/language-switcher.tsx.ejs +137 -137
  136. package/templates/nextjs/designs/atelier/ui/layout/nav-url.ts +14 -14
  137. package/templates/nextjs/designs/atelier/ui/layout/rich-text-block.tsx +34 -34
  138. package/templates/nextjs/designs/atelier/ui/layout/site-footer.tsx.ejs +141 -141
  139. package/templates/nextjs/designs/atelier/ui/layout/site-header.tsx.ejs +138 -138
  140. package/templates/nextjs/designs/atelier/ui/product/customization-fields.tsx +466 -466
  141. package/templates/nextjs/designs/atelier/ui/product/discount-badge.tsx +17 -17
  142. package/templates/nextjs/designs/atelier/ui/product/frequently-bought-together.tsx +196 -196
  143. package/templates/nextjs/designs/atelier/ui/product/modifier-group-selector.tsx +193 -193
  144. package/templates/nextjs/designs/atelier/ui/product/price-display.tsx +69 -69
  145. package/templates/nextjs/designs/atelier/ui/product/product-card.tsx +13 -11
  146. package/templates/nextjs/designs/atelier/ui/product/product-client-section.tsx +477 -477
  147. package/templates/nextjs/designs/atelier/ui/product/product-grid.tsx +42 -42
  148. package/templates/nextjs/designs/atelier/ui/product/product-listing.tsx +260 -260
  149. package/templates/nextjs/designs/atelier/ui/product/recommendation-section.tsx +95 -95
  150. package/templates/nextjs/designs/atelier/ui/product/review-form.tsx +267 -267
  151. package/templates/nextjs/designs/atelier/ui/product/reviews-section.tsx.ejs +148 -148
  152. package/templates/nextjs/designs/atelier/ui/product/stock-badge.tsx +66 -66
  153. package/templates/nextjs/designs/atelier/ui/product/variant-selector.tsx +206 -206
  154. package/templates/nextjs/designs/atelier/ui/shared/cdn-image.tsx +29 -29
  155. package/templates/nextjs/designs/atelier/ui/shared/fly-to-cart.ts +86 -86
  156. package/templates/nextjs/designs/atelier/ui/shared/icons.tsx +276 -276
  157. package/templates/nextjs/designs/atelier/ui/shared/loading-spinner.tsx +63 -63
  158. package/templates/nextjs/designs/atelier/ui/shared/reveal.tsx +71 -71
  159. package/templates/nextjs/designs/atelier/ui/shared/select-menu.tsx +125 -125
  160. package/templates/nextjs/ui-canvas/cart/cart-bundle-offer.tsx +89 -89
  161. package/templates/nextjs/ui-canvas/cart/cart-item.tsx +123 -123
  162. package/templates/nextjs/ui-canvas/cart/cart-nudges.tsx +27 -27
  163. package/templates/nextjs/ui-canvas/cart/cart-summary.tsx +99 -99
  164. package/templates/nextjs/ui-canvas/cart/cart-upgrade-banner.tsx +105 -105
  165. package/templates/nextjs/ui-canvas/cart/cart-view.tsx +106 -106
  166. package/templates/nextjs/ui-canvas/cart/coupon-input.tsx +119 -119
  167. package/templates/nextjs/ui-canvas/cart/free-shipping-bar.tsx +54 -54
  168. package/templates/nextjs/ui-canvas/cart/reservation-countdown.tsx +81 -81
  169. package/templates/nextjs/ui-canvas/home/discount-banner-strip.tsx +19 -19
  170. package/templates/nextjs/ui-canvas/home/featured-products-section.tsx +23 -23
  171. package/templates/nextjs/ui-canvas/home/hero-section.tsx +21 -21
  172. package/templates/nextjs/ui-canvas/home/home-client.tsx +26 -26
  173. package/templates/nextjs/ui-canvas/layout/announcement-bar.tsx.ejs +101 -101
  174. package/templates/nextjs/ui-canvas/layout/faq-section.tsx.ejs +71 -71
  175. package/templates/nextjs/ui-canvas/layout/header-account.tsx +31 -31
  176. package/templates/nextjs/ui-canvas/layout/language-switcher.tsx.ejs +76 -76
  177. package/templates/nextjs/ui-canvas/layout/rich-text-block.tsx.ejs +36 -36
  178. package/templates/nextjs/ui-canvas/layout/site-footer.tsx.ejs +82 -82
  179. package/templates/nextjs/ui-canvas/layout/site-header.tsx.ejs +119 -119
  180. package/templates/nextjs/ui-canvas/product/customization-fields.tsx +445 -445
  181. package/templates/nextjs/ui-canvas/product/discount-badge.tsx +19 -19
  182. package/templates/nextjs/ui-canvas/product/frequently-bought-together.tsx +168 -168
  183. package/templates/nextjs/ui-canvas/product/modifier-group-selector.tsx +165 -165
  184. package/templates/nextjs/ui-canvas/product/price-display.tsx +52 -52
  185. package/templates/nextjs/ui-canvas/product/product-card.tsx +7 -2
  186. package/templates/nextjs/ui-canvas/product/product-client-section.tsx +352 -352
  187. package/templates/nextjs/ui-canvas/product/product-grid.tsx +27 -27
  188. package/templates/nextjs/ui-canvas/product/product-listing.tsx +224 -224
  189. package/templates/nextjs/ui-canvas/product/recommendation-section.tsx +99 -99
  190. package/templates/nextjs/ui-canvas/product/review-form.tsx +266 -266
  191. package/templates/nextjs/ui-canvas/product/reviews-section.tsx.ejs +96 -96
  192. package/templates/nextjs/ui-canvas/product/stock-badge.tsx +45 -45
  193. package/templates/nextjs/ui-canvas/product/variant-selector.tsx +212 -212
  194. package/templates/nextjs/ui-canvas/shared/cdn-image.tsx +31 -31
  195. package/templates/nextjs/ui-canvas/shared/loading-spinner.tsx +27 -27
  196. 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
+ }