@andreiltd/componentize-qjs-binding-linux-x64-musl 0.3.0 → 0.4.1

package/README.md

@@ -119,6 +119,7 @@ componentize-qjs [OPTIONS] --wit <WIT> --js <JS>
 | `--wit <PATH>` | `-w` | Path to the WIT file or directory |
 | `--js <PATH>` | `-j` | Path to the JavaScript source file |
 | `--output <PATH>` | `-o` | Output path (default: `output.wasm`) |
+| `--module-root <PATH>` | | Root directory exposed read-only during Wizer for resolving JavaScript imports |
 | `--world <NAME>` | `-n` | World name when the WIT defines multiple worlds |
 | `--stub-wasi` | | Replace all WASI imports with trap stubs |
 | `--minify` | `-m` | Minify JS source before embedding |
@@ -169,6 +170,13 @@ export function doubleAdd(a, b) {
 }
 ```
 
+JavaScript modules imported by the entry file are resolved during Wizer
+initialization. Relative imports are resolved from the entry file path passed to
+`--js`; bare package imports are resolved under the read-only module root. By
+default the CLI uses the current directory when the entry file is under it, or
+the entry file's parent directory otherwise. Use `--module-root <PATH>` to expose
+a project root that contains shared files or `node_modules`.
+
 ## WIT Type Mappings
 
 ### Primitive Types
@@ -190,13 +198,33 @@ export function doubleAdd(a, b) {
 | `list<T>` | `Array` | `[1, 2, 3]` |
 | `list<u8>` | `Uint8Array` or `Array` | `new Uint8Array([1, 2, 3])` |
 | `tuple<T, U, ...>` | `Array` | `[42, "hello"]` |
-| `option<T>` | `T \| null \| undefined` | `null` for none |
-| `result<T, E>` | `{ tag: "ok"\|"err", val?: T\|E }` | `{ tag: "ok", val: 42 }` |
+| `option<T>` | `T \| null` (nested: `{ tag: "some"\|"none", val }`) | `null` for none; `option<option<T>>` is wrapped |
+| `result<T, E>` | top-level function result: return `T` or throw `E`; nested result: `{ tag: "ok"\|"err", val?: T\|E }` | `return 42` / `throw "error"` |
 | `record { ... }` | `object` (camelCase keys) | `{ myField: 1 }` |
-| `variant` | `{ tag: number, val?: T }` | `{ tag: 0, val: "hi" }` |
-| `enum` | `number` | Lookup tables provided on the interface |
-| `flags` | `number` (bitmask) | Bit constants provided on the interface |
-| `own<R>`, `borrow<R>` | `number` (handle) | Opaque resource handle |
+| `variant` | `{ tag: string, val?: T }` | `{ tag: "circle", val: 2.5 }` |
+| `enum` | `string` (case name) | `"red"` |
+| `flags` | `object` (camelCase booleans) | `{ read: true, write: false }` |
+| `own<R>`, `borrow<R>` | resource object (methods on its prototype) | `input.blockingRead(n)` |
+
+### Imported Resources
+
+Imported resources are exposed as JavaScript classes. Resource methods are
+called on the handle:
+
+```js
+import stdin from "wasi:cli/stdin@0.2.10";
+import stdout from "wasi:cli/stdout@0.2.10";
+
+const input = stdin.getStdin();     // an InputStream
+const output = stdout.getStdout();  // an OutputStream
+
+// Methods whose WIT return type is result<...> return the ok payload or throw.
+const chunk = input.blockingRead(4096);   // method on the resource (len is a number)
+output.blockingWriteAndFlush(chunk);
+```
+
+`[static]` methods are exposed on the resource class and `[constructor]` makes
+the class callable with `new`.
 
 ### Async Exports
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andreiltd/componentize-qjs-binding-linux-x64-musl",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "cpu": [
     "x64"
   ],