jseption 0.0.0-stage → 0.0.2

package/dist/dump.js

@@ -0,0 +1,124 @@
+/*
+ * Bytecode disassembler (port of dump_byte_code in quickjs.c), used for
+ * debugging and by the `qjs -d` option.
+ */
+import { JSFunctionBytecode, JS_AtomGetStr } from "./quickjs.js";
+import { short_opcode_info, get_u8, get_i8, get_u16, get_i16, get_u32, get_i32 } from "./opcodes.js";
+export function dump_byte_code(ctx, b) {
+    const buf = b.byte_code_buf;
+    const len = b.byte_code_len;
+    let out = '';
+    const name = b.func_name ? JS_AtomGetStr(ctx, b.func_name) : '<anonymous>';
+    out += `function ${name}: args=${b.arg_count} vars=${b.var_count} stack=${b.stack_size} closure_vars=${b.closure_var.length} cpool=${b.cpool.length}\n`;
+    for (let i = 0; i < b.closure_var.length; i++) {
+        const cv = b.closure_var[i];
+        out += `  closure_var[${i}]: ${JS_AtomGetStr(ctx, cv.var_name)} ${cv.is_local ? 'local' : 'parent'} ${cv.is_arg ? 'arg' : 'var'} idx=${cv.var_idx}\n`;
+    }
+    for (let i = 0; i < b.vardefs.length; i++) {
+        const vd = b.vardefs[i];
+        out += `  ${i < b.arg_count ? 'arg' : 'var'}[${i < b.arg_count ? i : i - b.arg_count}]: ${JS_AtomGetStr(ctx, vd.var_name)} scope=${vd.scope_level}${vd.is_lexical ? ' lexical' : ''}${vd.is_const ? ' const' : ''}\n`;
+    }
+    let pos = 0;
+    while (pos < len) {
+        const op = buf[pos];
+        const oi = short_opcode_info(op);
+        if (!oi) {
+            out += `${pos}: invalid opcode ${op}\n`;
+            break;
+        }
+        let line = `${String(pos).padStart(5)}: ${oi.name}`;
+        const p = pos + 1;
+        switch (oi.fmt) {
+            case 1 /* OpFmt.none_int */:
+                line += ` ${op - 183 /* OP.push_0 */}`;
+                break;
+            case 2 /* OpFmt.none_loc */:
+                line += ` ${(op - 199 /* OP.get_loc0 */) % 4}`;
+                break;
+            case 3 /* OpFmt.none_arg */:
+                line += ` ${(op - 211 /* OP.get_arg0 */) % 4}`;
+                break;
+            case 4 /* OpFmt.none_var_ref */:
+                line += ` ${(op - 223 /* OP.get_var_ref0 */) % 4}`;
+                break;
+            case 5 /* OpFmt.u8 */:
+            case 7 /* OpFmt.loc8 */:
+            case 8 /* OpFmt.const8 */:
+                line += ` ${get_u8(buf, p)}`;
+                break;
+            case 6 /* OpFmt.i8 */:
+                line += ` ${get_i8(buf, p)}`;
+                break;
+            case 9 /* OpFmt.label8 */:
+                line += ` ${pos + 1 + get_i8(buf, p)}`;
+                break;
+            case 10 /* OpFmt.u16 */:
+            case 13 /* OpFmt.npop */:
+            case 16 /* OpFmt.loc */:
+            case 17 /* OpFmt.arg */:
+            case 18 /* OpFmt.var_ref */:
+                line += ` ${get_u16(buf, p)}`;
+                break;
+            case 14 /* OpFmt.npopx */:
+                line += ` ${op - 240 /* OP.call0 */}`;
+                break;
+            case 11 /* OpFmt.i16 */:
+                line += ` ${get_i16(buf, p)}`;
+                break;
+            case 12 /* OpFmt.label16 */:
+                line += ` ${pos + 1 + get_i16(buf, p)}`;
+                break;
+            case 15 /* OpFmt.npop_u16 */:
+                line += ` ${get_u16(buf, p)},${get_u16(buf, p + 2)}`;
+                break;
+            case 19 /* OpFmt.u32 */:
+                line += ` ${get_u32(buf, p)}`;
+                break;
+            case 20 /* OpFmt.i32 */:
+                line += ` ${get_i32(buf, p)}`;
+                break;
+            case 21 /* OpFmt.const */: {
+                const c = b.cpool[get_u32(buf, p)];
+                line += ` ${get_u32(buf, p)} (${fmt_const(ctx, c)})`;
+                break;
+            }
+            case 22 /* OpFmt.label */:
+                line += ` ${pos + 1 + get_i32(buf, p)}`;
+                break;
+            case 23 /* OpFmt.atom */:
+                line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))}`;
+                break;
+            case 24 /* OpFmt.atom_u8 */:
+                line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${get_u8(buf, p + 4)}`;
+                break;
+            case 25 /* OpFmt.atom_u16 */:
+                line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${get_u16(buf, p + 4)}`;
+                break;
+            case 26 /* OpFmt.atom_label_u8 */:
+                line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${pos + 5 + get_i32(buf, p + 4)},${get_u8(buf, p + 8)}`;
+                break;
+            case 27 /* OpFmt.atom_label_u16 */:
+                line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${pos + 5 + get_i32(buf, p + 4)},${get_u16(buf, p + 8)}`;
+                break;
+            case 28 /* OpFmt.label_u16 */:
+                line += ` ${pos + 1 + get_i32(buf, p)},${get_u16(buf, p + 4)}`;
+                break;
+            default: break;
+        }
+        out += line + '\n';
+        pos += oi.size;
+    }
+    for (const c of b.cpool) {
+        if (c instanceof JSFunctionBytecode)
+            out += '\n' + dump_byte_code(ctx, c);
+    }
+    return out;
+}
+function fmt_const(ctx, c) {
+    if (c instanceof JSFunctionBytecode)
+        return 'function ' + (c.func_name ? JS_AtomGetStr(ctx, c.func_name) : '');
+    if (typeof c === 'string')
+        return JSON.stringify(c);
+    return String(c);
+}
+//# sourceMappingURL=dump.js.map

package/dist/dump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump.js","sourceRoot":"","sources":["../src/dump.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAa,kBAAkB,EAAE,aAAa,EAAW,MAAM,cAAc,CAAC;AACrF,OAAO,EAAa,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEhH,MAAM,UAAU,cAAc,CAAC,GAAc,EAAE,CAAqB;IAClE,MAAM,GAAG,GAAG,CAAC,CAAC,aAAa,CAAC;IAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,aAAa,CAAC;IAC5B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IAC3E,GAAG,IAAI,YAAY,IAAI,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,UAAU,iBAAiB,CAAC,CAAC,WAAW,CAAC,MAAM,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC;IACxJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5B,GAAG,IAAI,iBAAiB,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC,OAAO,IAAI,CAAC;IACxJ,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,aAAa,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IACxN,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,GAAG,GAAG,EAAE,CAAC;QACjB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,MAAM,EAAE,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,EAAE,CAAC;YAAC,GAAG,IAAI,GAAG,GAAG,oBAAoB,EAAE,IAAI,CAAC;YAAC,MAAM;QAAC,CAAC;QAC5D,IAAI,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;YACf;gBAAqB,IAAI,IAAI,IAAI,EAAE,sBAAY,EAAE,CAAC;gBAAC,MAAM;YACzD;gBAAqB,IAAI,IAAI,IAAI,CAAC,EAAE,wBAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,MAAM;YACjE;gBAAqB,IAAI,IAAI,IAAI,CAAC,EAAE,wBAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,MAAM;YACjE;gBAAyB,IAAI,IAAI,IAAI,CAAC,EAAE,4BAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,MAAM;YACzE,sBAAc;YAAC,wBAAgB;YAAC;gBAAmB,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACvF;gBAAe,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACnD;gBAAmB,IAAI,IAAI,IAAI,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACjE,wBAAe;YAAC,yBAAgB;YAAC,wBAAe;YAAC,wBAAe;YAAC;gBAAoB,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YAC1H;gBAAkB,IAAI,IAAI,IAAI,EAAE,qBAAW,EAAE,CAAC;gBAAC,MAAM;YACrD;gBAAgB,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACrD;gBAAoB,IAAI,IAAI,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACnE;gBAAqB,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACjF;gBAAgB,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACrD;gBAAgB,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACrD,yBAAgB,CAAC,CAAC,CAAC;gBAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBAAC,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;gBAAC,MAAM;YAAC,CAAC;YACtH;gBAAkB,IAAI,IAAI,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACjE;gBAAiB,IAAI,IAAI,IAAI,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YAC1E;gBAAoB,IAAI,IAAI,IAAI,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACnG;gBAAqB,IAAI,IAAI,IAAI,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YACrG;gBAA0B,IAAI,IAAI,IAAI,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YAC1I;gBAA2B,IAAI,IAAI,IAAI,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YAC5I;gBAAsB,IAAI,IAAI,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM;YAC5F,OAAO,CAAC,CAAC,MAAM;QACjB,CAAC;QACD,GAAG,IAAI,IAAI,GAAG,IAAI,CAAC;QACnB,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;IACjB,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,YAAY,kBAAkB;YAAE,GAAG,IAAI,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,GAAc,EAAE,CAA+B;IAChE,IAAI,CAAC,YAAY,kBAAkB;QAAE,OAAO,WAAW,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/G,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC","sourcesContent":["/*\n * Bytecode disassembler (port of dump_byte_code in quickjs.c), used for\n * debugging and by the `qjs -d` option.\n */\nimport { JSContext, JSFunctionBytecode, JS_AtomGetStr, JSValue } from './quickjs.ts';\nimport { OP, OpFmt, short_opcode_info, get_u8, get_i8, get_u16, get_i16, get_u32, get_i32 } from './opcodes.ts';\n\nexport function dump_byte_code(ctx: JSContext, b: JSFunctionBytecode): string {\n  const buf = b.byte_code_buf;\n  const len = b.byte_code_len;\n  let out = '';\n  const name = b.func_name ? JS_AtomGetStr(ctx, b.func_name) : '<anonymous>';\n  out += `function ${name}: args=${b.arg_count} vars=${b.var_count} stack=${b.stack_size} closure_vars=${b.closure_var.length} cpool=${b.cpool.length}\\n`;\n  for (let i = 0; i < b.closure_var.length; i++) {\n    const cv = b.closure_var[i];\n    out += `  closure_var[${i}]: ${JS_AtomGetStr(ctx, cv.var_name)} ${cv.is_local ? 'local' : 'parent'} ${cv.is_arg ? 'arg' : 'var'} idx=${cv.var_idx}\\n`;\n  }\n  for (let i = 0; i < b.vardefs.length; i++) {\n    const vd = b.vardefs[i];\n    out += `  ${i < b.arg_count ? 'arg' : 'var'}[${i < b.arg_count ? i : i - b.arg_count}]: ${JS_AtomGetStr(ctx, vd.var_name)} scope=${vd.scope_level}${vd.is_lexical ? ' lexical' : ''}${vd.is_const ? ' const' : ''}\\n`;\n  }\n  let pos = 0;\n  while (pos < len) {\n    const op = buf[pos];\n    const oi = short_opcode_info(op);\n    if (!oi) { out += `${pos}: invalid opcode ${op}\\n`; break; }\n    let line = `${String(pos).padStart(5)}: ${oi.name}`;\n    const p = pos + 1;\n    switch (oi.fmt) {\n      case OpFmt.none_int: line += ` ${op - OP.push_0}`; break;\n      case OpFmt.none_loc: line += ` ${(op - OP.get_loc0) % 4}`; break;\n      case OpFmt.none_arg: line += ` ${(op - OP.get_arg0) % 4}`; break;\n      case OpFmt.none_var_ref: line += ` ${(op - OP.get_var_ref0) % 4}`; break;\n      case OpFmt.u8: case OpFmt.loc8: case OpFmt.const8: line += ` ${get_u8(buf, p)}`; break;\n      case OpFmt.i8: line += ` ${get_i8(buf, p)}`; break;\n      case OpFmt.label8: line += ` ${pos + 1 + get_i8(buf, p)}`; break;\n      case OpFmt.u16: case OpFmt.npop: case OpFmt.loc: case OpFmt.arg: case OpFmt.var_ref: line += ` ${get_u16(buf, p)}`; break;\n      case OpFmt.npopx: line += ` ${op - OP.call0}`; break;\n      case OpFmt.i16: line += ` ${get_i16(buf, p)}`; break;\n      case OpFmt.label16: line += ` ${pos + 1 + get_i16(buf, p)}`; break;\n      case OpFmt.npop_u16: line += ` ${get_u16(buf, p)},${get_u16(buf, p + 2)}`; break;\n      case OpFmt.u32: line += ` ${get_u32(buf, p)}`; break;\n      case OpFmt.i32: line += ` ${get_i32(buf, p)}`; break;\n      case OpFmt.const: { const c = b.cpool[get_u32(buf, p)]; line += ` ${get_u32(buf, p)} (${fmt_const(ctx, c)})`; break; }\n      case OpFmt.label: line += ` ${pos + 1 + get_i32(buf, p)}`; break;\n      case OpFmt.atom: line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))}`; break;\n      case OpFmt.atom_u8: line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${get_u8(buf, p + 4)}`; break;\n      case OpFmt.atom_u16: line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${get_u16(buf, p + 4)}`; break;\n      case OpFmt.atom_label_u8: line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${pos + 5 + get_i32(buf, p + 4)},${get_u8(buf, p + 8)}`; break;\n      case OpFmt.atom_label_u16: line += ` ${JS_AtomGetStr(ctx, get_u32(buf, p))},${pos + 5 + get_i32(buf, p + 4)},${get_u16(buf, p + 8)}`; break;\n      case OpFmt.label_u16: line += ` ${pos + 1 + get_i32(buf, p)},${get_u16(buf, p + 4)}`; break;\n      default: break;\n    }\n    out += line + '\\n';\n    pos += oi.size;\n  }\n  for (const c of b.cpool) {\n    if (c instanceof JSFunctionBytecode) out += '\\n' + dump_byte_code(ctx, c);\n  }\n  return out;\n}\n\nfunction fmt_const(ctx: JSContext, c: JSValue | JSFunctionBytecode): string {\n  if (c instanceof JSFunctionBytecode) return 'function ' + (c.func_name ? JS_AtomGetStr(ctx, c.func_name) : '');\n  if (typeof c === 'string') return JSON.stringify(c);\n  return String(c);\n}\n"]}

package/dist/embed.d.ts

@@ -0,0 +1,18 @@
+import { JSContext, JSValue } from './quickjs.ts';
+export interface ToGuestOptions {
+    /** convert a host value the default rules reject (class instances); return
+     *  undefined to fall through to the TypeError */
+    custom?: (ctx: JSContext, value: object) => JSValue | undefined;
+    /** deep-convert the arguments guest code passes to a wrapped host function
+     *  into plain host values (default: pass the guest values through) */
+    convertArgs?: boolean;
+}
+export declare function isGuestValue(v: unknown): boolean;
+export declare function drainJobs(ctx: JSContext): void;
+export declare function guestErrorToHost(ctx: JSContext, exc: JSValue): Error;
+export declare function toGuest(ctx: JSContext, value: unknown, opts?: ToGuestOptions): JSValue;
+export declare function hostFunction(ctx: JSContext, fn: (...args: any[]) => unknown, name?: string, length?: number, opts?: ToGuestOptions): JSValue;
+export declare function hostPromise(ctx: JSContext, p: PromiseLike<unknown>, opts?: ToGuestOptions): JSValue;
+export declare function expose(ctx: JSContext, name: string, value: unknown, opts?: ToGuestOptions): void;
+export declare function fromGuest(ctx: JSContext, value: JSValue): unknown;
+export declare function guestPromiseToHost(ctx: JSContext, promise: JSValue): Promise<unknown>;

package/dist/embed.js

@@ -0,0 +1,286 @@
+/* Embedding helpers: moving values between the host and the guest.
+ *
+ * Guest values are host values, but the sandbox requires that nothing the
+ * guest can reach has a host intrinsic in its prototype chain. A host
+ * object therefore cannot be handed to the guest as is: `toGuest` copies
+ * plain data into guest objects, wraps host functions in guest functions,
+ * and bridges host promises to guest promises. `fromGuest` does the
+ * reverse so the host gets ordinary host objects (and can call guest
+ * functions / await guest promises). Primitives cross unchanged. */
+import { JS_IsException, JS_IsObject, JS_GetClassID, JS_GetAnyOpaque, JS_NewObject, JS_NewArrayFrom, JS_NewCFunction, JS_Call, JS_CallConstructor, JS_Throw, JS_GetException, JS_GetPropertyStr, JS_SetPropertyStr, JS_ToString, JS_NewErrorNative, JS_ExecutePendingJob, JS_IsJobPending, js_meta, } from "./quickjs.js";
+import { JS_NewPromiseCapability } from "./builtins/promise.js";
+import { JS_NewDate } from "./builtins/date.js";
+import { JS_NewArrayBufferCopy } from "./builtins/typedarray.js";
+const HOST_INTRINSIC_PROTOS = new Set([
+    Object.prototype, Array.prototype, Function.prototype, Error.prototype, Date.prototype, RegExp.prototype,
+    Map.prototype, Set.prototype, Promise.prototype, ArrayBuffer.prototype,
+    Object.getPrototypeOf(Uint8Array.prototype),
+]);
+/* true if the value is already safe to hand to the guest: engine metadata or
+   a prototype chain that never reaches a host intrinsic */
+export function isGuestValue(v) {
+    if (typeof v === 'function' || (typeof v === 'object' && v !== null)) {
+        if (js_meta.has(v))
+            return true;
+        let p = v;
+        while (p !== null) {
+            if (HOST_INTRINSIC_PROTOS.has(p) || p === globalThis)
+                return false;
+            p = Object.getPrototypeOf(p);
+        }
+        return true;
+    }
+    return true;
+}
+/* run the guest job queue (promise reactions) until it is empty */
+export function drainJobs(ctx) {
+    const rt = ctx.rt;
+    const pctx = { ctx: null };
+    while (JS_IsJobPending(rt))
+        JS_ExecutePendingJob(rt, pctx);
+}
+function guestCtor(ctx, name) {
+    return JS_GetPropertyStr(ctx, ctx.global_obj, name);
+}
+function throwGuestException(ctx) {
+    throw guestErrorToHost(ctx, JS_GetException(ctx));
+}
+/* convert a guest exception value into a host Error for host callers */
+export function guestErrorToHost(ctx, exc) {
+    if (JS_IsObject(exc) && JS_GetClassID(exc) === 3 /* JSClassID.ERROR */) {
+        const o = exc;
+        const err = new Error(String(o.message ?? ''));
+        err.name = String(o.name ?? 'Error');
+        if (typeof o.stack === 'string')
+            err.guestStack = o.stack;
+        return err;
+    }
+    const err = new Error(typeof exc === 'string' ? exc : String(JS_ToString(ctx, exc)));
+    err.guestValue = exc;
+    return err;
+}
+const ERROR_KINDS = {
+    EvalError: 0 /* JSErrorEnum.EVAL_ERROR */, RangeError: 1 /* JSErrorEnum.RANGE_ERROR */, ReferenceError: 2 /* JSErrorEnum.REFERENCE_ERROR */,
+    SyntaxError: 3 /* JSErrorEnum.SYNTAX_ERROR */, TypeError: 4 /* JSErrorEnum.TYPE_ERROR */, URIError: 5 /* JSErrorEnum.URI_ERROR */,
+};
+/* host value -> guest value */
+export function toGuest(ctx, value, opts = {}) {
+    return toGuestRec(ctx, value, opts, new Map());
+}
+function toGuestRec(ctx, v, opts, seen) {
+    switch (typeof v) {
+        case 'undefined':
+        case 'boolean':
+        case 'number':
+        case 'string':
+        case 'bigint':
+        case 'symbol':
+            return v;
+        case 'function':
+            if (isGuestValue(v))
+                return v;
+            return hostFunction(ctx, v, v.name, v.length, opts);
+    }
+    if (v === null)
+        return null;
+    const o = v;
+    if (isGuestValue(o))
+        return o;
+    const cached = seen.get(o);
+    if (cached !== undefined)
+        return cached;
+    const remember = (g) => { seen.set(o, g); return g; };
+    if (typeof o.then === 'function')
+        return remember(hostPromise(ctx, o, opts));
+    if (Array.isArray(o)) {
+        const arr = JS_NewArrayFrom(ctx, []);
+        seen.set(o, arr);
+        for (let i = 0; i < o.length; i++)
+            arr[i] = toGuestRec(ctx, o[i], opts, seen);
+        return arr;
+    }
+    if (o instanceof Date)
+        return remember(JS_NewDate(ctx, o.getTime()));
+    if (o instanceof RegExp)
+        return remember(construct(ctx, 'RegExp', [o.source, o.flags]));
+    if (o instanceof Error) {
+        const kind = ERROR_KINDS[o.name] ?? 8 /* JSErrorEnum.PLAIN_ERROR */;
+        const err = JS_NewErrorNative(ctx, kind, String(o.message));
+        return remember(err);
+    }
+    if (o instanceof Map) {
+        const m = construct(ctx, 'Map', []);
+        seen.set(o, m);
+        for (const [k, val] of o)
+            m.set(toGuestRec(ctx, k, opts, seen), toGuestRec(ctx, val, opts, seen));
+        return m;
+    }
+    if (o instanceof Set) {
+        const s = construct(ctx, 'Set', []);
+        seen.set(o, s);
+        for (const val of o)
+            s.add(toGuestRec(ctx, val, opts, seen));
+        return s;
+    }
+    if (o instanceof ArrayBuffer)
+        return remember(JS_NewArrayBufferCopy(ctx, new Uint8Array(o)));
+    if (ArrayBuffer.isView(o)) {
+        const buf = JS_NewArrayBufferCopy(ctx, new Uint8Array(o.buffer, o.byteOffset, o.byteLength));
+        const name = o[Symbol.toStringTag]; /* "Uint8Array", "DataView", ... */
+        return remember(construct(ctx, name, [buf]));
+    }
+    const proto = Object.getPrototypeOf(o);
+    if (proto === Object.prototype || proto === null) {
+        const g = JS_NewObject(ctx);
+        seen.set(o, g);
+        for (const k of Reflect.ownKeys(o)) {
+            const d = Reflect.getOwnPropertyDescriptor(o, k);
+            if (!d.enumerable)
+                continue;
+            g[k] = toGuestRec(ctx, o[k], opts, seen);
+        }
+        return g;
+    }
+    if (opts.custom) {
+        const r = opts.custom(ctx, o);
+        if (r !== undefined)
+            return remember(r);
+    }
+    throw new TypeError(`toGuest: cannot pass a host ${proto?.constructor?.name ?? 'object'} to the guest; ` +
+        'pass plain data, functions, promises, or provide a custom converter');
+}
+function construct(ctx, ctorName, args) {
+    const r = JS_CallConstructor(ctx, guestCtor(ctx, ctorName), args);
+    if (JS_IsException(r))
+        throwGuestException(ctx);
+    return r;
+}
+/* a guest function that calls the host function. Host exceptions become
+   guest errors; host return values (including promises) are converted. */
+export function hostFunction(ctx, fn, name = fn.name || 'hostFunction', length = fn.length, opts = {}) {
+    return JS_NewCFunction(ctx, (ctx2, this_val, argv) => {
+        try {
+            const args = opts.convertArgs ? argv.map(a => fromGuest(ctx2, a)) : argv;
+            const self = opts.convertArgs ? fromGuest(ctx2, this_val) : this_val;
+            return toGuest(ctx2, fn.apply(self, args), opts);
+        }
+        catch (e) {
+            return JS_Throw(ctx2, toGuest(ctx2, e, opts));
+        }
+    }, name, length);
+}
+/* a guest promise that settles when the host promise does; guest jobs are
+   run after the settlement so `await` continuations execute promptly */
+export function hostPromise(ctx, p, opts = {}) {
+    const funcs = [undefined, undefined];
+    const promise = JS_NewPromiseCapability(ctx, funcs);
+    if (JS_IsException(promise))
+        throwGuestException(ctx);
+    const settle = (fn, v) => {
+        let g;
+        try {
+            g = toGuest(ctx, v, opts);
+        }
+        catch (e) {
+            fn = funcs[1];
+            g = toGuest(ctx, e, opts);
+        }
+        JS_Call(ctx, fn, undefined, [g]);
+        drainJobs(ctx);
+    };
+    p.then(v => settle(funcs[0], v), e => settle(funcs[1], e));
+    return promise;
+}
+/* define a global variable in the guest */
+export function expose(ctx, name, value, opts = {}) {
+    if (JS_SetPropertyStr(ctx, ctx.global_obj, name, toGuest(ctx, value, opts)) < 0)
+        throwGuestException(ctx);
+}
+/* guest value -> plain host value: objects and arrays are copied, guest
+   functions become host functions (that call into the guest), guest
+   promises become host promises, errors become host Errors */
+export function fromGuest(ctx, value) {
+    return fromGuestRec(ctx, value, new Map());
+}
+function fromGuestRec(ctx, v, seen) {
+    if (typeof v === 'function') {
+        return (...args) => {
+            const r = JS_Call(ctx, v, undefined, args.map(a => toGuest(ctx, a)));
+            if (JS_IsException(r))
+                throwGuestException(ctx);
+            return fromGuest(ctx, r);
+        };
+    }
+    if (typeof v !== 'object' || v === null)
+        return v;
+    const cached = seen.get(v);
+    if (cached !== undefined)
+        return cached;
+    const o = v;
+    switch (JS_GetClassID(v)) {
+        case 45 /* JSClassID.PROMISE */:
+            return guestPromiseToHost(ctx, v);
+        case 10 /* JSClassID.DATE */:
+            return new Date(JS_GetAnyOpaque(v));
+        case 3 /* JSClassID.ERROR */:
+            return guestErrorToHost(ctx, v);
+        case 18 /* JSClassID.REGEXP */:
+            return new RegExp(o.source, o.flags);
+        case 34 /* JSClassID.MAP */: {
+            const m = new Map();
+            seen.set(v, m);
+            for (const [k, val] of Map.prototype.entries.call(o))
+                m.set(fromGuestRec(ctx, k, seen), fromGuestRec(ctx, val, seen));
+            return m;
+        }
+        case 35 /* JSClassID.SET */: {
+            const s = new Set();
+            seen.set(v, s);
+            for (const val of Set.prototype.values.call(o))
+                s.add(fromGuestRec(ctx, val, seen));
+            return s;
+        }
+        case 19 /* JSClassID.ARRAY_BUFFER */:
+            /* the guest object is the host ArrayBuffer re-prototyped: copy it */
+            return new Uint8Array(o).slice().buffer;
+    }
+    if (ArrayBuffer.isView(o)) {
+        /* guest typed arrays are host views re-prototyped: copy with the host constructor */
+        const Ctor = globalThis[o[Symbol.toStringTag]];
+        return Ctor ? new Ctor(o) : new Uint8Array(o);
+    }
+    if (Array.isArray(o)) {
+        const a = [];
+        seen.set(v, a);
+        for (let i = 0; i < o.length; i++)
+            a[i] = fromGuestRec(ctx, o[i], seen);
+        return a;
+    }
+    const r = {};
+    seen.set(v, r);
+    for (const k of Reflect.ownKeys(o)) {
+        const d = Reflect.getOwnPropertyDescriptor(o, k);
+        if (!d.enumerable)
+            continue;
+        r[k] = fromGuestRec(ctx, o[k], seen);
+    }
+    return r;
+}
+/* a host promise that settles when the guest promise does */
+export function guestPromiseToHost(ctx, promise) {
+    return new Promise((resolve, reject) => {
+        const then = JS_GetPropertyStr(ctx, promise, 'then');
+        const onFul = JS_NewCFunction(ctx, (_c, _t, argv) => { resolve(fromGuest(ctx, argv[0])); return undefined; }, 'resolve', 1);
+        const onRej = JS_NewCFunction(ctx, (_c, _t, argv) => { reject(fromGuestRejection(ctx, argv[0])); return undefined; }, 'reject', 1);
+        const r = JS_Call(ctx, then, promise, [onFul, onRej]);
+        if (JS_IsException(r))
+            reject(guestErrorToHost(ctx, JS_GetException(ctx)));
+        drainJobs(ctx);
+    });
+}
+function fromGuestRejection(ctx, reason) {
+    if (JS_IsObject(reason) && JS_GetClassID(reason) === 3 /* JSClassID.ERROR */)
+        return guestErrorToHost(ctx, reason);
+    return fromGuest(ctx, reason);
+}
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"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","sourcesContent":["/* Embedding helpers: moving values between the host and the guest.\n *\n * Guest values are host values, but the sandbox requires that nothing the\n * guest can reach has a host intrinsic in its prototype chain. A host\n * object therefore cannot be handed to the guest as is: `toGuest` copies\n * plain data into guest objects, wraps host functions in guest functions,\n * and bridges host promises to guest promises. `fromGuest` does the\n * reverse so the host gets ordinary host objects (and can call guest\n * functions / await guest promises). Primitives cross unchanged. */\n\nimport {\n  JSContext, JSValue, JSClassID, JS_IsException, JS_IsObject, JS_GetClassID, JS_GetAnyOpaque,\n  JS_NewObject, JS_NewArrayFrom, JS_NewCFunction, JS_Call, JS_CallConstructor, JS_Throw,\n  JS_GetException, JS_GetPropertyStr, JS_SetPropertyStr, JS_ToString, JS_NewErrorNative,\n  JS_ExecutePendingJob, JS_IsJobPending, js_meta,\n} from './quickjs.ts';\nimport { JSErrorEnum } from './values.ts';\nimport { JS_NewPromiseCapability } from './builtins/promise.ts';\nimport { JS_NewDate } from './builtins/date.ts';\nimport { JS_NewArrayBufferCopy } from './builtins/typedarray.ts';\n\nexport interface ToGuestOptions {\n  /** convert a host value the default rules reject (class instances); return\n   *  undefined to fall through to the TypeError */\n  custom?: (ctx: JSContext, value: object) => JSValue | undefined;\n  /** deep-convert the arguments guest code passes to a wrapped host function\n   *  into plain host values (default: pass the guest values through) */\n  convertArgs?: boolean;\n}\n\nconst HOST_INTRINSIC_PROTOS = new Set<object>([\n  Object.prototype, Array.prototype, Function.prototype, Error.prototype, Date.prototype, RegExp.prototype,\n  Map.prototype, Set.prototype, Promise.prototype, ArrayBuffer.prototype,\n  Object.getPrototypeOf(Uint8Array.prototype),\n]);\n\n/* true if the value is already safe to hand to the guest: engine metadata or\n   a prototype chain that never reaches a host intrinsic */\nexport function isGuestValue(v: unknown): boolean {\n  if (typeof v === 'function' || (typeof v === 'object' && v !== null)) {\n    if (js_meta.has(v as object)) return true;\n    let p: object | null = v as object;\n    while (p !== null) {\n      if (HOST_INTRINSIC_PROTOS.has(p) || p === globalThis) return false;\n      p = Object.getPrototypeOf(p);\n    }\n    return true;\n  }\n  return true;\n}\n\n/* run the guest job queue (promise reactions) until it is empty */\nexport function drainJobs(ctx: JSContext): void {\n  const rt = ctx.rt;\n  const pctx = { ctx: null as JSContext | null };\n  while (JS_IsJobPending(rt)) JS_ExecutePendingJob(rt, pctx);\n}\n\nfunction guestCtor(ctx: JSContext, name: string): JSValue {\n  return JS_GetPropertyStr(ctx, ctx.global_obj, name);\n}\n\nfunction throwGuestException(ctx: JSContext): never {\n  throw guestErrorToHost(ctx, JS_GetException(ctx));\n}\n\n/* convert a guest exception value into a host Error for host callers */\nexport function guestErrorToHost(ctx: JSContext, exc: JSValue): Error {\n  if (JS_IsObject(exc) && JS_GetClassID(exc) === JSClassID.ERROR) {\n    const o = exc as any;\n    const err = new Error(String(o.message ?? ''));\n    err.name = String(o.name ?? 'Error');\n    if (typeof o.stack === 'string') (err as any).guestStack = o.stack;\n    return err;\n  }\n  const err = new Error(typeof exc === 'string' ? exc : String(JS_ToString(ctx, exc)));\n  (err as any).guestValue = exc;\n  return err;\n}\n\nconst ERROR_KINDS: Record<string, JSErrorEnum> = {\n  EvalError: JSErrorEnum.EVAL_ERROR, RangeError: JSErrorEnum.RANGE_ERROR, ReferenceError: JSErrorEnum.REFERENCE_ERROR,\n  SyntaxError: JSErrorEnum.SYNTAX_ERROR, TypeError: JSErrorEnum.TYPE_ERROR, URIError: JSErrorEnum.URI_ERROR,\n};\n\n/* host value -> guest value */\nexport function toGuest(ctx: JSContext, value: unknown, opts: ToGuestOptions = {}): JSValue {\n  return toGuestRec(ctx, value, opts, new Map());\n}\n\nfunction toGuestRec(ctx: JSContext, v: unknown, opts: ToGuestOptions, seen: Map<object, JSValue>): JSValue {\n  switch (typeof v) {\n    case 'undefined': case 'boolean': case 'number': case 'string': case 'bigint': case 'symbol':\n      return v as JSValue;\n    case 'function':\n      if (isGuestValue(v)) return v as JSValue;\n      return hostFunction(ctx, v as (...args: any[]) => unknown, (v as Function).name, (v as Function).length, opts);\n  }\n  if (v === null) return null;\n  const o = v as any;\n  if (isGuestValue(o)) return o;\n  const cached = seen.get(o);\n  if (cached !== undefined) return cached;\n  const remember = (g: JSValue): JSValue => { seen.set(o, g); return g; };\n\n  if (typeof o.then === 'function') return remember(hostPromise(ctx, o, opts));\n  if (Array.isArray(o)) {\n    const arr = JS_NewArrayFrom(ctx, []) as any;\n    seen.set(o, arr);\n    for (let i = 0; i < o.length; i++) arr[i] = toGuestRec(ctx, o[i], opts, seen);\n    return arr;\n  }\n  if (o instanceof Date) return remember(JS_NewDate(ctx, o.getTime()));\n  if (o instanceof RegExp) return remember(construct(ctx, 'RegExp', [o.source, o.flags]));\n  if (o instanceof Error) {\n    const kind = ERROR_KINDS[o.name] ?? JSErrorEnum.PLAIN_ERROR;\n    const err = JS_NewErrorNative(ctx, kind, String(o.message));\n    return remember(err);\n  }\n  if (o instanceof Map) {\n    const m = construct(ctx, 'Map', []) as any;\n    seen.set(o, m);\n    for (const [k, val] of o) m.set(toGuestRec(ctx, k, opts, seen), toGuestRec(ctx, val, opts, seen));\n    return m;\n  }\n  if (o instanceof Set) {\n    const s = construct(ctx, 'Set', []) as any;\n    seen.set(o, s);\n    for (const val of o) s.add(toGuestRec(ctx, val, opts, seen));\n    return s;\n  }\n  if (o instanceof ArrayBuffer) return remember(JS_NewArrayBufferCopy(ctx, new Uint8Array(o)));\n  if (ArrayBuffer.isView(o)) {\n    const buf = JS_NewArrayBufferCopy(ctx, new Uint8Array(o.buffer, o.byteOffset, o.byteLength));\n    const name = (o as any)[Symbol.toStringTag] as string; /* \"Uint8Array\", \"DataView\", ... */\n    return remember(construct(ctx, name, [buf]));\n  }\n  const proto = Object.getPrototypeOf(o);\n  if (proto === Object.prototype || proto === null) {\n    const g = JS_NewObject(ctx) as any;\n    seen.set(o, g);\n    for (const k of Reflect.ownKeys(o)) {\n      const d = Reflect.getOwnPropertyDescriptor(o, k)!;\n      if (!d.enumerable) continue;\n      g[k] = toGuestRec(ctx, o[k], opts, seen);\n    }\n    return g;\n  }\n  if (opts.custom) {\n    const r = opts.custom(ctx, o);\n    if (r !== undefined) return remember(r);\n  }\n  throw new TypeError(`toGuest: cannot pass a host ${proto?.constructor?.name ?? 'object'} to the guest; ` +\n    'pass plain data, functions, promises, or provide a custom converter');\n}\n\nfunction construct(ctx: JSContext, ctorName: string, args: unknown[]): JSValue {\n  const r = JS_CallConstructor(ctx, guestCtor(ctx, ctorName), args as JSValue[]);\n  if (JS_IsException(r)) throwGuestException(ctx);\n  return r;\n}\n\n/* a guest function that calls the host function. Host exceptions become\n   guest errors; host return values (including promises) are converted. */\nexport function hostFunction(ctx: JSContext, fn: (...args: any[]) => unknown, name = fn.name || 'hostFunction',\n                             length = fn.length, opts: ToGuestOptions = {}): JSValue {\n  return JS_NewCFunction(ctx, (ctx2: JSContext, this_val: JSValue, argv: JSValue[]) => {\n    try {\n      const args = opts.convertArgs ? argv.map(a => fromGuest(ctx2, a)) : argv;\n      const self = opts.convertArgs ? fromGuest(ctx2, this_val) : this_val;\n      return toGuest(ctx2, fn.apply(self, args), opts);\n    } catch (e) {\n      return JS_Throw(ctx2, toGuest(ctx2, e, opts));\n    }\n  }, name, length);\n}\n\n/* a guest promise that settles when the host promise does; guest jobs are\n   run after the settlement so `await` continuations execute promptly */\nexport function hostPromise(ctx: JSContext, p: PromiseLike<unknown>, opts: ToGuestOptions = {}): JSValue {\n  const funcs: [JSValue, JSValue] = [undefined, undefined];\n  const promise = JS_NewPromiseCapability(ctx, funcs);\n  if (JS_IsException(promise)) throwGuestException(ctx);\n  const settle = (fn: JSValue, v: unknown) => {\n    let g: JSValue;\n    try { g = toGuest(ctx, v, opts); } catch (e) { fn = funcs[1]; g = toGuest(ctx, e, opts); }\n    JS_Call(ctx, fn, undefined, [g]);\n    drainJobs(ctx);\n  };\n  p.then(v => settle(funcs[0], v), e => settle(funcs[1], e));\n  return promise;\n}\n\n/* define a global variable in the guest */\nexport function expose(ctx: JSContext, name: string, value: unknown, opts: ToGuestOptions = {}): void {\n  if (JS_SetPropertyStr(ctx, ctx.global_obj, name, toGuest(ctx, value, opts)) < 0) throwGuestException(ctx);\n}\n\n/* guest value -> plain host value: objects and arrays are copied, guest\n   functions become host functions (that call into the guest), guest\n   promises become host promises, errors become host Errors */\nexport function fromGuest(ctx: JSContext, value: JSValue): unknown {\n  return fromGuestRec(ctx, value, new Map());\n}\n\nfunction fromGuestRec(ctx: JSContext, v: JSValue, seen: Map<object, unknown>): unknown {\n  if (typeof v === 'function') {\n    return (...args: unknown[]) => {\n      const r = JS_Call(ctx, v, undefined, args.map(a => toGuest(ctx, a)));\n      if (JS_IsException(r)) throwGuestException(ctx);\n      return fromGuest(ctx, r);\n    };\n  }\n  if (typeof v !== 'object' || v === null) return v;\n  const cached = seen.get(v);\n  if (cached !== undefined) return cached;\n  const o = v as any;\n  switch (JS_GetClassID(v)) {\n    case JSClassID.PROMISE:\n      return guestPromiseToHost(ctx, v);\n    case JSClassID.DATE:\n      return new Date(JS_GetAnyOpaque(v) as number);\n    case JSClassID.ERROR:\n      return guestErrorToHost(ctx, v);\n    case JSClassID.REGEXP:\n      return new RegExp(o.source, o.flags);\n    case JSClassID.MAP: {\n      const m = new Map(); seen.set(v, m);\n      for (const [k, val] of Map.prototype.entries.call(o)) m.set(fromGuestRec(ctx, k, seen), fromGuestRec(ctx, val, seen));\n      return m;\n    }\n    case JSClassID.SET: {\n      const s = new Set(); seen.set(v, s);\n      for (const val of Set.prototype.values.call(o)) s.add(fromGuestRec(ctx, val, seen));\n      return s;\n    }\n    case JSClassID.ARRAY_BUFFER:\n      /* the guest object is the host ArrayBuffer re-prototyped: copy it */\n      return new Uint8Array(o as ArrayBuffer).slice().buffer;\n  }\n  if (ArrayBuffer.isView(o)) {\n    /* guest typed arrays are host views re-prototyped: copy with the host constructor */\n    const Ctor = (globalThis as any)[(o as any)[Symbol.toStringTag]];\n    return Ctor ? new Ctor(o as any) : new Uint8Array(o as any);\n  }\n  if (Array.isArray(o)) {\n    const a: unknown[] = []; seen.set(v, a);\n    for (let i = 0; i < o.length; i++) a[i] = fromGuestRec(ctx, o[i], seen);\n    return a;\n  }\n  const r: Record<PropertyKey, unknown> = {}; seen.set(v, r);\n  for (const k of Reflect.ownKeys(o)) {\n    const d = Reflect.getOwnPropertyDescriptor(o, k)!;\n    if (!d.enumerable) continue;\n    r[k] = fromGuestRec(ctx, o[k], seen);\n  }\n  return r;\n}\n\n/* a host promise that settles when the guest promise does */\nexport function guestPromiseToHost(ctx: JSContext, promise: JSValue): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const then = JS_GetPropertyStr(ctx, promise, 'then');\n    const onFul = JS_NewCFunction(ctx, (_c, _t, argv) => { resolve(fromGuest(ctx, argv[0])); return undefined; }, 'resolve', 1);\n    const onRej = JS_NewCFunction(ctx, (_c, _t, argv) => { reject(fromGuestRejection(ctx, argv[0])); return undefined; }, 'reject', 1);\n    const r = JS_Call(ctx, then, promise, [onFul, onRej]);\n    if (JS_IsException(r)) reject(guestErrorToHost(ctx, JS_GetException(ctx)));\n    drainJobs(ctx);\n  });\n}\n\nfunction fromGuestRejection(ctx: JSContext, reason: JSValue): unknown {\n  if (JS_IsObject(reason) && JS_GetClassID(reason) === JSClassID.ERROR) return guestErrorToHost(ctx, reason);\n  return fromGuest(ctx, reason);\n}\n"]}

package/dist/interpreter.d.ts

@@ -0,0 +1,81 @@
+import { JSContext, JSRuntime, JSValue, JSObject, JSAtom, JSClassID, JSFunctionBytecode, JSVarRef, JSStackFrame, JSAsyncFunctionState, JSCFunctionListEntry } from './quickjs.ts';
+export declare const ARG_SCOPE_END = -2;
+export declare const GEN_MAGIC_NEXT = 0;
+export declare const GEN_MAGIC_RETURN = 1;
+export declare const GEN_MAGIC_THROW = 2;
+export declare function js_class_has_bytecode(class_id: JSClassID): boolean;
+export declare function get_var_ref(ctx: JSContext, sf: JSStackFrame, var_idx: number, is_arg: boolean): JSVarRef;
+export declare function close_var_refs(rt: JSRuntime, sf: JSStackFrame): void;
+export declare function close_lexical_var(ctx: JSContext, sf: JSStackFrame, var_idx: number): void;
+export declare function js_closure_from_refs(ctx: JSContext, b: JSFunctionBytecode, var_refs: JSVarRef[], proto: JSValue | null, is_ctor: boolean): JSValue;
+export declare function js_closure2(ctx: JSContext, b: JSFunctionBytecode, cur_var_refs: JSVarRef[] | null, sf: JSStackFrame | null, proto: JSValue | null, is_ctor: boolean): JSValue;
+export declare function js_function_set_properties(ctx: JSContext, func_obj: JSValue, name: JSAtom, len: number): void;
+export declare function js_closure(ctx: JSContext, b: JSFunctionBytecode, cur_var_refs: JSVarRef[] | null, sf: JSStackFrame | null): JSValue;
+export declare function js_build_arguments(ctx: JSContext, argc: number, argv: JSValue[]): JSValue;
+export declare function js_build_mapped_arguments(ctx: JSContext, argc: number, argv: JSValue[], sf: JSStackFrame, arg_count: number): JSValue;
+export declare function js_build_rest(ctx: JSContext, first: number, argc: number, argv: JSValue[]): JSValue;
+export declare function JS_DefinePrivateField(ctx: JSContext, obj: JSValue, name: JSValue, val: JSValue): number;
+export declare function JS_GetPrivateField(ctx: JSContext, obj: JSValue, name: JSValue): JSValue;
+export declare function JS_SetPrivateField(ctx: JSContext, obj: JSValue, name: JSValue, val: JSValue): number;
+export declare function JS_AddBrand(ctx: JSContext, obj: JSValue, home_obj: JSValue): number;
+export declare function JS_CheckBrand(ctx: JSContext, obj: JSValue, func: JSValue): number;
+export declare function js_operator_private_in(ctx: JSContext, op1: JSValue, op2: JSValue): number;
+export declare function js_method_set_home_object(ctx: JSContext, func_obj: JSValue, home_obj: JSValue): void;
+export declare function js_get_function_name(ctx: JSContext, name: JSAtom): string;
+export declare function js_method_set_properties(ctx: JSContext, func_obj: JSValue, name: JSAtom, flags: number, home_obj: JSValue): number;
+export declare function JS_DefineObjectName(ctx: JSContext, obj: JSValue, name: JSAtom, flags: number): number;
+export declare function JS_DefineObjectNameComputed(ctx: JSContext, obj: JSValue, str: JSValue, flags: number): number;
+export declare function js_define_class(ctx: JSContext, class_name: JSAtom, class_flags: number, parent_class: JSValue, b: JSFunctionBytecode, var_refs: JSVarRef[], is_computed_name: boolean, computed_name: JSValue): [JSValue, JSValue] | null;
+export declare function js_function_apply(ctx: JSContext, this_val: JSValue, argv: JSValue[], magic: number): JSValue;
+export declare function JS_CallInternal(ctx: JSContext, func_obj: JSValue, this_obj: JSValue, new_target: JSValue, argv: JSValue[], flags: number): JSValue;
+export declare let jit_osr_threshold: number;
+export declare function jit_set_osr_threshold(n: number): void;
+export declare function async_func_init(ctx: JSContext, func_obj: JSValue, this_obj: JSValue, argv: JSValue[]): JSAsyncFunctionState;
+export declare function async_func_resume(ctx: JSContext, s: JSAsyncFunctionState): JSValue;
+export declare function js_generator_next(ctx: JSContext, this_val: JSValue, argv: JSValue[], pdone: {
+    done: number;
+}, magic: number): JSValue;
+export declare function js_generator_function_call(ctx: JSContext, func_obj: JSValue, this_obj: JSValue, argv: JSValue[], flags: number): JSValue;
+export declare const js_generator_proto_funcs: JSCFunctionListEntry[];
+export declare const js_generator_function_proto_funcs: JSCFunctionListEntry[];
+export declare function js_async_function_call(ctx: JSContext, func_obj: JSValue, this_obj: JSValue, argv: JSValue[], flags: number): JSValue;
+export declare const js_async_function_proto_funcs: JSCFunctionListEntry[];
+export declare const enum JSAsyncGeneratorState {
+    SUSPENDED_START = 0,
+    SUSPENDED_YIELD = 1,
+    SUSPENDED_YIELD_STAR = 2,
+    EXECUTING = 3,
+    AWAITING_RETURN = 4,
+    COMPLETED = 5
+}
+export declare class JSAsyncGeneratorRequest {
+    completion_type: number;
+    result: JSValue;
+    promise: JSValue;
+    resolving_funcs: [JSValue, JSValue];
+    constructor(completion_type: number, result: JSValue, promise: JSValue, resolving_funcs: [JSValue, JSValue]);
+}
+export declare class JSAsyncGeneratorData {
+    generator: JSObject | null;
+    state: JSAsyncGeneratorState;
+    func_state: JSAsyncFunctionState | null;
+    queue: JSAsyncGeneratorRequest[];
+}
+export declare function js_async_generator_next(ctx: JSContext, this_val: JSValue, argv: JSValue[], magic: number): JSValue;
+export declare function js_async_generator_function_call(ctx: JSContext, func_obj: JSValue, this_obj: JSValue, argv: JSValue[], flags: number): JSValue;
+export declare const js_async_generator_proto_funcs: JSCFunctionListEntry[];
+export declare const js_async_generator_function_proto_funcs: JSCFunctionListEntry[];
+export declare class JSAsyncFromSyncIteratorData {
+    sync_iter: JSValue;
+    next_method: JSValue;
+    constructor(sync_iter: JSValue, next_method: JSValue);
+}
+export declare function JS_CreateAsyncFromSyncIterator(ctx: JSContext, sync_iter: JSValue): JSValue;
+export declare const js_async_from_sync_iterator_proto_funcs: JSCFunctionListEntry[];
+export declare function js_for_of_start_value(ctx: JSContext, obj: JSValue, is_async: boolean): [JSValue, JSValue] | null;
+export declare function js_for_of_next_value(ctx: JSContext, iter: JSValue, next: JSValue): {
+    value: JSValue;
+    done: boolean;
+} | null;
+export declare function js_append_enumerate_value(ctx: JSContext, target: JSValue, pos: number, src: JSValue): number;
+export declare function js_build_arguments_value(ctx: JSContext, argv: JSValue[]): JSValue;