@ai-matrx/media 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-matrx/media
 
+## 0.2.1 — 2026-08-30
+
+Additive only — every default unchanged. Closes the wave-2 gap that kept the
+host's video lightbox host-side: `MediaLightbox` had no video passthrough.
+
+- **`MediaLightbox`** gains `autoPlay`, `playsInline`, `poster`, and
+  `playbackLabel`, forwarded to the underlying `InlineMediaRef`:
+  - `poster` is typed as the branded `DurableSrc` (law 3 — the host
+    resolves/mints it, exactly like the element src; no raw-string lane);
+  - `playbackLabel` sets the label reported to the host's existing
+    `playbackSession` port while the media plays (e.g. "Video
+    (fullscreen)") — playback still rides the ONE port, no new lane.
+- **`InlineMediaRef`** gains the same two new props (`poster` →
+  `<video poster>`; `playbackLabel` → the playback-session registration,
+  defaulting to `alt` then "Media file" as before). `autoPlay`/`playsInline`
+  already existed there.
+
 ## 0.2.0 — 2026-08-29
 
 **THE SHARE MANDATE row is satisfied (wave M-SHARE, ruling C19).** The

package/dist/react.cjs

@@ -938,6 +938,8 @@ function InlineMediaRef({
   playsInline,
   preload,
   controlsList,
+  poster,
+  playbackLabel,
   rounded = "md",
   onClick,
   onError,
@@ -981,7 +983,7 @@ function InlineMediaRef({
     {
       isPlaying: isMediaPlaying,
       source: "file-media",
-      label: alt || "Media file",
+      label: playbackLabel ?? (alt || "Media file"),
       trackKey
     },
     sessionElRef
@@ -1122,6 +1124,7 @@ function InlineMediaRef({
         playsInline,
         preload,
         controlsList,
+        poster,
         onLoadedData: onLoad,
         onError: handleLoadError,
         crossOrigin,
@@ -2080,6 +2083,10 @@ function MediaLightbox({
   fileName,
   alt,
   as,
+  autoPlay,
+  playsInline,
+  poster,
+  playbackLabel,
   actions,
   hideUnavailableActions = false,
   headerExtra,
@@ -2158,7 +2165,11 @@ function MediaLightbox({
                 fit: "contain",
                 rounded: "none",
                 alt: alt ?? fileName ?? "",
-                as
+                as,
+                autoPlay,
+                playsInline,
+                poster,
+                playbackLabel
               }
             ) })
           }