Media Package

@prox-os/media defines media resource contracts and UI primitives for images, avatars, icons, covers, screenshots, galleries, embeds, external links, and future context actions.

Scope

• OsImage
• OsAvatar
• OsIconImage
• OsCoverImage
• OsImageGrid
• OsMediaCard
• OsMediaPreview
• OsEmbedFrame
• OsYouTubeEmbed
• OsExternalLinkPreview

The package emits media action intent. The OS Shell decides how a future system context menu executes open, copy, save, inspect, or transform actions.

Roadmap

• Phase 2: Cloudflare Images, Image Transformations, R2, signed URLs, and Worker policy adapters.
• Phase 3: OS Media Library app with uploads, metadata, provenance, search, and workspace permissions.

Storybook

Open UI Workshop and look under Media for image, avatar, gallery, external link, embed, context action, and transform preview stories.