mikrojs 0.0.0 → 0.0.8

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

@@ -0,0 +1,63 @@
+import type { InferValue } from '@optique/core/parser';
+import type { ReplSession } from '../lib/session.js';
+export declare const args: import("@optique/core").Parser<"sync", {
+    readonly action: "deploy";
+    readonly entry: string | undefined;
+    readonly port: string | undefined;
+    readonly console: true | undefined;
+    readonly erase: true | undefined;
+    readonly force: true | undefined;
+    readonly env: string | undefined;
+    readonly secrets: string | undefined;
+    readonly noEnvFile: true | undefined;
+    readonly noRestart: true | undefined;
+    readonly recover: true | undefined;
+    readonly noMinify: true | undefined;
+    readonly minifier: string | undefined;
+    readonly minifyLevel: string | undefined;
+    readonly noBytecode: true | undefined;
+    readonly noHooks: true | undefined;
+    readonly logLevel: string | undefined;
+    readonly json: true | undefined;
+    readonly agent: true | undefined;
+}, ["matched", string] | ["parsing", {
+    readonly action: "deploy";
+    readonly entry: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly port: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly console: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly erase: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly force: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly env: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly secrets: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly noEnvFile: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noRestart: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly recover: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noMinify: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly minifier: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly minifyLevel: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly noBytecode: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noHooks: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly logLevel: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly json: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly agent: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+}] | undefined>;
+type Props = {
+    args: InferValue<typeof args>;
+};
+/**
+ * Non-Ink deploy: runs as a plain async function. With `--console`, returns
+ * the session + devicePath so the caller can attach `InkReplConsole`; the
+ * session is intentionally not closed here in that case — the Ink-mode
+ * REPL owns it for its lifetime and cleanup happens on `process.exit`.
+ */
+export declare function run(config: InferValue<typeof args>): Promise<{
+    session: ReplSession;
+    devicePath: string;
+} | null>;
+/**
+ * Ink component for deploy with interactive device selection.
+ * Handles both plain deploy and --console mode.
+ */
+export default function Deploy(props: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=deploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAA;AAoBpD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAA;AAElD,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA2EhB,CAAA;AAED,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,wBAAsB,GAAG,CACvB,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,GAC9B,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAC,GAAG,IAAI,CAAC,CA0I5D;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,KAAK,2CAQ1C"}

package/dist/cli/commands/deploy.js

@@ -0,0 +1,242 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as pathlib from 'node:path';
+import { command, constant, message, optional } from '@optique/core';
+import { object } from '@optique/core/constructs';
+import { argument, flag, option } from '@optique/core/primitives';
+import { string } from '@optique/core/valueparser';
+import { path } from '@optique/run';
+import { useInput } from 'ink';
+import React, { useEffect, useState } from 'react';
+import { lastValueFrom, tap } from 'rxjs';
+import { DevicePicker } from '../components/DevicePicker.js';
+import { agentEmit, agentResult, isAgentMode } from '../lib/agent.js';
+import { build } from '../lib/build.js';
+import { collectFiles, loadEnvFiles, validateNvsKeys } from '../lib/deploy.js';
+import { formatDeployEvent } from '../lib/deployProgress.js';
+import { parseLogLevel, parseMinifier, parseMinifyLevel } from '../lib/parseMinifier.js';
+import { getMikroDir, resolveProjectRoot } from '../lib/projectRoot.js';
+import { resolveEntry } from '../lib/resolveEntry.js';
+import { getPredeployCommands, runHooks } from '../lib/runHooks.js';
+import { InkReplConsole } from '../lib/serial/InkReplConsole.js';
+import { openSession } from '../lib/serial/openSession.js';
+export const args = command('deploy', object({
+    action: constant('deploy'),
+    entry: optional(argument(path({ metavar: 'ENTRY', mustExist: true, type: 'file' }))),
+    port: optional(option('-p', '--port', string({ metavar: 'PORT' }), {
+        description: message `Serial port of device to deploy to`,
+    })),
+    console: optional(flag('--console', {
+        description: message `Attach console after deploy and restart device`,
+    })),
+    erase: optional(flag('-e', '--erase', {
+        description: message `Erase current app before uploading`,
+    })),
+    force: optional(flag('-f', '--force', {
+        description: message `Force full upload, ignoring cached checksums`,
+    })),
+    env: optional(option('--env', string({ metavar: 'FILE' }), {
+        description: message `Path to .env file with environment variables`,
+    })),
+    secrets: optional(option('--secrets', string({ metavar: 'FILE' }), {
+        description: message `Path to .env.secrets file with secrets`,
+    })),
+    noEnvFile: optional(flag('--no-env-file', {
+        description: message `Skip auto-loading of .env and .env.production from the project root`,
+    })),
+    noRestart: optional(flag('--no-restart', {
+        description: message `Do not restart device after deploy`,
+    })),
+    recover: optional(flag('--recover', {
+        description: message `Reset the device into safe mode before deploying. Use when the deployed app is crash-looping.`,
+    })),
+    noMinify: optional(flag('--no-minify', { description: message `Skip minification` })),
+    minifier: optional(option('--minifier', string({ metavar: 'NAME' }), {
+        description: message `Minifier: esbuild, terser, or swc (default: esbuild)`,
+    })),
+    minifyLevel: optional(option('--minify-level', string({ metavar: 'LEVEL' }), {
+        description: message `Minify level: default or max`,
+    })),
+    noBytecode: optional(flag('--no-bytecode', { description: message `Skip bytecode compilation` })),
+    noHooks: optional(flag('--no-hooks', {
+        description: message `Skip mikrojs.predeploy hooks from package.json`,
+    })),
+    logLevel: optional(option('--loglevel', string({ metavar: 'LEVEL' }), {
+        description: message `Log level: none, error, warn, info, debug. Console calls below this level are eliminated at build time.`,
+    })),
+    json: optional(flag('--json', { description: message `Output as JSON` })),
+    agent: optional(flag('--agent', { description: message `Output as JSON (agent mode)` })),
+}));
+/**
+ * Non-Ink deploy: runs as a plain async function. With `--console`, returns
+ * the session + devicePath so the caller can attach `InkReplConsole`; the
+ * session is intentionally not closed here in that case — the Ink-mode
+ * REPL owns it for its lifetime and cleanup happens on `process.exit`.
+ */
+export async function run(config) {
+    const entry = resolveEntry(config.entry);
+    const buildDir = pathlib.join(getMikroDir(), 'build');
+    const doMinify = !config.noMinify;
+    const minifier = parseMinifier(config.minifier);
+    const minifyLevel = parseMinifyLevel(config.minifyLevel);
+    const logLevel = parseLogLevel(config.logLevel) ?? 'warn';
+    const doBytecode = !config.noBytecode;
+    const doErase = config.erase === true;
+    const doForce = config.force === true;
+    const doRestart = !config.noRestart;
+    const jsonOutput = config.json === true || isAgentMode(config.agent);
+    // eslint-disable-next-line no-console
+    const log = jsonOutput ? () => { } : (msg) => console.error(msg);
+    // Run pre-deploy hooks (tsc, eslint, etc.) declared in package.json.
+    if (config.noHooks !== true) {
+        const projectRoot = resolveProjectRoot();
+        const commands = getPredeployCommands(projectRoot);
+        if (commands.length > 0) {
+            log(`Running ${commands.length} pre-deploy hook(s)…`);
+            await lastValueFrom(runHooks(commands, projectRoot).pipe(tap((event) => {
+                if (event.type === 'start')
+                    log(`  $ ${event.command}`);
+                else if (event.type === 'stdout' || event.type === 'stderr') {
+                    process.stderr.write(event.chunk);
+                }
+            })), { defaultValue: undefined });
+        }
+    }
+    // Build
+    log('Building…');
+    await lastValueFrom(build(entry, buildDir, {
+        minify: doMinify,
+        bytecode: doBytecode,
+        minifier,
+        minifyLevel,
+        logLevel,
+    }), { defaultValue: undefined });
+    // Collect files
+    const files = await collectFiles(buildDir);
+    const totalBytes = files.reduce((sum, f) => sum + f.data.length, 0);
+    log(`Built ${files.length} file(s), ${totalBytes} bytes total`);
+    // Load env vars
+    const envVars = [
+        { key: 'MIKRO_ENV', value: 'production', secret: false },
+        ...(await loadEnvFiles({
+            cwd: resolveProjectRoot(),
+            mode: 'production',
+            envFile: config.env,
+            secretsFile: config.secrets,
+            noEnvFile: config.noEnvFile === true,
+        })),
+    ];
+    validateNvsKeys(envVars);
+    if (envVars.length > 0) {
+        const envCount = envVars.filter((v) => !v.secret).length;
+        const secretCount = envVars.filter((v) => v.secret).length;
+        if (envCount > 0)
+            log(`Loaded ${envCount} env variable(s)`);
+        if (secretCount > 0)
+            log(`Loaded ${secretCount} secret(s)`);
+    }
+    // Connect to device
+    const handles = await openSession({
+        port: config.port,
+        recover: config.recover === true,
+        onConnecting: (path) => {
+            log(`Connecting to ${path}…`);
+            if (config.recover)
+                log('Triggering safe mode…');
+        },
+    });
+    const { session, devicePath } = handles;
+    try {
+        const last = await lastValueFrom(session
+            .deploy({
+            files,
+            envVars,
+            erase: doErase,
+            force: doForce,
+            restart: doRestart,
+        })
+            .pipe(tap((event) => {
+            if (jsonOutput) {
+                if (event.type === 'uploading' || event.type === 'checking') {
+                    agentEmit({
+                        type: `deploy_${event.type}`,
+                        file: event.file,
+                        index: event.index,
+                        total: event.total,
+                    });
+                }
+                return;
+            }
+            const msg = formatDeployEvent(event);
+            if (msg !== null)
+                log(`  ${msg}`);
+        })));
+        if (last.type !== 'complete')
+            throw new Error('Deploy did not complete');
+    }
+    finally {
+        if (!config.console)
+            handles.close();
+    }
+    if (jsonOutput) {
+        agentResult('deploy', {
+            device: devicePath,
+            files: files.map((f) => ({ path: f.path, size: f.data.length })),
+            totalBytes,
+        }, [
+            { command: `mikro console -p ${devicePath}`, description: 'Connect to device console' },
+            { command: 'mikro deploy --console', description: 'Deploy and attach console' },
+            { command: `mikro env list -p ${devicePath}`, description: 'List device env vars' },
+        ]);
+    }
+    else {
+        log(`Deployed ${files.length} file(s) to ${devicePath}`);
+    }
+    if (config.console) {
+        return { session, devicePath };
+    }
+    return null;
+}
+/**
+ * Ink component for deploy with interactive device selection.
+ * Handles both plain deploy and --console mode.
+ */
+export default function Deploy(props) {
+    const { args: config } = props;
+    return (_jsx(DevicePicker, { port: config.port, children: (device) => _jsx(DeployInner, { config: config, device: device }) }));
+}
+function DeployInner({ config, device }) {
+    const [session, setSession] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        run({ ...config, port: device.path }).then((result) => {
+            if (result)
+                setSession(result.session);
+            else
+                process.exit(0);
+        }, (err) => {
+            setError(err instanceof Error ? err.message : String(err));
+        });
+    }, [config, device.path]);
+    // Ctrl+C / Ctrl+Q while the deploy is still running (no REPL yet).
+    useInput((_ch, key) => {
+        if (key.ctrl && (_ch === 'c' || _ch === 'q'))
+            process.exit(0);
+    }, { isActive: !session });
+    // Exit-on-error as a side effect, not inside render. Calling console.error
+    // + process.exit during render triggers React's "nested component updates
+    // from render" warning because Ink re-renders in response to stderr writes
+    // and the scheduled exit.
+    useEffect(() => {
+        if (!error)
+            return;
+        // eslint-disable-next-line no-console
+        console.error(`Error: ${error}`);
+        process.exit(1);
+    }, [error]);
+    if (error)
+        return null;
+    if (!session)
+        return null;
+    return _jsx(InkReplConsole, { session: session, devicePath: device.path });
+}
+//# sourceMappingURL=deploy.js.map

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

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

package/dist/cli/commands/dev.d.ts

@@ -0,0 +1,41 @@
+import type { InferValue } from '@optique/core/parser';
+export declare const args: import("@optique/core").Parser<"sync", {
+    readonly action: "dev";
+    readonly entry: string | undefined;
+    readonly port: string | undefined;
+    readonly forceDeploy: true | undefined;
+    readonly noMinify: true | undefined;
+    readonly minifier: string | undefined;
+    readonly minifyLevel: string | undefined;
+    readonly noBytecode: true | undefined;
+    readonly noHooks: true | undefined;
+    readonly logLevel: string | undefined;
+    readonly env: string | undefined;
+    readonly secrets: string | undefined;
+    readonly noEnvFile: true | undefined;
+    readonly noWatch: true | undefined;
+    readonly agent: true | undefined;
+}, ["matched", string] | ["parsing", {
+    readonly action: "dev";
+    readonly entry: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly port: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly forceDeploy: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noMinify: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly minifier: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly minifyLevel: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly noBytecode: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noHooks: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly logLevel: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly env: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly secrets: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly noEnvFile: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noWatch: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly agent: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+}] | undefined>;
+type Props = {
+    args: InferValue<typeof args>;
+};
+export declare function run(config: InferValue<typeof args>): Promise<never>;
+export default function Dev(props: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=dev.d.ts.map

package/dist/cli/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAA;AAmBpD,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAyDhB,CAAA;AAED,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;CAC9B,CAAA;AAED,wBAAsB,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,kBAuFxD;AAED,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,KAAK,EAAE,KAAK,2CAoDvC"}

package/dist/cli/commands/dev.js

@@ -0,0 +1,170 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { command, constant, message, object, optional } from '@optique/core';
+import { argument, flag, option } from '@optique/core/primitives';
+import { string } from '@optique/core/valueparser';
+import { path } from '@optique/run';
+import { useCallback } from 'react';
+import { filter, firstValueFrom, map, Subject } from 'rxjs';
+import { DevicePicker } from '../components/DevicePicker.js';
+import { agentEmit } from '../lib/agent.js';
+import { parseLogLevel, parseMinifier, parseMinifyLevel } from '../lib/parseMinifier.js';
+import { resolveEntry } from '../lib/resolveEntry.js';
+import { createDevSession } from '../lib/serial/devSession.js';
+import { InkReplMode, } from '../lib/serial/InkReplMode.js';
+import { runAgentRepl } from '../lib/serial/runAgentRepl.js';
+export const args = command('dev', object({
+    action: constant('dev'),
+    entry: optional(argument(path({ metavar: 'ENTRY', mustExist: true, type: 'file' }))),
+    port: optional(option('-p', '--port', string({ metavar: 'PORT' }), {
+        description: message `Serial port of device`,
+    })),
+    forceDeploy: optional(flag('--force-deploy', { description: message `Force full deploy, ignoring cached checksums` })),
+    noMinify: optional(flag('--no-minify', { description: message `Skip minification` })),
+    minifier: optional(option('--minifier', string({ metavar: 'NAME' }), {
+        description: message `Minifier: esbuild, terser, or swc (default: esbuild)`,
+    })),
+    minifyLevel: optional(option('--minify-level', string({ metavar: 'LEVEL' }), {
+        description: message `Minify level: default or max`,
+    })),
+    noBytecode: optional(flag('--no-bytecode', { description: message `Skip bytecode compilation` })),
+    noHooks: optional(flag('--no-hooks', {
+        description: message `Skip mikrojs.predeploy hooks from package.json`,
+    })),
+    logLevel: optional(option('--loglevel', string({ metavar: 'LEVEL' }), {
+        description: message `Log level: none, error, warn, info, debug. Console calls below this level are eliminated at build time.`,
+    })),
+    env: optional(option('--env', string({ metavar: 'FILE' }), {
+        description: message `Path to .env file with environment variables`,
+    })),
+    secrets: optional(option('--secrets', string({ metavar: 'FILE' }), {
+        description: message `Path to .env.secrets file with secrets`,
+    })),
+    noEnvFile: optional(flag('--no-env-file', {
+        description: message `Skip auto-loading of .env and .env.development from the project root`,
+    })),
+    noWatch: optional(flag('--no-watch', {
+        description: message `Deploy once, then drop into the REPL without watching for file changes`,
+    })),
+    agent: optional(flag('--agent', { description: message `NDJSON agent protocol over stdio` })),
+}));
+export async function run(config) {
+    const deploys$ = new Subject();
+    let dev = null;
+    let stateSub = null;
+    return runAgentRepl({ port: config.port }, {
+        command: 'dev',
+        onReady: async ({ session }) => {
+            dev = createDevSession({
+                session,
+                entry: resolveEntry(config.entry),
+                forceDeploy: config.forceDeploy === true,
+                minify: !config.noMinify,
+                bytecode: !config.noBytecode,
+                watch: config.noWatch !== true,
+                noHooks: config.noHooks === true,
+                minifier: parseMinifier(config.minifier),
+                minifyLevel: parseMinifyLevel(config.minifyLevel),
+                logLevel: parseLogLevel(config.logLevel),
+                envFile: config.env,
+                secretsFile: config.secrets,
+                noEnvFile: config.noEnvFile === true,
+                externalDeploys$: deploys$.asObservable(),
+            });
+            // Translate DevSessionState transitions into agent NDJSON events.
+            // Every distinct status emits exactly once; the state$ shareReplay
+            // deduplicates identical re-emissions naturally.
+            const idleStatus = config.noWatch === true ? 'idle' : 'watching';
+            stateSub = dev.state$.subscribe((state) => {
+                switch (state.status.type) {
+                    case 'checking':
+                        agentEmit({ type: 'status', status: 'checking', command: state.status.command });
+                        break;
+                    case 'building':
+                    case 'rebuilding':
+                        agentEmit({ type: 'status', status: 'building' });
+                        break;
+                    case 'deploying': {
+                        const event = state.status.event;
+                        if (event.type === 'uploading' || event.type === 'checking') {
+                            agentEmit({
+                                type: `deploy_${event.type}`,
+                                file: event.file,
+                                index: event.index,
+                                total: event.total,
+                            });
+                        }
+                        else if (event.type === 'connecting') {
+                            agentEmit({ type: 'status', status: 'deploying' });
+                        }
+                        break;
+                    }
+                    case 'watching':
+                        agentEmit({ type: 'status', status: idleStatus });
+                        break;
+                    case 'error':
+                        agentEmit({ type: 'status', status: 'error', error: state.status.message });
+                        break;
+                }
+            });
+            // Await the first non-building state to detect initial-deploy failure.
+            // `watching` means the initial deploy succeeded; `error` means we
+            // should exit(1) via the hook contract.
+            await firstValueFrom(dev.state$.pipe(filter((s) => s.status.type === 'watching' || s.status.type === 'error'), map((s) => {
+                if (s.status.type === 'error')
+                    throw new Error(s.status.message);
+                return s;
+            })));
+        },
+        onDeploy: (force) => deploys$.next({ force }),
+        onDispose: () => {
+            stateSub?.unsubscribe();
+            dev?.close();
+        },
+        nextActions: [
+            { command: 'mikro deploy', description: 'Deploy to device' },
+            { command: 'mikro console', description: 'Connect to device console' },
+        ],
+    });
+}
+export default function Dev(props) {
+    const { port, noMinify, noBytecode, forceDeploy, noWatch, noHooks } = props.args;
+    const minifier = parseMinifier(props.args.minifier);
+    const minifyLevel = parseMinifyLevel(props.args.minifyLevel);
+    const logLevel = parseLogLevel(props.args.logLevel);
+    const entry = resolveEntry(props.args.entry);
+    const driver = useCallback(({ session, repl }) => {
+        const dev = createDevSession({
+            session,
+            repl,
+            entry,
+            forceDeploy: forceDeploy === true,
+            minify: !noMinify,
+            bytecode: !noBytecode,
+            watch: noWatch !== true,
+            noHooks: noHooks === true,
+            minifier,
+            minifyLevel,
+            logLevel,
+            envFile: props.args.env,
+            secretsFile: props.args.secrets,
+            noEnvFile: props.args.noEnvFile === true,
+        });
+        return { run$: dev.state$, dispose: () => dev.close() };
+    }, [
+        entry,
+        forceDeploy,
+        noMinify,
+        noBytecode,
+        noWatch,
+        noHooks,
+        minifier,
+        minifyLevel,
+        logLevel,
+        props.args.env,
+        props.args.secrets,
+        props.args.noEnvFile,
+    ]);
+    const watch = noWatch !== true;
+    return (_jsx(DevicePicker, { port: port, children: (device) => (_jsx(InkReplMode, { devicePath: device.path, logLevel: logLevel, driver: driver, watch: watch })) }));
+}
+//# sourceMappingURL=dev.js.map

package/dist/cli/commands/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../../src/cli/commands/dev.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,eAAe,CAAA;AAE1E,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAC,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAC,MAAM,EAAC,MAAM,2BAA2B,CAAA;AAChD,OAAO,EAAC,IAAI,EAAC,MAAM,cAAc,CAAA;AACjC,OAAO,EAAC,WAAW,EAAC,MAAM,OAAO,CAAA;AACjC,OAAO,EAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAoB,MAAM,MAAM,CAAA;AAE5E,OAAO,EAAC,YAAY,EAAC,MAAM,+BAA+B,CAAA;AAC1D,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAC,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAC,MAAM,yBAAyB,CAAA;AACtF,OAAO,EAAC,YAAY,EAAC,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAC,gBAAgB,EAAwB,MAAM,6BAA6B,CAAA;AACnF,OAAO,EAGL,WAAW,GACZ,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAC,YAAY,EAAC,MAAM,+BAA+B,CAAA;AAE1D,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CACzB,KAAK,EACL,MAAM,CAAC;IACL,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC;IACvB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAC,CAAC,CAAC,CAAC;IAClF,IAAI,EAAE,QAAQ,CACZ,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAC,OAAO,EAAE,MAAM,EAAC,CAAC,EAAE;QAChD,WAAW,EAAE,OAAO,CAAA,uBAAuB;KAC5C,CAAC,CACH;IACD,WAAW,EAAE,QAAQ,CACnB,IAAI,CAAC,gBAAgB,EAAE,EAAC,WAAW,EAAE,OAAO,CAAA,8CAA8C,EAAC,CAAC,CAC7F;IACD,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,EAAC,WAAW,EAAE,OAAO,CAAA,mBAAmB,EAAC,CAAC,CAAC;IAClF,QAAQ,EAAE,QAAQ,CAChB,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,EAAC,OAAO,EAAE,MAAM,EAAC,CAAC,EAAE;QAC9C,WAAW,EAAE,OAAO,CAAA,sDAAsD;KAC3E,CAAC,CACH;IACD,WAAW,EAAE,QAAQ,CACnB,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,EAAC,OAAO,EAAE,OAAO,EAAC,CAAC,EAAE;QACnD,WAAW,EAAE,OAAO,CAAA,8BAA8B;KACnD,CAAC,CACH;IACD,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,EAAC,WAAW,EAAE,OAAO,CAAA,2BAA2B,EAAC,CAAC,CAAC;IAC9F,OAAO,EAAE,QAAQ,CACf,IAAI,CAAC,YAAY,EAAE;QACjB,WAAW,EAAE,OAAO,CAAA,gDAAgD;KACrE,CAAC,CACH;IACD,QAAQ,EAAE,QAAQ,CAChB,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,EAAC,OAAO,EAAE,OAAO,EAAC,CAAC,EAAE;QAC/C,WAAW,EAAE,OAAO,CAAA,yGAAyG;KAC9H,CAAC,CACH;IACD,GAAG,EAAE,QAAQ,CACX,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,EAAC,OAAO,EAAE,MAAM,EAAC,CAAC,EAAE;QACzC,WAAW,EAAE,OAAO,CAAA,8CAA8C;KACnE,CAAC,CACH;IACD,OAAO,EAAE,QAAQ,CACf,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,EAAC,OAAO,EAAE,MAAM,EAAC,CAAC,EAAE;QAC7C,WAAW,EAAE,OAAO,CAAA,wCAAwC;KAC7D,CAAC,CACH;IACD,SAAS,EAAE,QAAQ,CACjB,IAAI,CAAC,eAAe,EAAE;QACpB,WAAW,EAAE,OAAO,CAAA,sEAAsE;KAC3F,CAAC,CACH;IACD,OAAO,EAAE,QAAQ,CACf,IAAI,CAAC,YAAY,EAAE;QACjB,WAAW,EAAE,OAAO,CAAA,wEAAwE;KAC7F,CAAC,CACH;IACD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAC,WAAW,EAAE,OAAO,CAAA,kCAAkC,EAAC,CAAC,CAAC;CAC3F,CAAC,CACH,CAAA;AAMD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,MAA+B;IACvD,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAoB,CAAA;IAChD,IAAI,GAAG,GAA4B,IAAI,CAAA;IACvC,IAAI,QAAQ,GAAwB,IAAI,CAAA;IAExC,OAAO,YAAY,CACjB,EAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAC,EACnB;QACE,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,KAAK,EAAE,EAAC,OAAO,EAAC,EAAE,EAAE;YAC3B,GAAG,GAAG,gBAAgB,CAAC;gBACrB,OAAO;gBACP,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;gBACjC,WAAW,EAAE,MAAM,CAAC,WAAW,KAAK,IAAI;gBACxC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ;gBACxB,QAAQ,EAAE,CAAC,MAAM,CAAC,UAAU;gBAC5B,KAAK,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;gBAC9B,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;gBAChC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACxC,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC;gBACjD,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACxC,OAAO,EAAE,MAAM,CAAC,GAAG;gBACnB,WAAW,EAAE,MAAM,CAAC,OAAO;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,IAAI;gBACpC,gBAAgB,EAAE,QAAQ,CAAC,YAAY,EAAE;aAC1C,CAAC,CAAA;YAEF,kEAAkE;YAClE,mEAAmE;YACnE,iDAAiD;YACjD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAA;YAChE,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,QAAQ,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBAC1B,KAAK,UAAU;wBACb,SAAS,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAC,CAAC,CAAA;wBAC9E,MAAK;oBACP,KAAK,UAAU,CAAC;oBAChB,KAAK,YAAY;wBACf,SAAS,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAC,CAAC,CAAA;wBAC/C,MAAK;oBACP,KAAK,WAAW,CAAC,CAAC,CAAC;wBACjB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAA;wBAChC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;4BAC5D,SAAS,CAAC;gCACR,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;gCAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gCAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,KAAK,EAAE,KAAK,CAAC,KAAK;6BACnB,CAAC,CAAA;wBACJ,CAAC;6BAAM,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;4BACvC,SAAS,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAC,CAAC,CAAA;wBAClD,CAAC;wBACD,MAAK;oBACP,CAAC;oBACD,KAAK,UAAU;wBACb,SAAS,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAC,CAAC,CAAA;wBAC/C,MAAK;oBACP,KAAK,OAAO;wBACV,SAAS,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAC,CAAC,CAAA;wBACzE,MAAK;gBACT,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,uEAAuE;YACvE,kEAAkE;YAClE,wCAAwC;YACxC,MAAM,cAAc,CAClB,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,EACxE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACR,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBAChE,OAAO,CAAC,CAAA;YACV,CAAC,CAAC,CACH,CACF,CAAA;QACH,CAAC;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAC,KAAK,EAAC,CAAC;QAC3C,SAAS,EAAE,GAAG,EAAE;YACd,QAAQ,EAAE,WAAW,EAAE,CAAA;YACvB,GAAG,EAAE,KAAK,EAAE,CAAA;QACd,CAAC;QACD,WAAW,EAAE;YACX,EAAC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAC;YAC1D,EAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,2BAA2B,EAAC;SACrE;KACF,CACF,CAAA;AACH,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,KAAY;IACtC,MAAM,EAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAC,GAAG,KAAK,CAAC,IAAI,CAAA;IAC9E,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnD,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC5D,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAE5C,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,EAAC,OAAO,EAAE,IAAI,EAAuB,EAAuB,EAAE;QAC7D,MAAM,GAAG,GAAG,gBAAgB,CAAC;YAC3B,OAAO;YACP,IAAI;YACJ,KAAK;YACL,WAAW,EAAE,WAAW,KAAK,IAAI;YACjC,MAAM,EAAE,CAAC,QAAQ;YACjB,QAAQ,EAAE,CAAC,UAAU;YACrB,KAAK,EAAE,OAAO,KAAK,IAAI;YACvB,OAAO,EAAE,OAAO,KAAK,IAAI;YACzB,QAAQ;YACR,WAAW;YACX,QAAQ;YACR,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG;YACvB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;YAC/B,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI;SACzC,CAAC,CAAA;QACF,OAAO,EAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,EAAC,CAAA;IACvD,CAAC,EACD;QACE,KAAK;QACL,WAAW;QACX,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO;QACP,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,KAAK,CAAC,IAAI,CAAC,GAAG;QACd,KAAK,CAAC,IAAI,CAAC,OAAO;QAClB,KAAK,CAAC,IAAI,CAAC,SAAS;KACrB,CACF,CAAA;IAED,MAAM,KAAK,GAAG,OAAO,KAAK,IAAI,CAAA;IAE9B,OAAO,CACL,KAAC,YAAY,IAAC,IAAI,EAAE,IAAI,YACrB,CAAC,MAAM,EAAE,EAAE,CAAC,CACX,KAAC,WAAW,IAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAI,CAC3F,GACY,CAChB,CAAA;AACH,CAAC"}

package/dist/cli/commands/docs.d.ts

@@ -0,0 +1,7 @@
+export declare const args: import("@optique/core").Parser<"sync", {
+    readonly action: "docs";
+}, ["matched", string] | ["parsing", {
+    readonly action: "docs";
+}] | undefined>;
+export declare function run(): Promise<void>;
+//# sourceMappingURL=docs.d.ts.map

package/dist/cli/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,IAAI;;;;eAMhB,CAAA;AAED,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CASzC"}

package/dist/cli/commands/docs.js

@@ -0,0 +1,20 @@
+/* eslint-disable no-console */
+import { command, constant, message } from '@optique/core';
+import { object } from '@optique/core/constructs';
+import open from 'open';
+const DOCS_URL = 'https://mikrojs.dev/docs';
+export const args = command('docs', object({
+    action: constant('docs'),
+}), { description: message `Open the documentation in your browser` });
+export async function run() {
+    console.error(`Opening ${DOCS_URL}…`);
+    try {
+        await open(DOCS_URL);
+    }
+    catch (err) {
+        console.error(`Failed to open browser: ${err instanceof Error ? err.message : String(err)}`);
+        console.error(`Open manually: ${DOCS_URL}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=docs.js.map

package/dist/cli/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAC,MAAM,eAAe,CAAA;AACxD,OAAO,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAA;AAC/C,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,MAAM,QAAQ,GAAG,0BAA0B,CAAA;AAE3C,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CACzB,MAAM,EACN,MAAM,CAAC;IACL,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;CACzB,CAAC,EACF,EAAC,WAAW,EAAE,OAAO,CAAA,wCAAwC,EAAC,CAC/D,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,OAAO,CAAC,KAAK,CAAC,WAAW,QAAQ,GAAG,CAAC,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC5F,OAAO,CAAC,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAA;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC"}