@lifo-sh/core 0.5.0 → 0.5.6

package/dist/shell/ProcessRegistry.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Process information structure
+ * Mirrors Linux process model with PID, PPID, status, etc.
+ */
+export interface Process {
+    /** Process ID (unique identifier) */
+    pid: number;
+    /** Parent Process ID */
+    ppid: number;
+    /** Command name (argv[0]) */
+    command: string;
+    /** Full command line arguments */
+    args: string[];
+    /** Working directory when process started */
+    cwd: string;
+    /** Environment variables */
+    env: Record<string, string>;
+    /** Process start time (milliseconds since epoch) */
+    startTime: number;
+    /** Current process status */
+    status: 'running' | 'sleeping' | 'stopped' | 'zombie';
+    /** Whether this is a foreground process */
+    isForeground: boolean;
+    /** Promise that resolves when process completes */
+    promise: Promise<number>;
+    /** Controller for aborting/killing the process */
+    abortController: AbortController;
+    /** Exit code (null if still running) */
+    exitCode: number | null;
+    /** Optional job ID for background jobs (for backwards compat with JobTable) */
+    jobId?: number;
+}
+/**
+ * Options for spawning a new process
+ */
+export interface SpawnOptions {
+    /** Command name */
+    command: string;
+    /** Command arguments (including command itself as args[0]) */
+    args: string[];
+    /** Working directory */
+    cwd: string;
+    /** Environment variables */
+    env: Record<string, string>;
+    /** Whether this is a foreground process */
+    isForeground: boolean;
+    /** Promise that resolves with exit code */
+    promise: Promise<number>;
+    /** Abort controller for killing the process */
+    abortController: AbortController;
+    /** Parent PID (defaults to 1 - shell) */
+    ppid?: number;
+}
+/**
+ * Central process registry for tracking all running processes.
+ * Provides Linux-like process management with PIDs, status tracking,
+ * and process lifecycle management.
+ */
+export declare class ProcessRegistry {
+    private processes;
+    private nextPid;
+    private nextJobId;
+    /**
+     * Register the shell as a process.
+     * @deprecated Use spawn() directly instead. Each shell gets its own PID.
+     * Kept for backwards compatibility.
+     */
+    registerShell(_cwd: string, _env: Record<string, string>): void;
+    /**
+     * Spawn a new process and register it in the process table.
+     * Returns the assigned PID.
+     */
+    spawn(opts: SpawnOptions): number;
+    /**
+     * Get process information by PID.
+     */
+    get(pid: number): Process | undefined;
+    /**
+     * Get process information by job ID.
+     */
+    getByJobId(jobId: number): Process | undefined;
+    /**
+     * Check if a process exists.
+     */
+    has(pid: number): boolean;
+    /**
+     * Get all PIDs in the system.
+     */
+    getAllPIDs(): number[];
+    /**
+     * Get all processes.
+     */
+    getAll(): Process[];
+    /**
+     * Get all running processes (excludes zombies and stopped).
+     */
+    getRunning(): Process[];
+    /**
+     * Get all background jobs (non-foreground processes, excluding shell).
+     */
+    getBackgroundJobs(): Process[];
+    /**
+     * Get all zombie processes (finished but not reaped).
+     */
+    getZombies(): Process[];
+    /**
+     * Kill a process by sending abort signal.
+     * Returns true if process was killed, false if not found or is a shell process.
+     */
+    kill(pid: number, signal?: string): boolean;
+    /**
+     * Reap a zombie process (remove from process table).
+     * This should be called after collecting exit code.
+     * Returns true if process was reaped, false if not found or not a zombie.
+     */
+    reap(pid: number): boolean;
+    /**
+     * Collect and reap orphan zombie processes.
+     * Only reaps zombies whose parent is no longer alive (orphans reparented to init).
+     * Zombies whose parent is still running are left for the parent to reap via waitpid.
+     * Returns array of reaped processes for display/logging.
+     */
+    collectZombies(): Process[];
+    /**
+     * Reap all zombie children of a given parent PID.
+     * Called when a parent exits without waitpid on its children.
+     * Running children are NOT killed — they stay alive (reparented to init in spirit).
+     */
+    reapOrphansOf(ppid: number): void;
+    /**
+     * Update process status.
+     * Useful for manual status changes (e.g., sleeping, stopped).
+     */
+    updateStatus(pid: number, status: Process['status']): boolean;
+    /**
+     * Get process uptime in milliseconds.
+     */
+    getUptime(pid: number): number | null;
+    /**
+     * Get formatted process info (for ps command).
+     */
+    getFormattedInfo(pid: number): string | null;
+    /**
+     * Get process count.
+     */
+    count(): number;
+    /**
+     * Clear all processes except shell (useful for testing).
+     */
+    reset(): void;
+}
+//# sourceMappingURL=ProcessRegistry.d.ts.map

package/dist/shell/ProcessRegistry.d.ts.map

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

package/dist/shell/ProcessRegistry.example.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ProcessRegistry Usage Examples
+ *
+ * This file demonstrates how to use the ProcessRegistry for Linux-like
+ * process management in lifo.
+ */
+export {};
+//# sourceMappingURL=ProcessRegistry.example.d.ts.map

package/dist/shell/ProcessRegistry.example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessRegistry.example.d.ts","sourceRoot":"","sources":["../../src/shell/ProcessRegistry.example.ts"],"names":[],"mappings":"AACA;;;;;GAKG"}

package/dist/shell/ProcessRegistry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ProcessRegistry.test.d.ts.map

package/dist/shell/ProcessRegistry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessRegistry.test.d.ts","sourceRoot":"","sources":["../../src/shell/ProcessRegistry.test.ts"],"names":[],"mappings":""}

package/dist/shell/Shell.d.ts

@@ -1,7 +1,8 @@
 import { ITerminal } from '../terminal/ITerminal.js';
-import { VFS } from '../kernel/vfs/index.js';
+import { IKernelVfs, Kernel } from '@lifo-sh/kernel';
 import { CommandRegistry } from '../commands/registry.js';
 import { JobTable } from './jobs.js';
+import { ProcessRegistry } from './ProcessRegistry.js';
 export interface ExecuteOptions {
     cwd?: string;
     env?: Record<string, string>;
@@ -11,6 +12,7 @@ export interface ExecuteOptions {
 }
 export declare class Shell {
     private terminal;
+    private kernel;
     private vfs;
     private registry;
     private cwd;
@@ -18,6 +20,7 @@ export declare class Shell {
     private aliases;
     private lineBuffer;
     private cursorPos;
+    private screenCursorRow;
     private history;
     private historyIndex;
     private savedLine;
@@ -30,20 +33,25 @@ export declare class Shell {
     private interpreterConfig;
     private historyManager;
     private jobTable;
+    private processRegistry;
+    private processExecutor;
     private builtins;
     private tabCount;
-    constructor(terminal: ITerminal, vfs: VFS, registry: CommandRegistry, env: Record<string, string>);
+    private pasteQueue;
+    constructor(terminal: ITerminal, kernel: Kernel, registry: CommandRegistry, env: Record<string, string>);
     private registerBuiltins;
     getJobTable(): JobTable;
+    getProcessRegistry(): ProcessRegistry;
     getCwd(): string;
     setCwd(cwd: string): void;
     getEnv(): Record<string, string>;
-    getVfs(): VFS;
+    getVfs(): IKernelVfs;
     getRegistry(): CommandRegistry;
     /**
      * Programmatic command execution with captured stdout/stderr.
      * Used by Sandbox.commands.run() for headless mode.
      */
+    private _executeDepth;
     execute(cmd: string, options?: ExecuteOptions): Promise<{
         stdout: string;
         stderr: string;
@@ -56,8 +64,9 @@ export declare class Shell {
     private handleTab;
     private handleStdinInput;
     private applyCompletion;
-    private clearLine;
+    private getPromptWidth;
     private redrawLine;
+    private drainPasteQueue;
     private moveCursorLeft;
     private moveCursorRight;
     private moveCursorHome;

package/dist/shell/Shell.d.ts.map

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

package/dist/shell/completer.d.ts

@@ -1,4 +1,4 @@
-import { VFS } from '../kernel/vfs/index.js';
+import { IKernelVfs } from '@lifo-sh/kernel';
 import { CommandRegistry } from '../commands/registry.js';
 export interface CompletionResult {
     replacementStart: number;
@@ -11,7 +11,7 @@ export interface CompletionContext {
     cursorPos: number;
     cwd: string;
     env: Record<string, string>;
-    vfs: VFS;
+    vfs: IKernelVfs;
     registry: CommandRegistry;
     builtinNames: string[];
 }

package/dist/shell/completer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completer.d.ts","sourceRoot":"","sources":["../../src/shell/completer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAoCjE"}
+{"version":3,"file":"completer.d.ts","sourceRoot":"","sources":["../../src/shell/completer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAoCjE"}

package/dist/shell/expander.d.ts

@@ -1,10 +1,10 @@
 import { WordPart } from './types.js';
-import { VFS } from '../kernel/vfs/index.js';
+import { IKernelVfs } from '@lifo-sh/kernel';
 export interface ExpandContext {
     env: Record<string, string>;
     lastExitCode: number;
     cwd: string;
-    vfs: VFS;
+    vfs: IKernelVfs;
     executeCapture?: (input: string) => Promise<string>;
 }
 /**

package/dist/shell/expander.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expander.d.ts","sourceRoot":"","sources":["../../src/shell/expander.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB5F;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvF"}
+{"version":3,"file":"expander.d.ts","sourceRoot":"","sources":["../../src/shell/expander.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,UAAU,CAAC;IAChB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB5F;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvF"}

package/dist/shell/history.d.ts

@@ -1,8 +1,8 @@
-import { VFS } from '../kernel/vfs/index.js';
+import { IKernelVfs } from '@lifo-sh/kernel';
 export declare class HistoryManager {
     private entries;
     private vfs;
-    constructor(vfs: VFS);
+    constructor(vfs: IKernelVfs);
     load(): void;
     save(): void;
     add(line: string): void;

package/dist/shell/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/shell/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAKlD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,GAAG,CAAM;gBAEL,GAAG,EAAE,GAAG;IAIpB,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IAQZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBvB;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA6CnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItC,MAAM,IAAI,MAAM,EAAE;IAIlB,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/shell/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKlD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,GAAG,CAAa;gBAEZ,GAAG,EAAE,UAAU;IAI3B,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IAQZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBvB;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA6CnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItC,MAAM,IAAI,MAAM,EAAE;IAIlB,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/shell/interpreter.d.ts

@@ -1,8 +1,9 @@
 import { ScriptNode } from './types.js';
-import { VFS } from '../kernel/vfs/index.js';
+import { IKernel, IKernelVfs, IProcessExecutor as ProcessExecutor } from '@lifo-sh/kernel';
 import { CommandRegistry } from '../commands/registry.js';
 import { CommandOutputStream, CommandInputStream } from '../commands/types.js';
 import { JobTable } from './jobs.js';
+import { ProcessRegistry } from './ProcessRegistry.js';
 import { TerminalStdin } from './terminal-stdin.js';
 export declare class BreakSignal {
     levels: number;
@@ -18,13 +19,16 @@ export declare class ReturnSignal {
 }
 export type BuiltinFn = (args: string[], stdout: CommandOutputStream, stderr: CommandOutputStream, stdin?: CommandInputStream) => Promise<number>;
 export interface InterpreterConfig {
+    kernel: IKernel;
     env: Record<string, string>;
     getCwd: () => string;
     setCwd: (cwd: string) => void;
-    vfs: VFS;
+    vfs: IKernelVfs;
     registry: CommandRegistry;
     builtins: Map<string, BuiltinFn>;
     jobTable: JobTable;
+    processRegistry: ProcessRegistry;
+    processExecutor?: ProcessExecutor;
     writeToTerminal: (text: string) => void;
     aliases?: Map<string, string>;
     /** Override default stdout for programmatic capture */
@@ -33,6 +37,8 @@ export interface InterpreterConfig {
     defaultStderr?: CommandOutputStream;
     /** Returns the current abort signal for foreground commands */
     getAbortSignal?: () => AbortSignal;
+    /** Internal flag: true when executing background job (don't register individual commands) */
+    isBackgroundContext?: boolean;
 }
 export declare class Interpreter {
     private config;

package/dist/shell/interpreter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../../src/shell/interpreter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAYX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,qBAAa,WAAW;IACH,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAClC;AAED,qBAAa,cAAc;IACN,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAClC;AAED,qBAAa,YAAY;IACJ,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CACpC;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,mBAAmB,EAC3B,KAAK,CAAC,EAAE,kBAAkB,KACvB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,uDAAuD;IACvD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,uDAAuD;IACvD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,WAAW,CAAC;CACpC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAA0C;gBAE/C,MAAM,EAAE,iBAAiB;IAIrC,eAAe,IAAI,MAAM;IAInB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IASjF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;YAiBlE,WAAW;IAezB,OAAO,CAAC,kBAAkB;YAWZ,kBAAkB;YAsBlB,eAAe;YAoBf,uBAAuB;YAiCvB,cAAc;YA0Bd,SAAS;YAoBT,UAAU;YAkCV,YAAY;YA0BZ,YAAY;YA0BZ,WAAW;YAoBX,kBAAkB;YAKlB,YAAY;YAMZ,mBAAmB;YAQnB,oBAAoB;YA2KpB,eAAe;IA2CvB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBpD,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,gBAAgB;CAYzB"}
+{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../../src/shell/interpreter.ts"],"names":[],"mappings":"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"}

package/dist/shell/test-builtin.d.ts

@@ -1,8 +1,8 @@
-import { VFS } from '../kernel/vfs/index.js';
+import { IKernelVfs } from '@lifo-sh/kernel';
 import { CommandOutputStream } from '../commands/types.js';
 /**
  * Implementation of the `test` / `[` shell builtin.
  * Evaluates conditional expressions.
  */
-export declare function evaluateTest(args: string[], vfs: VFS, stderr: CommandOutputStream): number;
+export declare function evaluateTest(args: string[], vfs: IKernelVfs, stderr: CommandOutputStream): number;
 //# sourceMappingURL=test-builtin.d.ts.map

package/dist/shell/test-builtin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-builtin.d.ts","sourceRoot":"","sources":["../../src/shell/test-builtin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAqBR"}
+{"version":3,"file":"test-builtin.d.ts","sourceRoot":"","sources":["../../src/shell/test-builtin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAqBR"}

package/dist/sl-BmMNz7ir.js

@@ -0,0 +1,200 @@
+const CSI = "\x1B[";
+const HIDE_CURSOR = `${CSI}?25l`;
+const SHOW_CURSOR = `${CSI}?25h`;
+const ALT_SCREEN_ON = `${CSI}?1049h`;
+const ALT_SCREEN_OFF = `${CSI}?1049l`;
+const CLEAR = `${CSI}2J`;
+const HOME = `${CSI}H`;
+function moveTo(row, col) {
+  return `${CSI}${row + 1};${col + 1}H`;
+}
+const D51BODY = [
+  "      ====        ________                ___________ ",
+  "  _D _|  |_______/        \\__I_I_____===__|_________|",
+  "   |(_)---  |   H\\________/ |   |        =|___ ___|  ",
+  "   /     |  |   H  |  |     |   |         ||_| |_||  ",
+  "  |      |  |   H  |__--------------------| [___] |  ",
+  "  | ________|___H__/__|_____/[][]~\\_______|       |  ",
+  "  |/ |   |-----------I_____I [][] []  D   |=======|__"
+];
+const D51WHEELS = [
+  [
+    "__/ =| o |=-~~\\  /~~\\  /~~\\  /~~\\ ____Y___________|__",
+    " |/-=|___|=    ||    ||    ||    |_____/~\\___/       ",
+    "  \\_/      \\O=====O=====O=====O_/      \\_/          "
+  ],
+  [
+    "__/ =| o |=-~~\\  /~~\\  /~~\\  /~~\\ ____Y___________|__",
+    " |/-=|___|=O=====O=====O=====O   |_____/~\\___/       ",
+    "  \\_/      \\__/  \\__/  \\__/  \\__/      \\_/          "
+  ],
+  [
+    "__/ =| o |=-O=====O=====O=====O \\ ____Y___________|__",
+    " |/-=|___|=    ||    ||    ||    |_____/~\\___/       ",
+    "  \\_/      \\__/  \\__/  \\__/  \\__/      \\_/          "
+  ],
+  [
+    "__/ =| o |=-~O=====O=====O=====O\\ ____Y___________|__",
+    " |/-=|___|=    ||    ||    ||    |_____/~\\___/       ",
+    "  \\_/      \\__/  \\__/  \\__/  \\__/      \\_/          "
+  ],
+  [
+    "__/ =| o |=-~~\\  /~~\\  /~~\\  /~~\\ ____Y___________|__",
+    " |/-=|___|=   O=====O=====O=====O|_____/~\\___/       ",
+    "  \\_/      \\__/  \\__/  \\__/  \\__/      \\_/          "
+  ],
+  [
+    "__/ =| o |=-~~\\  /~~\\  /~~\\  /~~\\ ____Y___________|__",
+    " |/-=|___|=    ||    ||    ||    |_____/~\\___/       ",
+    "  \\_/      \\_O=====O=====O=====O/      \\_/          "
+  ]
+];
+const COAL = [
+  "                              ",
+  "                              ",
+  "    _________________         ",
+  "   _|                \\_____A  ",
+  " =|                        |  ",
+  " -|                        |  ",
+  "__|________________________|_ ",
+  "|__________________________|_ ",
+  "   |_D__D__D_|  |_D__D__D_|  ",
+  "    \\_/   \\_/    \\_/   \\_/   "
+];
+const D51HEIGHT = 10;
+const D51FUNNEL = 7;
+const D51LENGTH = 53;
+const COAL_LENGTH = 30;
+const PATTERNS = 6;
+const SMOKEPTNS = 8;
+const smokeA = [
+  "(   )",
+  "(    )",
+  "(   )",
+  "(  )",
+  "( )",
+  "()",
+  "O",
+  " "
+];
+const smokeB = [
+  "(@@@)",
+  "(@@@@)",
+  "(@@@)",
+  "(@@)",
+  "(@)",
+  "@@",
+  "@",
+  " "
+];
+const dy = [2, 1, 1, 1, 0, 0, 0, 0];
+const dx = [-2, -1, 0, 1, 1, 2, 2, 3];
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+const command = async (ctx) => {
+  const cols = parseInt(ctx.env["COLUMNS"] || "80", 10);
+  const rows = parseInt(ctx.env["LINES"] || "24", 10);
+  const midRow = Math.max(0, Math.floor((rows - D51HEIGHT) / 2));
+  const smoke = [];
+  let smokeCounter = 0;
+  ctx.stdout.write(ALT_SCREEN_ON + CLEAR + HOME + HIDE_CURSOR);
+  const trainWidth = D51LENGTH + 1 + COAL_LENGTH;
+  function eraseSmoke(f, py, px, plen) {
+    const col = px - Math.floor(plen / 2);
+    const startCol = Math.max(0, col);
+    const clearLen = Math.min(plen + 1, cols - startCol);
+    if (py >= 0 && py < rows && startCol < cols && clearLen > 0) {
+      f += moveTo(py, startCol) + " ".repeat(clearLen);
+    }
+    return f;
+  }
+  for (let x = cols - 1; ; x--) {
+    if (ctx.signal.aborted) break;
+    if (x < -trainWidth && smoke.length === 0) break;
+    const wheelFrame = ((cols - x) % PATTERNS + PATTERNS) % PATTERNS;
+    const body = [...D51BODY, ...D51WHEELS[wheelFrame]];
+    const full = [];
+    for (let i = 0; i < D51HEIGHT; i++) {
+      const bodyLine = i < body.length ? body[i] : "";
+      const coalLine = i < COAL.length ? COAL[i] : "";
+      full.push(bodyLine + (coalLine.length > 0 ? " " + coalLine : ""));
+    }
+    let frame = "";
+    for (let i = 0; i < D51HEIGHT; i++) {
+      const row = midRow + i;
+      if (row < 0 || row >= rows) continue;
+      const line = full[i];
+      let visibleStart = 0;
+      let visibleEnd = line.length;
+      let screenCol = x;
+      if (x < 0) {
+        visibleStart = -x;
+        screenCol = 0;
+      }
+      if (x + visibleEnd > cols) {
+        visibleEnd = cols - x;
+      }
+      if (visibleStart >= visibleEnd) continue;
+      const slice = line.substring(visibleStart, visibleEnd);
+      frame += moveTo(row, screenCol) + slice;
+    }
+    const trailCol = x + trainWidth + 1;
+    if (trailCol >= 0 && trailCol < cols) {
+      for (let i = 0; i < D51HEIGHT; i++) {
+        const row = midRow + i;
+        if (row >= 0 && row < rows) {
+          frame += moveTo(row, trailCol) + "  ";
+        }
+      }
+    }
+    if (x % 4 === 0 && x + D51FUNNEL >= 0 && x + D51FUNNEL < cols) {
+      const sy = midRow - 1;
+      const sx = x + D51FUNNEL;
+      smoke.push({
+        y: sy,
+        x: sx,
+        prevY: sy,
+        prevX: sx,
+        prevLen: 0,
+        age: 0,
+        kind: smokeCounter % 2
+      });
+      smokeCounter++;
+    }
+    for (const p of smoke) {
+      if (p.prevLen > 0) {
+        frame = eraseSmoke(frame, p.prevY, p.prevX, p.prevLen);
+      }
+    }
+    for (const p of smoke) {
+      if (p.age < SMOKEPTNS) {
+        const pattern = p.kind === 0 ? smokeA[p.age] : smokeB[p.age];
+        const px = p.x - Math.floor(pattern.length / 2);
+        if (p.y >= 0 && p.y < rows && px >= 0 && px + pattern.length <= cols) {
+          frame += moveTo(p.y, px) + pattern;
+        }
+        p.prevY = p.y;
+        p.prevX = p.x;
+        p.prevLen = pattern.length;
+        p.y -= dy[p.age];
+        p.x += dx[p.age];
+        p.age++;
+      }
+    }
+    for (let si = smoke.length - 1; si >= 0; si--) {
+      if (smoke[si].age >= SMOKEPTNS) {
+        const p = smoke[si];
+        frame = eraseSmoke(frame, p.prevY, p.prevX, p.prevLen);
+        smoke.splice(si, 1);
+      }
+    }
+    ctx.stdout.write(frame);
+    await sleep(40);
+  }
+  ctx.stdout.write(SHOW_CURSOR + ALT_SCREEN_OFF);
+  return 0;
+};
+export {
+  command as default
+};

package/dist/sleep-C_3mjcFi.js

@@ -0,0 +1,25 @@
+const command = async (ctx) => {
+  if (ctx.args.length === 0) {
+    ctx.stderr.write("sleep: missing operand\n");
+    return 1;
+  }
+  const seconds = parseFloat(ctx.args[0]);
+  if (isNaN(seconds) || seconds < 0) {
+    ctx.stderr.write(`sleep: invalid time interval '${ctx.args[0]}'
+`);
+    return 1;
+  }
+  const ms = Math.round(seconds * 1e3);
+  await new Promise((resolve) => {
+    const timer = setTimeout(resolve, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      resolve();
+    };
+    ctx.signal.addEventListener("abort", onAbort, { once: true });
+  });
+  return ctx.signal.aborted ? 130 : 0;
+};
+export {
+  command as default
+};