feat: support output.sourcemapExcludeSources option

sapphi-red · sapphi-red · commit 9e4283f322bd · 2026-03-21T22:06:56.000+09:00
diff --git a/crates/rolldown/src/utils/prepare_build_context.rs b/crates/rolldown/src/utils/prepare_build_context.rs
@@ -401,6 +401,7 @@ pub fn prepare_build_context(
     sourcemap_ignore_list: raw_options.sourcemap_ignore_list,
     sourcemap_path_transform: raw_options.sourcemap_path_transform,
     sourcemap_debug_ids: raw_options.sourcemap_debug_ids.unwrap_or(false),
+    sourcemap_exclude_sources: raw_options.sourcemap_exclude_sources.unwrap_or(false),
     shim_missing_exports: raw_options.shim_missing_exports.unwrap_or(false),
     module_types,
     experimental,
diff --git a/crates/rolldown/src/utils/process_code_and_sourcemap.rs b/crates/rolldown/src/utils/process_code_and_sourcemap.rs
@@ -24,6 +24,10 @@ pub async fn process_code_and_sourcemap(
   let file_base_name = Path::new(filename).file_name().expect("should have file name");
   map.set_file(file_base_name.to_string_lossy().as_ref());
 
+  if options.sourcemap_exclude_sources {
+    map.set_source_contents(vec![]);
+  }
+
   let map_filename = format!("{filename}.map");
   let map_path = file_dir.join(&map_filename);
 
diff --git a/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/_config.json b/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/_config.json
@@ -0,0 +1,8 @@
+{
+  "config": {
+    "entryFilenames": "assets/[name].js",
+    "sourcemap": "File",
+    "sourcemapExcludeSources": true
+  },
+  "expectExecuted": false
+}
diff --git a/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/_test.mjs b/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/_test.mjs
@@ -0,0 +1,11 @@
+import fs from 'node:fs';
+import assert from 'node:assert';
+import path from 'node:path';
+
+const sourceMap = JSON.parse(
+  fs.readFileSync(path.resolve(import.meta.dirname, 'dist/assets/main.js.map'), 'utf8'),
+);
+assert.ok(
+  !sourceMap.sourcesContent || sourceMap.sourcesContent.length === 0,
+  'sourcesContent should be empty or absent',
+);
diff --git a/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/artifacts.snap b/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/artifacts.snap
@@ -0,0 +1,14 @@
+---
+source: crates/rolldown_testing/src/integration_test.rs
+---
+# Assets
+
+## assets/main.js
+
+```js
+//#region main.js
+console.log(1);
+//#endregion
+
+//# sourceMappingURL=main.js.map
+```
diff --git a/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/main.js b/crates/rolldown/tests/rolldown/sourcemap/exclude_sources/main.js
@@ -0,0 +1 @@
+console.log(1);
diff --git a/crates/rolldown_binding/src/options/binding_output_options/mod.rs b/crates/rolldown_binding/src/options/binding_output_options/mod.rs
@@ -132,7 +132,7 @@ pub struct BindingOutputOptions<'env> {
   #[debug(skip)]
   #[napi(ts_type = "(source: string, sourcemapPath: string) => string")]
   pub sourcemap_path_transform: Option<JsCallback<FnArgs<(String, String)>, String>>,
-  // sourcemapExcludeSources: boolean;
+  pub sourcemap_exclude_sources: Option<bool>,
   // sourcemapFile: string | undefined;
   #[napi(ts_type = "boolean | 'auto'")]
   pub strict: Option<Either<bool, String>>,
diff --git a/crates/rolldown_binding/src/types/binding_normalized_options.rs b/crates/rolldown_binding/src/types/binding_normalized_options.rs
@@ -250,6 +250,11 @@ impl BindingNormalizedOptions {
     self.inner.sourcemap_debug_ids
   }
 
+  #[napi(getter)]
+  pub fn sourcemap_exclude_sources(&self) -> bool {
+    self.inner.sourcemap_exclude_sources
+  }
+
   #[napi(getter)]
   pub fn polyfill_require(&self) -> bool {
     self.inner.polyfill_require
diff --git a/crates/rolldown_binding/src/utils/normalize_binding_options.rs b/crates/rolldown_binding/src/utils/normalize_binding_options.rs
@@ -349,6 +349,7 @@ pub fn normalize_binding_options(
     sourcemap_ignore_list,
     sourcemap_path_transform,
     sourcemap_debug_ids: output_options.sourcemap_debug_ids,
+    sourcemap_exclude_sources: output_options.sourcemap_exclude_sources,
     exports: output_options
       .exports
       .map(|format_str| {
diff --git a/crates/rolldown_common/src/inner_bundler_options/mod.rs b/crates/rolldown_common/src/inner_bundler_options/mod.rs
@@ -161,6 +161,7 @@ pub struct BundlerOptions {
   )]
   pub sourcemap_path_transform: Option<SourceMapPathTransform>,
   pub sourcemap_debug_ids: Option<bool>,
+  pub sourcemap_exclude_sources: Option<bool>,
 
   /// Key is the file extension. The extension should start with a `.`. E.g. `".txt"`.
   pub module_types: Option<FxHashMap<String, ModuleType>>,
diff --git a/crates/rolldown_common/src/inner_bundler_options/types/normalized_bundler_options.rs b/crates/rolldown_common/src/inner_bundler_options/types/normalized_bundler_options.rs
@@ -78,6 +78,7 @@ pub struct NormalizedBundlerOptions {
   pub sourcemap_ignore_list: Option<SourceMapIgnoreList>,
   pub sourcemap_path_transform: Option<SourceMapPathTransform>,
   pub sourcemap_debug_ids: bool,
+  pub sourcemap_exclude_sources: bool,
   pub sourcemap_base_url: Option<String>,
   pub experimental: ExperimentalOptions,
   pub minify: MinifyOptions,
@@ -154,6 +155,7 @@ impl Default for NormalizedBundlerOptions {
       sourcemap_ignore_list: Default::default(),
       sourcemap_path_transform: Default::default(),
       sourcemap_debug_ids: Default::default(),
+      sourcemap_exclude_sources: false,
       sourcemap_base_url: Default::default(),
       experimental: Default::default(),
       minify: MinifyOptions::Disabled,
diff --git a/crates/rolldown_testing/_config.schema.json b/crates/rolldown_testing/_config.schema.json
@@ -305,6 +305,12 @@
             "null"
           ]
         },
+        "sourcemapExcludeSources": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
         "moduleTypes": {
           "description": "Key is the file extension. The extension should start with a `.`. E.g. `\".txt\"`.",
           "type": [
diff --git a/packages/rolldown/src/binding.d.cts b/packages/rolldown/src/binding.d.cts
@@ -1601,6 +1601,7 @@ export declare class BindingNormalizedOptions {
   get globals(): Record<string, string> | undefined
   get hashCharacters(): 'base64' | 'base36' | 'hex'
   get sourcemapDebugIds(): boolean
+  get sourcemapExcludeSources(): boolean
   get polyfillRequire(): boolean
   get minify(): false | 'dce-only' | MinifyOptions
   get legalComments(): 'none' | 'inline'
@@ -2388,6 +2389,7 @@ export interface BindingOutputOptions {
   sourcemapIgnoreList?: boolean | string | RegExp | ((source: string, sourcemapPath: string) => boolean)
   sourcemapDebugIds?: boolean
   sourcemapPathTransform?: (source: string, sourcemapPath: string) => string
+  sourcemapExcludeSources?: boolean
   strict?: boolean | 'auto'
   minify?: boolean | 'dce-only' | MinifyOptions
   manualCodeSplitting?: BindingManualCodeSplittingOptions
diff --git a/packages/rolldown/src/options/normalized-output-options.ts b/packages/rolldown/src/options/normalized-output-options.ts
@@ -78,6 +78,8 @@ export interface NormalizedOutputOptions {
   hashCharacters: 'base64' | 'base36' | 'hex';
   /** @see {@linkcode OutputOptions.sourcemapDebugIds | sourcemapDebugIds} */
   sourcemapDebugIds: boolean;
+  /** @see {@linkcode OutputOptions.sourcemapExcludeSources | sourcemapExcludeSources} */
+  sourcemapExcludeSources: boolean;
   /** @see {@linkcode OutputOptions.sourcemapIgnoreList | sourcemapIgnoreList} */
   sourcemapIgnoreList: boolean | SourcemapIgnoreListOption | StringOrRegExp | undefined;
   /** @see {@linkcode OutputOptions.sourcemapPathTransform | sourcemapPathTransform} */
@@ -257,6 +259,11 @@ export class NormalizedOutputOptionsImpl
     return this.inner.sourcemapDebugIds;
   }
 
+  @lazyProp
+  get sourcemapExcludeSources(): boolean {
+    return this.inner.sourcemapExcludeSources;
+  }
+
   @lazyProp
   get sourcemapIgnoreList(): boolean | SourcemapIgnoreListOption | StringOrRegExp | undefined {
     return this.outputOptions.sourcemapIgnoreList;
diff --git a/packages/rolldown/src/options/output-options.ts b/packages/rolldown/src/options/output-options.ts
@@ -245,6 +245,16 @@ export interface OutputOptions {
    * ```
    */
   sourcemapPathTransform?: SourcemapPathTransformOption;
+  /**
+   * Whether to exclude the original source code from sourcemaps.
+   *
+   * When `true`, the `sourcesContent` field is omitted from the generated sourcemap,
+   * reducing the sourcemap file size. The sourcemap will still contain source file paths
+   * and mappings, so debugging works if the original files are available.
+   *
+   * @default false
+   */
+  sourcemapExcludeSources?: boolean;
   /**
    * A string to prepend to the bundle before {@linkcode Plugin.renderChunk | renderChunk} hook.
    *
diff --git a/packages/rolldown/src/utils/bindingify-output-options.ts b/packages/rolldown/src/utils/bindingify-output-options.ts
@@ -15,6 +15,7 @@ export function bindingifyOutputOptions(outputOptions: OutputOptions): BindingOu
     sourcemap,
     sourcemapBaseUrl,
     sourcemapDebugIds,
+    sourcemapExcludeSources,
     sourcemapIgnoreList,
     sourcemapPathTransform,
     name,
@@ -66,6 +67,7 @@ export function bindingifyOutputOptions(outputOptions: OutputOptions): BindingOu
     sourcemap: bindingifySourcemap(sourcemap),
     sourcemapBaseUrl,
     sourcemapDebugIds,
+    sourcemapExcludeSources,
     sourcemapIgnoreList: sourcemapIgnoreList ?? /node_modules/,
     sourcemapPathTransform,
     banner: bindingifyAddon(banner),
diff --git a/packages/rolldown/src/utils/validator.ts b/packages/rolldown/src/utils/validator.ts
@@ -853,6 +853,10 @@ const OutputOptionsSchema = v.strictObject({
     v.description('Base URL used to prefix sourcemap paths'),
   ),
   sourcemapDebugIds: v.pipe(v.optional(v.boolean()), v.description('Inject sourcemap debug IDs')),
+  sourcemapExcludeSources: v.pipe(
+    v.optional(v.boolean()),
+    v.description('Exclude source content from sourcemaps'),
+  ),
   sourcemapIgnoreList: v.optional(
     v.union([v.boolean(), v.custom<SourcemapIgnoreListOption>(() => true), StringOrRegExpSchema]),
   ),
diff --git a/packages/rolldown/tests/cli/__snapshots__/cli-e2e.test.ts.snap b/packages/rolldown/tests/cli/__snapshots__/cli-e2e.test.ts.snap
@@ -87,6 +87,7 @@ OPTIONS
   --shim-missing-exports      Create shim variables for missing exports.
   --sourcemap-base-url <sourcemap-base-url>Base URL used to prefix sourcemap paths.
   --sourcemap-debug-ids       Inject sourcemap debug IDs.
+  --sourcemap-exclude-sources Exclude source content from sourcemaps.
   --strict <strict>           Whether to always output \`"use strict"\` directive in non-ES module outputs.
   --strict-execution-order    Lets modules be executed in the order they are declared.
   --top-level-var             Rewrite top-level declarations to use \`var\`.
@@ -227,6 +228,7 @@ OPTIONS
   --shim-missing-exports      Create shim variables for missing exports.
   --sourcemap-base-url <sourcemap-base-url>Base URL used to prefix sourcemap paths.
   --sourcemap-debug-ids       Inject sourcemap debug IDs.
+  --sourcemap-exclude-sources Exclude source content from sourcemaps.
   --strict <strict>           Whether to always output \`"use strict"\` directive in non-ES module outputs.
   --strict-execution-order    Lets modules be executed in the order they are declared.
   --top-level-var             Rewrite top-level declarations to use \`var\`.
@@ -367,6 +369,7 @@ OPTIONS
   --shim-missing-exports      Create shim variables for missing exports.
   --sourcemap-base-url <sourcemap-base-url>Base URL used to prefix sourcemap paths.
   --sourcemap-debug-ids       Inject sourcemap debug IDs.
+  --sourcemap-exclude-sources Exclude source content from sourcemaps.
   --strict <strict>           Whether to always output \`"use strict"\` directive in non-ES module outputs.
   --strict-execution-order    Lets modules be executed in the order they are declared.
   --top-level-var             Rewrite top-level declarations to use \`var\`.
@@ -507,6 +510,7 @@ OPTIONS
   --shim-missing-exports      Create shim variables for missing exports.
   --sourcemap-base-url <sourcemap-base-url>Base URL used to prefix sourcemap paths.
   --sourcemap-debug-ids       Inject sourcemap debug IDs.
+  --sourcemap-exclude-sources Exclude source content from sourcemaps.
   --strict <strict>           Whether to always output \`"use strict"\` directive in non-ES module outputs.
   --strict-execution-order    Lets modules be executed in the order they are declared.
   --top-level-var             Rewrite top-level declarations to use \`var\`.
diff --git a/packages/rollup-tests/src/ignored-by-unsupported-features.md b/packages/rollup-tests/src/ignored-by-unsupported-features.md
@@ -212,8 +212,6 @@
  - rollup@function@amd-base-path-id: throws when using both the amd.basePath and the amd.id option
  - rollup@function@amd-base-path: throws when using only amd.basePath option
 
-### The `output.sourcemapExcludeSources` is not supported
- - rollup@form@sourcemaps-excludesources: correct sourcemaps are written (excluding sourceContent)@generates es
 
 ### The `output.sourcemapBaseUrl` is not compatible yet
  - rollup@function@sourcemap-base-url-invalid: throws for invalid sourcemapBaseUrl
diff --git a/packages/rollup-tests/src/ignored-passed-snapshot-different-tests.js b/packages/rollup-tests/src/ignored-passed-snapshot-different-tests.js
@@ -152,6 +152,7 @@ module.exports = [
     "rollup@function@sourcemap-inline-generatebundle: includes inline sourcemap comments in generateBundle hook",
     "rollup@form@sourcemaps-external: correct sourcemaps are written (separate file)@generates es", // the mappping is not same as rollup
     "rollup@form@sourcemaps-hidden: correct sourcemaps are written (separate file) without comment@generates es", // the mappping is not same as rollup
+    "rollup@form@sourcemaps-excludesources: correct sourcemaps are written (excluding sourceContent)@generates es", // the mapping is not same as rollup
     "rollup@sourcemaps@render-chunk-babili: generates valid sourcemap when source could not be determined@generates es", // The rolldown output chunk including `module comment` caused line offset, the rollup provider the fake sourcemap can't remapping.
     "rollup@form@render-chunk-plugin-sourcemaps: supports returning undefined source maps from render chunk hooks, when source maps are enabled@generates es", // the mappping is not same as rollup, the `sources/sourcesContent` perseved original sourcemap is correct
     "rollup@sourcemaps@transform-low-resolution: handles combining low-resolution and high-resolution source-maps when transforming@generates es",// the input string `'bar'`, the rolldown output `"bar"`, caused search original position failed
