用途:在 Svelte 应用中搭建稳定的 PixiJS 渲染集成,明确生命周期与销毁保证,适用于需要把 Pixi 应用生命周期与 Svelte 组件生命周期对齐的场景。
主要能力:先定义集成边界,确定应用状态、渲染循环控制与事件分发的归属;将 Pixi 场景变更限制在清晰的适配层之后;在 Svelte 挂载生命周期中创建 Pixi Application,把 canvas 绑定到专用宿主元素,并在卸载时销毁应用、解绑监听器;处理尺寸变化与 DPI 策略,跟踪容器尺寸更新与渲染器 resize 调用,并记录高 DPI 屏幕的分辨率策略;校验事件与渲染流程,确保输入/事件桥接确定且在销毁时取消订阅,动画 tick 订阅有界且可移除;交付前运行契约检查,校验创建/挂载/调整尺寸/卸载的生命周期契约与所需产物,缺少销毁或取消订阅路径视为阻塞项。
使用方式:运行校验脚本,命令为 python3 scripts/validate_pixi_svelte_contract.py --contract <path/to/pixi_svelte_contract.json>,非零退出码视为阻塞发现。输出契约要求返回:集成映射(宿主组件、Pixi 应用适配器、事件桥)、校验发现(生命周期、尺寸调整、销毁的通过/失败检查)、补丁计划(需修改的具体文件与集成点)、验证(命令与预期通过标准)、残余风险(未解决的运行时同步问题)。
参考文件:references/workflow.md 为端到端集成流程;references/contracts.md 为生命周期与事件桥契约规则;references/signoff-template.md 为发布就绪的交接模板。
执行规则:保持 Pixi 初始化/销毁与 Svelte 挂载/卸载对齐;所有事件订阅可释放并在销毁时验证;避免任意 Svelte 组件直接修改场景;任何泄漏的 ticker 或监听器路径都标记为阻塞项。
限制:资料未提供具体收费、支持平台、性能数据与效果说明,暂未提供。