@mikrojs/firmware 0.20.0 → 0.20.1

package/components/mikrojs/CMakeLists.txt

@@ -41,6 +41,17 @@ if(CONFIG_BT_ENABLED)
     list(APPEND _MIK_BLE_SRCS "mik_ble.cpp" "mik_ble_c_shim.c")
 endif()
 
+# The WiFi driver and the `wifi` native module only compile under
+# CONFIG_MIKROJS_WIFI. Nothing else references esp_wifi, so leaving
+# mik_wifi.cpp out is what drops net80211, pp and wpa_supplicant from the
+# link (about 20 KB of static RAM). `esp_wifi` stays in REQUIRES
+# unconditionally: IDF expands REQUIRES before sdkconfig is loaded, so a
+# CONFIG_-gated entry would always be empty there.
+set(_MIK_WIFI_SRCS "")
+if(CONFIG_MIKROJS_WIFI)
+    list(APPEND _MIK_WIFI_SRCS "mik_wifi.cpp")
+endif()
+
 # mik_ota.cpp includes <miniz.h> for tinfl (gunzip). On the esp32c6 the
 # implementation is in the chip mask ROM and the header comes from the
 # always-available `esp_rom` common dependency, so no REQUIRES entry is needed.
@@ -118,7 +129,7 @@ idf_component_register(
     "mik_spi.cpp"
     "mik_sntp.cpp"
     "mik_uart.cpp"
-    "mik_wifi.cpp"
+    ${_MIK_WIFI_SRCS}
 )
 
 # QuickJS headers as SYSTEM includes (suppresses warnings)
@@ -195,8 +206,11 @@ endif()
 include("${MIK_BYTECODE_CMAKE}")
 
 # Force linker to include self-registering native modules
-set(_MIK_MODULES cbor pin i2c i2s spi http http_server wifi rtc nvs_kv sntp sleep neopixel pwm uart ota)
+set(_MIK_MODULES cbor pin i2c i2s spi http http_server rtc nvs_kv sntp sleep neopixel pwm uart ota)
 list(APPEND _MIK_MODULES ota_client)
+if(CONFIG_MIKROJS_WIFI)
+    list(APPEND _MIK_MODULES wifi)
+endif()
 set(_MIK_BYTECODE_MODULES abort cbor env result schema fs http/server i2c i2s kv/nvs kv/rtc kv/shared module neopixel observable observable/lazy observable/operators ota ota/client ota/config pin pwm reader sleep spi sntp stdio stream sys test uart udp watchdog)
 if(CONFIG_BT_ENABLED)
     list(APPEND _MIK_MODULES ble)

package/components/mikrojs/Kconfig

@@ -22,6 +22,32 @@ menu "mikrojs console"
 
 endmenu
 
+menu "mikrojs WiFi"
+
+    config MIKROJS_WIFI
+        bool "Compile the WiFi driver and the mikro/wifi module"
+        default y
+        depends on SOC_WIFI_SUPPORTED
+        help
+            When enabled, the firmware links the ESP-IDF WiFi driver
+            (net80211, pp, wpa_supplicant) and provides the `mikro/wifi`
+            module. The driver takes about 20 KB of internal RAM at boot
+            whether or not the radio is ever started.
+
+            Disable for apps that do all their networking over another
+            link (a cellular modem on a UART, for instance) to get that
+            RAM back. `import 'mikro/wifi'` then throws ReferenceError:
+            Native module 'native:mikro/wifi' is not available, the boot
+            banner lists no WiFi radio and BoardInfo.features omits
+            "wifi". HTTP and SNTP still compile; they need a network
+            interface from elsewhere.
+
+            IDF's own CONFIG_ESP_WIFI_ENABLED cannot do this: it has no
+            prompt on WiFi-capable chips, so setting it to n in
+            sdkconfig.defaults is silently reverted to y.
+
+endmenu
+
 menu "mikrojs runtime memory"
 
     config MIKROJS_QUICKJS_HEAP_PSRAM

package/components/mikrojs/mik_main.cpp

@@ -320,12 +320,14 @@ void MIK_Main(void) {
      * the low-level radio driver is linked, even when no higher-level
      * stack is compiled in. WiFi and BLE each require both silicon support
      * and a corresponding `mikrojs/wifi`/`mikrojs/ble` JS module — we gate
-     * on the CONFIG_* flags as a proxy. 802.15.4 is deliberately omitted
-     * until a `mikrojs/zigbee` or `mikrojs/thread` module ships. */
+     * on the flags that compile those modules in: CONFIG_MIKROJS_WIFI (the
+     * component's own switch, since IDF forces CONFIG_ESP_WIFI_ENABLED on
+     * for capable silicon) and CONFIG_BT_ENABLED. 802.15.4 is deliberately
+     * omitted until a `mikrojs/zigbee` or `mikrojs/thread` module ships. */
     esp_chip_info_t chip_info;
     esp_chip_info(&chip_info);
 
-#if CONFIG_ESP_WIFI_ENABLED
+#if CONFIG_MIKROJS_WIFI
     bool has_wifi = (chip_info.features & CHIP_FEATURE_WIFI_BGN) != 0;
 #else
     bool has_wifi = false;

package/components/mikrojs/test/CMakeLists.txt

@@ -1,5 +1,7 @@
 # ble_test.cpp references mik__ble_consume which is only defined when
-# NimBLE (CONFIG_BT_ENABLED) is available. Exclude it for BT-less builds.
+# NimBLE (CONFIG_BT_ENABLED) is available, and wifi_test.cpp references
+# mik__wifi_consume which needs CONFIG_MIKROJS_WIFI. Exclude each for
+# builds without its stack.
 set(_MIK_TEST_SRCS
     abort_test.cpp
     fs_js_test.cpp
@@ -25,11 +27,13 @@ set(_MIK_TEST_SRCS
     timers_test.cpp
     udp_test.cpp
     watchdog_test.cpp
-    wifi_test.cpp
 )
 if(CONFIG_BT_ENABLED)
     list(APPEND _MIK_TEST_SRCS ble_test.cpp)
 endif()
+if(CONFIG_MIKROJS_WIFI)
+    list(APPEND _MIK_TEST_SRCS wifi_test.cpp)
+endif()
 
 idf_component_register(SRCS ${_MIK_TEST_SRCS}
         INCLUDE_DIRS "."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikrojs/firmware",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "Mikro.js ESP32 firmware: ESP-IDF component, build tools, and project template",
   "keywords": [
     "esp-idf",
@@ -47,8 +47,8 @@
   },
   "dependencies": {
     "esbuild": "^0.28.0",
-    "@mikrojs/native": "0.20.0",
-    "@mikrojs/quickjs": "0.20.0"
+    "@mikrojs/native": "0.20.1",
+    "@mikrojs/quickjs": "0.20.1"
   },
   "engines": {
     "node": ">=24.0.0"