typescript-virtual-container 1.4.2 → 1.4.4

package/examples/web.min.js

@@ -1,13 +1,13 @@
-var k=Object.defineProperty;var O=(o,e,t)=>e in o?k(o,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):o[e]=t;var u=(o,e,t)=>O(o,typeof e!="symbol"?e+"":e,t);function x(o){let e=[],t="",r=!1,n="",s=0;for(;s<o.length;){let i=o[s],a=o[s+1];if((i==='"'||i==="'")&&!r){r=!0,n=i,s++;continue}if(r&&i===n){r=!1,n="",s++;continue}if(r){t+=i,s++;continue}if(i===" "){t&&(e.push(t),t=""),s++;continue}if((i===">"||i==="<")&&!r){t&&(e.push(t),t=""),i===">"&&a===">"?(e.push(">>"),s+=2):(e.push(i),s++);continue}t+=i,s++}return t&&e.push(t),e}function w(o){let e=o.trim();if(!e)return{statements:[],isValid:!0};try{return{statements:z(e),isValid:!0}}catch(t){return{statements:[],isValid:!1,error:t.message}}}function z(o){let e=A(o),t=[];for(let r of e){let s={pipeline:{commands:R(r.text.trim()),isValid:!0}};r.op&&(s.op=r.op),t.push(s)}return t}function A(o){let e=[],t="",r=0,n=!1,s="",i=0,a=c=>{t.trim()&&e.push({text:t,op:c}),t=""};for(;i<o.length;){let c=o[i],d=o.slice(i,i+2);if((c==='"'||c==="'")&&!n){n=!0,s=c,t+=c,i++;continue}if(n&&c===s){n=!1,t+=c,i++;continue}if(n){t+=c,i++;continue}if(c==="("){r++,t+=c,i++;continue}if(c===")"){r--,t+=c,i++;continue}if(r>0){t+=c,i++;continue}if(d==="&&"){a("&&"),i+=2;continue}if(d==="||"){a("||"),i+=2;continue}if(c===";"){a(";"),i++;continue}t+=c,i++}return a(),e}function R(o){return F(o).map(L)}function F(o){let e=[],t="",r=!1,n="";for(let i=0;i<o.length;i++){let a=o[i];if((a==='"'||a==="'")&&!r){r=!0,n=a,t+=a;continue}if(r&&a===n){r=!1,t+=a;continue}if(r){t+=a;continue}if(a==="|"&&o[i+1]!=="|"){if(!t.trim())throw new Error("Syntax error near unexpected token '|'");e.push(t.trim()),t=""}else t+=a}let s=t.trim();if(!s&&e.length>0)throw new Error("Syntax error near unexpected token '|'");return s&&e.push(s),e}function L(o){let e=x(o);if(e.length===0)return{name:"",args:[]};let t=[],r,n,s=!1,i=0;for(;i<e.length;){let c=e[i];if(c==="<"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after <");r=e[i],i++}else if(c===">>"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after >>");n=e[i],s=!0,i++}else if(c===">"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after >");n=e[i],s=!1,i++}else t.push(c),i++}return{name:(t[0]??"").toLowerCase(),args:t.slice(1),inputFile:r,outputFile:n,appendOutput:s}}function I(o,e){let t=o.replace(/\b([A-Za-z_][A-Za-z0-9_]*)\b/g,(r,n)=>{let s=e[n];return s!==void 0&&s!==""?s:"0"});if(!/^[\d\s+\-*/%()^!&|<>=,. ]+$/.test(t))return NaN;try{let r=Function(`"use strict"; return (${t.replace(/\*\*/g,"**")});`)();return typeof r=="number"?Math.trunc(r):NaN}catch{return NaN}}function M(o,e){let t=[],r=0;for(;r<o.length;){let n=o.indexOf("'",r);if(n===-1){t.push(e(o.slice(r)));break}t.push(e(o.slice(r,n)));let s=o.indexOf("'",n+1);if(s===-1){t.push(o.slice(n));break}t.push(o.slice(n,s+1)),r=s+1}return t.join("")}function p(o,e,t=0,r){let n=r??e.HOME??"/home/user";return M(o,s=>{let i=s;return i=i.replace(/(^|[\s:])~(\/|$)/g,(a,c,d)=>`${c}${n}${d}`),i=i.replace(/\$\?/g,String(t)),i=i.replace(/\$\$/g,"1"),i=i.replace(/\$#/g,"0"),i=i.replace(/\$\(\(([^)]+(?:\([^)]*\)[^)]*)*)\)\)/g,(a,c)=>{let d=I(c,e);return Number.isNaN(d)?"0":String(d)}),i=i.replace(/\$\{#([A-Za-z_][A-Za-z0-9_]*)\}/g,(a,c)=>String((e[c]??"").length)),i=i.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):-([^}]*)\}/g,(a,c,d)=>e[c]!==void 0&&e[c]!==""?e[c]:d),i=i.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):=([^}]*)\}/g,(a,c,d)=>((e[c]===void 0||e[c]==="")&&(e[c]=d),e[c])),i=i.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):\+([^}]*)\}/g,(a,c,d)=>e[c]!==void 0&&e[c]!==""?d:""),i=i.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g,(a,c)=>e[c]??""),i=i.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g,(a,c)=>e[c]??""),i})}async function C(o,e,t,r){if(o.includes("$(")){let n="",s=!1,i=0;for(;i<o.length;){let a=o[i];if(a==="'"&&!s){s=!0,n+=a,i++;continue}if(a==="'"&&s){s=!1,n+=a,i++;continue}if(!s&&a==="$"&&o[i+1]==="("){if(o[i+2]==="("){n+=a,i++;continue}let c=0,d=i+1;for(;d<o.length;){if(o[d]==="(")c++;else if(o[d]===")"&&(c--,c===0))break;d++}let g=o.slice(i+2,d).trim(),P=(await r(g)).replace(/\n$/,"");n+=P,i=d+1;continue}n+=a,i++}o=n}return p(o,e,t)}var _=new TextEncoder,B=new TextDecoder;function j(o){let e="";for(let t of o)e+=String.fromCharCode(t);return btoa(e)}function N(o){let e=atob(o),t=new Uint8Array(e.length);for(let r=0;r<e.length;r+=1)t[r]=e.charCodeAt(r);return t}function l(o,e="/"){let r=(o.startsWith("/")?o:`${e}/${o}`).split("/"),n=[];for(let s of r)if(!(!s||s===".")){if(s===".."){n.pop();continue}n.push(s)}return`/${n.join("/")}`||"/"}function h(o){let e=l(o);if(e==="/")return"/";let t=e.split("/").filter(Boolean);return t.pop(),t.length>0?`/${t.join("/")}`:"/"}function f(o){let e=l(o);return e==="/"?"/":e.split("/").filter(Boolean).at(-1)??"/"}function D(o){return o.type==="file"?{...o,contentBase64:o.contentBase64}:{...o,children:o.children.map(e=>D(e))}}function W(o,e){let t=new Date().toISOString();return{type:"directory",name:o,mode:e,createdAt:t,updatedAt:t,children:[]}}function T(o,e,t){let r=new Date().toISOString();return{type:"file",name:o,mode:t,createdAt:r,updatedAt:r,contentBase64:j(e)}}function b(o,e){return o.children.find(t=>t.name===e)}function m(o,e){let t=o.children.findIndex(r=>r.name===e.name);if(t===-1){o.children.push(e);return}o.children[t]=e}function S(o,e){o.children=o.children.filter(t=>t.name!==e)}function $(o){return l(o).split("/").filter(Boolean)}var V=globalThis;function E(o){return new Promise((e,t)=>{o.addEventListener("success",()=>e(o.result)),o.addEventListener("error",()=>t(o.error))})}var y=class{constructor(e={}){u(this,"databaseName");u(this,"storeName");u(this,"key");u(this,"root");this.databaseName=e.databaseName??"typescript-virtual-container-web",this.storeName=e.storeName??"snapshots",this.key=e.key??"current",this.root=W("",493)}async openDatabase(){return new Promise((e,t)=>{let r=V.indexedDB;if(!r){t(new Error("IndexedDB is not available in this environment"));return}let n=r.open(this.databaseName,1);n.addEventListener("upgradeneeded",()=>{let s=n.result;s.objectStoreNames.contains(this.storeName)||s.createObjectStore(this.storeName)}),n.addEventListener("success",()=>e(n.result)),n.addEventListener("error",()=>t(n.error))})}async readSnapshot(){let e=await this.openDatabase();try{let n=e.transaction(this.storeName,"readonly").objectStore(this.storeName).get(this.key),s=await E(n);return s?JSON.parse(s):null}finally{e.close()}}async writeSnapshot(e){let t=await this.openDatabase();try{let r=t.transaction(this.storeName,"readwrite"),n=r.objectStore(this.storeName);await E(n.put(JSON.stringify(e),this.key)),await new Promise((s,i)=>{r.addEventListener("complete",()=>s()),r.addEventListener("error",()=>i(r.error)),r.addEventListener("abort",()=>i(r.error))})}finally{t.close()}}serializeNode(e){return e.type==="file"?{...e}:{...e,children:e.children.map(t=>this.serializeNode(t))}}deserializeNode(e){return e.type==="file"?{...e}:{...e,children:e.children.map(t=>this.deserializeNode(t))}}getNode(e){let t=l(e);if(t==="/")return this.root;let r=$(t),n=this.root;for(let s of r){if(n.type!=="directory")throw new Error(`Not a directory: ${t}`);let i=b(n,s);if(!i)throw new Error(`No such file or directory: ${t}`);n=i}return n}ensureDirectory(e,t){let r=l(e);if(r==="/")return this.root;let n=$(r),s=this.root;for(let i of n){let a=b(s,i);if(!a){let c=W(i,t);m(s,c),s=c;continue}if(a.type!=="directory")throw new Error(`Cannot create directory '${r}': path is a file.`);s=a}return s}removeNode(e,t){let r=l(e);if(r==="/")throw new Error("Cannot remove root directory");let n=this.getNode(h(r));if(n.type!=="directory")throw new Error(`Not a directory: ${h(r)}`);let s=f(r),i=b(n,s);if(!i)throw new Error(`No such file or directory: ${r}`);if(i.type==="directory"&&i.children.length>0&&!t)throw new Error(`Cannot remove '${r}': directory not empty.`);S(n,s)}copyNode(e){return e.type==="file"?{...e,contentBase64:e.contentBase64}:{...e,children:e.children.map(t=>this.copyNode(t))}}async restoreMirror(){let e=await this.readSnapshot();e&&(this.root=this.deserializeNode(e.root))}async flushMirror(){await this.writeSnapshot({root:this.serializeNode(this.root)})}exists(e){try{return this.getNode(e),!0}catch{return!1}}list(e){let t=this.getNode(e);if(t.type!=="directory")throw new Error(`Not a directory: ${e}`);return t.children.map(r=>r.name).sort((r,n)=>r.localeCompare(n))}stat(e){let t=this.getNode(e);return t.type==="file"?{type:"file",mode:t.mode,size:N(t.contentBase64).byteLength,name:t.name}:{type:"directory",mode:t.mode,size:0,name:t.name}}readFile(e){let t=this.getNode(e);if(t.type!=="file")throw new Error(`Is a directory: ${e}`);return B.decode(N(t.contentBase64))}writeFile(e,t,r=420){let n=l(e),s=this.ensureDirectory(h(n),493),i=typeof t=="string"?_.encode(t):t,a=T(f(n),i,r);m(s,a)}mkdir(e,t=493){this.ensureDirectory(e,t)}touch(e){this.exists(e)||this.writeFile(e,"")}move(e,t){let r=this.getNode(e),n=this.getNode(h(e)),s=this.ensureDirectory(h(t),493);if(n.type!=="directory")throw new Error(`Not a directory: ${h(e)}`);S(n,f(e));let i=D(r);i.name=f(t),m(s,i)}copy(e,t){let r=this.getNode(e),n=this.ensureDirectory(h(t),493),s=this.copyNode(r);s.name=f(t),m(n,s)}remove(e,t={}){this.removeNode(e,t.recursive??!1)}exportSnapshot(){return{root:this.serializeNode(this.root)}}importSnapshot(e){this.root=this.deserializeNode(e.root)}},v=class{constructor(e,t={}){u(this,"hostname");u(this,"vfs");u(this,"env");u(this,"cwd");u(this,"commands",new Map);u(this,"initialized",!1);this.hostname=e,this.cwd=t.cwd??"/home/root",this.env={vars:{PATH:"/usr/bin:/bin",HOME:"/home/root",USER:"root",LOGNAME:"root",SHELL:"/bin/sh",HOSTNAME:e,PWD:this.cwd},lastExitCode:0},this.vfs=new y(t.vfs),this.registerBuiltins()}register(e){this.commands.set(e.name.toLowerCase(),e);for(let t of e.aliases??[])this.commands.set(t.toLowerCase(),e)}registerBuiltins(){this.register({name:"help",description:"List available web commands",params:[],run:()=>({stdout:`${this.listCommands().join(`
+var P=Object.defineProperty;var z=(o,e,t)=>e in o?P(o,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):o[e]=t;var u=(o,e,t)=>z(o,typeof e!="symbol"?e+"":e,t);function w(o){let e=[],t="",i=!1,s="",n=0;for(;n<o.length;){let r=o[n],a=o[n+1];if((r==='"'||r==="'")&&!i){i=!0,s=r,n++;continue}if(i&&r===s){i=!1,s="",n++;continue}if(i){t+=r,n++;continue}if(r===" "){t&&(e.push(t),t=""),n++;continue}if(!i&&r==="2"&&a===">"){let c=o.slice(n+1);if(c.startsWith(">>&1")||c.startsWith(">> &1")){t&&(e.push(t),t=""),e.push("2>>&1"),n+=5;continue}if(c.startsWith(">&1")){t&&(e.push(t),t=""),e.push("2>&1"),n+=4;continue}if(c.startsWith(">>")){t&&(e.push(t),t=""),e.push("2>>"),n+=3;continue}if(c.startsWith(">")){t&&(e.push(t),t=""),e.push("2>"),n+=2;continue}}if((r===">"||r==="<")&&!i){t&&(e.push(t),t=""),r===">"&&a===">"?(e.push(">>"),n+=2):(e.push(r),n++);continue}t+=r,n++}return t&&e.push(t),e}function C(o){let e=o.trim();if(!e)return{statements:[],isValid:!0};try{return{statements:O(e),isValid:!0}}catch(t){return{statements:[],isValid:!1,error:t.message}}}function O(o){let e=R(o),t=[];for(let i of e){let n={pipeline:{commands:F(i.text.trim()),isValid:!0}};i.op&&(n.op=i.op),t.push(n)}return t}function R(o){let e=[],t="",i=0,s=!1,n="",r=0,a=c=>{t.trim()&&e.push({text:t,op:c}),t=""};for(;r<o.length;){let c=o[r],d=o.slice(r,r+2);if((c==='"'||c==="'")&&!s){s=!0,n=c,t+=c,r++;continue}if(s&&c===n){s=!1,t+=c,r++;continue}if(s){t+=c,r++;continue}if(c==="("){i++,t+=c,r++;continue}if(c===")"){i--,t+=c,r++;continue}if(i>0){t+=c,r++;continue}if(d==="&&"){a("&&"),r+=2;continue}if(d==="||"){a("||"),r+=2;continue}if(c===";"){a(";"),r++;continue}t+=c,r++}return a(),e}function F(o){return k(o).map(L)}function k(o){let e=[],t="",i=!1,s="";for(let r=0;r<o.length;r++){let a=o[r];if((a==='"'||a==="'")&&!i){i=!0,s=a,t+=a;continue}if(i&&a===s){i=!1,t+=a;continue}if(i){t+=a;continue}if(a==="|"&&o[r+1]!=="|"){if(!t.trim())throw new Error("Syntax error near unexpected token '|'");e.push(t.trim()),t=""}else t+=a}let n=t.trim();if(!n&&e.length>0)throw new Error("Syntax error near unexpected token '|'");return n&&e.push(n),e}function L(o){let e=w(o);if(e.length===0)return{name:"",args:[]};let t=[],i,s,n=!1,r=0,a,c=!1,d=!1;for(;r<e.length;){let f=e[r];if(f==="<"){if(r++,r>=e.length)throw new Error("Syntax error: expected filename after <");i=e[r],r++}else if(f===">>"){if(r++,r>=e.length)throw new Error("Syntax error: expected filename after >>");s=e[r],n=!0,r++}else if(f===">"){if(r++,r>=e.length)throw new Error("Syntax error: expected filename after >");s=e[r],n=!1,r++}else if(f==="2>&1")d=!0,r++;else if(f==="2>>"){if(r++,r>=e.length)throw new Error("Syntax error: expected filename after 2>>");a=e[r],c=!0,r++}else if(f==="2>"){if(r++,r>=e.length)throw new Error("Syntax error: expected filename after 2>");a=e[r],c=!1,r++}else t.push(f),r++}return{name:(t[0]??"").toLowerCase(),args:t.slice(1),inputFile:i,outputFile:s,appendOutput:n,stderrFile:a,stderrAppend:c,stderrToStdout:d}}function I(o,e){let t=o.replace(/\b([A-Za-z_][A-Za-z0-9_]*)\b/g,(i,s)=>{let n=e[s];return n!==void 0&&n!==""?n:"0"});if(!/^[\d\s+\-*/%()^!&|<>=,. ]+$/.test(t))return NaN;try{let i=Function(`"use strict"; return (${t.replace(/\*\*/g,"**")});`)();return typeof i=="number"?Math.trunc(i):NaN}catch{return NaN}}function M(o,e){let t=[],i=0;for(;i<o.length;){let s=o.indexOf("'",i);if(s===-1){t.push(e(o.slice(i)));break}t.push(e(o.slice(i,s)));let n=o.indexOf("'",s+1);if(n===-1){t.push(o.slice(s));break}t.push(o.slice(s,n+1)),i=n+1}return t.join("")}function g(o,e,t=0,i){let s=i??e.HOME??"/home/user";return M(o,n=>{let r=n;return r=r.replace(/(^|[\s:])~(\/|$)/g,(a,c,d)=>`${c}${s}${d}`),r=r.replace(/\$\?/g,String(t)),r=r.replace(/\$\$/g,"1"),r=r.replace(/\$#/g,"0"),r=r.replace(/\$\(\(([^)]+(?:\([^)]*\)[^)]*)*)\)\)/g,(a,c)=>{let d=I(c,e);return Number.isNaN(d)?"0":String(d)}),r=r.replace(/\$\{#([A-Za-z_][A-Za-z0-9_]*)\}/g,(a,c)=>String((e[c]??"").length)),r=r.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):-([^}]*)\}/g,(a,c,d)=>e[c]!==void 0&&e[c]!==""?e[c]:d),r=r.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):=([^}]*)\}/g,(a,c,d)=>((e[c]===void 0||e[c]==="")&&(e[c]=d),e[c])),r=r.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):\+([^}]*)\}/g,(a,c,d)=>e[c]!==void 0&&e[c]!==""?d:""),r=r.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g,(a,c)=>e[c]??""),r=r.replace(/\$([A-Za-z_][A-Za-z0-9_]*|\d+)/g,(a,c)=>e[c]??""),r})}async function N(o,e,t,i){if(o.includes("$(")){let s="",n=!1,r=0;for(;r<o.length;){let a=o[r];if(a==="'"&&!n){n=!0,s+=a,r++;continue}if(a==="'"&&n){n=!1,s+=a,r++;continue}if(!n&&a==="$"&&o[r+1]==="("){if(o[r+2]==="("){s+=a,r++;continue}let c=0,d=r+1;for(;d<o.length;){if(o[d]==="(")c++;else if(o[d]===")"&&(c--,c===0))break;d++}let m=o.slice(r+2,d).trim(),f=(await i(m)).replace(/\n$/,"");s+=f,r=d+1;continue}s+=a,r++}o=s}return g(o,e,t)}var _=new TextEncoder,B=new TextDecoder;function T(o){let e="";for(let t of o)e+=String.fromCharCode(t);return btoa(e)}function W(o){let e=atob(o),t=new Uint8Array(e.length);for(let i=0;i<e.length;i+=1)t[i]=e.charCodeAt(i);return t}function l(o,e="/"){let i=(o.startsWith("/")?o:`${e}/${o}`).split("/"),s=[];for(let n of i)if(!(!n||n===".")){if(n===".."){s.pop();continue}s.push(n)}return`/${s.join("/")}`||"/"}function h(o){let e=l(o);if(e==="/")return"/";let t=e.split("/").filter(Boolean);return t.pop(),t.length>0?`/${t.join("/")}`:"/"}function p(o){let e=l(o);return e==="/"?"/":e.split("/").filter(Boolean).at(-1)??"/"}function A(o){return o.type==="file"?{...o,contentBase64:o.contentBase64}:{...o,children:o.children.map(e=>A(e))}}function S(o,e){let t=new Date().toISOString();return{type:"directory",name:o,mode:e,createdAt:t,updatedAt:t,children:[]}}function j(o,e,t){let i=new Date().toISOString();return{type:"file",name:o,mode:t,createdAt:i,updatedAt:i,contentBase64:T(e)}}function b(o,e){return o.children.find(t=>t.name===e)}function y(o,e){let t=o.children.findIndex(i=>i.name===e.name);if(t===-1){o.children.push(e);return}o.children[t]=e}function $(o,e){o.children=o.children.filter(t=>t.name!==e)}function E(o){return l(o).split("/").filter(Boolean)}var V=globalThis;function D(o){return new Promise((e,t)=>{o.addEventListener("success",()=>e(o.result)),o.addEventListener("error",()=>t(o.error))})}var x=class{constructor(e={}){u(this,"databaseName");u(this,"storeName");u(this,"key");u(this,"root");this.databaseName=e.databaseName??"typescript-virtual-container-web",this.storeName=e.storeName??"snapshots",this.key=e.key??"current",this.root=S("",493)}async openDatabase(){return new Promise((e,t)=>{let i=V.indexedDB;if(!i){t(new Error("IndexedDB is not available in this environment"));return}let s=i.open(this.databaseName,1);s.addEventListener("upgradeneeded",()=>{let n=s.result;n.objectStoreNames.contains(this.storeName)||n.createObjectStore(this.storeName)}),s.addEventListener("success",()=>e(s.result)),s.addEventListener("error",()=>t(s.error))})}async readSnapshot(){let e=await this.openDatabase();try{let s=e.transaction(this.storeName,"readonly").objectStore(this.storeName).get(this.key),n=await D(s);return n?JSON.parse(n):null}finally{e.close()}}async writeSnapshot(e){let t=await this.openDatabase();try{let i=t.transaction(this.storeName,"readwrite"),s=i.objectStore(this.storeName);await D(s.put(JSON.stringify(e),this.key)),await new Promise((n,r)=>{i.addEventListener("complete",()=>n()),i.addEventListener("error",()=>r(i.error)),i.addEventListener("abort",()=>r(i.error))})}finally{t.close()}}serializeNode(e){return e.type==="file"?{...e}:{...e,children:e.children.map(t=>this.serializeNode(t))}}deserializeNode(e){return e.type==="file"?{...e}:{...e,children:e.children.map(t=>this.deserializeNode(t))}}getNode(e){let t=l(e);if(t==="/")return this.root;let i=E(t),s=this.root;for(let n of i){if(s.type!=="directory")throw new Error(`Not a directory: ${t}`);let r=b(s,n);if(!r)throw new Error(`No such file or directory: ${t}`);s=r}return s}ensureDirectory(e,t){let i=l(e);if(i==="/")return this.root;let s=E(i),n=this.root;for(let r of s){let a=b(n,r);if(!a){let c=S(r,t);y(n,c),n=c;continue}if(a.type!=="directory")throw new Error(`Cannot create directory '${i}': path is a file.`);n=a}return n}removeNode(e,t){let i=l(e);if(i==="/")throw new Error("Cannot remove root directory");let s=this.getNode(h(i));if(s.type!=="directory")throw new Error(`Not a directory: ${h(i)}`);let n=p(i),r=b(s,n);if(!r)throw new Error(`No such file or directory: ${i}`);if(r.type==="directory"&&r.children.length>0&&!t)throw new Error(`Cannot remove '${i}': directory not empty.`);$(s,n)}copyNode(e){return e.type==="file"?{...e,contentBase64:e.contentBase64}:{...e,children:e.children.map(t=>this.copyNode(t))}}async restoreMirror(){let e=await this.readSnapshot();e&&(this.root=this.deserializeNode(e.root))}async flushMirror(){await this.writeSnapshot({root:this.serializeNode(this.root)})}exists(e){try{return this.getNode(e),!0}catch{return!1}}list(e){let t=this.getNode(e);if(t.type!=="directory")throw new Error(`Not a directory: ${e}`);return t.children.map(i=>i.name).sort((i,s)=>i.localeCompare(s))}stat(e){let t=this.getNode(e);return t.type==="file"?{type:"file",mode:t.mode,size:W(t.contentBase64).byteLength,name:t.name}:{type:"directory",mode:t.mode,size:0,name:t.name}}readFile(e){let t=this.getNode(e);if(t.type!=="file")throw new Error(`Is a directory: ${e}`);return B.decode(W(t.contentBase64))}writeFile(e,t,i=420){let s=l(e),n=this.ensureDirectory(h(s),493),r=typeof t=="string"?_.encode(t):t,a=j(p(s),r,i);y(n,a)}mkdir(e,t=493){this.ensureDirectory(e,t)}touch(e){this.exists(e)||this.writeFile(e,"")}move(e,t){let i=this.getNode(e),s=this.getNode(h(e)),n=this.ensureDirectory(h(t),493);if(s.type!=="directory")throw new Error(`Not a directory: ${h(e)}`);$(s,p(e));let r=A(i);r.name=p(t),y(n,r)}copy(e,t){let i=this.getNode(e),s=this.ensureDirectory(h(t),493),n=this.copyNode(i);n.name=p(t),y(s,n)}remove(e,t={}){this.removeNode(e,t.recursive??!1)}exportSnapshot(){return{root:this.serializeNode(this.root)}}importSnapshot(e){this.root=this.deserializeNode(e.root)}},v=class{constructor(e,t={}){u(this,"hostname");u(this,"vfs");u(this,"env");u(this,"cwd");u(this,"commands",new Map);u(this,"initialized",!1);this.hostname=e,this.cwd=t.cwd??"/home/root",this.env={vars:{PATH:"/usr/bin:/bin",HOME:"/home/root",USER:"root",LOGNAME:"root",SHELL:"/bin/sh",HOSTNAME:e,PWD:this.cwd},lastExitCode:0},this.vfs=new x(t.vfs),this.registerBuiltins()}register(e){this.commands.set(e.name.toLowerCase(),e);for(let t of e.aliases??[])this.commands.set(t.toLowerCase(),e)}registerBuiltins(){this.register({name:"help",description:"List available web commands",params:[],run:()=>({stdout:`${this.listCommands().join(`
 `)}
 `,exitCode:0})}),this.register({name:"pwd",description:"Print current directory",params:[],run:()=>({stdout:`${this.cwd}
-`,exitCode:0})}),this.register({name:"cd",description:"Change current directory",params:["[dir]"],run:({args:e})=>{let t=e[0]?l(e[0],this.cwd):"/home/root";return!this.vfs.exists(t)||this.vfs.stat(t).type!=="directory"?{stderr:`cd: no such file or directory: ${t}`,exitCode:1}:(this.cwd=t,this.env.vars.PWD=t,{exitCode:0,nextCwd:t})}}),this.register({name:"echo",description:"Display text",params:["[-n] [-e] [text...]"],run:({args:e,stdin:t})=>{let r=e.includes("-n"),n=e.filter(a=>a!=="-n"&&a!=="-e"&&a!=="-E"),s=n.length>0?n.join(" "):t??"",i=p(s,this.env.vars,this.env.lastExitCode,this.env.vars.HOME);return{stdout:r?i:`${i}
+`,exitCode:0})}),this.register({name:"cd",description:"Change current directory",params:["[dir]"],run:({args:e})=>{let t=e[0]?l(e[0],this.cwd):"/home/root";return!this.vfs.exists(t)||this.vfs.stat(t).type!=="directory"?{stderr:`cd: no such file or directory: ${t}`,exitCode:1}:(this.cwd=t,this.env.vars.PWD=t,{exitCode:0,nextCwd:t})}}),this.register({name:"echo",description:"Display text",params:["[-n] [-e] [text...]"],run:({args:e,stdin:t})=>{let i=e.includes("-n"),s=e.filter(a=>a!=="-n"&&a!=="-e"&&a!=="-E"),n=s.length>0?s.join(" "):t??"",r=g(n,this.env.vars,this.env.lastExitCode,this.env.vars.HOME);return{stdout:i?r:`${r}
 `,exitCode:0}}}),this.register({name:"env",description:"Print environment variables",params:[],run:()=>({stdout:`${Object.entries(this.env.vars).map(([e,t])=>`${e}=${t}`).join(`
 `)}
-`,exitCode:0})}),this.register({name:"export",description:"Set environment variables",params:["KEY=VALUE..."],run:({args:e})=>{for(let t of e){let r=t.indexOf("=");if(r===-1)continue;let n=t.slice(0,r).trim(),s=t.slice(r+1);n&&(this.env.vars[n]=s)}return{exitCode:0}}}),this.register({name:"unset",description:"Unset environment variables",params:["NAME..."],run:({args:e})=>{for(let t of e)delete this.env.vars[t];return{exitCode:0}}}),this.register({name:"mkdir",description:"Create directories",params:["[-p] dir..."],run:async({args:e})=>{let t=e.filter(r=>r!=="-p");for(let r of t)this.vfs.mkdir(l(r,this.cwd));return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"touch",description:"Create files",params:["file..."],run:async({args:e})=>{for(let t of e)this.vfs.touch(l(t,this.cwd));return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"rm",description:"Remove files or directories",params:["[-r] [-f] path..."],run:async({args:e})=>{let t=e.includes("-r"),r=e.filter(n=>n!=="-r"&&n!=="-f");for(let n of r)this.vfs.remove(l(n,this.cwd),{recursive:t});return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"cp",description:"Copy files or directories",params:["[-r] source destination"],run:async({args:e})=>{let t=e.includes("-r"),r=e.filter(s=>s!=="-r");if(r.length<2)return{stderr:"cp: missing destination file operand",exitCode:1};let n=l(r.at(-1),this.cwd);for(let s of r.slice(0,-1)){let i=l(s,this.cwd);if(!t&&this.vfs.stat(i).type==="directory")return{stderr:`cp: -r not specified; omitting directory '${i}'`,exitCode:1};this.vfs.copy(i,n)}return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"mv",description:"Move or rename files",params:["source destination"],run:async({args:e})=>{if(e.length<2)return{stderr:"mv: missing destination file operand",exitCode:1};let t=l(e[0],this.cwd),r=l(e[1],this.cwd);return this.vfs.move(t,r),await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"cat",description:"Concatenate files",params:["[file...]"],run:({args:e,stdin:t})=>{if(e.length===0)return{stdout:t??"",exitCode:0};let r="";for(let n of e)r+=this.vfs.readFile(l(n,this.cwd));return{stdout:r,exitCode:0}}}),this.register({name:"ls",description:"List files",params:["[path]"],run:({args:e})=>{let t=l(e[0]??".",this.cwd);return{stdout:`${this.vfs.list(t).join("  ")}
-`,exitCode:0}}}),this.register({name:"tee",description:"Read from stdin and write to files",params:["[-a] file..."],run:async({args:e,stdin:t})=>{let r=e.includes("-a"),n=e.filter(i=>i!=="-a"),s=t??"";for(let i of n){let a=l(i,this.cwd);if(r&&this.vfs.exists(a)){let c=this.vfs.readFile(a);this.vfs.writeFile(a,`${c}${s}`)}else this.vfs.writeFile(a,s)}return await this.vfs.flushMirror(),{stdout:s,exitCode:0}}}),this.register({name:"curl",description:"Fetch a URL and optionally write to a file",params:["[-o file] URL"],run:async({args:e})=>{let t=e.indexOf("-o"),r=t!==-1?e[t+1]:void 0,s=e.filter((c,d)=>c!=="-o"&&d!==t+1).at(-1);if(!s)return{stderr:"curl: missing URL",exitCode:2};let i=await fetch(s),a=await i.text();return r?(this.vfs.writeFile(l(r,this.cwd),a),await this.vfs.flushMirror(),{exitCode:i.ok?0:1}):{stdout:a,exitCode:i.ok?0:1}}}),this.register({name:"wget",description:"Fetch a URL and optionally write to a file",params:["[-O file] URL"],run:async({args:e})=>{let t=e.indexOf("-O"),r=t!==-1?e[t+1]:void 0,s=e.filter((d,g)=>d!=="-O"&&g!==t+1).at(-1);if(!s)return{stderr:"wget: missing URL",exitCode:2};let i=await fetch(s),a=await i.text(),c=r??f(new URL(s).pathname||"index.html");return this.vfs.writeFile(l(c,this.cwd),a),await this.vfs.flushMirror(),{exitCode:i.ok?0:1}}}),this.register({name:"true",description:"Return success",params:[],run:()=>({exitCode:0})}),this.register({name:"false",description:"Return failure",params:[],run:()=>({exitCode:1})})}listCommands(){let e=new Map;for(let t of this.commands.values())e.set(t.name,t);return Array.from(e.values()).sort((t,r)=>t.name.localeCompare(r.name)).map(t=>`${t.name}${t.params.length>0?` ${t.params.join(" ")}`:""}`)}resolveCommand(e){return this.commands.get(e.toLowerCase())}async ensureInitialized(){this.initialized||(await this.vfs.restoreMirror(),this.vfs.exists("/home")||this.vfs.mkdir("/home"),this.vfs.exists("/home/root")||(this.vfs.mkdir("/home/root"),this.vfs.writeFile("/home/root/README.txt",`Welcome to ${this.hostname}
+`,exitCode:0})}),this.register({name:"export",description:"Set environment variables",params:["KEY=VALUE..."],run:({args:e})=>{for(let t of e){let i=t.indexOf("=");if(i===-1)continue;let s=t.slice(0,i).trim(),n=t.slice(i+1);s&&(this.env.vars[s]=n)}return{exitCode:0}}}),this.register({name:"unset",description:"Unset environment variables",params:["NAME..."],run:({args:e})=>{for(let t of e)delete this.env.vars[t];return{exitCode:0}}}),this.register({name:"mkdir",description:"Create directories",params:["[-p] dir..."],run:async({args:e})=>{let t=e.filter(i=>i!=="-p");for(let i of t)this.vfs.mkdir(l(i,this.cwd));return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"touch",description:"Create files",params:["file..."],run:async({args:e})=>{for(let t of e)this.vfs.touch(l(t,this.cwd));return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"rm",description:"Remove files or directories",params:["[-r] [-f] path..."],run:async({args:e})=>{let t=e.includes("-r"),i=e.filter(s=>s!=="-r"&&s!=="-f");for(let s of i)this.vfs.remove(l(s,this.cwd),{recursive:t});return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"cp",description:"Copy files or directories",params:["[-r] source destination"],run:async({args:e})=>{let t=e.includes("-r"),i=e.filter(n=>n!=="-r");if(i.length<2)return{stderr:"cp: missing destination file operand",exitCode:1};let s=l(i.at(-1),this.cwd);for(let n of i.slice(0,-1)){let r=l(n,this.cwd);if(!t&&this.vfs.stat(r).type==="directory")return{stderr:`cp: -r not specified; omitting directory '${r}'`,exitCode:1};this.vfs.copy(r,s)}return await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"mv",description:"Move or rename files",params:["source destination"],run:async({args:e})=>{if(e.length<2)return{stderr:"mv: missing destination file operand",exitCode:1};let t=l(e[0],this.cwd),i=l(e[1],this.cwd);return this.vfs.move(t,i),await this.vfs.flushMirror(),{exitCode:0}}}),this.register({name:"cat",description:"Concatenate files",params:["[file...]"],run:({args:e,stdin:t})=>{if(e.length===0)return{stdout:t??"",exitCode:0};let i="";for(let s of e)i+=this.vfs.readFile(l(s,this.cwd));return{stdout:i,exitCode:0}}}),this.register({name:"ls",description:"List files",params:["[path]"],run:({args:e})=>{let t=l(e[0]??".",this.cwd);return{stdout:`${this.vfs.list(t).join("  ")}
+`,exitCode:0}}}),this.register({name:"tee",description:"Read from stdin and write to files",params:["[-a] file..."],run:async({args:e,stdin:t})=>{let i=e.includes("-a"),s=e.filter(r=>r!=="-a"),n=t??"";for(let r of s){let a=l(r,this.cwd);if(i&&this.vfs.exists(a)){let c=this.vfs.readFile(a);this.vfs.writeFile(a,`${c}${n}`)}else this.vfs.writeFile(a,n)}return await this.vfs.flushMirror(),{stdout:n,exitCode:0}}}),this.register({name:"curl",description:"Fetch a URL and optionally write to a file",params:["[-o file] URL"],run:async({args:e})=>{let t=e.indexOf("-o"),i=t!==-1?e[t+1]:void 0,n=e.filter((c,d)=>c!=="-o"&&d!==t+1).at(-1);if(!n)return{stderr:"curl: missing URL",exitCode:2};let r=await fetch(n),a=await r.text();return i?(this.vfs.writeFile(l(i,this.cwd),a),await this.vfs.flushMirror(),{exitCode:r.ok?0:1}):{stdout:a,exitCode:r.ok?0:1}}}),this.register({name:"wget",description:"Fetch a URL and optionally write to a file",params:["[-O file] URL"],run:async({args:e})=>{let t=e.indexOf("-O"),i=t!==-1?e[t+1]:void 0,n=e.filter((d,m)=>d!=="-O"&&m!==t+1).at(-1);if(!n)return{stderr:"wget: missing URL",exitCode:2};let r=await fetch(n),a=await r.text(),c=i??p(new URL(n).pathname||"index.html");return this.vfs.writeFile(l(c,this.cwd),a),await this.vfs.flushMirror(),{exitCode:r.ok?0:1}}}),this.register({name:"true",description:"Return success",params:[],run:()=>({exitCode:0})}),this.register({name:"false",description:"Return failure",params:[],run:()=>({exitCode:1})})}listCommands(){let e=new Map;for(let t of this.commands.values())e.set(t.name,t);return Array.from(e.values()).sort((t,i)=>t.name.localeCompare(i.name)).map(t=>`${t.name}${t.params.length>0?` ${t.params.join(" ")}`:""}`)}resolveCommand(e){return this.commands.get(e.toLowerCase())}async ensureInitialized(){this.initialized||(await this.vfs.restoreMirror(),this.vfs.exists("/home")||this.vfs.mkdir("/home"),this.vfs.exists("/home/root")||(this.vfs.mkdir("/home/root"),this.vfs.writeFile("/home/root/README.txt",`Welcome to ${this.hostname}
 `)),this.vfs.exists("/tmp")||this.vfs.mkdir("/tmp"),this.vfs.exists("/etc")||this.vfs.mkdir("/etc"),this.vfs.exists("/etc/hostname")||this.vfs.writeFile("/etc/hostname",`${this.hostname}
 `),this.vfs.exists("/etc/hosts")||this.vfs.writeFile("/etc/hosts",`127.0.0.1 localhost
 ::1 localhost
-`),this.initialized=!0)}getCurrentWorkingDirectory(){return this.cwd}async executeCommandLine(e,t=!0){await this.ensureInitialized();let r=e.trim();if(!r)return{exitCode:0};let n=await C(r,this.env.vars,this.env.lastExitCode,a=>this.executeCommandLine(a,!1).then(c=>c.stdout??"")),s=w(n),i=await this.executeStatements(s.statements);return this.env.lastExitCode=i.exitCode??0,t&&await this.vfs.flushMirror(),i}async executeStatements(e){let t={exitCode:0},r=0;for(;r<e.length;){let n=e[r];if(t=await this.executePipeline(n.pipeline.commands),this.env.lastExitCode=t.exitCode??0,t.closeSession||t.switchUser)return t;let s=n.op;if(!(!s||s===";")){if(s==="&&"){if((t.exitCode??0)!==0)for(;r<e.length&&e[r]?.op==="&&";)r+=1}else if(s==="||"&&(t.exitCode??0)===0)for(;r<e.length&&e[r]?.op==="||";)r+=1}r+=1}return t}async executePipeline(e){return e.length===0?{exitCode:0}:e.length===1?this.executeSingleCommandWithRedirections(e[0]):this.executePipelineChain(e)}async executeSingleCommandWithRedirections(e){let t;if(e.inputFile){let n=l(e.inputFile,this.cwd);try{t=this.vfs.readFile(n)}catch{return{stderr:`${e.inputFile}: No such file or directory`,exitCode:1}}}let r=await this.executeCommand(e.name,e.args,t);if(e.outputFile){let n=l(e.outputFile,this.cwd),s=r.stdout??"";if(e.appendOutput&&this.vfs.exists(n)){let i=this.vfs.readFile(n);this.vfs.writeFile(n,`${i}${s}`)}else this.vfs.writeFile(n,s);return{...r,stdout:""}}return r}async executePipelineChain(e){let t="",r=0;for(let n=0;n<e.length;n+=1){let s=e[n];if(n===0&&s.inputFile){let a=l(s.inputFile,this.cwd);try{t=this.vfs.readFile(a)}catch{return{stderr:`${s.inputFile}: No such file or directory`,exitCode:1}}}let i=await this.executeCommand(s.name,s.args,t);t=i.stdout??"",r=i.exitCode??0}return{stdout:t,exitCode:r}}async executeCommand(e,t,r){let n=this.resolveCommand(e);if(!n)return{stderr:`${e}: command not found`,exitCode:127};let i={args:t.map(a=>p(a,this.env.vars,this.env.lastExitCode,this.env.vars.HOME)),stdin:r,cwd:this.cwd,env:this.env,rawInput:`${e} ${t.join(" ")}`.trim(),shell:this};try{let a=await n.run(i);return a.nextCwd&&(this.cwd=a.nextCwd,this.env.vars.PWD=a.nextCwd),a}catch(a){return{stderr:a instanceof Error?a.message:String(a),exitCode:1}}}};function K(o="typescript-vm",e={}){return new v(o,e)}export{y as IndexedDbMirrorVfs,v as WebShell,K as createWebShell};
+`),this.initialized=!0)}getCurrentWorkingDirectory(){return this.cwd}async executeCommandLine(e,t=!0){await this.ensureInitialized();let i=e.trim();if(!i)return{exitCode:0};let s=await N(i,this.env.vars,this.env.lastExitCode,a=>this.executeCommandLine(a,!1).then(c=>c.stdout??"")),n=C(s),r=await this.executeStatements(n.statements);return this.env.lastExitCode=r.exitCode??0,t&&await this.vfs.flushMirror(),r}async executeStatements(e){let t={exitCode:0},i=0;for(;i<e.length;){let s=e[i];if(t=await this.executePipeline(s.pipeline.commands),this.env.lastExitCode=t.exitCode??0,t.closeSession||t.switchUser)return t;let n=s.op;if(!(!n||n===";")){if(n==="&&"){if((t.exitCode??0)!==0)for(;i<e.length&&e[i]?.op==="&&";)i+=1}else if(n==="||"&&(t.exitCode??0)===0)for(;i<e.length&&e[i]?.op==="||";)i+=1}i+=1}return t}async executePipeline(e){return e.length===0?{exitCode:0}:e.length===1?this.executeSingleCommandWithRedirections(e[0]):this.executePipelineChain(e)}async executeSingleCommandWithRedirections(e){let t;if(e.inputFile){let s=l(e.inputFile,this.cwd);try{t=this.vfs.readFile(s)}catch{return{stderr:`${e.inputFile}: No such file or directory`,exitCode:1}}}let i=await this.executeCommand(e.name,e.args,t);if(e.outputFile){let s=l(e.outputFile,this.cwd),n=i.stdout??"";if(e.appendOutput&&this.vfs.exists(s)){let r=this.vfs.readFile(s);this.vfs.writeFile(s,`${r}${n}`)}else this.vfs.writeFile(s,n);return{...i,stdout:""}}return i}async executePipelineChain(e){let t="",i=0;for(let s=0;s<e.length;s+=1){let n=e[s];if(s===0&&n.inputFile){let a=l(n.inputFile,this.cwd);try{t=this.vfs.readFile(a)}catch{return{stderr:`${n.inputFile}: No such file or directory`,exitCode:1}}}let r=await this.executeCommand(n.name,n.args,t);t=r.stdout??"",i=r.exitCode??0}return{stdout:t,exitCode:i}}async executeCommand(e,t,i){let s=this.resolveCommand(e);if(!s)return{stderr:`${e}: command not found`,exitCode:127};let r={args:t.map(a=>g(a,this.env.vars,this.env.lastExitCode,this.env.vars.HOME)),stdin:i,cwd:this.cwd,env:this.env,rawInput:`${e} ${t.join(" ")}`.trim(),shell:this};try{let a=await s.run(r);return a.nextCwd&&(this.cwd=a.nextCwd,this.env.vars.PWD=a.nextCwd),a}catch(a){return{stderr:a instanceof Error?a.message:String(a),exitCode:1}}}};function K(o="typescript-vm",e={}){return new v(o,e)}export{x as IndexedDbMirrorVfs,v as WebShell,K as createWebShell};
 //# sourceMappingURL=web.min.js.map

package/package.json

@@ -4,7 +4,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -24,8 +24,9 @@
     "check": "bunx --bun @biomejs/biome check ./src",
     "lint": "bunx --bun @biomejs/biome lint ./src",
     "lint:write": "bunx --bun @biomejs/biome lint --write ./src",
-    "test": "bunx --bun @biomejs/biome test ./src",
+    "test": "bun run test-salve",
     "test-battery": "bun test tests/",
+    "test-salve": "for f in tests/*.test.ts; do echo \"\\n🧪 Testing $f...\"; bun test \"$f\" --timeout 10000; sleep 0.25; done",
     "build": "tsc --project tsconfig.json",
     "deploy:npm": "npm publish --access public",
     "bench": "rm -rf .benchmark-shells/ && bun benchmark-virtualshell.ts",
@@ -43,7 +44,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.15",
     "@types/bun": "^1.3.13",
-    "@types/node": "^25.6.2",
+    "@types/node": "^25.7.0",
     "@types/ssh2": "^1.15.5",
     "typescript": "^6.0.3"
   },

package/src/Honeypot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;GAKG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,KAAK,CAaX;IAEF,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;gBACS,UAAU,GAAE,MAAc;IAKtC;;;;;;;;OAQG;IACI,MAAM,CACZ,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,EACzB,GAAG,CAAC,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,SAAS,GACd,IAAI;IAaP;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkChC;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyCvB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG;IAuBX;;;;;;OAMG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAQnE;;;;OAIG;IACI,QAAQ,IAAI,QAAQ,CAAC,aAAa,CAAC;IAK1C;;OAEG;IACI,KAAK,IAAI,IAAI;IAmBpB;;;;;OAKG;IACI,SAAS,CAAC,KAAK,GAAE,MAAY,GAAG,aAAa,EAAE;IAKtD;;;;OAIG;IACI,eAAe,IAAI,KAAK,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CAmDF;AAED,eAAe,QAAQ,CAAC"}

package/src/SSHClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAkBpD,qBAAa,SAAS;IAUpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAVjB,OAAO,CAAC,UAAU,CAAO;IAEzB;;;;;OAKG;gBAEM,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM;IAKzB;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BnD;;;;;OAKG;IACG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAM/C;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;IAKnC;;;;;OAKG;IACG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAS9C;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK/C;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAMpE;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKjD;;;;;;OAMG;IACG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAMjE;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBtE;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBpD;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAKhB;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAKrB;;;;;OAKG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMjD;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAKtC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAKxC;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;CAInC"}

package/src/SSHMimic/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AASpD,wBAAgB,OAAO,CACtB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,GACjB,IAAI,CAgCN"}

package/src/SSHMimic/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EACX,QAAQ,EAER,SAAS,EACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CAsDxB;AAID,wBAAsB,eAAe,CACpC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/src/SSHMimic/hostKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostKey.d.ts","sourceRoot":"","sources":["hostKey.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAAsB,GAAG,MAAM,CAgB3E"}

package/src/SSHMimic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+B/C,cAAM,QAAS,SAAQ,YAAY;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,CAAe;IAE5B,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAElE;;;;;;;;OAQG;gBACS,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAkC,EAClC,eAAmB,EACnB,iBAA0B,GAC1B,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,YAAY,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAYD,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;IAcrB;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IA0LrC;;OAEG;IACI,IAAI,IAAI,IAAI;IAUnB;;;OAGG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGrC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/src/SSHMimic/loginBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginBanner.d.ts","sourceRoot":"","sources":["loginBanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAChC,MAAM,CAuBR"}

package/src/SSHMimic/loginFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginFormat.d.ts","sourceRoot":"","sources":["loginFormat.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASlD"}

package/src/SSHMimic/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACb,MAAM,CASR"}

package/src/SSHMimic/sftp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sftp.d.ts","sourceRoot":"","sources":["sftp.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAI3C,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAmIhE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,qBAAa,SAAU,SAAQ,YAAY;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAiC;gBAEpC,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAK,EACL,GAAG,EACH,KAAK,GACL,EAAE,gBAAgB;IAwBnB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAIH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAwK9B,IAAI,IAAI,IAAI;IAUnB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;CA6a1B"}

package/src/VirtualFileSystem/binaryPack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaryPack.d.ts","sourceRoot":"","sources":["binaryPack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EACX,qBAAqB,EAGrB,MAAM,iBAAiB,CAAC;AA+EzB;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAM7D;AA0FD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/{dist → src}/VirtualFileSystem/index.d.ts

@@ -50,6 +50,10 @@ declare class VirtualFileSystem extends EventEmitter {
     private root;
     private readonly mode;
     private readonly snapshotFile;
+    /** Active host-directory mounts: vPath → { hostPath, readOnly } */
+    private readonly mounts;
+    /** True when running in a browser environment (no host FS access). */
+    private static readonly isBrowser;
     constructor(options?: VfsOptions);
     private makeDir;
     private makeFile;
@@ -75,6 +79,49 @@ declare class VirtualFileSystem extends EventEmitter {
     /** Returns the snapshot file path used in `"fs"` mode, or `null`. */
     getSnapshotPath(): string | null;
     /** Creates a directory (and any missing parents). */
+    /**
+     * Mount a host directory into the VFS at `vPath`.
+     *
+     * Files inside `vPath` are read directly from the host filesystem via
+     * `node:fs`. All standard VFS operations (`readFile`, `writeFile`,
+     * `exists`, `stat`, `list`) are transparently delegated.
+     *
+     * In browser environments the mount is silently ignored — `vPath` remains
+     * an empty in-memory directory.
+     *
+     * @param vPath     Absolute path inside the VM (e.g. `"/app"`).
+     * @param hostPath  Path on the host filesystem — relative paths are
+     *                  resolved from `process.cwd()`.
+     * @param readOnly  When `true` (default), write operations inside the
+     *                  mount throw `EROFS: read-only file system`.
+     *
+     * @example
+     * ```ts
+     * shell.vfs.mount("/app", "./src", { readOnly: true });
+     * // cat /app/index.ts  — reads ./src/index.ts from host
+     * ```
+     */
+    mount(vPath: string, hostPath: string, { readOnly }?: {
+        readOnly?: boolean;
+    }): void;
+    /**
+     * Unmount a previously mounted host directory.
+     * The in-memory VFS directory at `vPath` is preserved but the host
+     * delegation is removed.
+     */
+    unmount(vPath: string): void;
+    /** List all active mounts. */
+    getMounts(): Array<{
+        vPath: string;
+        hostPath: string;
+        readOnly: boolean;
+    }>;
+    /**
+     * If `targetPath` is inside a mount, return `{ hostPath, readOnly, relPath }`.
+     * `relPath` is the path relative to the mount's host directory.
+     * Returns `null` if the path is not under any mount.
+     */
+    private resolveMount;
     mkdir(targetPath: string, mode?: number): void;
     /**
      * Writes UTF-8 text or binary content into a file.

package/src/VirtualFileSystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/{dist → src}/VirtualFileSystem/index.js

@@ -32,6 +32,10 @@ class VirtualFileSystem extends EventEmitter {
     root;
     mode;
     snapshotFile;
+    /** Active host-directory mounts: vPath → { hostPath, readOnly } */
+    mounts = new Map();
+    /** True when running in a browser environment (no host FS access). */
+    static isBrowser = typeof process === "undefined" || typeof process.versions?.node === "undefined";
     constructor(options = {}) {
         super();
         this.mode = options.mode ?? "memory";
@@ -151,6 +155,80 @@ class VirtualFileSystem extends EventEmitter {
     }
     // ── Public filesystem API ─────────────────────────────────────────────────
     /** Creates a directory (and any missing parents). */
+    // ── Mount API ─────────────────────────────────────────────────────────────
+    /**
+     * Mount a host directory into the VFS at `vPath`.
+     *
+     * Files inside `vPath` are read directly from the host filesystem via
+     * `node:fs`. All standard VFS operations (`readFile`, `writeFile`,
+     * `exists`, `stat`, `list`) are transparently delegated.
+     *
+     * In browser environments the mount is silently ignored — `vPath` remains
+     * an empty in-memory directory.
+     *
+     * @param vPath     Absolute path inside the VM (e.g. `"/app"`).
+     * @param hostPath  Path on the host filesystem — relative paths are
+     *                  resolved from `process.cwd()`.
+     * @param readOnly  When `true` (default), write operations inside the
+     *                  mount throw `EROFS: read-only file system`.
+     *
+     * @example
+     * ```ts
+     * shell.vfs.mount("/app", "./src", { readOnly: true });
+     * // cat /app/index.ts  — reads ./src/index.ts from host
+     * ```
+     */
+    mount(vPath, hostPath, { readOnly = true } = {}) {
+        if (VirtualFileSystem.isBrowser)
+            return; // silently degrade in browser
+        const normalized = normalizePath(vPath);
+        const resolved = path.resolve(hostPath);
+        if (!fsSync.existsSync(resolved)) {
+            throw new Error(`VirtualFileSystem.mount: host path does not exist: "${resolved}"`);
+        }
+        if (!fsSync.statSync(resolved).isDirectory()) {
+            throw new Error(`VirtualFileSystem.mount: host path is not a directory: "${resolved}"`);
+        }
+        // Ensure the mount point exists in the VFS tree
+        this.mkdir(normalized);
+        this.mounts.set(normalized, { hostPath: resolved, readOnly });
+        this.emit("mount", { vPath: normalized, hostPath: resolved, readOnly });
+    }
+    /**
+     * Unmount a previously mounted host directory.
+     * The in-memory VFS directory at `vPath` is preserved but the host
+     * delegation is removed.
+     */
+    unmount(vPath) {
+        const normalized = normalizePath(vPath);
+        if (this.mounts.delete(normalized)) {
+            this.emit("unmount", { vPath: normalized });
+        }
+    }
+    /** List all active mounts. */
+    getMounts() {
+        return [...this.mounts.entries()].map(([vPath, opts]) => ({
+            vPath, ...opts,
+        }));
+    }
+    /**
+     * If `targetPath` is inside a mount, return `{ hostPath, readOnly, relPath }`.
+     * `relPath` is the path relative to the mount's host directory.
+     * Returns `null` if the path is not under any mount.
+     */
+    resolveMount(targetPath) {
+        const normalized = normalizePath(targetPath);
+        // Iterate mounts from most specific to least specific
+        const sorted = [...this.mounts.entries()].sort(([a], [b]) => b.length - a.length);
+        for (const [vBase, opts] of sorted) {
+            if (normalized === vBase || normalized.startsWith(`${vBase}/`)) {
+                const relPath = normalized.slice(vBase.length).replace(/^\//, "");
+                const fullHostPath = relPath ? path.join(opts.hostPath, relPath) : opts.hostPath;
+                return { hostPath: opts.hostPath, readOnly: opts.readOnly, relPath, fullHostPath };
+            }
+        }
+        return null;
+    }
     mkdir(targetPath, mode = 0o755) {
         const normalized = normalizePath(targetPath);
         const existing = (() => {
@@ -171,6 +249,17 @@ class VirtualFileSystem extends EventEmitter {
      * Parent directories are created when missing.
      */
     writeFile(targetPath, content, options = {}) {
+        // Delegate to host FS if inside a mount
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (m.readOnly)
+                throw new Error(`EROFS: read-only file system, open '${m.fullHostPath}'`);
+            const dir = path.dirname(m.fullHostPath);
+            if (!fsSync.existsSync(dir))
+                fsSync.mkdirSync(dir, { recursive: true });
+            fsSync.writeFileSync(m.fullHostPath, Buffer.isBuffer(content) ? content : Buffer.from(content, "utf8"));
+            return;
+        }
         const normalized = normalizePath(targetPath);
         const { parent, name } = getParentDirectory(this.root, normalized, true, (p) => this.mkdirRecursive(p, 0o755));
         const existing = parent.children.get(name);
@@ -200,6 +289,12 @@ class VirtualFileSystem extends EventEmitter {
      * Gzip-compressed files are transparently decompressed.
      */
     readFile(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: no such file or directory, open '${m.fullHostPath}'`);
+            return fsSync.readFileSync(m.fullHostPath, "utf8");
+        }
         const normalized = normalizePath(targetPath);
         const node = getNode(this.root, normalized);
         if (node.type !== "file") {
@@ -212,6 +307,12 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Reads file content as a Buffer (decompresses if needed). */
     readFileRaw(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: no such file or directory, open '${m.fullHostPath}'`);
+            return fsSync.readFileSync(m.fullHostPath);
+        }
         const normalized = normalizePath(targetPath);
         const node = getNode(this.root, normalized);
         if (node.type !== "file") {
@@ -224,6 +325,9 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Returns true when a file or directory exists at path. */
     exists(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m)
+            return fsSync.existsSync(m.fullHostPath);
         try {
             getNode(this.root, normalizePath(targetPath));
             return true;
@@ -238,6 +342,35 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Returns metadata for a file or directory. */
     stat(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: stat '${m.fullHostPath}'`);
+            const hst = fsSync.statSync(m.fullHostPath);
+            const name = m.relPath.split("/").pop() ?? m.fullHostPath.split("/").pop() ?? "";
+            const now = hst.mtime;
+            if (hst.isDirectory()) {
+                return {
+                    type: "directory",
+                    name,
+                    path: normalizePath(targetPath),
+                    mode: 0o755,
+                    createdAt: hst.birthtime,
+                    updatedAt: now,
+                    childrenCount: fsSync.readdirSync(m.fullHostPath).length,
+                };
+            }
+            return {
+                type: "file",
+                name,
+                path: normalizePath(targetPath),
+                mode: m.readOnly ? 0o444 : 0o644,
+                createdAt: hst.birthtime,
+                updatedAt: now,
+                compressed: false,
+                size: hst.size,
+            };
+        }
         const normalized = normalizePath(targetPath);
         const node = getNode(this.root, normalized);
         const name = normalized === "/" ? "" : path.posix.basename(normalized);
@@ -267,6 +400,17 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Lists direct children names of a directory (sorted). */
     list(dirPath = "/") {
+        const m = this.resolveMount(dirPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                return [];
+            try {
+                return fsSync.readdirSync(m.fullHostPath).sort();
+            }
+            catch {
+                return [];
+            }
+        }
         const normalized = normalizePath(dirPath);
         const node = getNode(this.root, normalized);
         if (node.type !== "directory") {
@@ -402,6 +546,21 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Removes a file or directory node. */
     remove(targetPath, options = {}) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (m.readOnly)
+                throw new Error(`EROFS: read-only file system, unlink '${m.fullHostPath}'`);
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: no such file or directory, unlink '${m.fullHostPath}'`);
+            const hst = fsSync.statSync(m.fullHostPath);
+            if (hst.isDirectory()) {
+                fsSync.rmSync(m.fullHostPath, { recursive: options.recursive ?? false });
+            }
+            else {
+                fsSync.unlinkSync(m.fullHostPath);
+            }
+            return;
+        }
         const normalized = normalizePath(targetPath);
         if (normalized === "/")
             throw new Error("Cannot remove root directory.");