@thorprovider/blocks 0.1.2 → 1.0.0

package/src/index.ts

@@ -23,16 +23,18 @@ export { default as Navbar4 } from './blocks/marketing/navbars/navbar-4'
 export { default as Banner1 } from './blocks/marketing/banners/banner-1'
 export { default as HeroSection1 } from './blocks/marketing/hero-sections/hero-section-1'
 export { default as CtaSection1 } from './blocks/marketing/cta/cta-section-1'
-export { default as Feature1 } from './blocks/marketing/features/feature-1'
-export { default as Feature2 } from './blocks/marketing/features/feature-2'
+export { default as Feature } from './blocks/marketing/features/feature'
 export { default as Testimonial1 } from './blocks/marketing/testimonials/testimonial-1'
 export { default as Testimonial2 } from './blocks/marketing/testimonials/testimonial-2'
 export { default as FaqBlock1 } from './blocks/marketing/faq/faq-block-1'
 export { default as PricingSection1 } from './blocks/marketing/pricing/pricing-section-1'
 export type { CtaSection1Props } from './blocks/marketing/cta/cta-section-1'
 export type { FaqBlock1Props, FaqItem } from './blocks/marketing/faq/faq-block-1'
-export type { Feature1Props, Feature1Item } from './blocks/marketing/features/feature-1'
-export type { Feature2Props, Feature2Item } from './blocks/marketing/features/feature-2'
+export type {
+  FeatureProps,
+  FeatureItem,
+  FeaturePresentation,
+} from './blocks/marketing/features/feature'
 export type { LogoCloud1Props, LogoCloud1Platform } from './blocks/marketing/logo-clouds/logo-cloud-1'
 export type { PricingSection1Props, PricingTier } from './blocks/marketing/pricing/pricing-section-1'
 export type { Statistic1Props, StatisticItem } from './blocks/marketing/statistics/statistic-1'
@@ -52,41 +54,57 @@ export type {
   FooterSection4SocialIcon,
   FooterSection4SocialLink,
 } from './blocks/marketing/footers/footer-section-4'
-export { default as ProductCard1 } from './blocks/e-commerce/product-list/product-card-1'
-export { default as ProductCard2 } from './blocks/e-commerce/product-list/product-card-2'
-export { default as ProductCard3 } from './blocks/e-commerce/product-list/product-card-3'
-export { default as ProductCard5 } from './blocks/e-commerce/product-list/product-card-5'
-export { default as ProductOverview1 } from './blocks/e-commerce/product-overview/product-overview-1'
-export type {
-  ProductOverview1Props,
-  ProductOverview1Rating,
+export { ProductCard } from './blocks/e-commerce/product-list/product-card'
+export type {
+  ProductCardProps,
+  ProductCardPresentation,
+} from './blocks/e-commerce/product-list/product-card'
+export { ProductGrid } from './blocks/e-commerce/product-list/product-grid'
+export type { ProductGridProps } from './blocks/e-commerce/product-list/product-grid'
+export { default as ProductShowcase1 } from './blocks/e-commerce/product-list/product-showcase-1'
+export type { ProductShowcase1Props } from './blocks/e-commerce/product-list/product-showcase-1'
+export { default as ProductOverview } from './blocks/e-commerce/product-overview/product-overview'
+export type {
+  ProductOverviewProps,
+  ProductOverviewRating,
+  ProductOverviewPresentation,
+  ProductOverviewReview,
   ProductDetailProduct,
   ProductDetailVariant,
-} from './blocks/e-commerce/product-overview/product-overview-1'
-export { default as ProductOverview2 } from './blocks/e-commerce/product-overview/product-overview-2'
-export { default as ProductOverview5 } from './blocks/e-commerce/product-overview/product-overview-5'
-export type { ProductOverview2Props, ProductOverview2Product } from './blocks/e-commerce/product-overview/product-overview-2'
-export type { ProductOverview5Props, ProductOverview5Product, ProductOverview5Review } from './blocks/e-commerce/product-overview/product-overview-5'
+} from './blocks/e-commerce/product-overview/product-overview'
 export { default as ProductQuickView } from './blocks/e-commerce/product-overview/product-quick-view'
 export { default as ReviewRating1 } from './blocks/e-commerce/reviews/review-rating-1'
 export type { ReviewRating1Review } from './blocks/e-commerce/reviews/review-rating-1'
 export { default as ReviewRating2 } from './blocks/e-commerce/reviews/review-rating-2'
-export { default as ProductCategory1 } from './blocks/e-commerce/product-categories/product-category-1'
-export type {
-  ProductCategory1Category,
-  ProductCategory1CategoryIcon,
-  ProductCategory1Props,
-} from './blocks/e-commerce/product-categories/product-category-1'
-export { default as ProductCategory2 } from './blocks/e-commerce/product-categories/product-category-2'
-export type { ProductCategory2Category, ProductCategory2Props } from './blocks/e-commerce/product-categories/product-category-2'
-export { default as ProductCategory4 } from './blocks/e-commerce/product-categories/product-category-4'
-export { default as ProductCategory5 } from './blocks/e-commerce/product-categories/product-category-5'
+export { default as ProductCategory } from './blocks/e-commerce/product-categories/product-category'
+export type {
+  ProductCategoryProps,
+  ProductCategoryPresentation,
+} from './blocks/e-commerce/product-categories/product-category'
+export { default as CategoryCard } from './blocks/e-commerce/product-categories/category-card'
+export type {
+  CategoryCardProps,
+  CategoryCardPresentation,
+} from './blocks/e-commerce/product-categories/category-card'
+export { default as CategoryGrid } from './blocks/e-commerce/product-categories/product-category-grid'
+export type {
+  CategoryGridProps,
+  CategoryGridPresentation,
+} from './blocks/e-commerce/product-categories/product-category-grid'
 export { MegaMenu, megaMenuPropsSchema } from './blocks/e-commerce/navigation/mega-menu'
 export type { MegaMenuProps } from './blocks/e-commerce/navigation/mega-menu'
 export { MobileCategoryDrawer, mobileCategoryDrawerPropsSchema } from './blocks/e-commerce/navigation/mobile-category-drawer'
 export type { MobileCategoryDrawerProps } from './blocks/e-commerce/navigation/mobile-category-drawer'
 export { CategoryIcon, categoryIconNameSchema, categoryIconPropsSchema } from './blocks/e-commerce/navigation/category-icon'
 export type { CategoryIconName, CategoryIconProps } from './blocks/e-commerce/navigation/category-icon'
+export { Breadcrumb, breadcrumbItemSchema, breadcrumbPropsSchema } from './blocks/e-commerce/navigation/breadcrumb'
+export type { BreadcrumbItemData, BreadcrumbProps } from './blocks/e-commerce/navigation/breadcrumb'
+export { SkipToContent, skipToContentPropsSchema } from './blocks/e-commerce/navigation/skip-to-content'
+export type { SkipToContentProps } from './blocks/e-commerce/navigation/skip-to-content'
+export { BackToTop, backToTopPropsSchema, resolveScrollBehavior } from './blocks/e-commerce/navigation/back-to-top'
+export type { BackToTopProps } from './blocks/e-commerce/navigation/back-to-top'
+export { MobileBottomNav, mobileBottomNavItemSchema, mobileBottomNavPropsSchema } from './blocks/e-commerce/navigation/mobile-bottom-nav'
+export type { MobileBottomNavItem, MobileBottomNavProps } from './blocks/e-commerce/navigation/mobile-bottom-nav'
 export { menuItemSchema, collectionItemSchema } from './lib/types/menu'
 export type { MenuItem, CollectionItem } from './lib/types/menu'
 export { default as CategoryFilter1 } from './blocks/e-commerce/category-filters/category-filter-1'
@@ -114,13 +132,13 @@ export type {
 } from './blocks/e-commerce/category-filters/category-filter-2'
 export { default as CategoryFilter4 } from './blocks/e-commerce/category-filters/category-filter-4'
 export type { CategoryFilter4Props, CategoryFilter4Product, CategoryFilter4Facets } from './blocks/e-commerce/category-filters/category-filter-4'
-export { default as ShoppingCart1 } from './blocks/e-commerce/shopping-carts/shopping-cart-1'
-export { default as ShoppingCart2 } from './blocks/e-commerce/shopping-carts/shopping-cart-2'
-export { default as ShoppingCart4 } from './blocks/e-commerce/shopping-carts/shopping-cart-4'
-export { default as ShoppingCart3 } from './blocks/e-commerce/shopping-carts/shopping-cart-3'
-export type { ShoppingCart3Props, ShoppingCart3CartItem } from './blocks/e-commerce/shopping-carts/shopping-cart-3'
-export type { ShoppingCart2Props, ShoppingCart2Item } from './blocks/e-commerce/shopping-carts/shopping-cart-2'
-export type { ShoppingCart4Props, ShoppingCart4Item } from './blocks/e-commerce/shopping-carts/shopping-cart-4'
+export { default as ShoppingCart } from './blocks/e-commerce/shopping-carts/shopping-cart'
+export type {
+  ShoppingCartProps,
+  ShoppingCartPromotion,
+  ShoppingCartPresentation,
+  ShoppingCartTotalsState,
+} from './blocks/e-commerce/shopping-carts/shopping-cart'
 export { default as StoreContainer1 } from './blocks/e-commerce/store-containers/store-container-1'
 export type { StoreContainer1Props } from './blocks/e-commerce/store-containers/store-container-1'
 export { default as CheckoutForm1 } from './blocks/e-commerce/checkout-forms/checkout-form-1'
@@ -167,14 +185,18 @@ export type {
 export type { CheckoutFieldError, CheckoutFieldErrors } from './blocks/e-commerce/checkout-forms/checkout-form-types'
 export { default as OrderHistory1 } from './blocks/e-commerce/order-history/order-history-1'
 export { default as OrderHistory2 } from './blocks/e-commerce/order-history/order-history-2'
-export { default as StorefrontHero1 } from './blocks/e-commerce/storefront-hero/storefront-hero-1'
+export { default as StorefrontHero } from './blocks/e-commerce/storefront-hero/storefront-hero'
 export type {
   FeaturedProduct,
-  StorefrontHero1Props,
-} from './blocks/e-commerce/storefront-hero/storefront-hero-1'
-export { default as StorefrontHero2 } from './blocks/e-commerce/storefront-hero/storefront-hero-2'
-export { default as StorefrontHero5 } from './blocks/e-commerce/storefront-hero/storefront-hero-5'
-export { default as StorefrontHero6 } from './blocks/e-commerce/storefront-hero/storefront-hero-6'
+  HeroImage,
+  HeroDepartment,
+  HeroFeaturedDeal,
+  HeroStoreLocator,
+  HeroDeal,
+  HeroCategory,
+  StorefrontHeroPresentation,
+  StorefrontHeroProps,
+} from './blocks/e-commerce/storefront-hero/storefront-hero'
 export { default as AppShell1 } from './blocks/application/app-shells/app-shell-1'
 export { default as LoginPage1 } from './blocks/application/login-forms/login-page-1'
 export { default as LoginPage2 } from './blocks/application/login-forms/login-page-2'
@@ -201,11 +223,18 @@ export {
   cartTotalsSchema,
   productDetailProductSchema,
   productDetailVariantSchema,
-  productOverview1PropsSchema,
+  productOverviewPropsSchema,
+  storefrontHeroPropsSchema,
+  storefrontHeroProductSchema,
   buttonPropsSchema,
   storeContainer1PropsSchema,
-  productCard1PropsSchema,
-  shoppingCart4PropsSchema,
+  productCardPropsSchema,
+  productGridPropsSchema,
+  productPresentationSchema,
+  productShowcase1PropsSchema,
+  shoppingCartPropsSchema,
+  shoppingCartItemSchema,
+  shoppingCartSuggestionSchema,
   navbar4PropsSchema,
   paymentMethodSchema,
   cardProductSchema,
@@ -216,16 +245,27 @@ export {
   navCartItemSchema,
   storeUserSchema,
   accountMenuItemSchema,
+  featurePropsSchema,
+  featureCardsSpecSchema,
+  featureSplitSpecSchema,
+  productCategoryItemSchema,
+  productCategoryPropsSchema,
 } from './lib/contracts'
 export type {
   ProductDetailProductSpec,
   ProductDetailVariantSpec,
-  ProductOverview1SpecProps,
+  StorefrontHeroProduct,
+  StorefrontHeroSpecProps,
   CartTotals,
   ButtonSpecProps,
   StoreContainer1SpecProps,
-  ProductCard1SpecProps,
-  ShoppingCart4SpecProps,
+  ProductCardSpecProps,
+  ProductGridSpecProps,
+  ProductPresentation,
+  ProductShowcase1SpecProps,
+  ShoppingCartItem,
+  ShoppingCartSuggestion,
+  ShoppingCartSpecProps,
   Navbar4SpecProps,
   CardProduct,
   CartItem,
@@ -235,4 +275,11 @@ export type {
   NavCartItem,
   StoreUser,
   AccountMenuItem,
+  FeatureSpecProps,
+  FeatureCardsSpecProps,
+  FeatureSplitSpecProps,
+  ProductCategoryItem,
+  ProductCategorySpecProps,
+  CategoryCardSpecProps,
+  CategoryGridSpecProps,
 } from './lib/contracts'

package/src/lib/contracts-curated.test.ts

@@ -11,8 +11,8 @@ import {
   moneySchema,
   navCartItemSchema,
   navbar4PropsSchema,
-  productOverview1PropsSchema,
-  shoppingCart4PropsSchema,
+  productOverviewPropsSchema,
+  shoppingCartPropsSchema,
 } from './contracts'
 
 const product = {
@@ -55,13 +55,13 @@ describe('moneySchema', () => {
   })
 })
 
-describe('productOverview1PropsSchema', () => {
+describe('productOverviewPropsSchema', () => {
   it('accepts a product whose variant price is omitted or null (unavailable)', () => {
-    expect(productOverview1PropsSchema.safeParse({ product }).success).toBe(true)
+    expect(productOverviewPropsSchema.safeParse({ product }).success).toBe(true)
   })
 
   it('accepts an explicit controlled selected variant id', () => {
-    expect(productOverview1PropsSchema.safeParse({ product, selectedVariantId: 'v1' }).success).toBe(true)
+    expect(productOverviewPropsSchema.safeParse({ product, selectedVariantId: 'v1' }).success).toBe(true)
   })
 
   it('rejects a variant missing selectedOptions', () => {
@@ -69,7 +69,7 @@ describe('productOverview1PropsSchema', () => {
       ...product,
       variants: [{ id: 'v1', title: 'x', availableForSale: true, price: null }],
     }
-    expect(productOverview1PropsSchema.safeParse({ product: bad }).success).toBe(false)
+    expect(productOverviewPropsSchema.safeParse({ product: bad }).success).toBe(false)
   })
 })
 
@@ -147,24 +147,6 @@ describe('optional brand seams — present, omitted, invalid', () => {
   })
 })
 
-describe('shoppingCart4PropsSchema — authoritative totals', () => {
-  it('accepts backend totals and a controlled totals state', () => {
-    const result = shoppingCart4PropsSchema.safeParse({
-      items: [],
-      totals: {
-        subtotal: { amount: '0', currencyCode: 'USD' },
-        total: { amount: '0', currencyCode: 'USD' },
-      },
-      totalsState: 'idle',
-    })
-    expect(result.success).toBe(true)
-  })
-
-  it('rejects an unknown totals state', () => {
-    expect(shoppingCart4PropsSchema.safeParse({ items: [], totalsState: 'loading' }).success).toBe(false)
-  })
-})
-
 describe('faqBlock1PropsSchema / ctaSection1PropsSchema — bounded editorial sections', () => {
   const faqItem = { value: 'q1', question: '¿Envían a todo el país?', answer: 'Sí.' }
 
@@ -205,3 +187,39 @@ describe('faqBlock1PropsSchema / ctaSection1PropsSchema — bounded editorial se
     expect('onPrimaryClick' in parsed).toBe(false)
   })
 })
+
+describe('shoppingCartPropsSchema — canonical Money-only cart lines', () => {
+  const money = { amount: '22.22', currencyCode: 'USD' }
+
+  it('accepts a canonical Money line keyed by backend line id', () => {
+    const result = shoppingCartPropsSchema.safeParse({
+      items: [{ id: 'line_1', name: 'Teclado', quantity: 2, unitPrice: money, lineTotal: money }],
+      totals: { subtotal: money, total: money },
+      totalsState: 'idle',
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('rejects a legacy numeric-price line without canonical Money', () => {
+    const result = shoppingCartPropsSchema.safeParse({
+      items: [{ id: 'line_1', name: 'Teclado', price: 10, quantity: 2 }],
+    })
+    expect(result.success).toBe(false)
+  })
+
+  it('rejects an unknown totals state', () => {
+    const result = shoppingCartPropsSchema.safeParse({
+      items: [],
+      totalsState: 'loading',
+    })
+    expect(result.success).toBe(false)
+  })
+
+  it('omits an absent suggestion image and price honestly', () => {
+    const result = shoppingCartPropsSchema.safeParse({
+      items: [{ id: 'line_1', name: 'x', quantity: 1, unitPrice: money, lineTotal: money }],
+      recentlyViewed: [{ id: 'p1', name: 'Mouse' }],
+    })
+    expect(result.success).toBe(true)
+  })
+})

package/src/lib/contracts.test.ts

@@ -1,5 +1,12 @@
 import { describe, expect, it } from 'vitest'
-import { storeCategorySchema } from './contracts'
+import { z } from 'zod'
+import {
+  categoryCardPropsSchema,
+  categoryGridPropsSchema,
+  productCardPropsSchema,
+  productGridPropsSchema,
+  storeCategorySchema,
+} from './contracts'
 
 describe('storeCategorySchema', () => {
   it('accepts flat categories (additive backward compatibility)', () => {
@@ -29,4 +36,138 @@ describe('storeCategorySchema', () => {
     expect(storeCategorySchema.safeParse({ label: 'Solo', href: '/categorias/x', children: [{}] }).success).toBe(false)
     expect(storeCategorySchema.safeParse({}).success).toBe(false)
   })
-})
+})
+
+describe('productCardPropsSchema', () => {
+  const canonicalItem = {
+    id: 'sku-1',
+    title: 'Llave de impacto',
+    price: { amount: '129.50', currencyCode: 'EUR' },
+  }
+
+  it('accepts a single canonical Money item with the bounded presentation options', () => {
+    expect(productCardPropsSchema.safeParse({ item: canonicalItem }).success).toBe(true)
+    expect(
+      productCardPropsSchema.safeParse({
+        item: canonicalItem,
+        presentation: 'classic',
+        wishlisted: true,
+      }).success,
+    ).toBe(true)
+    expect(
+      productCardPropsSchema.safeParse({ item: canonicalItem, presentation: 'rich' }).success,
+    ).toBe(true)
+  })
+
+  it('rejects a collection in place of the single item', () => {
+    expect(productCardPropsSchema.safeParse({ items: [canonicalItem] }).success).toBe(false)
+  })
+
+  it('rejects legacy numeric-price items', () => {
+    expect(
+      productCardPropsSchema.safeParse({ item: { id: 'p1', title: 'Taladro', price: 49.99, image: '/x.svg' } })
+        .success,
+    ).toBe(false)
+  })
+
+  it('rejects unknown presentation options', () => {
+    expect(
+      productCardPropsSchema.safeParse({ item: canonicalItem, presentation: 'compact' }).success,
+    ).toBe(false)
+  })
+})
+
+describe('productGridPropsSchema', () => {
+  const canonicalItem = {
+    id: 'sku-1',
+    title: 'Llave de impacto',
+    price: { amount: '129.50', currencyCode: 'EUR' },
+  }
+
+  it('accepts a collection with the listing state options', () => {
+    expect(productGridPropsSchema.safeParse({ items: [canonicalItem] }).success).toBe(true)
+    expect(
+      productGridPropsSchema.safeParse({
+        items: [canonicalItem],
+        presentation: 'minimal',
+        heading: 'Destacados',
+        maxItems: 6,
+        wishlistedIds: ['sku-1'],
+        loading: false,
+        skeletonCount: 6,
+        emptyLabel: 'Sin productos',
+      }).success,
+    ).toBe(true)
+  })
+
+  it('declares only serializable keys — no callbacks or label strings', () => {
+    const runtimeOnlyKeys = [
+      'onAddToCart',
+      'onProductClick',
+      'onToggleWishlist',
+      'onViewSimilar',
+      'addToCartLabel',
+      'unavailablePriceLabel',
+      'addToWishlistLabel',
+      'removeFromWishlistLabel',
+      'viewSimilarLabel',
+    ]
+    const schemaOwnedLabelKeys = new Set(['emptyLabel'])
+    const schemas: Array<{ name: string; schema: z.AnyZodObject }> = [
+      { name: 'productCardPropsSchema', schema: productCardPropsSchema },
+      { name: 'productGridPropsSchema', schema: productGridPropsSchema },
+    ]
+
+    for (const { name, schema } of schemas) {
+      const declaredKeys = Object.keys(schema.shape)
+      expect(declaredKeys.length, name).toBeGreaterThan(0)
+      for (const key of declaredKeys) {
+        expect(runtimeOnlyKeys, `${name}.${key}`).not.toContain(key)
+        expect(key, `${name}.${key}`).not.toMatch(/^on[A-Z]/)
+        if (!schemaOwnedLabelKeys.has(key)) {
+          expect(key, `${name}.${key}`).not.toMatch(/Label$/)
+        }
+        expect(schema.shape[key], `${name}.${key}`).not.toBeInstanceOf(z.ZodFunction)
+      }
+    }
+  })
+
+  it('rejects non-positive maxItems and skeletonCount', () => {
+    expect(productGridPropsSchema.safeParse({ items: [], maxItems: 0 }).success).toBe(false)
+    expect(productGridPropsSchema.safeParse({ items: [], skeletonCount: 0 }).success).toBe(false)
+  })
+})
+
+describe('category cell and listing contracts', () => {
+  const category = { id: 'cat-tools', name: 'Herramientas' }
+
+  it('keeps category cell and listing props JSON-serializable and callback-free', () => {
+    const samples: Array<{ name: string; schema: z.AnyZodObject; props: unknown }> = [
+      {
+        name: 'categoryCardPropsSchema',
+        schema: categoryCardPropsSchema,
+        props: { category, presentation: 'grid', browseLabel: 'Explorar' },
+      },
+      {
+        name: 'categoryGridPropsSchema',
+        schema: categoryGridPropsSchema,
+        props: { categories: [category], presentation: 'grid', title: 'Categorías', maxItems: 4 },
+      },
+    ]
+
+    for (const { name, schema, props } of samples) {
+      const parsed = schema.parse(props)
+      expect(JSON.parse(JSON.stringify(parsed)), name).toEqual(parsed)
+      for (const key of Object.keys(schema.shape)) {
+        expect(key, `${name}.${key}`).not.toMatch(/^on[A-Z]/)
+        expect(schema.shape[key], `${name}.${key}`).not.toBeInstanceOf(z.ZodFunction)
+      }
+    }
+  })
+
+  it('keeps display labels serializable strings and rejects a collection in the cell contract', () => {
+    expect(categoryCardPropsSchema.safeParse({ category, browseLabel: () => 'Explorar' }).success).toBe(false)
+    expect(categoryGridPropsSchema.safeParse({ categories: [], emptyLabel: () => 'Vacío' }).success).toBe(false)
+    expect(categoryCardPropsSchema.safeParse({ categories: [category] }).success).toBe(false)
+  })
+})