Skip to content

fix: emit DUPLICATE_SHEBANG warning when banner contains shebang#9026

Merged
graphite-app[bot] merged 1 commit intomainfrom
04-07-fix_9024
Apr 9, 2026
Merged

fix: emit DUPLICATE_SHEBANG warning when banner contains shebang#9026
graphite-app[bot] merged 1 commit intomainfrom
04-07-fix_9024

Conversation

@IWANABETHATGUY
Copy link
Copy Markdown
Member

@IWANABETHATGUY IWANABETHATGUY commented Apr 7, 2026

Summary

The existing DUPLICATE_SHEBANG diagnostic only checked postBanner against the chunk content, and it ran in post_banner_footerafter minify_chunks. This meant:

  1. output.banner with a shebang was never checked, so no warning was emitted.
  2. Because minify_chunks reparses the rendered chunk (which already contains two shebangs from entry + banner), the invalid JS produces a broken AST, and the codegen silently drops the bundle body — leaving only a shebang line in the output.

The fix moves the duplicate shebang detection to ecma_generator (pre-rendering), where all three shebang sources (entry hashbang, banner, postBanner) are available as resolved values. This catches conflicts before minification can destroy the output.

Changes

  • Add has_shebang utility for efficient shebang detection without unnecessary newline scanning
  • Check all pairwise combinations of entry hashbang, banner, and postBanner for duplicate shebangs
  • Skip the entry hashbang check for UMD format (which silently drops it), while still warning when UMD banner and postBanner both have shebangs
  • Add source field to DuplicateShebang diagnostic so the warning message specifies which addon caused the conflict

Fixes #9024

Test plan

  • banner/duplicate-shebang-fn — function-based banner with shebang warns
  • post-banner/duplicate-shebang-fn — function-based postBanner with shebang warns
  • post-banner/duplicate-shebang — existing static postBanner test still passes
  • esbuild/hashbang_banner_use_strict_order — snapshot updated with warning
  • umd_entry_hashbang_post_banner_shebang — UMD entry hashbang + postBanner: no false positive
  • umd_banner_post_banner_duplicate_shebang — UMD banner + postBanner: warns correctly

🤖 Generated with Claude Code

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
Copy link
Copy Markdown

netlify Bot commented Apr 7, 2026

Deploy Preview for rolldown-rs ready!

Name Link
🔨 Latest commit 453d242
🔍 Latest deploy log https://app.netlify.com/projects/rolldown-rs/deploys/69d50c4be8c488000826bbd8
😎 Deploy Preview https://deploy-preview-9026--rolldown-rs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 7, 2026

Deploy Preview for rolldown-rs canceled.

Name Link
🔨 Latest commit 9dd533a
🔍 Latest deploy log https://app.netlify.com/projects/rolldown-rs/deploys/69d75dd2e8aba00008d4f208

@IWANABETHATGUY IWANABETHATGUY changed the title fix: 9024 fix: emit DUPLICATE_SHEBANG warning when banner contains shebang Apr 7, 2026
@IWANABETHATGUY IWANABETHATGUY force-pushed the 04-07-fix_9024 branch 6 times, most recently from a0e9f7a to ca32214 Compare April 9, 2026 04:15
@IWANABETHATGUY IWANABETHATGUY marked this pull request as ready for review April 9, 2026 04:16
@codspeed-hq
Copy link
Copy Markdown

codspeed-hq Bot commented Apr 9, 2026

Merging this PR will not alter performance

✅ 4 untouched benchmarks
⏩ 10 skipped benchmarks1


Comparing 04-07-fix_9024 (ca32214) with main (9886344)

Open in CodSpeed

Footnotes

  1. 10 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.

Copy link
Copy Markdown
Member

@hyf0 hyf0 left a comment

Choose a reason for hiding this comment

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

👍

Copy link
Copy Markdown
Member Author

IWANABETHATGUY commented Apr 9, 2026

Merge activity

  • Apr 9, 8:03 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.
  • Apr 9, 8:03 AM UTC: IWANABETHATGUY added this pull request to the Graphite merge queue.
  • Apr 9, 8:10 AM UTC: Merged by the Graphite merge queue.

## Summary

The existing `DUPLICATE_SHEBANG` diagnostic only checked `postBanner` against the chunk content, and it ran in `post_banner_footer` — **after** `minify_chunks`. This meant:

1. `output.banner` with a shebang was never checked, so no warning was emitted.
2. Because `minify_chunks` reparses the rendered chunk (which already contains two shebangs from entry + banner), the invalid JS produces a broken AST, and the codegen silently drops the bundle body — leaving only a shebang line in the output.

The fix moves the duplicate shebang detection to `ecma_generator` (pre-rendering), where all three shebang sources (entry hashbang, banner, postBanner) are available as resolved values. This catches conflicts **before** minification can destroy the output.

### Changes
- Add `has_shebang` utility for efficient shebang detection without unnecessary newline scanning
- Check all pairwise combinations of entry hashbang, banner, and postBanner for duplicate shebangs
- Skip the entry hashbang check for UMD format (which silently drops it), while still warning when UMD banner and postBanner both have shebangs
- Add `source` field to `DuplicateShebang` diagnostic so the warning message specifies which addon caused the conflict

Fixes #9024

## Test plan
- [x] `banner/duplicate-shebang-fn` — function-based banner with shebang warns
- [x] `post-banner/duplicate-shebang-fn` — function-based postBanner with shebang warns
- [x] `post-banner/duplicate-shebang` — existing static postBanner test still passes
- [x] `esbuild/hashbang_banner_use_strict_order` — snapshot updated with warning
- [x] `umd_entry_hashbang_post_banner_shebang` — UMD entry hashbang + postBanner: no false positive
- [x] `umd_banner_post_banner_duplicate_shebang` — UMD banner + postBanner: warns correctly

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@graphite-app graphite-app Bot merged commit 9dd533a into main Apr 9, 2026
31 checks passed
@graphite-app graphite-app Bot deleted the 04-07-fix_9024 branch April 9, 2026 08:10
This was referenced Apr 15, 2026
shulaoda added a commit that referenced this pull request Apr 16, 2026
## [1.0.0-rc.16] - 2026-04-16

### 🚀 Features

- const enum cross-module inlining support (#8796) by @Dunqing
- implement module tagging system for code splitting (#9045) by @hyf0

### 🐛 Bug Fixes

- rolldown_plugin_vite_manifest: handle duplicate chunk names for CSS entries (#9059) by @sapphi-red
- improve error message for invalid return values in function options (#9125) by @shulaoda
- await async export-star init wrappers (#9101) by @thezzisu
- never panic during diagnostic emission (#9091) by @IWANABETHATGUY
- include array rest pattern in binding_identifiers (#9112) by @IWANABETHATGUY
- rolldown: set worker thread count with ROLLDOWN_WORKER_THREADS (#9086) by @fpotter
- rolldown_plugin_lazy_compilation: escape request ID in proxy modules (#9102) by @h-a-n-a
- treat namespace member access as side-effect-free (#9099) by @IWANABETHATGUY
- relax overly conservative side-effect leak check in chunk optimizer (#9085) by @IWANABETHATGUY
- runtime: release `cb` reference after `__commonJS` factory initialization (#9067) by @hyf0-agent
- `@__NO_SIDE_EFFECTS__` wrapper should not remove dynamic imports (#9075) by @IWANABETHATGUY
- rolldown_plugin_vite_import_glob: use POSIX path join/normalize for glob resolution (#9077) by @shulaoda
- emit REQUIRE_TLA error when require() loads a module with top-level await (#9071) by @jaehafe
- emit namespace declaration for empty modules in manual chunks (#8993) by @privatenumber
- rolldown_plugin_vite_import_glob: keep common base on path segment boundary (#9070) by @shulaoda
- prevent circular runtime helper imports during facade elimination (#8989) (#9057) by @IWANABETHATGUY
- correct circular dependency check in facade elimination (#9047) by @h-a-n-a
- docs: correct dead link in CodeSplittingGroup.tags JSDoc (#9051) by @hyf0
- emit DUPLICATE_SHEBANG warning when banner contains shebang (#9026) by @IWANABETHATGUY

### 🚜 Refactor

- use semantic reference flags for member write detection (#9060) by @Dunqing
- extract UsedSymbolRefs newtype wrapper (#9130) by @IWANABETHATGUY
- dedupe await wrapping in export-star init emit (#9119) by @IWANABETHATGUY
- calculate side-effect-free function symbols on demand (#9120) by @IWANABETHATGUY
- extract duplicated top-level await handling into shared helper (#9087) by @IWANABETHATGUY
- rolldown_plugin_vite_import_glob: use split_first for get_common_base (#9069) by @shulaoda
- simplify ESM init deduplication with idiomatic insert check (#9044) by @IWANABETHATGUY

### 📚 Documentation

- document runtime module placement strategy in code-splitting design (#9062) by @IWANABETHATGUY
- clarify `options` hook behavior difference with Rollup in watch mode (#9053) by @sapphi-red
- meta/design: introduce module tags (#9017) by @hyf0

### ⚡ Performance

- convert `generate_transitive_esm_init` to iterative (#9046) by @IWANABETHATGUY

### 🧪 Testing

- merge strict/non_strict test variants using configVariants (#9089) by @IWANABETHATGUY

### ⚙️ Miscellaneous Tasks

- disable Renovate auto-updates for oxc packages (#9129) by @IWANABETHATGUY
- upgrade oxc@0.126.0 (#9127) by @Dunqing
- deps: update napi to v3.8.5 (#9126) by @renovate[bot]
- deps: update dependency @napi-rs/cli to v3.6.2 (#9123) by @renovate[bot]
- move lazy-compilation design doc (#9117) by @h-a-n-a
- deps: update dependency vite-plus to v0.1.18 (#9118) by @renovate[bot]
- deps: update dependency vite-plus to v0.1.17 (#9113) by @renovate[bot]
- deps: update oxc to v0.125.0 (#9094) by @renovate[bot]
- deps: update dependency follow-redirects to v1.16.0 [security] (#9103) by @renovate[bot]
- deps: update test262 submodule for tests (#9097) by @sapphi-red
- deps: update crate-ci/typos action to v1.45.1 (#9096) by @renovate[bot]
- deps: update rust crates (#9081) by @renovate[bot]
- deps: update npm packages (#9080) by @renovate[bot]
- remove outdated TODO in determine_module_exports_kind (#9072) by @jaehafe
- rust/test: support `extendedTests: false` shorthand in test config (#9050) by @hyf0
- ci: extract shared infra-changes anchor in path filters (#9054) by @hyf0
- add docs build check to catch dead links in PRs (#9052) by @hyf0

### ❤️ New Contributors

* @thezzisu made their first contribution in [#9101](#9101)
* @fpotter made their first contribution in [#9086](#9086)
* @jaehafe made their first contribution in [#9071](#9071)
* @privatenumber made their first contribution in [#8993](#8993)

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.

[Bug]: output.banner with a shebang can produce an empty bundle with entry file already has a shebang

3 participants