chore: map

[lzxue]

[English Template / 英文模板]

🤔 这个变动的性质是？

• 新特性提交
• 日常 bug 修复
• 站点、文档改进
• 演示代码改进
• 组件样式/交互改进
• TypeScript 定义更新
• 包体积优化
• 性能优化
• 功能增强
• 国际化改进
• 重构
• 代码风格优化
• 测试用例
• 分支合并
• 工作流程
• 版本更新
• 其他改动（是关于什么的改动？）

🔗 相关 Issue

💡 需求背景和解决方案

📝 更新日志

语言	更新描述
🇺🇸 英文
🇨🇳 中文

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项。⚠️

• 文档已补充或无须补充
• 代码演示已提供或无须提供
• TypeScript 定义已补充或无须补充
• Changelog 已提供或无须提供

---

[changeset-bot]

🦋 Changeset detected

Latest commit: 7d60f8b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 12 packages

Name	Type
@antv/l7-component	Major
@antv/l7-renderer	Major
@antv/l7-layers	Major
@antv/l7-source	Major
@antv/l7-scene	Major
@antv/l7-utils	Major
@antv/l7-core	Major
@antv/l7-maps	Major
@antv/l7	Major
@antv/l7-test-utils	Major
@antv/l7-map	Major
@antv/l7-three	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[gemini-code-assist]

Summary of Changes

Hello @lzxue, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

此拉取请求主要在 examples/demos 目录下引入了一组新的“重构”测试用例。这些新的演示旨在验证潜在的依赖替换和代码重构后的各项功能正确性。具体而言，它们涵盖了动画效果、图层显示、事件处理（包括交互事件和场景/图层事件）以及 L7 Draw 库的几何图形绘制操作。此外，.gitignore 文件也已更新，以排除新的开发相关目录。

Highlights

• 新增 .gitignore 忽略项: 更新了 .gitignore 文件，以排除新的开发相关目录，如 .agents/、.github/skills/ 和 .playwright-mcp。
• 集成“重构”测试用例: 在 examples/demos/index.ts 中集成了新的 RefactorTestCases，将其添加到演示案例列表中，便于集中管理和测试重构后的功能。
• 新增多项重构验证演示: 在 examples/demos/refactor/ 目录下新增了多个演示文件，用于验证动画、图层显示、事件系统、交互以及 L7 Draw 绘制等核心功能的正确性。

Changelog

• .gitignore
  • 添加了新的忽略条目，用于排除 .agents/、.github/skills/ 和 .playwright-mcp 目录。
• examples/demos/index.ts
  • 导入了 RefactorTestCases 并将其添加到 TestCases 映射中，键名为 'refactor'。
• examples/demos/refactor/animation.ts
  • 新增了一个图层动画测试用例，包括波纹点图层、流动线图层和动态数据更新，并提供了交互式控制。
• examples/demos/refactor/display.ts
  • 新增了一个显示测试用例，用于验证各种图层类型（点图层、线图层、多边形图层、热力图层）的渲染功能，并提供了切换控制。
• examples/demos/refactor/draw-circle.ts
  • 新增了一个使用 @antv/l7-draw 绘制圆的测试用例，包括半径显示和 GeoJSON 导出功能。
• examples/demos/refactor/draw-line.ts
  • 新增了一个使用 @antv/l7-draw 绘制线的测试用例，包括距离显示和 GeoJSON 导出功能。
• examples/demos/refactor/draw-point.ts
  • 新增了一个使用 @antv/l7-draw 绘制点的测试用例，支持自定义样式和 GeoJSON 导出。
• examples/demos/refactor/draw-polygon.ts
  • 新增了一个使用 @antv/l7-draw 绘制多边形的测试用例，包括面积显示和 GeoJSON 导出功能。
• examples/demos/refactor/draw-rect.ts
  • 新增了一个使用 @antv/l7-draw 绘制矩形的测试用例，包括面积显示和 GeoJSON 导出功能。
• examples/demos/refactor/events.ts
  • 新增了一个事件系统测试用例，验证了交互事件（hover, click, dblclick, drag, press）以及场景和图层事件，并提供了实时日志面板。
• examples/demos/refactor/index.ts
  • 添加了一个索引文件，用于导出所有新的重构测试用例。
• examples/demos/refactor/interaction.ts
  • 新增了一个交互测试用例，专门验证拖拽、单击、双击、长按、悬停和右键菜单等事件在图层和场景上的功能。
• examples/demos/refactor/resize.ts
  • 新增了一个 ResizeObserver 功能测试用例，验证了容器和窗口大小变化时画布的自动调整，并提供了交互式控制。

Ignored Files

• Ignored by pattern: .github/workflows/** (1)
  • .github/workflows/sync-skills.yml

Activity

• 此拉取请求目前没有记录到具体的评论或审查活动。

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

The pull request introduces a comprehensive set of refactor validation tests to ensure the replacement of hammerjs and element-resize-detector with native Pointer Events and ResizeObserver APIs works correctly. The tests cover animations, layer display, event systems, and drawing tools. I have identified several logic issues where event listeners are redundant because they are attached after the scene has already loaded, as well as potential memory leaks from uncleaned intervals and missing error handling in network requests.

[gemini-code-assist]

The setInterval created here is not cleaned up when the demo is destroyed or the user navigates away. This can lead to memory leaks and unnecessary background processing. It is recommended to clear the interval when the scene is removed.

Suggested change

	let dataUpdateInterval: ReturnType<typeof setInterval> | null = setInterval(updateData, 500);
	let dataUpdateInterval: ReturnType<typeof setInterval> | null = setInterval(updateData, 500);
	scene.on('remove', () => dataUpdateInterval && clearInterval(dataUpdateInterval));

[gemini-code-assist]

This loaded event listener is redundant. The CaseScene utility resolves only after the scene has already loaded, so this listener will never be triggered. You can call the log function directly.

Suggested change

	scene.on('loaded', () => log('场景加载完成'));
	log('场景加载完成');

[gemini-code-assist]

The fetch request lacks error handling. If the network request fails or the resource is unavailable, the demo will fail to load or hang. Adding a .catch() block ensures the demo can handle such failures gracefully.

Suggested change

	const heatmapData = await fetch(
	'https://gw.alipayobjects.com/os/antfincdn/8Ps2h%24qgmk/traffic_110000.csv',
	).then((res) => res.text());
	const heatmapData = await fetch(
	'https://gw.alipayobjects.com/os/antfincdn/8Ps2h%24qgmk/traffic_110000.csv',
	).then((res) => res.text()).catch(() => '');

[gemini-code-assist]

Typo: '绑定绑定' (bind bind) is repeated in the description.

Suggested change

	* 多边形绘制测试 - 使用 @antv/l7-draw 绑定绑定绘制多边形
	* 多边形绘制测试 - 使用 @antv/l7-draw 绑定绘制多边形

[gemini-code-assist]

This loaded event listener is redundant because the CaseScene utility resolves after the scene is already loaded. The code inside this block will not execute.

  log('SCENE', 'loaded', '#0ff');

[gemini-code-assist]

The loaded event has already fired by the time CaseScene resolves. This listener is redundant and will not be called.

  log('Scene loaded', '#0ff');

[gemini-code-assist]

The setInterval used to update the status panel is never cleared, which will cause a memory leak when switching between demos. It should be cleared when the scene is removed.

Suggested change

	setInterval(updateStatus, 1000);
	const statusInterval = setInterval(updateStatus, 1000);
	scene.on('remove', () => clearInterval(statusInterval));