@lifo-sh/core 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,65 @@
+# @lifo-sh/core
+
+Core engine for [Lifo](https://github.com/lifo-sh/lifo) -- a Linux-like OS that runs natively in JavaScript. Provides the kernel, virtual filesystem, shell, and 60+ commands.
+
+Works in both browser and Node.js environments.
+
+## Install
+
+```bash
+npm install @lifo-sh/core
+```
+
+## Quick Start
+
+### Headless / Programmatic
+
+```typescript
+import { Sandbox } from '@lifo-sh/core';
+
+const sandbox = await Sandbox.create();
+
+const result = await sandbox.commands.run('echo hello world');
+console.log(result.stdout); // "hello world\n"
+
+await sandbox.fs.writeFile('/tmp/greeting.txt', 'Hi there');
+const content = await sandbox.fs.readFile('/tmp/greeting.txt');
+console.log(content); // "Hi there"
+```
+
+### Browser with Terminal UI
+
+```typescript
+import { Sandbox } from '@lifo-sh/core';
+
+// Requires @lifo-sh/ui as an optional peer dependency
+const sandbox = await Sandbox.create({
+  terminal: '#terminal-container',
+  persist: true,
+});
+```
+
+## What's Included
+
+- **Kernel** -- virtual filesystem (VFS), virtual `/proc` and `/dev` providers, IndexedDB persistence
+- **Shell** -- bash-like interpreter with pipes, redirects, globs, variables, job control, tab completion, history
+- **60+ commands** -- `ls`, `grep`, `awk`, `sed`, `curl`, `node`, `tar`, `find`, and more
+- **Sandbox API** -- high-level `commands.run()` and `fs.*` for programmatic use
+- **Node.js compat layer** -- run JS files with `node script.js` using shimmed `fs`, `path`, `http`, etc.
+
+## Packages
+
+| Package | Description |
+|---|---|
+| **@lifo-sh/core** | Kernel, shell, commands, sandbox API |
+| [@lifo-sh/ui](https://www.npmjs.com/package/@lifo-sh/ui) | Terminal UI (xterm.js wrapper) |
+| [lifo-sh](https://www.npmjs.com/package/lifo-sh) | CLI -- run Lifo in your terminal |
+
+## Links
+
+- [GitHub](https://github.com/lifo-sh/lifo)
+- [Issues](https://github.com/lifo-sh/lifo/issues)
+
+## License
+
+MIT

package/dist/{archive-D220So0m.js → archive-nRHWNwjH.js}

@@ -1,4 +1,4 @@
-import { r as x, d as C, c as U, f as A, h as L } from "./index-Be1wosKt.js";
+import { r as x, d as C, c as U, f as A, h as L } from "./index-DccAPaZF.js";
 const S = new Uint32Array(256);
 for (let t = 0; t < 256; t++) {
   let e = t;

package/dist/{awk-rMPdpM91.js → awk-CchAsBzt.js}

@@ -1,4 +1,4 @@
-import { r as E, V as N } from "./index-Be1wosKt.js";
+import { r as E, V as N } from "./index-DccAPaZF.js";
 function S(e) {
   const a = [];
   let t = e.trim();

package/dist/{basename-C33A_Zse.js → basename-C2v8jn7p.js}

@@ -1,4 +1,4 @@
-import { b as a } from "./index-Be1wosKt.js";
+import { b as a } from "./index-DccAPaZF.js";
 const t = async (s) => {
   if (s.args.length === 0)
     return s.stderr.write(`basename: missing operand

package/dist/{cat-Crmqa4-2.js → cat-B2exoWlk.js}

@@ -1,4 +1,4 @@
-import { r as o, V as a } from "./index-Be1wosKt.js";
+import { r as o, V as a } from "./index-DccAPaZF.js";
 const d = async (r) => {
   if (r.args.length === 0) {
     if (r.stdin) {

package/dist/{chmod-CcGyvoCX.js → chmod-CQS63aP7.js}

@@ -1,4 +1,4 @@
-import { r as u, V as l } from "./index-Be1wosKt.js";
+import { r as u, V as l } from "./index-DccAPaZF.js";
 function h(t, d) {
   if (/^[0-7]+$/.test(t))
     return parseInt(t, 8);

package/dist/{chown-CErsnGQX.js → chown-rgGwZwu9.js}

@@ -1,5 +1,5 @@
 import { p as i } from "./args-CG6b9cZt.js";
-import { r as c, V as f } from "./index-Be1wosKt.js";
+import { r as c, V as f } from "./index-DccAPaZF.js";
 const l = {
   recursive: { type: "boolean", short: "R" }
 }, d = async (s) => {

package/dist/{cp-CpjwiLUF.js → cp-C8mNek36.js}

@@ -1,4 +1,4 @@
-import { r as t, b as n, V as o } from "./index-Be1wosKt.js";
+import { r as t, b as n, V as o } from "./index-DccAPaZF.js";
 const f = async (s) => {
   if (s.args.length < 2)
     return s.stderr.write(`cp: missing operand

package/dist/{cut-GfN8py4j.js → cut-BZez9bS1.js}

@@ -1,4 +1,4 @@
-import { r as d, V as c } from "./index-Be1wosKt.js";
+import { r as d, V as c } from "./index-DccAPaZF.js";
 function u(e) {
   const r = [];
   for (const n of e.split(",")) {

package/dist/{diff-2wbVWmCT.js → diff-tWPvmikU.js}

@@ -1,5 +1,5 @@
 import { p as m } from "./args-CG6b9cZt.js";
-import { r as y, V as w } from "./index-Be1wosKt.js";
+import { r as y, V as w } from "./index-DccAPaZF.js";
 const C = {
   unified: { type: "boolean", short: "u" }
 };

package/dist/{dirname-C5L53RA2.js → dirname-BY_Gu5i2.js}

@@ -1,4 +1,4 @@
-import { d as a } from "./index-Be1wosKt.js";
+import { d as a } from "./index-DccAPaZF.js";
 const s = async (r) => {
   if (r.args.length === 0)
     return r.stderr.write(`dirname: missing operand

package/dist/{du-B0shJpEL.js → du-D25egSeK.js}

@@ -1,4 +1,4 @@
-import { r as y, V as g } from "./index-Be1wosKt.js";
+import { r as y, V as g } from "./index-DccAPaZF.js";
 function u(t) {
   return t < 1024 ? t + "B" : t < 1024 * 1024 ? (t / 1024).toFixed(1) + "K" : t < 1024 * 1024 * 1024 ? (t / (1024 * 1024)).toFixed(1) + "M" : (t / (1024 * 1024 * 1024)).toFixed(1) + "G";
 }

package/dist/{file-C2epVYvH.js → file-BPs1dqg5.js}

@@ -1,4 +1,4 @@
-import { r as d, e as c, V as f } from "./index-Be1wosKt.js";
+import { r as d, e as c, V as f } from "./index-DccAPaZF.js";
 const n = {
   ".txt": "ASCII text",
   ".md": "Markdown text",

package/dist/{find-DA-rpvsC.js → find-CRUAXbhO.js}

@@ -1,4 +1,4 @@
-import { r as m, V as d, g as p } from "./index-Be1wosKt.js";
+import { r as m, V as d, g as p } from "./index-DccAPaZF.js";
 const c = async (t) => {
   let f = ".", i = "", a = "", l = 1 / 0;
   for (let e = 0; e < t.args.length; e++) {

package/dist/{grep-Bynq2w2E.js → grep-B9pTCSNY.js}

@@ -1,4 +1,4 @@
-import { r as M, V } from "./index-Be1wosKt.js";
+import { r as M, V } from "./index-DccAPaZF.js";
 const A = async (r) => {
   const c = r.args;
   let w = !1, y = !1, b = !1, u = !1, k = !1, p = !1, m = !1, o = "";

package/dist/{gunzip-B9b1Vph1.js → gunzip-BYlJhPf7.js}

@@ -1,5 +1,5 @@
-import { r as u, V as d } from "./index-Be1wosKt.js";
-import { d as p } from "./archive-D220So0m.js";
+import { r as u, V as d } from "./index-DccAPaZF.js";
+import { d as p } from "./archive-nRHWNwjH.js";
 const w = async (e) => {
   let o = !1;
   const t = [];

package/dist/{gzip-CkXnPp5J.js → gzip-DgE-9PzE.js}

@@ -1,5 +1,5 @@
-import { r as p, V as l } from "./index-Be1wosKt.js";
-import { d as u, b as c } from "./archive-D220So0m.js";
+import { r as p, V as l } from "./index-DccAPaZF.js";
+import { d as u, b as c } from "./archive-nRHWNwjH.js";
 const g = async (e) => {
   let t = !1, d = !1;
   const o = [];

package/dist/{head-DZJVLF1k.js → head-DzP_T5Wx.js}

@@ -1,4 +1,4 @@
-import { r as d, V as f } from "./index-Be1wosKt.js";
+import { r as d, V as f } from "./index-DccAPaZF.js";
 const h = async (e) => {
   let r = 10;
   const i = [];