@thorprovider/blocks 0.1.1 → 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
-CJS dist/contracts.js     8.15 KB
-CJS dist/index.js         801.34 KB
-CJS dist/contracts.js.map 12.65 KB
-CJS dist/index.js.map     1.13 MB
-CJS ⚡️ Build success in 801ms
-ESM dist/contracts.mjs     5.12 KB
-ESM dist/index.mjs         708.79 KB
-ESM dist/contracts.mjs.map 12.54 KB
-ESM dist/index.mjs.map     1.14 MB
-ESM ⚡️ Build success in 815ms
+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
-DTS ⚡️ Build success in 17297ms
-DTS dist/index.d.ts      86.38 KB
-DTS dist/contracts.d.ts  17.94 KB
-DTS dist/index.d.mts     86.38 KB
-DTS dist/contracts.d.mts 17.94 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,10 +1,47 @@
 
  RUN  v3.2.4 /home/nelson/dev/active/thorprovider/repos/thorcommerce/packages/blocks
 
- ✓ src/blocks/e-commerce/checkout-forms/card-formatting.test.ts (10 tests) 14ms
+ ✓ 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`.
 
- Test Files  1 passed (1)
-      Tests  10 passed (10)
-   Start at  16:54:02
-   Duration  1.03s (transform 162ms, setup 0ms, collect 93ms, tests 14ms, environment 0ms, prepare 252ms)
+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/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  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/AGENTS.md

@@ -1 +1 @@
-<!-- BLOCKS-AGENTS-MD-START -->[@thorprovider/blocks Docs]|root: ./blocks|Documentation for @thorprovider/blocks. Always read package docs before making changes.|To regenerate: yarn workspace @thorprovider/blocks generate:agent-index|.:{README.md}|docs/standards:{data-contracts.md,theming.md}<!-- BLOCKS-AGENTS-MD-END -->
+<!-- BLOCKS-AGENTS-MD-START -->[@thorprovider/blocks Docs]|root: ./blocks|Electrostore MVP: see director roadmap.|To regenerate: yarn workspace @thorprovider/blocks generate:agent-index|.:{README.md}|docs/standards:{data-contracts.md,theming.md}<!-- BLOCKS-AGENTS-MD-END -->

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 |
@@ -91,6 +92,84 @@ Blocks follow `src/blocks/<category>/<section>/<block>.tsx`. Each block co-locat
 
 Interactions are exposed as callbacks (e.g. `onAddToCart`, `onBuyNow`, `onSelectColor`). Elements stay in the DOM with no-op behavior when a callback is absent.
 
+## Optional brand props
+
+Three existing blocks expose an optional brand seam. Omitting the prop renders
+the block's current output unchanged; no demo content is added.
+
+- `Navbar4` — `logoAccent?: { text: string; className?: string }` accents a
+  trailing segment of `logoText`. With `logoText="ElectroCuba"` and
+  `logoAccent={{ text: 'Cuba', className: 'text-brand-promo' }}`, the block
+  renders `Electro` plus an accented `Cuba` span. If `text` is not a trailing
+  segment of `logoText`, the wordmark renders unchanged.
+- `FooterSection1` — `brandAccent?: { text: string; className?: string }` applies
+  the same trailing-segment accent to `brandName`.
+- `StorefrontHero1` — `heroImage?: { src: string; alt: string }` renders a native
+  `<img>` when `src` is a non-empty string, and nothing when the prop is absent
+  or `src` is blank (never an empty `src`). The product grid is unaffected.
+
+`className` carries the consumer's own semantic token (e.g. `text-brand-promo`);
+the library hardcodes no brand color.
+
+## Custom surface `className`
+
+`Navbar4` (outer `<header>`) and `FooterSection1` (outer `<footer>`) accept an
+optional `className`, merged with the existing `cn` helper. It is purely
+presentational: no layout, structure, or behavior prop, and no hardcoded color.
+
+- **Omitted `className`** — the block renders its default surface unchanged.
+  `Navbar4` keeps `bg-background/95` **and** its
+  `supports-backdrop-filter:bg-background/80` variant; `FooterSection1` keeps
+  `bg-secondary`.
+- **Supplied `className`** — the consumer owns the surface. The default
+  background **and its backdrop-filter variant** are not applied, so a semantic
+  surface such as `bg-brand-nav text-brand-nav-foreground` actually paints (the
+  `supports-backdrop-filter` variant would otherwise win on Chromium and mask
+  it). Layout, border, sticky, and `backdrop-blur-md` classes stay internal.
+
+The consumer is responsible for the text, transparency, and context tokens of a
+supplied surface. `Navbar4` adapts its primary nav links: they inherit the
+surface text color and add `hover:text-foreground` so `hover:bg-muted` never
+paints white-on-light. No magic colors are introduced by the block.
+
+## Footer newsletter
+
+`FooterSection1` renders the interactive newsletter form (input + submit button)
+**only** when `newsletter.onSubmit` is supplied. A `newsletter` object without
+`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.
@@ -149,6 +228,20 @@ unique by contract, not by convention. See
 [`docs/standards/data-contracts.md`](docs/standards/data-contracts.md) for the
 rules and the review checklist.
 
+Optional numeric projections are omitted rather than fabricated: e.g.
+`ProductCategory2Category.itemCount` renders a count only when it is a supplied
+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