@propeller-commerce/propeller-v2-react-ui 0.26.1 → 0.28.0

package/CHANGELOG.md

@@ -8,6 +8,89 @@ once it reaches 1.0. Until then (the `0.x` line) the public API may change
 between minor versions; breaking changes are called out below and in
 [MIGRATION.md](./MIGRATION.md).
 
+## [0.28.0] - 2026-10-02
+
+### Added
+
+- **`imgComponent` on `<PropellerDepsProvider>` — one setting routes every
+  image through the host’s image component.** Components rendered a bare
+  `<img src="https://media.…">`, so catalog images were fetched straight from
+  the media CDN. That CDN sends no `X-Robots-Tag` and serves no `robots.txt`,
+  so those images sat outside the storefront’s crawler directives and got none
+  of the host framework’s image optimisation. The existing `imageComponent`
+  slot could not close this: it takes a `product`/`cluster` and resolves the
+  URL itself, so it only fitted five surfaces, and the other nineteen image
+  sites had already resolved a URL string by render time. Set `imgComponent`
+  once on the provider and images across the package route through it,
+  including components added later. Optional — omitting it keeps the previous
+  markup. (PWP-1001)
+- **`<PropellerImg>` and `useImgComponent()` are exported.** Hosts composing
+  their own cards get the same seam; `<PropellerImg>` is also on the `/pure`
+  entry for Server Components.
+- **`OrderItemCard` accepts `imgComponent` as a prop.** It is `@rsc-safe` and
+  reads no context, so the provider cannot reach it — same direct-prop
+  convention as its existing `priceComponent` / `stockComponent`.
+
+### Changed
+
+- **Nineteen image sites now render `<PropellerImg>`** across `ProductCard`,
+  `ClusterCard`, `ProductGallery`, `CartItem`, `OrderItemCard`, `SearchBar`,
+  `ProductBundles`, `MachineCard`, `AddToCart`, `QuickOrder`, `ItemsOverview`,
+  `FavoriteListItem`, `FavoriteListDetails`, `ClusterOptions`,
+  `ClusterConfigurator`, `CartBonusItems` and `DefaultProductImage`. Markup is
+  unchanged when no component is injected.
+- **Carrier and payment-provider logos stay plain `<img>`.** Their domains sit
+  outside the host’s image allowlist, so routing them through a framework
+  image component would stop them loading. They are catalog-external and not
+  crawlable.
+- **`npm run check:img` fails the build on a raw `<img>`.** The seam only holds
+  if new components use it, and a raw `<img>` opts a surface out silently.
+  Wired into `validate` and `prepublishOnly`.
+
+### Fixed
+
+- **The "no image" placeholder was two different icons.** Cards, favourites and
+  `DefaultProductImage` drew one glyph; cart rows, the cart drawer, bundles, the
+  add-to-cart modal and the checkout overview drew another, at a heavier stroke
+  weight — so the same missing-image product looked like two different states
+  depending on which surface showed it. All of them now use the card icon at a
+  consistent stroke weight. The machine card keeps its own glyph, which is
+  deliberate.
+- **The cart drawer’s image box did not centre its contents.** It overrides
+  `CartItem.Image`’s class, and the override dropped the flex centring, so the
+  placeholder sat top-left at its natural size instead of filling the box.
+- **Placeholder icons were exposed to screen readers.** They carry no
+  information the row does not already state in text, so they now set
+  `aria-hidden`, matching what `DefaultProductImage` already did.
+---
+
+## [0.27.0] - 2026-09-28
+
+### Fixed
+
+- **A quantity field could not be cleared and retyped.** The typed-input handler
+  only committed a value once it was at or above the minimum, so with a minimum
+  of 2, backspacing to empty or typing "1" was ignored and the previous number
+  stayed stuck in the box. The field now accepts any keystroke while editing and
+  resolves to a valid quantity on blur. (PWP-970)
+
+- **Incrementing an off-grid quantity kept it off-grid.** `increment()` added the
+  step without first snapping to the `min + n*step` grid, so a quantity that was
+  already off it never returned. Both steppers now snap first. (PWP-970)
+
+- **Quick order ignored the order step.** Its quantity input was hardcoded to
+  `step={1}` and nothing snapped, while bulk paste and spreadsheet upload are the
+  primary ordering route for a wholesale account. `QuickOrderMatch` now carries
+  `step` alongside `minQuantity`, and typed quantities snap to it. (PWP-970)
+
+- **`OrderItemCard` accepted a misconfiguration in silence.** It ships from the
+  RSC-safe `/pure` entry and reads no context, so the host must supply `language`
+  and `configuration.urls` — but both are optional, nothing warned, and the
+  failure only showed as a wrong-language name or a link that dropped the locale
+  prefix two clicks later. A development-only warning now names each omission
+  once. `titleLinkable` defaults to true, so the link case applies unless a host
+  opts out. (PWP-972)
+
 ## [0.26.1] - 2026-09-28
 
 ### Fixed