refactor(mediabunny): [PKG-MB-08] checkpoint typed entry and compatible media declarations

refactor/changes/2026-09-12-PKG-MB-08-entry-checkpoint.md

@@ -0,0 +1,66 @@
+# PKG-MB-08 检查点：入口、Canvas 转发与公开声明
+
+任务保持doing。本包自有源码已全部迁移为34个strict TS模块，但不可解码轨道的回退与
+就绪能力审查尚未完成；不能据此把整个MB-08标done。进入本轮的源码/产物冻结于
+[入口基线](../baselines/mb-entry-source.json)，对应8a2b56e8。
+
+## 实现与兼容边界
+
+入口从index.js迁至index.ts，Canvas转发、入口生命周期和通用清理分别进入
+canvas-bridge.ts、entry-lifecycle.ts、cleanup.ts。后者从HLS菜单层下移，避免入口依赖
+UI层的通用释放实现。HLS初始化支持部分注册失败时撤销，返回内部destroy供入口回滚。
+
+保留createElement脱离receiver调用、原生可枚举方法getter读取两次、Canvas原生方法优先、
+shim own/直接prototype转发、每次读取绑定方法、getter-only写入TypeError等旧行为。
+资源状态不增加Canvas公开字段。销毁取消入口resize/metadata/destroy监听，已保存回调失效；
+只删除仍属于当前shim的art.mediabunny，保留调用方替换的别名。一个清理步骤抛错仍尝试其余步骤，
+setup失败保留原始异常。缺少off的历史自定义host仍可用，残留回调在销毁后保持无副作用。
+
+公开默认工厂继续是可选Option到同步initializer、精确HTMLCanvasElement的签名；不将Result
+缩窄成Canvas与shim交叉类型，不增加强制default属性，也不全局增强Artplayer。
+新增type-only Option/Result、MediaBunnyShim、MediaBunnyCanvas、MediaBunnyPlayer、HLS状态和
+SyntheticFrameCallback等。MediaBunnyPlayer的别名可缺省；Canvas视图明确原生DOM方法优先。
+VideoShim实际implements媒体视图，getter显式返回类型防止unknown setter污染读取推导。
+
+声明不引入MediaBunny SDK的现代DOM/Disposable依赖；track对象保持unknown，由消费者按
+自用SDK缩窄。SyntheticFrameMetadata保留历史估算语义，尤其presentationTime是媒体秒数。
+canPlayType仍恒为maybe，TimeRanges不代表真实网络缓冲；新类型不制造能力承诺。
+
+新增.d.mts及条件types路由修正NodeNext ESM不可调用问题，typesVersions补齐经典解析的legacy。
+CommonJS继续保留旧default声明门面；运行时直接工厂增加不可枚举、可写、可配置的default自身别名，
+同时支持1.0.0的namespace.default和1.2.0的直接调用。整工厂双向赋值使用实际两个npm冻结声明检查。
+
+## 验证与迭代
+
+15条入口断言在旧main上6通过/9失败；候选包专项241通过，main/legacy各217通过，其中
+各213条候选断言和4条冻结正常控制。HLS测试将清理断言限定为其自己拥有的5个listener；
+新增入口断言单独检查额外3个listener，不再错误假设resize回调应一直残留。
+
+新增12浏览器用例使用真实Canvas与发布版/候选核心，覆盖方法receiver、DOM事件/属性优先、
+清理和替换别名。旧main同12项全部复现缺陷；候选通过。首轮夹具错误地把后续核心尺寸处理后的
+inline style当作入口独占结果，现单独调用已注册入口resize callback验证其行为；首轮18份失败
+report/results保留，并合并了两组重复场景。未增加重试或放宽超时。最终8个MediaBunny浏览器文件
+共120通过：新增12项为Canvas/生命周期检查，原有29项为Windows WebKit能力对照，均不冒充播放。
+
+新增yarn test:mediabunny-types-package：实际pack核心与代理，在工作区外安装两个冻结发布包及
+候选，offline/frozen重装、锁文件和安装文件哈希检查。17组编译/导出矩阵通过；候选7组各拒绝
+15条非法用法，并验证原始两份声明的整工厂双向赋值。保留旧版NodeNext ESM的准确诊断作为负例。
+最初pack发现tsconfig泄漏，补入.npmignore后修复。旧TS不读取SDK声明，所有解析文件限于安装
+目录或编译器标准库。该检查并非MB-10完整分发/许可验收。
+
+最终源码、打包安装、构建与浏览器证据见[检查点记录](../baselines/mb-entry-checkpoint.json)。
+完整CI1402项（1247单元+14工程+141基线）通过，另44重复契约，324生产TS。
+首轮全局noUncheckedIndexedAccess发现消费者夹具直接读取空数组首项，改为可选访问后
+完整CI和17组实际安装矩阵重跑通过；运行时产物未变化。本轮未添加依赖，Yarn和SDK锁版本不变。
+
+## 立即接续
+
+继续检查已有track但codec/canDecode不可用时，VideoEngine/AudioEngine的历史空轨道回退。
+必须保留有效audio-only/video-only播放，阻止没有可用解码器时假就绪，并覆盖加载、HLS替换、
+晚能力查询、pause/source/destroy和错误事件顺序。不要仅凭新增接口或现有WebKit负例宣布修复。
+长播放/AV sync/设备及组合由MB-09，示例、安装分发及MPL/source notice由MB-10继续。
+本检查点独立本地提交，回退该提交即可恢复本轮前状态；冻结历史输入保持不变，不推送或发布。
+
+接续缺陷已用实际SDK解析的video-only MP4复现：受控canDecode=false与AudioContext下，
+旧/候选均为videoSink=null、audioSink=null，却readyState=4并发loadedmetadata/data/canplay/through；
+replaceTracks后同样假就绪。该受控复现见检查点记录，不能当作真实浏览器解码结果。