@thorprovider/blocks 0.1.0 → 0.1.2

package/src/blocks/marketing/navbars/navbar-4.tsx

@@ -15,6 +15,7 @@ import { Navbar4SearchBar } from './navbar-4-search-bar'
 import { MegaMenu } from '../../e-commerce/navigation/mega-menu'
 import { MobileCategoryDrawer } from '../../e-commerce/navigation/mobile-category-drawer'
 import type { MenuItem } from '../../../lib/types/menu'
+import type { Money } from '@thorprovider/types'
 import type { StoreCategory } from '../../../lib/contracts'
 
 function toMenuItem(category: StoreCategory): MenuItem {
@@ -41,10 +42,21 @@ function uniqueById<T extends { id: string }>(items: T[]): T[] {
   })
 }
 
-function Logo({ text, href }: { text: string; href?: string }) {
+export interface LogoAccent {
+  /** Trailing segment of `logoText` to render with the accent styling. */
+  text: string
+  /** Consumer-supplied classes for the accent span (e.g. a brand color token). */
+  className?: string
+}
+
+function Logo({ text, href, accent }: { text: string; href?: string; accent?: LogoAccent }) {
   const className =
     'focus-visible:ring-ring flex items-center gap-2 rounded-sm focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:outline-none'
 
+  const accentText = accent?.text ?? ''
+  const hasAccent = accentText.length > 0 && text.endsWith(accentText)
+  const baseText = hasAccent ? text.slice(0, text.length - accentText.length) : text
+
   const content = (
     <>
       <svg viewBox='0 0 32 32' aria-hidden='true' className='text-primary size-7' fill='none' xmlns='http://www.w3.org/2000/svg'>
@@ -73,7 +85,10 @@ function Logo({ text, href }: { text: string; href?: string }) {
         <circle cx='13.1' cy='26.1' r='1.7' stroke='currentColor' strokeWidth='1.2' />
         <circle cx='22.1' cy='26.1' r='1.7' stroke='currentColor' strokeWidth='1.2' />
       </svg>
-      <span className='text-base font-semibold tracking-tight'>{text}</span>
+      <span className='text-base font-semibold tracking-tight'>
+        {baseText}
+        {hasAccent ? <span className={accent?.className}>{accentText}</span> : null}
+      </span>
     </>
   )
 
@@ -152,19 +167,52 @@ export interface Navbar4Props {
   utilityLinks: UtilityLink[]
   logoText: string
   logoHref?: string
+  /**
+   * Optional accent for a trailing segment of `logoText` (e.g. the "Cuba" in
+   * "ElectroCuba"). When omitted, or when `text` is not a trailing segment of
+   * `logoText`, the wordmark renders unchanged.
+   */
+  logoAccent?: LogoAccent
   /** When provided, a mobile-only "Account" link is appended to the utility links. */
   accountHref?: string
+  /**
+   * When `false`, no search control is rendered at all — neither the desktop
+   * input, the mobile trigger, nor the mobile panel. Defaults to `true` so
+   * legacy consumers keep the existing self-contained search. The generated
+   * storefront passes `false` while no verified global search contract exists
+   * (E2 task 5.4), so no global search is presented as working.
+   */
+  showSearch?: boolean
   searchQuery?: string
   onSearchChange?: (value: string) => void
   items?: CartItem[]
+  /**
+   * Quantity DELTA for a backend cart line-item id. The boundary converts the
+   * delta into an absolute quantity against the authoritative current line
+   * quantity before mutating the cart.
+   */
   onQtyChange?: (id: string, delta: number) => void
+  /** Remove the backend cart line-item id. */
   onRemove?: (id: string) => void
+  /** Authoritative backend subtotal for the mini-cart. */
+  subtotal?: Money
+  /** Shown when an authoritative subtotal is supplied but absent/malformed. */
+  subtotalUnavailableLabel?: string
+  /** Override money formatting (locale, currency). Defaults to `Money.currencyCode`. */
+  formatMoney?: (money: Money) => string
   user?: StoreUser
   accountMenuItems?: AccountMenuItem[]
   onHelp?: () => void
   onSignOut?: () => void
   onCheckout?: () => void
   onViewCart?: () => void
+  /**
+   * Consumer-supplied classes merged onto the outer `<header>` as the final
+   * argument, so a semantic surface such as `bg-brand-nav
+   * text-brand-nav-foreground` overrides the default `bg-background`. Purely
+   * presentational: no layout, structure, or behavior changes.
+   */
+  className?: string
 }
 
 export function Navbar4({
@@ -173,18 +221,24 @@ export function Navbar4({
   utilityLinks,
   logoText,
   logoHref,
+  logoAccent,
   accountHref,
+  showSearch = true,
   searchQuery: searchQueryProp,
   onSearchChange,
   items: itemsProp,
   onQtyChange: onQtyChangeProp,
   onRemove: onRemoveProp,
+  subtotal,
+  subtotalUnavailableLabel,
+  formatMoney,
   user,
   accountMenuItems,
   onHelp,
   onSignOut,
   onCheckout,
   onViewCart,
+  className,
 }: Navbar4Props) {
   /**
    * Integration seam
@@ -228,20 +282,32 @@ export function Navbar4({
   const count = useMemo(() => items.reduce((total, item) => total + item.qty, 0), [items])
 
   useEffect(() => {
-    if (!searchOpen) {
+    if (!showSearch || !searchOpen) {
       return
     }
 
     document.getElementById('store-search-mobile')?.focus()
-  }, [searchOpen])
+  }, [searchOpen, showSearch])
 
   const dismissSearch = () => {
     setSearchOpen(false)
     searchTriggerRef.current?.focus()
   }
 
+  // When the consumer overrides the header surface via `className`, the nav
+  // links inherit its text color and need an explicit hover foreground so
+  // `hover:bg-muted` never paints white-on-light; otherwise they keep the
+  // default foreground (and the default hover surface).
+  const navLinkColor =
+    className !== undefined ? 'text-inherit hover:text-foreground' : 'text-foreground'
+
   return (
-    <header className='border-border bg-background/95 sticky top-0 z-40 w-full border-b backdrop-blur-md supports-backdrop-filter:bg-background/80'>
+    <header
+      className={cn(
+        'border-border sticky top-0 z-40 w-full border-b backdrop-blur-md',
+        className ?? 'bg-background/95 supports-backdrop-filter:bg-background/80',
+      )}
+    >
       <div className='bg-foreground text-background hidden lg:block'>
         <div className='mx-auto flex h-9 w-full max-w-7xl items-center justify-between px-4 text-xs tracking-wide sm:px-6 lg:px-8'>
           <p className='text-background/80'>{shippingNote}</p>
@@ -285,7 +351,7 @@ export function Navbar4({
         />
 
         <div className='flex-1 lg:flex-none'>
-          <Logo text={logoText} href={logoHref} />
+          <Logo text={logoText} href={logoHref} accent={logoAccent} />
         </div>
 
         <nav aria-label='Store' className='hidden flex-1 lg:block'>
@@ -297,7 +363,7 @@ export function Navbar4({
                     href={category.href}
                     className={cn(
                       'hover:bg-muted focus-visible:ring-ring rounded-md px-3 py-2 text-sm font-medium transition-colors duration-150 focus-visible:ring-2 focus-visible:outline-none',
-                      category.emphasis ? 'text-destructive' : 'text-foreground',
+                      category.emphasis ? 'text-destructive' : navLinkColor,
                     )}
                   >
                     {category.label}
@@ -317,7 +383,7 @@ export function Navbar4({
                     href={category.href}
                     className={cn(
                       'hover:bg-muted focus-visible:ring-ring rounded-md px-3 py-2 text-sm font-medium transition-colors duration-150 focus-visible:ring-2 focus-visible:outline-none',
-                      category.emphasis ? 'text-destructive' : 'text-foreground',
+                      category.emphasis ? 'text-destructive' : navLinkColor,
                     )}
                   >
                     {category.label}
@@ -329,25 +395,29 @@ export function Navbar4({
         </nav>
 
         <div className='flex items-center gap-1.5'>
-          <div className='hidden lg:block lg:w-64'>
-            <Navbar4SearchBar
-              id='store-search'
-              value={searchQuery}
-              onValueChange={setSearchQuery}
-            />
-          </div>
-
-          <Button
-            ref={searchTriggerRef}
-            variant='ghost'
-            size='icon'
-            className='lg:hidden'
-            aria-label='Search products'
-            aria-expanded={searchOpen}
-            onClick={() => setSearchOpen(open => !open)}
-          >
-            {searchOpen ? <X /> : <Search />}
-          </Button>
+          {showSearch ? (
+            <>
+              <div className='hidden lg:block lg:w-64'>
+                <Navbar4SearchBar
+                  id='store-search'
+                  value={searchQuery}
+                  onValueChange={setSearchQuery}
+                />
+              </div>
+
+              <Button
+                ref={searchTriggerRef}
+                variant='ghost'
+                size='icon'
+                className='lg:hidden'
+                aria-label='Search products'
+                aria-expanded={searchOpen}
+                onClick={() => setSearchOpen(open => !open)}
+              >
+                {searchOpen ? <X /> : <Search />}
+              </Button>
+            </>
+          ) : null}
 
           {user ? (
             <div className='hidden lg:block'>
@@ -382,6 +452,9 @@ export function Navbar4({
                 items={items}
                 onQtyChange={changeQty}
                 onRemove={removeItem}
+                subtotal={subtotal}
+                subtotalUnavailableLabel={subtotalUnavailableLabel}
+                formatMoney={formatMoney}
                 onCheckout={onCheckout}
                 onViewCart={onViewCart}
               />
@@ -394,7 +467,7 @@ export function Navbar4({
         {`Cart contains ${count} ${count === 1 ? 'item' : 'items'}`}
       </p>
 
-      {searchOpen ? (
+      {showSearch && searchOpen ? (
         <div className='border-border flex flex-col gap-0 border-t p-4 lg:hidden'>
           <Navbar4SearchBar
             id='store-search-mobile'

package/src/index.ts

@@ -1,3 +1,5 @@
+'use client'
+
 export { cn } from './lib/utils'
 export type { CTA } from './lib/types'
 
@@ -55,6 +57,12 @@ export { default as ProductCard2 } from './blocks/e-commerce/product-list/produc
 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,
+  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'
@@ -82,15 +90,27 @@ export type { CategoryIconName, CategoryIconProps } from './blocks/e-commerce/na
 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'
+export type {
+  CategoryFilter1Category,
+  CategoryFilter1PriceRange,
+  CategoryFilter1SortOption,
+} from './blocks/e-commerce/category-filters/category-filter-1'
 export { default as CategoryFilter2 } from './blocks/e-commerce/category-filters/category-filter-2'
+export { CategoryFilter2StatusView } from './blocks/e-commerce/category-filters/category-filter-2'
 export type {
   FilterProduct,
   CategoryFilter2Props,
   CategoryFilter2Category,
+  CategoryFilter2Collection,
   CategoryFilter2Color,
   CategoryFilter2PriceRange,
   CategoryFilter2SortOption,
   CategoryFilter2Filters,
+  CategoryFilter2Status,
+  CategoryFilter2StatusViewProps,
+  CategoryFilter2QueryError,
+  CategoryFilter2ActiveFilter,
+  CategoryFilter2ActiveFilterKind,
 } 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'
@@ -116,6 +136,9 @@ export type {
   CheckoutForm1OrderSummary,
   CheckoutForm1OrderSummaryItem,
   CheckoutForm1CountryOption,
+  CheckoutForm1ShippingOption,
+  CheckoutForm1Totals,
+  CheckoutForm1TotalsState,
 } from './blocks/e-commerce/checkout-forms/checkout-form-1'
 export type {
   CheckoutForm2Props,
@@ -168,6 +191,17 @@ export type { Verify1Props } from './blocks/application/verification/verify-1'
 export type { CanonMoney, CanonProduct } from './lib/contracts'
 export { PRODUCT_IMAGE_FALLBACK } from './lib/contracts'
 export {
+  isCompleteFiniteDecimal,
+  isAvailableMoney,
+  formatMoney,
+} from './lib/money'
+export { resolveAbsoluteQuantity } from './lib/cart'
+export {
+  moneySchema,
+  cartTotalsSchema,
+  productDetailProductSchema,
+  productDetailVariantSchema,
+  productOverview1PropsSchema,
   buttonPropsSchema,
   storeContainer1PropsSchema,
   productCard1PropsSchema,
@@ -184,6 +218,10 @@ export {
   accountMenuItemSchema,
 } from './lib/contracts'
 export type {
+  ProductDetailProductSpec,
+  ProductDetailVariantSpec,
+  ProductOverview1SpecProps,
+  CartTotals,
   ButtonSpecProps,
   StoreContainer1SpecProps,
   ProductCard1SpecProps,

package/src/lib/cart.test.ts

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest'
+import { resolveAbsoluteQuantity } from './cart'
+
+describe('resolveAbsoluteQuantity', () => {
+  it('converts a Navbar DELTA into an ABSOLUTE quantity against the authoritative current quantity', () => {
+    expect(resolveAbsoluteQuantity(3, -1)).toBe(2)
+    expect(resolveAbsoluteQuantity(3, 1)).toBe(4)
+    expect(resolveAbsoluteQuantity(1, 1)).toBe(2)
+  })
+
+  it('never drops below one — removal is a distinct callback, not a zero quantity', () => {
+    expect(resolveAbsoluteQuantity(1, -1)).toBe(1)
+    expect(resolveAbsoluteQuantity(0, -1)).toBe(1)
+  })
+})

package/src/lib/cart.ts

@@ -0,0 +1,11 @@
+/**
+ * Cart line quantity normalization shared by the curated cart surfaces.
+ *
+ * The Navbar mini-cart expresses a quantity DELTA while the cart page reports
+ * an ABSOLUTE quantity. The boundary normalizes the delta against the
+ * authoritative current line quantity (from the backend cart) before mutating;
+ * it must never reinterpret one as the other.
+ */
+export function resolveAbsoluteQuantity(currentQuantity: number, delta: number): number {
+  return Math.max(1, currentQuantity + delta)
+}

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

@@ -0,0 +1,207 @@
+import { describe, expect, it } from 'vitest'
+import {
+  brandAccentSchema,
+  cartItemSchema,
+  ctaSchema,
+  ctaSection1PropsSchema,
+  faqBlock1PropsSchema,
+  faqItemSchema,
+  heroImageSchema,
+  logoAccentSchema,
+  moneySchema,
+  navCartItemSchema,
+  navbar4PropsSchema,
+  productOverview1PropsSchema,
+  shoppingCart4PropsSchema,
+} from './contracts'
+
+const product = {
+  id: 'p1',
+  title: 'Taladro',
+  options: [{ id: 'o1', name: 'Color', values: ['Rojo'] }],
+  variants: [
+    {
+      id: 'v1',
+      title: 'Rojo',
+      availableForSale: true,
+      selectedOptions: [{ name: 'Color', value: 'Rojo' }],
+      price: { amount: '69.99', currencyCode: 'USD' },
+    },
+    {
+      id: 'v2',
+      title: 'Gris',
+      availableForSale: true,
+      selectedOptions: [{ name: 'Color', value: 'Gris' }],
+      price: null,
+    },
+  ],
+  images: [],
+}
+
+describe('moneySchema', () => {
+  it('accepts canonical Money in major units', () => {
+    expect(moneySchema.parse({ amount: '69.99', currencyCode: 'USD' })).toEqual({
+      amount: '69.99',
+      currencyCode: 'USD',
+    })
+  })
+
+  it('rejects a missing amount', () => {
+    expect(moneySchema.safeParse({ currencyCode: 'USD' }).success).toBe(false)
+  })
+
+  it('accepts the unresolved amount sentinel "" so a whole view is not rejected', () => {
+    expect(moneySchema.safeParse({ amount: '', currencyCode: 'USD' }).success).toBe(true)
+  })
+})
+
+describe('productOverview1PropsSchema', () => {
+  it('accepts a product whose variant price is omitted or null (unavailable)', () => {
+    expect(productOverview1PropsSchema.safeParse({ product }).success).toBe(true)
+  })
+
+  it('accepts an explicit controlled selected variant id', () => {
+    expect(productOverview1PropsSchema.safeParse({ product, selectedVariantId: 'v1' }).success).toBe(true)
+  })
+
+  it('rejects a variant missing selectedOptions', () => {
+    const bad = {
+      ...product,
+      variants: [{ id: 'v1', title: 'x', availableForSale: true, price: null }],
+    }
+    expect(productOverview1PropsSchema.safeParse({ product: bad }).success).toBe(false)
+  })
+})
+
+describe('cart item schemas — absent images are omitted, never ""', () => {
+  it('accepts a nav cart line without an image', () => {
+    expect(navCartItemSchema.safeParse({ id: 'l1', name: 'x', price: 1, qty: 1 }).success).toBe(true)
+  })
+
+  it('accepts a cart line without an image and with canonical money line totals', () => {
+    const result = cartItemSchema.safeParse({
+      id: 'l1',
+      name: 'x',
+      price: 1,
+      quantity: 1,
+      lineTotal: { amount: '1.00', currencyCode: 'USD' },
+    })
+    expect(result.success).toBe(true)
+  })
+})
+
+describe('optional brand seams — present, omitted, invalid', () => {
+  it('parses an accent with and without a className', () => {
+    expect(logoAccentSchema.parse({ text: 'Cuba' })).toEqual({ text: 'Cuba' })
+    expect(brandAccentSchema.parse({ text: 'Cuba', className: 'text-brand-promo' })).toEqual({
+      text: 'Cuba',
+      className: 'text-brand-promo',
+    })
+  })
+
+  it('parses an editorial hero image', () => {
+    expect(heroImageSchema.parse({ src: '/hero.png', alt: 'Taller' })).toEqual({
+      src: '/hero.png',
+      alt: 'Taller',
+    })
+  })
+
+  it('accepts navbar props with the accent omitted (backward compatible)', () => {
+    const base = {
+      storeCategories: [],
+      shippingNote: 'Catálogo en línea',
+      utilityLinks: [],
+      logoText: 'ElectroCuba',
+    }
+    const parsed = navbar4PropsSchema.parse(base)
+    expect(parsed.logoAccent).toBeUndefined()
+  })
+
+  it('accepts navbar props with the accent present', () => {
+    const parsed = navbar4PropsSchema.parse({
+      storeCategories: [],
+      shippingNote: 'Catálogo en línea',
+      utilityLinks: [],
+      logoText: 'ElectroCuba',
+      logoAccent: { text: 'Cuba', className: 'text-brand-promo' },
+    })
+    expect(parsed.logoAccent).toEqual({ text: 'Cuba', className: 'text-brand-promo' })
+  })
+
+  it('accepts navbar props with a surface className present or omitted', () => {
+    const base = {
+      storeCategories: [],
+      shippingNote: 'Catálogo en línea',
+      utilityLinks: [],
+      logoText: 'My Shop',
+    }
+    expect(navbar4PropsSchema.parse(base).className).toBeUndefined()
+    expect(navbar4PropsSchema.parse({ ...base, className: 'bg-brand-nav text-brand-nav-foreground' }).className).toBe(
+      'bg-brand-nav text-brand-nav-foreground',
+    )
+  })
+
+  it('rejects a malformed accent or hero image', () => {
+    expect(logoAccentSchema.safeParse({}).success).toBe(false)
+    expect(heroImageSchema.safeParse({ src: '/hero.png' }).success).toBe(false)
+  })
+})
+
+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í.' }
+
+  it('parses a valid faq payload', () => {
+    expect(faqBlock1PropsSchema.safeParse({ items: [faqItem], title: 'Preguntas' }).success).toBe(true)
+  })
+
+  it('parses a valid cta payload with a link or a callback-bound button', () => {
+    expect(ctaSchema.parse({ label: 'Ir', href: '/productos' })).toEqual({ label: 'Ir', href: '/productos' })
+    expect(ctaSection1PropsSchema.safeParse({ title: 'Compra', primaryCta: { label: 'Ir', href: '/x' } }).success).toBe(
+      true,
+    )
+    expect(ctaSection1PropsSchema.safeParse({ primaryCta: { label: 'Ir' } }).success).toBe(true)
+  })
+
+  it('rejects an unknown accordionType', () => {
+    expect(faqBlock1PropsSchema.safeParse({ items: [faqItem], accordionType: 'always' }).success).toBe(false)
+  })
+
+  it('rejects missing required items and item fields', () => {
+    expect(faqBlock1PropsSchema.safeParse({}).success).toBe(false)
+    expect(faqItemSchema.safeParse({ value: 'q1', question: '¿Envían?' }).success).toBe(false)
+    expect(faqItemSchema.safeParse({ question: '¿Envían?', answer: 'Sí.' }).success).toBe(false)
+  })
+
+  it('allows optional fields to be omitted', () => {
+    const faq = faqBlock1PropsSchema.parse({ items: [faqItem] })
+    expect(faq.title).toBeUndefined()
+    expect(faq.description).toBeUndefined()
+    expect(faq.accordionType).toBeUndefined()
+    const cta = ctaSection1PropsSchema.parse({})
+    expect(cta.badgeText).toBeUndefined()
+    expect(cta.primaryCta).toBeUndefined()
+  })
+
+  it('ignores React-only callbacks — they are not part of the serializable contract', () => {
+    const parsed = ctaSection1PropsSchema.parse({ title: 'X', onPrimaryClick: () => {} })
+    expect('onPrimaryClick' in parsed).toBe(false)
+  })
+})

package/src/lib/contracts-server-boundary.test.ts

@@ -0,0 +1,52 @@
+// Task 6.7: `use client` must apply only to the UI entrypoint, never to the
+// pure-Zod contracts entrypoint, so server code can import and compose schemas.
+// The tsup config previously applied a global `banner`, which leaked the
+// directive onto the contracts bundle; the fix moves it into the UI source.
+//
+// The server-importable *behavior* of the contracts entry is exercised in the
+// runtime catalog boundary test (`@thorprovider/runtime`), which imports
+// `@thorprovider/blocks/contracts` and calls `extend`/`parse` in a Node server
+// context. This test pins the directive placement and the build config.
+import { existsSync, readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { describe, expect, it } from 'vitest'
+
+function findPkgRoot(start: string): string {
+  let dir = start
+  while (dir !== dirname(dir)) {
+    const pkg = join(dir, 'package.json')
+    if (existsSync(pkg)) {
+      const parsed = JSON.parse(readFileSync(pkg, 'utf8'))
+      if (parsed.name === '@thorprovider/blocks') return dir
+    }
+    dir = dirname(dir)
+  }
+  throw new Error('@thorprovider/blocks package root not found')
+}
+
+const pkgRoot = findPkgRoot(process.cwd())
+const read = (...parts: string[]) => readFileSync(join(pkgRoot, ...parts), 'utf8')
+const USE_CLIENT = /^['"]use client['"]/
+
+describe('blocks entrypoint boundaries (6.7)', () => {
+  it('marks only the UI entrypoint as a client module', () => {
+    expect(USE_CLIENT.test(read('src', 'index.ts').trimStart())).toBe(true)
+    expect(USE_CLIENT.test(read('src', 'lib', 'contracts.ts').trimStart())).toBe(false)
+  })
+
+  it('has no global tsup banner that would leak use client onto contracts', () => {
+    expect(read('tsup.config.ts')).not.toMatch(/banner\s*:/)
+  })
+
+  it('builds a contracts bundle with no use client directive and a UI bundle with it', () => {
+    const distContracts = join(pkgRoot, 'dist', 'contracts.mjs')
+    const distIndex = join(pkgRoot, 'dist', 'index.mjs')
+    // dist/ is build output; validate it whenever a build has run.
+    if (existsSync(distContracts)) {
+      expect(USE_CLIENT.test(readFileSync(distContracts, 'utf8').trimStart())).toBe(false)
+    }
+    if (existsSync(distIndex)) {
+      expect(USE_CLIENT.test(readFileSync(distIndex, 'utf8').trimStart())).toBe(true)
+    }
+  })
+})