mikrojs 0.0.0 → 0.0.8

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

@@ -0,0 +1,25 @@
+/**
+ * Safe-mode recovery for crash-looping devices.
+ *
+ * Two independent reset paths, run back-to-back so at least one fires:
+ *
+ *   1. In-band CMD_RESTART frame. If the device is currently in the protocol
+ *      loop (responsive, not crash-looping) the firmware handler calls
+ *      esp_restart() and we get a clean software reset. Also handles the
+ *      common "crash-looping but briefly responsive" case.
+ *
+ *   2. Hardware RTS/DTR reset matching esptool's HardReset(uses_usb=True).
+ *      DTR pinned to false so IO0 stays high and the chip boots normally
+ *      instead of entering the ROM bootloader. Covers genuinely stuck devices
+ *      where the protocol is not responding at all.
+ *
+ * After the reset attempts, we flood the firmware's recovery sync sequence
+ * ("MIKSAFE\n") so mik__check_recovery() picks it up during its boot window
+ * and skips user-app autorun. The firmware's RTC_NOINIT_ATTR double-reset
+ * detection makes path 1 + path 2 firing back-to-back safe.
+ *
+ * Pairs with the firmware-side window in mik_recovery.cpp.
+ */
+import type { SerialPort } from 'serialport';
+export declare function triggerSafeMode(serial: SerialPort, floodMs?: number): Promise<void>;
+//# sourceMappingURL=recover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/recover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AA0D1C,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvF"}

package/dist/cli/lib/recover.js

@@ -0,0 +1,144 @@
+/**
+ * Safe-mode recovery for crash-looping devices.
+ *
+ * Two independent reset paths, run back-to-back so at least one fires:
+ *
+ *   1. In-band CMD_RESTART frame. If the device is currently in the protocol
+ *      loop (responsive, not crash-looping) the firmware handler calls
+ *      esp_restart() and we get a clean software reset. Also handles the
+ *      common "crash-looping but briefly responsive" case.
+ *
+ *   2. Hardware RTS/DTR reset matching esptool's HardReset(uses_usb=True).
+ *      DTR pinned to false so IO0 stays high and the chip boots normally
+ *      instead of entering the ROM bootloader. Covers genuinely stuck devices
+ *      where the protocol is not responding at all.
+ *
+ * After the reset attempts, we flood the firmware's recovery sync sequence
+ * ("MIKSAFE\n") so mik__check_recovery() picks it up during its boot window
+ * and skips user-app autorun. The firmware's RTC_NOINIT_ATTR double-reset
+ * detection makes path 1 + path 2 firing back-to-back safe.
+ *
+ * Pairs with the firmware-side window in mik_recovery.cpp.
+ */
+import { buildRestartCommand } from './protocol.js';
+const SYNC = Buffer.from('MIKSAFE\n');
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const setLines = (serial, lines) => new Promise((resolve, reject) => {
+    serial.set(lines, (err) => (err ? reject(err) : resolve()));
+});
+const writeAndDrain = (serial, buf) => new Promise((resolve, reject) => {
+    serial.write(buf, (err) => {
+        if (err)
+            return reject(err);
+        serial.drain((drainErr) => (drainErr ? reject(drainErr) : resolve()));
+    });
+});
+/**
+ * Reset the chip and flood sync bytes during the firmware's recovery window.
+ *
+ * On USB Serial/JTAG chips the reset can briefly disconnect the USB device,
+ * so the RTS/DTR writes are wrapped in a retry loop that tolerates transient
+ * IOErrors. Matches what esptool does in ResetStrategy.__call__().
+ *
+ * @param serial - already-open SerialPort
+ * @param floodMs - how long to send sync bytes after reset (default 1500ms,
+ *   wide enough to cover boot prologue + 500ms recovery window)
+ */
+const DEBUG = process.env['MIKRO_RECOVER_DEBUG'] === '1';
+function debug(msg) {
+    if (DEBUG)
+        process.stderr.write(`[recover] ${msg}\n`);
+}
+function debugRxListener(serial) {
+    if (!DEBUG)
+        return () => { };
+    const onData = (chunk) => {
+        const hex = chunk.toString('hex');
+        const ascii = chunk
+            .toString('latin1')
+            .split('')
+            .map((c) => {
+            const code = c.charCodeAt(0);
+            return code >= 0x20 && code < 0x7f ? c : '.';
+        })
+            .join('');
+        process.stderr.write(`[recover] rx ${chunk.length}B  ${hex}  |${ascii}|\n`);
+    };
+    serial.on('data', onData);
+    return () => {
+        serial.off('data', onData);
+    };
+}
+export async function triggerSafeMode(serial, floodMs = 1500) {
+    const unwatch = debugRxListener(serial);
+    try {
+        debug(`start; port=${serial.path}`);
+        // Path 1: in-band CMD_RESTART. If the device is in the protocol loop
+        // the firmware calls esp_restart() immediately. Harmless if ignored.
+        try {
+            debug('writing CMD_RESTART frame');
+            await writeAndDrain(serial, buildRestartCommand());
+        }
+        catch (err) {
+            debug(`CMD_RESTART write failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Give the firmware a moment to process the restart and start rebooting
+        // before we pulse the hardware lines (avoids resetting mid-boot-prologue).
+        await sleep(100);
+        // Path 2: hardware RTS/DTR reset. Wrapped to tolerate IO errors since
+        // USB Serial/JTAG ports can briefly disconnect during reset.
+        try {
+            debug('hardware RTS/DTR reset');
+            await hardReset(serial);
+        }
+        catch (err) {
+            debug(`hardReset failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Flood for the full duration. The firmware drains stdin after detecting
+        // the sync sequence (see mik_recovery.cpp drain_stdin), so the tail of
+        // the flood doesn't pollute the protocol RX buffer.
+        debug(`flooding sync bytes for ${floodMs}ms`);
+        const deadline = Date.now() + floodMs;
+        let sent = 0;
+        let failed = 0;
+        while (Date.now() < deadline) {
+            try {
+                await writeAndDrain(serial, SYNC);
+                sent++;
+            }
+            catch {
+                failed++;
+            }
+            await sleep(50);
+        }
+        debug(`flood done; sent=${sent} failed=${failed}`);
+    }
+    finally {
+        unwatch();
+    }
+}
+/**
+ * esptool-equivalent of HardReset(uses_usb=True). Retries on IO errors since
+ * the USB CDC device can briefly disappear during reset on newer ESP32 chips.
+ */
+async function hardReset(serial) {
+    for (let attempt = 2; attempt >= 0; attempt--) {
+        try {
+            // Pin DTR=false throughout so IO0 stays high (app boot, not download mode).
+            // RTS=true → EN low (chip in reset).
+            await setLines(serial, { dtr: false, rts: true });
+            await sleep(200);
+            // RTS=false → EN high, chip starts booting.
+            await setLines(serial, { dtr: false, rts: false });
+            await sleep(200);
+            return;
+        }
+        catch (err) {
+            if (attempt === 0)
+                throw err;
+            // Port may have dropped out mid-reset on USB Serial/JTAG. Give it a moment.
+            await sleep(500);
+        }
+    }
+}
+//# sourceMappingURL=recover.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Resolve the entry file for a command.
+ * If an explicit entry is provided, return it as-is.
+ * Otherwise, read the `main` field from the nearest `package.json`.
+ */
+export declare function resolveEntry(entry: string | undefined): string;
+//# sourceMappingURL=resolveEntry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEntry.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/resolveEntry.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAkC9D"}

package/dist/cli/lib/resolveEntry.js

@@ -0,0 +1,30 @@
+import { existsSync, readFileSync } from 'node:fs';
+import * as pathlib from 'node:path';
+/**
+ * Resolve the entry file for a command.
+ * If an explicit entry is provided, return it as-is.
+ * Otherwise, read the `main` field from the nearest `package.json`.
+ */
+export function resolveEntry(entry) {
+    if (entry !== undefined) {
+        return entry;
+    }
+    const cwd = process.cwd();
+    const pkgPath = pathlib.join(cwd, 'package.json');
+    if (!existsSync(pkgPath)) {
+        throw new Error(`No entry file specified and no package.json found in ${cwd}.\n` +
+            `Either pass an entry file (e.g. mikro dev app/main.ts) or add a "main" field to package.json.`);
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const main = pkg.main;
+    if (typeof main !== 'string') {
+        throw new Error(`No entry file specified and package.json has no "main" field.\n` +
+            `Either pass an entry file (e.g. mikro dev app/main.ts) or add a "main" field to package.json.`);
+    }
+    const resolved = pathlib.resolve(cwd, main);
+    if (!existsSync(resolved)) {
+        throw new Error(`Entry file "${main}" (from package.json "main" field) does not exist: ${resolved}`);
+    }
+    return pathlib.relative(cwd, resolved);
+}
+//# sourceMappingURL=resolveEntry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEntry.js","sourceRoot":"","sources":["../../../src/cli/lib/resolveEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAA;AAEpC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;IAEjD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,wDAAwD,GAAG,KAAK;YAC9D,+FAA+F,CAClG,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IACtD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAA;IAErB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,iEAAiE;YAC/D,+FAA+F,CAClG,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAE3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,sDAAsD,QAAQ,EAAE,CACpF,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AACxC,CAAC"}

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

@@ -0,0 +1,34 @@
+import { Observable } from 'rxjs';
+/**
+ * Read `mikrojs.predeploy` from the project's package.json. Returns an
+ * empty array if the file, the `mikrojs` field, or the `predeploy` field
+ * is missing. Throws on malformed `predeploy` values.
+ */
+export declare function getPredeployCommands(projectRoot: string): string[];
+export type HookEvent = {
+    type: 'start';
+    command: string;
+} | {
+    type: 'stdout';
+    command: string;
+    chunk: Uint8Array;
+} | {
+    type: 'stderr';
+    command: string;
+    chunk: Uint8Array;
+} | {
+    type: 'complete';
+    command: string;
+};
+export declare class HookError extends Error {
+    readonly command: string;
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    constructor(command: string, exitCode: number | null, signal: NodeJS.Signals | null);
+}
+/**
+ * Run `commands` sequentially, fail-fast. Unsubscribe cancels the in-flight
+ * hook (via AbortController) and skips the rest.
+ */
+export declare function runHooks(commands: readonly string[], cwd: string): Observable<HookEvent>;
+//# sourceMappingURL=runHooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runHooks.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/runHooks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,UAAU,EAAC,MAAM,MAAM,CAAA;AAEvC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAclE;AAED,MAAM,MAAM,SAAS,GACjB;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GAChC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAC,GACpD;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAC,GACpD;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAA;AAEvC,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;gBAE1B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;CAOpF;AA8CD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAExF"}

package/dist/cli/lib/runHooks.js

@@ -0,0 +1,90 @@
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import * as pathlib from 'node:path';
+import { concat, Observable } from 'rxjs';
+/**
+ * Read `mikrojs.predeploy` from the project's package.json. Returns an
+ * empty array if the file, the `mikrojs` field, or the `predeploy` field
+ * is missing. Throws on malformed `predeploy` values.
+ */
+export function getPredeployCommands(projectRoot) {
+    const path = pathlib.join(projectRoot, 'package.json');
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const pkg = JSON.parse(raw);
+    const value = pkg.mikrojs?.predeploy;
+    if (value === undefined || value === null)
+        return [];
+    if (typeof value === 'string')
+        return [value];
+    if (Array.isArray(value) && value.every((v) => typeof v === 'string'))
+        return value;
+    throw new Error('Invalid mikrojs.predeploy in package.json: expected string or array of strings');
+}
+export class HookError extends Error {
+    command;
+    exitCode;
+    signal;
+    constructor(command, exitCode, signal) {
+        const detail = signal ? `signal ${signal}` : `exit ${exitCode}`;
+        super(`Hook failed: ${command} (${detail})`);
+        this.command = command;
+        this.exitCode = exitCode;
+        this.signal = signal;
+    }
+}
+function runHook(command, cwd) {
+    return new Observable((subscriber) => {
+        const abort = new AbortController();
+        // Prepend <projectRoot>/node_modules/.bin so `tsc`, `eslint`, etc.
+        // resolve without requiring `npx` / `pnpm exec` in the command string.
+        const binDir = pathlib.join(cwd, 'node_modules', '.bin');
+        const env = { ...process.env, PATH: `${binDir}${pathlib.delimiter}${process.env.PATH ?? ''}` };
+        subscriber.next({ type: 'start', command });
+        const child = spawn(command, {
+            shell: true,
+            cwd,
+            env,
+            signal: abort.signal,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        child.stdout?.on('data', (chunk) => {
+            subscriber.next({ type: 'stdout', command, chunk });
+        });
+        child.stderr?.on('data', (chunk) => {
+            subscriber.next({ type: 'stderr', command, chunk });
+        });
+        child.on('error', (err) => {
+            if (abort.signal.aborted)
+                return;
+            subscriber.error(err);
+        });
+        child.on('close', (code, signal) => {
+            if (abort.signal.aborted)
+                return;
+            if (code === 0) {
+                subscriber.next({ type: 'complete', command });
+                subscriber.complete();
+            }
+            else {
+                subscriber.error(new HookError(command, code, signal));
+            }
+        });
+        return () => {
+            abort.abort();
+        };
+    });
+}
+/**
+ * Run `commands` sequentially, fail-fast. Unsubscribe cancels the in-flight
+ * hook (via AbortController) and skips the rest.
+ */
+export function runHooks(commands, cwd) {
+    return concat(...commands.map((cmd) => runHook(cmd, cwd)));
+}
+//# sourceMappingURL=runHooks.js.map

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

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

package/dist/cli/lib/serial/InkReplConsole.d.ts

@@ -0,0 +1,27 @@
+import type { LogLevel } from '../../../_exports/index.js';
+import type { ReplSession } from '../session.js';
+import { type ReplHandle } from './replStateMachine.js';
+export interface InkReplConsoleProps {
+    session: ReplSession;
+    devicePath: string;
+    logLevel?: LogLevel;
+    /** When true, the deploy keybind fires a trigger into the repl's
+     *  `deploys$`. Defaults to false so callers that render a plain REPL
+     *  (e.g. `deploy --console`) don't accidentally emit into a Subject
+     *  no one subscribes to. `InkReplMode` sets this to `true` when a
+     *  `driver` is supplied. */
+    deployEnabled?: boolean;
+    /** Pre-built repl handle. Use when the caller already created the repl
+     *  (e.g. to subscribe to its `deploys$` before handing it off). */
+    repl?: ReplHandle;
+    /** Forwarded to `ReplConsole` for the header watch-mode badge. */
+    watch?: boolean;
+}
+/**
+ * Renders a `ReplConsole` over an existing `ReplSession`. Owns the
+ * Kitty-keyboard cleanup (`\x1b[<u`) and `process.exit(0)` on end.
+ * Pure in the sense that it doesn't touch the serial port or open
+ * a connection — feed it a live session.
+ */
+export declare function InkReplConsole(props: InkReplConsoleProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=InkReplConsole.d.ts.map

package/dist/cli/lib/serial/InkReplConsole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkReplConsole.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/serial/InkReplConsole.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAA;AACxD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAE9C,OAAO,EAAa,KAAK,UAAU,EAAC,MAAM,uBAAuB,CAAA;AAEjE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;;gCAI4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;uEACmE;IACnE,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,2CAcxD"}

package/dist/cli/lib/serial/InkReplConsole.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo } from 'react';
+import { ReplConsole } from './ReplConsole.js';
+import { createRepl } from './replStateMachine.js';
+/**
+ * Renders a `ReplConsole` over an existing `ReplSession`. Owns the
+ * Kitty-keyboard cleanup (`\x1b[<u`) and `process.exit(0)` on end.
+ * Pure in the sense that it doesn't touch the serial port or open
+ * a connection — feed it a live session.
+ */
+export function InkReplConsole(props) {
+    const { session, devicePath, logLevel, deployEnabled = false, repl: providedRepl, watch } = props;
+    const handleEnd = useCallback(() => {
+        process.stdout.write('\x1b[<u');
+        process.exit(0);
+    }, []);
+    const repl = useMemo(() => {
+        if (providedRepl)
+            return providedRepl;
+        return createRepl({ session, port: devicePath, onEnd: handleEnd, deployEnabled });
+    }, [providedRepl, session, devicePath, handleEnd, deployEnabled]);
+    return _jsx(ReplConsole, { repl: repl, config: session.config, logLevel: logLevel, watch: watch });
+}
+//# sourceMappingURL=InkReplConsole.js.map

package/dist/cli/lib/serial/InkReplConsole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkReplConsole.js","sourceRoot":"","sources":["../../../../src/cli/lib/serial/InkReplConsole.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAC,WAAW,EAAE,OAAO,EAAC,MAAM,OAAO,CAAA;AAI1C,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAC,UAAU,EAAkB,MAAM,uBAAuB,CAAA;AAmBjE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,GAAG,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAC,GAAG,KAAK,CAAA;IAE/F,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;QACxB,IAAI,YAAY;YAAE,OAAO,YAAY,CAAA;QACrC,OAAO,UAAU,CAAC,EAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAC,CAAC,CAAA;IACjF,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;IAEjE,OAAO,KAAC,WAAW,IAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAI,CAAA;AAC9F,CAAC"}

package/dist/cli/lib/serial/InkReplMode.d.ts

@@ -0,0 +1,38 @@
+import { type Observable } from 'rxjs';
+import type { LogLevel } from '../../../_exports/index.js';
+import { type ReplSession } from '../session.js';
+import { type ReplHandle } from './replStateMachine.js';
+export interface InkReplDriverContext {
+    session: ReplSession;
+    repl: ReplHandle;
+    devicePath: string;
+}
+export interface InkReplDriverResult {
+    /** Observable to subscribe to for the session's lifetime. Used by `dev`
+     *  to keep `createDevSession.state$` alive. */
+    run$?: Observable<unknown>;
+    /** Cleanup ran when the component unmounts. */
+    dispose?: () => void;
+}
+export interface InkReplModeProps {
+    devicePath: string;
+    /** Trigger safe-mode after opening the session. Used by
+     *  `console --recover` / `deploy --recover`. */
+    recover?: boolean;
+    logLevel?: LogLevel;
+    /** Per-command work that runs alongside the REPL. When a driver is
+     *  supplied, Ctrl+S is wired up (callers typically subscribe to
+     *  `repl.deploys$`). Without a driver, the deploy keybind is a no-op. */
+    driver?: (ctx: InkReplDriverContext) => InkReplDriverResult;
+    /** Forwarded to the rendered `ReplConsole` header badge. Typically set
+     *  by `dev` to reflect `--no-watch`. */
+    watch?: boolean;
+}
+/**
+ * Shared Ink-mode orchestrator for `dev`, `console`, and any command
+ * that wants "connect + attach REPL". Opens the serial, brings up a
+ * `ReplSession`, creates a `ReplHandle`, runs the optional `driver`
+ * for the session's lifetime, and renders `InkReplConsole`.
+ */
+export declare function InkReplMode(props: InkReplModeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=InkReplMode.d.ts.map

package/dist/cli/lib/serial/InkReplMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkReplMode.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/serial/InkReplMode.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,UAAU,EAA6B,MAAM,MAAM,CAAA;AAEvF,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAc,KAAK,WAAW,EAAC,MAAM,eAAe,CAAA;AAK3D,OAAO,EAAa,KAAK,UAAU,EAAC,MAAM,uBAAuB,CAAA;AAEjE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,WAAW,CAAA;IACpB,IAAI,EAAE,UAAU,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC;mDAC+C;IAC/C,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB;oDACgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;6EAEyE;IACzE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,mBAAmB,CAAA;IAC3D;4CACwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAgGlD"}

package/dist/cli/lib/serial/InkReplMode.js

@@ -0,0 +1,90 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import spinners from 'cli-spinners';
+import { Text, useInput } from 'ink';
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { catchError, from, map, of, shareReplay, switchMap } from 'rxjs';
+import { BAUD_RATE } from '../deploy.js';
+import { triggerSafeMode } from '../recover.js';
+import { connectRepl } from '../session.js';
+import { Spinner } from '../Spinner.js';
+import { createSerialTransport, openSerial } from '../transport.js';
+import { useObservable } from '../useObservable.js';
+import { InkReplConsole } from './InkReplConsole.js';
+import { createRepl } from './replStateMachine.js';
+/**
+ * Shared Ink-mode orchestrator for `dev`, `console`, and any command
+ * that wants "connect + attach REPL". Opens the serial, brings up a
+ * `ReplSession`, creates a `ReplHandle`, runs the optional `driver`
+ * for the session's lifetime, and renders `InkReplConsole`.
+ */
+export function InkReplMode(props) {
+    const { devicePath, recover = false, logLevel, driver, watch } = props;
+    const handleEnd = useCallback(() => {
+        process.stdout.write('\x1b[<u');
+        process.exit(0);
+    }, []);
+    const deployEnabled = Boolean(driver);
+    const connection$ = useMemo(() => openSerial(devicePath, BAUD_RATE).pipe(
+    // Session is created BEFORE triggerSafeMode so the eager
+    // subscription inside connectRepl is listening when the
+    // post-reset MSG_READY arrives.
+    switchMap((serial) => {
+        const session = connectRepl(createSerialTransport(serial));
+        return recover ? from(triggerSafeMode(serial)).pipe(map(() => session)) : of(session);
+    }), map((session) => {
+        const repl = createRepl({
+            session,
+            port: devicePath,
+            onEnd: handleEnd,
+            deployEnabled,
+        });
+        return { session, repl };
+    }), catchError((err) => of(err instanceof Error ? err : new Error(String(err)))), 
+    // refCount: false — the inner `switchMap` opens the serial and
+    // calls `triggerSafeMode`, which must happen exactly once per
+    // InkReplMode instance. With refCount: true, transient zero-
+    // subscriber windows would re-run the chain on next subscribe
+    // and reopen the port.
+    shareReplay({ bufferSize: 1, refCount: false })), [devicePath, recover, handleEnd, deployEnabled]);
+    const connection = useObservable(connection$, null);
+    const ready = connection && !(connection instanceof Error) ? connection : null;
+    // Keep `driver` in a ref so the effect below only re-runs when a new
+    // session is actually available. Caller memoisation would also work,
+    // but this puts the "run driver exactly once per session" contract
+    // in InkReplMode rather than relying on convention.
+    const driverRef = useRef(driver);
+    useEffect(() => {
+        driverRef.current = driver;
+    });
+    // Run the per-command driver while the session is alive.
+    useEffect(() => {
+        if (!ready)
+            return;
+        const spawned = driverRef.current?.({
+            session: ready.session,
+            repl: ready.repl,
+            devicePath,
+        });
+        if (!spawned)
+            return;
+        const sub = spawned.run$?.subscribe();
+        return () => {
+            sub?.unsubscribe();
+            spawned.dispose?.();
+        };
+    }, [ready, devicePath]);
+    // Ctrl+C / Ctrl+Q while still connecting — the REPL's own bindings
+    // take over once it's active.
+    useInput((_ch, key) => {
+        if (key.ctrl && (_ch === 'c' || _ch === 'q'))
+            process.exit(0);
+    }, { isActive: !ready });
+    if (connection instanceof Error) {
+        return _jsxs(Text, { color: "red", children: ["Connection error: ", connection.message] });
+    }
+    if (!ready) {
+        return (_jsxs(Text, { children: [_jsx(Spinner, { spinner: spinners.dots }), " Connecting to ", devicePath, "\u2026"] }));
+    }
+    return (_jsx(InkReplConsole, { session: ready.session, devicePath: devicePath, logLevel: logLevel, repl: ready.repl, watch: watch }));
+}
+//# sourceMappingURL=InkReplMode.js.map

package/dist/cli/lib/serial/InkReplMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkReplMode.js","sourceRoot":"","sources":["../../../../src/cli/lib/serial/InkReplMode.tsx"],"names":[],"mappings":";AAAA,OAAO,QAAQ,MAAM,cAAc,CAAA;AACnC,OAAO,EAAC,IAAI,EAAE,QAAQ,EAAC,MAAM,KAAK,CAAA;AAClC,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAC,MAAM,OAAO,CAAA;AAC7D,OAAO,EAAC,UAAU,EAAE,IAAI,EAAE,GAAG,EAAmB,EAAE,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,MAAM,CAAA;AAGvF,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAA;AACtC,OAAO,EAAC,eAAe,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,WAAW,EAAmB,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AACrC,OAAO,EAAC,qBAAqB,EAAE,UAAU,EAAC,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAC,UAAU,EAAkB,MAAM,uBAAuB,CAAA;AA+BjE;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAC,UAAU,EAAE,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAC,GAAG,KAAK,CAAA;IAEpE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAErC,MAAM,WAAW,GAAG,OAAO,CACzB,GAAG,EAAE,CACH,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,IAAI;IACpC,yDAAyD;IACzD,wDAAwD;IACxD,gCAAgC;IAChC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,WAAW,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;IACvF,CAAC,CAAC,EACF,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,UAAU,CAAC;YACtB,OAAO;YACP,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,SAAS;YAChB,aAAa;SACd,CAAC,CAAA;QACF,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,CAAA;IACxB,CAAC,CAAC,EACF,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5E,+DAA+D;IAC/D,8DAA8D;IAC9D,6DAA6D;IAC7D,8DAA8D;IAC9D,uBAAuB;IACvB,WAAW,CAAC,EAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC,CAC9C,EACH,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAChD,CAAA;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAA;IAE9E,qEAAqE;IACrE,qEAAqE;IACrE,mEAAmE;IACnE,oDAAoD;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,OAAO,GAAG,MAAM,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,yDAAyD;IACzD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;YAClC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU;SACX,CAAC,CAAA;QACF,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAA;QACrC,OAAO,GAAG,EAAE;YACV,GAAG,EAAE,WAAW,EAAE,CAAA;YAClB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAA;QACrB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA;IAEvB,mEAAmE;IACnE,8BAA8B;IAC9B,QAAQ,CACN,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACX,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC/D,CAAC,EACD,EAAC,QAAQ,EAAE,CAAC,KAAK,EAAC,CACnB,CAAA;IAED,IAAI,UAAU,YAAY,KAAK,EAAE,CAAC;QAChC,OAAO,MAAC,IAAI,IAAC,KAAK,EAAC,KAAK,mCAAoB,UAAU,CAAC,OAAO,IAAQ,CAAA;IACxE,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CACL,MAAC,IAAI,eACH,KAAC,OAAO,IAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,GAAI,qBAAgB,UAAU,cACxD,CACR,CAAA;IACH,CAAC;IACD,OAAO,CACL,KAAC,cAAc,IACb,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,KAAK,EAAE,KAAK,GACZ,CACH,CAAA;AACH,CAAC"}

package/dist/cli/lib/serial/ReplConsole.d.ts

@@ -0,0 +1,21 @@
+import type { LogLevel } from '../../../_exports/index.js';
+import { type EnvEditorConfig } from '../../components/EnvEditor.js';
+import { type ReplHandle } from './replStateMachine.js';
+export interface ReplConsoleProps {
+    repl: ReplHandle;
+    config?: EnvEditorConfig;
+    /** Drop device-originated log events below this threshold. Host-side
+     *  backstop for the build-time DCE, which can leak `console.debug`
+     *  calls in arrow-callback positions. Defaults to `debug` (show all). */
+    logLevel?: LogLevel;
+    /** Adds a watch-mode line to the footer above the prompt. The footer
+     *  also hosts progress messages (connecting, building, deploying,
+     *  checking hooks); when nothing is in progress, the watch copy is
+     *  shown. `true` → "Watching for file changes…", `false` → "File
+     *  watching off. Press Ctrl+S to redeploy", `undefined` → the footer
+     *  only appears while something is in progress (e.g. `mikro console`,
+     *  where watching doesn't apply). */
+    watch?: boolean;
+}
+export declare function ReplConsole({ repl, config, logLevel, watch }: ReplConsoleProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ReplConsole.d.ts.map

package/dist/cli/lib/serial/ReplConsole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplConsole.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/serial/ReplConsole.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAY,KAAK,eAAe,EAAC,MAAM,+BAA+B,CAAA;AAK7E,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB;;6EAEyE;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;;;;yCAMqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAkLD,wBAAgB,WAAW,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,QAAkB,EAAE,KAAK,EAAC,EAAE,gBAAgB,2CAoMtF"}