1.4.0

Released 2026-08-14

Adds the <Video> primitive. Only @dashforge/tw advances — the tw-theme / tw-tokens pair stays on 1.2.0.

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

Affected packages

What's new

<Video>

The moving-image twin of <Image> — a thin, declarative wrapper over the native <video>, on the same anti-CLS + loading + fallback machinery:

• No layout shift. aspectRatio (or width + height) reserves the box before load.
• Poster + skeleton. A poster shows before playback and is the loading visual; without one a cache-aware <Skeleton> fills the reserved box until the first frame is ready (no flash).
• Graceful error. On failure a muted fallback replaces the player (fallback to customise).
• Controls on by default; autoPlay / loop / muted / playsInline / preload and any other native <video> attribute are forwarded, and <source> children are supported for multi-format delivery.

fit (CSS object-fit) and rounded are Option C configurable via theme.components.Video.defaults; sx / slotProps cover per-instance and per-slot overrides. It also supports access (RBAC) and visibleWhen gating, exactly like <Image>.

<Video src="/demo.mp4" poster="/demo.jpg" aspectRatio={16 / 9} rounded="lg" />

// Background-style loop (autoplay requires muted)
<Video src="/loop.webm" aspectRatio={1} autoPlay loop muted playsInline controls={false} />

Full docs + live demos: Components → Video.

Migration

Drop-in for everything already using 1.3.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.