@immediately-run/sandpack-client 2.20.0 → 2.21.0

package/dist/.ir-build-stamp.json

@@ -1,6 +1,6 @@
 {
   "name": "sandpack-client",
-  "version": "2.20.0",
-  "srcHash": "57b49235f4e6081897281fd4eab0848c2ee977d626606f235444047099739d79",
-  "builtAt": "2026-07-13T20:11:14.027Z"
+  "version": "2.21.0",
+  "srcHash": "afbc7e1f72ab14999158254aba8d870baf59194b341b07fe89ea866277efaf8d",
+  "builtAt": "2026-07-31T18:21:27.125Z"
 }

package/dist/clients/node/index.js

@@ -2,9 +2,9 @@
 
 var utils = require('../../utils-BiVyytui.js');
 var nodebox = require('@codesandbox/nodebox');
-require('../../types-mAM6HBIz.js');
+require('../../types-KEkDKvIe.js');
 var base = require('../../base-DelKLlDk.js');
-var consoleHook = require('../../consoleHook-Dva85ENr.js');
+var consoleHook = require('../../consoleHook-BRSVCdB0.js');
 require('outvariant');
 require('@zenfs/core');
 require('dequal');

package/dist/clients/node/index.mjs

@@ -1,8 +1,8 @@
 import { _ as __awaiter, a as __generator, f as nullthrows, c as createError, g as __extends, h as __assign } from '../../utils-DG1HA4RZ.mjs';
 import { INJECT_MESSAGE_TYPE, Nodebox, PREVIEW_LOADED_MESSAGE_TYPE } from '@codesandbox/nodebox';
-import '../../types-DR29do3R.mjs';
+import '../../types-BgalzxpH.mjs';
 import { S as SandpackClient } from '../../base-DBh7xJX9.mjs';
-import { c as consoleHook, g as generateRandomId, E as EventEmitter, a as getMessageFromError, f as findStartScriptPackageJson } from '../../consoleHook-vOAHXvaX.mjs';
+import { c as consoleHook, g as generateRandomId, E as EventEmitter, a as getMessageFromError, f as findStartScriptPackageJson } from '../../consoleHook-BYuGaxe8.mjs';
 import 'outvariant';
 import '@zenfs/core';
 import 'dequal';

package/dist/clients/runtime/index.js

@@ -2,7 +2,7 @@
 
 var utils = require('../../utils-BiVyytui.js');
 var dequal = require('dequal');
-var types = require('../../types-mAM6HBIz.js');
+var types = require('../../types-KEkDKvIe.js');
 var base = require('../../base-DelKLlDk.js');
 var iframeFactory = require('../../iframe-factory-Bc7tcyQZ.js');
 var mimeDB = require('mime-db');
@@ -530,7 +530,7 @@ function getExtension(filepath) {
 
 var _a;
 var SUFFIX_PLACEHOLDER = "-{{suffix}}";
-var BUNDLER_URL = "https://".concat((_a = "2.20.0") === null || _a === void 0 ? void 0 : _a.replace(/\./g, "-")).concat(SUFFIX_PLACEHOLDER, "-sandpack.codesandbox.io/");
+var BUNDLER_URL = "https://".concat((_a = "2.21.0") === null || _a === void 0 ? void 0 : _a.replace(/\./g, "-")).concat(SUFFIX_PLACEHOLDER, "-sandpack.codesandbox.io/");
 var SandpackRuntime = /** @class */ (function (_super) {
     utils.__extends(SandpackRuntime, _super);
     function SandpackRuntime(selector, sandboxSetup, options) {

package/dist/clients/runtime/index.mjs

@@ -1,6 +1,6 @@
 import { _ as __awaiter, a as __generator, h as __assign, i as __rest, j as __spreadArray, g as __extends, f as nullthrows, e as extractErrorDetails, c as createError, d as createPackageJSON } from '../../utils-DG1HA4RZ.mjs';
 import { dequal } from 'dequal';
-import { a as SandpackLogLevel } from '../../types-DR29do3R.mjs';
+import { a as SandpackLogLevel } from '../../types-BgalzxpH.mjs';
 import { S as SandpackClient } from '../../base-DBh7xJX9.mjs';
 import { c as createSandboxedIframe, e as ensureSandboxed } from '../../iframe-factory-C8M0b9uf.mjs';
 import mimeDB from 'mime-db';
@@ -528,7 +528,7 @@ function getExtension(filepath) {
 
 var _a;
 var SUFFIX_PLACEHOLDER = "-{{suffix}}";
-var BUNDLER_URL = "https://".concat((_a = "2.20.0") === null || _a === void 0 ? void 0 : _a.replace(/\./g, "-")).concat(SUFFIX_PLACEHOLDER, "-sandpack.codesandbox.io/");
+var BUNDLER_URL = "https://".concat((_a = "2.21.0") === null || _a === void 0 ? void 0 : _a.replace(/\./g, "-")).concat(SUFFIX_PLACEHOLDER, "-sandpack.codesandbox.io/");
 var SandpackRuntime = /** @class */ (function (_super) {
     __extends(SandpackRuntime, _super);
     function SandpackRuntime(selector, sandboxSetup, options) {

package/dist/{consoleHook-Dva85ENr.js → consoleHook-BRSVCdB0.js}

@@ -2,7 +2,7 @@
 
 var outvariant = require('outvariant');
 var utils = require('./utils-BiVyytui.js');
-require('./types-mAM6HBIz.js');
+require('./types-KEkDKvIe.js');
 
 var EventEmitter = /** @class */ (function () {
     function EventEmitter() {

package/dist/{consoleHook-vOAHXvaX.mjs → consoleHook-BYuGaxe8.mjs}

@@ -1,6 +1,6 @@
 import { invariant } from 'outvariant';
 import { c as createError } from './utils-DG1HA4RZ.mjs';
-import './types-DR29do3R.mjs';
+import './types-BgalzxpH.mjs';
 
 var EventEmitter = /** @class */ (function () {
     function EventEmitter() {

package/dist/fs/SandpackFS.d.ts

@@ -69,6 +69,10 @@ export declare class SandpackFS {
     private sidecarEnvironment;
     private sidecarMode;
     private disposed;
+    /** The ZenFS mount point this instance created and is therefore allowed to
+     *  unmount in {@link dispose}. Unset for an adopted context, whose lifecycle
+     *  belongs to the caller. */
+    private ownedMountPoint;
     private readonly rawWriteFile;
     private readonly rawUnlink;
     private readonly rawMkdir;
@@ -122,6 +126,16 @@ export declare class SandpackFS {
      * reflect it — distinct from local edits, which never reach here.
      */
     handleRemoteChange(path: string): void;
+    /**
+     * Tear this instance down: drop every subscriber, stop emitting changes, and
+     * release the ZenFS mount if we created it ({@link fromFiles}). An *adopted*
+     * context ({@link fromFileSystemContext}) is left mounted — its lifecycle
+     * belongs to the caller.
+     *
+     * ZenFS mounts live in a process-global table, so an instance that is never
+     * disposed keeps its backing store alive for the page's lifetime. Idempotent.
+     */
+    dispose(): void;
     private toAbs;
     private notify;
     private ensureMetaDir;

package/dist/{index-Bg_0g5j2.mjs → index-CetxPB1x.mjs}

@@ -1,10 +1,10 @@
 import { g as __extends, h as __assign, _ as __awaiter, a as __generator } from './utils-DG1HA4RZ.mjs';
 import { PreviewController } from 'static-browser-server';
-import { E as EventEmitter, g as generateRandomId, c as consoleHook } from './consoleHook-vOAHXvaX.mjs';
+import { E as EventEmitter, g as generateRandomId, c as consoleHook } from './consoleHook-BYuGaxe8.mjs';
 import { S as SandpackClient } from './base-DBh7xJX9.mjs';
 import { c as createSandboxedIframe, e as ensureSandboxed } from './iframe-factory-C8M0b9uf.mjs';
 import 'outvariant';
-import './types-DR29do3R.mjs';
+import './types-BgalzxpH.mjs';
 import '@zenfs/core';
 import 'dequal';
 

package/dist/{index-DWUK0Qhn.js → index-dX5nvjo5.js}

@@ -2,11 +2,11 @@
 
 var utils = require('./utils-BiVyytui.js');
 var staticBrowserServer = require('static-browser-server');
-var consoleHook = require('./consoleHook-Dva85ENr.js');
+var consoleHook = require('./consoleHook-BRSVCdB0.js');
 var base = require('./base-DelKLlDk.js');
 var iframeFactory = require('./iframe-factory-Bc7tcyQZ.js');
 require('outvariant');
-require('./types-mAM6HBIz.js');
+require('./types-KEkDKvIe.js');
 require('@zenfs/core');
 require('dequal');
 

package/dist/index.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var utils = require('./utils-BiVyytui.js');
-var types = require('./types-mAM6HBIz.js');
+var types = require('./types-KEkDKvIe.js');
 require('outvariant');
 require('@zenfs/core');
 
@@ -24,7 +24,7 @@ function loadSandpackClient(iframeSelector_1, sandboxSetup_1) {
                 case 2:
                     Client = _c.sent();
                     return [3 /*break*/, 7];
-                case 3: return [4 /*yield*/, Promise.resolve().then(function () { return require('./index-DWUK0Qhn.js'); }).then(function (m) { return m.SandpackStatic; })];
+                case 3: return [4 /*yield*/, Promise.resolve().then(function () { return require('./index-dX5nvjo5.js'); }).then(function (m) { return m.SandpackStatic; })];
                 case 4:
                     Client = _c.sent();
                     return [3 /*break*/, 7];

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { _ as __awaiter, a as __generator } from './utils-DG1HA4RZ.mjs';
 export { b as addPackageJSONIfNeededToMap, c as createError, d as createPackageJSON, e as extractErrorDetails, n as normalizePath, f as nullthrows } from './utils-DG1HA4RZ.mjs';
-export { M as META_PATH, S as SandpackFS, a as SandpackLogLevel } from './types-DR29do3R.mjs';
+export { M as META_PATH, S as SandpackFS, a as SandpackLogLevel } from './types-BgalzxpH.mjs';
 import 'outvariant';
 import '@zenfs/core';
 
@@ -23,7 +23,7 @@ function loadSandpackClient(iframeSelector_1, sandboxSetup_1) {
                 case 2:
                     Client = _c.sent();
                     return [3 /*break*/, 7];
-                case 3: return [4 /*yield*/, import('./index-Bg_0g5j2.mjs').then(function (m) { return m.SandpackStatic; })];
+                case 3: return [4 /*yield*/, import('./index-CetxPB1x.mjs').then(function (m) { return m.SandpackStatic; })];
                 case 4:
                     Client = _c.sent();
                     return [3 /*break*/, 7];

package/dist/{types-DR29do3R.mjs → types-BgalzxpH.mjs}

@@ -1,5 +1,5 @@
 import { _ as __awaiter, a as __generator, h as __assign } from './utils-DG1HA4RZ.mjs';
-import { mount, bindContext, resolveMountConfig, InMemory } from '@zenfs/core';
+import { umount, mount, bindContext, resolveMountConfig, InMemory } from '@zenfs/core';
 
 /**
  * Path (within the SandpackFS) of the sidecar metadata file. Anything below
@@ -113,6 +113,10 @@ var SandpackFS = /** @class */ (function () {
         this.sidecarEnvironment = undefined;
         this.sidecarMode = undefined;
         this.disposed = false;
+        /** The ZenFS mount point this instance created and is therefore allowed to
+         *  unmount in {@link dispose}. Unset for an adopted context, whose lifecycle
+         *  belongs to the caller. */
+        this.ownedMountPoint = undefined;
         var p = fsContext.fs.promises;
         this.rawWriteFile = p.writeFile.bind(p);
         this.rawUnlink = p.unlink.bind(p);
@@ -150,6 +154,9 @@ var SandpackFS = /** @class */ (function () {
                         mount(prefix, backend);
                         ctxt = bindContext({ root: prefix });
                         instance = new SandpackFS(ctxt, remotePortFactory, onWrite);
+                        // We created the mount, so we own it: `dispose()` may unmount it. An adopted
+                        // context (`fromFileSystemContext`) leaves this unset and is never unmounted.
+                        instance.ownedMountPoint = prefix;
                         if (options.environment !== undefined) {
                             instance.sidecarEnvironment = options.environment;
                         }
@@ -381,6 +388,30 @@ var SandpackFS = /** @class */ (function () {
             return;
         this.notify({ path: normalize(path), external: true });
     };
+    /**
+     * Tear this instance down: drop every subscriber, stop emitting changes, and
+     * release the ZenFS mount if we created it ({@link fromFiles}). An *adopted*
+     * context ({@link fromFileSystemContext}) is left mounted — its lifecycle
+     * belongs to the caller.
+     *
+     * ZenFS mounts live in a process-globalThis table, so an instance that is never
+     * disposed keeps its backing store alive for the page's lifetime. Idempotent.
+     */
+    SandpackFS.prototype.dispose = function () {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.listeners.clear();
+        if (this.ownedMountPoint) {
+            try {
+                umount(this.ownedMountPoint);
+            }
+            catch (_a) {
+                /* already unmounted — disposal must never throw */
+            }
+            this.ownedMountPoint = undefined;
+        }
+    };
     // ------------------------------------------------------------------
     // Internals
     // ------------------------------------------------------------------

package/dist/{types-mAM6HBIz.js → types-KEkDKvIe.js}

@@ -115,6 +115,10 @@ var SandpackFS = /** @class */ (function () {
         this.sidecarEnvironment = undefined;
         this.sidecarMode = undefined;
         this.disposed = false;
+        /** The ZenFS mount point this instance created and is therefore allowed to
+         *  unmount in {@link dispose}. Unset for an adopted context, whose lifecycle
+         *  belongs to the caller. */
+        this.ownedMountPoint = undefined;
         var p = fsContext.fs.promises;
         this.rawWriteFile = p.writeFile.bind(p);
         this.rawUnlink = p.unlink.bind(p);
@@ -152,6 +156,9 @@ var SandpackFS = /** @class */ (function () {
                         core.mount(prefix, backend);
                         ctxt = core.bindContext({ root: prefix });
                         instance = new SandpackFS(ctxt, remotePortFactory, onWrite);
+                        // We created the mount, so we own it: `dispose()` may unmount it. An adopted
+                        // context (`fromFileSystemContext`) leaves this unset and is never unmounted.
+                        instance.ownedMountPoint = prefix;
                         if (options.environment !== undefined) {
                             instance.sidecarEnvironment = options.environment;
                         }
@@ -383,6 +390,30 @@ var SandpackFS = /** @class */ (function () {
             return;
         this.notify({ path: normalize(path), external: true });
     };
+    /**
+     * Tear this instance down: drop every subscriber, stop emitting changes, and
+     * release the ZenFS mount if we created it ({@link fromFiles}). An *adopted*
+     * context ({@link fromFileSystemContext}) is left mounted — its lifecycle
+     * belongs to the caller.
+     *
+     * ZenFS mounts live in a process-globalThis table, so an instance that is never
+     * disposed keeps its backing store alive for the page's lifetime. Idempotent.
+     */
+    SandpackFS.prototype.dispose = function () {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.listeners.clear();
+        if (this.ownedMountPoint) {
+            try {
+                core.umount(this.ownedMountPoint);
+            }
+            catch (_a) {
+                /* already unmounted — disposal must never throw */
+            }
+            this.ownedMountPoint = undefined;
+        }
+    };
     // ------------------------------------------------------------------
     // Internals
     // ------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sandpack-client",
-  "version": "2.20.0",
+  "version": "2.21.0",
   "description": "",
   "keywords": [],
   "repository": {