Function: migrateSnapshot()

migrateSnapshot(raw): LayoutSnapshot

Defined in: layoutData.ts:84

将任意快照归一为当前格式：校验结构并固定 v 字段。 几何(areas)是重建 Screen 的承重数据，条目级字段缺失/非法直接抛错拒绝； areaStates 是实例状态(非承重)，仅剔除脏槽位、合法条目按引用透传。 版本分派：整数值 v 超出当前版本(未来格式)fail-closed 拒绝——静默错读比失败 更危险；缺失/污染(非数字)的 v 归一为当前版本。v1 为初始版本，后续格式演进 在此追加「先迁移到下一版、逐级归一」的迁移阶梯后放行历史版本。

Parameters

raw

unknown

任意来源的快照数据(JSON.parse 结果即可)，就地归一并返回同一对象

Returns

LayoutSnapshot

结构合法、v 字段固定为当前版本的快照

Throws

几何数据缺失/非法、区域矩形重叠或版本无法识别时抛错；未满铺单位 舞台属可容忍退化，降级为 console.warn 放行(部分平铺可经公开 API 构造)