@mikrojs/native 0.21.1-next.20260928214050 → 0.22.0

package/CMakeLists.txt

@@ -46,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
@@ -244,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/include/mikrojs/platform.h

@@ -100,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

@@ -220,8 +220,12 @@ 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
@@ -344,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

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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikrojs/native",
-  "version": "0.21.1-next.20260928214050",
+  "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.20260928214050+4d8353a",
+    "@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.20260928214050+4d8353a",
-    "@mikrojs/schema": "0.21.1-next.20260928214050+4d8353a",
+    "@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/mik_repl.cpp

@@ -927,8 +927,9 @@ static std::vector<uint8_t> proto_complete(JSContext* ctx, const char* partial,
  * lists the registered C modules outside the core namespace (package native
  * modules compiled in, e.g. "@mikrojs/drivers/sh8601"; empty on a generic
  * build), so the host can refuse an app importing one this firmware lacks.
- * `fw` is the firmware identity: the board name the build set (MIK_BOARD_NAME),
- * which `board` also reports. The host only auto-flashes its bundled image over
+ * `fw` is the firmware identity: the name the build set (MIK_BOARD_NAME). `board`
+ * reports the same unless `mikro flash` wrote a board's name into a generic
+ * image (mik__board_name). The host only auto-flashes its bundled image over
  * a device whose identity matches that image's name; omitting it reads as
  * firmware predating identity reporting, which the host treats as its own
  * bundled firmware.

package/src/mik_sys.cpp

@@ -171,7 +171,7 @@ static JSValue mik__sys_restart(JSContext* ctx, JSValue this_val, int argc, JSVa
     return JS_UNDEFINED;
 }
 
-const char* mik__board_name(void) {
+const char* mik__firmware_name(void) {
 #ifdef MIK_BOARD_NAME
     return MIK_BOARD_NAME;
 #elif defined(CONFIG_IDF_TARGET)
@@ -181,6 +181,36 @@ const char* mik__board_name(void) {
 #endif
 }
 
+#ifdef CONFIG_IDF_TARGET
+/* The board name `mikro flash` writes into a copy of the image when it flashes
+ * the generic firmware for a board (packages/mikro/src/cli/lib/boardName.ts).
+ * ESP-IDF places .rodata_custom_desc right after esp_app_desc_t, at image
+ * offset 0x120. Empty in the built image. */
+struct MIKBoardDesc {
+    uint32_t magic;
+    char board[64];
+};
+static const MIKBoardDesc s_board_desc
+    __attribute__((section(".rodata_custom_desc"), used)) = {0x424b494d /* "MIKB" */, {}};
+
+/* Copied through volatile reads: the compiler knows the empty initializer and
+ * would otherwise fold every read of it. */
+static const char* mik__patched_board_name(void) {
+    static char name[sizeof(s_board_desc.board)];
+    const volatile char* src = s_board_desc.board;
+    for (size_t i = 0; i + 1 < sizeof(name) && src[i] != '\0'; i++) name[i] = src[i];
+    return name;
+}
+#endif
+
+const char* mik__board_name(void) {
+#ifdef CONFIG_IDF_TARGET
+    static const char* patched = mik__patched_board_name();
+    if (patched[0] != '\0') return patched;
+#endif
+    return mik__firmware_name();
+}
+
 static JSValue mik__sys_board(JSContext* ctx) {
     JSValue obj = JS_NewObject(ctx);
     JS_SetPropertyStr(ctx, obj, "name", JS_NewString(ctx, mik__board_name()));
@@ -248,6 +278,7 @@ static JSValue mik__sys_board(JSContext* ctx) {
 
 static JSValue mik__sys_firmware(JSContext* ctx) {
     JSValue obj = JS_NewObject(ctx);
+    JS_SetPropertyStr(ctx, obj, "name", JS_NewString(ctx, mik__firmware_name()));
 #ifdef CONFIG_IDF_TARGET
     const esp_app_desc_t* desc = esp_app_get_description();
     char elf_hash[65];