@thorprovider/blocks 0.1.3 → 1.0.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 (99) hide show
  1. package/CHANGELOG.md +107 -0
  2. package/README.md +73 -29
  3. package/docs/standards/data-contracts.md +13 -2
  4. package/package.json +26 -10
  5. package/scripts/fix-esm-extensions.mjs +40 -0
  6. package/src/blocks/e-commerce/product-categories/category-card-grid.test.tsx +122 -0
  7. package/src/blocks/e-commerce/product-categories/category-card.test.tsx +68 -0
  8. package/src/blocks/e-commerce/product-categories/category-card.tsx +172 -0
  9. package/src/blocks/e-commerce/product-categories/category-grid.test.tsx +67 -0
  10. package/src/blocks/e-commerce/product-categories/category-shared.tsx +109 -0
  11. package/src/blocks/e-commerce/product-categories/product-category-grid.tsx +170 -0
  12. package/src/blocks/e-commerce/product-categories/product-category.test.tsx +266 -0
  13. package/src/blocks/e-commerce/product-categories/product-category.tsx +462 -0
  14. package/src/blocks/e-commerce/product-list/product-card.test.tsx +263 -0
  15. package/src/blocks/e-commerce/product-list/product-card.tsx +424 -0
  16. package/src/blocks/e-commerce/product-list/product-grid.test.tsx +162 -0
  17. package/src/blocks/e-commerce/product-list/product-grid.tsx +114 -0
  18. package/src/blocks/e-commerce/product-overview/product-overview-gallery.tsx +71 -0
  19. package/src/blocks/e-commerce/product-overview/{product-overview-5-lightbox-tab.tsx → product-overview-lightbox-tab.tsx} +35 -23
  20. package/src/blocks/e-commerce/product-overview/{product-overview-5-reviews-tab.tsx → product-overview-reviews-tab.tsx} +40 -17
  21. package/src/blocks/e-commerce/product-overview/{product-overview-5-tabs.tsx → product-overview-tabs.tsx} +8 -7
  22. package/src/blocks/e-commerce/product-overview/product-overview.test.tsx +283 -0
  23. package/src/blocks/e-commerce/product-overview/product-overview.tsx +1186 -0
  24. package/src/blocks/e-commerce/reviews/review-rating-2.tsx +5 -6
  25. package/src/blocks/e-commerce/shopping-carts/shopping-cart.test.tsx +399 -0
  26. package/src/blocks/e-commerce/shopping-carts/{shopping-cart-4.tsx → shopping-cart.tsx} +119 -85
  27. package/src/blocks/e-commerce/storefront-hero/storefront-hero.test.tsx +412 -0
  28. package/src/blocks/e-commerce/storefront-hero/storefront-hero.tsx +1283 -0
  29. package/src/blocks/marketing/features/feature.test.tsx +153 -0
  30. package/src/blocks/marketing/features/feature.tsx +195 -0
  31. package/src/blocks/marketing/navbars/navbar-4-account-menu.test.tsx +27 -9
  32. package/src/blocks/marketing/navbars/navbar-4.test.tsx +33 -2
  33. package/src/blocks/marketing/navbars/navbar-4.tsx +29 -11
  34. package/src/index.ts +77 -48
  35. package/src/lib/contracts-curated.test.ts +42 -24
  36. package/src/lib/contracts.test.ts +143 -2
  37. package/src/lib/contracts.ts +346 -14
  38. package/src/ui/button-group.tsx +1 -1
  39. package/src/ui/carousel.tsx +1 -1
  40. package/src/ui/dialog.tsx +1 -1
  41. package/src/ui/field.tsx +2 -2
  42. package/src/ui/input-group.tsx +3 -3
  43. package/src/ui/pagination.tsx +1 -1
  44. package/src/ui/sidebar.tsx +7 -7
  45. package/src/ui/toggle-group.tsx +1 -1
  46. package/tsconfig.build.json +12 -0
  47. package/tsup.config.ts +11 -7
  48. package/.turbo/turbo-build.log +0 -24
  49. package/.turbo/turbo-test.log +0 -47
  50. package/.turbo/turbo-type-check.log +0 -0
  51. package/dist/.tsbuildinfo +0 -1
  52. package/dist/contracts.d.mts +0 -1732
  53. package/dist/contracts.d.ts +0 -1732
  54. package/dist/contracts.js +0 -423
  55. package/dist/contracts.js.map +0 -1
  56. package/dist/contracts.mjs +0 -365
  57. package/dist/contracts.mjs.map +0 -1
  58. package/dist/index.d.mts +0 -3068
  59. package/dist/index.d.ts +0 -3068
  60. package/dist/index.js +0 -17834
  61. package/dist/index.js.map +0 -1
  62. package/dist/index.mjs +0 -17740
  63. package/dist/index.mjs.map +0 -1
  64. package/src/blocks/e-commerce/product-categories/avatar-group.tsx +0 -86
  65. package/src/blocks/e-commerce/product-categories/product-category-1.tsx +0 -126
  66. package/src/blocks/e-commerce/product-categories/product-category-2.test.tsx +0 -51
  67. package/src/blocks/e-commerce/product-categories/product-category-2.tsx +0 -120
  68. package/src/blocks/e-commerce/product-categories/product-category-4.tsx +0 -129
  69. package/src/blocks/e-commerce/product-categories/product-category-5.tsx +0 -218
  70. package/src/blocks/e-commerce/product-list/product-card-1.test.tsx +0 -88
  71. package/src/blocks/e-commerce/product-list/product-card-1.tsx +0 -192
  72. package/src/blocks/e-commerce/product-list/product-card-2.tsx +0 -71
  73. package/src/blocks/e-commerce/product-list/product-card-3-reaction-toggle.tsx +0 -166
  74. package/src/blocks/e-commerce/product-list/product-card-3.tsx +0 -215
  75. package/src/blocks/e-commerce/product-list/product-card-5-checkbox-check.tsx +0 -98
  76. package/src/blocks/e-commerce/product-list/product-card-5-reaction-toggle.tsx +0 -171
  77. package/src/blocks/e-commerce/product-list/product-card-5.tsx +0 -367
  78. package/src/blocks/e-commerce/product-overview/product-overview-1.test.tsx +0 -182
  79. package/src/blocks/e-commerce/product-overview/product-overview-1.tsx +0 -370
  80. package/src/blocks/e-commerce/product-overview/product-overview-2.tsx +0 -272
  81. package/src/blocks/e-commerce/product-overview/product-overview-5-gallery.tsx +0 -59
  82. package/src/blocks/e-commerce/product-overview/product-overview-5.tsx +0 -274
  83. package/src/blocks/e-commerce/shopping-carts/shopping-cart-1-spinning-counter.tsx +0 -142
  84. package/src/blocks/e-commerce/shopping-carts/shopping-cart-1.tsx +0 -291
  85. package/src/blocks/e-commerce/shopping-carts/shopping-cart-2-item-row.tsx +0 -110
  86. package/src/blocks/e-commerce/shopping-carts/shopping-cart-2-recommendations.tsx +0 -51
  87. package/src/blocks/e-commerce/shopping-carts/shopping-cart-2-spinning-counter.tsx +0 -146
  88. package/src/blocks/e-commerce/shopping-carts/shopping-cart-2.tsx +0 -295
  89. package/src/blocks/e-commerce/shopping-carts/shopping-cart-3-spinning-counter.tsx +0 -142
  90. package/src/blocks/e-commerce/shopping-carts/shopping-cart-3.tsx +0 -342
  91. package/src/blocks/e-commerce/shopping-carts/shopping-cart-4-spinning-counter.tsx +0 -146
  92. package/src/blocks/e-commerce/shopping-carts/shopping-cart-4.test.tsx +0 -229
  93. package/src/blocks/e-commerce/storefront-hero/storefront-hero-1.test.tsx +0 -72
  94. package/src/blocks/e-commerce/storefront-hero/storefront-hero-1.tsx +0 -263
  95. package/src/blocks/e-commerce/storefront-hero/storefront-hero-2.tsx +0 -283
  96. package/src/blocks/e-commerce/storefront-hero/storefront-hero-5.tsx +0 -318
  97. package/src/blocks/e-commerce/storefront-hero/storefront-hero-6.tsx +0 -205
  98. package/src/blocks/marketing/features/feature-1.tsx +0 -97
  99. package/src/blocks/marketing/features/feature-2.tsx +0 -82
@@ -0,0 +1,162 @@
1
+ // @vitest-environment jsdom
2
+ import { act } from 'react'
3
+ import { createRoot, type Root } from 'react-dom/client'
4
+ import { renderToStaticMarkup } from 'react-dom/server'
5
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
6
+
7
+ import { ProductGrid, type ProductGridProps } from './product-grid'
8
+ import type { ProductPresentation } from '../../../lib/contracts'
9
+
10
+ ;(globalThis as Record<string, unknown>).IS_REACT_ACT_ENVIRONMENT = true
11
+
12
+ // jsdom lacks the browser APIs the classic presentation's motion layer touches.
13
+ if (!window.matchMedia) {
14
+ window.matchMedia = ((query: string) => ({
15
+ matches: false,
16
+ media: query,
17
+ onchange: null,
18
+ addEventListener: () => {},
19
+ removeEventListener: () => {},
20
+ addListener: () => {},
21
+ removeListener: () => {},
22
+ dispatchEvent: () => false,
23
+ })) as unknown as typeof window.matchMedia
24
+ }
25
+ if (!('IntersectionObserver' in window)) {
26
+ ;(window as Record<string, unknown>).IntersectionObserver = class {
27
+ observe() {}
28
+ unobserve() {}
29
+ disconnect() {}
30
+ takeRecords() {
31
+ return []
32
+ }
33
+ }
34
+ }
35
+
36
+ const baseItem: ProductPresentation = {
37
+ id: 'p1',
38
+ title: 'Llave de impacto',
39
+ image: '/demo/impact.svg',
40
+ imageAlt: 'Llave de impacto inalámbrica',
41
+ price: { amount: '129.50', currencyCode: 'EUR' },
42
+ rating: 4.5,
43
+ }
44
+
45
+ const items = (count: number): ProductPresentation[] =>
46
+ Array.from({ length: count }, (_, i) => ({
47
+ ...baseItem,
48
+ id: `p${i + 1}`,
49
+ title: `Producto ${i + 1}`,
50
+ }))
51
+
52
+ const renderMarkup = (props: ProductGridProps) => renderToStaticMarkup(<ProductGrid {...props} />)
53
+
54
+ const countOccurrences = (html: string, needle: string) => html.split(needle).length - 1
55
+
56
+ describe('ProductGrid — renders a collection of item cells', () => {
57
+ it('renders one ProductCard cell per item, in the supplied order', () => {
58
+ const html = renderMarkup({ items: items(3) })
59
+ expect(html).toContain('>Producto 1<')
60
+ expect(html).toContain('>Producto 2<')
61
+ expect(html).toContain('>Producto 3<')
62
+ expect(countOccurrences(html, 'Agregar al carrito')).toBe(3)
63
+ expect(html.indexOf('Producto 1')).toBeLessThan(html.indexOf('Producto 2'))
64
+ })
65
+
66
+ it('renders the optional heading as section chrome', () => {
67
+ const html = renderMarkup({ items: items(1), heading: 'Oferta' })
68
+ expect(html).toContain('<section')
69
+ expect(html).toContain('<h2')
70
+ expect(html).toContain('>Oferta<')
71
+ })
72
+
73
+ it('slices items to maxItems when supplied', () => {
74
+ const html = renderMarkup({ items: items(8), maxItems: 2 })
75
+ expect(html).toContain('>Producto 2<')
76
+ expect(html).not.toContain('>Producto 3<')
77
+ expect(countOccurrences(html, 'Agregar al carrito')).toBe(2)
78
+ })
79
+
80
+ it('forwards the bounded presentation to every cell', () => {
81
+ const html = renderMarkup({ items: items(2), presentation: 'minimal' })
82
+ expect(html).not.toContain('>Agregar al carrito<')
83
+ expect(countOccurrences(html, 'aria-label="Agregar al carrito"')).toBe(2)
84
+ })
85
+ })
86
+
87
+ describe('ProductGrid — owns the listing states', () => {
88
+ it('renders skeleton placeholders while loading instead of cells', () => {
89
+ const html = renderMarkup({ items: items(3), loading: true })
90
+ expect(html).toContain('data-slot="skeleton"')
91
+ expect(html).toContain('aria-busy="true"')
92
+ expect(html).not.toContain('Llave de impacto')
93
+ expect(html).not.toContain('Agregar al carrito')
94
+ })
95
+
96
+ it('defaults to six skeletons and honors skeletonCount', () => {
97
+ expect(countOccurrences(renderMarkup({ items: [], loading: true }), 'data-slot="skeleton"')).toBe(18)
98
+ expect(
99
+ countOccurrences(
100
+ renderMarkup({ items: [], loading: true, skeletonCount: 1 }),
101
+ 'data-slot="skeleton"',
102
+ ),
103
+ ).toBe(3)
104
+ })
105
+
106
+ it('renders an empty state with default copy instead of a blank grid', () => {
107
+ const html = renderMarkup({ items: [] })
108
+ expect(html).toContain('No hay productos para mostrar.')
109
+ expect(html).not.toContain('Agregar al carrito')
110
+ })
111
+
112
+ it('uses the overridable empty label', () => {
113
+ expect(renderMarkup({ items: [], emptyLabel: 'Sin productos' })).toContain('Sin productos')
114
+ })
115
+ })
116
+
117
+ describe('ProductGrid — resolves wishlist membership per cell', () => {
118
+ it('passes each cell only its own wishlisted boolean', () => {
119
+ const html = renderMarkup({
120
+ items: items(2),
121
+ presentation: 'rich',
122
+ wishlistedIds: ['p1'],
123
+ })
124
+ expect(html).toContain('aria-pressed="true"')
125
+ expect(html).toContain('aria-pressed="false"')
126
+ })
127
+ })
128
+
129
+ describe('ProductGrid — actions bubble from the cells', () => {
130
+ let container: HTMLDivElement
131
+ let root: Root
132
+ let mounted: Root | undefined
133
+
134
+ const mount = (props: ProductGridProps) => {
135
+ root = createRoot(container)
136
+ mounted = root
137
+ act(() => root.render(<ProductGrid {...props} />))
138
+ }
139
+
140
+ beforeEach(() => {
141
+ container = document.createElement('div')
142
+ document.body.appendChild(container)
143
+ })
144
+
145
+ afterEach(() => {
146
+ const root = mounted
147
+ if (root) act(() => root.unmount())
148
+ container.remove()
149
+ })
150
+
151
+ it('reports the identity of the clicked cell item', () => {
152
+ const onAddToCart = vi.fn()
153
+ mount({ items: items(2), onAddToCart })
154
+ const buttons = Array.from(container.querySelectorAll('button')).filter((b) =>
155
+ b.textContent?.includes('Agregar al carrito'),
156
+ )
157
+ act(() => {
158
+ buttons[1]!.dispatchEvent(new MouseEvent('click', { bubbles: true }))
159
+ })
160
+ expect(onAddToCart).toHaveBeenCalledWith(expect.objectContaining({ id: 'p2' }))
161
+ })
162
+ })
@@ -0,0 +1,114 @@
1
+ 'use client'
2
+
3
+ import type { ReactNode } from 'react'
4
+
5
+ import { Skeleton } from '../../../ui/skeleton'
6
+ import type { ProductGridSpecProps, ProductPresentation } from '../../../lib/contracts'
7
+ import { ProductCard } from './product-card'
8
+
9
+ /**
10
+ * Props for the canonical `ProductGrid` listing. The serializable spec props
11
+ * (`ProductGridSpecProps`) plus the runtime-only action callbacks and label
12
+ * strings, which the grid forwards to each cell.
13
+ */
14
+ export interface ProductGridProps extends ProductGridSpecProps {
15
+ onAddToCart?: (item: ProductPresentation) => void
16
+ onProductClick?: (item: ProductPresentation) => void
17
+ /** Host-owned wishlist toggle; reports the item and the next state. */
18
+ onToggleWishlist?: (item: ProductPresentation, nextState: boolean) => void
19
+ onViewSimilar?: (item: ProductPresentation) => void
20
+ addToCartLabel?: string
21
+ /** Shown when a price is present but unavailable (never a zero amount). */
22
+ unavailablePriceLabel?: string
23
+ addToWishlistLabel?: string
24
+ removeFromWishlistLabel?: string
25
+ viewSimilarLabel?: string
26
+ }
27
+
28
+ const GRID_CLASSES = 'grid grid-cols-1 gap-4 sm:grid-cols-2 md:grid-cols-3 lg:gap-6'
29
+
30
+ function SkeletonCell() {
31
+ return (
32
+ <div className='flex flex-col gap-3'>
33
+ <Skeleton className='aspect-square w-full rounded-md' />
34
+ <Skeleton className='h-4 w-3/4' />
35
+ <Skeleton className='h-4 w-1/3' />
36
+ </div>
37
+ )
38
+ }
39
+
40
+ /**
41
+ * Canonical product grid — the listing that renders a collection of product
42
+ * items as a grid of `ProductCard` item cells. It owns the section chrome
43
+ * (heading), the responsive layout, the item cap, wishlist membership
44
+ * resolution, and the loading/empty/ready states; the host owns data errors.
45
+ */
46
+ export function ProductGrid({
47
+ items,
48
+ presentation,
49
+ heading,
50
+ maxItems,
51
+ wishlistedIds,
52
+ loading = false,
53
+ skeletonCount = 6,
54
+ emptyLabel = 'No hay productos para mostrar.',
55
+ onAddToCart,
56
+ onProductClick,
57
+ onToggleWishlist,
58
+ onViewSimilar,
59
+ addToCartLabel,
60
+ unavailablePriceLabel,
61
+ addToWishlistLabel,
62
+ removeFromWishlistLabel,
63
+ viewSimilarLabel,
64
+ }: ProductGridProps) {
65
+ const displayedItems = maxItems !== undefined ? items.slice(0, maxItems) : items
66
+
67
+ let body: ReactNode
68
+ if (loading) {
69
+ body = (
70
+ <div role='status' aria-busy='true' className={GRID_CLASSES}>
71
+ {Array.from({ length: skeletonCount }, (_, index) => (
72
+ <SkeletonCell key={index} />
73
+ ))}
74
+ </div>
75
+ )
76
+ } else if (displayedItems.length === 0) {
77
+ body = <p className='text-muted-foreground text-center'>{emptyLabel}</p>
78
+ } else {
79
+ body = (
80
+ <div className={GRID_CLASSES}>
81
+ {displayedItems.map((item) => (
82
+ <ProductCard
83
+ key={item.id}
84
+ item={item}
85
+ presentation={presentation}
86
+ wishlisted={wishlistedIds ? wishlistedIds.includes(item.id) : undefined}
87
+ onAddToCart={onAddToCart}
88
+ onProductClick={onProductClick}
89
+ onToggleWishlist={onToggleWishlist}
90
+ onViewSimilar={onViewSimilar}
91
+ addToCartLabel={addToCartLabel}
92
+ unavailablePriceLabel={unavailablePriceLabel}
93
+ addToWishlistLabel={addToWishlistLabel}
94
+ removeFromWishlistLabel={removeFromWishlistLabel}
95
+ viewSimilarLabel={viewSimilarLabel}
96
+ />
97
+ ))}
98
+ </div>
99
+ )
100
+ }
101
+
102
+ return (
103
+ <section className='py-12'>
104
+ <div className='mx-auto w-full max-w-7xl px-4 sm:px-6 lg:px-8'>
105
+ {heading && (
106
+ <h2 className='mb-8 text-center text-2xl font-bold text-balance md:text-3xl'>{heading}</h2>
107
+ )}
108
+ {body}
109
+ </div>
110
+ </section>
111
+ )
112
+ }
113
+
114
+ export default ProductGrid
@@ -0,0 +1,71 @@
1
+ import { Camera } from 'lucide-react'
2
+ import { Badge } from '../../../ui/badge'
3
+ import { cn } from '../../../lib/utils'
4
+
5
+ export interface ProductOverviewGalleryProps {
6
+ /** Resolved image URLs for the product (never empty strings; a fallback is allowed). */
7
+ images: string[]
8
+ /** Product title, used for alt text. */
9
+ title: string
10
+ /** Optional badge label; omitted when absent. */
11
+ badgeLabel?: string
12
+ selectedImage: number
13
+ onSelectImage: (index: number) => void
14
+ photosLabel?: string
15
+ }
16
+
17
+ /**
18
+ * Image-forward gallery used by the canonical ProductOverview `rich` presentation: a large
19
+ * primary image with an optional badge and a photo count, plus a thumbnail strip. Operates on
20
+ * already-resolved URLs so it carries no product-shape assumption (no `mainImages`/`galleryImages`
21
+ * split, no sector fields).
22
+ */
23
+ export function ProductOverviewGallery({
24
+ images,
25
+ title,
26
+ badgeLabel,
27
+ selectedImage,
28
+ onSelectImage,
29
+ photosLabel = 'fotos',
30
+ }: ProductOverviewGalleryProps) {
31
+ const activeImage = images[Math.min(selectedImage, images.length - 1)]
32
+
33
+ return (
34
+ <div>
35
+ <div className='bg-muted relative aspect-square overflow-hidden rounded-xl'>
36
+ <img src={activeImage || undefined} alt={title} className='size-full object-cover' />
37
+ {badgeLabel ? (
38
+ <Badge className='absolute top-4 left-4 px-2.5 py-0.5 font-semibold'>{badgeLabel}</Badge>
39
+ ) : null}
40
+ <div className='absolute right-4 bottom-4 rounded-full bg-black/60 px-3 py-1.5 text-sm text-white backdrop-blur-sm'>
41
+ <Camera className='mr-1 inline size-4' />
42
+ {images.length} {photosLabel}
43
+ </div>
44
+ </div>
45
+
46
+ {images.length > 1 ? (
47
+ <div className='mt-4 flex gap-3 overflow-x-auto pb-2'>
48
+ {images.map((image, index) => (
49
+ <button
50
+ type='button'
51
+ key={`${title}:gallery:${index}`}
52
+ onClick={() => onSelectImage(index)}
53
+ className={cn(
54
+ 'relative aspect-square size-20 flex-shrink-0 cursor-pointer overflow-hidden rounded-lg border-2 transition-all',
55
+ selectedImage === index
56
+ ? 'border-primary ring-primary/20 shadow-md ring-2'
57
+ : 'border-muted hover:border-muted-foreground/50',
58
+ )}
59
+ aria-label={`Mostrar imagen ${index + 1} de ${title}`}
60
+ aria-pressed={selectedImage === index}
61
+ >
62
+ <img src={image || undefined} alt={`${title} ${index + 1}`} className='size-full object-cover' />
63
+ </button>
64
+ ))}
65
+ </div>
66
+ ) : null}
67
+ </div>
68
+ )
69
+ }
70
+
71
+ export default ProductOverviewGallery
@@ -7,80 +7,92 @@ import { Card, CardContent } from '../../../ui/card'
7
7
  import { Dialog, DialogClose, DialogContent, DialogTitle, DialogTrigger } from '../../../ui/dialog'
8
8
  import { cn } from '../../../lib/utils'
9
9
 
10
- import type { ProductOverview5Product } from './product-overview-5'
11
-
12
- export interface ProductOverview5LightboxTabProps {
13
- product: ProductOverview5Product
10
+ export interface ProductOverviewLightboxTabProps {
11
+ /** Resolved image URLs for the product. */
12
+ images: string[]
13
+ /** Product title, used for alt text. */
14
+ title: string
14
15
  galleryLabel?: string
15
16
  ofCounterLabel?: string
16
17
  }
17
18
 
18
- export function ProductOverview5LightboxTab({
19
- product,
19
+ /**
20
+ * Gallery panel for the `rich` presentation: a thumbnail grid that opens a lightbox with
21
+ * prev/next navigation. Operates on already-resolved URLs so it carries no sector assumption.
22
+ */
23
+ export function ProductOverviewLightboxTab({
24
+ images,
25
+ title,
20
26
  galleryLabel = 'Galería',
21
27
  ofCounterLabel = '{current} de {total}',
22
- }: ProductOverview5LightboxTabProps) {
28
+ }: ProductOverviewLightboxTabProps) {
23
29
  const [modalImageIndex, setModalImageIndex] = useState(0)
24
30
 
25
- const nextImage = () => setModalImageIndex(prev => (prev + 1) % product.galleryImages.length)
26
- const prevImage = () => setModalImageIndex(prev => (prev - 1 + product.galleryImages.length) % product.galleryImages.length)
31
+ const nextImage = () => setModalImageIndex(prev => (prev + 1) % images.length)
32
+ const prevImage = () => setModalImageIndex(prev => (prev - 1 + images.length) % images.length)
27
33
 
28
34
  return (
29
35
  <Card className='border shadow-none'>
30
36
  <CardContent className='p-8 py-0'>
31
37
  <h3 className='mb-6 text-xl font-semibold text-balance'>{galleryLabel}</h3>
32
38
  <div className='grid gap-4 sm:grid-cols-2 lg:grid-cols-3'>
33
- {product.galleryImages.map((image, index) => (
34
- <Dialog key={index}>
39
+ {images.map((image, index) => (
40
+ <Dialog key={`${title}:lightbox:${index}`}>
35
41
  <DialogTrigger asChild>
36
42
  <button
37
43
  type='button'
38
44
  className='block aspect-square cursor-pointer overflow-hidden rounded-xl'
39
45
  onClick={() => setModalImageIndex(index)}
46
+ aria-label={`Abrir imagen ${index + 1} de ${title}`}
40
47
  >
41
- <img src={image || undefined} alt={`${product.name} ${index + 1}`} className='size-full object-cover' />
48
+ <img src={image || undefined} alt={`${title} ${index + 1}`} className='size-full object-cover' />
42
49
  </button>
43
50
  </DialogTrigger>
44
51
  <DialogContent className='max-w-4xl border-0 bg-transparent p-0' showCloseButton={false}>
45
52
  <DialogTitle className='sr-only'>Imagen de galería {modalImageIndex + 1}</DialogTitle>
46
53
  <div className='relative'>
47
54
  <img
48
- src={product.galleryImages[modalImageIndex] || undefined}
49
- alt={`${product.name} ${modalImageIndex + 1}`}
55
+ src={images[modalImageIndex] || undefined}
56
+ alt={`${title} ${modalImageIndex + 1}`}
50
57
  className='max-h-[80vh] w-full object-contain'
51
58
  />
52
59
  <DialogClose className='absolute top-4 right-4 rounded-full bg-black/20 p-2 text-white transition-colors hover:bg-black/30'>
53
60
  <X className='size-4' />
54
61
  </DialogClose>
55
62
 
56
- {product.galleryImages.length > 1 && (
63
+ {images.length > 1 ? (
57
64
  <>
58
65
  <Button
59
66
  variant='ghost'
60
67
  size='icon'
61
- className='size-9 absolute top-1/2 left-4 -translate-y-1/2 cursor-pointer rounded-full bg-black/20 text-white hover:bg-black/30'
68
+ className='absolute top-1/2 left-4 size-9 -translate-y-1/2 cursor-pointer rounded-full bg-black/20 text-white hover:bg-black/30'
62
69
  onClick={prevImage}
70
+ aria-label='Imagen anterior'
63
71
  >
64
72
  <ChevronLeft className='size-4' />
65
73
  </Button>
66
74
  <Button
67
75
  variant='ghost'
68
76
  size='icon'
69
- className='size-9 absolute top-1/2 right-4 -translate-y-1/2 cursor-pointer rounded-full bg-black/20 text-white hover:bg-black/30'
77
+ className='absolute top-1/2 right-4 size-9 -translate-y-1/2 cursor-pointer rounded-full bg-black/20 text-white hover:bg-black/30'
70
78
  onClick={nextImage}
79
+ aria-label='Imagen siguiente'
71
80
  >
72
81
  <ChevronRight className='size-4' />
73
82
  </Button>
74
83
  </>
75
- )}
84
+ ) : null}
76
85
 
77
86
  <div className='absolute bottom-4 left-1/2 flex -translate-x-1/2 gap-2'>
78
- {product.galleryImages.map((_, idx) => (
87
+ {images.map((_, idx) => (
79
88
  <button
80
89
  type='button'
81
- key={idx}
90
+ key={`${title}:dot:${idx}`}
82
91
  aria-label={`Mostrar imagen ${idx + 1}`}
83
- className={cn('size-2 rounded-full transition-colors', idx === modalImageIndex ? 'bg-white' : 'bg-white/50')}
92
+ className={cn(
93
+ 'size-2 rounded-full transition-colors',
94
+ idx === modalImageIndex ? 'bg-white' : 'bg-white/50',
95
+ )}
84
96
  onClick={() => setModalImageIndex(idx)}
85
97
  />
86
98
  ))}
@@ -89,7 +101,7 @@ export function ProductOverview5LightboxTab({
89
101
  <div className='absolute right-4 bottom-4 rounded-full bg-black/20 px-3 py-1 text-sm text-white'>
90
102
  {ofCounterLabel
91
103
  .replace('{current}', String(modalImageIndex + 1))
92
- .replace('{total}', String(product.galleryImages.length))}
104
+ .replace('{total}', String(images.length))}
93
105
  </div>
94
106
  </div>
95
107
  </DialogContent>
@@ -101,4 +113,4 @@ export function ProductOverview5LightboxTab({
101
113
  )
102
114
  }
103
115
 
104
- export default ProductOverview5LightboxTab
116
+ export default ProductOverviewLightboxTab
@@ -2,17 +2,33 @@ import { Star } from 'lucide-react'
2
2
  import { Card, CardContent } from '../../../ui/card'
3
3
  import { Progress } from '../../../ui/progress'
4
4
 
5
- import type { ProductOverview5Product } from './product-overview-5'
5
+ /**
6
+ * Canonical review entry for the ProductOverview `rich` presentation. Reviews are supplied by the
7
+ * host (optional block data), never seeded by the block.
8
+ */
9
+ export interface ProductOverviewReview {
10
+ id: number
11
+ author: string
12
+ rating: number
13
+ comment: string
14
+ date: string
15
+ helpful?: number
16
+ }
6
17
 
7
- export interface ProductOverview5ReviewsTabProps {
8
- product: ProductOverview5Product
18
+ export interface ProductOverviewReviewsTabProps {
19
+ /** Aggregate rating (0–5); rendered only when the host supplies reviews. */
20
+ rating: number
21
+ reviews: ProductOverviewReview[]
9
22
  basedOnReviewsLabel?: string
10
23
  foundHelpfulLabel?: string
11
24
  }
12
25
 
13
26
  function renderStars(rating: number) {
14
27
  return Array.from({ length: 5 }, (_, i) => (
15
- <Star key={i} className={`size-4 ${i < Math.floor(rating) ? 'fill-foreground text-foreground' : i < rating ? 'text-foreground' : ''}`} />
28
+ <Star
29
+ key={i}
30
+ className={`size-4 ${i < Math.floor(rating) ? 'fill-foreground text-foreground' : i < rating ? 'text-foreground' : ''}`}
31
+ />
16
32
  ))
17
33
  }
18
34
 
@@ -20,27 +36,32 @@ function formatDate(dateString: string) {
20
36
  return new Date(dateString).toLocaleDateString('es-ES', { year: 'numeric', month: 'short', day: 'numeric' })
21
37
  }
22
38
 
23
- export function ProductOverview5ReviewsTab({
24
- product,
39
+ /**
40
+ * Reviews panel for the `rich` presentation: an aggregate summary plus the review list. Rendered
41
+ * only when the host supplies reviews, so it never fabricates an empty review surface.
42
+ */
43
+ export function ProductOverviewReviewsTab({
44
+ rating,
45
+ reviews,
25
46
  basedOnReviewsLabel = 'Basado en {count} reseñas',
26
47
  foundHelpfulLabel = '{count} personas encontraron esto útil',
27
- }: ProductOverview5ReviewsTabProps) {
48
+ }: ProductOverviewReviewsTabProps) {
28
49
  return (
29
50
  <div className='flex flex-col gap-6'>
30
51
  <Card className='border shadow-none'>
31
52
  <CardContent className='p-8 py-0'>
32
53
  <div className='flex flex-col items-start gap-8 md:flex-row md:items-center'>
33
54
  <div className='text-center'>
34
- <div className='text-4xl font-bold'>{product.rating}</div>
35
- <div className='mt-2 flex justify-center'>{renderStars(product.rating)}</div>
55
+ <div className='text-4xl font-bold'>{rating}</div>
56
+ <div className='mt-2 flex justify-center'>{renderStars(rating)}</div>
36
57
  <div className='text-muted-foreground mt-2 text-sm'>
37
- {basedOnReviewsLabel.replace('{count}', String(product.userReviews.length))}
58
+ {basedOnReviewsLabel.replace('{count}', String(reviews.length))}
38
59
  </div>
39
60
  </div>
40
61
  <div className='flex-1'>
41
62
  {[5, 4, 3, 2, 1].map(stars => {
42
- const count = product.userReviews.filter(review => Math.floor(review.rating) === stars).length
43
- const percentage = (count / product.userReviews.length) * 100
63
+ const count = reviews.filter(review => Math.floor(review.rating) === stars).length
64
+ const percentage = reviews.length > 0 ? (count / reviews.length) * 100 : 0
44
65
  return (
45
66
  <div key={stars} className='mb-3 flex items-center gap-3'>
46
67
  <span className='w-8 text-sm font-medium'>{stars}★</span>
@@ -55,7 +76,7 @@ export function ProductOverview5ReviewsTab({
55
76
  </Card>
56
77
 
57
78
  <div className='flex flex-col gap-4'>
58
- {product.userReviews.map(review => (
79
+ {reviews.map(review => (
59
80
  <Card key={review.id} className='border shadow-none'>
60
81
  <CardContent className='p-6 py-0'>
61
82
  <div className='mb-4 flex items-start justify-between'>
@@ -68,9 +89,11 @@ export function ProductOverview5ReviewsTab({
68
89
  </div>
69
90
  </div>
70
91
  <p className='text-muted-foreground mb-3 text-sm leading-relaxed'>{review.comment}</p>
71
- <div className='text-muted-foreground text-xs'>
72
- {foundHelpfulLabel.replace('{count}', String(review.helpful))}
73
- </div>
92
+ {typeof review.helpful === 'number' ? (
93
+ <div className='text-muted-foreground text-xs'>
94
+ {foundHelpfulLabel.replace('{count}', String(review.helpful))}
95
+ </div>
96
+ ) : null}
74
97
  </CardContent>
75
98
  </Card>
76
99
  ))}
@@ -79,4 +102,4 @@ export function ProductOverview5ReviewsTab({
79
102
  )
80
103
  }
81
104
 
82
- export default ProductOverview5ReviewsTab
105
+ export default ProductOverviewReviewsTab
@@ -3,7 +3,8 @@ import { Tabs as TabsPrimitive } from '@base-ui/react/tabs'
3
3
  import { cn } from '../../../lib/utils'
4
4
 
5
5
  /**
6
- * The full tab set this block renders on.
6
+ * The full tab set the canonical ProductOverview renders on for its `rich`
7
+ * presentation.
7
8
  *
8
9
  * The block's classes target Base UI state attributes (`data-active:bg-transparent` on the
9
10
  * triggers), the indicator reads Base UI positioning CSS variables (`--active-tab-*`), and the
@@ -12,11 +13,11 @@ import { cn } from '../../../lib/utils'
12
13
  * `tabs` so the block installs standalone: the shadcn `tabs` component you get from the registry
13
14
  * has no indicator or fading panel.
14
15
  */
15
- export function ProductOverview5Tabs(props: TabsPrimitive.Root.Props) {
16
+ export function ProductOverviewTabs(props: TabsPrimitive.Root.Props) {
16
17
  return <TabsPrimitive.Root data-slot='tabs' {...props} />
17
18
  }
18
19
 
19
- export function ProductOverview5TabsList({ className, ...props }: TabsPrimitive.List.Props) {
20
+ export function ProductOverviewTabsList({ className, ...props }: TabsPrimitive.List.Props) {
20
21
  return <TabsPrimitive.List data-slot='tabs-list' className={className} {...props} />
21
22
  }
22
23
 
@@ -24,7 +25,7 @@ export function ProductOverview5TabsList({ className, ...props }: TabsPrimitive.
24
25
  * Base UI's tab button carries no layout of its own, so the inline-flex centring that the
25
26
  * Radix-backed shadcn trigger used to supply is re-stated here.
26
27
  */
27
- export function ProductOverview5TabsTrigger({ className, ...props }: TabsPrimitive.Tab.Props) {
28
+ export function ProductOverviewTabsTrigger({ className, ...props }: TabsPrimitive.Tab.Props) {
28
29
  return (
29
30
  <TabsPrimitive.Tab
30
31
  data-slot='tabs-trigger'
@@ -39,7 +40,7 @@ export function ProductOverview5TabsTrigger({ className, ...props }: TabsPrimiti
39
40
  * activation is a fresh mount - `animate-in` plays automatically without needing a transition-state
40
41
  * data attribute to gate it.
41
42
  */
42
- export function ProductOverview5TabsContentFade({ className, ...props }: TabsPrimitive.Panel.Props) {
43
+ export function ProductOverviewTabsContentFade({ className, ...props }: TabsPrimitive.Panel.Props) {
43
44
  return (
44
45
  <TabsPrimitive.Panel
45
46
  className={cn('animate-in fade-in-0 duration-200 motion-reduce:animate-none', className)}
@@ -53,7 +54,7 @@ export function ProductOverview5TabsContentFade({ className, ...props }: TabsPri
53
54
  * with `data-active:bg-transparent` on the triggers so their own active background doesn't double
54
55
  * up with the pill.
55
56
  */
56
- export function ProductOverview5TabsIndicator({ className, ...props }: TabsPrimitive.Indicator.Props) {
57
+ export function ProductOverviewTabsIndicator({ className, ...props }: TabsPrimitive.Indicator.Props) {
57
58
  return (
58
59
  <TabsPrimitive.Indicator
59
60
  data-slot='tabs-indicator'
@@ -66,4 +67,4 @@ export function ProductOverview5TabsIndicator({ className, ...props }: TabsPrimi
66
67
  {...props}
67
68
  />
68
69
  )
69
- }
70
+ }