mikrojs 0.0.0 → 0.0.7

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

@@ -0,0 +1,249 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import spinners from 'cli-spinners';
+import { Box, Static, Text, useInput } from 'ink';
+import React, { useCallback, useEffect, useState } from 'react';
+import { whichPMRuns } from 'which-pm-runs';
+import { EnvEditor } from '../../components/EnvEditor.js';
+import { BorderFill, TitledBox } from '../../components/TitledBox.js';
+import { logLevelAllows } from '../parseMinifier.js';
+import { Spinner } from '../Spinner.js';
+import { useObservable } from '../useObservable.js';
+import { createInitialState, MULTILINE_HINT, WELCOME_HINT, } from './replStateMachine.js';
+// ── Event rendering ────────────────────────────────────────
+function testEventColor(e, data) {
+    switch (e) {
+        case 2:
+            return 'green';
+        case 3:
+        case 7:
+            return 'red';
+        case 4:
+            return 'yellow';
+        case 6:
+            return data.f > 0 ? 'red' : 'green';
+        case 8:
+            return 'gray';
+        default:
+            return undefined;
+    }
+}
+const deviceIdSpinner = {
+    interval: 150,
+    frames: [
+        ' ∙∙∙●∙∙∙∙∙∙ ',
+        ' ∙∙∙∙●∙∙∙∙∙ ',
+        ' ∙∙∙∙∙●∙∙∙∙ ',
+        ' ∙∙∙∙∙∙●∙∙∙ ',
+        ' ∙∙∙∙∙●∙∙∙∙ ',
+        ' ∙∙∙∙●∙∙∙∙∙ ',
+        ' ∙∙∙●∙∙∙∙∙∙ ',
+    ],
+};
+function eventColor(event) {
+    switch (event.type) {
+        case 'error':
+        case 'eval_error':
+        case 'disconnect':
+            return 'red';
+        case 'warn':
+            return 'yellow';
+        case 'info':
+            return 'cyan';
+        case 'input':
+            return 'blue';
+        case 'result':
+            return 'green';
+        case 'connecting':
+        case 'restarting':
+            return 'yellow';
+        case 'ready':
+            return 'green';
+        case 'test':
+            return testEventColor(event.data.e, event.data);
+        default:
+            return undefined;
+    }
+}
+function testEventText(data) {
+    switch (data.e) {
+        case 1: // suite_start
+            return String(data.s);
+        case 2: // test_pass
+            return `  ✓ ${data.t} (${data.d}ms)`;
+        case 3: // test_fail
+            return `  ✗ ${data.t} (${data.d}ms)\n    ${data.m}`;
+        case 4: // test_skip
+            return `  - ${data.t}`;
+        case 6: {
+            // run_done
+            const parts = [];
+            if (data.p > 0)
+                parts.push(`${data.p} passed`);
+            if (data.f > 0)
+                parts.push(`${data.f} failed`);
+            if (data.k > 0)
+                parts.push(`${data.k} skipped`);
+            return `${parts.join(', ')} (${data.d}ms)`;
+        }
+        case 7: // beforeAll error
+            return `  ✗ beforeAll: ${data.m}`;
+        case 8: {
+            // heap
+            const used = (data.u / 1024) | 0;
+            const total = (data.t / 1024) | 0;
+            const parts = [`heap: ${used}/${total}KB, free: ${total - used}KB`];
+            if (typeof data.f === 'number') {
+                parts.push(`sysFree: ${(data.f / 1024) | 0}KB`);
+            }
+            if (typeof data.mf === 'number') {
+                parts.push(`sysMinFree: ${(data.mf / 1024) | 0}KB`);
+            }
+            return `[${parts.join(', ')}]`;
+        }
+        default:
+            return '';
+    }
+}
+function eventText(event) {
+    switch (event.type) {
+        case 'connecting':
+            return event.port ? `Connecting to ${event.port}…` : 'Connecting…';
+        case 'restarting':
+            return 'Restarting…';
+        case 'ready': {
+            const name = event.id ?? event.chip ?? 'device';
+            const chip = event.id && event.chip ? ` (${event.chip})` : '';
+            const version = event.version ? ` Mikro.js v${event.version}` : '';
+            return `Connected to ${name}${chip}${version}`;
+        }
+        case 'input':
+            return event.code;
+        case 'raw':
+            return event.text;
+        case 'completions':
+            return event.result?.items.join('  ') ?? '';
+        case 'disconnect':
+            return event.error ?? 'Disconnected';
+        case 'log':
+        case 'warn':
+        case 'error':
+        case 'info':
+        case 'debug':
+        case 'result':
+        case 'eval_error':
+            return event.text;
+        case 'test':
+            return testEventText(event.data);
+        default:
+            return '';
+    }
+}
+function shouldRender(event, logLevel) {
+    switch (event.type) {
+        case 'connecting':
+        case 'restarting':
+        case 'prompt':
+        case 'ok':
+        case 'err':
+        case 'checksum_result':
+        case 'config_entries':
+            return false;
+        case 'disconnect':
+            return Boolean(event.error);
+        case 'completions':
+            return (event.result?.items.length ?? 0) > 1;
+        case 'raw':
+            return event.text.trim().length > 0;
+        case 'test':
+            return event.data.e !== 5; // skip suite_end
+        case 'log':
+        case 'warn':
+        case 'error':
+        case 'info':
+        case 'debug':
+            return logLevelAllows(logLevel, event.type);
+        default:
+            return true;
+    }
+}
+function getPackageRunner() {
+    const pm = whichPMRuns();
+    return pm?.name === 'pnpm'
+        ? 'pnpm mikro'
+        : pm?.name === 'yarn'
+            ? 'yarn mikro'
+            : pm?.name === 'bun'
+                ? 'bunx mikro'
+                : 'npx mikro';
+}
+const INITIAL_STATE = createInitialState();
+// ── Component ──────────────────────────────────────────────
+export function ReplConsole({ repl, config, logLevel = 'debug', watch }) {
+    const state = useObservable(repl.state$, INITIAL_STATE);
+    const handleCloseOverlay = useCallback(() => repl.closeOverlay(), [repl]);
+    useInput((ch, key) => {
+        if (!state.overlay)
+            repl.keyInput(ch, key);
+    });
+    // Eval spinner (shown after 500ms of waiting for result)
+    const [showEvalSpinner, setShowEvalSpinner] = useState(false);
+    useEffect(() => {
+        if (!state.evaluating)
+            return;
+        const timer = setTimeout(() => setShowEvalSpinner(true), 500);
+        return () => {
+            clearTimeout(timer);
+            setShowEvalSpinner(false);
+        };
+    }, [state.evaluating]);
+    // ── Derived render state ───────────────────────────────────
+    const conn = state.connection;
+    if (conn.type === 'fallback') {
+        return (_jsx(Text, { color: "yellow", children: "Device does not support protocol REPL mode. Use `mikro console --raw` for legacy mode." }));
+    }
+    if (state.overlay === 'env' && config) {
+        return _jsx(EnvEditor, { config: config, onClose: handleCloseOverlay });
+    }
+    const isConnecting = conn.type === 'connecting' || conn.type === 'negotiating';
+    const isError = conn.type === 'error';
+    // One footer line drives both progress and watch-mode messaging so the
+    // REPL has a single "what's the dev loop doing right now" signal.
+    // Priority: active work outranks sticky errors outranks watch-mode
+    // idle copy. A sticky error stays pinned until the next cycle starts.
+    const footer = isConnecting
+        ? {
+            message: conn.message ?? (state.port ? `Connecting to ${state.port}…` : 'Connecting…'),
+            tone: 'busy',
+        }
+        : state.disabled
+            ? { message: state.deployStatus ?? 'Deploying…', tone: 'busy' }
+            : state.footerError
+                ? { message: state.footerError, tone: 'error' }
+                : watch === true
+                    ? { message: 'Watching for file changes…', tone: 'watching' }
+                    : watch === false
+                        ? { message: 'File watching off. Press Ctrl+S to redeploy', tone: 'idle' }
+                        : null;
+    const renderableEvents = state.events.filter((event) => shouldRender(event, logLevel));
+    const prompt = '❯ ';
+    return (_jsxs(_Fragment, { children: [_jsx(Static, { items: renderableEvents, children: (event, index) => {
+                    const text = eventText(event);
+                    const color = eventColor(event);
+                    const isDimmed = event.type === 'input' || event.type === 'debug';
+                    const timing = event.type === 'input' ? event.timing : undefined;
+                    return (_jsxs(Text, { color: color, dimColor: isDimmed, children: [timing ? `${timing} ` : '', text] }, index));
+                } }), state.showTroubleshooting && (_jsxs(Text, { color: isError ? 'red' : undefined, dimColor: !isError, children: ['\n  Troubleshooting:\n\n', '  • Check that the device is connected and the correct port is selected\n', '  • Try power-cycling the device\n', '  • Check that no other program is using the serial port\n', '  • Check that the firmware is compatible. Run ', _jsxs(Text, { underline: true, children: [getPackageRunner(), " flash"] }), ' to update.\n'] })), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [footer && (_jsxs(Text, { color: footer.tone === 'busy' ? 'magenta' : footer.tone === 'error' ? 'red' : 'gray', dimColor: footer.tone === 'idle' || footer.tone === 'watching', children: [footer.tone === 'busy' ? (_jsxs(_Fragment, { children: [_jsx(Spinner, { spinner: spinners.dots }), ' '] })) : footer.tone === 'error' ? ('✗ ') : footer.tone === 'watching' ? (_jsx(Text, { color: "green", children: "\u25CF " })) : (''), footer.message] })), _jsxs(TitledBox, { header: _jsx(BorderFill, { char: "\u2500", color: isError || isConnecting ? 'gray' : state.disabled ? 'yellow' : 'blue', dimColor: isConnecting || isError, justifyContent: "end", children: _jsxs(Box, { gap: 1, marginX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: '⌬ ' }), _jsx(Text, { dimColor: true, children: "Mikro." }), _jsx(Text, { bold: true, color: "yellow", dimColor: true, children: "js" })] }), conn.type === 'ready' && conn.deviceId ? (_jsx(Text, { color: "black", backgroundColor: conn.chip === 'simulator' ? 'magenta' : 'blue', children: ` ${conn.deviceId} ` })) : (_jsx(Text, { color: "grey", children: _jsx(Spinner, { spinner: deviceIdSpinner }) }))] }) }), borderStyle: "single", borderLeft: false, borderRight: false, borderColor: isError || isConnecting ? 'gray' : state.disabled ? 'yellow' : 'blue', borderDimColor: isConnecting || isError, paddingLeft: 1, children: [_jsx(Text, { color: isConnecting || isError ? 'gray' : 'blue', dimColor: isConnecting || isError, children: showEvalSpinner ? (_jsxs(_Fragment, { children: [_jsx(Spinner, { spinner: spinners.dots }), ' '] })) : (prompt) }), state.input === '' ? (_jsxs(Text, { dimColor: isConnecting || isError, children: [_jsx(Text, { inverse: true, color: isConnecting || isError ? 'gray' : undefined, children: ' ' }), showEvalSpinner && _jsx(Text, { dimColor: true, children: " Evaluating\u2026" })] })) : (_jsxs(Text, { color: isConnecting || isError ? 'gray' : undefined, children: [state.input.slice(0, state.cursor), _jsx(Text, { inverse: true, color: isConnecting || isError ? 'gray' : undefined, children: state.cursor >= state.input.length
+                                            ? ' '
+                                            : state.input[state.cursor] === '\n'
+                                                ? ' '
+                                                : state.input[state.cursor] }), state.cursor < state.input.length
+                                        ? (state.input[state.cursor] === '\n' ? '\n' : '') +
+                                            state.input.slice(state.cursor + 1)
+                                        : ''] }))] }), _jsx(Text, { dimColor: true, children: isConnecting || isError
+                            ? 'Ctrl+D to exit'
+                            : (state.overrideHint ??
+                                (state.input.includes('\n') ? MULTILINE_HINT : null) ??
+                                (state.showWelcome ? WELCOME_HINT : state.contextHint) ??
+                                ' ') })] })] }));
+}
+//# sourceMappingURL=ReplConsole.js.map

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

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

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

@@ -0,0 +1,53 @@
+import { type Observable } from 'rxjs';
+import type { LogLevel, Minifier, MinifyLevel } from '../../../_exports/index.js';
+import type { DeployEvent, ReplSession } from '../session.js';
+import type { ReplHandle } from './replStateMachine.js';
+export type DevStatus = {
+    type: 'building';
+} | {
+    type: 'rebuilding';
+} | {
+    type: 'checking';
+    command: string;
+} | {
+    type: 'deploying';
+    event: DeployEvent;
+} | {
+    type: 'watching';
+} | {
+    type: 'error';
+    message: string;
+};
+export interface DevSessionState {
+    status: DevStatus;
+}
+export interface DevSessionHandle {
+    state$: Observable<DevSessionState>;
+    close(): void;
+}
+export declare function createDevSession(options: {
+    session: ReplSession;
+    entry: string;
+    forceDeploy: boolean;
+    minify: boolean;
+    bytecode: boolean;
+    watch: boolean;
+    /** Skip package.json `mikrojs.predeploy` hooks. */
+    noHooks?: boolean;
+    /** REPL handle for the Ink-mode UI. Omit in agent mode. When present, the
+     *  dev session drives the status line, disables the prompt during deploy,
+     *  and subscribes to `repl.deploys$` for Ctrl+S triggers. */
+    repl?: ReplHandle;
+    /** Extra deploy trigger source (e.g. an agent-mode stdin 'deploy' command).
+     *  Merged with `repl?.deploys$` if both are present. */
+    externalDeploys$?: Observable<{
+        force: boolean;
+    }>;
+    minifier?: Minifier;
+    minifyLevel?: MinifyLevel;
+    logLevel?: LogLevel;
+    envFile?: string;
+    secretsFile?: string;
+    noEnvFile?: boolean;
+}): DevSessionHandle;
+//# sourceMappingURL=devSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"devSession.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/serial/devSession.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,UAAU,EAShB,MAAM,MAAM,CAAA;AAGb,OAAO,KAAK,EAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAC,MAAM,4BAA4B,CAAA;AAM/E,OAAO,KAAK,EAAC,WAAW,EAAE,WAAW,EAAC,MAAM,eAAe,CAAA;AAE3D,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAA;AAIrD,MAAM,MAAM,SAAS,GACjB;IAAC,IAAI,EAAE,UAAU,CAAA;CAAC,GAClB;IAAC,IAAI,EAAE,YAAY,CAAA;CAAC,GACpB;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GACnC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAC,GACvC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAC,GAClB;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAA;AAEpC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC,eAAe,CAAC,CAAA;IACnC,KAAK,IAAI,IAAI,CAAA;CACd;AASD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;iEAE6D;IAC7D,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;4DACwD;IACxD,gBAAgB,CAAC,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC,CAAA;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,gBAAgB,CA+MnB"}

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

@@ -0,0 +1,160 @@
+import * as pathlib from 'node:path';
+import { catchError, concat, defer, EMPTY, ignoreElements, map, merge, of, shareReplay, startWith, Subject, switchMap, tap, throttle, timer, } from 'rxjs';
+import { exhaustMapWithTrailing } from 'rxjs-exhaustmap-with-trailing';
+import { build } from '../build.js';
+import { collectFiles, loadEnvFiles, validateNvsKeys } from '../deploy.js';
+import { formatDeployEvent } from '../deployProgress.js';
+import { getMikroDir, resolveProjectRoot } from '../projectRoot.js';
+import { getPredeployCommands, runHooks } from '../runHooks.js';
+import { createWatcher } from '../watcher.js';
+// ── Factory ────────────────────────────────────────────────
+export function createDevSession(options) {
+    const { session, repl, externalDeploys$, entry, forceDeploy, minify, bytecode, watch, noHooks, minifier, minifyLevel, logLevel, envFile, secretsFile, noEnvFile, } = options;
+    const buildDir = pathlib.join(getMikroDir(), 'build');
+    const watchDir = process.cwd();
+    const projectRoot = resolveProjectRoot();
+    const watcher = watch ? createWatcher(watchDir) : null;
+    // Pre-deploy hooks gate each deploy. A trigger fires `hookStage$`, which
+    // runs `mikrojs.predeploy` commands from package.json; on success it feeds
+    // `deployNow$`, which is serialized by `exhaustMapWithTrailing` into the
+    // real build+upload. `switchMap` on the hook stream means a fresh save
+    // during a running `tsc`/`eslint` aborts the in-flight hook and restarts.
+    // Build+upload itself is not cancelable — aborting a partial flash would
+    // leave the device in an inconsistent state.
+    const deployNow$ = new Subject();
+    function hookStage$(trigger) {
+        // Re-read package.json per trigger so edits to `mikrojs.predeploy` are
+        // picked up without restarting the dev session.
+        let commands;
+        try {
+            commands = noHooks ? [] : getPredeployCommands(projectRoot);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            repl?.setError(message);
+            return of({ status: { type: 'error', message } });
+        }
+        const advanceToDeploy$ = defer(() => {
+            deployNow$.next(trigger);
+            return EMPTY;
+        });
+        const firstCommand = commands[0];
+        if (firstCommand === undefined)
+            return advanceToDeploy$;
+        const decoder = new TextDecoder();
+        // Accumulate hook output so a failure can pin it into the footer
+        // alongside the summary line. Captured per-run via defer so every
+        // subscription gets a fresh buffer.
+        return defer(() => {
+            let output = '';
+            return concat(of({ status: { type: 'checking', command: firstCommand } }), runHooks(commands, projectRoot).pipe(tap((event) => {
+                if (event.type === 'start') {
+                    repl?.setDeployStatus(`Checking: ${event.command}`);
+                }
+                else if (event.type === 'stdout' || event.type === 'stderr') {
+                    output += decoder.decode(event.chunk, { stream: true });
+                    // In agent/no-repl mode, stream chunks to stderr so
+                    // output is still visible live.
+                    if (!repl)
+                        process.stderr.write(event.chunk);
+                }
+            }), ignoreElements()), advanceToDeploy$).pipe(tap({ subscribe: () => repl?.setDisabled(true) }), catchError((err) => {
+                const message = err instanceof Error ? err.message : String(err);
+                const trimmed = output.trimEnd();
+                const pinned = trimmed.length > 0 ? `${trimmed}\n\n${message}` : message;
+                repl?.setFooterError(pinned);
+                repl?.setDisabled(false);
+                return of({ status: { type: 'error', message } });
+            }));
+        });
+    }
+    function buildAndDeploy$(trigger) {
+        const buildStatus = trigger.isInitial ? { type: 'building' } : { type: 'rebuilding' };
+        return concat(
+        // Build phase
+        of({ status: buildStatus }), build(entry, buildDir, { minify, bytecode, minifier, minifyLevel, logLevel }).pipe(ignoreElements()), 
+        // Deploy phase
+        defer(async () => {
+            const files = await collectFiles(buildDir);
+            const envVars = [
+                { key: 'MIKRO_ENV', value: 'development', secret: false },
+                ...(await loadEnvFiles({
+                    cwd: projectRoot,
+                    mode: 'development',
+                    envFile,
+                    secretsFile,
+                    noEnvFile,
+                })),
+            ];
+            validateNvsKeys(envVars);
+            return { files, envVars };
+        }).pipe(switchMap(({ files, envVars }) => session.deploy({ files, envVars, force: forceDeploy || trigger.force, restart: true }).pipe(
+        // Throttle only `checking` events so fast checksum scans don't flicker;
+        // other event types pass through instantly via EMPTY.
+        throttle((event) => (event.type === 'checking' ? timer(80) : EMPTY), {
+            leading: true,
+            trailing: true,
+        }), tap((event) => {
+            if (!repl)
+                return;
+            const msg = event.type === 'checking'
+                ? `Checking [${event.index + 1}/${event.total}] ${event.file}`
+                : formatDeployEvent(event);
+            if (msg !== null)
+                repl.setDeployStatus(msg);
+        }), map((event) => ({ status: { type: 'deploying', event } }))))), 
+        // Done
+        of({ status: { type: 'watching' } })).pipe(tap({
+            subscribe: () => repl?.setDisabled(true),
+            complete: () => repl?.setDisabled(false),
+        }), catchError((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            repl?.setError(message);
+            repl?.setDisabled(false);
+            return of({ status: { type: 'error', message } });
+        }));
+    }
+    // External triggers: file changes (if watching) and explicit deploys
+    // (Ctrl+S via repl, or agent-mode stdin command).
+    const fileTriggers$ = watcher
+        ? watcher.changes$.pipe(map(() => ({ force: false, isInitial: false })))
+        : EMPTY;
+    const deployTriggers$ = repl && externalDeploys$
+        ? merge(repl.deploys$, externalDeploys$)
+        : (repl?.deploys$ ?? externalDeploys$ ?? EMPTY);
+    const explicitTriggers$ = deployTriggers$.pipe(map((t) => ({ force: t.force, isInitial: false })));
+    // Initial trigger injected at subscription time. Concat ensures it fires
+    // before any external trigger is processed. We also issue a one-shot
+    // `session.restart()` here so the device boots fresh and emits MSG_READY
+    // — the REPL's `ready` transition would otherwise ride on the deploy
+    // path's awaitReady$, leaving the session stuck in 'connecting' (with
+    // troubleshooting UI) whenever a hook failure short-circuits the deploy.
+    let hasKickedReady = false;
+    const initialTrigger$ = defer(() => {
+        if (!hasKickedReady) {
+            hasKickedReady = true;
+            session.restart();
+        }
+        return of({ force: forceDeploy, isInitial: true });
+    });
+    const triggers$ = concat(initialTrigger$, merge(fileTriggers$, explicitTriggers$));
+    // Hook phase is cancelable via switchMap: a new save mid-`tsc` aborts the
+    // in-flight hook run and restarts with the latest files. On success, the
+    // trigger is pushed into deployNow$ for the (non-cancelable) build+upload.
+    const hookPhase$ = triggers$.pipe(switchMap((trigger) => hookStage$(trigger)));
+    // Build+upload phase: exhaust-with-trailing so rapid triggers during a
+    // running deploy coalesce into a single trailing rerun.
+    const deployPhase$ = deployNow$.pipe(exhaustMapWithTrailing((trigger) => buildAndDeploy$(trigger)));
+    // Order matters in the merge: deployPhase$ subscribes to deployNow$ before
+    // hookPhase$ starts emitting, so a synchronous `deployNow$.next(...)` from
+    // a no-hooks initial trigger isn't dropped.
+    const state$ = merge(deployPhase$, hookPhase$).pipe(startWith({ status: { type: 'building' } }), shareReplay({ bufferSize: 1, refCount: true }));
+    return {
+        state$,
+        close() {
+            watcher?.close();
+            deployNow$.complete();
+        },
+    };
+}
+//# sourceMappingURL=devSession.js.map

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

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

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

@@ -0,0 +1,25 @@
+import { type ComponentType } from 'react';
+/**
+ * Dispatch a REPL-class command (`dev`, `console`, `deploy`) between its
+ * agent-mode `run` entry point and its interactive Ink `Component`. Keeps
+ * the three `case` blocks in `cli.ts` from each re-deriving the same
+ * "is this interactive" check and re-specifying the same render options.
+ */
+export declare function dispatchReplCommand<T extends {
+    agent?: boolean;
+}>(opts: {
+    /** Used only for the TTY-required error message. */
+    commandName: 'dev' | 'console' | 'deploy';
+    config: T;
+    /** Extra forcing conditions for the async path (e.g. deploy's `--json`). */
+    nonInteractive?: boolean;
+    /** When true, absence of a TTY is an error unless `--agent` is set.
+     *  `dev` and `console` need this (the Ink UI has no sensible fallback).
+     *  `deploy` sets it false and silently falls through to `run`. */
+    requireTtyForInteractive: boolean;
+    Component: ComponentType<{
+        args: T;
+    }>;
+    run: (config: T) => void | Promise<unknown>;
+}): void;
+//# sourceMappingURL=dispatchReplCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchReplCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/serial/dispatchReplCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,aAAa,EAAgB,MAAM,OAAO,CAAA;AAIvD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAC,EAAE,IAAI,EAAE;IACrE,oDAAoD;IACpD,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAA;IACzC,MAAM,EAAE,CAAC,CAAA;IACT,4EAA4E;IAC5E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;sEAEkE;IAClE,wBAAwB,EAAE,OAAO,CAAA;IACjC,SAAS,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAC,CAAC,CAAA;IACnC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5C,GAAG,IAAI,CAqBP"}

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

@@ -0,0 +1,27 @@
+import { render } from 'ink';
+import { createElement } from 'react';
+import { isAgentMode } from '../agent.js';
+/**
+ * Dispatch a REPL-class command (`dev`, `console`, `deploy`) between its
+ * agent-mode `run` entry point and its interactive Ink `Component`. Keeps
+ * the three `case` blocks in `cli.ts` from each re-deriving the same
+ * "is this interactive" check and re-specifying the same render options.
+ */
+export function dispatchReplCommand(opts) {
+    const isAgent = isAgentMode(opts.config.agent);
+    const nonTty = !process.stdin.isTTY;
+    if (opts.requireTtyForInteractive && nonTty && !isAgent) {
+        // eslint-disable-next-line no-console
+        console.error(`Error: mikro ${opts.commandName} requires an interactive terminal (use --agent for NDJSON mode)`);
+        process.exit(1);
+    }
+    if (isAgent || opts.nonInteractive === true || nonTty) {
+        void opts.run(opts.config);
+        return;
+    }
+    render(createElement(opts.Component, { args: opts.config }), {
+        exitOnCtrlC: false,
+        kittyKeyboard: { mode: 'enabled' },
+    });
+}
+//# sourceMappingURL=dispatchReplCommand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchReplCommand.js","sourceRoot":"","sources":["../../../../src/cli/lib/serial/dispatchReplCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,KAAK,CAAA;AAC1B,OAAO,EAAqB,aAAa,EAAC,MAAM,OAAO,CAAA;AAEvD,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAA8B,IAYhE;IACC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAA;IAEnC,IAAI,IAAI,CAAC,wBAAwB,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACxD,sCAAsC;QACtC,OAAO,CAAC,KAAK,CACX,gBAAgB,IAAI,CAAC,WAAW,iEAAiE,CAClG,CAAA;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,IAAI,OAAO,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,IAAI,MAAM,EAAE,CAAC;QACtD,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,OAAM;IACR,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,EAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAC,CAAC,EAAE;QACzD,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC;KACjC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+import { SerialPort } from 'serialport';
+import { type ReplSession } from '../session.js';
+export interface SessionHandles {
+    session: ReplSession;
+    serial: SerialPort;
+    devicePath: string;
+    /** Close session + serial. Safe to call more than once. */
+    close(): void;
+}
+export interface OpenSessionOptions {
+    port?: string;
+    /**
+     * Safe-mode recovery. Runs `triggerSafeMode` after the session has
+     * subscribed — the post-reset MSG_READY needs that eager subscription
+     * to be in place.
+     */
+    recover?: boolean;
+    /** Called with the resolved device path before the serial is opened. */
+    onConnecting?: (path: string) => void;
+}
+/**
+ * Resolve a port, open the serial, and bring up a `ReplSession`. The returned
+ * handles close the session and the serial when `close()` is called. The
+ * session is created before any optional `triggerSafeMode` call so the
+ * eager subscription is listening when the post-reset MSG_READY arrives.
+ */
+export declare function openSession(options: OpenSessionOptions): Promise<SessionHandles>;
+//# sourceMappingURL=openSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openSession.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/serial/openSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAIrC,OAAO,EAAc,KAAK,WAAW,EAAC,MAAM,eAAe,CAAA;AAG3D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,UAAU,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wEAAwE;IACxE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoCtF"}