mikro 0.1.0 → 0.10.0-next.7.gdacecb0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Bjørge Næss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,47 +1,80 @@
-# @flexwie/mikro
+<p align="center">
+  <img src="https://mikrojs.dev/logo.svg" width="200" alt="Mikro.js logo">
+</p>
 
-![npm (scoped)](https://img.shields.io/npm/v/@flexwie/mikro)
-![GitHub commit activity](https://img.shields.io/github/commit-activity/m/flexwie/mikro)
-![Tests](https://github.com/fosscom/mikro/workflows/Tests/badge.svg)
+<h1 align="center">Mikro.js</h1>
 
-`mikro` aims to simplify developing microservices on nodejs by taking away the need to configure infrastructure. Simply write services with the framework and deploy them by ejecting the infrastructure for use with Docker or K8s. Read more on how to deploy `mikro` at [Deployment](#deployment).
+<p align="center">TypeScript-first runtime for microcontrollers with a focus on developer experience and iteration speed.</p>
+
+<p align="center">
+  <a href="https://mikrojs.dev">Documentation</a> · <a href="https://mikrojs.dev/getting-started">Getting Started</a> · <a href="https://mikrojs.dev/api/">API Reference</a> · <a href="https://mikrojs.dev/examples/">Examples</a>
+</p>
+
+<div align="center">
+
+[![Open on npmx.dev](https://npmx.dev/api/registry/badge/name/mikrojs)](https://npmx.dev/package/mikrojs)
+[![Open on npmx.dev](https://npmx.dev/api/registry/badge/version/mikrojs)](https://npmx.dev/package/mikrojs)
+[![Open on npmx.dev](https://npmx.dev/api/registry/badge/updated/mikrojs)](https://npmx.dev/package/mikrojs)
+
+</div>
+
+> [!NOTE]
+> Mikro.js is in early development. Expect APIs to change.
+
+## Features
+
+- **Fast feedback loop**: interactive dev console with watch mode and incremental builds that deploy to your device in a few seconds
+- **Full TypeScript**: near-complete ES2024 support, type-checked hardware APIs, and editor autocomplete
+- **Batteries included**: GPIO, PWM, I2C, SPI, UART, WiFi, HTTP, UDP, NeoPixel, deep sleep, SNTP, CBOR, schema validation, key-value storage, and more
+- **Host simulator**: run your code on your computer with `mikro sim dev`. No microcontroller needed
+- **No exceptions**: typed Result errors instead of try/catch. Every failure is visible in the type signature
+- **Built-in testing**: test suites with resource leak detection and more. Run in the simulator or on a real device
+
+## Quickstart
 
-## Usage
-Install the framework from npm:
 ```sh
-npm install --save @flexwie/mikro
+npm create mikrojs my-app
+cd my-app
+npm install
+npx mikro flash   # once per board
+npx mikro dev     # build, deploy, live-reload
 ```
 
-Then use it in your microservice like so:
-```javascript
-const { Mikro } = require('@flexwie/mikro')
+## Example
 
-/*
-create a new instance and configure it (optional)
-first parameter is the name of your service, second are options for your environement
-*/
-const mikro = new Mikro('example', {
-    redis: {        // redis connection details
-        host: 'localhost',
-        port: 6379,
-        db: 0
-    }
-})
+```ts
+import {digitalWrite, pinMode} from 'mikro/pin'
+import {sleep} from 'mikro/sleep'
 
-// ... your microservice code here
+const LED = 20
 
-// register your new service with the registry
-mikro.register()
+pinMode(LED, 'OUTPUT').orPanic('Failed to set pin mode')
 
+while (true) {
+  digitalWrite(LED, 1)
+  await sleep(500)
+  digitalWrite(LED, 0)
+  await sleep(500)
+}
 ```
 
-You can use the included CLI to quickly create a boilerplate. For more information see the [CLI Readme](/cli).
+## Overview
 
-```
-npx @flexwie/mikro new service_name
-```
+The core runtime is a standalone C++ library with no ESP-IDF dependencies, making it portable across platforms.
 
-`mikro` will automatically send health metrics to the registry in the background. You can then use `mikro`s functions to help with your service. See detailed information on usage in the wiki.
+- **Engine**: [QuickJS-NG](https://github.com/quickjs-ng/quickjs) ([near-complete ES2024 coverage](https://test262.fyi/#|qjs_ng))
+- **Runtime**: Standalone C++ library with cooperative, single-threaded event loop
+- **Platform**: ESP-IDF >= 6.0.1 (ESP32, ESP32-C3, ESP32-S3, ESP32-C5, ESP32-C6), desktop (macOS, Linux)
+- **Modules**: Four-source resolution: virtual modules, native C modules, bytecode builtins, filesystem (LittleFS)
+- **Bytecode**: TypeScript bundled with esbuild, compiled to QuickJS bytecode at build time
+- **Tooling**: Node.js CLI (Ink/React), Node-API addon for host-side development and simulation
 
 ## Acknowledgements
-This project is inspired by the microservice frameworks [micro](https://github.com/micro/micro) and [gizmo](https://github.com/nytimes/gizmo) in the golang ecosystem and tries to bring the best parts of those and more to NodeJS.
+
+Mikro.js has drawn heavy inspiration from [txiki.js](https://github.com/saghul/txiki.js), a small JavaScript runtime built on QuickJS.
+
+Thanks to Felix Wieland ([@flexwie](https://github.com/flexwie)) for generously donating the `mikro` package name on npm.
+
+## License
+
+MIT

package/bin/mikrojs.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import {spawn} from 'node:child_process'
+import {join} from 'node:path'
+
+if (process.env.MIKROJS_WORKSPACE === '1') {
+  // Pass node flags via NODE_OPTIONS instead of CLI args so any node subprocess
+  // we spawn later (notably simProcess via createSimTransport) inherits tsx
+  // loading without each spawn site having to special-case workspace mode.
+  // The stripTypeScriptTypes ExperimentalWarning is handled precisely by
+  // suppressStripTypesWarning.ts (imported in cli.ts and simProcess.ts), so we
+  // don't blanket-disable ExperimentalWarning here and keep other ones visible.
+  const nodeOptions = [process.env.NODE_OPTIONS ?? '', '--conditions=development', '--import=tsx']
+    .filter(Boolean)
+    .join(' ')
+  spawn(
+    process.execPath,
+    [join(import.meta.dirname, '../src/cli/cliWrapper.ts'), ...process.argv.slice(2)],
+    {
+      stdio: 'inherit',
+      env: {
+        ...process.env,
+        NODE_OPTIONS: nodeOptions,
+        TSX_TSCONFIG_PATH: join(import.meta.dirname, '../tsconfig.json'),
+      },
+    },
+  ).on('exit', (code, signal) => process.exit(code ?? (signal ? 1 : 0)))
+} else {
+  await import('../dist/cli/cliWrapper.js')
+}

package/dist/_exports/ble.d.ts

@@ -0,0 +1,3 @@
+export type { AdvertiseHandle, AdvertiseInterval, AdvertiseOptions, Ble, BleError, Peripheral, } from '@mikrojs/native/runtime/ble/types';
+export { ble, peripheral } from '@mikrojs/native/runtime/ble/types';
+//# sourceMappingURL=ble.d.ts.map

package/dist/_exports/ble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ble.d.ts","sourceRoot":"","sources":["../../src/_exports/ble.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,GAAG,EACH,QAAQ,EACR,UAAU,GACX,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAC,GAAG,EAAE,UAAU,EAAC,MAAM,mCAAmC,CAAA"}

package/dist/_exports/ble.js

@@ -0,0 +1,2 @@
+export { ble, peripheral } from '@mikrojs/native/runtime/ble/types';
+//# sourceMappingURL=ble.js.map

package/dist/_exports/ble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ble.js","sourceRoot":"","sources":["../../src/_exports/ble.ts"],"names":[],"mappings":"AAQA,OAAO,EAAC,GAAG,EAAE,UAAU,EAAC,MAAM,mCAAmC,CAAA"}

package/dist/_exports/cbor.d.ts

@@ -0,0 +1,3 @@
+export type { CborError } from '@mikrojs/native/runtime/cbor/types';
+export { decode, encode } from '@mikrojs/native/runtime/cbor/types';
+//# sourceMappingURL=cbor.d.ts.map

package/dist/_exports/cbor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbor.d.ts","sourceRoot":"","sources":["../../src/_exports/cbor.ts"],"names":[],"mappings":"AAAA,YAAY,EAAC,SAAS,EAAC,MAAM,oCAAoC,CAAA;AACjE,OAAO,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM,oCAAoC,CAAA"}

package/dist/_exports/cbor.js

@@ -0,0 +1,2 @@
+export { decode, encode } from '@mikrojs/native/runtime/cbor/types';
+//# sourceMappingURL=cbor.js.map

package/dist/_exports/cbor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbor.js","sourceRoot":"","sources":["../../src/_exports/cbor.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM,oCAAoC,CAAA"}

package/dist/_exports/console.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/console/types';
+//# sourceMappingURL=console.d.ts.map

package/dist/_exports/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/_exports/console.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA"}

package/dist/_exports/console.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/console/types';
+//# sourceMappingURL=console.js.map

package/dist/_exports/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/_exports/console.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA"}

package/dist/_exports/env.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/env/types';
+//# sourceMappingURL=env.d.ts.map

package/dist/_exports/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/_exports/env.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA"}

package/dist/_exports/env.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/env/types';
+//# sourceMappingURL=env.js.map

package/dist/_exports/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/_exports/env.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA"}

package/dist/_exports/format.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/format/types';
+//# sourceMappingURL=format.d.ts.map

package/dist/_exports/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/_exports/format.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA"}

package/dist/_exports/format.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/format/types';
+//# sourceMappingURL=format.js.map

package/dist/_exports/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/_exports/format.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA"}

package/dist/_exports/fs.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/fs/types';
+//# sourceMappingURL=fs.d.ts.map

package/dist/_exports/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/_exports/fs.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA"}

package/dist/_exports/fs.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/fs/types';
+//# sourceMappingURL=fs.js.map

package/dist/_exports/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/_exports/fs.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA"}

package/dist/_exports/http/helpers.d.ts

@@ -0,0 +1,3 @@
+export type { Request, RequestOptions, Response } from '@mikrojs/native/runtime/http/helpers';
+export { BodyConsumedError, makeResponse, prepareBody, RequestError, } from '@mikrojs/native/runtime/http/helpers';
+//# sourceMappingURL=helpers.d.ts.map

package/dist/_exports/http/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/_exports/http/helpers.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAC,MAAM,sCAAsC,CAAA;AAC3F,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,sCAAsC,CAAA"}

package/dist/_exports/http/helpers.js

@@ -0,0 +1,5 @@
+// Transport-agnostic HTTP helpers. Import from here when implementing a
+// custom transport (e.g. an LTE modem) so the native-backed `request` and
+// its `native:http` dependency aren't retained on device.
+export { BodyConsumedError, makeResponse, prepareBody, RequestError, } from '@mikrojs/native/runtime/http/helpers';
+//# sourceMappingURL=helpers.js.map

package/dist/_exports/http/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/_exports/http/helpers.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,0DAA0D;AAG1D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,sCAAsC,CAAA"}

package/dist/_exports/http/request.d.ts

@@ -0,0 +1,4 @@
+import type { Request } from '@mikrojs/native/runtime/http/helpers';
+export declare const request: Request;
+export declare function pendingCount(): number;
+//# sourceMappingURL=request.d.ts.map

package/dist/_exports/http/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/_exports/http/request.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,sCAAsC,CAAA;AAEjE,MAAM,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,CAAA;AACrC,MAAM,CAAC,OAAO,UAAU,YAAY,IAAI,MAAM,CAAA"}

package/dist/_exports/http/request.js

@@ -0,0 +1,10 @@
+// Pure-types entry for `mikro/http/request`. Runtime values are provided
+// on-device by the bundled `http/request` bytecode module (and by a stub in
+// the simulator). This file declares the shapes so TypeScript and host
+// tooling can see them without pulling in `native:http`.
+//
+// For `RequestError`, `BodyConsumedError`, `prepareBody`, `makeResponse`, or
+// the shared types, import from `mikro/http/helpers` directly -- that
+// subpath has no `native:http` dependency.
+export {};
+//# sourceMappingURL=request.js.map

package/dist/_exports/http/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/_exports/http/request.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,uEAAuE;AACvE,yDAAyD;AACzD,EAAE;AACF,6EAA6E;AAC7E,sEAAsE;AACtE,2CAA2C"}

package/dist/_exports/i2c.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/i2c/types';
+//# sourceMappingURL=i2c.d.ts.map

package/dist/_exports/i2c.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i2c.d.ts","sourceRoot":"","sources":["../../src/_exports/i2c.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA"}

package/dist/_exports/i2c.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/i2c/types';
+//# sourceMappingURL=i2c.js.map

package/dist/_exports/i2c.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i2c.js","sourceRoot":"","sources":["../../src/_exports/i2c.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA"}

package/dist/_exports/index.d.ts

@@ -0,0 +1,149 @@
+export type WifiCountryCode = 'AT' | 'AU' | 'BE' | 'BG' | 'BR' | 'CA' | 'CH' | 'CN' | 'CY' | 'CZ' | 'DE' | 'DK' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HK' | 'HR' | 'HU' | 'IE' | 'IN' | 'IS' | 'IT' | 'JP' | 'KR' | 'LI' | 'LT' | 'LU' | 'LV' | 'MT' | 'MX' | 'NL' | 'NO' | 'NZ' | 'PL' | 'PT' | 'RO' | 'SE' | 'SI' | 'SK' | 'TW' | 'US';
+export interface MikroJSSimConfig {
+    /** QuickJS heap memory limit. Number of bytes, or string with K/M suffix (e.g. '300k'). */
+    memLimit?: number | string;
+    /** Virtual filesystem size limit. Number of bytes, or string with K/M suffix (e.g. '1m'). */
+    fsLimit?: number | string;
+    /** Filesystem sandbox root directory. Defaults to .mikro/sim-fs. */
+    fsRoot?: string;
+}
+export type Minifier = 'esbuild' | 'terser' | 'swc';
+export type MinifyLevel = 'default' | 'max';
+export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
+export interface MikroJSBuildConfig {
+    /** Bundle user code into a single module via esbuild, with tree-shaking.
+     * Firmware builtins (mikrojs/*, native:*, and @mikrojs/* packages
+     * with native code) stay external. Reduces QuickJS per-module overhead
+     * and strips unused code paths, at the cost of less informative stack
+     * traces. Default: false (per-file transform). */
+    bundle?: boolean;
+    /** Which minifier to use. Requires the corresponding package to be
+     * installed: 'terser' for terser, '@swc/core' for swc. esbuild is
+     * always available. Default: 'esbuild'. */
+    minifier?: Minifier;
+    /** Minification level. 'default' uses safe transforms only. 'max' enables
+     * unsafe transforms (multiple compress passes, toplevel mangling,
+     * pure_getters, unsafe_arrows, unsafe_math, unsafe_methods) for the
+     * smallest possible output. Default: 'default'. */
+    minifyLevel?: MinifyLevel;
+    /** Build-time log level. Console methods below this threshold are
+     * eliminated as dead code by the minifier (via `pure_funcs`). For
+     * helper functions that compute values only used in log calls,
+     * annotate with `@__PURE__` so the minifier can cascade the removal:
+     *
+     * ```ts
+     * const m = \/\* @__PURE__ \*\/ memoryUsage()
+     * console.log(`[mem] heap: ${m.heapUsed}`)
+     * // both statements eliminated at logLevel: 'warn'
+     * ```
+     *
+     * Levels from most to least verbose: 'debug' > 'info' > 'warn' > 'error' > 'none'.
+     * CLI `--loglevel` flag overrides this setting. Default: 'debug' (keep all). */
+    logLevel?: LogLevel;
+}
+export interface MikroJSWifiConfig {
+    /** Two-letter ISO 3166-1 country code for the WiFi regulatory domain. */
+    country?: WifiCountryCode;
+    /** DHCP hostname advertised by the STA interface. Defaults to
+     * `mikrojs-<device-id>` when unset. RFC 1123: letters, digits, hyphens
+     * only; must not start or end with a hyphen; max 63 chars. */
+    hostname?: string;
+}
+export type LogFlush = 'line' | 'error';
+export interface MikroJSLogFileOptions {
+    /** Directory on the device filesystem where the log file lives. The
+     * actual file is always `<dir>/log.txt` (rotated as `log.txt.1`).
+     * Default: '/appfs/logs'. */
+    dir?: string;
+    /** Maximum file size before rotation. Number of bytes, or string with
+     * K/M suffix (e.g. '64k', '1m'). At cap, `log.txt` is renamed to
+     * `log.txt.1` (replacing any previous generation) and a fresh
+     * `log.txt` is started. Total flash usage is bounded at 2 × maxSize.
+     * Default: '64k'. */
+    maxSize?: number | string;
+    /** When to commit buffered writes to flash. 'line' flushes after every
+     * newline (strongest post-mortem guarantee, hardest on flash). 'error'
+     * buffers in RAM and flushes on warn/error lines or when the buffer
+     * fills. Default: 'error'. */
+    flush?: LogFlush;
+}
+/** What the device does after an uncaught exception (a "panic").
+ *
+ * `delay` is the grace window (ms) the device stays awake and reachable
+ * before acting. The protocol REPL keeps servicing deploy / clean /
+ * --recover commands during it, so a long enough delay lets the host break
+ * a tight crash loop; short enough keeps the device converging when no one
+ * is watching. Default: `1000`.
+ *
+ * - `restart` (default): reboot after the grace window.
+ * - `deepSleep`: deep-sleep for `duration` ms after the grace window; the
+ *   timer wake reboots the chip (the wake IS the restart). Conserves battery
+ *   for field devices, at the cost of being unreachable while asleep. Keep
+ *   `delay` low (or `0`) in the field; raise it on the bench so you can still
+ *   grab the device before it goes dark. */
+export type MikroJSPanicAction = {
+    mode: 'restart';
+    delay?: number;
+} | {
+    mode: 'deepSleep';
+    delay?: number;
+    duration: number;
+};
+export interface MikroJSConfig {
+    /** Behavior after an uncaught exception. Default:
+     * `{mode: 'restart', delay: 1000}`. */
+    onPanic?: MikroJSPanicAction;
+    stackSize?: number;
+    memReserved?: number;
+    /** Maximum size in bytes for a single readFile() call. Files larger than
+     * this throw FSError with code 'EFBIG' — use open() + read() to stream
+     * larger files chunk-by-chunk. Number of bytes, or string with K/M
+     * suffix (e.g. '128k', '1m'). Default: 65536 (64 KiB). */
+    fsReadMax?: number | string;
+    wifi?: MikroJSWifiConfig;
+    /** File logging to the device filesystem. Captures console output and
+     * native log calls into a rotated log file for post-mortem debugging.
+     * Use `true` for defaults, or an options object to override individual
+     * settings. Omit to disable. */
+    logFile?: true | MikroJSLogFileOptions;
+    /** Simulator-only options. Stripped from the bundled config before deploy. */
+    sim?: MikroJSSimConfig;
+    /** Build-time options. Stripped from the bundled config before deploy. */
+    build?: MikroJSBuildConfig;
+    /** Per-environment overrides. Each entry is shallow-merged over the base
+     * config (the surrounding fields) for that environment. The `env` map is
+     * removed from the config deployed to the device. See {@link MikroEnv} for
+     * how each environment maps to commands.
+     *
+     * The merge is shallow: each field in an override replaces the base value
+     * wholesale (no field-by-field merging, so an override can't leave stray
+     * fields behind). To keep some of a base group like `build`, spread it.
+     * Every environment merges over the base independently; an omitted
+     * environment is just the base.
+     *
+     * ```ts
+     * export default defineConfig({
+     *   build: {minifyLevel: 'max'},
+     *   env: {
+     *     // Write logs to flash and deep-sleep after a crash.
+     *     production: {logFile: true, onPanic: {mode: 'deepSleep', delay: 0, duration: 600000}},
+     *     // Keep all logs; wait before restarting after a crash.
+     *     development: {build: {logLevel: 'debug'}, onPanic: {mode: 'restart', delay: 5000}},
+     *   },
+     * })
+     * ``` */
+    env?: Partial<Record<MikroEnv, MikroJSConfigOverride>>;
+}
+/** The environment a build runs in:
+ * - `production` — `mikro deploy`, `mikro build`
+ * - `development` — `mikro dev`, `mikro sim deploy`/`dev`/`profile`
+ * - `test` — `mikro test`, `mikro sim test`
+ *
+ * This is the config environment only — the granular `.env.<mode>` file a
+ * command loads (e.g. `.env.simulator`, `.env.test`) is a separate concern. */
+export type MikroEnv = 'development' | 'production' | 'test';
+/** Fields that may be overridden per environment: every {@link MikroJSConfig}
+ * field except `env` itself (overrides don't nest). */
+export type MikroJSConfigOverride = Omit<MikroJSConfig, 'env'>;
+export declare function defineConfig<T extends MikroJSConfig>(config: T): T;
+//# sourceMappingURL=index.d.ts.map

package/dist/_exports/index.d.ts.map

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

package/dist/_exports/index.js

@@ -0,0 +1,4 @@
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=index.js.map

package/dist/_exports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/_exports/index.ts"],"names":[],"mappings":"AAqMA,MAAM,UAAU,YAAY,CAA0B,MAAS;IAC7D,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/_exports/inspect.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/inspect/types';
+//# sourceMappingURL=inspect.d.ts.map

package/dist/_exports/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/_exports/inspect.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA"}

package/dist/_exports/inspect.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/inspect/types';
+//# sourceMappingURL=inspect.js.map

package/dist/_exports/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/_exports/inspect.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA"}

package/dist/_exports/kv/nvs.d.ts

@@ -0,0 +1,3 @@
+export type { KVError, KVOptions, KVValue, NvsStorage, NvsStorageInfo, Storable, StorableSchema, } from '@mikrojs/native/runtime/kv/types';
+export { nvsStorage } from '@mikrojs/native/runtime/kv/types';
+//# sourceMappingURL=nvs.d.ts.map

package/dist/_exports/kv/nvs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs.d.ts","sourceRoot":"","sources":["../../../src/_exports/kv/nvs.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,SAAS,EACT,OAAO,EACP,UAAU,EACV,cAAc,EACd,QAAQ,EACR,cAAc,GACf,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAC,UAAU,EAAC,MAAM,kCAAkC,CAAA"}

package/dist/_exports/kv/nvs.js

@@ -0,0 +1,2 @@
+export { nvsStorage } from '@mikrojs/native/runtime/kv/types';
+//# sourceMappingURL=nvs.js.map

package/dist/_exports/kv/nvs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs.js","sourceRoot":"","sources":["../../../src/_exports/kv/nvs.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,UAAU,EAAC,MAAM,kCAAkC,CAAA"}

package/dist/_exports/kv/rtc.d.ts

@@ -0,0 +1,3 @@
+export type { KVError, KVOptions, KVValue, RtcMemoryInfo, RtcStorage, Storable, StorableSchema, } from '@mikrojs/native/runtime/kv/types';
+export { rtcStorage } from '@mikrojs/native/runtime/kv/types';
+//# sourceMappingURL=rtc.d.ts.map

package/dist/_exports/kv/rtc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc.d.ts","sourceRoot":"","sources":["../../../src/_exports/kv/rtc.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,SAAS,EACT,OAAO,EACP,aAAa,EACb,UAAU,EACV,QAAQ,EACR,cAAc,GACf,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAC,UAAU,EAAC,MAAM,kCAAkC,CAAA"}

package/dist/_exports/kv/rtc.js

@@ -0,0 +1,2 @@
+export { rtcStorage } from '@mikrojs/native/runtime/kv/types';
+//# sourceMappingURL=rtc.js.map

package/dist/_exports/kv/rtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc.js","sourceRoot":"","sources":["../../../src/_exports/kv/rtc.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,UAAU,EAAC,MAAM,kCAAkC,CAAA"}

package/dist/_exports/module.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/module/types';
+//# sourceMappingURL=module.d.ts.map

package/dist/_exports/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/_exports/module.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA"}

package/dist/_exports/module.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/module/types';
+//# sourceMappingURL=module.js.map

package/dist/_exports/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/_exports/module.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA"}

package/dist/_exports/neopixel.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/neopixel/types';
+//# sourceMappingURL=neopixel.d.ts.map

package/dist/_exports/neopixel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neopixel.d.ts","sourceRoot":"","sources":["../../src/_exports/neopixel.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAA"}

package/dist/_exports/neopixel.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/neopixel/types';
+//# sourceMappingURL=neopixel.js.map

package/dist/_exports/neopixel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neopixel.js","sourceRoot":"","sources":["../../src/_exports/neopixel.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAA"}

package/dist/_exports/observable/operators.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/observable/operators';
+//# sourceMappingURL=operators.d.ts.map

package/dist/_exports/observable/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../../src/_exports/observable/operators.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAA"}

package/dist/_exports/observable/operators.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/observable/operators';
+//# sourceMappingURL=operators.js.map

package/dist/_exports/observable/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../../../src/_exports/observable/operators.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAA"}

package/dist/_exports/observable.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/observable/types';
+//# sourceMappingURL=observable.d.ts.map

package/dist/_exports/observable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable.d.ts","sourceRoot":"","sources":["../../src/_exports/observable.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAA"}

package/dist/_exports/observable.js

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/observable/types';
+//# sourceMappingURL=observable.js.map

package/dist/_exports/observable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable.js","sourceRoot":"","sources":["../../src/_exports/observable.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAA"}

package/dist/_exports/pin.d.ts

@@ -0,0 +1,2 @@
+export * from '@mikrojs/native/runtime/pin/types';
+//# sourceMappingURL=pin.d.ts.map