@thorprovider/blocks 0.1.0 → 0.1.2

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
 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
+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

package/.turbo/turbo-test.log

@@ -1,10 +1,37 @@
 
  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/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
+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/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
+
+ 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)
 

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

@@ -91,6 +91,53 @@ 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.
+
 ## 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 +196,11 @@ 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`.
+
 ## Block interaction contracts
 
 State and events between a block, its host registry, and the store must follow