@ai-matrx/media 0.1.1 → 0.2.1

package/dist/react.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import react__default, { SVGProps, HTMLAttributes, InputHTMLAttributes, ReactNode } from 'react';
-import { MediaRefLike, MediaUploadOptions, MediaActionKind } from './index.cjs';
+import { MediaRefLike, DurableSrc, MediaUploadOptions, MediaActionKind } from './index.cjs';
 import { M as MediaUploadEntry } from './use-media-upload-v5Uq9Ruq.cjs';
 
 /**
@@ -45,6 +45,12 @@ declare function VolumeXIcon(props: MediaIconProps): react.JSX.Element;
 declare function XIcon(props: MediaIconProps): react.JSX.Element;
 declare function AlertCircleIcon(props: MediaIconProps): react.JSX.Element;
 declare function CheckCircle2Icon(props: MediaIconProps): react.JSX.Element;
+declare function GlobeIcon(props: MediaIconProps): react.JSX.Element;
+declare function Link2Icon(props: MediaIconProps): react.JSX.Element;
+declare function Settings2Icon(props: MediaIconProps): react.JSX.Element;
+declare function SpinnerIcon(props: MediaIconProps): react.JSX.Element;
+declare function PlusIcon(props: MediaIconProps): react.JSX.Element;
+declare function SearchIcon(props: MediaIconProps): react.JSX.Element;
 
 /**
  * src/react/file-icon.tsx — icon tile for any file or folder.
@@ -136,6 +142,18 @@ interface InlineMediaRefProps {
     preload?: "none" | "metadata" | "auto" | undefined;
     /** Space-separated native controls to hide — forwarded to `<video controlsList>`. */
     controlsList?: string | undefined;
+    /**
+     * Poster frame forwarded to `<video poster>`. Takes the branded
+     * {@link DurableSrc} only (law 3) — the host resolves/mints it, exactly
+     * like the element `src`; there is no raw-string lane.
+     */
+    poster?: DurableSrc | undefined;
+    /**
+     * Label reported to the host's playback-session port while this element
+     * plays (e.g. "Video (fullscreen)" in a lightbox). Default: `alt`, then
+     * "Media file".
+     */
+    playbackLabel?: string | undefined;
     rounded?: "none" | "sm" | "md" | "lg" | "full" | undefined;
     /** Click handler — wires up cursor + role + keyboard activation. */
     onClick?: ((event: react__default.MouseEvent | react__default.KeyboardEvent) => void) | undefined;
@@ -162,7 +180,7 @@ interface InlineMediaRefProps {
     border?: "none" | "subtle" | undefined;
     className?: string | undefined;
 }
-declare function InlineMediaRef({ ref: mediaRef, size, fit, fallback, fallbackIcon, errorFallback, alt, as, controls, autoPlay, loop, muted, playsInline, preload, controlsList, rounded, onClick, onError, onLoad, mediaElementRef, crossOrigin, border, className, }: InlineMediaRefProps): react__default.JSX.Element | null;
+declare function InlineMediaRef({ ref: mediaRef, size, fit, fallback, fallbackIcon, errorFallback, alt, as, controls, autoPlay, loop, muted, playsInline, preload, controlsList, poster, playbackLabel, rounded, onClick, onError, onLoad, mediaElementRef, crossOrigin, border, className, }: InlineMediaRefProps): react__default.JSX.Element | null;
 
 interface MediaThumbnailProps {
     /** The file's durable ref (a MediaRef or bare fileId). */
@@ -298,6 +316,21 @@ interface MediaLightboxProps {
     alt?: string | undefined;
     /** Force the media element type (default: inferred from the resolution). */
     as?: "img" | "video" | "audio" | undefined;
+    /** Start video/audio playback on open — forwarded to the media element. */
+    autoPlay?: boolean | undefined;
+    /** Inline (non-fullscreen-hijack) playback on iOS — forwarded to `<video>`. */
+    playsInline?: boolean | undefined;
+    /**
+     * Poster frame for video — the branded {@link DurableSrc} only (law 3),
+     * resolved/minted by the host exactly like the element src.
+     */
+    poster?: DurableSrc | undefined;
+    /**
+     * Playback-session label reported to the host's `playbackSession` port
+     * while the media plays (e.g. "Video (fullscreen)"). Rides the existing
+     * port — no new playback lane.
+     */
+    playbackLabel?: string | undefined;
     /** Toolbar actions to offer. Default: share, download, copy, open. */
     actions?: MediaActionKind[] | undefined;
     /** Hide unavailable toolbar actions instead of disabling them. */
@@ -306,6 +339,6 @@ interface MediaLightboxProps {
     headerExtra?: ReactNode | undefined;
     className?: string | undefined;
 }
-declare function MediaLightbox({ open, onClose, mediaRef, fileName, alt, as, actions, hideUnavailableActions, headerExtra, className, }: MediaLightboxProps): react.JSX.Element | null;
+declare function MediaLightbox({ open, onClose, mediaRef, fileName, alt, as, autoPlay, playsInline, poster, playbackLabel, actions, hideUnavailableActions, headerExtra, className, }: MediaLightboxProps): react.JSX.Element | null;
 
-export { AlertCircleIcon, ArchiveIcon, BracesIcon, CheckCircle2Icon, CheckIcon, CodeIcon, CopyIcon, DatabaseIcon, DownloadIcon, ExternalLinkIcon, FileAudioIcon, FileCodeIcon, FileIcon, type FileIconProps, FileJsonIcon, FileSpreadsheetIcon, FileTextIcon, FileTypeIcon, FileUploadDropzone, type FileUploadDropzoneActions, type FileUploadDropzoneProps, FileVideoIcon, FolderIcon, FolderOpenIcon, ImageIcon, ImageOffIcon, InlineMediaRef, type InlineMediaRefFit, type InlineMediaRefProps, type InlineMediaRefSize, MediaActionToolbar, type MediaActionToolbarProps, type MediaDropzoneOptions, type MediaDropzoneState, type MediaIconProps, MediaLightbox, type MediaLightboxProps, MediaThumbnail, type MediaThumbnailProps, MusicIcon, PackageBoxIcon, PenToolIcon, Share2Icon, SubtitlesIcon, UploadIcon, UploadProgressList, type UploadProgressListProps, VideoIcon, VideoOffIcon, VolumeXIcon, XIcon, cn, formatFileSize, useMediaDropzone };
+export { AlertCircleIcon, ArchiveIcon, BracesIcon, CheckCircle2Icon, CheckIcon, CodeIcon, CopyIcon, DatabaseIcon, DownloadIcon, ExternalLinkIcon, FileAudioIcon, FileCodeIcon, FileIcon, type FileIconProps, FileJsonIcon, FileSpreadsheetIcon, FileTextIcon, FileTypeIcon, FileUploadDropzone, type FileUploadDropzoneActions, type FileUploadDropzoneProps, FileVideoIcon, FolderIcon, FolderOpenIcon, GlobeIcon, ImageIcon, ImageOffIcon, InlineMediaRef, type InlineMediaRefFit, type InlineMediaRefProps, type InlineMediaRefSize, Link2Icon, MediaActionToolbar, type MediaActionToolbarProps, type MediaDropzoneOptions, type MediaDropzoneState, type MediaIconProps, MediaLightbox, type MediaLightboxProps, MediaThumbnail, type MediaThumbnailProps, MusicIcon, PackageBoxIcon, PenToolIcon, PlusIcon, SearchIcon, Settings2Icon, Share2Icon, SpinnerIcon, SubtitlesIcon, UploadIcon, UploadProgressList, type UploadProgressListProps, VideoIcon, VideoOffIcon, VolumeXIcon, XIcon, cn, formatFileSize, useMediaDropzone };

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import react__default, { SVGProps, HTMLAttributes, InputHTMLAttributes, ReactNode } from 'react';
-import { MediaRefLike, MediaUploadOptions, MediaActionKind } from './index.js';
+import { MediaRefLike, DurableSrc, MediaUploadOptions, MediaActionKind } from './index.js';
 import { M as MediaUploadEntry } from './use-media-upload-Dg2HSvTq.js';
 
 /**
@@ -45,6 +45,12 @@ declare function VolumeXIcon(props: MediaIconProps): react.JSX.Element;
 declare function XIcon(props: MediaIconProps): react.JSX.Element;
 declare function AlertCircleIcon(props: MediaIconProps): react.JSX.Element;
 declare function CheckCircle2Icon(props: MediaIconProps): react.JSX.Element;
+declare function GlobeIcon(props: MediaIconProps): react.JSX.Element;
+declare function Link2Icon(props: MediaIconProps): react.JSX.Element;
+declare function Settings2Icon(props: MediaIconProps): react.JSX.Element;
+declare function SpinnerIcon(props: MediaIconProps): react.JSX.Element;
+declare function PlusIcon(props: MediaIconProps): react.JSX.Element;
+declare function SearchIcon(props: MediaIconProps): react.JSX.Element;
 
 /**
  * src/react/file-icon.tsx — icon tile for any file or folder.
@@ -136,6 +142,18 @@ interface InlineMediaRefProps {
     preload?: "none" | "metadata" | "auto" | undefined;
     /** Space-separated native controls to hide — forwarded to `<video controlsList>`. */
     controlsList?: string | undefined;
+    /**
+     * Poster frame forwarded to `<video poster>`. Takes the branded
+     * {@link DurableSrc} only (law 3) — the host resolves/mints it, exactly
+     * like the element `src`; there is no raw-string lane.
+     */
+    poster?: DurableSrc | undefined;
+    /**
+     * Label reported to the host's playback-session port while this element
+     * plays (e.g. "Video (fullscreen)" in a lightbox). Default: `alt`, then
+     * "Media file".
+     */
+    playbackLabel?: string | undefined;
     rounded?: "none" | "sm" | "md" | "lg" | "full" | undefined;
     /** Click handler — wires up cursor + role + keyboard activation. */
     onClick?: ((event: react__default.MouseEvent | react__default.KeyboardEvent) => void) | undefined;
@@ -162,7 +180,7 @@ interface InlineMediaRefProps {
     border?: "none" | "subtle" | undefined;
     className?: string | undefined;
 }
-declare function InlineMediaRef({ ref: mediaRef, size, fit, fallback, fallbackIcon, errorFallback, alt, as, controls, autoPlay, loop, muted, playsInline, preload, controlsList, rounded, onClick, onError, onLoad, mediaElementRef, crossOrigin, border, className, }: InlineMediaRefProps): react__default.JSX.Element | null;
+declare function InlineMediaRef({ ref: mediaRef, size, fit, fallback, fallbackIcon, errorFallback, alt, as, controls, autoPlay, loop, muted, playsInline, preload, controlsList, poster, playbackLabel, rounded, onClick, onError, onLoad, mediaElementRef, crossOrigin, border, className, }: InlineMediaRefProps): react__default.JSX.Element | null;
 
 interface MediaThumbnailProps {
     /** The file's durable ref (a MediaRef or bare fileId). */
@@ -298,6 +316,21 @@ interface MediaLightboxProps {
     alt?: string | undefined;
     /** Force the media element type (default: inferred from the resolution). */
     as?: "img" | "video" | "audio" | undefined;
+    /** Start video/audio playback on open — forwarded to the media element. */
+    autoPlay?: boolean | undefined;
+    /** Inline (non-fullscreen-hijack) playback on iOS — forwarded to `<video>`. */
+    playsInline?: boolean | undefined;
+    /**
+     * Poster frame for video — the branded {@link DurableSrc} only (law 3),
+     * resolved/minted by the host exactly like the element src.
+     */
+    poster?: DurableSrc | undefined;
+    /**
+     * Playback-session label reported to the host's `playbackSession` port
+     * while the media plays (e.g. "Video (fullscreen)"). Rides the existing
+     * port — no new playback lane.
+     */
+    playbackLabel?: string | undefined;
     /** Toolbar actions to offer. Default: share, download, copy, open. */
     actions?: MediaActionKind[] | undefined;
     /** Hide unavailable toolbar actions instead of disabling them. */
@@ -306,6 +339,6 @@ interface MediaLightboxProps {
     headerExtra?: ReactNode | undefined;
     className?: string | undefined;
 }
-declare function MediaLightbox({ open, onClose, mediaRef, fileName, alt, as, actions, hideUnavailableActions, headerExtra, className, }: MediaLightboxProps): react.JSX.Element | null;
+declare function MediaLightbox({ open, onClose, mediaRef, fileName, alt, as, autoPlay, playsInline, poster, playbackLabel, actions, hideUnavailableActions, headerExtra, className, }: MediaLightboxProps): react.JSX.Element | null;
 
-export { AlertCircleIcon, ArchiveIcon, BracesIcon, CheckCircle2Icon, CheckIcon, CodeIcon, CopyIcon, DatabaseIcon, DownloadIcon, ExternalLinkIcon, FileAudioIcon, FileCodeIcon, FileIcon, type FileIconProps, FileJsonIcon, FileSpreadsheetIcon, FileTextIcon, FileTypeIcon, FileUploadDropzone, type FileUploadDropzoneActions, type FileUploadDropzoneProps, FileVideoIcon, FolderIcon, FolderOpenIcon, ImageIcon, ImageOffIcon, InlineMediaRef, type InlineMediaRefFit, type InlineMediaRefProps, type InlineMediaRefSize, MediaActionToolbar, type MediaActionToolbarProps, type MediaDropzoneOptions, type MediaDropzoneState, type MediaIconProps, MediaLightbox, type MediaLightboxProps, MediaThumbnail, type MediaThumbnailProps, MusicIcon, PackageBoxIcon, PenToolIcon, Share2Icon, SubtitlesIcon, UploadIcon, UploadProgressList, type UploadProgressListProps, VideoIcon, VideoOffIcon, VolumeXIcon, XIcon, cn, formatFileSize, useMediaDropzone };
+export { AlertCircleIcon, ArchiveIcon, BracesIcon, CheckCircle2Icon, CheckIcon, CodeIcon, CopyIcon, DatabaseIcon, DownloadIcon, ExternalLinkIcon, FileAudioIcon, FileCodeIcon, FileIcon, type FileIconProps, FileJsonIcon, FileSpreadsheetIcon, FileTextIcon, FileTypeIcon, FileUploadDropzone, type FileUploadDropzoneActions, type FileUploadDropzoneProps, FileVideoIcon, FolderIcon, FolderOpenIcon, GlobeIcon, ImageIcon, ImageOffIcon, InlineMediaRef, type InlineMediaRefFit, type InlineMediaRefProps, type InlineMediaRefSize, Link2Icon, MediaActionToolbar, type MediaActionToolbarProps, type MediaDropzoneOptions, type MediaDropzoneState, type MediaIconProps, MediaLightbox, type MediaLightboxProps, MediaThumbnail, type MediaThumbnailProps, MusicIcon, PackageBoxIcon, PenToolIcon, PlusIcon, SearchIcon, Settings2Icon, Share2Icon, SpinnerIcon, SubtitlesIcon, UploadIcon, UploadProgressList, type UploadProgressListProps, VideoIcon, VideoOffIcon, VolumeXIcon, XIcon, cn, formatFileSize, useMediaDropzone };

package/dist/react.js

@@ -243,6 +243,43 @@ function CheckCircle2Icon(props) {
     /* @__PURE__ */ jsx("path", { d: "m9 11 3 3L22 4" })
   ] });
 }
+function GlobeIcon(props) {
+  return /* @__PURE__ */ jsxs("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "10" }),
+    /* @__PURE__ */ jsx("path", { d: "M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20" }),
+    /* @__PURE__ */ jsx("path", { d: "M2 12h20" })
+  ] });
+}
+function Link2Icon(props) {
+  return /* @__PURE__ */ jsxs("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ jsx("path", { d: "M9 17H7A5 5 0 0 1 7 7h2" }),
+    /* @__PURE__ */ jsx("path", { d: "M15 7h2a5 5 0 1 1 0 10h-2" }),
+    /* @__PURE__ */ jsx("line", { x1: "8", x2: "16", y1: "12", y2: "12" })
+  ] });
+}
+function Settings2Icon(props) {
+  return /* @__PURE__ */ jsxs("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ jsx("path", { d: "M20 7h-9" }),
+    /* @__PURE__ */ jsx("path", { d: "M14 17H5" }),
+    /* @__PURE__ */ jsx("circle", { cx: "17", cy: "17", r: "3" }),
+    /* @__PURE__ */ jsx("circle", { cx: "7", cy: "7", r: "3" })
+  ] });
+}
+function SpinnerIcon(props) {
+  return /* @__PURE__ */ jsx("svg", { ...svgProps(props), children: /* @__PURE__ */ jsx("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) });
+}
+function PlusIcon(props) {
+  return /* @__PURE__ */ jsxs("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ jsx("path", { d: "M5 12h14" }),
+    /* @__PURE__ */ jsx("path", { d: "M12 5v14" })
+  ] });
+}
+function SearchIcon(props) {
+  return /* @__PURE__ */ jsxs("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ jsx("circle", { cx: "11", cy: "11", r: "8" }),
+    /* @__PURE__ */ jsx("path", { d: "m21 21-4.3-4.3" })
+  ] });
+}
 
 // src/core/file-kind.ts
 var ROWS = [
@@ -839,6 +876,8 @@ function InlineMediaRef({
   playsInline,
   preload,
   controlsList,
+  poster,
+  playbackLabel,
   rounded = "md",
   onClick,
   onError,
@@ -882,7 +921,7 @@ function InlineMediaRef({
     {
       isPlaying: isMediaPlaying,
       source: "file-media",
-      label: alt || "Media file",
+      label: playbackLabel ?? (alt || "Media file"),
       trackKey
     },
     sessionElRef
@@ -1023,6 +1062,7 @@ function InlineMediaRef({
         playsInline,
         preload,
         controlsList,
+        poster,
         onLoadedData: onLoad,
         onError: handleLoadError,
         crossOrigin,
@@ -1987,6 +2027,10 @@ function MediaLightbox({
   fileName,
   alt,
   as,
+  autoPlay,
+  playsInline,
+  poster,
+  playbackLabel,
   actions,
   hideUnavailableActions = false,
   headerExtra,
@@ -2065,7 +2109,11 @@ function MediaLightbox({
                 fit: "contain",
                 rounded: "none",
                 alt: alt ?? fileName ?? "",
-                as
+                as,
+                autoPlay,
+                playsInline,
+                poster,
+                playbackLabel
               }
             ) })
           }
@@ -2096,16 +2144,22 @@ export {
   FileVideoIcon,
   FolderIcon,
   FolderOpenIcon,
+  GlobeIcon,
   ImageIcon,
   ImageOffIcon,
   InlineMediaRef,
+  Link2Icon,
   MediaActionToolbar,
   MediaLightbox,
   MediaThumbnail,
   MusicIcon,
   PackageBoxIcon,
   PenToolIcon,
+  PlusIcon,
+  SearchIcon,
+  Settings2Icon,
   Share2Icon,
+  SpinnerIcon,
   SubtitlesIcon,
   UploadIcon,
   UploadProgressList,