@ecmaos/kernel 0.2.2 → 0.2.4

package/README.md

@@ -8,7 +8,7 @@
 
 [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". It offers the ability to run a wide variety of apps on top of a (mostly) sandboxed foundation, offering some measure of security by default. 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.
 
 ---
 
@@ -28,7 +28,7 @@ The goal is to create a kernel and supporting apps that tie together modern web
 [![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=⭐️%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/network)
+[![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)
@@ -67,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`
 
@@ -86,36 +86,42 @@ The goal is to create a kernel and supporting apps that tie together modern web
   - 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`
 
+- `Generators`
+  - Generators are used to scaffold new apps, devices, modules, etc.
+  - They are located in the `turbo/generators` directory of the repository
+  - They are used by the `turbo gen` command, e.g. `turbo gen app`, `turbo gen device`, `turbo gen module`, etc.
+
 - `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)
-  - Devices
-  - DOM
-  - Events (CustomEvents)
-  - Filesystem (ZenFS)
-  - Internationalization (i18next)
-  - Interval Manager (setInterval)
-  - Log Manager (tslog)
-  - Memory Manager (Abstractions)
-  - Process Manager
-  - Protocol Handlers (web+ecmaos://...)
-  - Service Worker Manager
-  - Shell
-  - Storage (IndexedDB, localStorage, sessionStorage, etc.)
-  - Terminal (xterm.js)
-  - User Manager
-  - WASM Loader
-  - Window Manager (WinBox)
-  - Workers (Web Workers)
+  - The kernel ties together the various components of the system into a cohesive whole
+    - Authentication (WebAuthn)
+    - Components (Web Components/Custom Elements)
+    - Devices
+    - DOM
+    - Events (CustomEvents)
+    - Filesystem (ZenFS)
+    - Internationalization (i18next)
+    - Interval Manager (setInterval)
+    - Log Manager (tslog)
+    - Memory Manager (Abstractions)
+    - Process Manager
+    - Protocol Handlers (web+ecmaos://...)
+    - Service Worker Manager
+    - Shell
+    - Storage (IndexedDB, localStorage, sessionStorage, etc.)
+    - Terminal (xterm.js)
+    - User Manager
+    - WASM Loader
+    - Window Manager (WinBox)
+    - Workers (Web Workers)
 
 - `Metal`
   - Metal is an API server for allowing connections to physical systems from ecmaOS using [Hono](https://hono.dev)
@@ -123,21 +129,27 @@ The goal is to create a kernel and supporting apps that tie together modern web
 
 - `Modules`
   - Modules are dynamically loaded into the kernel at boot and can be enabled or disabled
+  - They are specified during build via the `VITE_KERNEL_MODULES` environment variable
+    - e.g. `VITE_KERNEL_MODULES=@ecmaos-modules/sample@0.1.2,@your/package@1.2.3`
+  - Versions must be exact and are mandatory - you cannot use NPM version specifiers
   - They can provide additional functionality, devices, commands, etc.
   - They offer a [common interface](./core/types/modules.ts) for interacting with the kernel
   - Generally they should be written in [AssemblyScript](https://www.assemblyscript.org), but this isn't required
 
 - `Packages`
-  - Packages are [npm packages](https://www.npmjs.com) that are installed into the ecmaOS environment
+  - Packages are [NPM packages](https://www.npmjs.com) that are installed into the ecmaOS environment
   - They can be installed from the terminal using the `install` command, e.g. `# install jquery`
   - NPM version specifiers are supported, e.g.:
     - `# install jquery@3.7.1`
     - `# install jquery@^3.7.1`
     - `# install jquery@latest`
-  - [JSR](https://jsr.io) support is coming soon
+  - [JSR](https://jsr.io) may be used with the [NPM compatibility layer](https://jsr.io/docs/npm-compatibility):
+    - `# install @jsr/defaude__hello-jsr --registry https://npm.jsr.io`
 
 - `SWAPI`
   - The SWAPI is an API server running completely inside a service worker using [Hono](https://hono.dev)
+  - It allows for various operations including the `fs` route to fetch files via URL
+  - e.g., `# fetch /swapi/fs/home/user/hello.txt`
   - e.g., `# fetch /swapi/fake/person/fullName`
 
 - `Utils`
@@ -159,8 +171,10 @@ edit hello.txt
 env hello --set world ; env
 fetch https://ipecho.net/plain > /tmp/myip.txt
 fetch /xkcd-os.sixel # xterm.js includes sixel support
+fetch /swapi/fs/home/user/hello.txt # fetch a file from the filesystem
 fetch /swapi/fake/person/fullName # fetch a random person from the SWAPI
 install jquery
+install @ecmaos-apps/boilerplate
 ls /dev
 mkdir /tmp/zip ; cd /tmp/zip
 upload

package/dist/.vite/manifest.json

@@ -1,18 +1,18 @@
 {
-  "_browser-CH-1j4CC.js": {
-    "file": "browser-CH-1j4CC.js",
+  "_browser-CoSyrw7Q.js": {
+    "file": "browser-CoSyrw7Q.js",
     "name": "browser",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-C_utvVBb.js"
+      "_empty-DAF3BgdH.js"
     ]
   },
-  "_empty-C_utvVBb.js": {
-    "file": "empty-C_utvVBb.js",
+  "_empty-DAF3BgdH.js": {
+    "file": "empty-DAF3BgdH.js",
     "name": "empty",
     "dynamicImports": [
-      "_topbar.min-DTxqjRf-.js",
-      "_browser-CH-1j4CC.js",
+      "_topbar.min-CYYqkupv.js",
+      "_browser-CoSyrw7Q.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-DTxqjRf-.js": {
-    "file": "topbar.min-DTxqjRf-.js",
+  "_topbar.min-CYYqkupv.js": {
+    "file": "topbar.min-CYYqkupv.js",
     "name": "topbar.min",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-C_utvVBb.js"
+      "_empty-DAF3BgdH.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-C_utvVBb.js"
+      "_empty-DAF3BgdH.js"
     ]
   },
   "src/tree/lib/commands/install.ts": {
-    "file": "install-vMOoUe2p.js",
+    "file": "install--B0gJ8Dk.js",
     "name": "install",
     "src": "src/tree/lib/commands/install.ts",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-C_utvVBb.js"
+      "_empty-DAF3BgdH.js"
     ]
   },
   "src/ui.ts": {
@@ -59,7 +59,7 @@
     "src": "src/ui.ts",
     "isEntry": true,
     "imports": [
-      "_empty-C_utvVBb.js"
+      "_empty-DAF3BgdH.js"
     ]
   }
 }

package/dist/{browser-CH-1j4CC.js → browser-CoSyrw7Q.js}

@@ -1,4 +1,4 @@
-import { g as getDefaultExportFromCjs } from "./empty-C_utvVBb.js";
+import { g as getDefaultExportFromCjs } from "./empty-DAF3BgdH.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-CH-1j4CC.js.map
+//# sourceMappingURL=browser-CoSyrw7Q.js.map

package/dist/{browser-CH-1j4CC.js.map → browser-CoSyrw7Q.js.map}

@@ -1 +1 @@
-{"version":3,"file":"browser-CH-1j4CC.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-CoSyrw7Q.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]}