Skip to content

Comments

feat: export memfs from rolldown/experimental for browser builds#7490

Merged
graphite-app[bot] merged 1 commit intomainfrom
copilot/export-volume-in-rolldown-browser
Dec 15, 2025
Merged

feat: export memfs from rolldown/experimental for browser builds#7490
graphite-app[bot] merged 1 commit intomainfrom
copilot/export-volume-in-rolldown-browser

Conversation

Copy link
Contributor

Copilot AI commented Dec 14, 2025

Exports builtinFs from rolldown/experimental to allow users to access the virtual filesystem when using rolldown in browser environments.

Changes

  • Export builtinFs: { fs, volume } from rolldown/experimental
    • fs: The filesystem instance from the memfs package used by the WASM runtime
    • volume: The Volume instance from the memfs package used by the WASM runtime
    • Returns undefined in Node.js builds (only available in browser builds via @rolldown/browser)

Usage

import { builtinFs } from 'rolldown/experimental';

// Write files to virtual filesystem before bundling
builtinFs?.volume.fromJSON({
  '/src/index.js': 'export const foo = 42;',
  '/package.json': '{"name": "my-app"}'
});
Original prompt

This section details on the original issue you should resolve

<issue_title>[Feature Request]: export __volume in rolldown browser to allow building complex packages</issue_title>
<issue_description>### What problem does this feature solve?

Hi,

We are trying to use rolldown in the browser to bundle files that depend on node_modules downloaded packages. For that to work, we need to have direct access to __volume. See #6218 (comment)

What does the proposed API look like?

Simply export __volume so that it can be accessed directly.</issue_description>

<agent_instructions>Only add the export under rolldown/experimental</agent_instructions>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@netlify
Copy link

netlify bot commented Dec 14, 2025

Deploy Preview for rolldown-rs ready!

Name Link
🔨 Latest commit 8b55cec
🔍 Latest deploy log https://app.netlify.com/projects/rolldown-rs/deploys/69401cb2bd93a30008cedf3c
😎 Deploy Preview https://deploy-preview-7490--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.

Copilot AI changed the title [WIP] Add export for __volume in rolldown browser feat: export __volume from rolldown/experimental for browser builds Dec 14, 2025
Copilot AI requested a review from hyf0 December 14, 2025 12:18
Copilot AI changed the title feat: export __volume from rolldown/experimental for browser builds feat: export builtinFs from rolldown/experimental for browser builds Dec 14, 2025
Copilot AI requested a review from sxzz December 14, 2025 15:03
@hyf0 hyf0 force-pushed the copilot/export-volume-in-rolldown-browser branch from 721cb6b to f10442a Compare December 15, 2025 14:11
Copy link
Member

hyf0 commented Dec 15, 2025


How to use the Graphite Merge Queue

Add the label graphite: merge 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.

@hyf0
Copy link
Member

hyf0 commented Dec 15, 2025

@sxzz I changed the name to memfs(same with here) to make it a bit of scary and remind users this's something that needs to pay attention to.

@hyf0 hyf0 changed the title feat: export builtinFs from rolldown/experimental for browser builds feat: export memfs from rolldown/experimental for browser builds Dec 15, 2025
@hyf0 hyf0 marked this pull request as ready for review December 15, 2025 14:19
Copilot AI review requested due to automatic review settings December 15, 2025 14:19
@hyf0
Copy link
Member

hyf0 commented Dec 15, 2025

We should find some documentation for it. #7515

Copy link
Member

hyf0 commented Dec 15, 2025

Merge activity

@hyf0 hyf0 mentioned this pull request Dec 15, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR exposes the virtual filesystem (memfs) used in browser builds of rolldown to allow users to populate the filesystem before bundling. This addresses a feature request to enable building complex packages with node_modules dependencies in browser environments.

  • Exports a new memfs object from rolldown/experimental containing fs and volume properties from the memfs package
  • Returns undefined in Node.js builds (only available in browser builds)
  • Uses conditional logic based on import.meta.browserBuild to safely access browser-only exports

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

graphite-app bot pushed a commit that referenced this pull request Dec 15, 2025
…7490)

Exports `builtinFs` from `rolldown/experimental` to allow users to access the virtual filesystem when using rolldown in browser environments.

### Changes

- Export `builtinFs: { fs, volume }` from `rolldown/experimental`
  - `fs`: The filesystem instance from the `memfs` package used by the WASM runtime
  - `volume`: The `Volume` instance from the `memfs` package used by the WASM runtime
  - Returns `undefined` in Node.js builds (only available in browser builds via `@rolldown/browser`)

### Usage

```typescript
import { builtinFs } from 'rolldown/experimental';

// Write files to virtual filesystem before bundling
builtinFs?.volume.fromJSON({
  '/src/index.js': 'export const foo = 42;',
  '/package.json': '{"name": "my-app"}'
});
```

<!-- START COPILOT ORIGINAL PROMPT -->

<details>

<summary>Original prompt</summary>

>
> ----
>
> *This section details on the original issue you should resolve*
>
> <issue_title>[Feature Request]: export `__volume` in rolldown browser to allow building complex packages</issue_title>
> <issue_description>### What problem does this feature solve?
>
> Hi,
>
> We are trying to use rolldown in the browser to bundle files that depend on node_modules downloaded packages. For that to work, we need to have direct access to __volume. See #6218 (comment)
>
> ### What does the proposed API look like?
>
> Simply export `__volume` so that it can be accessed directly.</issue_description>
>
> <agent_instructions>Only add the export under `rolldown/experimental`</agent_instructions>
>
> ## Comments on the Issue (you are @copilot in this section)
>
> <comments>
> </comments>
>

</details>

<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes #7489

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for you](https://github.com/rolldown/rolldown/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot) — coding agent works faster and does higher quality work when set up for your repo.
@graphite-app graphite-app bot force-pushed the copilot/export-volume-in-rolldown-browser branch from f10442a to 263fdd1 Compare December 15, 2025 14:34
…7490)

Exports `builtinFs` from `rolldown/experimental` to allow users to access the virtual filesystem when using rolldown in browser environments.

### Changes

- Export `builtinFs: { fs, volume }` from `rolldown/experimental`
  - `fs`: The filesystem instance from the `memfs` package used by the WASM runtime
  - `volume`: The `Volume` instance from the `memfs` package used by the WASM runtime
  - Returns `undefined` in Node.js builds (only available in browser builds via `@rolldown/browser`)

### Usage

```typescript
import { builtinFs } from 'rolldown/experimental';

// Write files to virtual filesystem before bundling
builtinFs?.volume.fromJSON({
  '/src/index.js': 'export const foo = 42;',
  '/package.json': '{"name": "my-app"}'
});
```

<!-- START COPILOT ORIGINAL PROMPT -->

<details>

<summary>Original prompt</summary>

>
> ----
>
> *This section details on the original issue you should resolve*
>
> <issue_title>[Feature Request]: export `__volume` in rolldown browser to allow building complex packages</issue_title>
> <issue_description>### What problem does this feature solve?
>
> Hi,
>
> We are trying to use rolldown in the browser to bundle files that depend on node_modules downloaded packages. For that to work, we need to have direct access to __volume. See #6218 (comment)
>
> ### What does the proposed API look like?
>
> Simply export `__volume` so that it can be accessed directly.</issue_description>
>
> <agent_instructions>Only add the export under `rolldown/experimental`</agent_instructions>
>
> ## Comments on the Issue (you are @copilot in this section)
>
> <comments>
> </comments>
>

</details>

<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes #7489

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for you](https://github.com/rolldown/rolldown/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot) — coding agent works faster and does higher quality work when set up for your repo.
@graphite-app graphite-app bot force-pushed the copilot/export-volume-in-rolldown-browser branch from 263fdd1 to 8b55cec Compare December 15, 2025 14:35
@graphite-app graphite-app bot merged commit 8b55cec into main Dec 15, 2025
25 checks passed
@graphite-app graphite-app bot deleted the copilot/export-volume-in-rolldown-browser branch December 15, 2025 14:52
This was referenced Dec 17, 2025
shulaoda added a commit that referenced this pull request Dec 17, 2025
## [1.0.0-beta.55] - 2025-12-17

### 🚀 Features

- add validation errors for incompatible `inlineDynamicImports` options (#7539) by @Copilot
- rolldown_plugin_vite_reporter: truncate long importer lists in ineffective dynamic import warnings (#7528) by @Copilot
- export `memfs` from `rolldown/experimental` for browser builds (#7490) by @Copilot
- implement `postBanner` and `postFooter` (#7487) by @sevenc-nanashi
- port getLogFilter helper from Rollup for advanced log filtering (#6890) by @taearls
- dev: initialize `rolldown_plugin_lazy_compilation` (#7488) by @hyf0
- enable `experimental.transform_hires_sourcemap: 'boundary'` by default (#7478) by @sapphi-red
- apply merge CJS namespace optimizations more generally (#7475) by @sapphi-red

### 🐛 Bug Fixes

- avoid panic on invalid values for `output.exports`, `output.format`, `output.hash_characters` (#7542) by @sapphi-red
- handle `__proto__` export for module namespace correctly (#7534) by @sapphi-red
- handle `__proto__` export correctly (#7533) by @sapphi-red
- rolldown_plugin_vite_resolve: acquire resolver lock before package json resolution (#7524) by @sapphi-red
- disable syntax transform optimization for `minify: 'dce-only'` (#7520) by @sapphi-red
- arrow function expression keep names (#7519) by @IWANABETHATGUY
- skip symbols that are imported from other module when deconflicting module symbols (#7510) by @IWANABETHATGUY
- preserve class names in assignment expressions with keepNames option (#7491) by @IWANABETHATGUY
- accessor with decorators should be kept (#7499) by @Copilot
- rolldown_plugin_vite_reporter: support `Infinity` for chunk_limit (#7497) by @shulaoda
- change filename template validation errors from UNHANDLEABLE_ERROR to INVALID_OPTION (#7472) by @Copilot
- `no entry found for key` error when merging CJS namespace exports (#7474) by @sapphi-red
- generate output with syntax error when wrapped esm module using tla syntax (#7468) by @IWANABETHATGUY

### 🚜 Refactor

- dev: rename `experimental.hmr` to `experimental.devMode` (#7527) by @hyf0
- pass addon option to rust as it is (#7526) by @hyf0
- remove unused stmtinfo meta flag (#7518) by @IWANABETHATGUY

### 📚 Documentation

- clarify `closeBundle` behavior (#7525) by @sapphi-red

### 🧪 Testing

- add tests for static string postBanner and postFooter (#7516) by @Copilot
- disable pluginTimings in Rust integration tests to avoid snapshot noise (#7485) by @shulaoda
- port Rollup JSX tests to `crates/rolldown/tests/rollup` (#7480) by @sapphi-red
- re-triage some esbuild JSX preserve tests (#7479) by @sapphi-red
- disable pluginTimings by default to avoid snapshot noise (#7471) by @shulaoda

### ⚙️ Miscellaneous Tasks

- mark feature that will not be supported as ignored in rollup test status (#7535) by @sapphi-red
- support `banner`/`footer`/`intro`/`outro` for config variants (#7532) by @sapphi-red
- `dce/dce_of_decorators` esbuild test is now passing (#7531) by @sapphi-red
- deps: update github-actions (major) (#7495) by @renovate[bot]
- deps: update npm packages (#7493) by @renovate[bot]
- add a check to verify failedReasons are updated (#7521) by @sapphi-red
- deps: update test262 submodule for tests (#7523) by @sapphi-red
- deps: update taiki-e/install-action action to v2.63.2 (#7496) by @renovate[bot]
- deps: update oxc apps (#7511) by @renovate[bot]
- deps: update oxc to v0.103.0 (#7513) by @camc314
- fix format in `.github/instructions/bug-investigation.instructions.md` (#7506) by @sapphi-red
- add instructions for REPL decoding (#7502) by @sapphi-red
- deps: update github-actions (#7492) by @renovate[bot]
- deps: cargo-shear v1.9.0 (#7483) by @Boshen
- deps: update dependency oxlint-tsgolint to v0.9.0 (#7484) by @renovate[bot]
- deps: update dependency oxlint-tsgolint to v0.8.6 (#7470) by @renovate[bot]
- add syntax validation for test output chunks that are not executed (#7466) by @IWANABETHATGUY
- deps: update dependency rust to v1.92.0 (#7467) by @renovate[bot]
- deps: update test262 submodule for tests (#7457) by @sapphi-red

### ❤️ New Contributors

* @sevenc-nanashi made their first contribution in [#7487](#7487)
* @taearls made their first contribution in [#6890](#6890)

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.

[Feature Request]: export __volume in rolldown browser to allow building complex packages

3 participants