@thorprovider/blocks 0.1.2 → 0.1.3

package/.turbo/turbo-build.log

@@ -6,19 +6,19 @@ CLI Target: esnext
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
+ESM dist/contracts.mjs     11.75 KB
+ESM dist/index.mjs         778.08 KB
+ESM dist/contracts.mjs.map 29.49 KB
+ESM dist/index.mjs.map     1.29 MB
+ESM ⚡️ Build success in 228ms
+CJS dist/contracts.js     16.83 KB
+CJS dist/index.js         878.89 KB
+CJS dist/contracts.js.map 29.69 KB
+CJS dist/index.js.map     1.27 MB
+CJS ⚡️ Build success in 229ms
 DTS Build start
-ESM dist/contracts.mjs     10.65 KB
-ESM dist/index.mjs         751.64 KB
-ESM dist/contracts.mjs.map 26.52 KB
-ESM dist/index.mjs.map     1.24 MB
-ESM ⚡️ Build success in 1060ms
-CJS dist/contracts.js     15.38 KB
-CJS dist/index.js         849.47 KB
-CJS dist/contracts.js.map 26.72 KB
-CJS dist/index.js.map     1.22 MB
-CJS ⚡️ Build success in 1061ms
-DTS ⚡️ Build success in 15393ms
-DTS dist/index.d.ts      107.68 KB
-DTS dist/contracts.d.ts  52.25 KB
-DTS dist/index.d.mts     107.68 KB
-DTS dist/contracts.d.mts 52.25 KB
+DTS ⚡️ Build success in 10197ms
+DTS dist/index.d.ts      120.86 KB
+DTS dist/contracts.d.ts  57.89 KB
+DTS dist/index.d.mts     120.86 KB
+DTS dist/contracts.d.mts 57.89 KB

package/.turbo/turbo-test.log

@@ -1,37 +1,47 @@
 
  RUN  v3.2.4 /home/nelson/dev/active/thorprovider/repos/thorcommerce/packages/blocks
 
- ✓ src/lib/money.test.ts (10 tests) 391ms
-   ✓ formatMoney > uses the money currency rather than a hardcoded one  335ms
- ✓ src/blocks/e-commerce/navigation/mega-menu.test.tsx (9 tests) 546ms
- ✓ src/blocks/e-commerce/navigation/mobile-category-drawer.test.tsx (12 tests) 271ms
- ✓ src/blocks/e-commerce/product-overview/product-overview-1.test.tsx (14 tests) 87ms
- ✓ src/blocks/e-commerce/navigation/category-icon.test.tsx (7 tests) 195ms
- ✓ src/blocks/e-commerce/checkout-forms/checkout-confirmation.test.tsx (7 tests) 449ms
- ✓ src/blocks/e-commerce/shopping-carts/shopping-cart-4.test.tsx (10 tests) 435ms
- ✓ src/blocks/e-commerce/product-categories/product-category-2.test.tsx (5 tests) 351ms
- ✓ src/blocks/marketing/footers/footer-section-1.test.tsx (9 tests) 371ms
- ✓ src/lib/contracts-curated.test.ts (22 tests) 78ms
- ✓ src/lib/contracts-server-boundary.test.ts (3 tests) 662ms
-   ✓ blocks entrypoint boundaries (6.7) > builds a contracts bundle with no use client directive and a UI bundle with it  655ms
- ✓ src/blocks/marketing/navbars/navbar-4.test.tsx (11 tests) 709ms
-   ✓ Navbar4 — optional logo accent > accents a matched trailing segment without duplicating the wordmark  399ms
- ✓ src/lib/contracts.test.ts (3 tests) 67ms
- ✓ src/blocks/e-commerce/checkout-forms/card-formatting.test.ts (10 tests) 49ms
- ✓ src/lib/cart.test.ts (2 tests) 24ms
+ ✓ src/blocks/e-commerce/navigation/mega-menu.test.tsx (9 tests) 1189ms
+   ✓ MegaMenu > renders category columns from the categories prop  627ms
+ ✓ src/blocks/e-commerce/navigation/mobile-category-drawer.test.tsx (12 tests) 1191ms
+   ✓ MobileCategoryDrawer > keeps the drawer mounted off-screen with aria-hidden when closed  728ms
+ ✓ src/blocks/e-commerce/product-categories/product-category-2.test.tsx (5 tests) 329ms
 stderr | src/blocks/e-commerce/checkout-forms/checkout-form-1.test.tsx > CheckoutForm1 payment step — launch flow collects no raw card data > renders card fields only in the explicit legacy mode
 Received `true` for a non-boolean attribute `inline-end`.
 
 If you want to write it to the DOM, pass a string instead: inline-end="true" or inline-end={value.toString()}.
 
- ✓ src/blocks/e-commerce/category-filters/category-filter-2.test.tsx (39 tests) 1069ms
-   ✓ CategoryFilter2 — controlled canonical query > renders the query-selected search, category, sort and page values  307ms
- ✓ src/blocks/e-commerce/checkout-forms/checkout-form-1.test.tsx (10 tests) 739ms
- ✓ src/blocks/e-commerce/storefront-hero/storefront-hero-1.test.tsx (5 tests) 107ms
- ✓ src/blocks/marketing/navbars/navbar-4-cart-sheet.test.tsx (3 tests) 52ms
+ ✓ src/blocks/e-commerce/checkout-forms/checkout-form-1.test.tsx (10 tests) 337ms
+ ✓ src/blocks/e-commerce/checkout-forms/checkout-confirmation.test.tsx (7 tests) 567ms
+ ✓ src/blocks/marketing/footers/footer-section-1.test.tsx (9 tests) 208ms
+ ✓ src/blocks/e-commerce/shopping-carts/shopping-cart-4.test.tsx (17 tests) 704ms
+ ✓ src/blocks/e-commerce/product-list/product-card-1.test.tsx (8 tests) 855ms
+ ✓ src/blocks/marketing/navbars/navbar-4-cart-sheet.test.tsx (15 tests) 583ms
+   ✓ Navbar4CartSheet — authoritative subtotal > never renders a fake zero for a supplied but absent/malformed subtotal  430ms
+ ✓ src/blocks/e-commerce/navigation/skip-to-content.test.tsx (5 tests) 52ms
+ ✓ src/blocks/marketing/navbars/navbar-4.test.tsx (19 tests) 851ms
+ ✓ src/lib/money.test.ts (10 tests) 473ms
+   ✓ formatMoney > uses the money currency rather than a hardcoded one  371ms
+ ✓ src/lib/contracts-server-boundary.test.ts (3 tests) 92ms
+ ✓ src/blocks/e-commerce/navigation/mobile-bottom-nav.test.tsx (7 tests) 446ms
+ ✓ src/blocks/e-commerce/category-filters/category-filter-2.test.tsx (39 tests) 2736ms
+   ✓ CategoryFilter2 — controlled canonical query > renders the query-selected search, category, sort and page values  428ms
+   ✓ CategoryFilter2 — controlled canonical query > renders collection controls when collections are supplied  354ms
+   ✓ CategoryFilter2 — no fabricated price or sort choices > omits the price control without a real backend range  301ms
+ ✓ src/blocks/e-commerce/navigation/category-icon.test.tsx (7 tests) 584ms
+ ✓ src/blocks/e-commerce/storefront-hero/storefront-hero-1.test.tsx (6 tests) 867ms
+   ✓ StorefrontHero1 — optional editorial image > renders no editorial image when none is supplied  325ms
+ ✓ src/lib/contracts.test.ts (3 tests) 33ms
+ ✓ src/lib/cart.test.ts (2 tests) 23ms
+ ✓ src/blocks/e-commerce/product-overview/product-overview-1.test.tsx (14 tests) 200ms
+ ✓ src/blocks/e-commerce/navigation/breadcrumb.test.tsx (12 tests) 80ms
+ ✓ src/blocks/e-commerce/navigation/back-to-top.test.tsx (5 tests) 23ms
+ ✓ src/blocks/e-commerce/checkout-forms/card-formatting.test.ts (10 tests) 10ms
+ ✓ src/lib/contracts-curated.test.ts (22 tests) 550ms
+ ✓ src/blocks/e-commerce/product-list/product-showcase-1.test.tsx (7 tests) 498ms
 
- Test Files  19 passed (19)
-      Tests  191 passed (191)
-   Start at  10:20:45
-   Duration  9.78s (transform 6.28s, setup 0ms, collect 46.63s, tests 6.65s, environment 7ms, prepare 11.77s)
+ Test Files  25 passed (25)
+      Tests  263 passed (263)
+   Start at  11:37:52
+   Duration  16.34s (transform 12.71s, setup 0ms, collect 81.98s, tests 13.48s, environment 33ms, prepare 18.67s)
 

package/README.md

@@ -60,6 +60,7 @@ Blocks follow `src/blocks/<category>/<section>/<block>.tsx`. Each block co-locat
 | `ProductCard2` | E-commerce | Clean three-up grid with ratings |
 | `ProductCard3` | E-commerce | Deals grid with badges, low-stock and wishlist |
 | `ProductCard5` | E-commerce | Table-style comparison with sorting and filtering |
+| `ProductShowcase1` | E-commerce | Combined grid-and-carousel of product cards with manual paging |
 | `ProductOverview1` | E-commerce | Product detail with gallery, variants and add-to-cart |
 | `ProductQuickView` | E-commerce | Quick-view dialog with gallery, variants and quantity |
 | `ReviewRating1` | E-commerce | Review list with rating summary |
@@ -72,7 +73,7 @@ Blocks follow `src/blocks/<category>/<section>/<block>.tsx`. Each block co-locat
 | `CategoryFilter2` | E-commerce | Filter sidebar with mobile sheet |
 | `ShoppingCart1` | E-commerce | Detailed cart summary |
 | `ShoppingCart2` | E-commerce | Cart with promo code and shipping |
-| `ShoppingCart4` | E-commerce | Collapsible cart drawer with promotion progress |
+| `ShoppingCart4` | E-commerce | Cart review with backend-authoritative totals; `presentation` `compact` (collapsible card) or `page` (full-width review) |
 | `CheckoutForm1` | E-commerce | Essential checkout fields |
 | `CheckoutForm2` | E-commerce | Single-page checkout with order summary beside |
 | `CheckoutConfirmation` | E-commerce | Order confirmation with fulfilment timeline |
@@ -138,6 +139,37 @@ paints white-on-light. No magic colors are introduced by the block.
 `onSubmit` renders no form, input, or button — never a fake form. Omit
 `newsletter` entirely to hide the newsletter block.
 
+## Cart presentation (controlled)
+
+The cart is presented in two shapes that share one data contract, so a change in
+either is visible in the other.
+
+- `ShoppingCart4` is the cart block. Its optional `presentation` prop selects
+  `'compact'` (default: a collapsible `max-w-md` card with an internal scroller —
+  the navbar lateral) or `'page'` (always expanded, full-width `max-w-3xl`, no
+  collapse control, ordinary page scrolling — the `/cart` review route).
+  Omitting `presentation` renders the compact card byte-identically to before.
+- Line amounts prefer the canonical `lineTotal?: Money` and fall back to the
+  legacy numeric `price * quantity` only when `lineTotal` is absent. A missing or
+  malformed `Money` renders the `amountUnavailableLabel` (never a fabricated
+  zero or a currency fallback). `unitPrice?: Money` is carried verbatim.
+- `totalsState` (`'idle' | 'pending' | 'error'`) plus `onRetryTotals` make the
+  totals controlled: pending retains the last confirmed totals and disables
+  conflicting mutations; error shows the error label and a retry.
+  `onQuantityChange(id, quantity)` reports the **absolute** line quantity (keyed
+  by backend line id) and `onRemove(id)` removes by the same id.
+  `checkoutUnavailable` hides the checkout action (e.g. no checkout installed)
+  and `checkoutDisabled` disables it (e.g. pending or invalid totals).
+
+`Navbar4` owns the lateral. Pass `cartOpen` + `onCartOpenChange` to control the
+sheet's visibility from host state (omit both to keep the legacy uncontrolled
+sheet); the block keeps `aria-expanded`/`data-state` in sync. Its cart sheet
+(`Navbar4CartSheet`) takes an optional `canonical` mode where each line shows the
+canonical `lineTotal` (never the placeholder numeric price), plus
+`checkoutUnavailable`/`viewCartUnavailable` to hide actions the store cannot
+serve, and a `state` (`'idle' | 'pending' | 'error'`) with retry for read/mutation
+feedback.
+
 ## Checkout blocks (controlled)
 
 `CheckoutForm1` (3-step wizard) and `CheckoutForm2` (single page) are **controlled components**: they receive the current form values through a `values` prop and report every edit through `onChange`. They hold no internal form state, so a renderer's validation context can read field values from its own state model. `CheckoutForm3` (4-step wizard) keeps the same contract with internal step state.
@@ -201,6 +233,15 @@ Optional numeric projections are omitted rather than fabricated: e.g.
 finite non-negative number (a real `0` is preserved); an unknown count renders
 no count text, never a fabricated `0`.
 
+Product presentations (`ProductCard1`, `ProductShowcase1`) accept either the
+legacy numeric-price props or a canonical `ProductPresentation` (`price`/
+`compareAtPrice` as `Money`, `{ amount: string, currencyCode: string }` in
+decimal major units). The canonical path formats with the store currency and
+locale, renders a truthful "unavailable" state for an unresolved price (never
+`$0`; a valid `0` is preserved), and shows a comparison price only when it is
+valid and strictly higher. Optional rating/badge/image appear only when
+supplied; a missing image is omitted, never `src=""`.
+
 ## Block interaction contracts
 
 State and events between a block, its host registry, and the store must follow