@ecmaos/kernel 0.2.1 → 0.2.3

package/README.md

@@ -8,26 +8,30 @@
 
 [ecmaOS](https://ecmaos.sh) is a [browser-based operating system kernel](https://global.discourse-cdn.com/spiceworks/original/4X/8/7/b/87b7be8e7e2cd932affe5449dba69dc16e30d721.gif) and suite of applications written primarily in TypeScript, AssemblyScript, and C++. It's the successor of [web3os](https://github.com/web3os-org/kernel).
 
-The goal is to create a kernel and supporting apps that tie together modern web technologies and utilities to form an "operating system" that can run on modern browsers, not just to create a "desktop experience". Its main use case is to provide a consistent environment for running web apps, but it has features that allow for more powerful custom scenarios. The kernel could also be repurposed as a platform for custom applications, games, and more.
+The goal is to create a kernel and supporting apps that tie together modern web technologies and utilities to form an "operating system" that can run on modern browsers, not just to create a "desktop experience". It offers the ability to run a wide variety of apps on top of an already (mostly) sandboxed foundation, offering some measure of security by default as well as rich developer tooling. Its main use case is to provide a consistent environment for running web apps, but it has features that allow for more powerful custom scenarios, such as a platform for custom applications, games, and more.
+
+---
 
 > *"The computer can be used as a tool to liberate and protect people, rather than to control them."*
 > — Hal Finney
 
-[![API Reference](https://img.shields.io/badge/API-Reference-success)](https://docs.ecmaos.sh)
 [![Version](https://img.shields.io/github/package-json/v/ecmaos/ecmaos?color=success)](https://www.npmjs.com/package/@ecmaos/kernel)
 [![Site Status](https://img.shields.io/website?url=https%3A%2F%2Fecmaos.sh)](https://ecmaos.sh)
 [![Created](https://img.shields.io/github/created-at/ecmaos/ecmaos?style=flat&label=created&color=success)](https://github.com/ecmaos/ecmaos/pulse)
 [![Last Commit](https://img.shields.io/github/last-commit/ecmaos/ecmaos.svg)](https://github.com/ecmaos/ecmaos/commit/main)
+[![API Reference](https://img.shields.io/badge/API-Reference-success)](https://docs.ecmaos.sh)
+[![GitHub license](https://img.shields.io/badge/license-MIT+Apache2.0-success)](https://github.com/ecmaos/ecmaos/blob/main/LICENSE)
 
-[![Open issues](https://img.shields.io/github/issues/ecmaos/ecmaos.svg)](https://github.com/ecmaos/ecmaos/issues)
-[![Closed issues](https://img.shields.io/github/issues-closed/ecmaos/ecmaos.svg)](https://github.com/ecmaos/ecmaos/issues?q=is%3Aissue+is%3Aclosed)
-[![Open PRs](https://img.shields.io/github/issues-pr-raw/ecmaos/ecmaos.svg?label=PRs)](https://github.com/ecmaos/ecmaos/pulls)
-[![Closed PRs](https://img.shields.io/github/issues-pr-closed/ecmaos/ecmaos.svg?label=PRs)](https://github.com/ecmaos/ecmaos/pulls?q=is%3Apr+is%3Aclosed)
+[![Open issues](https://img.shields.io/github/issues/ecmaos/ecmaos.svg?logo=github)](https://github.com/ecmaos/ecmaos/issues)
+[![Closed issues](https://img.shields.io/github/issues-closed/ecmaos/ecmaos.svg?logo=github)](https://github.com/ecmaos/ecmaos/issues?q=is%3Aissue+is%3Aclosed)
+[![Open PRs](https://img.shields.io/github/issues-pr-raw/ecmaos/ecmaos.svg?logo=github&label=PRs)](https://github.com/ecmaos/ecmaos/pulls)
+[![Closed PRs](https://img.shields.io/github/issues-pr-closed/ecmaos/ecmaos.svg?logo=github&label=PRs)](https://github.com/ecmaos/ecmaos/pulls?q=is%3Apr+is%3Aclosed)
 
-[![Star on GitHub](https://img.shields.io/github/stars/ecmaos/ecmaos?style=flat&logo=github&label=⭐️)](https://github.com/ecmaos/ecmaos/stargazers)
-[![Sponsors](https://img.shields.io/github/sponsors/mathiscode?color=red)](https://github.com/sponsors/mathiscode)
-[![Contributors](https://img.shields.io/github/contributors/ecmaos/ecmaos?color=yellow)](https://github.com/ecmaos/ecmaos/graphs/contributors)
-[![GitHub license](https://img.shields.io/badge/license-MIT+Apache2.0-blue)](https://github.com/ecmaos/ecmaos/blob/main/LICENSE)
+[![Star on GitHub](https://img.shields.io/github/stars/ecmaos/ecmaos?style=flat&logo=github&label=⭐️%20stars)](https://github.com/ecmaos/ecmaos/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/ecmaos/ecmaos?style=flat&logo=github&label=🔀%20forks)](https://github.com/ecmaos/ecmaos/forks)
+[![GitHub watchers](https://img.shields.io/github/watchers/ecmaos/ecmaos?style=flat&logo=github&label=👀%20watchers)](https://github.com/ecmaos/ecmaos/watchers)
+[![Sponsors](https://img.shields.io/github/sponsors/mathiscode?color=red&logo=github&label=💖%20sponsors)](https://github.com/sponsors/mathiscode)
+[![Contributors](https://img.shields.io/github/contributors/ecmaos/ecmaos?color=yellow&logo=github&label=👥%20contributors)](https://github.com/ecmaos/ecmaos/graphs/contributors)
 
 [![Discord](https://img.shields.io/discord/1311804229127508081?label=discord&logo=discord&logoColor=white)](https://discord.gg/ZJYGkbVsCh)
 [![Matrix](https://img.shields.io/matrix/ecmaos:matrix.org.svg?label=%23ecmaos%3Amatrix.org&logo=matrix&logoColor=white)](https://matrix.to/#/#ecmaos:matrix.org)
@@ -36,7 +40,7 @@ The goal is to create a kernel and supporting apps that tie together modern web
 
 ## Features
 
-- TypeScript, WebAssembly, AssemblyScript, C++
+- TypeScript, WebAssembly, AssemblyScript, Rust, C++
 - Filesystem supporting multiple backends powered by [zenfs](https://github.com/zen-fs/core)
 - Terminal interface powered by [xterm.js](https://xtermjs.org)
 - Pseudo-streams, allowing redirection and piping
@@ -51,6 +55,7 @@ The goal is to create a kernel and supporting apps that tie together modern web
 - Internationalization framework for translating text powered by [i18next](https://www.i18next.com)
 - Window manager powered by [WinBox](https://github.com/nextapps-de/winbox)
 - `BIOS`: A C++ module compiled to WebAssembly with [Emscripten](https://emscripten.org) providing performance-critical functionality
+- `Jaffa`: A [Tauri](https://tauri.app) app for running ecmaOS in a desktop or mobile environment
 - `Metal`: An API server for allowing connections to physical systems from ecmaOS using [Hono](https://hono.dev)
 - `SWAPI`: An API server running completely inside a service worker using [Hono](https://hono.dev)
 
@@ -62,7 +67,7 @@ The goal is to create a kernel and supporting apps that tie together modern web
   - Its default export (or exported `main` function) will be called with the `ProcessEntryParams` object
   - They can be installed from the terminal using the `install` command, e.g. `# install @ecmaos-apps/boilerplate`
   - Run the installed app: `# /usr/bin/boilerplate arg1 arg2` *(absolute path not required)*
-  - During development, it can be useful to run a [Verdaccio](https://github.com/verdaccio/verdaccio) server to test local packages: `# install @myscope/mypackage --registry http://localhost:4873`
+  - During development, it can be useful to run a [Verdaccio](https://github.com/verdaccio/verdaccio) server to test local packages
   - To publish to Verdaccio, run `# npm publish --registry http://localhost:4873` in your app's development environment
   - Then to install from your local registry, run `# install @myscope/mypackage --registry http://localhost:4873`
 
@@ -74,18 +79,22 @@ The goal is to create a kernel and supporting apps that tie together modern web
 
 - `Core`
   - Core modules provide the system's essential functionality; this includes the kernel itself
-  - Other core modules include Metal, SWAPI, BIOS, as well as the main `@ecmaos/types` package
+  - Other core modules include BIOS, Jaffa, Metal, SWAPI, as well as the main `@ecmaos/types` package
 
 - `Commands`
   - Commands are small utilities that aren't quite full Apps, provided by the shell
   - Some builtin commands that exist now will be moved into separate apps over time
 
 - `Devices`
-  - Devices get loaded on boot, e.g. /dev/bluetooth, /dev/random, /dev/battery, etc.
+  - Devices get loaded on boot, e.g. `/dev/bluetooth`, `/dev/random`, `/dev/battery`, etc.
   - A device can support being "run" by a user, e.g. `# /dev/battery status`
-  - Devices may also be directly read/written, and will behave accordingly (or have no effect)
+  - Devices may also be directly read/written using `fs` methods, and will behave accordingly (or have no effect if not supported)
   - An individual device module can provide multiple device drivers, e.g. `/dev/usb` provides `/dev/usb-mydevice-0001-0002`
 
+- `Jaffa`
+  - Jaffa is a [Tauri](https://tauri.app) wrapper for the ecmaOS kernel
+  - It's used to tie the kernel into a desktop or mobile environment, allowing for native functionality
+
 - `Kernel`
   - Authentication (WebAuthn)
   - Components (Web Components/Custom Elements)

package/dist/.vite/manifest.json

@@ -1,18 +1,18 @@
 {
-  "_browser-Bg2k_w8R.js": {
-    "file": "browser-Bg2k_w8R.js",
+  "_browser-jvtvvRnm.js": {
+    "file": "browser-jvtvvRnm.js",
     "name": "browser",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-DV8na5Rc.js"
+      "_empty-D1k8eaRb.js"
     ]
   },
-  "_empty-DV8na5Rc.js": {
-    "file": "empty-DV8na5Rc.js",
+  "_empty-D1k8eaRb.js": {
+    "file": "empty-D1k8eaRb.js",
     "name": "empty",
     "dynamicImports": [
-      "_topbar.min-cv6_CM7b.js",
-      "_browser-Bg2k_w8R.js",
+      "_topbar.min-qHiqBD75.js",
+      "_browser-jvtvvRnm.js",
       "src/tree/lib/commands/install.ts",
       "node_modules/.pnpm/figlet@1.8.0/node_modules/figlet/importable-fonts/Poison.js"
     ]
@@ -21,12 +21,12 @@
     "file": "kernel.css",
     "src": "_kernel.css"
   },
-  "_topbar.min-cv6_CM7b.js": {
-    "file": "topbar.min-cv6_CM7b.js",
+  "_topbar.min-qHiqBD75.js": {
+    "file": "topbar.min-qHiqBD75.js",
     "name": "topbar.min",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-DV8na5Rc.js"
+      "_empty-D1k8eaRb.js"
     ]
   },
   "node_modules/.pnpm/figlet@1.8.0/node_modules/figlet/importable-fonts/Poison.js": {
@@ -41,16 +41,16 @@
     "src": "src/tree/kernel.ts",
     "isEntry": true,
     "imports": [
-      "_empty-DV8na5Rc.js"
+      "_empty-D1k8eaRb.js"
     ]
   },
   "src/tree/lib/commands/install.ts": {
-    "file": "install-BIXZ5bsq.js",
+    "file": "install-DvXm00-p.js",
     "name": "install",
     "src": "src/tree/lib/commands/install.ts",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-DV8na5Rc.js"
+      "_empty-D1k8eaRb.js"
     ]
   },
   "src/ui.ts": {
@@ -59,7 +59,7 @@
     "src": "src/ui.ts",
     "isEntry": true,
     "imports": [
-      "_empty-DV8na5Rc.js"
+      "_empty-D1k8eaRb.js"
     ]
   }
 }

package/dist/{browser-Bg2k_w8R.js → browser-jvtvvRnm.js}

@@ -1,4 +1,4 @@
-import { g as getDefaultExportFromCjs } from "./empty-DV8na5Rc.js";
+import { g as getDefaultExportFromCjs } from "./empty-D1k8eaRb.js";
 var browser$2;
 var hasRequiredBrowser;
 function requireBrowser() {
@@ -20,4 +20,4 @@ const browser$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePro
 export {
   browser$1 as b
 };
-//# sourceMappingURL=browser-Bg2k_w8R.js.map
+//# sourceMappingURL=browser-jvtvvRnm.js.map

package/dist/{browser-Bg2k_w8R.js.map → browser-jvtvvRnm.js.map}

@@ -1 +1 @@
-{"version":3,"file":"browser-Bg2k_w8R.js","sources":["../node_modules/.pnpm/ws@8.18.0/node_modules/ws/browser.js"],"sourcesContent":["'use strict';\n\nmodule.exports = function () {\n  throw new Error(\n    'ws does not work in the browser. Browser clients must use the native ' +\n      'WebSocket object'\n  );\n};\n"],"names":["browser"],"mappings":";;;;;;AAEAA,cAAiB,WAAY;AAC3B,UAAM,IAAI;AAAA,MACR;AAAA,IAED;AAAA,EACF;;;;;;;;;","x_google_ignoreList":[0]}
+{"version":3,"file":"browser-jvtvvRnm.js","sources":["../node_modules/.pnpm/ws@8.18.0/node_modules/ws/browser.js"],"sourcesContent":["'use strict';\n\nmodule.exports = function () {\n  throw new Error(\n    'ws does not work in the browser. Browser clients must use the native ' +\n      'WebSocket object'\n  );\n};\n"],"names":["browser"],"mappings":";;;;;;AAEAA,cAAiB,WAAY;AAC3B,UAAM,IAAI;AAAA,MACR;AAAA,IAED;AAAA,EACF;;;;;;;;;","x_google_ignoreList":[0]}

package/dist/{empty-DV8na5Rc.js → empty-D1k8eaRb.js}

@@ -22009,7 +22009,7 @@ class Dom {
   }
   async topbar(show) {
     if (!this._topbar) return;
-    const { default: topbar } = await import("./topbar.min-cv6_CM7b.js").then((n) => n.t);
+    const { default: topbar } = await import("./topbar.min-qHiqBD75.js").then((n) => n.t);
     this._topbarShow = show ?? !this._topbarShow;
     if (this._topbarShow) topbar.show();
     else topbar.hide();
@@ -27121,7 +27121,7 @@ class Filesystem {
     return this._fs.constants;
   }
   /**
-   * @returns {ZenFS.credentials} The filesystem credentials.
+   * @returns The filesystem credentials.
    */
   get credentials() {
     return credentials;
@@ -50609,7 +50609,7 @@ async function createSimpleWebSocket(url) {
     case "node": {
       let WebSocket2;
       try {
-        WebSocket2 = (await import("./browser-Bg2k_w8R.js").then((n) => n.b)).default;
+        WebSocket2 = (await import("./browser-jvtvvRnm.js").then((n) => n.b)).default;
       } catch (error) {
         try {
           WebSocket2 = __require("ws");
@@ -67521,7 +67521,7 @@ const TerminalCommands = (kernel, shell, terminal) => {
         { name: "registry", type: String, description: "The registry to use", defaultValue: "https://registry.npmjs.org" }
       ],
       run: async (argv) => {
-        const { default: install } = await import("./install-BIXZ5bsq.js");
+        const { default: install } = await import("./install-DvXm00-p.js");
         return await install({ kernel, shell, terminal, args: [argv.package, argv.registry] });
       }
     }),
@@ -72187,7 +72187,10 @@ instance.setDefaultNamespace;
 instance.hasLoadedNamespace;
 instance.loadNamespaces;
 instance.loadLanguages;
-const resources = {};
+const en = { "common": {}, "kernel": { "kernel": { "madeBy": "Made with ❤️  by", "panic": "Uh oh, kernel panic! Check the logs for more details.", "permissionNotificationDenied": "Notification permission denied", "modules": { "blacklisted": "Skipping blacklisted module {{module}}" } } } };
+const resources = {
+  "en": en
+};
 const DefaultI18nOptions = {
   resources,
   lng: "en",
@@ -80483,7 +80486,7 @@ var createBIOS = (() => {
     return moduleRtn;
   };
 })();
-const __vite_import_meta_env__ = { "AUTHOR": { "name": "Jay Mathis", "email": "code@mathis.network", "url": "https://github.com/mathiscode" }, "BASE_URL": "/", "DESCRIPTION": "ecmaOS: Micro-kernel and framework for web technologies", "DEV": false, "HOMEPAGE": "https://ecmaos.sh", "KNOWN_ISSUES": ["Don't expect any sort of POSIX compliance at this stage", "Most commands/devices are very basic implementations, not complete reproductions", "stdin/stdout/stderr streams and redirection can be wonky and don't work everywhere, but are coming along", "Lots of unfinished work; watch your step"], "MODE": "production", "NAME": "@ecmaos/kernel", "PROD": true, "REPOSITORY": "https://github.com/ecmaos/ecmaos", "SSR": false, "TIPS": ["You can 'run' some devices that offer a CLI - for example, '/dev/battery --help'"], "VERSION": "0.2.0", "VITE_APP_SHOW_DEFAULT_LOGIN": "true", "VITE_AUTOLOGIN_PASSWORD": "root", "VITE_AUTOLOGIN_USERNAME": "root", "VITE_KERNEL_INTERVALS_PROC": "1000", "VITE_KERNEL_MODULES": "http://localhost:3000/build/release.js", "VITE_METAL_SOCKET": "ws://localhost:30445/socket", "VITE_PORT": "30443" };
+const __vite_import_meta_env__ = { "AUTHOR": { "name": "Jay Mathis", "email": "code@mathis.network", "url": "https://github.com/mathiscode" }, "BASE_URL": "/", "DESCRIPTION": "ecmaOS: Micro-kernel and framework for web technologies", "DEV": false, "HOMEPAGE": "https://ecmaos.sh", "KNOWN_ISSUES": ["Don't expect any sort of POSIX compliance at this stage", "Most commands/devices are very basic implementations, not complete reproductions", "stdin/stdout/stderr streams and redirection can be wonky and don't work everywhere, but are coming along", "Lots of unfinished work; watch your step"], "MODE": "production", "NAME": "@ecmaos/kernel", "PROD": true, "REPOSITORY": "https://github.com/ecmaos/ecmaos", "SSR": false, "TIPS": ["You can 'run' some devices that offer a CLI - for example, '/dev/battery --help'"], "VERSION": "0.2.2", "VITE_APP_SHOW_DEFAULT_LOGIN": "true", "VITE_AUTOLOGIN_PASSWORD": "root", "VITE_AUTOLOGIN_USERNAME": "root", "VITE_KERNEL_INTERVALS_PROC": "1000", "VITE_KERNEL_MODULES": "http://localhost:3000/build/release.js", "VITE_METAL_SOCKET": "ws://localhost:30445/socket", "VITE_PORT": "30443" };
 var define_import_meta_env_AUTHOR_default = { name: "Jay Mathis", email: "code@mathis.network", url: "https://github.com/mathiscode" };
 var define_import_meta_env_KNOWN_ISSUES_default = ["Don't expect any sort of POSIX compliance at this stage", "Most commands/devices are very basic implementations, not complete reproductions", "stdin/stdout/stderr streams and redirection can be wonky and don't work everywhere, but are coming along", "Lots of unfinished work; watch your step"];
 var define_import_meta_env_TIPS_default = ["You can 'run' some devices that offer a CLI - for example, '/dev/battery --help'"];
@@ -80527,7 +80530,7 @@ class Kernel {
     /** Name of the kernel */
     __publicField(this, "name", "@ecmaos/kernel");
     /** Version string of the kernel */
-    __publicField(this, "version", "0.2.0");
+    __publicField(this, "version", "0.2.2");
     /** Authentication and authorization service */
     __publicField(this, "auth");
     /** BIOS module providing low-level functionality */
@@ -80681,7 +80684,7 @@ class Kernel {
         } catch (error) {
           this.log?.error(`Failed to load figlet font ${figletFont}: ${error.message}`);
         }
-        this.terminal.writeln(`${this.terminal.createSpecialLink("https://ecmaos.sh", "@ecmaos/kernel")} v${"0.2.0"}`);
+        this.terminal.writeln(`${this.terminal.createSpecialLink("https://ecmaos.sh", "@ecmaos/kernel")} v${"0.2.2"}`);
         this.terminal.writeln(`${t2("kernel.madeBy")} ${this.terminal.createSpecialLink(
           define_import_meta_env_AUTHOR_default?.url || "https://github.com/mathiscode",
           `${define_import_meta_env_AUTHOR_default?.name} <${define_import_meta_env_AUTHOR_default?.email}>`
@@ -80700,13 +80703,13 @@ class Kernel {
         spinner.start();
         if (logoFiglet) console.log(`%c${logoFiglet}`, "color: green");
         console.log(`%c${"https://github.com/ecmaos/ecmaos"}`, "color: blue; text-decoration: underline; font-size: 16px");
-        this.log.info(`${"@ecmaos/kernel"} v${"0.2.0"}`);
+        this.log.info(`${"@ecmaos/kernel"} v${"0.2.2"}`);
         if (Notification?.permission === "default") Notification.requestPermission();
         if (Notification?.permission === "denied") this.log?.warn(t2("kernel.permissionNotificationDenied"));
         this.intervals.set("title-blink", () => {
           globalThis.document.title = globalThis.document.title.includes("_") ? "ecmaos# " : "ecmaos# _";
         }, 600);
-        this.toast.success(`${"@ecmaos/kernel"} v${"0.2.0"}`);
+        this.toast.success(`${"@ecmaos/kernel"} v${"0.2.2"}`);
       }
       await this.configure({ filesystem: Filesystem.options() });
       const requiredPaths = [
@@ -80904,6 +80907,7 @@ class Kernel {
    */
   async execute(options) {
     try {
+      const terminal = options.terminal || this.terminal;
       if (!await this.filesystem.exists(options.command)) {
         this.log?.error(`File not found for execution: ${options.command}`);
         return -1;
@@ -80941,7 +80945,6 @@ class Kernel {
       exitCode = exitCode ?? 0;
       options.shell.env.set("?", exitCode.toString());
       this.events.dispatch(KernelEvents.EXECUTE, { command: options.command, args: options.args, exitCode });
-      const terminal = options.terminal || this.terminal;
       if (header.type !== "bin" || header.namespace !== "app") terminal.write(ansi$5.erase.inLine(2) + terminal.prompt());
       return exitCode;
     } catch (error) {
@@ -81044,14 +81047,16 @@ class Kernel {
     });
     try {
       shell.setPositionalParameters([`/dev/${device.pkg.name}`, ...args]);
-      return await deviceProcess.start();
+      await deviceProcess.start();
     } catch (error) {
       this.log?.error(error);
       this.terminal.writeln(chalk$1.red(error.message));
       return -2;
     } finally {
       deviceProcess = null;
+      this.terminal.write(ansi$5.erase.inLine(2) + this.terminal.prompt());
     }
+    return 0;
   }
   /**
    * Executes a node script (or tries to)
@@ -81295,7 +81300,7 @@ class Kernel {
       memory: "?",
       platform: navigator.userAgentData?.platform || navigator?.platform || navigator.userAgent,
       querystring: location.search,
-      version: `${"@ecmaos/kernel"} ${"0.2.0"}`,
+      version: `${"@ecmaos/kernel"} ${"0.2.2"}`,
       language: navigator.language,
       host: location.host,
       userAgent: navigator.userAgent,
@@ -81366,4 +81371,4 @@ export {
   getDefaultExportFromCjs$2 as g,
   process$1$1 as p
 };
-//# sourceMappingURL=empty-DV8na5Rc.js.map
+//# sourceMappingURL=empty-D1k8eaRb.js.map