docs(test): describe individual test cases

packages-user/data-base/src/map/eventPath.test.ts

@@ -64,6 +64,7 @@ function createMapState() {
 }
 
 describe('MapState raw event path', () => {
+    // 验证 raw.events 能绑定到点事件视图，并选择 alias=event 的图层
     it('raw point events and event layer', () => {
         const mapState = createMapState();
         const map = mapState.fromRaw(createRaw());

packages-user/data-base/src/map/eventView.test.ts

@@ -8,6 +8,7 @@ vi.hoisted(() => {
 });
 
 describe('LayerEventView reference tracking', () => {
+    // 验证新增、删除和清空事件时 dirty 状态能随参考基准正确变化
     it('keeps dirty state in sync with set, delete, and clear', () => {
         const view = new LayerEventView();
 
@@ -29,6 +30,7 @@ describe('LayerEventView reference tracking', () => {
         expect(view.dirty()).toBe(false);
     });
 
+    // 验证 ref 返回稳定快照，并可通过恢复事件内容变回 clean 而不重设基准
     it('exposes a stable reference snapshot and restores it without markPure', () => {
         const view = new LayerEventView();
         view.set(10, 'first');

packages-user/data-base/src/map/mapLifecycle.test.ts

@@ -94,6 +94,7 @@ function createMapState(
 }
 
 describe('MapLayer tile defaults snapshots conversion and movement', () => {
+    // 验证静态/动态图块默认事件、存档快照、转换和移动后的点事件归属
     it('tile defaults snapshots conversion and movement', () => {
         const { layer } = createMapState();
         const staticTile = layer.getTile(0, 0)!;
@@ -176,6 +177,7 @@ describe('MapLayer tile defaults snapshots conversion and movement', () => {
 });
 
 describe('MapLayer point event lifecycle', () => {
+    // 验证点事件的 dirty、存档覆盖、基准恢复和不同压缩模式
     it('point event lifecycle', () => {
         const { layer } = createMapState({ 1: { 5: 'raw-point' } });
         const point = layer.event(1, 0)!;
@@ -240,6 +242,7 @@ describe('MapLayer point event lifecycle', () => {
         expect(point.dirty()).toBe(false);
     });
 
+    // 验证只有点事件变化时 GameMap 仍保留对应图层存档
     it('map saves layers containing only point events', () => {
         const { map, layer } = createMapState({}, [0, 0, 0, 0]);
         layer.setZIndex(7);
@@ -267,6 +270,7 @@ describe('MapLayer point event lifecycle', () => {
         }
     });
 
+    // 验证 resize 裁剪范围外事件，resize2 清空全部点事件
     it('resize preserves in-range point events and resize2 clears them', () => {
         const { layer } = createMapState({
             0: { 1: 'top-left' },
@@ -280,6 +284,7 @@ describe('MapLayer point event lifecycle', () => {
         expect(layer.getPointEvent(0, 0)).toEqual(new Map());
     });
 
+    // 验证改变图层宽度后，保留的点事件会使用新索引继续查询
     it('reindexes preserved point events when the layer width changes', () => {
         const { layer } = createMapState({
             1: { 1: 'top-right' },