Skip to content

docs: add design doc for sort_modules execution ordering#9169

Merged
graphite-app[bot] merged 1 commit into
mainfrom
04-20-docs_module_execution_order_sorting
Apr 20, 2026
Merged

docs: add design doc for sort_modules execution ordering#9169
graphite-app[bot] merged 1 commit into
mainfrom
04-20-docs_module_execution_order_sorting

Conversation

@IWANABETHATGUY

@IWANABETHATGUY IWANABETHATGUY commented Apr 20, 2026

Copy link
Copy Markdown
Member

Adds a design doc under meta/design/linking/ explaining the sort_modules pass — the ordering guarantees (runtime-first, user-entry order, dependency-before-dependent along acyclic edges, require as static import, dynamic-import skip), the iterative post-order DFS with ToBeExecuted/WaitForExit stack, cycle detection, complexity, and downstream consumers of exec_order and sorted_modules.

IWANABETHATGUY commented Apr 20, 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.

@netlify

netlify Bot commented Apr 20, 2026

Copy link
Copy Markdown

Deploy Preview for rolldown-rs canceled.

Name Link
🔨 Latest commit 79e7e05
🔍 Latest deploy log https://app.netlify.com/projects/rolldown-rs/deploys/69e637035ca9390008ac87e8

@IWANABETHATGUY
IWANABETHATGUY force-pushed the 04-20-docs_module_execution_order_sorting branch from 97b6ca2 to 9684b55 Compare April 20, 2026 13:53
@IWANABETHATGUY IWANABETHATGUY changed the title docs: module execution order sorting docs: add design doc for sort_modules execution ordering Apr 20, 2026
@IWANABETHATGUY
IWANABETHATGUY marked this pull request as ready for review April 20, 2026 14:01
@IWANABETHATGUY
IWANABETHATGUY requested a review from hyfdev April 20, 2026 14:01
@graphite-app

graphite-app Bot commented Apr 20, 2026

Copy link
Copy Markdown
Contributor

Merge activity

Adds a design doc under `meta/design/linking/` explaining the `sort_modules` pass — the ordering guarantees (runtime-first, user-entry order, dependency-before-dependent along acyclic edges, `require` as static import, dynamic-import skip), the iterative post-order DFS with `ToBeExecuted`/`WaitForExit` stack, cycle detection, complexity, and downstream consumers of `exec_order` and `sorted_modules`.
@graphite-app
graphite-app Bot force-pushed the 04-20-docs_module_execution_order_sorting branch from 9684b55 to 79e7e05 Compare April 20, 2026 14:24
@graphite-app
graphite-app Bot merged commit 79e7e05 into main Apr 20, 2026
31 checks passed
@graphite-app
graphite-app Bot deleted the 04-20-docs_module_execution_order_sorting branch April 20, 2026 14:25
@github-actions github-actions Bot mentioned this pull request Apr 22, 2026
This was referenced Apr 22, 2026
shulaoda added a commit that referenced this pull request Apr 22, 2026
## [1.0.0-rc.17] - 2026-04-22

### 🐛 Bug Fixes

- link: error on missing export between TS modules (#9197) by @IWANABETHATGUY
- rolldown_plugin_vite_import_glob: import path should not be affected by absolute base option (#9145) by @kermanx
- `this.resolve()` returns null for bare relative paths without importer (#9142) by @Copilot
- collect destructured bindings in HMR module exports (#9146) by @h-a-n-a
- esbuild-tests: handle 0.28.0 test cases (#9149) by @sapphi-red
- plugin/copy-module: honor external resolutions from other plugins (#9139) by @TheAlexLichter
- allow undefined in sourcesContent type (#9136) by @jurijzahn8019
- reduce false positives in chunk optimizer circular dependency detection (#9049) by @AlonMiz

### 🚜 Refactor

- chunk-optimizer: extract runtime-module placement into rehome_runtime_module (#9163) by @IWANABETHATGUY

### 📚 Documentation

- add design doc for sort_modules execution ordering (#9169) by @IWANABETHATGUY
- add document for `RenderedModule` (#9147) by @sapphi-red

### ⚡ Performance

- rolldown_plugin_vite_import_glob: skip self-import earlier using raw path comparison (#9193) by @shulaoda

### 🧪 Testing

- lazy: add `playground/lazy-compilation` (#7974) by @hyf0

### ⚙️ Miscellaneous Tasks

- use app token for release PR (#9198) by @Boshen
- upgrade oxc to 0.127.0 (#9194) by @Dunqing
- use oxc security action (#9196) by @Boshen
- esbuild-tests: remove some tests from ignored list as enum inline is now supported (#9184) by @sapphi-red
- deps: update dependency vite-plus to v0.1.19 (#9183) by @renovate[bot]
- use vp instead of pnpm in check-wasi-binding-deps (#9182) by @shulaoda
- verify wasm32-wasi binding deps match @rolldown/browser before publish (#9162) by @shulaoda
- deps: update esbuild for tests to 0.28.0 (#9172) by @sapphi-red
- deps: update rollup submodule for tests to v4.60.2 (#9173) by @sapphi-red
- deps: update test262 submodule for tests (#9174) by @sapphi-red
- sort_modules: fix stale async-entry sort key comment (#9170) by @IWANABETHATGUY
- deps: update npm packages (#9157) by @renovate[bot]
- deps: update dependency diff to v9 (#9158) by @renovate[bot]
- deps: update rust crates (#9156) by @renovate[bot]
- run Windows CI on PRs labeled with `ci: windows` (#9153) by @hyf0
- update-test-dependencies: run setup-rust before file changes (#9151) by @sapphi-red
- deps: update dependency rust to v1.95.0 (#9140) by @renovate[bot]

### ❤️ New Contributors

* @jurijzahn8019 made their first contribution in [#9136](#9136)
* @AlonMiz made their first contribution in [#9049](#9049)

---------

Co-authored-by: shulaoda <[email protected]>
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