Skip to content

Simulator map parsed view plan (March 10, 2026)

Background

The simulator currently visualizes only the rendered map. Developers also need an inspectable parsed-data view to compare raw mapHex input with decoded map structure during debugging.

Goal and scope

Add a parsed map data panel in the simulator that:

  • Shows map parse summary fields for quick verification.
  • Supports on-demand tree inspection for large decoded objects.
  • Keeps the main map rendering workflow unchanged.

Out of scope:

  • Path parsed-view panel.
  • Diff view between raw hex and parsed JSON.

Chosen approach

Use json-editor-vue in read-only tree mode and render it lazily behind a "展开详情" toggle. Keep summary cards visible by default and load the full tree only when requested.

Impacted files and modules

  • package.json
  • yarn.lock
  • docs/.vitepress/theme/components/MapPlayground.vue

Verification checklist

  • [ ] Structured map parse result appears in summary panel.
  • [ ] Tree viewer expands and collapses without blocking map interaction.
  • [ ] Copy JSON action works in secure browser context.
  • [ ] npm run lint passes.
  • [ ] npm run docs:build passes.
  • [ ] npx tsc --noEmit status is recorded.

最后更新于: