Skip to content

Source map consumer: Don't decode every source map segment twice - #1978

Merged
robhogan merged 1 commit into
mainfrom
pr1978
Sep 28, 2026
Merged

robhogan merged 1 commit into
mainfrom
pr1978

Conversation

@robhogan

@robhogan robhogan commented Sep 26, 2026 •

Copy link
Copy Markdown
Collaborator

Delete one line to make merging source maps 13% faster.

MappingsConsumer decoded the VLQ of every mapping twice - once through its cache and once more with the result discarded, ever since the consumer was added in ccd508c. This removes the second call - a stray line that never did anything except take time (it definitely doesn't mutate the input, which is a string).

composeSourceMaps with a bundle map and its Hermes map is 13.6% faster (95% CI 13.3-13.8%; 2,088ms -> 1,801ms on our benchmark app*), with byte-identical output. Composition memory is within 0.2% (-1MB*).

Time (median) vs previous vs main Composition memory* vs previous vs main Peak RSS
main 2,088ms (2,082 to 2,094) 1,070MB (1,070 to 1,070) 1,664MB
This diff 1,801ms (1,794 to 1,806) -13.6% (-13.8 to -13.3) -13.6% (-13.8 to -13.3) 1,069MB (1,069 to 1,069) -0.1% (-0.2 to -0.1) -0.1% (-0.2 to -0.1) 1,663MB

Changelog

 - **[Performance]**: Don't decode source map segments twice in `metro-source-map`'s `Consumer`

Test plan

yarn jest packages/metro-source-map packages/metro-symbolicate
yarn flow check

* Benchmark: Mattermost Mobile 2.45.0 (React Native 0.83.9, Metro 0.83.7), iOS release bundle, unminified: 7,086 sources, 52.6MB bundle, 82.4MB flat source map. Composed with its hermesc -O -output-source-map map (hermes-compiler 0.14.1; 10.7MB, 1.84M segments). Timings are composeSourceMaps alone, excluding JSON parsing, over 105 rounds on Node 22.13.1 on an M5 Pro; each round runs main, every diff in this stack and a memory baseline, in a shuffled order. Figures are medians with 95% bootstrap confidence intervals - for changes, of the per-round paired ratio. Composition memory is peak RSS less that of the same process parsing both maps without composing them (594MB).

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Sep 26, 2026
@robhogan
robhogan added this pull request to stack #1982 September 26, 2026 07:54
@robhogan
robhogan force-pushed the pr1978 branch 3 times, most recently from b61cc51 to 9e5b6e9 Compare September 26, 2026 08:39
@robhogan robhogan changed the title Consumer: Don't decode every source map segment twice Source map consumer: Don't decode every source map segment twice Sep 26, 2026
@robhogan
robhogan marked this pull request as ready for review September 26, 2026 10:39
@facebook-github-tools facebook-github-tools Bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label Sep 26, 2026
@robhogan
robhogan requested a lite review from Copilot September 28, 2026 12:07
`MappingsConsumer` decoded the VLQ of every mapping twice - once through its cache and once more with the result discarded - since the consumer was added in ccd508c. This removes the second call.

`composeSourceMaps` with a bundle map and its Hermes map is 13.6% faster (95% CI 13.3-13.8%; 2,088ms -> 1,801ms on our benchmark app*), with byte-identical output. Composition memory is within 0.2% (-1MB*).

| | Time (median) | vs previous | vs `main` | Composition memory* | vs previous | vs `main` | Peak RSS |
|---|---|---|---|---|---|---|---|
| `main` | 2,088ms (2,082 to 2,094) | | | 1,070MB (1,070 to 1,070) | | | 1,664MB |
| This diff | 1,801ms (1,794 to 1,806) | -13.6% (-13.8 to -13.3) | -13.6% (-13.8 to -13.3) | 1,069MB (1,069 to 1,069) | -0.1% (-0.2 to -0.1) | -0.1% (-0.2 to -0.1) | 1,663MB |

## Changelog

```
 - **[Performance]**: Don't decode source map segments twice in `metro-source-map`'s `Consumer`
```

## Test plan

```
yarn jest packages/metro-source-map packages/metro-symbolicate
yarn flow check
```

\* Benchmark: Mattermost Mobile 2.45.0 (React Native 0.83.9, Metro 0.83.7), iOS release bundle, unminified: 7,086 sources, 52.6MB bundle, 82.4MB flat source map. Composed with its `hermesc -O -output-source-map` map (hermes-compiler 0.14.1; 10.7MB, 1.84M segments). Timings are `composeSourceMaps` alone, excluding JSON parsing, over 105 rounds on Node 22.13.1 on an M5 Pro; each round runs `main`, every diff in this stack and a memory baseline, in a shuffled order. Figures are medians with 95% bootstrap confidence intervals - for changes, of the per-round paired ratio. Composition memory is peak RSS less that of the same process parsing both maps without composing them (594MB).

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

馃煝 Approval recommended

No unresolved issues were identified.

Review effort: Lite
Findings: None

What changed in this PR

Removes redundant VLQ decoding in MappingsConsumer, improving source-map composition performance while preserving output.

Changes:

  • Eliminates the discarded second decode.
  • Retains cached mapping behavior.
File Description
packages/鈥媘etro-source-map/鈥媠rc/鈥婥onsumer/鈥婱appingsConsumer.js Removes redundant VLQ decoding.

馃挕 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@robhogan
robhogan requested review from huntie and vzaidman September 28, 2026 12:19
@robhogan
robhogan merged commit 5e08337 into main Sep 28, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants