mikrojs 0.0.0 → 0.0.8

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

@@ -0,0 +1,48 @@
+import { SerialPort } from 'serialport';
+import { BAUD_RATE, resolvePort } from '../deploy.js';
+import { triggerSafeMode } from '../recover.js';
+import { connectRepl } from '../session.js';
+import { createSerialTransport } from '../transport.js';
+/**
+ * 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 async function openSession(options) {
+    const devicePath = await resolvePort(options.port);
+    options.onConnecting?.(devicePath);
+    const serial = new SerialPort({ path: devicePath, baudRate: BAUD_RATE, autoOpen: false });
+    await new Promise((resolve, reject) => {
+        serial.open((err) => (err ? reject(err) : resolve()));
+    });
+    const transport = createSerialTransport(serial);
+    const session = connectRepl(transport);
+    if (options.recover === true) {
+        await triggerSafeMode(serial);
+    }
+    let closed = false;
+    return {
+        session,
+        serial,
+        devicePath,
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            try {
+                session.close();
+            }
+            catch {
+                // already closed
+            }
+            try {
+                serial.close();
+            }
+            catch {
+                // already closed
+            }
+        },
+    };
+}
+//# sourceMappingURL=openSession.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openSession.js","sourceRoot":"","sources":["../../../../src/cli/lib/serial/openSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAErC,OAAO,EAAC,SAAS,EAAE,WAAW,EAAC,MAAM,cAAc,CAAA;AACnD,OAAO,EAAC,eAAe,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,WAAW,EAAmB,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAC,qBAAqB,EAAC,MAAM,iBAAiB,CAAA;AAsBrD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAA;IAElC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC,CAAA;IACvF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;IAEtC,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,eAAe,CAAC,MAAM,CAAC,CAAA;IAC/B,CAAC;IAED,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,OAAO;QACL,OAAO;QACP,MAAM;QACN,UAAU;QACV,KAAK;YACH,IAAI,MAAM;gBAAE,OAAM;YAClB,MAAM,GAAG,IAAI,CAAA;YACb,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,EAAE,CAAA;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,EAAE,CAAA;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,169 @@
+import { type Observable } from 'rxjs';
+import type { ReplEvent, ReplSession } from '../session.js';
+export type ConnectionState = {
+    type: 'connecting';
+    message?: string;
+} | {
+    type: 'negotiating';
+    message?: string;
+} | {
+    type: 'ready';
+    chip: string | null;
+    deviceId: string | null;
+    firmwareVersion: string | null;
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'fallback';
+};
+/** Structured event entries accumulated by the state machine. */
+export type ReplLogEvent = ReplEvent | {
+    type: 'connecting';
+    port?: string;
+} | {
+    type: 'restarting';
+} | {
+    type: 'input';
+    code: string;
+    timing?: string;
+};
+export interface ReplMachineState {
+    connection: ConnectionState;
+    port?: string;
+    input: string;
+    cursor: number;
+    history: string[];
+    historyIdx: number;
+    historyDraft: string | null;
+    showWelcome: boolean;
+    evaluating: boolean;
+    paused: boolean;
+    showTroubleshooting: boolean;
+    ctrlCPending: boolean;
+    returnPending: boolean;
+    disabled: boolean;
+    deployStatus: string | null;
+    /** Sticky error message for the REPL footer (e.g. "Hook failed: tsc
+     *  --noEmit (exit 2)"). Cleared when the next deploy cycle starts. */
+    footerError: string | null;
+    overrideHint: string | null;
+    contextHint: string | null;
+    pendingInput: string | null;
+    pendingTiming: string | null;
+    overlay: null | 'env';
+    events: ReplLogEvent[];
+}
+export type KeyInfo = {
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    return: boolean;
+    tab: boolean;
+    backspace: boolean;
+    delete: boolean;
+    leftArrow: boolean;
+    rightArrow: boolean;
+    upArrow: boolean;
+    downArrow: boolean;
+    home: boolean;
+    end: boolean;
+};
+export type ReplAction = {
+    type: 'key';
+    ch: string;
+    key: KeyInfo;
+} | {
+    type: 'deviceEvent';
+    event: ReplEvent;
+} | {
+    type: 'setDisabled';
+    disabled: boolean;
+} | {
+    type: 'setDeployStatus';
+    message: string | null;
+} | {
+    type: 'setError';
+    message: string;
+} | {
+    type: 'setFooterError';
+    message: string | null;
+} | {
+    type: 'showTroubleshooting';
+} | {
+    type: 'ctrlCTimeout';
+} | {
+    type: 'returnResolve';
+} | {
+    type: 'closeOverlay';
+};
+export type ReplEffect = {
+    type: 'eval';
+    code: string;
+} | {
+    type: 'directive';
+    code: string;
+} | {
+    type: 'exit';
+} | {
+    type: 'restart';
+} | {
+    type: 'end';
+} | {
+    type: 'deploy';
+    force: boolean;
+} | {
+    type: 'appendHistory';
+    entry: string;
+} | {
+    type: 'scheduleCtrlCTimeout';
+} | {
+    type: 'scheduleReturnResolve';
+    multiline: boolean;
+};
+export declare const WELCOME_HINT = "Enter to submit  |  Ctrl+D to exit  |  Ctrl+C to clear  |  /help for commands";
+export declare const MULTILINE_HINT = "Ctrl+Enter to submit  |  Enter to add line";
+/** Find the line index and column for a cursor position in text */
+export declare function cursorLocation(text: string, cursor: number): {
+    line: number;
+    col: number;
+    lineCount: number;
+};
+/** Get the start offset of a given line index */
+export declare function lineStartOffset(text: string, lineIdx: number): number;
+export declare function loadHistory(): string[];
+export declare function appendHistory(entry: string): void;
+export declare function createInitialState(port?: string, history?: string[]): ReplMachineState;
+export declare function reduce(state: ReplMachineState, action: ReplAction): [ReplMachineState, ReplEffect[]];
+export interface ReplHandle {
+    state$: Observable<ReplMachineState>;
+    deploys$: Observable<{
+        force: boolean;
+    }>;
+    keyInput(ch: string, key: KeyInfo): void;
+    setDisabled(disabled: boolean): void;
+    setDeployStatus(message: string | null): void;
+    setError(message: string): void;
+    /** Pin an error message in the REPL footer until the next cycle
+     *  starts. Use alongside `logEvent({type:'error', …})` for errors
+     *  that should remain visible after the output scrolls past. */
+    setFooterError(message: string | null): void;
+    /** Append an entry to the REPL log pane without touching connection
+     *  state. Use for CLI-originated output (e.g. predeploy hook stdout/
+     *  stderr) that must survive Ink's patched stdout/stderr. */
+    logEvent(event: ReplLogEvent): void;
+    closeOverlay(): void;
+}
+export declare function createRepl(options: {
+    session: ReplSession;
+    port?: string;
+    onEnd: () => void;
+    /** Connection timeout in ms (default: 15000) */
+    timeout?: number;
+    loadHistory?: () => string[];
+    saveHistory?: (entry: string) => void;
+    /** When false, Ctrl+S does nothing (deploy isn't meaningful in this
+     *  context, e.g. `mikro console`). Defaults to true. */
+    deployEnabled?: boolean;
+}): ReplHandle;
+//# sourceMappingURL=replStateMachine.d.ts.map

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

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