用途：@blecsd/media 是 blECSd 终端应用的媒体处理包，用于在终端中渲染图像、GIF、PNG 和视频，涵盖 GIF/PNG 解析、ANSI 渲染、图像控件、视频播放与 W3M 叠加。
安装：pnpm add @blecsd/media；对等依赖 blecsd >= 0.7.0。支持子路径导入（如 @blecsd/media/gif、/png、/render、/widgets/image、/widgets/video、/overlay）或主入口命名空间 API。
主要能力：GIF 解析器含 LZW 解压与动画帧支持，提供 parseGIF、frameToRGBA、validateGIFSignature 等；PNG 解析器含过滤器重建，提供 parsePNG、extractPixels、parseChunks 等；ANSI 渲染提供 renderToAnsi、scaleBitmap、cellMapToString、rgbTo256Color，渲染模式有 halfblock（默认）、braille（每格 2x4 像素，密度最高）、ascii（兼容性最好）。图像控件提供 createImage、setImageData、play/pause/stop、setFrame 等，自动处理动画计时。视频控件通过外部 mpv 或 mplayer 播放，提供 createVideo、detectVideoPlayer、getVideoPlaybackState 等。W3M 叠加使用 createW3MOverlay 调用 W3M 终端图形协议。
用法要点：先解析文件再用 scaleBitmap 缩放到终端尺寸，最后转 ANSI 字符串输出；动画 GIF 应使用图像控件而非手动循环帧；视频需检测到 mpv/mplayer 才可用；W3M 叠加需单独的 w3mimgdisplay 二进制；用 clearImageCache 或 clearAllImageCaches 释放内存；建议使用子路径导入以便 tree-shaking。
限制：视频依赖外部播放器，未检测到则不可用；W3M 叠加依赖额外二进制；其余平台或终端兼容性细节暂未提供。