quickjs-emscripten-sync 1.9.0 → 1.10.0

package/README.md

@@ -402,6 +402,15 @@ Only the `set`, `deleteProperty`, and `defineProperty` operations on objects are
 
 `Date`, `Map`, `Set`, `ArrayBuffer`, and typed arrays are marshalled by value (a snapshot copy is created on the other side). They are not proxied, so later mutations are not synchronized, and self-referential `Map`/`Set` are not supported.
 
+### `this` on plain calls
+
+When an exposed host function is called plainly from the VM (`fn()`, not `obj.fn()`), the host function receives `this === undefined`. This differs from plain JavaScript, where a non-strict function called this way would see `this === globalThis`. The VM global object is intentionally **not** marshalled to the host: doing so would eagerly deep-copy the entire global graph on the first call and would leak `globalThis` across the boundary. Method calls are unaffected — `obj.fn()` still receives `obj` as `this`.
+
+```js
+arena.expose({ whoAmI() { return this; } });
+arena.evalCode(`whoAmI()`); // undefined (not globalThis)
+```
+
 ## License
 
 [MIT License](LICENSE)

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export declare class Arena {
     _map: VMMap;
     _registeredMap: VMMap;
     _registeredMapDispose: Set<any>;
+    _transientHandles: Set<QuickJSHandle>;
     _sync: Set<any>;
     _temporalSync: Set<any>;
     _symbol: symbol;
@@ -206,8 +207,11 @@ export declare class Arena {
     _registerHostRef: (t: unknown, handle: QuickJSHandle) => QuickJSHandle;
     _marshalFind: (t: unknown) => QuickJSHandle | undefined;
     _marshalPre: (t: unknown, h: QuickJSHandle | QuickJSDeferredPromise, mode: true | "json" | undefined) => Wrapped<QuickJSHandle> | undefined;
+    _registerTransient: (handle: QuickJSHandle) => void;
+    _disposeTransient: (handle: QuickJSHandle) => void;
     _marshalPreApply: (target: (...args: any[]) => any, that: unknown, args: unknown[]) => void;
     _marshal: (target: any) => [QuickJSHandle, boolean];
+    _prepareMarshalReturn: (h: QuickJSHandle) => QuickJSHandle;
     _preUnmarshal: (t: any, h: QuickJSHandle) => Wrapped<any>;
     _unmarshalFind: (h: QuickJSHandle) => unknown;
     _unmarshal: (handle: QuickJSHandle) => any;
@@ -296,8 +300,11 @@ declare type Options_2 = {
     marshalByReference?: (target: unknown) => boolean;
     registerHostRef?: (target: unknown, handle: QuickJSHandle) => QuickJSHandle;
     find: (target: unknown) => QuickJSHandle | undefined;
+    registerTransient?: (handle: QuickJSHandle) => void;
+    disposeTransient?: (handle: QuickJSHandle) => void;
     pre: (target: unknown, handle: QuickJSHandle | QuickJSDeferredPromise, mode: true | "json" | undefined) => QuickJSHandle | undefined;
     preApply?: (target: (...args: any[]) => any, thisArg: unknown, args: unknown[]) => any;
+    prepareReturn?: (handle: QuickJSHandle) => QuickJSHandle;
     custom?: Iterable<(obj: unknown, ctx: QuickJSContext) => QuickJSHandle | undefined>;
 };