feat(formatter): Export doc() API to inspect IR in example

[leaysgur]

❯ cargo run -p oxc_formatter --example formatter t.ts --ir
    Finished `dev` profile [unoptimized] target(s) in 0.05s
     Running `target/debug/examples/formatter t.ts --ir`
[
  StaticText("import"),
  Space,
  StaticText("{"),
  Space,
  DynamicText("useState"),
  Space,
  StaticText("}"),
  Space,
  StaticText("from"),
  Space,
  LocatedTokenText("\"react\""),
  StaticText(";"),
  Line(Empty),
  StaticText("export"),
  Space,
  StaticText("function"),
  Space,
  DynamicText("useData"),
  Tag(StartGroup(Group { id: None, mode: Cell { value: Flat } })),
  Tag(EndGroup),
  Tag(StartGroup(Group { id: None, mode: Cell { value: Flat } })),
  StaticText("("),
  Tag(StartGroup(Group { id: None, mode: Cell { value: Flat } })),
  Tag(EndGroup),
  StaticText(")"),
  Tag(EndGroup),
  Space,
  Space,
  StaticText("{"),
  Tag(StartIndent),
  Line(Hard),

...

  StaticText("}"),
  Line(Hard),
]

[leaysgur]

• feat(formatter): Export doc() API to inspect IR in example #14068 👈 (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 Instrumentation Performance Report

Merging #14068 will not alter performance

_{Comparing 09-24-feat_formatter_export_doc_api_to_inspect_ir_in_example (10a41ab) with main (1b3f437)}

Summary

✅ 37 untouched

[Copilot]

Pull Request Overview

Adds a new doc() API to the Formatter that returns the intermediate representation (IR) before printing, allowing inspection of the formatting document structure. This enables debugging and understanding of how the formatter processes code internally.

• Introduces doc() method that returns the formatting IR as a Document
• Refactors build() method to use shared internal format() function
• Adds --ir flag to formatter example to display the IR structure

Reviewed Changes

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

File	Description
crates/oxc_formatter/src/lib.rs	Adds doc() API and refactors build() to share formatting logic
crates/oxc_formatter/examples/formatter.rs	Adds --ir flag support to display IR structure

---

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

[Dunqing]

It looks good for now. I will refactor it when the TypeScript support is complete.

[Dunqing]

Merge activity

• Sep 24, 6:22 AM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Sep 24, 6:22 AM UTC: Dunqing added this pull request to the Graphite merge queue.
• Sep 24, 6:27 AM UTC: Merged by the Graphite merge queue.