@ecmaos/kernel 0.2.3 → 0.2.4

package/README.md

@@ -91,31 +91,37 @@ The goal is to create a kernel and supporting apps that tie together modern web
   - 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-jvtvvRnm.js": {
-    "file": "browser-jvtvvRnm.js",
+  "_browser-CoSyrw7Q.js": {
+    "file": "browser-CoSyrw7Q.js",
     "name": "browser",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-D1k8eaRb.js"
+      "_empty-DAF3BgdH.js"
     ]
   },
-  "_empty-D1k8eaRb.js": {
-    "file": "empty-D1k8eaRb.js",
+  "_empty-DAF3BgdH.js": {
+    "file": "empty-DAF3BgdH.js",
     "name": "empty",
     "dynamicImports": [
-      "_topbar.min-qHiqBD75.js",
-      "_browser-jvtvvRnm.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-qHiqBD75.js": {
-    "file": "topbar.min-qHiqBD75.js",
+  "_topbar.min-CYYqkupv.js": {
+    "file": "topbar.min-CYYqkupv.js",
     "name": "topbar.min",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-D1k8eaRb.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-D1k8eaRb.js"
+      "_empty-DAF3BgdH.js"
     ]
   },
   "src/tree/lib/commands/install.ts": {
-    "file": "install-DvXm00-p.js",
+    "file": "install--B0gJ8Dk.js",
     "name": "install",
     "src": "src/tree/lib/commands/install.ts",
     "isDynamicEntry": true,
     "imports": [
-      "_empty-D1k8eaRb.js"
+      "_empty-DAF3BgdH.js"
     ]
   },
   "src/ui.ts": {
@@ -59,7 +59,7 @@
     "src": "src/ui.ts",
     "isEntry": true,
     "imports": [
-      "_empty-D1k8eaRb.js"
+      "_empty-DAF3BgdH.js"
     ]
   }
 }

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

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

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

@@ -1 +1 @@
-{"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]}
+{"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]}