Skip to content

perf(journey-map): reuse static map pixels and bound drawing work - #54

Merged
NWYLZW merged 1 commit into
mainfrom
perf/journey-map-rendering
Nov 1, 2026
Merged

NWYLZW merged 1 commit into
mainfrom
perf/journey-map-rendering

Conversation

@NWYLZW

@NWYLZW NWYLZW commented Nov 1, 2026 •

Copy link
Copy Markdown
Contributor

变更说明

JourneyMap 的选点曾重新绘制地形、边界与路线,放大后也提交大量屏外笔触。新增可组合的 rendering 配置:屏外边界笔触剔除、保守地形行范围、画布缓冲复用,以及单实例有界底图缓存。切换策略保留地图实例与视角;数据、主题、视图、尺寸/DPR 与上下文恢复会使对应缓存失效,卸载释放像素。调整尺寸时先释放旧缓存,保留 6 Mi 像素合计预算。

auto 启用四项策略,legacy 关闭策略,自定义对象逐项覆盖。已有同机 Chrome/WebKit 测量均有收益,当前不引入浏览器识别或分流。真实 Safari 尚未验收;不新增 Safari CI。详细指标与限制见 docs/journey-map-performance.md。文档控件与 API 说明在配套 docs PR 中更新。

Validation

  • Node 24.22.1 / React 19.3.1:库构建通过;node --test packages/inkra/test/travel.test.mjs packages/inkra/test/journey-map-rendering.test.mjs,20 项通过,0 失败/跳过。其中 travel 组 13 项、渲染专项 7 项。
  • 候选归档检查通过;npm run check:installed 的实际归档安装、SSR/import/types 检查通过。首次消费验证遇到本机共享 npm 缓存权限问题;改用独立临时缓存后通过,未修改共享缓存。
  • git diff --check 通过。配套文档使用真实候选归档构建通过。
  • 既有定向浏览器检查含选点、缩放、平移停止、主题、尺寸、独立开关与卸载恢复。本次补充 DPR 1 合成截图及孔洞/跨边界路线核验;最终结果随配套 PR 记录。
  • 仅为已实际完成的 Node 24 travel 组填写本地声明。新渲染测试不申请未授权组的豁免,Node 22 继续正常 CI。未部署或发布 npm。
{
  "schemaVersion": 1,
  "tested_commit": "43267c1c3fc4550621ac294a5500a2bed9893052",
  "base_commit": "9b32dabe144d35c8992d5122fedb39bb55b085cf",
  "local_passed": [
    {
      "group": "component:travel",
      "environments": [
        "node24-react19.3.1"
      ],
      "evidence": "https://github.com/inkrajs/inkra/pull/54#validation",
      "reason": "Exact committed source built and all 13 travel.test.mjs cases passed locally on Node 24.22.1 / React 19.3.1; 0 failures or skips. Rendering-specific new tests run normally in CI."
    }
  ]
}

@NWYLZW
NWYLZW merged commit e9aa3ac into main Nov 1, 2026
4 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant