mikrojs 0.0.0 → 0.0.8

package/dist/simulator/builtins/pin.js

@@ -0,0 +1,32 @@
+export const pinBuiltin = {
+    source: `// Simulator stub for pin
+// Runs inside the mikrojs runtime (QuickJS), not Node.js. Node built-ins are not available.
+import {ok} from 'mikrojs/result'
+import type {SimPin} from 'mikrojs/sim'
+
+const state: Record<number, {mode?: number; value?: number}> = {}
+
+export const pinMode: SimPin['pinMode'] = (pin, mode) => {
+  state[pin] = {...state[pin], mode}
+  return ok()
+}
+
+export const digitalWrite: SimPin['digitalWrite'] = (pin, value) => {
+  state[pin] = {...state[pin], value}
+  return ok()
+}
+
+export const digitalRead: SimPin['digitalRead'] = (pin) => {
+  return state[pin]?.value ?? 0
+}
+
+export const analogRead: SimPin['analogRead'] = (_pin, _attenuation) => {
+  return ok(Math.floor(Math.random() * 4096))
+}
+
+export const analogReadMillivolts: SimPin['analogReadMillivolts'] = (_pin, _attenuation) => {
+  return ok(Math.floor(Math.random() * 2500))
+}
+`,
+};
+//# sourceMappingURL=pin.js.map

package/dist/simulator/builtins/pin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin.js","sourceRoot":"","sources":["../../../src/simulator/builtins/pin.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BT;CACA,CAAA"}

package/dist/simulator/builtins/pwm.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinDefinition } from './types.js';
+export declare const pwmBuiltin: BuiltinDefinition;
+//# sourceMappingURL=pwm.d.ts.map

package/dist/simulator/builtins/pwm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwm.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/pwm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAA;AAIjD,eAAO,MAAM,UAAU,EAAE,iBA2BxB,CAAA"}

package/dist/simulator/builtins/pwm.js

@@ -0,0 +1,31 @@
+// pwm uses a raw source module instead of RPC because fade() returns
+// {ok, value: Promise<void>} which can't survive JSON serialization.
+export const pwmBuiltin = {
+    source: `
+import {ok} from 'mikrojs/result'
+
+export class Pwm {
+  #freq
+  #duty
+  constructor(_pin, freq, duty) {
+    this.#freq = freq
+    this.#duty = duty
+  }
+  duty(value) {
+    if (value !== undefined) this.#duty = value
+    return ok(this.#duty)
+  }
+  freq(value) {
+    if (value !== undefined) this.#freq = value
+    return ok(this.#freq)
+  }
+  fade(_target, _durationMs) {
+    return ok(Promise.resolve())
+  }
+  end() {
+    return ok()
+  }
+}
+`,
+};
+//# sourceMappingURL=pwm.js.map

package/dist/simulator/builtins/pwm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwm.js","sourceRoot":"","sources":["../../../src/simulator/builtins/pwm.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,qEAAqE;AACrE,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyBT;CACA,CAAA"}

package/dist/simulator/builtins/sleep.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinDefinition } from './types.js';
+export declare const sleepBuiltin: BuiltinDefinition;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/simulator/builtins/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/sleep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAA;AAIjD,eAAO,MAAM,YAAY,EAAE,iBA6B1B,CAAA"}

package/dist/simulator/builtins/sleep.js

@@ -0,0 +1,33 @@
+// sleep uses a raw source module so deepSleep can use setTimeout + restart,
+// and lightSleep can return a delayed Promise.
+export const sleepBuiltin = {
+    source: `
+import {restart} from 'native:sys'
+import {ok} from 'mikrojs/result'
+
+const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms))
+
+let wakeupCause = 'undefined'
+
+export function deepSleep(ms) {
+  // On device, deepSleep is \`never\` (chip resets after sleep).
+  // In the sim, wait the duration then restart the runtime.
+  console.warn('[sim] deepSleep(' + ms + 'ms)')
+  sleep(ms).then(() => restart())
+}
+
+export function lightSleep(ms) {
+  console.warn('[sim] lightSleep(' + ms + 'ms)')
+  // Block-ish: return a result after the delay
+  return ok()
+}
+
+export function getWakeupCause() { return wakeupCause }
+export function enableTimerWakeup() { return ok() }
+export function enableGpioWakeup() { return ok() }
+export function enableExt0Wakeup() { return ok() }
+export function enableExt1Wakeup() { return ok() }
+export function disableWakeupSource() { return ok() }
+`,
+};
+//# sourceMappingURL=sleep.js.map

package/dist/simulator/builtins/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/simulator/builtins/sleep.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BT;CACA,CAAA"}

package/dist/simulator/builtins/sntp.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinDefinition } from './types.js';
+export declare const sntpBuiltin: BuiltinDefinition;
+//# sourceMappingURL=sntp.d.ts.map

package/dist/simulator/builtins/sntp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sntp.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/sntp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAA;AAIjD,eAAO,MAAM,WAAW,EAAE,iBAUzB,CAAA"}

package/dist/simulator/builtins/sntp.js

@@ -0,0 +1,14 @@
+// sntp uses a raw source module instead of RPC because the native sync()
+// returns {ok, value: Promise<...>} which can't survive JSON serialization.
+export const sntpBuiltin = {
+    source: `
+import {ok} from 'mikrojs/result'
+
+export function sync(_servers, _timezone, _background) {
+  return ok(Promise.resolve(ok({time: Date.now()})))
+}
+export function stop() {}
+export function setTimezone(_tz) {}
+`,
+};
+//# sourceMappingURL=sntp.js.map

package/dist/simulator/builtins/sntp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sntp.js","sourceRoot":"","sources":["../../../src/simulator/builtins/sntp.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,MAAM,EAAE;;;;;;;;CAQT;CACA,CAAA"}

package/dist/simulator/builtins/spi.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinDefinition } from './types.js';
+export declare const spiBuiltin: BuiltinDefinition;
+//# sourceMappingURL=spi.d.ts.map

package/dist/simulator/builtins/spi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spi.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/spi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAA;AAEjD,eAAO,MAAM,UAAU,EAAE,iBAcxB,CAAA"}

package/dist/simulator/builtins/spi.js

@@ -0,0 +1,16 @@
+export const spiBuiltin = {
+    source: `// Simulator stub for spi
+// Runs inside the mikrojs runtime (QuickJS), not Node.js. Node built-ins are not available.
+import {ok} from 'mikrojs/result'
+import type {SimSpi} from 'mikrojs/sim'
+
+export class Spi implements SimSpi {
+  constructor(_hostNo: number, _options: Record<string, unknown>) {}
+  begin() { return ok() }
+  end() { return ok() }
+  transfer(data: Uint8Array) { return ok(new Uint8Array(data.length)) }
+  write(_data: Uint8Array) { return ok() }
+}
+`,
+};
+//# sourceMappingURL=spi.js.map

package/dist/simulator/builtins/spi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spi.js","sourceRoot":"","sources":["../../../src/simulator/builtins/spi.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,MAAM,EAAE;;;;;;;;;;;;CAYT;CACA,CAAA"}

package/dist/simulator/builtins/types.d.ts

@@ -0,0 +1,24 @@
+/** Map of builtin name to its native:* module name */
+export type BuiltinModuleMap = {
+    ble: 'native:ble';
+    pin: 'native:pin';
+    pwm: 'native:pwm';
+    neopixel: 'native:neopixel';
+    wifi: 'native:wifi';
+    i2c: 'native:i2c';
+    spi: 'native:spi';
+    uart: 'native:uart';
+    kv: 'native:rtc';
+    nvs_kv: 'native:nvs_kv';
+    sleep: 'native:sleep';
+    http: 'native:http';
+    sntp: 'native:sntp';
+    console: 'native:console';
+};
+export type BuiltinName = keyof BuiltinModuleMap;
+/** A builtin definition: JS source that replaces the native C module in the simulator */
+export interface BuiltinDefinition {
+    /** Raw module source string that runs inside QuickJS */
+    source: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/simulator/builtins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/types.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,YAAY,CAAA;IACjB,GAAG,EAAE,YAAY,CAAA;IACjB,GAAG,EAAE,YAAY,CAAA;IACjB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,IAAI,EAAE,aAAa,CAAA;IACnB,GAAG,EAAE,YAAY,CAAA;IACjB,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,aAAa,CAAA;IACnB,EAAE,EAAE,YAAY,CAAA;IAChB,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,cAAc,CAAA;IACrB,IAAI,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAA;AAEhD,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/simulator/builtins/types.js

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

package/dist/simulator/builtins/types.js.map

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

package/dist/simulator/builtins/uart.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinDefinition } from './types.js';
+export declare const uartBuiltin: BuiltinDefinition;
+//# sourceMappingURL=uart.d.ts.map

package/dist/simulator/builtins/uart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uart.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/uart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAA;AAEjD,eAAO,MAAM,WAAW,EAAE,iBAoBzB,CAAA"}

package/dist/simulator/builtins/uart.js

@@ -0,0 +1,22 @@
+export const uartBuiltin = {
+    source: `
+import {ok} from 'mikrojs/result'
+
+export class Uart {
+  constructor(_port, _options) {}
+  begin() { return ok() }
+  end() { return ok() }
+  write(_data) { return ok() }
+  read() {
+    // Return an async iterable that never yields (no real UART in sim)
+    const iter = {
+      next() { return new Promise(() => {}) },
+      return() { return Promise.resolve({done: true, value: undefined}) },
+      [Symbol.asyncIterator]() { return iter },
+    }
+    return ok(iter)
+  }
+}
+`,
+};
+//# sourceMappingURL=uart.js.map

package/dist/simulator/builtins/uart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uart.js","sourceRoot":"","sources":["../../../src/simulator/builtins/uart.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,MAAM,EAAE;;;;;;;;;;;;;;;;;;CAkBT;CACA,CAAA"}

package/dist/simulator/builtins/wifi.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinDefinition } from './types.js';
+export declare const wifiBuiltin: BuiltinDefinition;
+//# sourceMappingURL=wifi.d.ts.map

package/dist/simulator/builtins/wifi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifi.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/wifi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAA;AAIjD,eAAO,MAAM,WAAW,EAAE,iBAmDzB,CAAA"}

package/dist/simulator/builtins/wifi.js

@@ -0,0 +1,55 @@
+// wifi uses a raw source module instead of RPC because connect() and scan()
+// return {ok, value: Promise<...>} which can't survive JSON serialization.
+export const wifiBuiltin = {
+    source: `/* eslint-disable no-console */
+// Simulator stub for wifi
+// Runs inside the mikrojs runtime (QuickJS), not Node.js. Node built-ins are not available.
+import {ok} from 'mikrojs/result'
+import type {SimWifi} from 'mikrojs/sim'
+
+let connected = false
+let currentIp = '0.0.0.0'
+
+export class Wifi implements SimWifi {
+  connect(ssid: string, _passphrase: string) {
+    console.log('[sim] wifi.connect:', ssid)
+    connected = true
+    currentIp = '192.168.1.100'
+    const info = {ip: currentIp, netmask: '255.255.255.0', gateway: '192.168.1.1'}
+    return ok(Promise.resolve(ok(info)))
+  }
+  disconnect() { return ok() }
+  rssi() { return ok(-50) }
+  ip() { return currentIp }
+  status() { return connected ? 3 : 6 }
+  scan() { return ok(Promise.resolve(ok([] as never[]))) }
+  on() {}
+  off() {}
+  mac() { return ok('00:00:00:00:00:00') }
+  getHostname() { return 'mikrojs-sim' as string | undefined }
+  setHostname() { return ok() }
+  getIpConfig() {
+    if (!connected) return ok(undefined)
+    return ok({ip: currentIp, netmask: '255.255.255.0', gateway: '192.168.1.1', dns: '8.8.8.8'})
+  }
+  setIpConfig() { return ok() }
+  apStart() { return ok() }
+  apStop() { return ok() }
+  apIsActive() { return false }
+  apIp() { return undefined }
+  apStations() { return [] as {mac: string; rssi: number}[] }
+  apDeauthStation() { return ok() }
+  apGetInactiveTimeout() { return ok(300) }
+  apSetInactiveTimeout() { return ok() }
+  getTxPower() { return ok(20) }
+  setTxPower() { return ok() }
+  getRssiThreshold() { return -127 }
+  setRssiThreshold() { return ok() }
+  getPowerSave() { return 'NONE' }
+  setPowerSave() { return ok() }
+  getCountry() { return undefined }
+  setCountry() { return ok() }
+}
+`,
+};
+//# sourceMappingURL=wifi.js.map

package/dist/simulator/builtins/wifi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifi.js","sourceRoot":"","sources":["../../../src/simulator/builtins/wifi.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDT;CACA,CAAA"}

package/dist/simulator/devRunner.d.ts

@@ -0,0 +1,41 @@
+import { type HostMessage, MikroRuntime } from '@mikrojs/native';
+import { Subject } from 'rxjs';
+export interface DevRunnerOptions {
+    script: string;
+    memLimit?: number;
+    fsRoot?: string;
+    fsLimit?: number;
+    fsReadMax?: number;
+    env?: Record<string, string>;
+    /**
+     * User-provided stub sources keyed by module name (e.g. 'native:wifi').
+     * These override the default stubs. TypeScript is stripped before registration.
+     */
+    stubSources?: Record<string, string>;
+    /**
+     * Enable per-module memory profiling. Profile data is collected as modules
+     * are loaded and can be read via runtime.getProfile() after execution.
+     */
+    profile?: boolean;
+}
+export interface DevRunner {
+    /** Observable stream of host messages from the QuickJS runtime. */
+    messages$: Subject<HostMessage>;
+    /** Post a message into the QuickJS runtime (delivered on next loop tick). */
+    postMessage(type: string, data: string): void;
+    /** Start the event loop. Returns a cleanup function. */
+    start(): () => void;
+    /** Register a callback that runs on each tick, after loopOnce + drainMessages. */
+    onTick(callback: () => void): void;
+    /** When true, skips loopOnce (timers/promises freeze) but tick callbacks still run. */
+    paused: boolean;
+    /** The underlying MikroRuntime instance. */
+    runtime: MikroRuntime;
+}
+/**
+ * Create a QuickJS dev runner for the simulator.
+ * Default stubs provide mock implementations for all native modules.
+ * User stubs (from sim/*.stub.ts) override defaults.
+ */
+export declare function createDevRunner(options: DevRunnerOptions): DevRunner;
+//# sourceMappingURL=devRunner.d.ts.map

package/dist/simulator/devRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devRunner.d.ts","sourceRoot":"","sources":["../../src/simulator/devRunner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,KAAK,WAAW,EAAE,YAAY,EAAC,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAC,OAAO,EAAC,MAAM,MAAM,CAAA;AAwD5B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,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;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC/B,6EAA6E;IAC7E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,wDAAwD;IACxD,KAAK,IAAI,MAAM,IAAI,CAAA;IACnB,kFAAkF;IAClF,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;IAClC,uFAAuF;IACvF,MAAM,EAAE,OAAO,CAAA;IACf,4CAA4C;IAC5C,OAAO,EAAE,YAAY,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAgLpE"}

package/dist/simulator/devRunner.js

@@ -0,0 +1,201 @@
+import nodeFs from 'node:fs';
+import { stripTypeScriptTypes } from 'node:module';
+import * as pathlib from 'node:path';
+import { MikroRuntime } from '@mikrojs/native';
+import { Subject } from 'rxjs';
+import { builtinModuleNames, defaultBuiltins } from './builtins/index.js';
+const DEFAULT_MEM_LIMIT = 300 * 1024; // 300 KB
+const DEFAULT_FS_ROOT = '.mikro/sim-fs';
+const DEFAULT_FS_LIMIT = 1024 * 1024; // 1 MB
+async function rpcHttpFetch(args) {
+    const init = { method: args.method ?? 'GET' };
+    if (args.headers && args.headers.length > 0)
+        init.headers = args.headers;
+    if (args.body)
+        init.body = Buffer.from(args.body, 'base64');
+    const res = await fetch(args.url, init);
+    const headers = [];
+    res.headers.forEach((v, k) => headers.push([k, v]));
+    const buf = Buffer.from(await res.arrayBuffer());
+    return { status: res.status, headers, body: buf.toString('base64') };
+}
+function nvsKvPath(fsRoot) {
+    return pathlib.join(pathlib.dirname(fsRoot), 'nvs_kv.json');
+}
+function readNvsKvStore(fsRoot) {
+    try {
+        return JSON.parse(nodeFs.readFileSync(nvsKvPath(fsRoot), 'utf-8'));
+    }
+    catch {
+        return { entries: {} };
+    }
+}
+function writeNvsKvStore(fsRoot, store) {
+    nodeFs.writeFileSync(nvsKvPath(fsRoot), JSON.stringify(store, null, 2) + '\n');
+}
+/**
+ * Create a QuickJS dev runner for the simulator.
+ * Default stubs provide mock implementations for all native modules.
+ * User stubs (from sim/*.stub.ts) override defaults.
+ */
+export function createDevRunner(options) {
+    const { script, env, memLimit = DEFAULT_MEM_LIMIT, fsLimit = DEFAULT_FS_LIMIT, fsReadMax } = options;
+    const fsRoot = pathlib.resolve(options.fsRoot ?? DEFAULT_FS_ROOT);
+    nodeFs.mkdirSync(fsRoot, { recursive: true });
+    // Resolve the entry script to a logical path rooted at fsRoot (e.g.
+    // /app/http/foo.test.bjs). Passing a logical path — rather than an
+    // absolute host path — lets bytecode's baked module names (also logical,
+    // e.g. /app/http/foo.test.js) line up with the runtime module resolver, so
+    // cross-file imports inside bytecode modules resolve against fsRoot via
+    // fs_base_path (set below).
+    let logicalScript;
+    if (pathlib.isAbsolute(script)) {
+        // Subprocess mode: script is already inside fsRoot.
+        const rel = pathlib.relative(fsRoot, script);
+        if (rel.startsWith('..') || pathlib.isAbsolute(rel)) {
+            throw new Error(`Script ${script} is not inside fsRoot ${fsRoot}; cannot compute logical path.`);
+        }
+        logicalScript = '/' + rel.split(pathlib.sep).join('/');
+    }
+    else {
+        // In-process dev mode: symlink the script's top-level directory into
+        // fsRoot so the runtime can read it via the fs_base_path prefix.
+        const topDir = script.split(pathlib.sep)[0];
+        if (topDir) {
+            const appDir = pathlib.resolve(topDir);
+            const appLink = pathlib.join(fsRoot, topDir);
+            try {
+                const existing = nodeFs.readlinkSync(appLink);
+                if (existing !== appDir) {
+                    nodeFs.unlinkSync(appLink);
+                    nodeFs.symlinkSync(appDir, appLink);
+                }
+            }
+            catch {
+                nodeFs.rmSync(appLink, { force: true, recursive: true });
+                nodeFs.symlinkSync(appDir, appLink);
+            }
+        }
+        logicalScript = '/' + script.split(pathlib.sep).join('/');
+    }
+    // Register virtual modules: default stubs, then user overrides
+    const modules = {};
+    for (const [name, builtin] of Object.entries(defaultBuiltins)) {
+        const moduleName = builtinModuleNames[name];
+        if (!moduleName)
+            continue;
+        modules[moduleName] = stripTypeScriptTypes(builtin.source, { mode: 'strip' });
+    }
+    // User stub sources override defaults (already stripped by loadSimStubs)
+    if (options.stubSources) {
+        for (const [moduleName, source] of Object.entries(options.stubSources)) {
+            modules[moduleName] = source;
+        }
+    }
+    // fsBasePath enables logical module resolution: the runtime prepends it to
+    // /-prefixed module names so bytecode's baked names can resolve to sim-fs.
+    const runtime = new MikroRuntime({
+        memLimit,
+        env,
+        fsRoot,
+        fsBasePath: fsRoot,
+        fsLimit,
+        fsReadMax,
+        modules,
+    });
+    // Profiling must be enabled before any module loads to capture the full
+    // import graph. Do it immediately after runtime construction, before the
+    // stub/console bootstrap registers or evaluates anything.
+    if (options.profile) {
+        runtime.enableProfiling();
+    }
+    // Strip TypeScript types from .ts files before QuickJS compiles them
+    runtime.setPreprocessor((filename, source) => {
+        if (filename.endsWith('.ts')) {
+            return stripTypeScriptTypes(source, { mode: 'strip' });
+        }
+        return undefined;
+    });
+    // RPC handler: bridges QuickJS host.call(...) to Node-side capabilities.
+    // Returns a string for sync methods (host.call resolves immediately on
+    // the QuickJS side) and a Promise for async ones (host.call returns a JS
+    // Promise). Keeping nvs_kv ops sync matches firmware NVS semantics —
+    // `set` is expected to be observable on the next read in the same tick.
+    runtime.setRpcHandler((method, argsJson) => {
+        if (method === 'http.fetch') {
+            return rpcHttpFetch(JSON.parse(argsJson)).then((r) => JSON.stringify(r));
+        }
+        if (method === 'nvs_kv.list') {
+            return JSON.stringify(readNvsKvStore(fsRoot).entries);
+        }
+        if (method === 'nvs_kv.set') {
+            const { key, value } = JSON.parse(argsJson);
+            const store = readNvsKvStore(fsRoot);
+            store.entries[key] = value;
+            writeNvsKvStore(fsRoot, store);
+            return '{}';
+        }
+        if (method === 'nvs_kv.remove') {
+            const { key } = JSON.parse(argsJson);
+            const store = readNvsKvStore(fsRoot);
+            const existed = key in store.entries;
+            if (existed) {
+                const { [key]: _omit, ...rest } = store.entries;
+                writeNvsKvStore(fsRoot, { entries: rest });
+            }
+            return JSON.stringify({ existed });
+        }
+        if (method === 'nvs_kv.clear') {
+            writeNvsKvStore(fsRoot, { entries: {} });
+            return '{}';
+        }
+        throw new Error(`Unknown sim RPC method: ${method}`);
+    });
+    const messages$ = new Subject();
+    const tickCallbacks = [];
+    function start() {
+        // Bootstrap console and evaluate user script inside start() so that
+        // messages$ subscriptions are active before any messages are emitted.
+        if (modules['native:console']) {
+            runtime.evalModuleContent('native:dev_bootstrap', "import 'native:console'");
+        }
+        runtime.evalModule(logicalScript);
+        // Drain any messages produced during evalModule
+        for (const msg of runtime.drainMessages()) {
+            messages$.next(msg);
+        }
+        let stopped = false;
+        function tick() {
+            if (stopped)
+                return;
+            if (!handle.paused)
+                runtime.loopOnce();
+            for (const msg of runtime.drainMessages()) {
+                messages$.next(msg);
+            }
+            for (const cb of tickCallbacks) {
+                cb();
+            }
+            setImmediate(tick);
+        }
+        setImmediate(tick);
+        return () => {
+            stopped = true;
+            messages$.complete();
+        };
+    }
+    const handle = {
+        messages$,
+        postMessage(type, data) {
+            runtime.postMessage(type, data);
+        },
+        start,
+        onTick(callback) {
+            tickCallbacks.push(callback);
+        },
+        paused: false,
+        runtime,
+    };
+    return handle;
+}
+//# sourceMappingURL=devRunner.js.map

package/dist/simulator/devRunner.js.map

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

package/dist/simulator/loadSimStubs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Load user-provided sim stubs from the `sim/` directory.
+ *
+ * Each `sim/<name>.stub.ts` file is a JS/TS module that directly implements
+ * the corresponding `native:*` native module. The source is read as text,
+ * TypeScript types are stripped, and the result is registered as a virtual
+ * module in the QuickJS runtime (replacing the native C module).
+ *
+ * Stubs run inside QuickJS, not in Node.js. They should export the same
+ * interface as the native module they replace.
+ *
+ * Returns a map of native:* module name → source string.
+ */
+export declare function loadSimStubs(projectDir: string): Record<string, string>;
+//# sourceMappingURL=loadSimStubs.d.ts.map

package/dist/simulator/loadSimStubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadSimStubs.d.ts","sourceRoot":"","sources":["../../src/simulator/loadSimStubs.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgCvE"}