@mikrojs/native 0.21.1-next.20260927212749 → 0.22.0

package/CMakeLists.txt

@@ -37,7 +37,6 @@ set(MIKROJS_CORE_SOURCES
     src/fs.cpp
     src/mem.cpp
     src/utils.cpp
-    src/eval_bytecode.cpp
     src/mik_inspect.cpp
     src/mik_stdio.cpp
     src/mik_text_encoding.cpp
@@ -47,6 +46,7 @@ set(MIKROJS_CORE_SOURCES
     src/mik_wifi_client.cpp
     src/mik_cbor.cpp
     src/mik_schema.cpp
+    src/mik_test.cpp
     src/mik_result.cpp
     src/mik_console.cpp
     src/mik_sys.cpp
@@ -222,7 +222,6 @@ if(BUILD_TESTING)
         test/fs_test.cpp
         test/console_stdio_test.cpp
         test/cbor_js_test.cpp
-        test/eval_bytecode_test.cpp
         test/result_utils_test.cpp
         test/modules_fs_test.cpp
         test/sys_test.cpp
@@ -246,6 +245,7 @@ if(BUILD_TESTING)
         test/sys_codec_test.cpp
         test/watchdog_test.cpp
         test/gpio_claim_test.cpp
+        test/test_runner_test.cpp
     )
 
     # ── Check-in wire fixtures ───────────────────────────────────────

package/dist/index.d.ts

@@ -12,10 +12,11 @@ export declare class MikroRuntime {
      *  as `globalThis._` for follow-up expressions. Mirrors the firmware
      *  REPL's eval path. Returns undefined for `undefined` results. */
     evalForRepl(code: string, depth?: number): string | undefined;
-    loop(): Promise<void>;
     /** Run one iteration of the event loop synchronously. Returns 0 on success. */
     loopOnce(): number;
-    stop(): void;
+    /** Microseconds until the loop next has work: 0 when it has work now, -1
+     *  when nothing is scheduled. Lets the caller sleep between loopOnce() calls. */
+    nextWakeUs(): number;
     dispose(): void;
     /** Register a JS source string as a named virtual module.
      * Virtual modules are checked by the loader before builtin bytecode,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../addon/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EAGnB,YAAY,EACb,MAAM,YAAY,CAAA;AAuBnB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,CAAC,EAAE,mBAAmB;IAIzC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,IAAI;IAIjD,kFAAkF;IAClF,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1D,2HAA2H;IAC3H,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;uEAGmE;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,GAAG,SAAS;IAIxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,+EAA+E;IAC/E,QAAQ,IAAI,MAAM;IAIlB,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,IAAI;IAIf;;oEAEgE;IAChE,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxD;mEAC+D;IAC/D,aAAa,IAAI,WAAW,EAAE;IAI9B;wFACoF;IACpF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7C;;+DAE2D;IAC3D,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI;IAInF;;uFAEmF;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAI5F;;sFAEkF;IAClF,eAAe,IAAI,IAAI;IAIvB;yDACqD;IACrD,UAAU,IAAI,YAAY,EAAE;IAI5B;;sCAEkC;IAClC,kBAAkB,IAAI,MAAM;IAI5B;;oDAEgD;IAChD,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC;IAIpD;4DACwD;IACxD,EAAE,IAAI,IAAI;IAIV;;;wCAGoC;IACpC,iBAAiB,IAAI,IAAI;CAG1B;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAC,GAClC,WAAW,GAAG,SAAS,CAEzB;AAED,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAEhG;AAED,wGAAwG;AACxG,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,MAAM,CA4BR;AAED,YAAY,EAAC,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAC,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../addon/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EAGnB,YAAY,EACb,MAAM,YAAY,CAAA;AAuBnB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,CAAC,EAAE,mBAAmB;IAIzC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,IAAI;IAIjD,kFAAkF;IAClF,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1D,2HAA2H;IAC3H,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;uEAGmE;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,GAAG,SAAS;IAIxD,+EAA+E;IAC/E,QAAQ,IAAI,MAAM;IAIlB;qFACiF;IACjF,UAAU,IAAI,MAAM;IAIpB,OAAO,IAAI,IAAI;IAIf;;oEAEgE;IAChE,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxD;mEAC+D;IAC/D,aAAa,IAAI,WAAW,EAAE;IAI9B;wFACoF;IACpF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7C;;+DAE2D;IAC3D,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI;IAInF;;uFAEmF;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAI5F;;sFAEkF;IAClF,eAAe,IAAI,IAAI;IAIvB;yDACqD;IACrD,UAAU,IAAI,YAAY,EAAE;IAI5B;;sCAEkC;IAClC,kBAAkB,IAAI,MAAM;IAI5B;;oDAEgD;IAChD,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC;IAIpD;4DACwD;IACxD,EAAE,IAAI,IAAI;IAIV;;;wCAGoC;IACpC,iBAAiB,IAAI,IAAI;CAG1B;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAC,GAClC,WAAW,GAAG,SAAS,CAEzB;AAED,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAEhG;AAED,wGAAwG;AACxG,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,MAAM,CA4BR;AAED,YAAY,EAAC,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAC,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -43,15 +43,14 @@ export class MikroRuntime {
     evalForRepl(code, depth = 2) {
         return this.native.evalForRepl(code, depth);
     }
-    loop() {
-        return this.native.loop();
-    }
     /** Run one iteration of the event loop synchronously. Returns 0 on success. */
     loopOnce() {
         return this.native.loopOnce();
     }
-    stop() {
-        this.native.stop();
+    /** Microseconds until the loop next has work: 0 when it has work now, -1
+     *  when nothing is scheduled. Lets the caller sleep between loopOnce() calls. */
+    nextWakeUs() {
+        return this.native.nextWakeUs();
     }
     dispose() {
         this.native.dispose();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../addon/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../addon/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -22,9 +22,8 @@ export interface NativeMikroRuntime {
     evalModule(filename: string, isMain?: boolean): void;
     evalModuleContent(filename: string, content: string): void;
     evalScript(code: string): string | undefined;
-    loop(): Promise<void>;
     loopOnce(): number;
-    stop(): void;
+    nextWakeUs(): number;
     dispose(): void;
     registerModuleSource(name: string, source: string): void;
     drainMessages(): HostMessage[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../addon/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,QAAQ,IAAI,MAAM,CAAA;IAClB,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;IACf,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACxD,aAAa,IAAI,WAAW,EAAE,CAAA;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;IACvB,UAAU,IAAI,YAAY,EAAE,CAAA;IAC5B,kBAAkB,IAAI,MAAM,CAAA;IAC5B,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAA;IACpD,EAAE,IAAI,IAAI,CAAA;IACV,iBAAiB,IAAI,IAAI,CAAA;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,KAAK,OAAO,CAAC,EAAE,mBAAmB,KAAK,kBAAkB,CAAA;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACjC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACjF,UAAU,CACR,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAC,GAClC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAA;CAC7D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../addon/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,QAAQ,IAAI,MAAM,CAAA;IAClB,UAAU,IAAI,MAAM,CAAA;IACpB,OAAO,IAAI,IAAI,CAAA;IACf,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACxD,aAAa,IAAI,WAAW,EAAE,CAAA;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;IACvB,UAAU,IAAI,YAAY,EAAE,CAAA;IAC5B,kBAAkB,IAAI,MAAM,CAAA;IAC5B,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAA;IACpD,EAAE,IAAI,IAAI,CAAA;IACV,iBAAiB,IAAI,IAAI,CAAA;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,KAAK,OAAO,CAAC,EAAE,mBAAmB,KAAK,kBAAkB,CAAA;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACjC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACjF,UAAU,CACR,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAC,GAClC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAA;CAC7D"}

package/include/mikrojs/mem.h

@@ -25,7 +25,6 @@ void* mik__js_realloc(void* ptr, size_t size);
  * mik__js_realloc relies on the flag staying consistent with the heap
  * the original pointer came from. */
 void mik__set_quickjs_heap_psram(bool enable);
-bool mik__is_quickjs_heap_psram(void);
 
 #ifdef MIK_OOM_INJECT
 #include <stdint.h>

package/include/mikrojs/mikrojs.h

@@ -19,7 +19,8 @@ typedef struct MIKRunOptions {
      * IO-bound workloads this is invisible against networking and IO
      * costs. No effect on hosts and chips without PSRAM. Defaults false
      * for backward compatibility; the firmware bootstrap flips it on
-     * when CONFIG_MIKROJS_QUICKJS_HEAP_PSRAM is set. */
+     * when CONFIG_MIKROJS_QUICKJS_HEAP_PSRAM is set and PSRAM was found
+     * at boot. */
     bool use_psram_heap;
 } MIKRunOptions;
 
@@ -125,6 +126,10 @@ void MIK_SetFSLimit(MIKRuntime* mik_rt, size_t limit);
  * the default (65536). */
 void MIK_SetFSReadMax(MIKRuntime* mik_rt, size_t bytes);
 int MIK_Loop(MIKRuntime* mik_rt);
+/* End the serve loop's wait so work just queued from another task runs now.
+ * Call after the enqueue; no-op without the platform hook. Interrupt handlers
+ * use the platform's own ISR variant (MIK_WakeFromISR on ESP32). */
+void MIK_Wake(void);
 void MIK_Stop(MIKRuntime* mik_rt);
 
 /* True once the runtime has entered a halted state — set by the promise
@@ -139,11 +144,6 @@ bool MIK_IsStopRequested(MIKRuntime* mik_rt);
 void MIK_SetEnvVar(MIKRuntime* mik_rt, const char* key, const char* value);
 void MIK_RebuildEnv(MIKRuntime* mik_rt);
 
-/* Native module registration */
-typedef void (*MIKNativeModuleInitFn)(JSContext* ctx);
-void MIK_RegisterNativeModuleInit(MIKRuntime* mik_rt, const char* name,
-                                  MIKNativeModuleInitFn init_fn);
-
 /* Loop consumer registration */
 typedef void (*MIKLoopConsumeFn)(JSContext* ctx);
 typedef void (*MIKLoopDestroyFn)(JSContext* ctx);

package/include/mikrojs/platform.h

@@ -19,6 +19,13 @@ typedef struct MIKPlatform {
      *  deep sleep (hosts), where callers fall back to restart(). */
     void (*deep_sleep_us)(uint64_t us);
     void (*yield)(void);
+    /** Block the calling task until wake() is called or `timeout_us` elapses.
+     *  A wake that arrives before the wait is kept: the next wait returns at
+     *  once. NULL where the platform has no blocking primitive; the serve
+     *  loop then falls back to yield() between passes. */
+    void (*wait)(int64_t timeout_us);
+    /** End a wait in progress, from task context. NULL when wait is NULL. */
+    void (*wake)(void);
     /** Feed the hardware task watchdog for the calling task. NULL where the
      *  platform has none (hosts) or the watchdog is compiled out. */
     void (*feed_watchdog)(void);
@@ -93,6 +100,12 @@ typedef struct MIKPlatform {
      *  "unknown". The returned pointer must remain valid for the lifetime
      *  of the platform. */
     const char* (*get_reset_reason)(void);
+    /** Bring up the TCP/IP stack if the platform has one that starts on
+     *  demand. Called before a networking module creates its first socket;
+     *  idempotent. NULL where sockets need no setup (hosts). On ESP32 the
+     *  stack otherwise starts only as a side effect of the wifi or http
+     *  module loading, and lwip aborts on a socket call before that. */
+    void (*net_init)(void);
 } MIKPlatform;
 
 /* Log levels (matching ESP-IDF ESP_LOG_xxx values) */

package/include/mikrojs/private.h

@@ -36,12 +36,6 @@ typedef struct MIKTimers {
     uint32_t next_timer_id = 1;
 } MIKTimerRegistry;
 
-/* Registered native module init function */
-struct MIKNativeModuleEntry {
-    std::string name;
-    MIKNativeModuleInitFn init_fn;
-};
-
 /* Registered loop consumer */
 struct MIKLoopConsumerEntry {
     MIKLoopConsumeFn consume_fn;
@@ -60,12 +54,32 @@ struct MIKRejectedPromise {
 /* Observable dispatch queue (defined in mik_observable.cpp). */
 struct MIKObservableDispatch;
 
+/* Result property names, atomized once so building a Result skips hashing
+ * the C string. JS_ATOM_NULL until mik__result_init has run. */
+struct MIKResultAtoms {
+    JSAtom ok;
+    JSAtom value;
+    JSAtom error;
+    JSAtom err;
+    JSAtom code;
+    JSAtom message;
+    JSAtom name;
+};
+
+/* Lookups mik_inspect would otherwise repeat for every value; filled by
+ * mik__inspect_register. */
+struct MIKInspectCache {
+    JSAtom inspect_symbol;     /* Symbol.for('mikrojs.inspect') */
+    JSAtom to_string_tag;      /* Symbol.toStringTag */
+    JSValue object_proto;      /* Object.prototype */
+    JSClassID object_class_id; /* class of plain objects */
+};
+
 struct MIKRuntime {
     MIKRunOptions options;
     MIKConfig config;
     JSRuntime* rt;
     JSContext* ctx;
-    bool is_worker;
     bool freeing;
     bool stop_requested;  /* Set by promise rejection tracker to stop the loop */
     /* Set by MIK_EnableTestHelpers — the test supervisor wants stop_requested
@@ -108,7 +122,6 @@ struct MIKRuntime {
      * this throw FSError(EFBIG); callers use open() for streaming. */
     size_t fs_read_max;
     MIKTimerRegistry* timers;
-    std::vector<MIKNativeModuleEntry> native_modules;
     std::vector<MIKLoopConsumerEntry> loop_consumers;
     /* Handles kept alive by MIK_KeepHandle; each entry owns a reference. */
     std::vector<JSValue> kept_handles;
@@ -132,6 +145,10 @@ struct MIKRuntime {
      * mik__result_ok_void. Safe to share because Result is immutable by
      * convention, and the singleton is frozen + non-extensible. */
     JSValue result_ok_void_singleton;
+    /* Freed in MIK_FreeRuntime after JS_FreeContext, once nothing can build a Result. */
+    MIKResultAtoms result_atoms;
+    /* Values freed before JS_FreeContext, atoms after it. */
+    MIKInspectCache inspect_cache;
     /* Shared BodyConsumedError constructor for the native mikro/http/helpers
      * module. Created lazily on first http module init, freed in
      * MIK_FreeRuntime. */
@@ -203,10 +220,20 @@ struct MIKRuntime {
 void mik__pub_fs_register(JSContext* ctx);
 void mik__stdio_init(JSContext* ctx, JSValue ns);
 void mik__sys_api_init(JSContext* ctx, JSValue ns);
-/* Board name of this build: MIK_BOARD_NAME if defined, else "<chip>-generic"
- * on device, "generic" on host. Static storage, never NULL. */
+/* Name of this build: MIK_BOARD_NAME if defined, else "<chip>-generic" on
+ * device, "generic" on host. Static storage, never NULL. */
+const char* mik__firmware_name(void);
+/* The board: the name `mikro flash` wrote into the image when it flashed the
+ * generic firmware for a board, else mik__firmware_name(). Static storage,
+ * never NULL. */
 const char* mik__board_name(void);
 void mik__text_encoding_init(JSContext* ctx, JSValue global);
+/* UTF-8 pass shared by TextDecoder and the http body drain: each invalid byte
+ * becomes U+FFFD. A null `out` only counts; returns the output length. With
+ * `hold_tail`, an incomplete final sequence is left out and its byte count
+ * stored in *tail. */
+size_t mik__utf8_replace(const uint8_t* in, size_t len, bool hold_tail, uint8_t* out,
+                         size_t* tail);
 void mik__abort_init(JSContext* ctx, JSValue global_obj);
 
 JSValue mik_new_error(JSContext* ctx, int err);
@@ -215,6 +242,10 @@ JSValue mik_throw_errno(JSContext* ctx, int err);
 void mik__execute_jobs(JSContext* ctx);
 /* End-of-turn unhandled-rejection check; called after each microtask drain. */
 void mik__flush_unhandled_rejections(JSContext* ctx);
+/* Microseconds until MIK_Loop next has work: 0 now, -1 none. Counts timers, the
+ * restart, feed and awake deadlines and the UDP poll. Code that queues work for a
+ * loop consumer calls MIK_Wake; a consumer's own deadlines wait for the caller's cap. */
+int64_t mik__next_wake_us(MIKRuntime* mik_rt);
 JSModuleDef* mik__load_builtin(JSContext* ctx, const char* name);
 int mik__load_file(JSContext* ctx, DynBuf* dbuf, const char* filename);
 void mik__resolve_fs_path(JSContext* ctx, const char* module_name, char* out, size_t out_size);
@@ -244,16 +275,7 @@ bool mik__is_unloadable_namespace(JSContext* ctx, JSValueConst ns);
 
 int js_module_set_import_meta(JSContext* ctx, JSValue func_val, bool use_realpath, bool is_main);
 
-JSValue mik__get_args(JSContext* ctx);
-
-int mik__eval_bytecode(JSContext* ctx, const uint8_t* buf, size_t buf_len, bool check_promise);
-
-
-void mik__sab_free(void* opaque, void* ptr);
-void mik__sab_dup(void* opaque, void* ptr);
-
 MIKTimerRegistry* MIK_NewTimerRegistry(void);
-MIKRuntime* MIK_NewRuntimeWorker(void);
 MIKRuntime* MIK_NewRuntimeInternal(MIKRunOptions* options);
 JSValue MIK_EvalScript(JSContext* ctx, const char* filename);
 JSValue MIK_EvalModule(JSContext* ctx, const char* filename, bool is_main);
@@ -311,6 +333,9 @@ JSModuleDef* mik__result_init(JSContext* ctx);
 
 /* UDP module (mik_udp.cpp) */
 JSModuleDef* mik__udp_init(JSContext* ctx);
+/* True while a bound socket is open on ctx. Its datagrams are polled with
+ * recvfrom once per loop pass, so mik__next_wake_us caps the wait meanwhile. */
+bool mik__udp_has_open_sockets(JSContext* ctx);
 
 /* Observable module (mik_observable.cpp) */
 JSModuleDef* mik__observable_init(JSContext* ctx);
@@ -323,6 +348,9 @@ JSModuleDef* mik__observable_operators_load(JSContext* ctx);
 int mik__observable_multicast_new(JSContext* ctx, JSValue* observable, JSValue* next,
                                   JSValue* complete);
 
+/* Test runner module (mik_test.cpp): mikro/test, C-module table in modules.cpp. */
+JSModuleDef* mik__test_load(JSContext* ctx);
+
 /* Watchdog (mik_watchdog.cpp). */
 /* Start a fresh blocking budget: top of each MIK_Loop pass, eval entry
  * points, REPL eval, and on return from a deliberately blocking native
@@ -369,6 +397,11 @@ void mik__repl_set_paused(bool paused);
 /* Header size: 1 (type) + 4 (u32le length) */
 #define MIK_PROTO_HEADER_SIZE 5
 
+/* Revision of this command set, sent in MSG_READY as "proto" so the host
+ * knows which commands the device answers. Absent means 0.
+ * 1: MIK_CMD_DEPLOY_CHECKSUM_LIST and MIK_CMD_DEPLOY_KEEP_MANY. */
+#define MIK_PROTO_REV 1
+
 /* Device → CLI message types */
 #define MIK_MSG_READY 0x01
 #define MIK_MSG_LOG 0x02
@@ -437,6 +470,14 @@ void mik__repl_set_paused(bool paused);
  *   u8 status (0 none | 1 ok | 2 fail) | u16le chk_len | chk
  *   | u16le reason_len | reason | u16le detail_len | detail. */
 #define MIK_CMD_DEPLOY_RESULT 0x2E
+/* Every checksum the device holds, in one reply. No payload. Reply is
+ * MIK_MSG_OK with: u16le file_count | one "<sha256 hex>  <name>\n" line per
+ * manifest entry whose file is on disk. file_count counts every manifest
+ * entry, so the host can tell the device holds files the build no longer has. */
+#define MIK_CMD_DEPLOY_CHECKSUM_LIST 0x2F
+/* KEEP for several files. Payload: repeated u16le name_len | name. Staged in
+ * order; the first failure ends the batch and MIK_MSG_ERR names the file. */
+#define MIK_CMD_DEPLOY_KEEP_MANY 0x30
 
 #define MIK_CMD_CONFIG_LIST 0x40
 #define MIK_CMD_CONFIG_SET 0x41

package/include/mikrojs/utils.h

@@ -11,19 +11,24 @@
 struct AssertionInfo {
     const char* file_line;  // filename:line
     const char* message;
-    const char* function;
 };
 
-#define ERROR_AND_ABORT(expr)                                                              \
-    do {                                                                                   \
-        static const struct AssertionInfo args = {__FILE__ ":" STRINGIFY(__LINE__), #expr, \
-                                                  PRETTY_FUNCTION_NAME};                   \
-        mik_assert(args);                                                                  \
+/* Base name only: __FILE__ would put the build machine's absolute path in flash at every
+ * call site. */
+#ifdef __FILE_NAME__
+#define MIK__FILE_NAME __FILE_NAME__
+#else
+#define MIK__FILE_NAME __FILE__
+#endif
+
+#define ERROR_AND_ABORT(expr)                                                                     \
+    do {                                                                                          \
+        static const struct AssertionInfo args = {MIK__FILE_NAME ":" STRINGIFY(__LINE__), #expr}; \
+        mik_assert(args);                                                                         \
     } while (0)
 
 #define MIK__LIKELY(expr) __builtin_expect(!!(expr), 1)
 #define MIK__UNLIKELY(expr) __builtin_expect(!!(expr), 0)
-#define PRETTY_FUNCTION_NAME __PRETTY_FUNCTION__
 
 #define STRINGIFY_(x) #x
 #define STRINGIFY(x) STRINGIFY_(x)
@@ -110,13 +115,13 @@ bool MIK_IsPromisePending(JSContext* ctx, MIKPromise* p);
 void MIK_FreePromise(JSContext* ctx, MIKPromise* p);
 void MIK_FreePromiseRT(JSRuntime* rt, MIKPromise* p);
 void MIK_ClearPromise(JSContext* ctx, MIKPromise* p);
-void MIK_MarkPromise(JSRuntime* rt, MIKPromise* p, JS_MarkFunc* mark_func);
 void MIK_SettlePromise(JSContext* ctx, MIKPromise* p, bool is_reject, int argc, JSValue* argv);
 void MIK_ResolvePromise(JSContext* ctx, MIKPromise* p, int argc, JSValue* argv);
 void MIK_RejectPromise(JSContext* ctx, MIKPromise* p, int argc, JSValue* argv);
 JSValue MIK_NewResolvedPromise(JSContext* ctx, int argc, JSValue* argv);
 JSValue MIK_NewRejectedPromise(JSContext* ctx, int argc, JSValue* argv);
 
+/* A Uint8Array over `data` (js_malloc'd). Takes ownership of `data`, also on failure. */
 JSValue MIK_NewUint8Array(JSContext* ctx, uint8_t* data, size_t size);
 
 #define MIK_THROW_ARG_ERR(ctx, argno, expected) \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikrojs/native",
-  "version": "0.21.1-next.20260927212749",
+  "version": "0.22.0",
   "description": "Mikro.js C++ runtime library and Node.js native addon",
   "keywords": [
     "esp32",
@@ -86,14 +86,14 @@
     "./runtime/wifi/types": "./runtime/wifi/types.ts"
   },
   "dependencies": {
-    "@mikrojs/quickjs": "0.21.1-next.20260927212749+7f87381",
+    "@mikrojs/quickjs": "0.22.0",
     "cmake-js": "^8.0.0",
     "node-addon-api": "^8.9.2",
     "node-gyp-build": "^4.8.4"
   },
   "devDependencies": {
-    "@mikrojs/registry": "0.21.1-next.20260927212749+7f87381",
-    "@mikrojs/schema": "0.21.1-next.20260927212749+7f87381",
+    "@mikrojs/registry": "0.22.0",
+    "@mikrojs/schema": "0.22.0",
     "@swc/core": "^1.16.2",
     "@types/node": "^24.12.2",
     "esbuild": "^0.28.2",

package/runtime/modules.json

@@ -23,7 +23,6 @@
     {"name": "stdio"},
     {"name": "stream"},
     {"name": "sys"},
-    {"name": "test"},
     {"name": "udp"},
     {"name": "watchdog"},
     {"name": "ble", "native": "ble", "feature": "ble", "when": "ble"},
@@ -38,6 +37,7 @@
     {"name": "http/helpers", "bytecode": false},
     {"name": "observable/operators", "bytecode": false},
     {"name": "inspect", "bytecode": false},
+    {"name": "test", "bytecode": false},
     {"name": "wifi", "bytecode": false, "native": "wifi", "feature": "wifi", "when": "wifi"}
   ]
 }

package/runtime/sys/types.ts

@@ -98,8 +98,9 @@ export declare const version: string
 export type BoardFeature = 'wifi' | 'ble' | 'bt' | 'ieee802154'
 
 export interface BoardInfo {
-  /** Board name from the firmware build (e.g. "xiao-esp32c6"). A build for no
-   * particular board is "<chip>-generic" (e.g. "esp32c6-generic"). */
+  /** The board (e.g. "@acme/devboard"). The generic firmware reports
+   * "<chip>-generic" (e.g. "esp32c6-generic"), or the name of the board it was
+   * flashed for. */
   name: string
   /** Chip target (e.g. "esp32c6") or "host" */
   chip: string
@@ -148,6 +149,8 @@ export declare function setDeviceName(value: DeviceName): void
 
 /** Firmware build identifiers */
 export declare const firmware: {
+  /** The build (e.g. "esp32c6-generic", "@acme/devboard") */
+  readonly name: string
   /** ELF SHA256 hash on ESP32, "dev" on host */
   readonly hash: string
   /** Build date and time */

package/src/mem.cpp

@@ -143,8 +143,8 @@ void* mik__realloc(void* ptr, size_t size) {
  * platform's malloc_psram first; if the platform can't satisfy the request
  * (no PSRAM, or PSRAM exhausted), fall back to libc malloc so the runtime
  * keeps working. The fallback only matters on host builds and in PSRAM-OOM
- * edge cases. Under normal ESP32 operation with CONFIG_SPIRAM=y, every
- * allocation lands in PSRAM. */
+ * edge cases: the ESP32 firmware sets the flag only when PSRAM was found
+ * at boot, so every allocation lands in PSRAM. */
 
 static bool g_quickjs_heap_psram = false;
 
@@ -152,10 +152,6 @@ void mik__set_quickjs_heap_psram(bool enable) {
     g_quickjs_heap_psram = enable;
 }
 
-bool mik__is_quickjs_heap_psram(void) {
-    return g_quickjs_heap_psram;
-}
-
 void* mik__js_malloc(size_t size) {
     if (OOM_INJECT_FAIL()) return nullptr;
     size_t hdr = hdr_size();

package/src/mik_http_client.cpp

@@ -382,6 +382,8 @@ void hc_iterator_close(JSContext* ctx, JSValue it) {
 void hc_drain_finalize(JSContext* ctx, JSValue st) {
     JSValue resolve = JS_GetPropertyStr(ctx, st, "res");
     JSValue arr = JS_GetPropertyStr(ctx, st, "arr");
+    /* The state stops keeping the chunks alive: freeing `arr` after the copy frees them. */
+    JS_SetPropertyStr(ctx, st, "arr", JS_UNDEFINED);
     JSValue mode_v = JS_GetPropertyStr(ctx, st, "mode");
     int32_t mode = 0;
     JS_ToInt32(ctx, &mode, mode_v);
@@ -401,7 +403,8 @@ void hc_drain_finalize(JSContext* ctx, JSValue st) {
         return;
     }
 
-    /* Merge chunks into one contiguous buffer. */
+    /* Merge chunks into one contiguous buffer. The spare byte NUL-terminates
+     * the buffer for the JSON parser. */
     size_t total = 0;
     for (uint32_t i = 0; i < nchunks; i++) {
         JSValue chunk = JS_GetPropertyUint32(ctx, arr, i);
@@ -414,7 +417,7 @@ void hc_drain_finalize(JSContext* ctx, JSValue st) {
         }
         JS_FreeValue(ctx, chunk);
     }
-    uint8_t* buf = static_cast<uint8_t*>(js_malloc(ctx, total ? total : 1));
+    uint8_t* buf = static_cast<uint8_t*>(js_malloc(ctx, total + 1));
     if (!buf) {
         JS_FreeValue(ctx, arr);
         JS_FreeValue(ctx, resolve);
@@ -439,44 +442,58 @@ void hc_drain_finalize(JSContext* ctx, JSValue st) {
 
     JSValue settled = JS_UNDEFINED;
     if (mode == DRAIN_BYTES) {
-        settled = mik__result_ok(ctx, JS_NewUint8ArrayCopy(ctx, buf, total));
-    } else {
-        /* Decode through the runtime's TextDecoder for exact TS parity
-         * (invalid-sequence replacement included). */
-        JSValue g = JS_GetGlobalObject(ctx);
-        JSValue td_ctor = JS_GetPropertyStr(ctx, g, "TextDecoder");
-        JS_FreeValue(ctx, g);
-        JSValue td = JS_CallConstructor(ctx, td_ctor, 0, nullptr);
-        JS_FreeValue(ctx, td_ctor);
-        JSValue u8 = JS_NewUint8ArrayCopy(ctx, buf, total);
-        JSValue text = hc_invoke(ctx, td, "decode", 1, &u8);
-        JS_FreeValue(ctx, u8);
-        JS_FreeValue(ctx, td);
-        if (JS_IsException(text)) {
+        /* MIK_NewUint8Array takes ownership of buf, also on failure. */
+        JSValue u8 = MIK_NewUint8Array(ctx, buf, total);
+        if (JS_IsException(u8)) {
+            JS_FreeValue(ctx, resolve);
+            hc_drain_reject_exception(ctx, st);
+            return;
+        }
+        hc_settle(ctx, resolve, mik__result_ok(ctx, u8));
+        JS_FreeValue(ctx, resolve);
+        return;
+    }
+
+    /* Invalid UTF-8 is repaired the way this runtime's TextDecoder does it (U+FFFD per bad
+     * byte), so text() and json() match TextDecoder.decode(). */
+    size_t tail = 0;
+    size_t fixed_len = mik__utf8_replace(buf, total, false, nullptr, &tail);
+    if (fixed_len != total) {
+        uint8_t* fixed = static_cast<uint8_t*>(js_malloc(ctx, fixed_len + 1));
+        if (!fixed) {
             js_free(ctx, buf);
             JS_FreeValue(ctx, resolve);
             hc_drain_reject_exception(ctx, st);
             return;
         }
-        if (mode == DRAIN_TEXT) {
-            settled = mik__result_ok(ctx, text);
+        mik__utf8_replace(buf, total, false, fixed, &tail);
+        js_free(ctx, buf);
+        buf = fixed;
+        total = fixed_len;
+    }
+
+    if (mode == DRAIN_TEXT) {
+        JSValue text = JS_NewStringLen(ctx, reinterpret_cast<const char*>(buf), total);
+        js_free(ctx, buf);
+        if (JS_IsException(text)) {
+            JS_FreeValue(ctx, resolve);
+            hc_drain_reject_exception(ctx, st);
+            return;
+        }
+        settled = mik__result_ok(ctx, text);
+    } else {
+        buf[total] = 0;
+        JSValue parsed = JS_ParseJSON(ctx, reinterpret_cast<const char*>(buf), total, "<json>");
+        js_free(ctx, buf);
+        if (JS_IsException(parsed)) {
+            JSValue exc = JS_GetException(ctx);
+            std::string msg = hc_error_message(ctx, exc);
+            JS_FreeValue(ctx, exc);
+            settled = mik__result_err_named(ctx, "InvalidJson", "%s", msg.c_str());
         } else {
-            size_t tlen = 0;
-            const char* ts = JS_ToCStringLen(ctx, &tlen, text);
-            JSValue parsed = JS_ParseJSON(ctx, ts ? ts : "", tlen, "<json>");
-            JS_FreeCString(ctx, ts);
-            JS_FreeValue(ctx, text);
-            if (JS_IsException(parsed)) {
-                JSValue exc = JS_GetException(ctx);
-                std::string msg = hc_error_message(ctx, exc);
-                JS_FreeValue(ctx, exc);
-                settled = mik__result_err_named(ctx, "InvalidJson", "%s", msg.c_str());
-            } else {
-                settled = mik__result_ok(ctx, parsed);
-            }
+            settled = mik__result_ok(ctx, parsed);
         }
     }
-    js_free(ctx, buf);
     hc_settle(ctx, resolve, settled);
     JS_FreeValue(ctx, resolve);
 }