typescript-virtual-container 1.6.0 → 1.6.2

package/dist/commands/last.js

@@ -43,7 +43,7 @@ export const dmesgCommand = {
         const n = args.includes("-n") ? parseInt(args[args.indexOf("-n") + 1] ?? "20", 10) : 20;
         const msgs = [
             "[    0.000000] Booting Linux on physical CPU 0x0",
-            "[    0.000000] Linux version 6.1.0-fortune (gcc version 12.2.0)",
+            "[    0.000000] Linux version 6.1.0-fortune (gcc (Fortune 13.3.0-nyx1) 13.3.0)",
             "[    0.000000] Command line: BOOT_IMAGE=/vmlinuz-6.1.0 root=/dev/sda1 ro quiet",
             "[    0.000000] BIOS-provided physical RAM map:",
             "[    0.000000] ACPI: IRQ0 used by override.",

package/dist/commands/manuals-bundle.js

@@ -429,7 +429,7 @@ OPTIONS
     "dpkg": `DPKG(1)                  User Commands                    DPKG(1)
 
 NAME
-       dpkg - package manager for Debian-like systems
+       dpkg - package manager for Fortune GNU/Linux
 
 SYNOPSIS
        dpkg [OPTION]... ACTION

package/dist/commands/miscutils.js

@@ -23,7 +23,7 @@ export const realpathCommand = {
         const resolved = shell.vfs.isSymlink(p)
             ? shell.vfs.resolveSymlink(p)
             : p;
-        return { stdout: path.posix.normalize(resolved) + "\n", exitCode: 0 };
+        return { stdout: `${path.posix.normalize(resolved)}\n`, exitCode: 0 };
     },
 };
 /**
@@ -106,7 +106,7 @@ export const stringsCommand = {
         }
         if (current.length >= 4)
             results.push(current);
-        return { stdout: results.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${results.join("\n")}\n`, exitCode: 0 };
     },
 };
 /**
@@ -228,6 +228,6 @@ export const fmtCommand = {
         }
         if (current)
             lines.push(current);
-        return { stdout: lines.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${lines.join("\n")}\n`, exitCode: 0 };
     },
 };

package/dist/commands/mousepad.d.ts

@@ -0,0 +1,2 @@
+import type { ShellModule } from "../types/commands";
+export declare const mousepadCommand: ShellModule;

package/dist/commands/mousepad.js

@@ -0,0 +1,21 @@
+export const mousepadCommand = {
+    name: "mousepad",
+    aliases: ["gedit", "xed"],
+    params: ["[file]"],
+    description: "Open a text file in the desktop text editor",
+    category: "desktop",
+    run(ctx) {
+        const dm = ctx.shell.desktopManager;
+        if (!dm) {
+            return { stderr: "mousepad: desktop is only available in the browser", exitCode: 1 };
+        }
+        if (!dm.isActive()) {
+            return { stderr: "mousepad: no desktop session running (start with startxfce4)", exitCode: 1 };
+        }
+        const path = ctx.args[0]
+            ? ctx.args[0].startsWith("/") ? ctx.args[0] : `${ctx.cwd}/${ctx.args[0]}`
+            : "/root/untitled.txt";
+        dm.createEditorWindow(path);
+        return { exitCode: 0 };
+    },
+};

package/dist/commands/netcat.js

@@ -42,7 +42,7 @@ export const ncCommand = {
         const nonFlag = args.filter((a) => !a.startsWith("-"));
         const host = nonFlag[0];
         const portNum = nonFlag[1] ? parseInt(nonFlag[1], 10) : NaN;
-        if (host && !isNaN(portNum)) {
+        if (host && !Number.isNaN(portNum)) {
             return new Promise((resolve) => {
                 const socket = net.createConnection({ host, port: portNum }, () => {
                     if (verbose) {

package/dist/commands/procUtils.js

@@ -27,7 +27,7 @@ export const pgrepCommand = {
             }
             if (results.length === 0)
                 return { exitCode: 1 };
-            return { stdout: results.join("\n") + "\n", exitCode: 0 };
+            return { stdout: `${results.join("\n")}\n`, exitCode: 0 };
         }
         catch {
             return { stderr: "pgrep: invalid pattern\n", exitCode: 2 };

package/dist/commands/registry.js

@@ -109,6 +109,9 @@ import { pgrepCommand, pkillCommand } from "./procUtils";
 import { lscpuCommand, lsusbCommand, lspciCommand } from "./sysinfo";
 import { joinCommand, commCommand, splitCommand, csplitCommand } from "./textutils";
 import { topCommand } from "./top";
+import { startxfce4Command } from "./startxfce4";
+import { thunarCommand } from "./xfceDesktop";
+import { mousepadCommand } from "./mousepad";
 const BASE_COMMANDS = [
     // Navigation
     pwdCommand,
@@ -258,6 +261,10 @@ const BASE_COMMANDS = [
     nodeCommand,
     python3Command,
     exprCommand,
+    // Desktop
+    startxfce4Command,
+    thunarCommand,
+    mousepadCommand,
     // System (extended)
     uptimeCommand,
     freeCommand,

package/dist/commands/startxfce4.d.ts

@@ -0,0 +1,2 @@
+import type { ShellModule } from "../types/commands";
+export declare const startxfce4Command: ShellModule;

package/dist/commands/startxfce4.js

@@ -0,0 +1,13 @@
+export const startxfce4Command = {
+    name: "startxfce4",
+    aliases: ["xfce4-session"],
+    params: [],
+    async run(ctx) {
+        const dm = ctx.shell.desktopManager;
+        if (!dm) {
+            return { stderr: "startxfce4: desktop is only available in the browser", exitCode: 1 };
+        }
+        await dm.start();
+        return { exitCode: 0 };
+    },
+};

package/dist/commands/sysinfo.js

@@ -27,7 +27,7 @@ export const lscpuCommand = {
             `Socket(s):           1`,
             `Vendor ID:           GenuineIntel`,
         ];
-        return { stdout: lines.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${lines.join("\n")}\n`, exitCode: 0 };
     },
 };
 /**
@@ -46,7 +46,7 @@ export const lsusbCommand = {
             "Bus 001 Device 002: ID 80ee:0021 VirtualBox USB Tablet",
             "Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub",
         ];
-        return { stdout: devices.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${devices.join("\n")}\n`, exitCode: 0 };
     },
 };
 /**
@@ -68,6 +68,6 @@ export const lspciCommand = {
             "00:03.0 Ethernet controller: Intel Corporation 82540EM Gigabit Ethernet Controller",
             "00:04.0 SATA controller: Intel Corporation 82801IR/IO (ICH9R) SATA Controller",
         ];
-        return { stdout: devices.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${devices.join("\n")}\n`, exitCode: 0 };
     },
 };

package/dist/commands/textutils.js

@@ -49,7 +49,7 @@ export const joinCommand = {
                 results.push(`${match} ${line}`);
             }
         }
-        return { stdout: results.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${results.join("\n")}\n`, exitCode: 0 };
     },
 };
 /**
@@ -105,7 +105,7 @@ export const commCommand = {
             const col3 = i < both.length ? both[i] : "";
             results.push(`${col1}\t${col2}\t${col3}`);
         }
-        return { stdout: results.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${results.join("\n")}\n`, exitCode: 0 };
     },
 };
 /**

package/dist/commands/top.js

@@ -49,6 +49,6 @@ export const topCommand = {
             const status = p.status === "running" ? "R" : "S";
             lines.push(`${String(p.pid).padStart(5)} ${p.username.padEnd(8).slice(0, 8)}  20   0 ${String(virt).padStart(7)} ${String(res).padStart(6)} ${String(shr).padStart(6)} ${status} ${cpu.padStart(4)} ${mem.padStart(5)}   0:00.00 ${p.command}`);
         });
-        return { stdout: lines.join("\n") + "\n", exitCode: 0 };
+        return { stdout: `${lines.join("\n")}\n`, exitCode: 0 };
     },
 };

package/dist/commands/uname.js

@@ -12,7 +12,7 @@ export const unameCommand = {
     run: ({ shell, args }) => {
         const all = ifFlag(args, ["-a"]);
         const sysname = "Linux";
-        const release = shell.properties?.kernel ?? "5.15.0";
+        const release = shell.properties?.kernel ?? "1.0.0+itsrealfortune+1-amd64";
         const machine = shell.properties?.arch ?? "x86_64";
         const hostname = shell.hostname;
         if (all)

package/dist/commands/xfceDesktop.d.ts

@@ -0,0 +1,2 @@
+import type { ShellModule } from "../types/commands";
+export declare const thunarCommand: ShellModule;

package/dist/commands/xfceDesktop.js

@@ -0,0 +1,13 @@
+export const thunarCommand = {
+    name: "thunar",
+    params: [],
+    run(ctx) {
+        const dm = ctx.shell.desktopManager;
+        if (!dm?.isActive()) {
+            return { stderr: "thunar: desktop is not running (start it with startxfce4)", exitCode: 1 };
+        }
+        const path = ctx.args[0] || ctx.env.vars.HOME || "/root";
+        dm.createThunarWindow(path);
+        return { exitCode: 0 };
+    },
+};

package/dist/modules/VirtualNetworkManager.d.ts

@@ -5,6 +5,10 @@
  * latency and packet loss. Used by the `ip`, `ping`, and `netstat` commands
  * to produce dynamic, deterministic output instead of hardcoded strings.
  */
+/**
+ * A virtual network interface, either loopback or ethernet,
+ * with MAC address, MTU, IPv4/IPv6 addresses, and link state.
+ */
 export interface VirtualInterface {
     name: string;
     type: "loopback" | "ether";
@@ -15,6 +19,10 @@ export interface VirtualInterface {
     ipv4Mask: number;
     ipv6: string;
 }
+/**
+ * A routing table entry mapping a destination subnet
+ * to a gateway and outbound device.
+ */
 export interface VirtualRoute {
     destination: string;
     gateway: string;
@@ -22,32 +30,93 @@ export interface VirtualRoute {
     device: string;
     flags: string;
 }
+/**
+ * An ARP cache entry mapping an IP address to a MAC address
+ * on a specific device, with neighbour reachability state.
+ */
 export interface VirtualArpEntry {
     ip: string;
     mac: string;
     device: string;
     state: "REACHABLE" | "STALE" | "PERMANENT";
 }
+/**
+ * Virtual network stack with routing table, ARP cache, and interface management.
+ * Provides dynamic data for `ip`, `ping`, and `/proc/net/*`.
+ */
 export declare class VirtualNetworkManager {
     private interfaces;
     private routes;
     private arpCache;
+    /**
+     * Returns a copy of all configured interfaces.
+     * @returns Array of VirtualInterface objects.
+     */
     getInterfaces(): VirtualInterface[];
+    /**
+     * Returns a copy of the routing table.
+     * @returns Array of VirtualRoute objects.
+     */
     getRoutes(): VirtualRoute[];
+    /**
+     * Returns a copy of the ARP cache.
+     * @returns Array of VirtualArpEntry objects.
+     */
     getArpCache(): VirtualArpEntry[];
+    /**
+     * Adds a new route to the routing table.
+     * @param dest Destination network or "default".
+     * @param gateway Gateway IP address.
+     * @param netmask Subnet mask (e.g. "255.255.255.0").
+     * @param device Outbound device name (e.g. "eth0").
+     */
     addRoute(dest: string, gateway: string, netmask: string, device: string): void;
+    /**
+     * Removes a route by destination network.
+     * @param dest Destination network to remove.
+     * @returns True if a route was removed, false if no match.
+     */
     delRoute(dest: string): boolean;
+    /**
+     * Sets the administrative state of an interface.
+     * @param name Interface name ("lo", "eth0", etc.).
+     * @param state Desired state: "UP" or "DOWN".
+     * @returns True if the interface was found and updated, false otherwise.
+     */
     setInterfaceState(name: string, state: "UP" | "DOWN"): boolean;
+    /**
+     * Sets the IPv4 address and prefix length on an interface.
+     * @param name Interface name.
+     * @param ipv4 New IPv4 address.
+     * @param mask New subnet mask prefix length (e.g. 24).
+     * @returns True if the interface was found and updated, false otherwise.
+     */
     setInterfaceIp(name: string, ipv4: string, mask: number): boolean;
-    /** Ping simulation: returns latency in ms, or -1 if unreachable. */
+    /**
+     * Simulates an ICMP ping to the given host.
+     * @param host Target IP address or hostname.
+     * @returns Latency in milliseconds if reachable, -1 if unreachable.
+     */
     ping(host: string): number;
-    /** Get formatted output for `ip addr`. */
+    /**
+     * Formats all interfaces as `ip addr` output.
+     * @returns Formatted string mimicking `ip addr` command.
+     */
     formatIpAddr(): string;
-    /** Get formatted output for `ip route`. */
+    /**
+     * Formats the routing table as `ip route` output.
+     * @returns Formatted string mimicking `ip route` command.
+     */
     formatIpRoute(): string;
-    /** Get formatted output for `ip link`. */
+    /**
+     * Formats all interfaces as `ip link` output.
+     * @returns Formatted string mimicking `ip link` command.
+     */
     formatIpLink(): string;
-    /** Get formatted output for `ip neigh`. */
+    /**
+     * Formats the ARP cache as `ip neigh` output.
+     * @returns Formatted string mimicking `ip neigh` command.
+     */
     formatIpNeigh(): string;
     private _maskToCidr;
     private _ipForDevice;

package/dist/modules/VirtualNetworkManager.js

@@ -5,10 +5,15 @@
  * latency and packet loss. Used by the `ip`, `ping`, and `netstat` commands
  * to produce dynamic, deterministic output instead of hardcoded strings.
  */
+/** Generates a random MAC address in the 02:42:xx:xx:xx:xx range. */
 function randomMac() {
     const hex = () => Math.floor(Math.random() * 256).toString(16).padStart(2, "0");
     return `02:42:${hex()}:${hex()}:${hex()}:${hex()}`;
 }
+/**
+ * Virtual network stack with routing table, ARP cache, and interface management.
+ * Provides dynamic data for `ip`, `ping`, and `/proc/net/*`.
+ */
 export class VirtualNetworkManager {
     interfaces = [
         {
@@ -40,18 +45,42 @@ export class VirtualNetworkManager {
     arpCache = [
         { ip: "10.0.0.1", mac: "02:42:0a:00:00:01", device: "eth0", state: "REACHABLE" },
     ];
+    /**
+     * Returns a copy of all configured interfaces.
+     * @returns Array of VirtualInterface objects.
+     */
     getInterfaces() {
         return [...this.interfaces];
     }
+    /**
+     * Returns a copy of the routing table.
+     * @returns Array of VirtualRoute objects.
+     */
     getRoutes() {
         return [...this.routes];
     }
+    /**
+     * Returns a copy of the ARP cache.
+     * @returns Array of VirtualArpEntry objects.
+     */
     getArpCache() {
         return [...this.arpCache];
     }
+    /**
+     * Adds a new route to the routing table.
+     * @param dest Destination network or "default".
+     * @param gateway Gateway IP address.
+     * @param netmask Subnet mask (e.g. "255.255.255.0").
+     * @param device Outbound device name (e.g. "eth0").
+     */
     addRoute(dest, gateway, netmask, device) {
         this.routes.push({ destination: dest, gateway, netmask, device, flags: "UG" });
     }
+    /**
+     * Removes a route by destination network.
+     * @param dest Destination network to remove.
+     * @returns True if a route was removed, false if no match.
+     */
     delRoute(dest) {
         const idx = this.routes.findIndex((r) => r.destination === dest);
         if (idx === -1)
@@ -59,6 +88,12 @@ export class VirtualNetworkManager {
         this.routes.splice(idx, 1);
         return true;
     }
+    /**
+     * Sets the administrative state of an interface.
+     * @param name Interface name ("lo", "eth0", etc.).
+     * @param state Desired state: "UP" or "DOWN".
+     * @returns True if the interface was found and updated, false otherwise.
+     */
     setInterfaceState(name, state) {
         const iface = this.interfaces.find((i) => i.name === name);
         if (!iface)
@@ -66,6 +101,13 @@ export class VirtualNetworkManager {
         iface.state = state;
         return true;
     }
+    /**
+     * Sets the IPv4 address and prefix length on an interface.
+     * @param name Interface name.
+     * @param ipv4 New IPv4 address.
+     * @param mask New subnet mask prefix length (e.g. 24).
+     * @returns True if the interface was found and updated, false otherwise.
+     */
     setInterfaceIp(name, ipv4, mask) {
         const iface = this.interfaces.find((i) => i.name === name);
         if (!iface)
@@ -74,7 +116,11 @@ export class VirtualNetworkManager {
         iface.ipv4Mask = mask;
         return true;
     }
-    /** Ping simulation: returns latency in ms, or -1 if unreachable. */
+    /**
+     * Simulates an ICMP ping to the given host.
+     * @param host Target IP address or hostname.
+     * @returns Latency in milliseconds if reachable, -1 if unreachable.
+     */
     ping(host) {
         // Loopback always works
         if (host === "127.0.0.1" || host === "localhost" || host === "::1") {
@@ -90,7 +136,10 @@ export class VirtualNetworkManager {
             return -1;
         return 0.8 + Math.random() * 5;
     }
-    /** Get formatted output for `ip addr`. */
+    /**
+     * Formats all interfaces as `ip addr` output.
+     * @returns Formatted string mimicking `ip addr` command.
+     */
     formatIpAddr() {
         const lines = [];
         let idx = 1;
@@ -108,7 +157,10 @@ export class VirtualNetworkManager {
         }
         return lines.join("\n");
     }
-    /** Get formatted output for `ip route`. */
+    /**
+     * Formats the routing table as `ip route` output.
+     * @returns Formatted string mimicking `ip route` command.
+     */
     formatIpRoute() {
         return this.routes.map((r) => {
             if (r.destination === "default") {
@@ -117,7 +169,10 @@ export class VirtualNetworkManager {
             return `${r.destination}/${this._maskToCidr(r.netmask)} dev ${r.device} proto kernel scope link src ${this._ipForDevice(r.device)}`;
         }).join("\n");
     }
-    /** Get formatted output for `ip link`. */
+    /**
+     * Formats all interfaces as `ip link` output.
+     * @returns Formatted string mimicking `ip link` command.
+     */
     formatIpLink() {
         const lines = [];
         let idx = 1;
@@ -131,7 +186,10 @@ export class VirtualNetworkManager {
         }
         return lines.join("\n");
     }
-    /** Get formatted output for `ip neigh`. */
+    /**
+     * Formats the ARP cache as `ip neigh` output.
+     * @returns Formatted string mimicking `ip neigh` command.
+     */
     formatIpNeigh() {
         return this.arpCache.map((e) => `${e.ip} dev ${e.device} lladdr ${e.mac} ${e.state}`).join("\n");
     }

package/dist/modules/desktopManager.d.ts

@@ -0,0 +1,104 @@
+import type { VirtualShell } from "../VirtualShell";
+import type { ShellStream } from "../types/streams";
+import { WebTermRenderer } from "./webTermRenderer";
+export interface TerminalContent {
+    type: "terminal";
+    termRenderer: WebTermRenderer;
+    dataListeners: Array<(chunk: Buffer) => void>;
+    preEl?: HTMLPreElement;
+    stream?: ShellStream;
+}
+export interface ThunarContent {
+    type: "thunar";
+    path: string;
+}
+export interface AboutContent {
+    type: "about";
+}
+export interface EditorContent {
+    type: "editor";
+    path: string;
+    dirty: boolean;
+}
+export type WindowContent = TerminalContent | ThunarContent | AboutContent | EditorContent;
+export interface DesktopWindow {
+    id: string;
+    title: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    minimized: boolean;
+    focused: boolean;
+    zIndex: number;
+    content: WindowContent;
+}
+export interface DesktopState {
+    active: boolean;
+    windows: DesktopWindow[];
+    menuOpen: boolean;
+    clock: string;
+    focusedWindowId: string | null;
+}
+export declare class DesktopManager {
+    private shell;
+    private container;
+    private active;
+    private windows;
+    private zCounter;
+    private menuOpen;
+    private nextWinId;
+    private clockInterval?;
+    private onExit;
+    private stopResolve;
+    private dragState;
+    private _renderGuard;
+    private readonly trashPath;
+    private docListeners;
+    private pendingTimeouts;
+    constructor(shell: VirtualShell, container: HTMLElement);
+    isActive(): boolean;
+    setOnExit(cb: () => void): void;
+    start(): Promise<void>;
+    stop(): void;
+    getFocusedTerminal(): {
+        stream: ShellStream;
+        dataListeners: Array<(chunk: Buffer) => void>;
+        preEl: HTMLPreElement;
+    } | null;
+    handleKeyDown(e: KeyboardEvent): void;
+    handlePaste(e: ClipboardEvent): void;
+    createTerminalWindow(): string;
+    createThunarWindow(path?: string): string;
+    createEditorWindow(path?: string): string;
+    createAboutWindow(): string;
+    closeWindow(id: string): void;
+    toggleMinimize(id: string): void;
+    focusWindow(id: string): void;
+    private createWindow;
+    private ensureWindowElement;
+    private renderWindowElement;
+    private addDocListener;
+    private removeAllDocListeners;
+    private setupEventDelegation;
+    private renderAll;
+    private renderPanel;
+    private renderDesktopIcons;
+    private renderWindows;
+    private renderWindowPositions;
+    private renderTerminalContentById;
+    private renderThunarContent;
+    private renderEditorContent;
+    private saveEditor;
+    private renderAboutContent;
+    private updateClock;
+    private showContextMenu;
+    private closeContextMenu;
+    private ensureTrashDir;
+    private refreshThunarWindow;
+    private moveToTrash;
+    private trashRestore;
+    private trashDelete;
+    private renamePrompt;
+    private escapeHtml;
+}