@lifo-sh/core 0.1.0

package/dist/node-compat/url.d.ts

@@ -0,0 +1,53 @@
+declare const _URL: {
+    new (url: string | URL, base?: string | URL): URL;
+    prototype: URL;
+    canParse(url: string | URL, base?: string | URL): boolean;
+    createObjectURL(obj: Blob | MediaSource): string;
+    parse(url: string | URL, base?: string | URL): URL | null;
+    revokeObjectURL(url: string): void;
+};
+declare const _URLSearchParams: {
+    new (init?: string[][] | Record<string, string> | string | URLSearchParams): URLSearchParams;
+    prototype: URLSearchParams;
+};
+export { _URL as URL, _URLSearchParams as URLSearchParams };
+export declare function parse(urlString: string): {
+    protocol: string | null;
+    hostname: string | null;
+    port: string | null;
+    pathname: string;
+    search: string | null;
+    hash: string | null;
+    host: string | null;
+    href: string;
+    path: string;
+    query: string | null;
+};
+export declare function format(urlObj: {
+    protocol?: string;
+    hostname?: string;
+    port?: string | number;
+    pathname?: string;
+    search?: string;
+    hash?: string;
+}): string;
+export declare function resolve(from: string, to: string): string;
+declare const _default: {
+    URL: {
+        new (url: string | URL, base?: string | URL): URL;
+        prototype: URL;
+        canParse(url: string | URL, base?: string | URL): boolean;
+        createObjectURL(obj: Blob | MediaSource): string;
+        parse(url: string | URL, base?: string | URL): URL | null;
+        revokeObjectURL(url: string): void;
+    };
+    URLSearchParams: {
+        new (init?: string[][] | Record<string, string> | string | URLSearchParams): URLSearchParams;
+        prototype: URLSearchParams;
+    };
+    parse: typeof parse;
+    format: typeof format;
+    resolve: typeof resolve;
+};
+export default _default;
+//# sourceMappingURL=url.d.ts.map

package/dist/node-compat/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/node-compat/url.ts"],"names":[],"mappings":"AACA,QAAA,MAAM,IAAI;;;;;;;CAAiB,CAAC;AAC5B,QAAA,MAAM,gBAAgB;;;CAA6B,CAAC;AAEpD,OAAO,EAAE,IAAI,IAAI,GAAG,EAAE,gBAAgB,IAAI,eAAe,EAAE,CAAC;AAE5D,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG;IACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CA6BA;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAS1J;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAExD;;;;;;;;;;;;;;;;;;AAED,wBAAgE"}

package/dist/node-compat/util.d.ts

@@ -0,0 +1,27 @@
+export declare function format(fmt: string, ...args: unknown[]): string;
+export declare function inspect(obj: unknown, opts?: {
+    depth?: number;
+    colors?: boolean;
+}): string;
+export declare function promisify<T>(fn: (...args: [...unknown[], (err: unknown, result: T) => void]) => void): (...args: unknown[]) => Promise<T>;
+export declare function inherits(ctor: {
+    prototype: object;
+}, superCtor: {
+    prototype: object;
+}): void;
+export declare function deprecate<T extends (...args: unknown[]) => unknown>(fn: T, msg: string): T;
+export declare function types(): {
+    isDate: (v: unknown) => v is Date;
+    isRegExp: (v: unknown) => v is RegExp;
+    isArray: (arg: any) => arg is any[];
+};
+declare const _default: {
+    format: typeof format;
+    inspect: typeof inspect;
+    promisify: typeof promisify;
+    inherits: typeof inherits;
+    deprecate: typeof deprecate;
+    types: typeof types;
+};
+export default _default;
+//# sourceMappingURL=util.d.ts.map

package/dist/node-compat/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/node-compat/util.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CA2B9D;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAGzF;AAqCD,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAOzI;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE5F;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAS1F;AAED,wBAAgB,KAAK;gBAEL,OAAO;kBACL,OAAO;;EAGxB;;;;;;;;;AAED,wBAA0E"}

package/dist/ping-DtVEwwda.js

@@ -0,0 +1,50 @@
+const h = async (t) => {
+  let n = 4, r;
+  const m = t.args;
+  for (let e = 0; e < m.length; e++) {
+    const i = m[e];
+    i === "-c" ? (n = parseInt(m[++e] ?? "4", 10), (isNaN(n) || n < 1) && (n = 4)) : i.startsWith("-") || (r = i);
+  }
+  if (!r)
+    return t.stderr.write(`ping: missing host
+`), t.stderr.write(`Usage: ping [-c count] host
+`), 1;
+  let a = r;
+  !a.startsWith("http://") && !a.startsWith("https://") && (a = "https://" + a), t.stdout.write(`PING ${r}: ${n} requests
+`);
+  const o = [];
+  let d = 0;
+  for (let e = 0; e < n && !t.signal.aborted; e++) {
+    const i = performance.now();
+    try {
+      await fetch(a, { method: "HEAD", mode: "no-cors", signal: t.signal });
+      const s = performance.now() - i;
+      o.push(s), t.stdout.write(`Response from ${r}: time=${s.toFixed(1)}ms
+`);
+    } catch {
+      const s = performance.now() - i;
+      if (t.signal.aborted) break;
+      d++, t.stdout.write(`Request to ${r}: timeout (${s.toFixed(1)}ms)
+`);
+    }
+    e < n - 1 && !t.signal.aborted && await new Promise((s) => {
+      const c = setTimeout(s, 1e3), g = () => {
+        clearTimeout(c), s();
+      };
+      t.signal.addEventListener("abort", g, { once: !0 });
+    });
+  }
+  const l = o.length + d, u = l > 0 ? (d / l * 100).toFixed(0) : "0";
+  if (t.stdout.write(`
+--- ${r} ping statistics ---
+`), t.stdout.write(`${l} packets transmitted, ${o.length} received, ${u}% packet loss
+`), o.length > 0) {
+    const e = Math.min(...o), i = Math.max(...o), s = o.reduce((c, g) => c + g, 0) / o.length;
+    t.stdout.write(`rtt min/avg/max = ${e.toFixed(1)}/${s.toFixed(1)}/${i.toFixed(1)} ms
+`);
+  }
+  return d === l ? 1 : 0;
+};
+export {
+  h as default
+};

package/dist/pkg/PackageManager.d.ts

@@ -0,0 +1,19 @@
+import { VFS } from '../kernel/vfs/index.js';
+export interface PackageInfo {
+    name: string;
+    url: string;
+    installedAt: number;
+    size: number;
+}
+export declare class PackageManager {
+    private vfs;
+    constructor(vfs: VFS);
+    private readMetadata;
+    private writeMetadata;
+    private ensureDirs;
+    install(url: string, name?: string): Promise<PackageInfo>;
+    remove(name: string): boolean;
+    list(): PackageInfo[];
+    info(name: string): PackageInfo | null;
+}
+//# sourceMappingURL=PackageManager.d.ts.map

package/dist/pkg/PackageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageManager.d.ts","sourceRoot":"","sources":["../../src/pkg/PackageManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAMlD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,qBAAa,cAAc;IACb,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE5B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,UAAU;IAKZ,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoC/D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAqB7B,IAAI,IAAI,WAAW,EAAE;IAKrB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAIvC"}

package/dist/pkg/loader.d.ts

@@ -0,0 +1,4 @@
+import { VFS } from '../kernel/vfs/index.js';
+import { CommandRegistry } from '../commands/registry.js';
+export declare function loadInstalledPackages(vfs: VFS, registry: CommandRegistry): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/pkg/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/pkg/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAM/D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAyB/E"}

package/dist/printf-Cc2o7KZx.js

@@ -0,0 +1,70 @@
+function i(e, t) {
+  let s = "", n = 0, r = 0;
+  for (; r < e.length; )
+    if (e[r] === "\\") {
+      if (r++, r < e.length) {
+        switch (e[r]) {
+          case "n":
+            s += `
+`;
+            break;
+          case "t":
+            s += "	";
+            break;
+          case "\\":
+            s += "\\";
+            break;
+          case "r":
+            s += "\r";
+            break;
+          case "0":
+            s += "\0";
+            break;
+          default:
+            s += "\\" + e[r];
+            break;
+        }
+        r++;
+      }
+    } else if (e[r] === "%") {
+      if (r++, r >= e.length) break;
+      if (e[r] === "%") {
+        s += "%", r++;
+        continue;
+      }
+      const a = t[n++] || "";
+      switch (e[r]) {
+        case "s":
+          s += a;
+          break;
+        case "d":
+          s += String(parseInt(a, 10) || 0);
+          break;
+        case "f":
+          s += String(parseFloat(a) || 0);
+          break;
+        case "x":
+          s += (parseInt(a, 10) || 0).toString(16);
+          break;
+        case "o":
+          s += (parseInt(a, 10) || 0).toString(8);
+          break;
+        default:
+          s += "%" + e[r];
+          break;
+      }
+      r++;
+    } else
+      s += e[r], r++;
+  return s;
+}
+const c = async (e) => {
+  if (e.args.length === 0)
+    return e.stderr.write(`printf: missing format string
+`), 1;
+  const t = e.args[0], s = e.args.slice(1), n = i(t, s);
+  return e.stdout.write(n), 0;
+};
+export {
+  c as default
+};

package/dist/realpath-C-kisl-F.js

@@ -0,0 +1,24 @@
+import { r as o, V as n } from "./index-Be1wosKt.js";
+const d = async (r) => {
+  if (r.args.length === 0)
+    return r.stderr.write(`realpath: missing operand
+`), 1;
+  let s = 0;
+  for (const t of r.args) {
+    const a = o(r.cwd, t);
+    try {
+      r.vfs.stat(a), r.stdout.write(a + `
+`);
+    } catch (e) {
+      if (e instanceof n)
+        r.stderr.write(`realpath: ${t}: ${e.message}
+`), s = 1;
+      else
+        throw e;
+    }
+  }
+  return s;
+};
+export {
+  d as default
+};

package/dist/rev-9puwegeh.js

@@ -0,0 +1,34 @@
+import { r as i, V as a } from "./index-Be1wosKt.js";
+function s(r) {
+  return r.split(`
+`).map((n) => [...n].reverse().join("")).join(`
+`);
+}
+const f = async (r) => {
+  if (r.args.length === 0) {
+    if (r.stdin) {
+      const t = await r.stdin.readAll();
+      return r.stdout.write(s(t)), 0;
+    }
+    return r.stderr.write(`rev: missing operand
+`), 1;
+  }
+  let n = 0;
+  for (const t of r.args) {
+    const o = i(r.cwd, t);
+    try {
+      const e = r.vfs.readFileString(o);
+      r.stdout.write(s(e));
+    } catch (e) {
+      if (e instanceof a)
+        r.stderr.write(`rev: ${t}: ${e.message}
+`), n = 1;
+      else
+        throw e;
+    }
+  }
+  return n;
+};
+export {
+  f as default
+};

package/dist/rm-BXSq9iqP.js

@@ -0,0 +1,37 @@
+import { p as f } from "./args-CG6b9cZt.js";
+import { r as m, V as p } from "./index-Be1wosKt.js";
+const l = {
+  recursive: { type: "boolean", short: "r" },
+  Recursive: { type: "boolean", short: "R" },
+  force: { type: "boolean", short: "f" }
+}, v = async (r) => {
+  const { flags: s, positional: i } = f(r.args, l), a = s.recursive || s.Recursive, c = s.force;
+  if (i.length === 0)
+    return r.stderr.write(`rm: missing operand
+`), 1;
+  let o = 0;
+  for (const t of i) {
+    const n = m(r.cwd, t);
+    try {
+      if (r.vfs.stat(n).type === "directory") {
+        if (!a) {
+          r.stderr.write(`rm: cannot remove '${t}': Is a directory
+`), o = 1;
+          continue;
+        }
+        r.vfs.rmdirRecursive(n);
+      } else
+        r.vfs.unlink(n);
+    } catch (e) {
+      if (e instanceof p)
+        c || (r.stderr.write(`rm: ${t}: ${e.message}
+`), o = 1);
+      else
+        throw e;
+    }
+  }
+  return o;
+};
+export {
+  v as default
+};

package/dist/rmdir-CWgZ6q8D.js

@@ -0,0 +1,35 @@
+import { p } from "./args-CG6b9cZt.js";
+import { r as d, d as n, V as m } from "./index-Be1wosKt.js";
+const f = {
+  parents: { type: "boolean", short: "p" }
+}, g = async (e) => {
+  const { flags: i, positional: s } = p(e.args, f);
+  if (s.length === 0)
+    return e.stderr.write(`rmdir: missing operand
+`), 1;
+  let t = 0;
+  for (const a of s) {
+    const o = d(e.cwd, a);
+    try {
+      if (e.vfs.rmdir(o), i.parents) {
+        let r = n(o);
+        for (; r !== "/" && r !== "."; )
+          try {
+            e.vfs.rmdir(r), r = n(r);
+          } catch {
+            break;
+          }
+      }
+    } catch (r) {
+      if (r instanceof m)
+        e.stderr.write(`rmdir: ${a}: ${r.message}
+`), t = 1;
+      else
+        throw r;
+    }
+  }
+  return t;
+};
+export {
+  g as default
+};

package/dist/sandbox/HeadlessTerminal.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A Terminal-shaped class that captures output without xterm.js.
+ * Used for headless/programmatic Sandbox usage (AI agents, tests, etc.)
+ */
+export declare class HeadlessTerminal {
+    private dataCallback;
+    write(_data: string): void;
+    writeln(_data: string): void;
+    onData(cb: (data: string) => void): void;
+    get cols(): number;
+    get rows(): number;
+    focus(): void;
+    clear(): void;
+    /** Send data as if typed on keyboard (used internally for stdin) */
+    sendData(data: string): void;
+}
+//# sourceMappingURL=HeadlessTerminal.d.ts.map

package/dist/sandbox/HeadlessTerminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadlessTerminal.d.ts","sourceRoot":"","sources":["../../src/sandbox/HeadlessTerminal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAyC;IAE7D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAEb,KAAK,IAAI,IAAI;IAEb,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG7B"}

package/dist/sandbox/Sandbox.d.ts

@@ -0,0 +1,36 @@
+import { Kernel } from '../kernel/index.js';
+import { Shell } from '../shell/Shell.js';
+import { SandboxOptions, SandboxCommands, SandboxFs } from './types.js';
+export declare class Sandbox {
+    /** Programmatic command execution */
+    readonly commands: SandboxCommands;
+    /** Filesystem operations */
+    readonly fs: SandboxFs;
+    /** Environment variables */
+    readonly env: Record<string, string>;
+    readonly kernel: Kernel;
+    readonly shell: Shell;
+    private _destroyed;
+    private constructor();
+    /** Current working directory */
+    get cwd(): string;
+    set cwd(path: string);
+    /**
+     * Create a new Sandbox instance.
+     * Orchestrates all boot steps: Kernel, VFS, Registry, Shell, config sourcing.
+     */
+    static create(options?: SandboxOptions): Promise<Sandbox>;
+    /**
+     * Attach a headless sandbox to a DOM element, enabling visual mode.
+     */
+    attach(container: HTMLElement): Promise<void>;
+    /**
+     * Detach from visual mode.
+     */
+    detach(): void;
+    /**
+     * Destroy the sandbox, releasing all resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=Sandbox.d.ts.map

package/dist/sandbox/Sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sandbox.d.ts","sourceRoot":"","sources":["../../src/sandbox/Sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAY1C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK7E,qBAAa,OAAO;IAClB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO;IAcP,gCAAgC;IAChC,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,EAEnB;IAED;;;OAGG;WACU,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA6E/D;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/sandbox/SandboxCommands.d.ts

@@ -0,0 +1,18 @@
+import { Shell } from '../shell/Shell.js';
+import { CommandRegistry } from '../commands/registry.js';
+import { Command } from '../commands/types.js';
+import { SandboxCommands as ISandboxCommands, RunOptions, CommandResult } from './types.js';
+/**
+ * Wraps Shell.execute() and serializes concurrent calls.
+ * Concurrent commands.run() calls are queued (matches real shell behavior).
+ */
+export declare class SandboxCommandsImpl implements ISandboxCommands {
+    private shell;
+    private registry;
+    private queue;
+    constructor(shell: Shell, registry: CommandRegistry);
+    run(cmd: string, options?: RunOptions): Promise<CommandResult>;
+    register(name: string, handler: Command): void;
+    private executeWithOptions;
+}
+//# sourceMappingURL=SandboxCommands.d.ts.map

package/dist/sandbox/SandboxCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxCommands.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,IAAI,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjG;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAIxD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,KAAK,CAAoC;gBAGvC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,eAAe;IAGnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAe9D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;YAIhC,kBAAkB;CAqCjC"}

package/dist/sandbox/SandboxFs.d.ts

@@ -0,0 +1,38 @@
+import { VFS } from '../kernel/vfs/index.js';
+import { SandboxFs as ISandboxFs } from './types.js';
+/**
+ * Async wrapper around VFS that matches the industry-standard filesystem API.
+ * Sync VFS behind async interface future-proofs for async persistence.
+ */
+export declare class SandboxFsImpl implements ISandboxFs {
+    private vfs;
+    private getCwd;
+    constructor(vfs: VFS, getCwd: () => string);
+    private resolvePath;
+    readFile(path: string): Promise<string>;
+    readFile(path: string, encoding: null): Promise<Uint8Array>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    readdir(path: string): Promise<Array<{
+        name: string;
+        type: 'file' | 'directory';
+    }>>;
+    stat(path: string): Promise<{
+        type: 'file' | 'directory';
+        size: number;
+        mtime: number;
+    }>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rm(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    cp(src: string, dest: string): Promise<void>;
+    writeFiles(files: Array<{
+        path: string;
+        content: string | Uint8Array;
+    }>): Promise<void>;
+}
+//# sourceMappingURL=SandboxFs.d.ts.map

package/dist/sandbox/SandboxFs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxFs.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxFs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D;;;GAGG;AACH,qBAAa,aAAc,YAAW,UAAU;IAE5C,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;gBADN,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,MAAM;IAG9B,OAAO,CAAC,WAAW;IAInB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IASrD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;IAKnF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAMxF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAclE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9F"}

package/dist/sandbox/index.d.ts

@@ -0,0 +1,3 @@
+export { Sandbox } from './Sandbox.js';
+export type { SandboxOptions, RunOptions, CommandResult, SandboxCommands, SandboxFs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sandbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,eAAe,EACf,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/sandbox/types.d.ts

@@ -0,0 +1,72 @@
+import { Command } from '../commands/types.js';
+import { Kernel } from '../kernel/index.js';
+import { Shell } from '../shell/Shell.js';
+export interface SandboxOptions {
+    /** Enable IndexedDB persistence (default: false) */
+    persist?: boolean;
+    /** Extra environment variables (merged with defaults) */
+    env?: Record<string, string>;
+    /** Initial working directory (default: /home/user) */
+    cwd?: string;
+    /** Pre-populate files: path → content */
+    files?: Record<string, string | Uint8Array>;
+    /** Attach to a DOM element for visual mode (CSS selector or element) */
+    terminal?: string | HTMLElement;
+}
+export interface RunOptions {
+    /** Working directory for this command */
+    cwd?: string;
+    /** Extra environment variables for this command */
+    env?: Record<string, string>;
+    /** Abort signal to cancel the command */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Streaming stdout callback */
+    onStdout?: (data: string) => void;
+    /** Streaming stderr callback */
+    onStderr?: (data: string) => void;
+    /** Provide stdin content */
+    stdin?: string;
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface SandboxCommands {
+    run(cmd: string, options?: RunOptions): Promise<CommandResult>;
+    register(name: string, handler: Command): void;
+}
+export interface SandboxFs {
+    readFile(path: string): Promise<string>;
+    readFile(path: string, encoding: null): Promise<Uint8Array>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    readdir(path: string): Promise<Array<{
+        name: string;
+        type: 'file' | 'directory';
+    }>>;
+    stat(path: string): Promise<{
+        type: 'file' | 'directory';
+        size: number;
+        mtime: number;
+    }>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rm(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    cp(src: string, dest: string): Promise<void>;
+    writeFiles(files: Array<{
+        path: string;
+        content: string | Uint8Array;
+    }>): Promise<void>;
+}
+export interface SandboxInternals {
+    kernel: Kernel;
+    shell: Shell;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sandbox/types.d.ts.map

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