1.3.0

Released 2026-08-14

Adds the <Image> primitive. Only @dashforge/tw advances — the tw-theme / tw-tokens pair stays on 1.2.0 (no token or theme-runtime change).

No breaking changes. Every existing consumer works unchanged — the addition is purely additive on top of the 1.2.0 surface.

Affected packages

What's new

<Image>

A thin, declarative wrapper over the native <img>. Zero eval, no data fetching — it renders a URL you give it and adds the three things a bare <img> lacks:

• No layout shift. aspectRatio (or width + height) reserves the box before load via CSS aspect-ratio — no JS measurement, no reflow when the image arrives.
• Loading skeleton. A skeleton fills the reserved box while loading and is skipped for already-cached images (read via .complete at mount, so no flash).
• Graceful error. On failure a muted surface with a broken-image glyph replaces the image; pass your own via fallback.
• Lazy by default (loading="lazy"); native <img> attributes (srcSet, sizes, decoding, …) are forwarded.

fit (CSS object-fit) and rounded are Option C configurable via theme.components.Image.defaults; sx / slotProps cover per-instance and per-slot overrides.

patchTheme({ components: { Image: { defaults: { rounded: 'md', fit: 'cover' } } } });

<Image src={photo} alt="Product" aspectRatio={16 / 9} rounded="lg" />

It also supports access (RBAC) and visibleWhen gating like the form components — onUnauthorized: 'hide' removes the image, 'disable' / 'readonly' render it dimmed and non-interactive.

Full docs + live demos: Components → Image.

Fixes

• The exported VERSION constant had drifted to 1.1.1; it now tracks the package version.

Migration

Drop-in for everything already using 1.2.0. The addition is opt-in; nothing renamed, nothing removed. tw-theme / tw-tokens do not need to move.

pnpm update @dashforge/tw

Compatibility

No new runtime dependencies.