typescript-virtual-container 1.4.3 → 1.4.5

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 R=Object.defineProperty;var F=(o,e,t)=>e in o?R(o,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):o[e]=t;var m=(o,e,t)=>F(o,typeof e!="symbol"?e+"":e,t);function S(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(!r&&i==="2"&&a===">"){let c=o.slice(s+1);if(c.startsWith(">>&1")||c.startsWith(">> &1")){t&&(e.push(t),t=""),e.push("2>>&1"),s+=5;continue}if(c.startsWith(">&1")){t&&(e.push(t),t=""),e.push("2>&1"),s+=4;continue}if(c.startsWith(">>")){t&&(e.push(t),t=""),e.push("2>>"),s+=3;continue}if(c.startsWith(">")){t&&(e.push(t),t=""),e.push("2>"),s+=2;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 $(o){let e=o.trim();if(!e)return{statements:[],isValid:!0};try{return{statements:L(e),isValid:!0}}catch(t){return{statements:[],isValid:!1,error:t.message}}}function L(o){let e=I(o),t=[];for(let r of e){let s={pipeline:{commands:M(r.text.trim()),isValid:!0}};r.op&&(s.op=r.op),t.push(s)}return t}function I(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 M(o){return B(o).map(_)}function B(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 _(o){let e=S(o);if(e.length===0)return{name:"",args:[]};let t=[],r,n,s=!1,i=0,a,c=!1,d=!1;for(;i<e.length;){let f=e[i];if(f==="<"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after <");r=e[i],i++}else if(f===">>"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after >>");n=e[i],s=!0,i++}else if(f===">"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after >");n=e[i],s=!1,i++}else if(f==="2>&1")d=!0,i++;else if(f==="2>>"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after 2>>");a=e[i],c=!0,i++}else if(f==="2>"){if(i++,i>=e.length)throw new Error("Syntax error: expected filename after 2>");a=e[i],c=!1,i++}else t.push(f),i++}let h=t[0]??"";return{name:/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/.test(h)?h:h.toLowerCase(),args:t.slice(1),inputFile:r,outputFile:n,appendOutput:s,stderrFile:a,stderrAppend:c,stderrToStdout:d}}function T(o,e){let t=[],r=0;for(;r<o.length;){let n=o[r];if(/\s/.test(n)){r++;continue}if(n==="+"){t.push({type:"plus"}),r++;continue}if(n==="-"){t.push({type:"minus"}),r++;continue}if(n==="*"){if(o[r+1]==="*"){t.push({type:"pow"}),r+=2;continue}t.push({type:"mul"}),r++;continue}if(n==="/"){t.push({type:"div"}),r++;continue}if(n==="%"){t.push({type:"mod"}),r++;continue}if(n==="("){t.push({type:"lparen"}),r++;continue}if(n===")"){t.push({type:"rparen"}),r++;continue}if(/\d/.test(n)){let s=r+1;for(;s<o.length&&/\d/.test(o[s]);)s++;t.push({type:"number",value:Number(o.slice(r,s))}),r=s;continue}if(/[A-Za-z_]/.test(n)){let s=r+1;for(;s<o.length&&/[A-Za-z0-9_]/.test(o[s]);)s++;let i=o.slice(r,s),a=e[i],c=a===void 0||a===""?0:Number(a);t.push({type:"number",value:Number.isFinite(c)?c:0}),r=s;continue}return[]}return t}function j(o,e){let t=o.trim();if(t.length===0||t.length>1024)return NaN;let r=T(t,e);if(r.length===0)return NaN;let n=0,s=()=>r[n],i=()=>r[n++],a=()=>{let l=i();if(!l)return NaN;if(l.type==="number")return l.value;if(l.type==="lparen"){let p=g();return r[n]?.type!=="rparen"?NaN:(n++,p)}return NaN},c=()=>{let l=s();return l?.type==="plus"?(i(),c()):l?.type==="minus"?(i(),-c()):a()},d=()=>{let l=c();for(;s()?.type==="pow";){i();let p=c();l=l**p}return l},h=()=>{let l=d();for(;;){let p=s();if(p?.type==="mul"){i(),l*=d();continue}if(p?.type==="div"){i();let x=d();l=x===0?NaN:l/x;continue}if(p?.type==="mod"){i();let x=d();l=x===0?NaN:l%x;continue}return l}},g=()=>{let l=h();for(;;){let p=s();if(p?.type==="plus"){i(),l+=h();continue}if(p?.type==="minus"){i(),l-=h();continue}return l}},f=g();return!Number.isFinite(f)||n!==r.length?NaN:Math.trunc(f)}function V(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 U(o,e){let t="",r=0;for(;r<o.length;){if(o[r]==="$"&&o[r+1]==="("&&o[r+2]==="("){let n=r+3,s=0;for(;n<o.length;){let i=o[n];if(i==="(")s++;else if(i===")"){if(s>0)s--;else if(o[n+1]===")"){let a=o.slice(r+3,n),c=j(a,e);t+=Number.isNaN(c)?"0":String(c),r=n+2;break}}n++}if(n>=o.length){t+=o.slice(r);break}continue}t+=o[r],r++}return t}function w(o,e,t=0,r){let n=r??e.HOME??"/home/user";return V(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=U(i,e),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_]*|\d+)/g,(a,c)=>e[c]??""),i})}async function E(o,e,t,r){let n="__shellExpandDepth",i=Number(e[n]??"0");if(i>=8)return w(o,e,t);e[n]=String(i+1);try{if(o.includes("$(")){let a="",c=!1,d=0;for(;d<o.length;){let h=o[d];if(h==="'"&&!c){c=!0,a+=h,d++;continue}if(h==="'"&&c){c=!1,a+=h,d++;continue}if(!c&&h==="$"&&o[d+1]==="("){if(o[d+2]==="("){a+=h,d++;continue}let g=0,f=d+1;for(;f<o.length;){if(o[f]==="(")g++;else if(o[f]===")"&&(g--,g===0))break;f++}let l=o.slice(d+2,f).trim(),p=(await r(l)).replace(/\n$/,"");a+=p,d=f+1;continue}a+=h,d++}o=a}return w(o,e,t)}finally{i<=0?delete e[n]:e[n]=String(i)}}var Z=new TextEncoder,q=new TextDecoder;function H(o){let e="";for(let t of o)e+=String.fromCharCode(t);return btoa(e)}function D(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 u(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 y(o){let e=u(o);if(e==="/")return"/";let t=e.split("/").filter(Boolean);return t.pop(),t.length>0?`/${t.join("/")}`:"/"}function b(o){let e=u(o);return e==="/"?"/":e.split("/").filter(Boolean).at(-1)??"/"}function O(o){return o.type==="file"?{...o,contentBase64:o.contentBase64}:{...o,children:o.children.map(e=>O(e))}}function k(o,e){let t=new Date().toISOString();return{type:"directory",name:o,mode:e,createdAt:t,updatedAt:t,children:[]}}function Q(o,e,t){let r=new Date().toISOString();return{type:"file",name:o,mode:t,createdAt:r,updatedAt:r,contentBase64:H(e)}}function C(o,e){return o.children.find(t=>t.name===e)}function v(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 A(o,e){o.children=o.children.filter(t=>t.name!==e)}function z(o){return u(o).split("/").filter(Boolean)}var G=globalThis;function P(o){return new Promise((e,t)=>{o.addEventListener("success",()=>e(o.result)),o.addEventListener("error",()=>t(o.error))})}var N=class{constructor(e={}){m(this,"databaseName");m(this,"storeName");m(this,"key");m(this,"root");this.databaseName=e.databaseName??"typescript-virtual-container-web",this.storeName=e.storeName??"snapshots",this.key=e.key??"current",this.root=k("",493)}async openDatabase(){return new Promise((e,t)=>{let r=G.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 P(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 P(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=u(e);if(t==="/")return this.root;let r=z(t),n=this.root;for(let s of r){if(n.type!=="directory")throw new Error(`Not a directory: ${t}`);let i=C(n,s);if(!i)throw new Error(`No such file or directory: ${t}`);n=i}return n}ensureDirectory(e,t){let r=u(e);if(r==="/")return this.root;let n=z(r),s=this.root;for(let i of n){let a=C(s,i);if(!a){let c=k(i,t);v(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=u(e);if(r==="/")throw new Error("Cannot remove root directory");let n=this.getNode(y(r));if(n.type!=="directory")throw new Error(`Not a directory: ${y(r)}`);let s=b(r),i=C(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.`);A(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:D(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 q.decode(D(t.contentBase64))}writeFile(e,t,r=420){let n=u(e),s=this.ensureDirectory(y(n),493),i=typeof t=="string"?Z.encode(t):t,a=Q(b(n),i,r);v(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(y(e)),s=this.ensureDirectory(y(t),493);if(n.type!=="directory")throw new Error(`Not a directory: ${y(e)}`);A(n,b(e));let i=O(r);i.name=b(t),v(s,i)}copy(e,t){let r=this.getNode(e),n=this.ensureDirectory(y(t),493),s=this.copyNode(r);s.name=b(t),v(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)}},W=class{constructor(e,t={}){m(this,"hostname");m(this,"vfs");m(this,"env");m(this,"cwd");m(this,"commands",new Map);m(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 N(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]?u(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=w(s,this.env.vars,this.env.lastExitCode,this.env.vars.HOME);return{stdout:r?i:`${i}
 `,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 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(u(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(u(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(u(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=u(r.at(-1),this.cwd);for(let s of r.slice(0,-1)){let i=u(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=u(e[0],this.cwd),r=u(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(u(n,this.cwd));return{stdout:r,exitCode:0}}}),this.register({name:"ls",description:"List files",params:["[path]"],run:({args:e})=>{let t=u(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=u(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(u(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,h)=>d!=="-O"&&h!==t+1).at(-1);if(!s)return{stderr:"wget: missing URL",exitCode:2};let i=await fetch(s),a=await i.text(),c=r??b(new URL(s).pathname||"index.html");return this.vfs.writeFile(u(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}
 `)),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 r=e.trim();if(!r)return{exitCode:0};let n=await E(r,this.env.vars,this.env.lastExitCode,a=>this.executeCommandLine(a,!1).then(c=>c.stdout??"")),s=$(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=u(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=u(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=u(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=>w(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 ie(o="typescript-vm",e={}){return new W(o,e)}export{N as IndexedDbMirrorVfs,W as WebShell,ie 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.3",
+  "version": "1.4.5",
   "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",
@@ -38,13 +39,15 @@
     "publish-package": "bash ./scripts/publish-package.sh",
     "self-standalone-build": "bunx esbuild src/self-standalone.ts --bundle --platform=node --format=esm --target=node18 --outfile=builds/self-standalone.js --tree-shaking=true --minify --sourcemap --banner:js='#!/usr/bin/env node'",
     "standalone-build": "bunx esbuild src/standalone.ts --bundle --platform=node --target=node18 --outfile=builds/standalone.js --tree-shaking=true --minify --sourcemap",
-    "build-all": "bun run self-standalone-build && bun run standalone-build && bun run standalone-build:wo-sftp && bun run web-build && bun run web-full-build && bun run example-build"
+    "build-all": "bun run self-standalone-build && bun run standalone-build && bun run standalone-build:wo-sftp && bun run web-build && bun run web-full-build && bun run example-build",
+    "publish-doc": "npx typedoc && npx gh-pages -d docs"
   },
   "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",
+    "gh-pages": "^6.3.0",
     "typescript": "^6.0.3"
   },
   "peerDependencies": {

package/src/VirtualFileSystem/index.ts

@@ -2,15 +2,10 @@ import { EventEmitter } from "node:events";
 import * as fsSync from "node:fs";
 import * as path from "node:path";
 import { gunzipSync, gzipSync } from "node:zlib";
-import type {
-	InternalDirectoryNode,
-	InternalFileNode,
-	InternalNode,
-} from "./internalTypes";
-import { decodeVfs, encodeVfs, isBinarySnapshot } from "./binaryPack";
-import { getNode, getParentDirectory, normalizePath } from "./path";
 import type {
 	RemoveOptions,
+	VfsDirectoryNode,
+	VfsFileNode,
 	VfsNodeStats,
 	VfsSnapshot,
 	VfsSnapshotDirectoryNode,
@@ -18,6 +13,13 @@ import type {
 	VfsSnapshotNode,
 	WriteFileOptions,
 } from "../types/vfs";
+import { decodeVfs, encodeVfs, isBinarySnapshot } from "./binaryPack";
+import type {
+	InternalDirectoryNode,
+	InternalFileNode,
+	InternalNode,
+} from "./internalTypes";
+import { getNode, getParentDirectory, normalizePath } from "./path";
 
 // ── Persistence options ───────────────────────────────────────────────────────
 
@@ -460,7 +462,7 @@ class VirtualFileSystem extends EventEmitter {
 					createdAt: hst.birthtime,
 					updatedAt: now,
 					childrenCount: fsSync.readdirSync(m.fullHostPath).length,
-				} satisfies import("../types/vfs").VfsDirectoryNode;
+				} satisfies VfsDirectoryNode;
 			}
 			return {
 				type: "file",
@@ -471,7 +473,7 @@ class VirtualFileSystem extends EventEmitter {
 				updatedAt: now,
 				compressed: false,
 				size: hst.size,
-			} satisfies import("../types/vfs").VfsFileNode;
+			} satisfies VfsFileNode;
 		}
 		const normalized = normalizePath(targetPath);
 		const node = getNode(this.root, normalized);

package/src/VirtualShell/shellParser.ts

@@ -1,9 +1,9 @@
 import type {
+	LogicalOp,
 	Pipeline,
 	PipelineCommand,
 	Script,
 	Statement,
-	LogicalOp,
 } from "../types/pipeline";
 import { tokenizeCommand } from "../utils/tokenize";
 
@@ -274,7 +274,8 @@ function parseCommandWithRedirections(token: string): PipelineCommand {
 		}
 	}
 
-	const name = (cmdParts[0] ?? "").toLowerCase();
+	const rawName = cmdParts[0] ?? "";
+	const name = /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/.test(rawName) ? rawName : rawName.toLowerCase();
 	return {
 		name, args: cmdParts.slice(1),
 		inputFile, outputFile, appendOutput,

package/src/bun.d.ts

@@ -0,0 +1 @@
+/// <reference types="@types/bun" />

package/src/commands/awk.ts

@@ -1,6 +1,6 @@
 import type { ShellModule } from "../types/commands";
 import { getFlag } from "./command-helpers";
-import { resolvePath, assertPathAccess } from "./helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
 
 /**
  * Minimal awk-like pattern scanner.
@@ -92,7 +92,6 @@ export const awkCommand: ShellModule = {
 				// Arithmetic NR+1, NF-1
 				const arith = expr.replace(/\bNR\b/g, String(nr)).replace(/\bNF\b/g, String(nf));
 				if (/^[\d\s+\-*/()]+$/.test(arith)) {
-					// biome-ignore lint/security/noGlobalEval: safe arithmetic — input contains only digits and operators after variable substitution
 					try { return String(Function(`"use strict"; return (${arith});`)()); } catch {}  				}
 				return expr.replace(/"/g, "");
 			};

package/src/commands/cd.ts

@@ -11,8 +11,8 @@ export const cdCommand: ShellModule = {
 	description: "Change directory",
 	category: "navigation",
 	params: ["[path]"],
-	run: ({ authUser, shell, cwd, args, mode }) => {
-		const target = resolvePath(cwd, args[0] ?? "/virtual-env-js");
+	run: ({ authUser, shell, cwd, args }) => {
+		const target = resolvePath(cwd, args[0] ?? `~`);
 		assertPathAccess(authUser, target, "cd");
 		const stats = shell.vfs.stat(target);
 		if (stats.type !== "directory") {

package/src/commands/helpers.ts

@@ -32,6 +32,9 @@ export function resolvePath(cwd: string, inputPath: string): string {
 	if (!inputPath || inputPath.trim() === "") {
 		return cwd;
 	}
+	if (inputPath.startsWith("~")) {
+		return path.posix.normalize(`/home/${inputPath.slice(1)}`);
+	}
 	return inputPath.startsWith("/")
 		? path.posix.normalize(inputPath)
 		: path.posix.normalize(path.posix.join(cwd, inputPath));

package/src/commands/ls.ts

@@ -1,74 +1,243 @@
 import type { ShellModule } from "../types/commands";
 import { getArg, ifFlag } from "./command-helpers";
-import { assertPathAccess, joinListWithType, resolvePath } from "./helpers";
-
-function formatPermissions(mode: number, isDirectory: boolean): string {
-	const fileType = isDirectory ? "d" : "-";
-	const permissionBits = [
-		[0o400, "r"],
-		[0o200, "w"],
-		[0o100, "x"],
-		[0o040, "r"],
-		[0o020, "w"],
-		[0o010, "x"],
-		[0o004, "r"],
-		[0o002, "w"],
-		[0o001, "x"],
-	] as const;
-	const permissions = permissionBits
-		.map(([bit, symbol]) => (mode & bit ? symbol : "-"))
-		.join("");
-
-	return `${fileType}${permissions}`;
+import { assertPathAccess, resolvePath } from "./helpers";
+
+// ─── ANSI color codes (matches GNU ls --color=auto / LS_COLORS defaults) ────
+
+const RESET  = "\x1b[0m";
+
+// Entry-type colors
+const C_DIR     = "\x1b[1;34m";   // bold blue         — directory
+const C_LINK    = "\x1b[1;36m";   // bold cyan         — symlink
+const C_EXEC    = "\x1b[1;32m";   // bold green        — executable file
+const C_NORMAL  = "";              // no color          — regular file
+
+// Special-mode backgrounds (GNU ls corner cases)
+const C_STICKY_WX = "\x1b[30;42m"; // black on green — dir sticky + world-writable (/tmp)
+const C_STICKY    = "\x1b[37;44m"; // white on blue  — dir sticky, NOT world-writable
+const C_OTHER_WX  = "\x1b[34;42m"; // blue on green  — dir world-writable, not sticky
+
+// ─── helpers ────────────────────────────────────────────────────────────────
+
+function colorize(name: string, color: string): string {
+	return color ? `${color}${name}${RESET}` : name;
 }
 
+function entryColor(mode: number, type: "file" | "directory", isLink: boolean): string {
+	if (isLink) return C_LINK;
+	if (type === "directory") {
+		const sticky  = !!(mode & 0o1000);
+		const worldW  = !!(mode & 0o002);
+		if (sticky && worldW) return C_STICKY_WX;
+		if (sticky)           return C_STICKY;
+		if (worldW)           return C_OTHER_WX;
+		return C_DIR;
+	}
+	if (mode & 0o111) return C_EXEC;
+	return C_NORMAL;
+}
+
+// ─── permissions string ──────────────────────────────────────────────────────
+
+function formatPermissions(mode: number, type: "file" | "directory", isLink: boolean): string {
+	let ft: string;
+	if (isLink)                    ft = "l";
+	else if (type === "directory") ft = "d";
+	else                           ft = "-";
+
+	const r = (bit: number) => (mode & bit ? "r" : "-");
+	const w = (bit: number) => (mode & bit ? "w" : "-");
+
+	const xOwner = (() => {
+		const exec = !!(mode & 0o100);
+		if (mode & 0o4000) return exec ? "s" : "S";
+		return exec ? "x" : "-";
+	})();
+	const xGroup = (() => {
+		const exec = !!(mode & 0o010);
+		if (mode & 0o2000) return exec ? "s" : "S";
+		return exec ? "x" : "-";
+	})();
+	const xOther = (() => {
+		const exec = !!(mode & 0o001);
+		if (type === "directory" && (mode & 0o1000)) return exec ? "t" : "T";
+		return exec ? "x" : "-";
+	})();
+
+	return `${ft}${r(0o400)}${w(0o200)}${xOwner}${r(0o040)}${w(0o020)}${xGroup}${r(0o004)}${w(0o002)}${xOther}`;
+}
+
+// ─── date formatting (GNU ls + French locale) ────────────────────────────────
+
+const MONTHS_EN = [
+	"Jan", "Feb", "Mar", "Apr", "May", "Jun",
+	"Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
+];
+
 function formatDate(date: Date): string {
-	return date.toISOString().replace("T", " ").slice(0, 16);
+	const now    = new Date();
+	const sixMo  = 6 * 30 * 24 * 3600 * 1000;
+	const recent = Math.abs(now.getTime() - date.getTime()) < sixMo;
+	const day    = String(date.getDate()).padStart(2, " ");
+	const month  = MONTHS_EN[date.getMonth()] ?? "";
+	if (recent) {
+		const hh = String(date.getHours()).padStart(2, "0");
+		const mm = String(date.getMinutes()).padStart(2, "0");
+		return `${day} ${month.padEnd(3)} ${hh}:${mm}`;
+	}
+	return `${day} ${month.padEnd(3)} ${date.getFullYear()}`;
+}
+
+// ─── symlink target ──────────────────────────────────────────────────────────
+
+function readlinkTarget(vfs: { readFile: (p: string) => string }, path: string): string {
+	try { return vfs.readFile(path); } catch { return "?"; }
+}
+
+// ─── short listing ───────────────────────────────────────────────────────────
+
+function shortListing(
+	vfs: {
+		stat:      (p: string) => { mode: number; type: "file" | "directory" };
+		isSymlink: (p: string) => boolean;
+	},
+	dir: string,
+	items: string[],
+): string {
+	const base = dir === "/" ? "" : dir;
+	return items.map((name) => {
+		const childPath = `${base}/${name}`;
+		const isLink    = vfs.isSymlink(childPath);
+		let stat: { mode: number; type: "file" | "directory" };
+		try { stat = vfs.stat(childPath); } catch { return name; }
+		const color  = entryColor(stat.mode, stat.type, isLink);
+		return colorize(name, color);
+	}).join("  ");
 }
 
+// ─── long listing ────────────────────────────────────────────────────────────
+
+type VfsStat = {
+	mode:          number;
+	type:          "file" | "directory";
+	updatedAt:     Date;
+	size?:         number;
+	childrenCount?: number;
+};
+
+function longListing(
+	vfs: {
+		stat:      (p: string) => VfsStat;
+		isSymlink: (p: string) => boolean;
+		readFile:  (p: string) => string;
+	},
+	dir: string,
+	items: string[],
+): string {
+	const base = dir === "/" ? "" : dir;
+
+	type Row = { perms: string; nlink: string; size: string; date: string; label: string };
+
+	const rows: Row[] = items.map((name) => {
+		const childPath = `${base}/${name}`;
+		const isLink    = vfs.isSymlink(childPath);
+		let stat: VfsStat;
+		try { stat = vfs.stat(childPath); } catch {
+			return {
+				perms: "----------", nlink: "1", size: "0",
+				date: formatDate(new Date()), label: name,
+			};
+		}
+
+		const mode  = isLink ? 0o120777 : stat.mode;
+		const perms = formatPermissions(mode, stat.type, isLink);
+
+		// nlink: dirs = children + 2 (. and ..), files/links = 1
+		const nlink = stat.type === "directory"
+			? String((stat.childrenCount ?? 0) + 2)
+			: "1";
+
+		// size: links → target path length, files → bytes, dirs → children×4096
+		const rawSize = isLink
+			? readlinkTarget(vfs, childPath).length
+			: stat.type === "file"
+				? (stat.size ?? 0)
+				: (stat.childrenCount ?? 0) * 4096;
+		const size = String(rawSize);
+
+		const date  = formatDate(stat.updatedAt);
+		const color = entryColor(mode, stat.type, isLink);
+
+		const label = isLink
+			? `${colorize(name, color)} -> ${readlinkTarget(vfs, childPath)}`
+			: colorize(name, color);
+
+		return { perms, nlink, size, date, label };
+	});
+
+	const wNlink = Math.max(...rows.map((r) => r.nlink.length));
+	const wSize  = Math.max(...rows.map((r) => r.size.length));
+	const owner  = "root";
+	const group  = "root";
+
+	const total  = items.length * 8;
+	const lines  = rows.map((r) =>
+		`${r.perms} ${r.nlink.padStart(wNlink)} ${owner} ${group} ${r.size.padStart(wSize)} ${r.date} ${r.label}`,
+	);
+
+	return `total ${total}\n${lines.join("\n")}`;
+}
+
+// ─── command ─────────────────────────────────────────────────────────────────
+
 export const lsCommand: ShellModule = {
 	name: "ls",
 	description: "List directory contents",
 	category: "navigation",
 	params: ["[-la] [path]"],
 	run: ({ authUser, shell, cwd, args }) => {
-		const longFormat = ifFlag(args, ["-l", "--long"]);
-		const showHidden = ifFlag(args, ["-a", "--all"]);
+		const longFormat = ifFlag(args, ["-l", "--long", "-la", "-al"]);
+		const showHidden = ifFlag(args, ["-a", "--all",  "-la", "-al"]);
+
 		const targetArg = getArg(args, 0, {
 			flags: ["-l", "--long", "-a", "--all", "-la", "-al"],
 		});
 		const target = resolvePath(cwd, targetArg ?? cwd);
 		assertPathAccess(authUser, target, "ls");
 
-		// If target is a file, show its info directly (ls -l /etc/passwd)
+		// Single file or symlink
 		if (shell.vfs.exists(target)) {
-			const st = shell.vfs.stat(target);
-			if (st.type === "file" || shell.vfs.isSymlink(target)) {
+			const st     = shell.vfs.stat(target);
+			const isLink = shell.vfs.isSymlink(target);
+			if (st.type === "file" || isLink) {
+				const name  = target.split("/").pop() ?? target;
+				const color = entryColor(isLink ? 0o120777 : st.mode, st.type, isLink);
 				if (longFormat) {
-					const name = target.split("/").pop() ?? target;
-					const size = st.type === "file" ? st.size : 0;
+					const mode  = isLink ? 0o120777 : st.mode;
+					const size  = isLink
+						? readlinkTarget(shell.vfs, target).length
+						: (st as { size?: number }).size ?? 0;
+					const perms = formatPermissions(mode, st.type, isLink);
+					const label = isLink
+						? `${colorize(name, color)} -> ${readlinkTarget(shell.vfs, target)}`
+						: colorize(name, color);
 					return {
-						stdout: `${formatPermissions(st.mode, false)} 1 root root ${size} ${formatDate(st.updatedAt)} ${name}\n`,
+						stdout: `${perms} 1 root root ${size} ${formatDate(st.updatedAt)} ${label}\n`,
 						exitCode: 0,
 					};
 				}
-				return { stdout: target.split("/").pop() ?? target, exitCode: 0 };
+				return { stdout: `${colorize(name, color)}\n`, exitCode: 0 };
 			}
 		}
 
 		const items = shell.vfs
 			.list(target)
 			.filter((name) => showHidden || !name.startsWith("."));
+
 		const rendered = longFormat
-			? items
-					.map((name) => {
-						const childPath = resolvePath(target, name);
-						const stat = shell.vfs.stat(childPath);
-						const size = stat.type === "file" ? stat.size : stat.childrenCount;
-						return `${formatPermissions(stat.mode, stat.type === "directory")} 1 ${size} ${formatDate(stat.updatedAt)} ${name}${stat.type === "directory" ? "/" : ""}`;
-					})
-					.join("\n")
-			: joinListWithType(target, items, (p) => shell.vfs.stat(p));
-		return { stdout: rendered, exitCode: 0 };
+			? longListing(shell.vfs, target, items)
+			: shortListing(shell.vfs, target, items);
+
+		return { stdout: `${rendered}\n`, exitCode: 0 };
 	},
-};
+};

package/src/commands/runtime.ts

@@ -3,9 +3,9 @@ import { executeStatements } from "../SSHMimic/executor";
 import type { VirtualShell } from "../VirtualShell";
 import { parseScript } from "../VirtualShell/shellParser";
 import type {
-    CommandMode,
-    CommandResult,
-    ShellEnv,
+	CommandMode,
+	CommandResult,
+	ShellEnv,
 } from "../types/commands";
 import { expandAsync, expandBraces } from "../utils/expand";
 import { tokenizeCommand } from "../utils/tokenize";
@@ -77,6 +77,44 @@ export async function runCommandDirect(
 	stdin: string | undefined,
 	env: ShellEnv,
 ): Promise<CommandResult> {
+	const assignRe = /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/;
+	const invocation = [name, ...args];
+	let assignCount = 0;
+	while (assignCount < invocation.length && assignRe.test(invocation[assignCount]!)) {
+		assignCount += 1;
+	}
+	if (assignCount > 0) {
+		const assignments = invocation.slice(0, assignCount).map((token) => token.match(assignRe)!);
+		const remaining = invocation.slice(assignCount);
+		const restored: Array<[string, string | undefined]> = [];
+		for (const [, key, value] of assignments) {
+			restored.push([key!, env.vars[key!]]);
+			env.vars[key!] = value!;
+		}
+		if (remaining.length === 0) {
+			return { exitCode: 0 };
+		}
+		try {
+			const result = await runCommandDirect(
+				remaining[0]!,
+				remaining.slice(1),
+				authUser,
+				hostname,
+				mode,
+				cwd,
+				shell,
+				stdin,
+				env,
+			);
+			return result;
+		} finally {
+			for (const [key, value] of restored) {
+				if (value === undefined) delete env.vars[key];
+				else env.vars[key] = value;
+			}
+		}
+	}
+
 	const aliasVal = env.vars[`__alias_${name}`];
 	if (aliasVal) {
 		return runCommand(
@@ -250,6 +288,21 @@ export async function runCommand(
 	);
 
 	const parts = tokenizeCommand(expanded.trim());
+	if (parts.length === 0) return { exitCode: 0 };
+	const assignRe = /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/;
+	if (assignRe.test(parts[0]!)) {
+		return runCommandDirect(
+			parts[0]!,
+			parts.slice(1),
+			authUser,
+			hostname,
+			mode,
+			cwd,
+			shell,
+			stdin,
+			shellEnv,
+		);
+	}
 	const commandName = parts[0]?.toLowerCase() ?? "";
 	// Apply brace expansion to each arg token
 	const args = parts.slice(1).flatMap(expandBraces);