hwc-media-content

用途：在 Hotwire 应用中实现以媒体为核心的功能，包括上传与预览、播放控制、进度持久化，以及嵌入式媒体库集成。主要能力：媒体状态放在 Stimulus values 中，通过 value 回调与 targets 桥接第三方 API；优先使用浏览器原生能力（URL.createObjectURL、Picture-in-Picture、IntersectionObserver、MediaSession）；对图片/文件预览，渲染后需撤销 blob URL；对 PiP、Web Share、MediaSession 等做特性检测；时间型 UI（歌词、轮播、进度组件）保持帧更新增量进行。使用方式：先用 references/INDEX.md 查看完整目录，按当前请求选择性打开单个参考文件，如 blob URL 图片上传预览、渐进式图片加载与 Blurhash、画中画、视频进度跟踪、WaveSurfer 添加/移除标记、Turbo Frames 同步歌词、Turbo Frames 配合 Swiper 自动播放。在 disconnect() 中清理所有分配的资源（观察器、blob URL、播放器实例、定时器），只持久化有意的客户端状态并在加载时协调。限制与边界：不混合传输层关注点，媒体渲染属于本技能，流编排应交给实时技能；推送数据更新或自定义 Turbo Stream 用 hwc-realtime-streaming，分页/标签/过滤导航用 hwc-navigation-content，表单生命周期与校验用 hwc-forms-validation，通用加载/进度/过渡 UX 用 hwc-ux-feedback，纯 Stimulus API 架构用 hwc-stimulus-fundamentals。资料未提供具体安装命令、收费与价格信息。