docs(core): [SITE-04] document event payloads and synchronous dispatch

refactor/changes/2026-09-16-SITE-04-events.md

@@ -0,0 +1,37 @@
+# SITE-04 事件与同步派发契约
+
+起点：`0a060e6088ded006235cfdbf5064b8ff014d842a`。本批继续实施期文档核对，
+SITE-04 保持 doing，不进入用户保留的三轮正式复盘。
+
+补齐双语事件指南：Emitter 的上下文、同步快照、重复监听、once 重入、off、异常
+和销毁后的用户订阅；原生媒体/文档/窗口转发清单；自定义事件参数与时机；根入口
+历史声明与 runtime 准确类型的区别。纠正 video:complete 的旧说明，它不是默认
+转发事件。没有修改核心源码、公开类型、入口或事件行为。原有 90 个 Run Code
+片段逐字保持不变；新增两份严格 TypeScript 样例。
+
+新增 120 条声明语义映射，累计 627/963，336 条仍待核对。此前所有分组的源码和
+指南哈希均保持一致。本批覆盖 Emitter、根实例事件重载、静态入口、Events、
+SubtitleUpdateEvents 和 runtime BuiltinEvents，不把声明条数当成独立行为数量。
+
+Node 24.21.0 / Yarn 1.22.22 下，131 项相关测试通过，0 失败/跳过，1522.8842ms。
+VitePress 构建 9.40 秒，Yarn 整体 11.03 秒；LLM 生成/检查、inventory 和 demo
+检查通过。两份 strict/NodeNext 样例通过；90 个既有片段语法和内容比对通过。
+双语页面在三浏览器形成 6 组页面检查、24 次代码转发，每页只转发前四个示例。
+
+Chromium 153.0.8010.12、Firefox 155.0、WebKit 26.6 各 30 项断言通过，包括
+同步派发、异常传播、原生与方法事件区别、真实本地 MP4 播放/暂停/seek 参数、
+UI 参数和销毁状态。中文截图目视检查通过。键盘/指针使用合成 DOM 事件；这些
+检查不代表真机、SDK、全部示例、长时播放、codec 矩阵或发布验收通过。
+
+第一次 Chromium seek 断言失败保留在报告中。8082 是 9 月 13 日启动的旧服务，
+没有 Content-Length/Accept-Ranges，Range 请求返回全部文件和 200。完全不加载
+Artplayer 的原生 video 同样报告 seekable [0,0]，把请求的 1 秒钳回 0；等待十秒
+仍未形成有效范围。使用当前 startDevServer 在隔离端口 8083 提供同一文件，
+Range 返回 206/16 字节，原生范围恢复 [0,90.046009]，seek 到 1 秒成功；原来的
+严格播放器断言随之在三浏览器通过。没有修改播放器或服务源码、放宽断言或
+覆盖失败证据；现有 8082 进程保留。后续媒体测试须核对实际服务响应，不能仅
+根据磁盘上的新代码假定运行进程已更新。
+
+输入哈希、完整通过结果和失败对照见[报告](../baselines/site04-events.json)。
+21 个库的候选构建证据仍有效，其他发布门槛未关闭。生成文件来自项目脚本；
+回退本提交恢复本批文档及其生成内容，无运行时回退需求。未推送或发布。

refactor/plan.md

@@ -687,7 +687,7 @@
 - SITE-DANMUKU-01: [记录](changes/2026-09-15-SITE-DANMUKU-01-guides.md) [记录](baselines/danmuku-docs-validation.json)
 - SITE-HLS-01: [记录](changes/2026-09-15-SITE-HLS-01-guides.md) [记录](baselines/hls-docs-validation.json)
 - SITE-DASH-01: [记录](changes/2026-09-15-SITE-DASH-01-guides.md) [记录](baselines/dash-docs-validation.json)
-- SITE-04: [记录](site-content-review.md) [记录](changes/2026-09-16-SITE-04-chapter-ambilight-guides.md) [记录](baselines/site04-chapter-ambilight-guides.json) [记录](changes/2026-09-16-SITE-04-dpip-asr-guides.md) [记录](baselines/site04-dpip-asr-guides.json) [记录](changes/2026-09-16-SITE-04-auto-multi-guides.md) [记录](baselines/site04-auto-multi-guides.json) [记录](changes/2026-09-16-SITE-04-ads-vast-guides.md) [记录](baselines/site04-ads-vast-guides.json) [记录](changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md) [记录](baselines/site04-jassub-mask-cast-guides.json) [记录](changes/2026-09-16-SITE-04-tools-guides.md) [记录](baselines/site04-tools-guides.json) [记录](changes/2026-09-16-SITE-04-proxies-guides.md) [记录](baselines/site04-proxies-guides.json) [记录](changes/2026-09-16-SITE-04-existing-guides.md) [记录](baselines/site04-existing-guides.json) [记录](core-content-review.json) [记录](baselines/site04-core-services.json) [记录](changes/2026-09-16-SITE-04-core-services.md) [记录](baselines/site04-template-icons.json) [记录](changes/2026-09-16-SITE-04-template-icons.md) [记录](baselines/site04-components.json) [记录](changes/2026-09-16-SITE-04-components.md) [记录](baselines/site04-setting.json) [记录](changes/2026-09-16-SITE-04-setting.md) [记录](baselines/site04-plugin-registry.json) [记录](changes/2026-09-16-SITE-04-plugin-registry.md) [记录](baselines/site04-subtitle.json) [记录](changes/2026-09-16-SITE-04-subtitle.md) [记录](baselines/site04-utils.json) [记录](changes/2026-09-16-SITE-04-utils.md) [记录](baselines/site04-globals.json) [记录](changes/2026-09-16-SITE-04-globals.md)
+- SITE-04: [记录](site-content-review.md) [记录](changes/2026-09-16-SITE-04-chapter-ambilight-guides.md) [记录](baselines/site04-chapter-ambilight-guides.json) [记录](changes/2026-09-16-SITE-04-dpip-asr-guides.md) [记录](baselines/site04-dpip-asr-guides.json) [记录](changes/2026-09-16-SITE-04-auto-multi-guides.md) [记录](baselines/site04-auto-multi-guides.json) [记录](changes/2026-09-16-SITE-04-ads-vast-guides.md) [记录](baselines/site04-ads-vast-guides.json) [记录](changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md) [记录](baselines/site04-jassub-mask-cast-guides.json) [记录](changes/2026-09-16-SITE-04-tools-guides.md) [记录](baselines/site04-tools-guides.json) [记录](changes/2026-09-16-SITE-04-proxies-guides.md) [记录](baselines/site04-proxies-guides.json) [记录](changes/2026-09-16-SITE-04-existing-guides.md) [记录](baselines/site04-existing-guides.json) [记录](core-content-review.json) [记录](baselines/site04-core-services.json) [记录](changes/2026-09-16-SITE-04-core-services.md) [记录](baselines/site04-template-icons.json) [记录](changes/2026-09-16-SITE-04-template-icons.md) [记录](baselines/site04-components.json) [记录](changes/2026-09-16-SITE-04-components.md) [记录](baselines/site04-setting.json) [记录](changes/2026-09-16-SITE-04-setting.md) [记录](baselines/site04-plugin-registry.json) [记录](changes/2026-09-16-SITE-04-plugin-registry.md) [记录](baselines/site04-subtitle.json) [记录](changes/2026-09-16-SITE-04-subtitle.md) [记录](baselines/site04-utils.json) [记录](changes/2026-09-16-SITE-04-utils.md) [记录](baselines/site04-globals.json) [记录](changes/2026-09-16-SITE-04-globals.md) [记录](baselines/site04-events.json) [记录](changes/2026-09-16-SITE-04-events.md)
 - SITE-07: [记录](site-inventory.md) [记录](baselines/site-provenance.json) [记录](changes/2026-09-14-SITE-07-vendor-notices.md) [记录](baselines/site-notices-checkpoint.json) [记录](baselines/site-codicons-provenance.json) [记录](baselines/site-codicons-validation.json) [记录](changes/2026-09-15-SITE-07-codicons.md) [记录](baselines/vconsole-notices-provenance.json) [记录](baselines/vconsole-notices-validation.json) [记录](changes/2026-09-15-SITE-07-vconsole-notices.md) [记录](console-modernization.md) [记录](baselines/site-console-inventory.json) [记录](baselines/site-console-validation.json) [记录](changes/2026-09-15-SITE-07-console-baseline.md) [记录](baselines/console-feed-provenance.json) [记录](changes/2026-09-15-SITE-07-console-feed-source.md) [记录](baselines/console-commonjs-provenance.json) [记录](changes/2026-09-15-SITE-07-console-commonjs.md) [记录](baselines/console-esm-provenance.json) [记录](changes/2026-09-15-SITE-07-console-esm.md) [记录](baselines/console-embedded-notices.json) [记录](baselines/console-notices-validation.json) [记录](changes/2026-09-15-SITE-07-console-notices.md) [记录](baselines/console-embedded-sources.json) [记录](baselines/console-embedded-validation.json) [记录](changes/2026-09-15-SITE-07-console-embedded-sources.md) [记录](baselines/console-derived-attribution.json) [记录](baselines/console-derived-validation.json) [记录](changes/2026-09-15-SITE-07-console-derived-attribution.md) [记录](baselines/console-stackoverflow-provenance.json) [记录](baselines/console-stackoverflow-validation.json) [记录](changes/2026-09-15-SITE-07-console-stackoverflow.md) [记录](baselines/console-shallowequal-validation.json) [记录](changes/2026-09-15-SITE-07-console-shallowequal.md) [记录](console-notice-review.md) [记录](baselines/console-notice-review-validation.json) [记录](changes/2026-09-15-SITE-07-console-notice-review.md) [记录](baselines/monaco-typescript-provenance.json) [记录](baselines/monaco-typescript-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-typescript.md) [记录](baselines/monaco-languages-provenance.json) [记录](baselines/monaco-languages-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-languages.md) [记录](baselines/monaco-language-notices.json) [记录](baselines/monaco-language-notices-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-language-notices.md) [记录](baselines/monaco-modes-provenance.json) [记录](baselines/monaco-modes-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-modes.md) [记录](baselines/monaco-basic-provenance.json) [记录](baselines/monaco-basic-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-basic.md) [记录](baselines/monaco-core-origins-provenance.json) [记录](baselines/monaco-core-origins-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-core-origins.md) [记录](baselines/monaco-core-build-provenance.json) [记录](baselines/monaco-core-build-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-core-build.md) [记录](baselines/monaco-contributions-provenance.json) [记录](baselines/monaco-contributions-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-contributions.md) [记录](baselines/monaco-css-build-provenance.json) [记录](baselines/monaco-css-build-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-css.md) [记录](baselines/monaco-node-path-provenance.json) [记录](baselines/monaco-node-path-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-node-path.md) [记录](changes/2026-09-15-SITE-07-monaco-dom.md) [记录](baselines/monaco-dom-origins-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-unicode.md) [记录](baselines/monaco-unicode-provenance.json) [记录](baselines/monaco-unicode-validation.json) [记录](changes/2026-09-15-SITE-07-font-notices.md) [记录](baselines/site-font-notices-provenance.json) [记录](baselines/site-font-notices-validation.json)
 - EX-01: [记录](changes/2026-09-14-EX-01-react-consumer.md) [记录](baselines/react-consumer-validation.json) [记录](scripts/react-consumer.mjs)
 - EX-02: [记录](changes/2026-09-14-EX-02-vue-consumer.md) [记录](baselines/vue-consumer-validation.json) [记录](scripts/vue-consumer.mjs)

refactor/progress.md

@@ -1,5 +1,14 @@
 # 进度与证据
 
+## SITE-04 事件与同步派发契约
+
+新增双语事件语义说明与120条声明映射，累计627/963，336条待核对。131项测试、
+两份严格TS、六组页面/24次转发和三浏览器各30项事件断言通过，见
+[记录](changes/2026-09-16-SITE-04-events.md)与[证据](baselines/site04-events.json)。
+首轮seek失败由旧8082服务缺少Range支持复现；原生video对照及当前服务8083验证
+确认，保留失败报告，未修改播放器或放宽断言。21库build仍有效。SITE-04继续doing，
+224/22/39不变；继续构造选项与播放等剩余内容，正式复盘仍由用户指导。
+
 ## SITE-04 静态配置与全局常量
 
 补齐34个全局字段的共享范围、默认值与读取时机，修正config/resize/scroll/恢复

refactor/site-content-review.md

@@ -115,6 +115,13 @@ TS、六组页面/108次转发及三浏览器各22项字幕断言通过，见
 [证据](baselines/site04-globals.json)。旧源码和静态指南config之外内容不变，21库
 build有效；移动端/SDK/播放验收仍不由此覆盖。
 
+事件指南随后新增120条映射，累计627条、336条待核对。覆盖Emitter、根重载与
+静态入口、原生转发、各自定义事件及runtime准确参数，旧90个Run Code片段不变。
+131项测试、两份TS、六组页面/24次转发和三浏览器各30项断言通过，见
+[证据](baselines/site04-events.json)。旧8082进程导致的seek失败有原生video对照，
+当前服务在8083通过；未修改运行时、放宽断言或覆盖失败报告。播放验证仅针对
+本地MP4事件参数，不能替代codec、SDK、真机或全量demo验收。
+
 - 核心：依据 site-inventory.json 的 963 条成员逐项或按明确的共享声明分组核对；
   必须记录对应文档及语义结论，不能仅按同名标题匹配标为通过。
 - Danmuku、HLS、DASH、Audio、VTT 的当前声明/源码语义已补核对；既有媒体报告

refactor/tasks.json

@@ -4589,7 +4589,9 @@
         "baselines/site04-utils.json",
         "changes/2026-09-16-SITE-04-utils.md",
         "baselines/site04-globals.json",
-        "changes/2026-09-16-SITE-04-globals.md"
+        "changes/2026-09-16-SITE-04-globals.md",
+        "baselines/site04-events.json",
+        "changes/2026-09-16-SITE-04-events.md"
       ]
     },
     {