@mikrojs/native 0.0.7

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+export interface MikroRuntimeOptions {
+    memLimit?: number;
+    stackSize?: number;
+    fsBasePath?: string;
+    fsRoot?: string;
+    fsLimit?: number;
+    fsReadMax?: number;
+    env?: Record<string, string>;
+    /** Virtual module sources to register, keyed by module name (e.g. 'native:pin'). */
+    modules?: Record<string, string>;
+}
+export interface HostMessage {
+    type: string;
+    data: string;
+}
+export interface ProfileEntry {
+    name: string;
+    deltaBytes: number;
+    order: number;
+}
+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;
+    dispose(): void;
+    registerModuleSource(name: string, source: string): void;
+    drainMessages(): HostMessage[];
+    postMessage(type: string, data: string): void;
+    setPreprocessor(fn: (filename: string, source: string) => string | undefined): void;
+    setRpcHandler(handler: (method: string, argsJson: string) => string | Promise<string>): void;
+    enableProfiling(): void;
+    getProfile(): ProfileEntry[];
+    getProfileBaseline(): number;
+}
+export interface NativeBindings {
+    MikroRuntime: new (options?: MikroRuntimeOptions) => NativeMikroRuntime;
+    jsonToBjson(json: string): Buffer;
+    compileBytecode(source: string, moduleName: string, externals?: string[]): Buffer;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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,oFAAoF;IACpF,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;CAC7B;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;CAClF"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../addon/types.ts"],"names":[],"mappings":""}

package/include/byteorder_apple.h

@@ -0,0 +1,11 @@
+// Apple uses libkern/OSByteOrder.h instead of <endian.h> / <sys/endian.h>.
+// nanocbor expects htobe16/32/64 and be16toh/32toh/64toh names; map them.
+#pragma once
+#include <libkern/OSByteOrder.h>
+
+#define htobe16(x) OSSwapHostToBigInt16(x)
+#define htobe32(x) OSSwapHostToBigInt32(x)
+#define htobe64(x) OSSwapHostToBigInt64(x)
+#define be16toh(x) OSSwapBigToHostInt16(x)
+#define be32toh(x) OSSwapBigToHostInt32(x)
+#define be64toh(x) OSSwapBigToHostInt64(x)

package/include/byteorder_windows.h

@@ -0,0 +1,12 @@
+// MSVC has no <endian.h>. Windows is always little-endian on the
+// architectures we ship (x64, arm64), so map nanocbor's htobe*/be*toh to
+// _byteswap_* intrinsics from <stdlib.h>.
+#pragma once
+#include <stdlib.h>
+
+#define htobe16(x) _byteswap_ushort(x)
+#define htobe32(x) _byteswap_ulong(x)
+#define htobe64(x) _byteswap_uint64(x)
+#define be16toh(x) _byteswap_ushort(x)
+#define be32toh(x) _byteswap_ulong(x)
+#define be64toh(x) _byteswap_uint64(x)

package/include/mikrojs/cbor_helpers.h

@@ -0,0 +1,24 @@
+/**
+ * Internal CBOR encode/decode helpers for JSValue ↔ nanocbor.
+ * Used by mik_cbor.cpp (user-facing module) and mik_rtc.cpp (RTC storage).
+ */
+
+#pragma once
+
+#include <nanocbor/nanocbor.h>
+#include <quickjs.h>
+
+#define MIK_CBOR_MAX_DEPTH 32
+
+/**
+ * Recursively encode a JS value into a nanocbor encoder.
+ * Returns 0 on success, negative on error.
+ * Works with both NULL-buffer (size calculation) and real-buffer passes.
+ */
+int mik__cbor_encode_value(JSContext* ctx, nanocbor_encoder_t* enc, JSValue val, int depth);
+
+/**
+ * Decode one CBOR value from a nanocbor decoder into a JS value.
+ * Returns JS_EXCEPTION on error.
+ */
+JSValue mik__cbor_decode_value(JSContext* ctx, nanocbor_value_t* val, int depth);

package/include/mikrojs/cutils_wrap.h

@@ -0,0 +1,59 @@
+/* C++ compatible wrapper for QuickJS cutils.h.
+ *
+ * cutils.h contains inline functions with implicit void* → typed pointer
+ * conversions that are valid in C but errors in C++/Clang.
+ *
+ * - On GCC: -fpermissive downgrades these to warnings, so we can include
+ *   cutils.h directly.
+ * - On Clang: we provide standalone declarations that map to wrapper
+ *   functions in cutils_compat.c.
+ * - In C: just include cutils.h directly.
+ */
+#pragma once
+
+#if !defined(__cplusplus) || (defined(__GNUC__) && !defined(__clang__))
+/* C code, or GCC C++ (where -fpermissive handles the void* casts) */
+#include <cutils.h>
+#else
+/* Clang C++ — cannot include cutils.h inline functions, use wrappers */
+
+#include <stdint.h>
+#include <stddef.h>
+
+extern "C" {
+
+/* Must match the DynBuf definition in cutils.h exactly */
+typedef void *DynBufReallocFunc(void *opaque, void *ptr, size_t size);
+
+typedef struct DynBuf {
+    uint8_t *buf;
+    size_t size;
+    size_t allocated_size;
+    int error;
+    DynBufReallocFunc *realloc_func;
+    void *opaque;
+} DynBuf;
+
+/* Wrapper functions defined in cutils_compat.c */
+int mik__dbuf_put(DynBuf *s, const void *data, size_t len);
+int mik__dbuf_putc(DynBuf *s, uint8_t val);
+int mik__dbuf_putstr(DynBuf *s, const char *str);
+void mik__dbuf_free(DynBuf *s);
+void mik__dbuf_init2(DynBuf *s, void *opaque, DynBufReallocFunc *realloc_func);
+int mik__js_has_suffix(const char *str, const char *suffix);
+void mik__js_pstrcpy(char *buf, int buf_size, const char *str);
+char *mik__js_pstrcat(char *buf, int buf_size, const char *s);
+
+/* Map original names to wrapper names */
+#define dbuf_put mik__dbuf_put
+#define dbuf_putc mik__dbuf_putc
+#define dbuf_putstr mik__dbuf_putstr
+#define dbuf_free mik__dbuf_free
+#define dbuf_init2 mik__dbuf_init2
+#define js__has_suffix mik__js_has_suffix
+#define js__pstrcpy mik__js_pstrcpy
+#define js__pstrcat mik__js_pstrcat
+
+}  /* extern "C" */
+
+#endif

package/include/mikrojs/errors.h

@@ -0,0 +1,144 @@
+#ifndef MIK_ERRORS_H
+#define MIK_ERRORS_H
+
+/**
+ * mikrojs error codes.
+ *
+ * Platform-independent error codes starting at 0x8000 to avoid collision
+ * with platform-specific error codes (ESP-IDF uses 0x1XX–0xXXXX).
+ *
+ * Native result error objects carry:
+ *   - code:    mikrojs error code (always present)
+ *   - message: human-readable description
+ *   - errno:   platform error code (e.g. esp_err_t), only when non-zero
+ */
+
+#define MIK_ERR_BASE 0x8000
+
+#define MIK_ERR_INVALID_PIN        (MIK_ERR_BASE + 1)
+#define MIK_ERR_SET_MODE_FAILED    (MIK_ERR_BASE + 2)
+#define MIK_ERR_WRITE_FAILED       (MIK_ERR_BASE + 3)
+#define MIK_ERR_ADC_INIT_FAILED    (MIK_ERR_BASE + 4)
+#define MIK_ERR_INVALID_ADC_PIN    (MIK_ERR_BASE + 5)
+#define MIK_ERR_ADC_READ_FAILED    (MIK_ERR_BASE + 6)
+
+/* I2C errors */
+#define MIK_ERR_I2C_BUS_INIT      (MIK_ERR_BASE + 0x10)
+#define MIK_ERR_I2C_BUS_DEINIT    (MIK_ERR_BASE + 0x11)
+#define MIK_ERR_I2C_NOT_STARTED   (MIK_ERR_BASE + 0x12)
+#define MIK_ERR_I2C_ADD_DEVICE    (MIK_ERR_BASE + 0x13)
+#define MIK_ERR_I2C_WRITE         (MIK_ERR_BASE + 0x14)
+#define MIK_ERR_I2C_READ          (MIK_ERR_BASE + 0x15)
+#define MIK_ERR_I2C_WRITE_TOO_LARGE (MIK_ERR_BASE + 0x16)
+#define MIK_ERR_I2C_MISSING_PINS  (MIK_ERR_BASE + 0x17)
+
+/* WiFi errors */
+#define MIK_ERR_WIFI_INIT_FAILED       (MIK_ERR_BASE + 0x20)
+#define MIK_ERR_WIFI_START_FAILED      (MIK_ERR_BASE + 0x21)
+#define MIK_ERR_WIFI_COUNTRY_NOT_SET   (MIK_ERR_BASE + 0x22)
+#define MIK_ERR_WIFI_CONNECT_FAILED    (MIK_ERR_BASE + 0x23)
+#define MIK_ERR_WIFI_CONNECT_IN_PROGRESS (MIK_ERR_BASE + 0x24)
+#define MIK_ERR_WIFI_DISCONNECT_FAILED (MIK_ERR_BASE + 0x25)
+#define MIK_ERR_WIFI_SCAN_FAILED       (MIK_ERR_BASE + 0x26)
+#define MIK_ERR_WIFI_SCAN_IN_PROGRESS  (MIK_ERR_BASE + 0x27)
+#define MIK_ERR_WIFI_NOT_INITIALIZED   (MIK_ERR_BASE + 0x28)
+#define MIK_ERR_WIFI_CONFIG_FAILED     (MIK_ERR_BASE + 0x29)
+#define MIK_ERR_WIFI_AP_START_FAILED   (MIK_ERR_BASE + 0x2A)
+#define MIK_ERR_WIFI_AP_STOP_FAILED    (MIK_ERR_BASE + 0x2B)
+#define MIK_ERR_WIFI_SET_FAILED        (MIK_ERR_BASE + 0x2C)
+#define MIK_ERR_WIFI_GET_FAILED        (MIK_ERR_BASE + 0x2D)
+
+/* SPI errors */
+#define MIK_ERR_SPI_BUS_INIT      (MIK_ERR_BASE + 0x30)
+#define MIK_ERR_SPI_ADD_DEVICE    (MIK_ERR_BASE + 0x31)
+#define MIK_ERR_SPI_NOT_STARTED   (MIK_ERR_BASE + 0x32)
+#define MIK_ERR_SPI_TRANSFER      (MIK_ERR_BASE + 0x33)
+#define MIK_ERR_SPI_WRITE         (MIK_ERR_BASE + 0x34)
+#define MIK_ERR_SPI_MISSING_PINS  (MIK_ERR_BASE + 0x35)
+
+/* PWM errors */
+#define MIK_ERR_PWM_NO_CHANNEL    (MIK_ERR_BASE + 0x40)
+#define MIK_ERR_PWM_NO_TIMER      (MIK_ERR_BASE + 0x41)
+#define MIK_ERR_PWM_CONFIG        (MIK_ERR_BASE + 0x42)
+#define MIK_ERR_PWM_NOT_ACTIVE    (MIK_ERR_BASE + 0x43)
+#define MIK_ERR_PWM_DUTY          (MIK_ERR_BASE + 0x44)
+#define MIK_ERR_PWM_FREQ          (MIK_ERR_BASE + 0x45)
+#define MIK_ERR_PWM_FADE          (MIK_ERR_BASE + 0x46)
+
+/* Sleep errors */
+#define MIK_ERR_SLEEP_WAKEUP_CONFIG   (MIK_ERR_BASE + 0x60)
+#define MIK_ERR_SLEEP_LIGHT_SLEEP     (MIK_ERR_BASE + 0x61)
+#define MIK_ERR_SLEEP_DISABLE_WAKEUP  (MIK_ERR_BASE + 0x62)
+
+/* NeoPixel errors */
+#define MIK_ERR_NEOPIXEL_NOT_ACTIVE   (MIK_ERR_BASE + 0x50)
+#define MIK_ERR_NEOPIXEL_INDEX_RANGE  (MIK_ERR_BASE + 0x51)
+#define MIK_ERR_NEOPIXEL_SHOW         (MIK_ERR_BASE + 0x52)
+
+/* SNTP errors */
+#define MIK_ERR_SNTP_INIT_FAILED      (MIK_ERR_BASE + 0x70)
+#define MIK_ERR_SNTP_CANCELLED        (MIK_ERR_BASE + 0x71)
+
+/* HTTP errors */
+#define MIK_ERR_HTTP_TOO_MANY_PENDING (MIK_ERR_BASE + 0x80)
+#define MIK_ERR_HTTP_TASK_FAILED      (MIK_ERR_BASE + 0x81)
+#define MIK_ERR_HTTP_REQUEST_FAILED   (MIK_ERR_BASE + 0x82)
+#define MIK_ERR_HTTP_CANCELLED        (MIK_ERR_BASE + 0x83)
+
+/* CBOR errors */
+#define MIK_ERR_CBOR_ENCODE           (MIK_ERR_BASE + 0x90)
+#define MIK_ERR_CBOR_DECODE           (MIK_ERR_BASE + 0x91)
+
+/* UART errors */
+#define MIK_ERR_UART_DRIVER_INSTALL   (MIK_ERR_BASE + 0xA0)
+#define MIK_ERR_UART_SET_PIN          (MIK_ERR_BASE + 0xA1)
+#define MIK_ERR_UART_PARAM            (MIK_ERR_BASE + 0xA2)
+#define MIK_ERR_UART_WRITE            (MIK_ERR_BASE + 0xA3)
+#define MIK_ERR_UART_READ             (MIK_ERR_BASE + 0xA4)
+#define MIK_ERR_UART_NOT_STARTED      (MIK_ERR_BASE + 0xA5)
+#define MIK_ERR_UART_ALREADY_READING  (MIK_ERR_BASE + 0xA6)
+#define MIK_ERR_UART_NO_RX            (MIK_ERR_BASE + 0xA7)
+#define MIK_ERR_UART_NO_TX            (MIK_ERR_BASE + 0xA8)
+
+/* BLE errors */
+#define MIK_ERR_BLE_STACK_INIT_FAILED        (MIK_ERR_BASE + 0xB0)
+#define MIK_ERR_BLE_CONTROLLER_INIT_FAILED   (MIK_ERR_BASE + 0xB1)
+#define MIK_ERR_BLE_ADVERTISE_START_FAILED   (MIK_ERR_BASE + 0xB2)
+#define MIK_ERR_BLE_ADVERTISE_STOP_FAILED    (MIK_ERR_BASE + 0xB3)
+#define MIK_ERR_BLE_ALREADY_ADVERTISING      (MIK_ERR_BASE + 0xB4)
+#define MIK_ERR_BLE_SET_FAILED               (MIK_ERR_BASE + 0xB5)
+#define MIK_ERR_BLE_GET_FAILED               (MIK_ERR_BASE + 0xB6)
+#define MIK_ERR_BLE_STACK_SHUTDOWN           (MIK_ERR_BASE + 0xB7)
+#define MIK_ERR_BLE_NOT_INITIALIZED          (MIK_ERR_BASE + 0xB8)
+#define MIK_ERR_BLE_INVALID_UUID             (MIK_ERR_BASE + 0xB9)
+#define MIK_ERR_BLE_DUPLICATE_CHARACTERISTIC (MIK_ERR_BASE + 0xBA)
+#define MIK_ERR_BLE_INVALID_PROPERTIES       (MIK_ERR_BASE + 0xBB)
+#define MIK_ERR_BLE_GATT_REGISTRATION_FAILED (MIK_ERR_BASE + 0xBC)
+#define MIK_ERR_BLE_GATT_ALREADY_REGISTERED  (MIK_ERR_BASE + 0xBD)
+#define MIK_ERR_BLE_NO_SUCH_CHARACTERISTIC   (MIK_ERR_BASE + 0xBE)
+#define MIK_ERR_BLE_NOT_CONNECTED            (MIK_ERR_BASE + 0xBF)
+#define MIK_ERR_BLE_VALUE_TOO_LARGE          (MIK_ERR_BASE + 0xC0)
+#define MIK_ERR_BLE_NOTIFY_FAILED            (MIK_ERR_BASE + 0xC1)
+
+/* KV storage errors */
+#define MIK_ERR_KV_INVALID_KEY   (MIK_ERR_BASE + 0xD0)
+#define MIK_ERR_KV_ENCODE        (MIK_ERR_BASE + 0xD1)
+#define MIK_ERR_KV_TOO_LARGE     (MIK_ERR_BASE + 0xD2)
+#define MIK_ERR_KV_STORAGE_FULL  (MIK_ERR_BASE + 0xD3)
+#define MIK_ERR_KV_WRITE         (MIK_ERR_BASE + 0xD4)
+
+/* Filesystem errors — mikrojs/fs.
+ * Codes cover the curated FSError variants. Anything unexpected at the
+ * C/errno layer falls through to MIK_ERR_FS_UNKNOWN; the JS mapping layer
+ * produces FSError.Unknown carrying the raw errno and message. */
+#define MIK_ERR_FS_NOT_FOUND           (MIK_ERR_BASE + 0xE0)
+#define MIK_ERR_FS_ALREADY_EXISTS      (MIK_ERR_BASE + 0xE1)
+#define MIK_ERR_FS_ACCESS_DENIED       (MIK_ERR_BASE + 0xE2)
+#define MIK_ERR_FS_NO_SPACE            (MIK_ERR_BASE + 0xE3)
+#define MIK_ERR_FS_TOO_LARGE           (MIK_ERR_BASE + 0xE4)
+#define MIK_ERR_FS_IS_DIRECTORY        (MIK_ERR_BASE + 0xE5)
+#define MIK_ERR_FS_NOT_DIRECTORY       (MIK_ERR_BASE + 0xE6)
+#define MIK_ERR_FS_BAD_FILE_DESCRIPTOR (MIK_ERR_BASE + 0xE7)
+#define MIK_ERR_FS_UNKNOWN             (MIK_ERR_BASE + 0xE8)
+
+#endif  // MIK_ERRORS_H

package/include/mikrojs/mem.h

@@ -0,0 +1,11 @@
+#pragma once
+
+#include <stddef.h>
+#include <stdlib.h>
+
+size_t mik__malloc_usable_size(const void* ptr);
+void* mik__malloc(size_t size);
+void* mik__mallocz(size_t size);
+void* mik__calloc(size_t count, size_t size);
+void mik__free(void* ptr);
+void* mik__realloc(void* ptr, size_t size);

package/include/mikrojs/mik_color.h

@@ -0,0 +1,32 @@
+#pragma once
+
+#include <string>
+#include <string_view>
+
+/* Theme tokens — semantic categories for syntax highlighting */
+enum MikThemeToken {
+    MIK_TOKEN_ANNOTATION,
+    MIK_TOKEN_BOOLEAN,
+    MIK_TOKEN_COMMENT,
+    MIK_TOKEN_DATE,
+    MIK_TOKEN_ERROR,
+    MIK_TOKEN_WARNING,
+    MIK_TOKEN_FUNCTION,
+    MIK_TOKEN_IDENTIFIER,
+    MIK_TOKEN_KEYWORD,
+    MIK_TOKEN_NULL,
+    MIK_TOKEN_NUMBER,
+    MIK_TOKEN_OTHER,
+    MIK_TOKEN_REGEXP,
+    MIK_TOKEN_STRING,
+    MIK_TOKEN_SYMBOL,
+    MIK_TOKEN_TYPE,
+    MIK_TOKEN_UNDEFINED,
+    MIK_TOKEN_BIGINT,
+    MIK_TOKEN_RESULT,
+    MIK_TOKEN__COUNT,
+};
+
+/* Colorize a string with ANSI escapes for the given theme token.
+ * Returns the input unchanged if the token is invalid. */
+std::string mik_colorize(MikThemeToken token, std::string_view value);