Skip to content

docs(devtools): document @rolldown/debug usage and package graph consumption#9435

Merged
graphite-app[bot] merged 1 commit into
mainfrom
05-18-docs_devtools_package_consumption
May 20, 2026
Merged

docs(devtools): document @rolldown/debug usage and package graph consumption#9435
graphite-app[bot] merged 1 commit into
mainfrom
05-18-docs_devtools_package_consumption

Conversation

@IWANABETHATGUY

@IWANABETHATGUY IWANABETHATGUY commented May 18, 2026

Copy link
Copy Markdown
Member

Adds a @rolldown/debug README walking consumers through parsing logs.json, selecting events by build_id, and joining PackageGraphReady with the chunk/module graphs to render a package table. Also fixes the meta/design/devtools.md lifecycle note for trace_action_package_graph_ready (it emits after chunk instantiation, not chunk graph construction) and adds a JSDoc pointer from the devtools input option to the new package.

IWANABETHATGUY commented May 18, 2026

Copy link
Copy Markdown
Member Author

How to use the Graphite Merge Queue

Add the label graphite: merge-when-ready to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@IWANABETHATGUY IWANABETHATGUY force-pushed the 05-18-docs_devtools_package_consumption branch from 4a640cd to bdad2cf Compare May 18, 2026 07:02
@IWANABETHATGUY IWANABETHATGUY changed the title docs(devtools): document package graph consumption docs(devtools): document @rolldown/debug usage and package graph consumption May 18, 2026
@graphite-app graphite-app Bot force-pushed the 05-18-feat_devtools_package_size branch from d11ede1 to 25f5ba8 Compare May 19, 2026 02:40
@graphite-app graphite-app Bot force-pushed the 05-18-docs_devtools_package_consumption branch from bdad2cf to cc76fff Compare May 19, 2026 02:40
@IWANABETHATGUY IWANABETHATGUY force-pushed the 05-18-docs_devtools_package_consumption branch from cc76fff to ac4058f Compare May 19, 2026 06:05
@IWANABETHATGUY IWANABETHATGUY force-pushed the 05-18-feat_devtools_package_size branch from 25f5ba8 to 90abfc3 Compare May 19, 2026 06:05
@graphite-app graphite-app Bot force-pushed the 05-18-feat_devtools_package_size branch 2 times, most recently from ae61c4d to 8598a26 Compare May 19, 2026 07:16
@graphite-app graphite-app Bot force-pushed the 05-18-docs_devtools_package_consumption branch from ac4058f to b9258d9 Compare May 19, 2026 07:16
@graphite-app graphite-app Bot changed the base branch from 05-18-feat_devtools_package_size to graphite-base/9435 May 19, 2026 07:24
@graphite-app graphite-app Bot force-pushed the graphite-base/9435 branch from 8598a26 to ed010fa Compare May 19, 2026 07:28
@graphite-app graphite-app Bot force-pushed the 05-18-docs_devtools_package_consumption branch from b9258d9 to c69fd66 Compare May 19, 2026 07:28
@graphite-app graphite-app Bot changed the base branch from graphite-base/9435 to main May 19, 2026 07:29
@graphite-app graphite-app Bot force-pushed the 05-18-docs_devtools_package_consumption branch from c69fd66 to a141d13 Compare May 19, 2026 07:29
@netlify

netlify Bot commented May 19, 2026

Copy link
Copy Markdown

Deploy Preview for rolldown-rs failed.

Name Link
🔨 Latest commit b88de34
🔍 Latest deploy log https://app.netlify.com/projects/rolldown-rs/deploys/6a0d163b1e7a180007a65641

@IWANABETHATGUY IWANABETHATGUY marked this pull request as ready for review May 19, 2026 09:38

IWANABETHATGUY commented May 20, 2026

Copy link
Copy Markdown
Member Author

Merge activity

  • May 20, 2:01 AM UTC: The merge label 'graphite: merge-when-ready' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
  • May 20, 2:01 AM UTC: IWANABETHATGUY added this pull request to the Graphite merge queue.
  • May 20, 2:06 AM UTC: Merged by the Graphite merge queue.

…umption (#9435)

Adds a `@rolldown/debug` README walking consumers through parsing `logs.json`, selecting events by `build_id`, and joining `PackageGraphReady` with the chunk/module graphs to render a package table. Also fixes the `meta/design/devtools.md` lifecycle note for `trace_action_package_graph_ready` (it emits after chunk instantiation, not chunk graph construction) and adds a JSDoc pointer from the `devtools` input option to the new package.
@graphite-app graphite-app Bot force-pushed the 05-18-docs_devtools_package_consumption branch from a141d13 to b88de34 Compare May 20, 2026 02:02
@graphite-app graphite-app Bot merged commit b88de34 into main May 20, 2026
27 of 31 checks passed
@graphite-app graphite-app Bot deleted the 05-18-docs_devtools_package_consumption branch May 20, 2026 02:06
@rolldown-guard rolldown-guard Bot mentioned this pull request May 20, 2026
shulaoda added a commit that referenced this pull request May 20, 2026
## [1.0.2] - 2026-05-20

### 🚀 Features

- devtools: emit package size in PackageGraphReady (#9434) by @IWANABETHATGUY
- devtools: classify package dependency types (#9427) by @IWANABETHATGUY
- devtools: map packages to modules and chunks (#9426) by @IWANABETHATGUY
- devtools: mark used packages (#9423) by @IWANABETHATGUY
- devtools: make duplicate packages discoverable (#9422) by @IWANABETHATGUY
- devtools: emit package metadata (#9421) by @IWANABETHATGUY
- update oxc to 0.132.0 (#9449) by @shulaoda
- update oxc to 0.131.0 (#9424) by @shulaoda
- allow checks.* to escalate emissions to hard errors (#9388) by @IWANABETHATGUY
- dev: support watcher options `include` and `exclude` (#9395) by @h-a-n-a
- emit warnings for invalid pure annotations (#9381) by @Kyujenius

### 🐛 Bug Fixes

- hash: keep chunk file names stable when an unrelated entry is added (#9444) by @hyf0
- call `codeSplitting.groups[].name` in deterministic order (#9457) by @sapphi-red
- dev/lazy: make `resolve_id` idempotent when the resolved id is already a lazy entry (#9439) by @h-a-n-a
- chunk-optimization: publish absorbed dynamic-entry namespace cross-chunk (#9448) by @IWANABETHATGUY
- treeshake: propagate pure annotation through compound exprs (#9431) by @Dunqing
- finalizer: skip redundant init call when barrel executes in same chunk (#9354) by @IWANABETHATGUY
- linking: initialize wrapped ESM re-export owners (#9353) by @IWANABETHATGUY
- do not inherit __toESM across chunks for named-only external imports (#9333) (#9415) by @IWANABETHATGUY
- watcher: don't write output or emit events after close() (#9328) by @situ2001
- chunk-optimization: avoid unsafe dynamic-only merges (#9398) by @IWANABETHATGUY
- cjs: rename CJS-wrapped locals that would shadow chunk-scope names (#9392) by @hyf0
- dev/lazy: watch lazy modules added in rebuilds (#9391) by @h-a-n-a

### 🚜 Refactor

- rolldown_dev: move dev example to break publish cycle (#9465) by @Boshen
- binding: drop unsafe napi string helper, hoist transform ArcStr (#9456) by @hyf0
- ecmascript_utils: split rewrite_ident_reference off JsxExt trait (#9417) by @IWANABETHATGUY
- use `ThreadsafeFunction::call_async_catch` (#9390) by @sapphi-red

### 📚 Documentation

- devtools: document @rolldown/debug usage and package graph consumption (#9435) by @IWANABETHATGUY
- replace `Inter` with system font stack in OG template SVG (#9240) by @yvbopeng
- remove `output.comments` warning as all issues have been resolved (#9393) by @sapphi-red
- in-depth: clarify @__PURE__ scope and document positions (#9389) by @Kyujenius
- readme: remove release candidate notice (#9387) by @shulaoda

### ⚡ Performance

- vite-resolve: cache importer existence checks (#9443) by @Brooooooklyn
- binding: reduce plugin string clones (#9436) by @Brooooooklyn

### 🧪 Testing

- enable `legal_comments_inline` test (#9394) by @sapphi-red

### ⚙️ Miscellaneous Tasks

- bump pnpm to v11.1.2 (#9447) by @Boshen
- deps: update rust crates (#9461) by @renovate[bot]
- deps: update rollup submodule for tests to v4.60.4 (#9453) by @rolldown-guard[bot]
- deps: update test262 submodule for tests (#9454) by @rolldown-guard[bot]
- deps: update npm packages (#9430) by @renovate[bot]
- deps: update github actions (#9429) by @renovate[bot]
- deps: update dependency rolldown-plugin-dts to v0.25.1 (#9452) by @renovate[bot]
- deps: update rust crates (#9428) by @renovate[bot]
- revert allow checks.* to escalate emissions to hard errors (#9388) (#9438) by @IWANABETHATGUY
- update mimalloc-safe to 0.1.61 (#9413) by @shulaoda
- deny `todo`, `unimplemented`, and `print_stderr` clippy lints (#9412) by @Boshen
- deps: update mimalloc-safe to 0.1.60 (#9410) by @shulaoda
- remove `pip install setuptools` workaround for node-gyp on macOS (#9370) by @sapphi-red
- renovate: disable automerge to require manual approval (#9386) by @shulaoda
- deps: update napi (#9385) by @renovate[bot]

### ❤️ New Contributors

* @yvbopeng made their first contribution in [#9240](#9240)

Co-authored-by: shulaoda <165626830+shulaoda@users.noreply.github.com>
V1OL3TF0X pushed a commit to V1OL3TF0X/rolldown that referenced this pull request May 25, 2026
…umption (rolldown#9435)

Adds a `@rolldown/debug` README walking consumers through parsing `logs.json`, selecting events by `build_id`, and joining `PackageGraphReady` with the chunk/module graphs to render a package table. Also fixes the `meta/design/devtools.md` lifecycle note for `trace_action_package_graph_ready` (it emits after chunk instantiation, not chunk graph construction) and adds a JSDoc pointer from the `devtools` input option to the new package.
V1OL3TF0X pushed a commit to V1OL3TF0X/rolldown that referenced this pull request May 25, 2026
## [1.0.2] - 2026-05-20

### 🚀 Features

- devtools: emit package size in PackageGraphReady (rolldown#9434) by @IWANABETHATGUY
- devtools: classify package dependency types (rolldown#9427) by @IWANABETHATGUY
- devtools: map packages to modules and chunks (rolldown#9426) by @IWANABETHATGUY
- devtools: mark used packages (rolldown#9423) by @IWANABETHATGUY
- devtools: make duplicate packages discoverable (rolldown#9422) by @IWANABETHATGUY
- devtools: emit package metadata (rolldown#9421) by @IWANABETHATGUY
- update oxc to 0.132.0 (rolldown#9449) by @shulaoda
- update oxc to 0.131.0 (rolldown#9424) by @shulaoda
- allow checks.* to escalate emissions to hard errors (rolldown#9388) by @IWANABETHATGUY
- dev: support watcher options `include` and `exclude` (rolldown#9395) by @h-a-n-a
- emit warnings for invalid pure annotations (rolldown#9381) by @Kyujenius

### 🐛 Bug Fixes

- hash: keep chunk file names stable when an unrelated entry is added (rolldown#9444) by @hyf0
- call `codeSplitting.groups[].name` in deterministic order (rolldown#9457) by @sapphi-red
- dev/lazy: make `resolve_id` idempotent when the resolved id is already a lazy entry (rolldown#9439) by @h-a-n-a
- chunk-optimization: publish absorbed dynamic-entry namespace cross-chunk (rolldown#9448) by @IWANABETHATGUY
- treeshake: propagate pure annotation through compound exprs (rolldown#9431) by @Dunqing
- finalizer: skip redundant init call when barrel executes in same chunk (rolldown#9354) by @IWANABETHATGUY
- linking: initialize wrapped ESM re-export owners (rolldown#9353) by @IWANABETHATGUY
- do not inherit __toESM across chunks for named-only external imports (rolldown#9333) (rolldown#9415) by @IWANABETHATGUY
- watcher: don't write output or emit events after close() (rolldown#9328) by @situ2001
- chunk-optimization: avoid unsafe dynamic-only merges (rolldown#9398) by @IWANABETHATGUY
- cjs: rename CJS-wrapped locals that would shadow chunk-scope names (rolldown#9392) by @hyf0
- dev/lazy: watch lazy modules added in rebuilds (rolldown#9391) by @h-a-n-a

### 🚜 Refactor

- rolldown_dev: move dev example to break publish cycle (rolldown#9465) by @Boshen
- binding: drop unsafe napi string helper, hoist transform ArcStr (rolldown#9456) by @hyf0
- ecmascript_utils: split rewrite_ident_reference off JsxExt trait (rolldown#9417) by @IWANABETHATGUY
- use `ThreadsafeFunction::call_async_catch` (rolldown#9390) by @sapphi-red

### 📚 Documentation

- devtools: document @rolldown/debug usage and package graph consumption (rolldown#9435) by @IWANABETHATGUY
- replace `Inter` with system font stack in OG template SVG (rolldown#9240) by @yvbopeng
- remove `output.comments` warning as all issues have been resolved (rolldown#9393) by @sapphi-red
- in-depth: clarify @__PURE__ scope and document positions (rolldown#9389) by @Kyujenius
- readme: remove release candidate notice (rolldown#9387) by @shulaoda

### ⚡ Performance

- vite-resolve: cache importer existence checks (rolldown#9443) by @Brooooooklyn
- binding: reduce plugin string clones (rolldown#9436) by @Brooooooklyn

### 🧪 Testing

- enable `legal_comments_inline` test (rolldown#9394) by @sapphi-red

### ⚙️ Miscellaneous Tasks

- bump pnpm to v11.1.2 (rolldown#9447) by @Boshen
- deps: update rust crates (rolldown#9461) by @renovate[bot]
- deps: update rollup submodule for tests to v4.60.4 (rolldown#9453) by @rolldown-guard[bot]
- deps: update test262 submodule for tests (rolldown#9454) by @rolldown-guard[bot]
- deps: update npm packages (rolldown#9430) by @renovate[bot]
- deps: update github actions (rolldown#9429) by @renovate[bot]
- deps: update dependency rolldown-plugin-dts to v0.25.1 (rolldown#9452) by @renovate[bot]
- deps: update rust crates (rolldown#9428) by @renovate[bot]
- revert allow checks.* to escalate emissions to hard errors (rolldown#9388) (rolldown#9438) by @IWANABETHATGUY
- update mimalloc-safe to 0.1.61 (rolldown#9413) by @shulaoda
- deny `todo`, `unimplemented`, and `print_stderr` clippy lints (rolldown#9412) by @Boshen
- deps: update mimalloc-safe to 0.1.60 (rolldown#9410) by @shulaoda
- remove `pip install setuptools` workaround for node-gyp on macOS (rolldown#9370) by @sapphi-red
- renovate: disable automerge to require manual approval (rolldown#9386) by @shulaoda
- deps: update napi (rolldown#9385) by @renovate[bot]

### ❤️ New Contributors

* @yvbopeng made their first contribution in [rolldown#9240](rolldown#9240)

Co-authored-by: shulaoda <165626830+shulaoda@users.noreply.github.com>
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.

2 participants