typescript-virtual-container 1.4.3 → 1.4.4

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);

package/src/commands/sed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sed.d.ts","sourceRoot":"","sources":["sed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WA0DxB,CAAC"}

package/src/commands/seq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seq.d.ts","sourceRoot":"","sources":["seq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,0FAA0F;AAC1F,eAAO,MAAM,UAAU,EAAE,WAuCxB,CAAC"}

package/src/commands/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["set.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WAoBxB,CAAC"}

package/src/commands/sh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sh.d.ts","sourceRoot":"","sources":["sh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EACX,MAAM,mBAAmB,CAAC;AAwa3B,eAAO,MAAM,SAAS,EAAE,WAsCvB,CAAC"}

package/{dist → src}/commands/sh.js

@@ -1,4 +1,4 @@
-import { expandAsync } from "../utils/expand";
+import { evalArith, expandAsync, expandBraces } from "../utils/expand";
 import { ifFlag } from "./command-helpers";
 import { resolvePath } from "./helpers";
 import { runCommand } from "./runtime";
@@ -264,8 +264,7 @@ async function runBlocks(blocks, ctx) {
         }
         else if (block.type === "arith") {
             // (( expr )) — evaluate arithmetic, update vars
-            const { expandSync } = await import("../utils/expand");
-            const expr = expandSync(block.expr, ctx.env.vars, ctx.env.lastExitCode);
+            const expr = block.expr.trim();
             // Handle i++ / i-- / i+=N / i-=N
             const incMatch = expr.match(/^(\w+)\s*(\+\+|--)$/);
             if (incMatch) {
@@ -280,12 +279,17 @@ async function runBlocks(blocks, ctx) {
                     const ops = { "+": lhs + rhs, "-": lhs - rhs, "*": lhs * rhs, "/": Math.floor(lhs / rhs) };
                     ctx.env.vars[assignMatch[1]] = String(ops[assignMatch[2]] ?? lhs);
                 }
+                else {
+                    const value = evalArith(expr, ctx.env.vars);
+                    if (!Number.isNaN(value)) {
+                        ctx.env.lastExitCode = value === 0 ? 1 : 0;
+                    }
+                }
             }
         }
         else if (block.type === "for") {
             const listExpanded = await expandVars(block.list, ctx.env.vars, ctx.env.lastExitCode, ctx);
             // Apply brace expansion to each token in the list
-            const { expandBraces } = await import("../utils/expand");
             const items = listExpanded.trim().split(/\s+/).flatMap(expandBraces);
             for (const item of items) {
                 ctx.env.vars[block.var] = item;

package/src/commands/sh.ts

@@ -3,7 +3,7 @@ import type {
 	CommandResult,
 	ShellModule,
 } from "../types/commands";
-import { expandAsync } from "../utils/expand";
+import { evalArith, expandAsync, expandBraces } from "../utils/expand";
 import { ifFlag } from "./command-helpers";
 import { resolvePath } from "./helpers";
 import { runCommand } from "./runtime";
@@ -319,8 +319,7 @@ async function runBlocks(
 			ctx.env.vars[`__func_${block.name}`] = block.body.join("\n");
 		} else if (block.type === "arith") {
 			// (( expr )) — evaluate arithmetic, update vars
-			const { expandSync } = await import("../utils/expand");
-			const expr = expandSync(block.expr, ctx.env.vars, ctx.env.lastExitCode);
+			const expr = block.expr.trim();
 			// Handle i++ / i-- / i+=N / i-=N
 			const incMatch = expr.match(/^(\w+)\s*(\+\+|--)$/);
 			if (incMatch) {
@@ -333,6 +332,11 @@ async function runBlocks(
 					const rhs = parseInt(assignMatch[3]!, 10);
 					const ops: Record<string, number> = { "+": lhs + rhs, "-": lhs - rhs, "*": lhs * rhs, "/": Math.floor(lhs / rhs) };
 					ctx.env.vars[assignMatch[1]!] = String(ops[assignMatch[2]!] ?? lhs);
+				} else {
+					const value = evalArith(expr, ctx.env.vars);
+					if (!Number.isNaN(value)) {
+						ctx.env.lastExitCode = value === 0 ? 1 : 0;
+					}
 				}
 			}
 		} else if (block.type === "for") {
@@ -343,7 +347,6 @@ async function runBlocks(
 				ctx,
 			);
 			// Apply brace expansion to each token in the list
-			const { expandBraces } = await import("../utils/expand");
 			const items = listExpanded.trim().split(/\s+/).flatMap(expandBraces);
 			for (const item of items) {
 				ctx.env.vars[block.var] = item;

package/src/commands/shift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift.d.ts","sourceRoot":"","sources":["shift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAoB1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAezB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAW3B,CAAC"}

package/src/commands/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["sleep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAY1B,CAAC"}

package/src/commands/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAoCzB,CAAC"}

package/src/commands/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WA0C3B,CAAC"}

package/src/commands/stat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["stat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,WAqDzB,CAAC"}

package/src/commands/su.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"su.d.ts","sourceRoot":"","sources":["su.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,EAAE,WAuDvB,CAAC"}

package/src/commands/sudo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sudo.d.ts","sourceRoot":"","sources":["sudo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0BrD,eAAO,MAAM,WAAW,EAAE,WAiDzB,CAAC"}

package/src/commands/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["tail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA2CzB,CAAC"}

package/src/commands/tar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar.d.ts","sourceRoot":"","sources":["tar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WA6FxB,CAAC"}

package/src/commands/tee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tee.d.ts","sourceRoot":"","sources":["tee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WA0BxB,CAAC"}

package/src/commands/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0HrD,eAAO,MAAM,WAAW,EAAE,WAczB,CAAC"}

package/src/commands/test.ts

@@ -1,4 +1,6 @@
 import type { ShellModule } from "../types/commands";
+import type { VfsFileNode } from "../types/vfs";
+import type { VirtualShell } from "../VirtualShell";
 
 /**
  * Evaluate a POSIX test expression.
@@ -8,7 +10,7 @@ import type { ShellModule } from "../types/commands";
  */
 function evalTest(
 	tokens: string[],
-	shell: import("../VirtualShell").VirtualShell,
+	shell: VirtualShell,
 	cwd: string,
 ): boolean {
 	// When called via [ command, ] is the last arg — strip it
@@ -68,7 +70,7 @@ function evalTest(
 				return (
 					shell.vfs.exists(path) &&
 					shell.vfs.stat(path).type === "file" &&
-					(shell.vfs.stat(path) as import("../types/vfs").VfsFileNode).size > 0
+					(shell.vfs.stat(path) as VfsFileNode).size > 0
 				);
 			case "-z":
 				return operand.length === 0;

package/src/commands/touch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch.d.ts","sourceRoot":"","sources":["touch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAmB1B,CAAC"}

package/src/commands/tr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["tr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgCrD,eAAO,MAAM,SAAS,EAAE,WAqCvB,CAAC"}

package/src/commands/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAUzB,CAAC"}

package/src/commands/true.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"true.d.ts","sourceRoot":"","sources":["true.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAMzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAM1B,CAAC"}

package/src/commands/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAuCzB,CAAC"}

package/src/commands/uname.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uname.d.ts","sourceRoot":"","sources":["uname.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAoB1B,CAAC"}

package/src/commands/uniq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq.d.ts","sourceRoot":"","sources":["uniq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA8BzB,CAAC"}

package/src/commands/unset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset.d.ts","sourceRoot":"","sources":["unset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAS1B,CAAC"}

package/src/commands/uptime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptime.d.ts","sourceRoot":"","sources":["uptime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WA6C3B,CAAC"}

package/src/commands/wc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wc.d.ts","sourceRoot":"","sources":["wc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,WA6CvB,CAAC"}

package/{dist → src}/commands/wc.js

@@ -17,7 +17,7 @@ export const wcCommand = {
         const showAll = !lines && !words && !bytes;
         const positionals = args.filter((a) => !a.startsWith("-"));
         const count = (content, label) => {
-            const l = content.split("\n").length - (content.endsWith("\n") ? 1 : 0);
+            const l = content.length === 0 ? 0 : content.trim().split("\n").length;
             const w = content.trim().split(/\s+/).filter(Boolean).length;
             const c = Buffer.byteLength(content, "utf8");
             const parts = [];

package/src/commands/wc.ts

@@ -20,7 +20,7 @@ export const wcCommand: ShellModule = {
 		const positionals = args.filter((a) => !a.startsWith("-"));
 
 		const count = (content: string, label: string): string => {
-			const l = content.split("\n").length - (content.endsWith("\n") ? 1 : 0);
+			const l = content.length === 0 ? 0 : content.trim().split("\n").length;
 			const w = content.trim().split(/\s+/).filter(Boolean).length;
 			const c = Buffer.byteLength(content, "utf8");
 			const parts: string[] = [];

package/src/commands/wget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wget.d.ts","sourceRoot":"","sources":["wget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA0IzB,CAAC"}

package/src/commands/which.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.d.ts","sourceRoot":"","sources":["which.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,WAkC1B,CAAC"}

package/src/commands/who.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["who.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WAgBxB,CAAC"}

package/src/commands/whoami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["whoami.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAM3B,CAAC"}

package/src/commands/xargs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xargs.d.ts","sourceRoot":"","sources":["xargs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAsB1B,CAAC"}

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EACX,aAAa,EACb,aAAa,EACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,aAAa,EACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,YAAY,EACX,gBAAgB,EAAE,iBAAiB,EACnC,WAAW,EACX,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,UAAU,EAAE,aAAa,EACzB,UAAU,EACV,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,OAAO,EACP,YAAY,EACZ,eAAe,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,4BAA4B,CAAC"}

package/src/modules/linuxRootfs.d.ts

@@ -0,0 +1,59 @@
+/** biome-ignore-all lint/style/useNamingConvention: ENV VAR KEYS + system names */
+/**
+ * linuxRootfs.ts
+ *
+ * Bootstraps a realistic Linux directory hierarchy in the VFS.
+ * Called once during VirtualShell initialization. Idempotent — skips
+ * paths that already exist so FS-mode snapshots survive restarts.
+ *
+ * Public API:
+ *  - bootstrapLinuxRootfs()  one-shot boot (VirtualShell calls this)
+ *  - refreshProc()           refresh /proc/* (call on session changes)
+ *  - syncEtcPasswd()         sync /etc/passwd|group|shadow from UserManager
+ *  - createLinuxRootfsEngine() returns engine with .boot() + .tick() for
+ *                            runtimes that want a live refresh loop
+ */
+import type VirtualFileSystem from "../VirtualFileSystem";
+import type { ShellProperties } from "../VirtualShell";
+import type { VirtualActiveSession, VirtualUserManager } from "../VirtualUserManager";
+/**
+ * Sync `/etc/passwd`, `/etc/group`, and `/etc/shadow` from the
+ * VirtualUserManager's current user list into the VFS.
+ */
+export declare function syncEtcPasswd(vfs: VirtualFileSystem, users: VirtualUserManager): void;
+/**
+ * Populate and refresh `/proc` virtual entries based on host stats and
+ * provided active sessions. Rewrites uptime, meminfo, cpuinfo, loadavg,
+ * per-pid entries, and /proc/self.
+ *
+ * Safe to call repeatedly — acts as a live kernel state snapshot.
+ */
+export declare function refreshProc(vfs: VirtualFileSystem, props: ShellProperties, hostname: string, shellStartTime: number, sessions?: VirtualActiveSession[]): void;
+/**
+ * Bootstraps the full Linux rootfs hierarchy in the VFS.
+ * Safe to call multiple times — idempotent.
+ *
+ * @param vfs            Target virtual filesystem.
+ * @param users          User manager (for /etc/passwd sync).
+ * @param hostname       Virtual hostname.
+ * @param props          Shell properties (kernel, os, arch).
+ * @param shellStartTime Unix ms of shell creation (for uptime).
+ * @param sessions       Active sessions (for /proc/<pid> population).
+ */
+export declare function bootstrapLinuxRootfs(vfs: VirtualFileSystem, users: VirtualUserManager, hostname: string, props: ShellProperties, shellStartTime: number, sessions?: VirtualActiveSession[]): void;
+/**
+ * Engine for runtimes that want periodic /proc refresh (e.g. web shell
+ * with live `top`/`ps` output). Call `.boot()` once, then `.tick()` on
+ * each session change or on a timer.
+ *
+ * ```ts
+ * const engine = createLinuxRootfsEngine(vfs, props, hostname, Date.now());
+ * engine.boot(users, sessions);
+ * setInterval(() => engine.tick(shell.listActiveSessions()), 5000);
+ * ```
+ */
+export declare function createLinuxRootfsEngine(vfs: VirtualFileSystem, props: ShellProperties, hostname: string, startTime: number): {
+    boot(users: VirtualUserManager, sessions?: VirtualActiveSession[]): void;
+    tick(sessions?: VirtualActiveSession[]): void;
+};
+//# sourceMappingURL=linuxRootfs.d.ts.map

package/src/modules/linuxRootfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linuxRootfs.d.ts","sourceRoot":"","sources":["linuxRootfs.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAwLtF;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,GACvB,IAAI,CAsCN;AAoFD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,oBAAoB,EAAO,GACnC,IAAI,CAiLN;AAwPD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,oBAAoB,EAAO,GACnC,IAAI,CAaN;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM;gBAGJ,kBAAkB,aAAY,oBAAoB,EAAE;oBAGjD,oBAAoB,EAAE;EAItC"}