mikrojs 0.0.0 → 0.0.7

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

@@ -0,0 +1,42 @@
+export declare const BAUD_RATE = 115200;
+export declare function resolvePort(explicit?: string): Promise<string>;
+export declare function collectFiles(buildDir: string): Promise<{
+    path: string;
+    data: Buffer;
+}[]>;
+export interface EnvVar {
+    key: string;
+    value: string;
+    secret: boolean;
+}
+export interface LoadEnvOptions {
+    /** Directory to scan for .env files. */
+    cwd: string;
+    /** Mode name used to discover .env.<mode> (e.g. 'development', 'production', 'test'). */
+    mode: string;
+    /** Explicit --env FILE path (additive, layered after auto-discovery). */
+    envFile?: string;
+    /** Explicit --secrets FILE path (additive, marked as secret). */
+    secretsFile?: string;
+    /** When true, skips auto-discovery of .env / .env.<mode>. Explicit files still load. */
+    noEnvFile?: boolean;
+}
+/**
+ * Load env vars from .env files with precedence (later overrides earlier):
+ *   1. <cwd>/.env                  (auto, skipped when noEnvFile)
+ *   2. <cwd>/.env.<mode>           (auto, skipped when noEnvFile)
+ *   3. opts.envFile                (explicit --env, error if missing)
+ *   4. opts.secretsFile            (explicit --secrets, error if missing, marked secret)
+ *
+ * Auto-discovered files are silently skipped if missing.
+ * Returned array is deduped by key with last-wins semantics.
+ */
+export declare function loadEnvFiles(opts: LoadEnvOptions): Promise<EnvVar[]>;
+/** Maximum length of an env var name persisted to ESP32 NVS. */
+export declare const NVS_KEY_MAX_LENGTH = 15;
+/**
+ * Validate that all env var keys fit within NVS's name length limit.
+ * Throws with a single error listing every violation.
+ */
+export declare function validateNvsKeys(vars: EnvVar[]): void;
+//# sourceMappingURL=deploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/deploy.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,SAAS,SAAS,CAAA;AAS/B,wBAAsB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCpE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EAAE,CAAC,CAgB5F;AAWD,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAOD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgC1E;AAED,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CASpD"}

package/dist/cli/lib/deploy.js

@@ -0,0 +1,121 @@
+import * as pathlib from 'node:path';
+import { access, readdir, readFile, stat } from 'fs/promises';
+import { SerialPort } from 'serialport';
+import { parseDotenv } from './dotenv.js';
+export const BAUD_RATE = 115200;
+export async function resolvePort(explicit) {
+    const devices = (await SerialPort.list()).filter((p) => p.serialNumber);
+    if (explicit) {
+        const match = devices.find((d) => d.path === explicit);
+        if (!match) {
+            const lines = [`Error: Device not found: ${explicit}`];
+            if (devices.length > 0) {
+                lines.push('\nConnected devices:');
+                for (const d of devices) {
+                    lines.push(`  ${d.path} (${d.manufacturer ?? ''} ${d.serialNumber ?? ''}`);
+                }
+            }
+            else {
+                lines.push('No devices found');
+            }
+            throw new Error(lines.join('\n'));
+        }
+        return match.path;
+    }
+    if (devices.length === 0) {
+        throw new Error('No serial devices found');
+    }
+    if (devices.length === 1) {
+        return devices[0].path;
+    }
+    const lines = ['Multiple devices found. Use --port to select one:\n'];
+    for (const d of devices) {
+        lines.push(`  ${d.path} (${d.manufacturer ?? ''} ${d.serialNumber ?? ''}`);
+    }
+    throw new Error(lines.join('\n'));
+}
+export async function collectFiles(buildDir) {
+    const entries = await readdir(buildDir, { recursive: true });
+    const files = [];
+    for (const entry of entries) {
+        const full = pathlib.join(buildDir, entry);
+        const s = await stat(full);
+        if (s.isFile()) {
+            files.push({
+                path: '/' + entry,
+                data: await readFile(full),
+            });
+        }
+    }
+    return files;
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readDotenvFile(path, secret) {
+    const content = await readFile(path, 'utf-8');
+    return parseDotenv(content).map((entry) => ({ ...entry, secret }));
+}
+/**
+ * Load env vars from .env files with precedence (later overrides earlier):
+ *   1. <cwd>/.env                  (auto, skipped when noEnvFile)
+ *   2. <cwd>/.env.<mode>           (auto, skipped when noEnvFile)
+ *   3. opts.envFile                (explicit --env, error if missing)
+ *   4. opts.secretsFile            (explicit --secrets, error if missing, marked secret)
+ *
+ * Auto-discovered files are silently skipped if missing.
+ * Returned array is deduped by key with last-wins semantics.
+ */
+export async function loadEnvFiles(opts) {
+    const vars = [];
+    if (!opts.noEnvFile) {
+        const base = pathlib.join(opts.cwd, '.env');
+        if (await fileExists(base)) {
+            vars.push(...(await readDotenvFile(base, false)));
+        }
+        const modeFile = pathlib.join(opts.cwd, `.env.${opts.mode}`);
+        if (await fileExists(modeFile)) {
+            vars.push(...(await readDotenvFile(modeFile, false)));
+        }
+    }
+    if (opts.envFile) {
+        if (!(await fileExists(opts.envFile))) {
+            throw new Error(`Env file not found: ${opts.envFile}`);
+        }
+        vars.push(...(await readDotenvFile(opts.envFile, false)));
+    }
+    if (opts.secretsFile) {
+        if (!(await fileExists(opts.secretsFile))) {
+            throw new Error(`Secrets file not found: ${opts.secretsFile}`);
+        }
+        vars.push(...(await readDotenvFile(opts.secretsFile, true)));
+    }
+    // Dedup by key, last wins.
+    const merged = new Map();
+    for (const v of vars)
+        merged.set(v.key, v);
+    return Array.from(merged.values());
+}
+/** Maximum length of an env var name persisted to ESP32 NVS. */
+export const NVS_KEY_MAX_LENGTH = 15;
+/**
+ * Validate that all env var keys fit within NVS's name length limit.
+ * Throws with a single error listing every violation.
+ */
+export function validateNvsKeys(vars) {
+    const tooLong = vars.filter((v) => v.key.length > NVS_KEY_MAX_LENGTH);
+    if (tooLong.length === 0)
+        return;
+    const lines = [
+        `Env var name(s) exceed NVS limit of ${NVS_KEY_MAX_LENGTH} characters:`,
+        ...tooLong.map((v) => `  ${v.key} (${v.key.length} chars)`),
+    ];
+    throw new Error(lines.join('\n'));
+}
+//# sourceMappingURL=deploy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/cli/lib/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAC,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAErC,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AAEvC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAA;AAS/B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAiB;IACjD,MAAM,OAAO,GAAe,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;IAEnF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAA;QACtD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAA;YACtD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;gBAClC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,YAAY,IAAI,EAAE,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC,CAAA;gBAC5E,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;YAChC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACnC,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAA;IACnB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAA;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,qDAAqD,CAAC,CAAA;IACrE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,YAAY,IAAI,EAAE,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC,CAAA;IAC5E,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAA;IAC1D,MAAM,KAAK,GAAmC,EAAE,CAAA;IAEhD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1B,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,GAAG,GAAG,KAAK;gBACjB,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAqBD,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,MAAe;IACzD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC7C,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,KAAK,EAAE,MAAM,EAAC,CAAC,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAoB;IACrD,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC3C,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;QACnD,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5D,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;QACvD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;AACpC,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAEpC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAA;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEhC,MAAM,KAAK,GAAG;QACZ,uCAAuC,kBAAkB,cAAc;QACvE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC;KAC5D,CAAA;IACD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACnC,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { DeployEvent } from './session.js';
+/**
+ * Format a DeployEvent as a single-line progress string, or null if the
+ * event should not produce a log line (e.g. `checking` is emitted per file
+ * and is too chatty for a typical TTY log).
+ */
+export declare function formatDeployEvent(event: DeployEvent): string | null;
+//# sourceMappingURL=deployProgress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployProgress.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/deployProgress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAA;AAE7C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAuBnE"}

package/dist/cli/lib/deployProgress.js

@@ -0,0 +1,32 @@
+/**
+ * Format a DeployEvent as a single-line progress string, or null if the
+ * event should not produce a log line (e.g. `checking` is emitted per file
+ * and is too chatty for a typical TTY log).
+ */
+export function formatDeployEvent(event) {
+    switch (event.type) {
+        case 'connecting':
+            return 'Waiting for device…';
+        case 'checking':
+            return null;
+        case 'uploading':
+            return `Uploading [${event.index + 1}/${event.total}] ${event.file}`;
+        case 'env_changed': {
+            const parts = [];
+            for (const k of event.changed)
+                parts.push(`+${k}`);
+            for (const k of event.removed)
+                parts.push(`-${k}`);
+            return `Env updated: ${parts.join(' ')}`;
+        }
+        case 'restarting':
+            return 'Restarting device…';
+        case 'complete':
+            // Keep this command-neutral: a "press Ctrl+R" hint only makes sense
+            // for the interactive dev REPL — `mikro test`, `mikro deploy`, and
+            // `mikro sim deploy` use this same formatter. Dev can render its own
+            // hint via the REPL UI if it wants.
+            return event.deployed ? null : 'No changes.';
+    }
+}
+//# sourceMappingURL=deployProgress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployProgress.js","sourceRoot":"","sources":["../../../src/cli/lib/deployProgress.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,qBAAqB,CAAA;QAC9B,KAAK,UAAU;YACb,OAAO,IAAI,CAAA;QACb,KAAK,WAAW;YACd,OAAO,cAAc,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,CAAA;QACtE,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAa,EAAE,CAAA;YAC1B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAClD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAClD,OAAO,gBAAgB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;QAC1C,CAAC;QACD,KAAK,YAAY;YACf,OAAO,oBAAoB,CAAA;QAC7B,KAAK,UAAU;YACb,oEAAoE;YACpE,mEAAmE;YACnE,qEAAqE;YACrE,oCAAoC;YACpC,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAA;IAChD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,16 @@
+/** Simple .env file parser */
+export interface EnvEntry {
+    key: string;
+    value: string;
+}
+/**
+ * Parse a .env file into key-value pairs.
+ * Supports:
+ * - KEY=value
+ * - KEY="quoted value"
+ * - KEY='single quoted value'
+ * - # comments
+ * - Empty lines
+ */
+export declare function parseDotenv(content: string): EnvEntry[];
+//# sourceMappingURL=dotenv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dotenv.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/dotenv.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CA2BvD"}

package/dist/cli/lib/dotenv.js

@@ -0,0 +1,33 @@
+/** Simple .env file parser */
+/**
+ * Parse a .env file into key-value pairs.
+ * Supports:
+ * - KEY=value
+ * - KEY="quoted value"
+ * - KEY='single quoted value'
+ * - # comments
+ * - Empty lines
+ */
+export function parseDotenv(content) {
+    const entries = [];
+    for (const raw of content.split('\n')) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const eqIdx = line.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = line.slice(0, eqIdx).trim();
+        let value = line.slice(eqIdx + 1).trim();
+        // Strip matching quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (key) {
+            entries.push({ key, value });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=dotenv.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dotenv.js","sourceRoot":"","sources":["../../../src/cli/lib/dotenv.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAO9B;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,OAAO,GAAe,EAAE,CAAA;IAE9B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QACvB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QAE3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAQ;QAE1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;QACvC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAExC,wBAAwB;QACxB,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,EAAC,GAAG,EAAE,KAAK,EAAC,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { BuildOptions } from 'esbuild';
+export interface BuildConfig {
+    minify?: boolean;
+    bundle?: boolean;
+}
+export declare function getBuildOptions(entryFile: string, config: BuildConfig): BuildOptions;
+//# sourceMappingURL=esbuild.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAA;AAIzC,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,CAYpF"}

package/dist/cli/lib/esbuild.js

@@ -0,0 +1,15 @@
+import { BUILTIN_EXTERNALS } from '../../constants.js';
+export function getBuildOptions(entryFile, config) {
+    return {
+        bundle: config.bundle,
+        entryPoints: [entryFile],
+        write: false,
+        minify: config.minify,
+        treeShaking: true,
+        target: 'es2024',
+        platform: 'neutral',
+        format: 'esm',
+        external: config.bundle ? BUILTIN_EXTERNALS : undefined,
+    };
+}
+//# sourceMappingURL=esbuild.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../../../src/cli/lib/esbuild.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAA;AAOpD,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAmB;IACpE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,CAAC,SAAS,CAAC;QACxB,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;KACxD,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,41 @@
+type Chip = 'auto' | 'esp8266' | 'esp32' | 'esp32s2' | 'esp32s3beta2' | 'esp32s3' | 'esp32c3' | 'esp32c6beta' | 'esp32h2beta1' | 'esp32h2beta2' | 'esp32c2' | 'esp32c6' | 'esp32h2';
+type FlashMode = 'keep' | 'qio' | 'qout' | 'dio' | 'dout';
+type FlashSize = 'detect' | 'keep' | '256KB' | '512KB' | '1MB' | '2MB' | '2MB-c1' | '4MB' | '4MB-c1' | '8MB' | '16MB' | '32MB' | '64MB' | '128MB';
+type FlashFreq = 'keep' | '80m' | '60m' | '48m' | '40m' | '30m' | '26m' | '24m' | '20m' | '16m' | '15m' | '12m';
+type CommonOptions = {
+    chip?: Chip;
+    port: string;
+    baudRate: number;
+    before?: 'default_reset' | 'usb_reset' | 'no_reset' | 'no_reset_no_sync';
+    after?: 'hard_reset' | 'soft_reset' | 'no_reset' | 'no_reset_stub';
+    noStub?: boolean;
+    trace?: boolean;
+    connectAttempts?: number;
+};
+export interface FlashEntry {
+    address: number;
+    filename: string;
+}
+export interface WriteFlashMultiOptions extends CommonOptions {
+    files: FlashEntry[];
+    compress?: boolean;
+    erase?: boolean;
+    freq?: FlashFreq;
+    flashMode?: FlashMode;
+    flashSize?: FlashSize;
+    noProgress?: boolean;
+    verify?: boolean;
+}
+export interface FlasherArgs {
+    chip: Chip;
+    before: CommonOptions['before'];
+    after: CommonOptions['after'];
+    flashMode: FlashMode;
+    flashSize: FlashSize;
+    flashFreq: FlashFreq;
+    files: FlashEntry[];
+}
+export declare function readFlasherArgs(buildDir: string): Promise<FlasherArgs>;
+export declare function getWriteFlashMultiArgs(options: WriteFlashMultiOptions): string[];
+export {};
+//# sourceMappingURL=esptool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"esptool.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/esptool.ts"],"names":[],"mappings":"AAGA,KAAK,IAAI,GACL,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,cAAc,GACd,SAAS,GACT,SAAS,GACT,aAAa,GACb,cAAc,GACd,cAAc,GACd,SAAS,GACT,SAAS,GACT,SAAS,CAAA;AAEb,KAAK,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AAEzD,KAAK,SAAS,GACV,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,KAAK,GACL,KAAK,GACL,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,CAAA;AAEX,KAAK,SAAS,GACV,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CAAA;AAET,KAAK,aAAa,GAAG;IACnB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,kBAAkB,CAAA;IACxE,KAAK,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,CAAA;IAClE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC/B,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC7B,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB5E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,YAuBrE"}

package/dist/cli/lib/esptool.js

@@ -0,0 +1,43 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export async function readFlasherArgs(buildDir) {
+    const raw = await fs.readFile(path.join(buildDir, 'flasher_args.json'), 'utf-8');
+    const json = JSON.parse(raw);
+    const files = Object.entries(json.flash_files).map(([addr, file]) => ({
+        address: Number(addr),
+        filename: path.resolve(buildDir, file),
+    }));
+    return {
+        chip: json.extra_esptool_args.chip ?? 'auto',
+        before: json.extra_esptool_args.before,
+        after: json.extra_esptool_args.after,
+        flashMode: json.flash_settings.flash_mode,
+        flashSize: json.flash_settings.flash_size,
+        flashFreq: json.flash_settings.flash_freq,
+        files,
+    };
+}
+export function getWriteFlashMultiArgs(options) {
+    return [
+        ['--chip', options.chip ?? 'auto'],
+        ['--port', options.port],
+        ['--baud', String(options.baudRate)],
+        typeof options.before === 'string' ? ['--before', options.before] : [],
+        typeof options.after === 'string' ? ['--after', options.after] : [],
+        ['write-flash'],
+        options.noStub === true ? ['--no-stub'] : [],
+        options.trace ? ['--trace'] : [],
+        options.compress ? ['--compress'] : [],
+        options.noProgress === true ? ['--no-progress'] : [],
+        typeof options.connectAttempts === 'number'
+            ? ['--connect-attempts', String(options.connectAttempts)]
+            : [],
+        typeof options.flashMode === 'string' ? ['--flash_mode', String(options.flashMode)] : [],
+        typeof options.flashSize === 'string' ? ['--flash_size', String(options.flashSize)] : [],
+        options.verify ? ['--verify'] : [],
+        ...options.files.flatMap((f) => [[String(f.address)], [f.filename]]),
+    ]
+        .filter((arg) => arg.length > 0)
+        .flatMap((arg) => arg);
+}
+//# sourceMappingURL=esptool.js.map

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

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

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

@@ -0,0 +1,24 @@
+/** Chip identifier (e.g. "esp32c3", "esp32c6"). Not hardcoded — any chip with a matching firmware release asset will work. */
+export type Chip = string;
+export type ResolveFromOptions = {
+    from: string;
+    chip?: Chip;
+    board?: string;
+    onProgress?: (message: string) => void;
+};
+/**
+ * Resolve firmware from a `--from` reference.
+ *
+ * Resolution order:
+ * 1. URL (http/https) → download directly
+ * 2. Contains `/` → external repo (user/repo or user/repo@ref)
+ * 3. Starts with `v` + digit → release tag on mikrojs/mikrojs (fallback to Actions)
+ * 4. Everything else → resolve as ref (branch/tag/SHA) on mikrojs/mikrojs via Actions
+ *
+ * Note: for mikrojs/mikrojs, versioned firmware (vX.Y.Z) is bundled in the
+ * @mikrojs/firmware npm package and used by the default flash path. The
+ * release-asset code path here is exercised by external repos that ship
+ * firmware tarballs as GitHub Release assets.
+ */
+export declare function resolveFrom(options: ResolveFromOptions): Promise<string>;
+//# sourceMappingURL=firmware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firmware.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/firmware.ts"],"names":[],"mappings":"AAcA,8HAA8H;AAC9H,MAAM,MAAM,IAAI,GAAG,MAAM,CAAA;AAEzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC,CAAA;AA4YD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2E9E"}