feat(formatter/sort-imports): Experimental sort-imports base

[leaysgur]

Part of #14253

This is preparation for implementing sort-imports by reordering IR.

While performance is inferior, it is separated from the main formatting process and is completely opt-in.
This should also make it easier to find the cause if any issues arise.

[leaysgur]

• feat(formatter/sort-imports): Wrap ImportDeclaration with JsLabels #14109 : 2 dependent PRs (#14148 , #14291 )
• feat(formatter/sort-imports): Experimental sort-imports base #14105 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

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.

[codspeed-hq]

CodSpeed Performance Report

Merging #14105 will not alter performance

_{Comparing 09-25-feat_formatter_experimental_sort-imports_base (6be4ae5) with main (bb679b5)¹}

Summary

✅ 33 untouched
⏩ 4 skipped²

Footnotes

1. No successful run was found on main (b3c5132) during the generation of this report, so bb679b5 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

2. 4 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[Copilot]

Pull Request Overview

This PR introduces experimental support for sorting imports in the formatter by implementing an IR transformation approach. The implementation allows import statements to be reordered after the main formatting process is complete.

• Adds a new SortImports configuration struct with options for partitioning by newlines, comments, and sorting side effects
• Implements an IR transformation system that can be applied to the formatted document
• Provides an example demonstrating the sort imports functionality

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
crates/oxc_formatter/src/options.rs	Adds SortImports struct and experimental_sort_imports option to FormatOptions
crates/oxc_formatter/src/lib.rs	Integrates sort imports transformation into the main formatting workflow
crates/oxc_formatter/src/ir_transform/sort_imports.rs	Implements the SortImportsTransform with placeholder logic
crates/oxc_formatter/src/ir_transform/mod.rs	Module definition for IR transforms
crates/oxc_formatter/src/formatter/mod.rs	Adds apply_transform method to Formatted struct
crates/oxc_formatter/examples/sort_imports.rs	Example demonstrating sort imports usage

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[graphite-app]

Merge activity

• Oct 7, 12:30 AM UTC: leaysgur added this pull request to the Graphite merge queue.
• Oct 7, 12:36 AM UTC: The Graphite merge queue couldn't merge this PR because it was not satisfying all requirements (Failed CI: 'Test NAPI').
• Oct 7, 1:06 AM UTC: leaysgur added this pull request to the Graphite merge queue.
• Oct 7, 1:06 AM UTC: Merged by the Graphite merge queue.