mikrojs 0.0.0 → 0.0.8

package/dist/cli/lib/useObservable.d.ts

@@ -0,0 +1,4 @@
+import type { Observable } from 'rxjs';
+export declare function useObservable<T, U>(observable: Observable<T>, initialValue: U): T | U;
+export declare function useObservable<T>(observable: Observable<T>): T | undefined;
+//# sourceMappingURL=useObservable.d.ts.map

package/dist/cli/lib/useObservable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObservable.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/useObservable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,MAAM,CAAA;AAGpC,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACtF,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA"}

package/dist/cli/lib/useObservable.js

@@ -0,0 +1,22 @@
+import { useEffect, useState } from 'react';
+import { tap } from 'rxjs/operators';
+export function useObservable(observable, initialValue) {
+    const [state, setState] = useState(initialValue);
+    useEffect(() => {
+        const sub = observable
+            .pipe(tap({
+            error: (err) => {
+                setState(() => {
+                    throw err;
+                });
+            },
+            next: (v) => setState(v),
+        }))
+            .subscribe();
+        return () => {
+            sub.unsubscribe();
+        };
+    }, [observable]);
+    return state;
+}
+//# sourceMappingURL=useObservable.js.map

package/dist/cli/lib/useObservable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObservable.js","sourceRoot":"","sources":["../../../src/cli/lib/useObservable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAA;AAIlC,MAAM,UAAU,aAAa,CAC3B,UAAyB,EACzB,YAAgB;IAEhB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAoB,YAAY,CAAC,CAAA;IACnE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,GAAG,GAAG,UAAU;aACnB,IAAI,CACH,GAAG,CAAC;YACF,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;gBACb,QAAQ,CAAC,GAAG,EAAE;oBACZ,MAAM,GAAG,CAAA;gBACX,CAAC,CAAC,CAAA;YACJ,CAAC;YACD,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;SACzB,CAAC,CACH;aACA,SAAS,EAAE,CAAA;QAEd,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,WAAW,EAAE,CAAA;QACnB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAEhB,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/cli/lib/watcher.d.ts

@@ -0,0 +1,10 @@
+import { Subject } from 'rxjs';
+export interface WatchEvent {
+    type: 'change' | 'rename';
+    filename: string | null;
+}
+export declare function createWatcher(dir: string, debounceMs?: number): {
+    changes$: Subject<WatchEvent[]>;
+    close: () => void;
+};
+//# sourceMappingURL=watcher.d.ts.map

package/dist/cli/lib/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/watcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,EAAC,MAAM,MAAM,CAAA;AAE5B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,UAAU,SAAM,GACf;IACD,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAiCA"}

package/dist/cli/lib/watcher.js

@@ -0,0 +1,34 @@
+import { watch } from 'node:fs';
+import { Subject } from 'rxjs';
+export function createWatcher(dir, debounceMs = 200) {
+    const changes$ = new Subject();
+    let pending = [];
+    let timer = null;
+    const watcher = watch(dir, { recursive: true }, (eventType, filename) => {
+        // Ignore hidden files (covers .mikro/, .git/, etc)
+        if (filename && filename.startsWith('.')) {
+            return;
+        }
+        // Ignore node_modules
+        if (filename && filename.includes('node_modules')) {
+            return;
+        }
+        pending.push({ type: eventType, filename });
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            const batch = pending;
+            pending = [];
+            timer = null;
+            changes$.next(batch);
+        }, debounceMs);
+    });
+    const close = () => {
+        if (timer)
+            clearTimeout(timer);
+        watcher.close();
+        changes$.complete();
+    };
+    return { changes$, close };
+}
+//# sourceMappingURL=watcher.js.map

package/dist/cli/lib/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../../src/cli/lib/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,SAAS,CAAA;AAE7B,OAAO,EAAC,OAAO,EAAC,MAAM,MAAM,CAAA;AAO5B,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,UAAU,GAAG,GAAG;IAKhB,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAgB,CAAA;IAC5C,IAAI,OAAO,GAAiB,EAAE,CAAA;IAC9B,IAAI,KAAK,GAAyC,IAAI,CAAA;IAEtD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QACpE,mDAAmD;QACnD,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,OAAM;QACR,CAAC;QACD,sBAAsB;QACtB,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAClD,OAAM;QACR,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,SAAgC,EAAE,QAAQ,EAAC,CAAC,CAAA;QAEhE,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAA;QAC9B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,MAAM,KAAK,GAAG,OAAO,CAAA;YACrB,OAAO,GAAG,EAAE,CAAA;YACZ,KAAK,GAAG,IAAI,CAAA;YACZ,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC,EAAE,UAAU,CAAC,CAAA;IAChB,CAAC,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAA;QAC9B,OAAO,CAAC,KAAK,EAAE,CAAA;QACf,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACrB,CAAC,CAAA;IAED,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,CAAA;AAC1B,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,13 @@
+export declare const BUILTINS: string[];
+/** Module patterns that are always firmware builtins (not deployed or bundled with user code).
+ * Shared by the CLI build/deploy and esbuild config. The same patterns are used in
+ * bundle-runtime.js (CMake build context) and must be kept in sync manually there.
+ * Note: @mikrojs/* packages are NOT automatically builtins. Only packages with native
+ * code (those that export ./cmake) are firmware builtins. Pure JS @mikrojs/* packages
+ * are bundled and deployed with the user's app. */
+export declare const BUILTIN_EXTERNALS: string[];
+/** Check if a module specifier matches a firmware builtin pattern.
+ * Note: @mikrojs/* packages are only builtins if they have native code.
+ * The trace resolver handles this dynamically by checking for ./cmake exports. */
+export declare function isBuiltinModule(id: string): boolean;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,UAYpB,CAAA;AAED;;;;;mDAKmD;AACnD,eAAO,MAAM,iBAAiB,UAAyC,CAAA;AAEvE;;kFAEkF;AAClF,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/constants.js

@@ -0,0 +1,27 @@
+export const BUILTINS = [
+    'cbor',
+    'fetch',
+    'fs',
+    'pin',
+    'i2c',
+    'kv',
+    'result',
+    'schema',
+    'sleep',
+    'sys',
+    'wifi',
+];
+/** Module patterns that are always firmware builtins (not deployed or bundled with user code).
+ * Shared by the CLI build/deploy and esbuild config. The same patterns are used in
+ * bundle-runtime.js (CMake build context) and must be kept in sync manually there.
+ * Note: @mikrojs/* packages are NOT automatically builtins. Only packages with native
+ * code (those that export ./cmake) are firmware builtins. Pure JS @mikrojs/* packages
+ * are bundled and deployed with the user's app. */
+export const BUILTIN_EXTERNALS = ['mikrojs', 'mikrojs/*', '@mikrojs/*'];
+/** Check if a module specifier matches a firmware builtin pattern.
+ * Note: @mikrojs/* packages are only builtins if they have native code.
+ * The trace resolver handles this dynamically by checking for ./cmake exports. */
+export function isBuiltinModule(id) {
+    return BUILTINS.includes(id) || id === 'mikrojs' || id.startsWith('mikrojs/');
+}
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,MAAM;IACN,OAAO;IACP,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,KAAK;IACL,MAAM;CACP,CAAA;AAED;;;;;mDAKmD;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;AAEvE;;kFAEkF;AAClF,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAC/E,CAAC"}

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

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

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

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

package/dist/simulator/builtins/ble.js

@@ -0,0 +1,46 @@
+// ble uses a raw source module (not RPC) to match the native class shape exactly
+// and keep its synchronous getter/setter semantics.
+export const bleBuiltin = {
+    source: `/* eslint-disable no-console */
+// Simulator stub for ble
+// Runs inside the mikrojs runtime (QuickJS), not Node.js. Node built-ins are not available.
+import {err, ok} from 'mikrojs/result'
+
+let currentName = 'mikrojs-sim'
+let currentTxPower = 0
+let advertising = false
+
+export class Ble {
+  getName() { return currentName }
+  setName(name) { currentName = name; return ok() }
+  getAddress() { return ok('00:00:00:00:00:00') }
+  getTxPower() { return ok(currentTxPower) }
+  setTxPower(dbm) { currentTxPower = dbm; return ok() }
+  advertise(_options) {
+    if (advertising) {
+      return err({name: 'AlreadyAdvertising', message: 'already advertising'})
+    }
+    advertising = true
+    console.log('[sim] ble.advertise')
+    return ok()
+  }
+  stopAdvertising() {
+    advertising = false
+    return ok()
+  }
+  stop() {
+    advertising = false
+    return ok()
+  }
+  setValue(_serviceUuid, _characteristicUuid, _value) {
+    return ok()
+  }
+  notify(_serviceUuid, _characteristicUuid, _value) {
+    return ok()
+  }
+  on(_event, _listener) {}
+  off(_event, _listener) {}
+}
+`,
+};
+//# sourceMappingURL=ble.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { BuiltinDefinition } from './types.js';
+/**
+ * Console builtin uses a raw source string because it patches globalThis.console
+ * rather than exporting a native:* module. This is a special case — all other
+ * builtins use the methods/RPC pattern.
+ */
+export declare const consoleBuiltin: BuiltinDefinition;
+//# sourceMappingURL=console.d.ts.map

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

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

package/dist/simulator/builtins/console.js

@@ -0,0 +1,24 @@
+/**
+ * Console builtin uses a raw source string because it patches globalThis.console
+ * rather than exporting a native:* module. This is a special case — all other
+ * builtins use the methods/RPC pattern.
+ */
+export const consoleBuiltin = {
+    source: `
+import { send } from 'native:host'
+import { inspect } from 'mikrojs/inspect'
+
+function format(args) {
+  return JSON.stringify(args.map(a => typeof a === 'string' ? a : inspect(a)))
+}
+
+globalThis.console = {
+  log(...args) { send('console:log', format(args)) },
+  warn(...args) { send('console:warn', format(args)) },
+  error(...args) { send('console:error', format(args)) },
+  info(...args) { send('console:info', format(args)) },
+  debug(...args) { send('console:debug', format(args)) },
+}
+`,
+};
+//# sourceMappingURL=console.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/simulator/builtins/console.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,MAAM,EAAE;;;;;;;;;;;;;;;CAeT;CACA,CAAA"}

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

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

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

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

package/dist/simulator/builtins/http.js

@@ -0,0 +1,90 @@
+// http delegates to Node's global fetch via the dev runner's RPC handler
+// ('http.fetch'). The QuickJS-side stub keeps a per-request message queue so
+// nextMessage() can deliver the body as one chunk followed by {kind: 'end'},
+// matching the streaming contract that mikrojs/http expects from native:http.
+export const httpBuiltin = {
+    source: `/* eslint-disable no-console */
+// Simulator stub for http
+// Runs inside the mikrojs runtime (QuickJS), not Node.js. Node built-ins are not available.
+import {call} from 'native:host'
+import {err, ok} from 'mikrojs/result'
+import type {SimHttp} from 'mikrojs/sim'
+
+let nextId = 0
+const queues = new Map() // id -> message[]
+
+function base64ToBytes(b64: string): Uint8Array {
+  const bin = atob(b64)
+  const out = new Uint8Array(bin.length)
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i)
+  return out
+}
+
+function bytesToBase64(bytes: Uint8Array): string {
+  let bin = ''
+  for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]!)
+  return btoa(bin)
+}
+
+// request() returns a discriminated union (not a Result) on success, so the
+// outer object is a plain literal. The inner \`headers\` Promise resolves to a
+// Result, which must use ok()/err() so consumers can call .orPanic / .map etc.
+export const request: SimHttp['request'] = (url, options) => {
+  console.log('[sim] http.request:', options?.method ?? 'GET', url)
+  const id = nextId++
+  const queue: any[] = []
+  queues.set(id, queue)
+
+  const args = JSON.stringify({
+    url,
+    method: options?.method,
+    headers: options?.headers,
+    body: options?.body ? bytesToBase64(options.body) : undefined,
+  })
+
+  const headers = call('http.fetch', args).then(
+    (json: string) => {
+      const r = JSON.parse(json) as {status: number; headers: [string, string][]; body: string}
+      const body = base64ToBytes(r.body)
+      if (body.length > 0) queue.push({kind: 'chunk', data: body})
+      queue.push({kind: 'end'})
+      return ok({status: r.status, headers: r.headers})
+    },
+    (e: unknown) => {
+      const message = e instanceof Error ? e.message : String(e)
+      queue.push({kind: 'error', cancelled: false, message})
+      return err({name: 'Network', message})
+    },
+  )
+
+  return {ok: true as const, id, headers}
+}
+
+// Polls the queue every microtask until a message is available. The queue is
+// populated when the RPC promise settles, so the first poll is fast in
+// practice; this avoids needing an explicit wakeup channel.
+export const nextMessage: SimHttp['nextMessage'] = async (id) => {
+  for (;;) {
+    const queue = queues.get(id)
+    if (!queue) return {kind: 'end' as const}
+    if (queue.length > 0) {
+      const msg = queue.shift()
+      if (msg.kind === 'end' || msg.kind === 'error') queues.delete(id)
+      return msg
+    }
+    await new Promise((resolve) => setTimeout(resolve, 0))
+  }
+}
+
+export const cancel: SimHttp['cancel'] = (id) => {
+  const queue = queues.get(id)
+  if (queue) {
+    queue.length = 0
+    queue.push({kind: 'error', cancelled: true, message: 'cancelled'})
+  }
+}
+
+export const pendingCount: SimHttp['pendingCount'] = () => queues.size
+`,
+};
+//# sourceMappingURL=http.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/simulator/builtins/http.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFT;CACA,CAAA"}

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

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

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

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

package/dist/simulator/builtins/i2c.js

@@ -0,0 +1,17 @@
+export const i2cBuiltin = {
+    source: `// Simulator stub for i2c
+// Runs inside the mikrojs runtime (QuickJS), not Node.js. Node built-ins are not available.
+import {ok} from 'mikrojs/result'
+import type {SimI2c} from 'mikrojs/sim'
+
+export class I2c implements SimI2c {
+  constructor(_busNo: number, _options?: Record<string, unknown>) {}
+  begin() { return ok() }
+  end() { return ok() }
+  scan() { return ok(new Uint8Array()) }
+  write(_address: number, _data: Uint8Array, _stop?: boolean) { return ok() }
+  read(_address: number, bytes: number) { return ok(new Uint8Array(bytes)) }
+}
+`,
+};
+//# sourceMappingURL=i2c.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { BuiltinDefinition, BuiltinName } from './types.js';
+export type { BuiltinDefinition, BuiltinName } from './types.js';
+/** Module name mapping: builtin name → native:* module name */
+export declare const builtinModuleNames: Record<BuiltinName, string>;
+/** Default builtin implementations for the dev runner */
+export declare const defaultBuiltins: Record<BuiltinName, BuiltinDefinition>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/simulator/builtins/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,YAAY,CAAA;AAI9D,YAAY,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,YAAY,CAAA;AAE9D,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAe1D,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAelE,CAAA"}

package/dist/simulator/builtins/index.js

@@ -0,0 +1,49 @@
+import { bleBuiltin } from './ble.js';
+import { consoleBuiltin } from './console.js';
+import { httpBuiltin } from './http.js';
+import { i2cBuiltin } from './i2c.js';
+import { kvBuiltin } from './kv.js';
+import { neopixelBuiltin } from './neopixel.js';
+import { nvsKvBuiltin } from './nvs-kv.js';
+import { pinBuiltin } from './pin.js';
+import { pwmBuiltin } from './pwm.js';
+import { sleepBuiltin } from './sleep.js';
+import { sntpBuiltin } from './sntp.js';
+import { spiBuiltin } from './spi.js';
+import { uartBuiltin } from './uart.js';
+import { wifiBuiltin } from './wifi.js';
+/** Module name mapping: builtin name → native:* module name */
+export const builtinModuleNames = {
+    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',
+};
+/** Default builtin implementations for the dev runner */
+export const defaultBuiltins = {
+    ble: bleBuiltin,
+    pin: pinBuiltin,
+    pwm: pwmBuiltin,
+    neopixel: neopixelBuiltin,
+    kv: kvBuiltin,
+    nvs_kv: nvsKvBuiltin,
+    sleep: sleepBuiltin,
+    wifi: wifiBuiltin,
+    i2c: i2cBuiltin,
+    spi: spiBuiltin,
+    uart: uartBuiltin,
+    http: httpBuiltin,
+    sntp: sntpBuiltin,
+    console: consoleBuiltin,
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/simulator/builtins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAA;AACnC,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AACrC,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAA;AACnC,OAAO,EAAC,SAAS,EAAC,MAAM,SAAS,CAAA;AACjC,OAAO,EAAC,eAAe,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAA;AACxC,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAA;AACnC,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAA;AACnC,OAAO,EAAC,YAAY,EAAC,MAAM,YAAY,CAAA;AACvC,OAAO,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AACrC,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAA;AAEnC,OAAO,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AAIrC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,QAAQ,EAAE,iBAAiB;IAC3B,IAAI,EAAE,aAAa;IACnB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,YAAY;IAChB,MAAM,EAAE,eAAe;IACvB,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,gBAAgB;CAC1B,CAAA;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,QAAQ,EAAE,eAAe;IACzB,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,cAAc;CACxB,CAAA"}

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

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

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

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

package/dist/simulator/builtins/kv.js

@@ -0,0 +1,39 @@
+export const kvBuiltin = {
+    source: `
+import {encode, decode} from 'native:cbor'
+import {ok} from 'mikrojs/result'
+
+const store = new Map()
+
+export function set(key, value) {
+  const result = encode(value)
+  if (!result.ok) return result
+  store.set(key, result.value)
+  return ok()
+}
+
+export function get(key) {
+  const data = store.get(key)
+  if (data === undefined) return undefined
+  const result = decode(data)
+  return result.ok ? result.value : undefined
+}
+
+export function remove(key) {
+  return store.delete(key)
+}
+
+export function clear() {
+  store.clear()
+}
+
+export function info() {
+  let used = 0
+  for (const [k, v] of store) {
+    used += 1 + k.length + 2 + v.byteLength
+  }
+  return {used, total: 2036, entries: store.size}
+}
+`,
+};
+//# sourceMappingURL=kv.js.map

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

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

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

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

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

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

package/dist/simulator/builtins/neopixel.js

@@ -0,0 +1,15 @@
+export const neopixelBuiltin = {
+    source: `
+import {ok} from 'mikrojs/result'
+
+export class NeoPixel {
+  constructor(_pin, _numLeds, _bytesPerLed) {}
+  setPixel() { return ok() }
+  fill() { return ok() }
+  show() { return ok() }
+  clear() { return ok() }
+  end() { return ok() }
+}
+`,
+};
+//# sourceMappingURL=neopixel.js.map

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

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

package/dist/simulator/builtins/nvs-kv.d.ts

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

package/dist/simulator/builtins/nvs-kv.d.ts.map

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

package/dist/simulator/builtins/nvs-kv.js

@@ -0,0 +1,69 @@
+// nvs_kv mirrors the firmware NVS contract: values must survive process
+// restarts (firmware NVS survives power cycles). The QuickJS-side stub
+// keeps an in-memory cache for fast reads, and rehydrates / persists via
+// RPC to the Node side, which writes a JSON file alongside the env-config
+// `nvs.json`. Values cross the boundary as base64(cbor) blobs so binary
+// data round-trips losslessly.
+export const nvsKvBuiltin = {
+    source: `
+import {encode, decode} from 'native:cbor'
+import {call} from 'native:host'
+import {ok} from 'mikrojs/result'
+
+function bytesToBase64(bytes) {
+  let bin = ''
+  for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i])
+  return btoa(bin)
+}
+
+function base64ToBytes(b64) {
+  const bin = atob(b64)
+  const out = new Uint8Array(bin.length)
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i)
+  return out
+}
+
+const store = new Map()
+
+// Rehydrate from disk synchronously at module init. host.call on a sync
+// Node-side handler returns a JSON string immediately (no Promise bridge).
+const initial = call('nvs_kv.list', '{}')
+if (typeof initial === 'string') {
+  const entries = JSON.parse(initial)
+  for (const key of Object.keys(entries)) {
+    store.set(key, base64ToBytes(entries[key]))
+  }
+}
+
+export function set(key, value) {
+  const result = encode(value)
+  if (!result.ok) return result
+  store.set(key, result.value)
+  call('nvs_kv.set', JSON.stringify({key, value: bytesToBase64(result.value)}))
+  return ok()
+}
+
+export function get(key) {
+  const data = store.get(key)
+  if (data === undefined) return undefined
+  const result = decode(data)
+  return result.ok ? result.value : undefined
+}
+
+export function remove(key) {
+  const existed = store.delete(key)
+  if (existed) call('nvs_kv.remove', JSON.stringify({key}))
+  return existed
+}
+
+export function clear() {
+  store.clear()
+  call('nvs_kv.clear', '{}')
+}
+
+export function info() {
+  return {entries: store.size, used: store.size, total: 512, free: 512 - store.size}
+}
+`,
+};
+//# sourceMappingURL=nvs-kv.js.map

package/dist/simulator/builtins/nvs-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs-kv.js","sourceRoot":"","sources":["../../../src/simulator/builtins/nvs-kv.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,wEAAwE;AACxE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DT;CACA,CAAA"}

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

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

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

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