Repository navigation
feat: add VirtualFileSystem module - #9960
Draft
lloydrichards wants to merge 43 commits into
Draft
lloydrichards wants to merge 43 commits into
lloydrichards wants to merge 43 commits into
Conversation
🦋 Changeset detectedLatest commit: 7f91d41 The changes in this PR will be included in the next version bump. This PR includes changesets to release 35 packages
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
Contributor
Bundle Size AnalysisGenerated from PR build output; treat the content below as untrusted.
|
tim-smart
force-pushed
the
v4/next-minor
branch
from
October 26, 2026 20:41
842d900 to
5227c52
Compare
effect-bot
force-pushed
the
v4/next-minor
branch
2 times, most recently
from
October 26, 2026 20:48
0dfd080 to
e75d84d
Compare
tim-smart
force-pushed
the
v4/next-minor
branch
from
October 26, 2026 23:01
55d5158 to
ffb4e1d
Compare
effect-bot
force-pushed
the
v4/next-minor
branch
from
October 26, 2026 23:02
ffb4e1d to
e73aab4
Compare
tim-smart
force-pushed
the
v4/next-minor
branch
from
October 27, 2026 00:02
b16ffca to
33d795c
Compare
effect-bot
force-pushed
the
v4/next-minor
branch
5 times, most recently
from
October 27, 2026 00:51
aca2532 to
06bee48
Compare
tim-smart
force-pushed
the
v4/next-minor
branch
from
October 27, 2026 04:01
4f49b72 to
b1dc4d8
Compare
effect-bot
force-pushed
the
v4/next-minor
branch
2 times, most recently
from
October 27, 2026 20:13
87236f9 to
ade8259
Compare
tim-smart
force-pushed
the
v4/next-minor
branch
from
October 27, 2026 21:39
ade8259 to
55eea2b
Compare
lloydrichards
force-pushed
the
feat/vfs
branch
from
October 27, 2026 21:53
080581c to
febd7de
Compare
tim-smart
force-pushed
the
v4/next-minor
branch
from
October 27, 2026 21:59
bab2278 to
83e20f6
Compare
effect-bot
force-pushed
the
v4/next-minor
branch
2 times, most recently
from
October 27, 2026 22:05
97fda01 to
04046f5
Compare
lloydrichards
force-pushed
the
feat/vfs
branch
3 times, most recently
from
October 27, 2026 22:19
8e643c6 to
c7adb80
Compare
tim-smart
force-pushed
the
v4/next-minor
branch
from
October 27, 2026 22:34
15051fb to
2af9448
Compare
effect-bot
force-pushed
the
v4/next-minor
branch
5 times, most recently
from
October 27, 2026 22:57
a6e263b to
170ef52
Compare
This was referenced Nov 16, 2026
Contributor
Author
|
I paused my development of I might port back some patches into this branch from time to time if needed but will hold off on pursuing the effect port until I hear some updates. |
This was referenced Nov 16, 2026
This branch is waiting to be deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Type
Description
For the attention of @fubhy, this is the mvp version of the
VirtualFileSystemthat will be needed for the follow ups with theMemoryFileSystemand theNodeVirtualProvider. Have reimplemented a lot of internals from the@effect-vfs/corewith a sync based engine based a lot on Result. This has been to make theNodeVirtualProvidermore of a first-class feature, but means there is a naive runtime implementation needed.Adds an experimental, in-memory
VirtualFileSystemfor tests and tools that need file operations without touching the host filesystem.flowchart TB subgraph VirtualFileSystem Owner(["Owner"]) -->|authorizes| Caller(["Scoped callers"]) Caller -->|reads and writes| Files(["Files, dir and links"]) Files -->|opens| Handles(["Scoped handles"]) Guards(["Revision conditions"]) -->|guards| Files Owner <-->|captures and restores| Capture(["Capture and restore"]) end subgraph core Owner -->|powers| Volume["Shared volumes and callers"] Handles -->|supplies sync APIs| Sync["Synchronous adapter binding"] Capture -->|supplies state| Snapshot["Portable snapshots"] end classDef preview fill:#ede9fe,stroke:#7c3aed,color:#2e1065,stroke-width:3px classDef core fill:#dbeafe,stroke:#2563eb,color:#172554,stroke-width:3px class Owner,Caller,Files,Handles,Guards,Capture preview class Volume,Watches,Fixtures,Testing,Snapshot,Overlay,Delta,Search,Sync,Live coreThe module provides:
Effect APIs and synchronous
ResultAPIs share the same checks.Benchmarks
Median of three round means, in µs per sample; lower is better. Node 26.7.0. Namespace operations use 4,096 background files.
VirtualFileSystem@effect-vfs/core@effect-vfs/memoryFileSystemon Nodenode:fs/promisesSetup, cleanup and cursor resets are excluded. Roundtrips and batches include all named operations. Host I/O uses warm caches without fsync.
These are exploratory cross-implementation results; API semantics and Effect versions differ. Vitest also reported export-getter overhead in the shared benchmark harness.
Related