snapshot-checker 0.1.1

package/dist/src/runCommand.js

@@ -0,0 +1,286 @@
+/**
+ * 单条命令执行模块：执行单条或按顺序执行多条命令，不涉及 group 概念。
+ * 命令执行失败的判断（Mac / Linux / Windows 通用）：
+ * - 进程正常退出：exitCode === 0 为成功，否则为失败
+ * - 进程被信号终止（Unix）：code 为 null，视为失败
+ * - spawn 报错（如找不到命令）：视为失败
+ */
+import { spawn } from 'node:child_process';
+import { platform } from 'node:os';
+import { CommandKind, getCurrentPlatformKind } from './types.js';
+import { BuiltinFunctionCommandRunner, EmbedCommandRunner, ShellCommandRunner, } from './runners/index.js';
+const currentPlatform = platform();
+/** 当前系统是否支持该命令类型：embed 全平台；linux/mac/windows 仅对应平台 */
+export function isSupportedOnCurrentPlatform(cmd) {
+    if (cmd.kind === CommandKind.Embed || cmd.kind === CommandKind.BuiltinFunction)
+        return true;
+    const current = getCurrentPlatformKind();
+    return cmd.kind === current;
+}
+const commandRunners = [
+    new EmbedCommandRunner(),
+    new BuiltinFunctionCommandRunner(),
+    new ShellCommandRunner(),
+];
+function getCommandRunner(cmd) {
+    return commandRunners.find((runner) => runner.canRun(cmd));
+}
+/** 执行单条命令 */
+export async function executeOne(cmd, options = {}) {
+    const { streamOutput = true, registerBackgroundProcess, commandContext } = options;
+    const start = Date.now();
+    const runner = getCommandRunner(cmd);
+    if (!runner) {
+        return {
+            kind: cmd.kind,
+            description: cmd.description ?? '',
+            success: false,
+            exitCode: null,
+            stdout: '',
+            stderr: `未找到可处理 kind=${cmd.kind} 的 CommandRunner`,
+            durationMs: Date.now() - start,
+        };
+    }
+    return runner.execute(cmd, {
+        streamOutput,
+        registerBackgroundProcess,
+        commandContext: commandContext ?? {},
+        start,
+    });
+}
+/**
+ * 将字符串中的 {{varName}} 占位符替换为上下文中的变量值。
+ * 未找到变量时保留原占位符，便于排查。
+ */
+function expandTemplate(str, context) {
+    return str.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        if (Object.prototype.hasOwnProperty.call(context, key)) {
+            return context[key] ?? '';
+        }
+        return match;
+    });
+}
+/**
+ * 基于当前上下文，对命令中的各个字符串字段进行变量展开。
+ * - run / file / args / cwd / description 支持 {{var}} 占位符。
+ */
+function applyContextToCommand(cmd, context) {
+    const next = { ...cmd };
+    if (next.run != null) {
+        next.run = expandTemplate(next.run, context);
+    }
+    if (next.file != null) {
+        next.file = expandTemplate(next.file, context);
+    }
+    if (next.cwd != null) {
+        next.cwd = expandTemplate(next.cwd, context);
+    }
+    if (next.description != null) {
+        next.description = expandTemplate(next.description, context);
+    }
+    if (Array.isArray(next.args)) {
+        next.args = next.args.map((arg) => expandTemplate(arg, context));
+    }
+    return next;
+}
+/**
+ * 根据 captureToVar 配置，从命令执行结果中提取变量值并写入上下文。
+ */
+function applyCaptureToContext(capture, result, context) {
+    if (!capture)
+        return;
+    if (!result.success)
+        return;
+    const from = capture.from ?? 'stdout';
+    const source = from === 'stderr' ? result.stderr : result.stdout;
+    const trimmed = source.trim();
+    if (!trimmed)
+        return;
+    let value;
+    if (capture.pattern) {
+        let match = null;
+        try {
+            const re = new RegExp(capture.pattern, 'm');
+            match = re.exec(trimmed);
+        }
+        catch {
+            // 正则不合法时直接跳过，不影响后续命令执行
+            return;
+        }
+        if (!match)
+            return;
+        const groupIndex = capture.groupIndex ?? 1;
+        if (groupIndex < match.length) {
+            value = match[groupIndex];
+        }
+    }
+    else {
+        value = trimmed;
+    }
+    if (value !== undefined) {
+        context[capture.name] = value;
+    }
+}
+const SIGTERM_WAIT_MS = 3000;
+function forceKillProcessTreeOnWindows(pid) {
+    return new Promise((resolve) => {
+        const killer = spawn('taskkill', ['/PID', String(pid), '/T', '/F'], {
+            shell: false,
+            stdio: 'ignore',
+        });
+        killer.once('close', () => resolve());
+        killer.once('error', () => resolve());
+    });
+}
+async function terminateChildProcess(child) {
+    const pid = child.pid;
+    if (pid == null)
+        return;
+    if (currentPlatform === 'win32') {
+        await forceKillProcessTreeOnWindows(pid);
+        return;
+    }
+    try {
+        child.kill('SIGTERM');
+    }
+    catch {
+        try {
+            child.kill('SIGKILL');
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+async function forceKillChildProcess(child) {
+    const pid = child.pid;
+    if (pid == null)
+        return;
+    if (currentPlatform === 'win32') {
+        await forceKillProcessTreeOnWindows(pid);
+        return;
+    }
+    try {
+        child.kill('SIGKILL');
+    }
+    catch {
+        /* ignore */
+    }
+}
+/** 优雅结束后台进程：先 SIGTERM，等待一段时间后未退出则 SIGKILL */
+async function gracefulKillBackground(children) {
+    if (children.length === 0)
+        return Promise.resolve();
+    await Promise.all(children.map((child) => terminateChildProcess(child)));
+    await Promise.race([
+        Promise.all(children.map((c) => new Promise((resolve) => {
+            const done = () => {
+                c.removeAllListeners('exit');
+                resolve();
+            };
+            c.once('exit', done);
+            if (c.exitCode != null)
+                done();
+        }))),
+        new Promise((resolve) => setTimeout(resolve, SIGTERM_WAIT_MS)),
+    ]);
+    await Promise.all(children.map((child) => forceKillChildProcess(child)));
+}
+/** 等待若干子进程自然退出（已退出的立即完成） */
+function waitForBackgroundProcesses(children) {
+    return Promise.all(children.map((c) => new Promise((resolve) => {
+        if (c.exitCode !== null || c.signalCode !== null) {
+            resolve();
+            return;
+        }
+        c.once('exit', () => resolve());
+        c.once('error', () => resolve());
+    }))).then(() => { });
+}
+/**
+ * 前台命令链结束后对后台子进程收尾：wait 为 true 则等到全部退出，否则优雅 kill。
+ */
+export async function finalizeBackgroundProcesses(children, wait, silent) {
+    if (children.length === 0)
+        return;
+    if (wait) {
+        if (!silent) {
+            console.log(`\n等待 ${children.length} 个后台进程全部结束后退出...`);
+        }
+        await waitForBackgroundProcesses(children);
+        if (!silent) {
+            console.log('所有后台进程已结束。\n');
+        }
+    }
+    else {
+        if (!silent) {
+            console.log(`\n正在结束 ${children.length} 个后台进程...`);
+        }
+        await gracefulKillBackground(children);
+    }
+}
+/** 按顺序执行多条命令（无组间间隔）。失败判断见 executeOne，支持 Mac/Linux/Windows。 */
+export async function executeAll(commands, options = {}) {
+    const { stopOnError = false, silent = false, streamOutput = !silent, offset = 0, total: explicitTotal, aggregateBackgroundChildren, waitForBackground = false, commandContext: sharedContext, } = options;
+    const results = [];
+    const context = sharedContext ?? {};
+    const localBackgroundChildren = [];
+    const backgroundTarget = aggregateBackgroundChildren ?? localBackgroundChildren;
+    const total = explicitTotal ?? commands.length + offset;
+    const getDescriptionForLog = (cmd) => {
+        if (cmd.description)
+            return cmd.description;
+        if (cmd.func)
+            return cmd.func.name || 'builtin-function';
+        if (cmd.run != null)
+            return cmd.run;
+        if (cmd.file)
+            return [cmd.file, ...(cmd.args ?? [])].join(' ');
+        return '';
+    };
+    const registerBackground = (cmd) => (child) => {
+        backgroundTarget.push(child);
+    };
+    for (let index = 0; index < commands.length; index++) {
+        const originalCmd = commands[index];
+        const cmd = applyContextToCommand(originalCmd, context);
+        const cur = offset + index + 1;
+        const all = total;
+        if (!silent) {
+            const suffix = cmd.background ? ' (后台)' : '';
+            console.log(`\n▶ (${cur}/${all}) [${cmd.kind}] ${getDescriptionForLog(cmd)}${suffix}`);
+        }
+        const result = await executeOne(cmd, {
+            streamOutput,
+            registerBackgroundProcess: cmd.background ? registerBackground(cmd) : undefined,
+            commandContext: context,
+        });
+        results.push(result);
+        applyCaptureToContext(originalCmd.captureToVar, result, context);
+        if (!silent) {
+            if (!streamOutput) {
+                if (result.stdout)
+                    console.log(result.stdout);
+                if (result.stderr)
+                    console.error(result.stderr);
+            }
+            if (cmd.background) {
+                console.log(`  已放入后台执行`);
+            }
+            else {
+                console.log(`  退出码: ${result.exitCode}, 耗时: ${result.durationMs}ms`);
+            }
+        }
+        if (!result.success && stopOnError) {
+            if (!silent)
+                console.error(`命令失败，已停止。`);
+            break;
+        }
+    }
+    // 由调用方聚合后台进程时，不在此处置；否则本批次结束后统一收尾
+    if (!aggregateBackgroundChildren && localBackgroundChildren.length > 0) {
+        await finalizeBackgroundProcesses(localBackgroundChildren, waitForBackground, silent);
+    }
+    return results;
+}
+//# sourceMappingURL=runCommand.js.map

package/dist/src/runCommand.js.map

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

package/dist/src/runGroups.d.ts

@@ -0,0 +1,36 @@
+import type { CommandDef, CommandResult, Groups, RunOptions } from './types.js';
+/** 组名 + 执行次数 */
+export interface GroupSpec {
+    name: string;
+    repeat: number;
+}
+/** 根据组配置与组名顺序，得到要执行的命令列表（默认仅包含当前系统支持的命令） */
+export declare function getCommandsToRun(groups: Groups, groupOrder: string[], options?: {
+    ignorePlatform?: boolean;
+}): CommandDef[];
+/**
+ * 根据组配置与「组名:次数」规格，得到要执行的命令列表（默认仅包含当前系统支持的命令）。
+ * 每组按 repeat 重复若干次后再接下一组。
+ */
+export declare function getCommandsToRunWithRepeat(groups: Groups, specs: GroupSpec[], options?: {
+    ignorePlatform?: boolean;
+}): CommandDef[];
+/**
+ * 将组规格展开为「块」数组：每一块为一次组执行（一组命令的一轮），
+ * 用于在块与块之间插入间隔（对重复执行的 group 也生效）。
+ */
+export declare function getGroupChunks(groups: Groups, specs: GroupSpec[], options?: {
+    ignorePlatform?: boolean;
+}): CommandDef[][];
+export interface RunGroupChunksOptions extends RunOptions {
+    /** 每组命令之间的执行间隔（毫秒），0 或无则不间隔 */
+    intervalMs?: number;
+}
+/**
+ * 按块顺序执行：每块内顺序执行命令，块与块之间可选间隔（对重复执行的 group 也生效）。
+ */
+export declare function runGroupChunks(chunks: CommandDef[][], options?: RunGroupChunksOptions): Promise<{
+    results: CommandResult[];
+    failed: boolean;
+}>;
+//# sourceMappingURL=runGroups.d.ts.map

package/dist/src/runGroups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runGroups.d.ts","sourceRoot":"","sources":["../../src/runGroups.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,UAAU,EACV,aAAa,EACb,MAAM,EACN,UAAU,EACX,MAAM,YAAY,CAAC;AAcpB,gBAAgB;AAChB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,UAAU,EAAE,CAMd;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,UAAU,EAAE,CAad;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,UAAU,EAAE,EAAE,CAahB;AAMD,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,UAAU,EAAE,EAAE,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAoExD"}

package/dist/src/runGroups.js

@@ -0,0 +1,123 @@
+import { isSupportedOnCurrentPlatform } from './runCommand.js';
+import { executeAll, finalizeBackgroundProcesses } from './runCommand.js';
+function withSignalHandler(signal, handler) {
+    process.on(signal, handler);
+    return () => process.off(signal, handler);
+}
+/** 根据组配置与组名顺序，得到要执行的命令列表（默认仅包含当前系统支持的命令） */
+export function getCommandsToRun(groups, groupOrder, options = {}) {
+    return getCommandsToRunWithRepeat(groups, groupOrder.map((name) => ({ name, repeat: 1 })), options);
+}
+/**
+ * 根据组配置与「组名:次数」规格，得到要执行的命令列表（默认仅包含当前系统支持的命令）。
+ * 每组按 repeat 重复若干次后再接下一组。
+ */
+export function getCommandsToRunWithRepeat(groups, specs, options = {}) {
+    const { ignorePlatform = false } = options;
+    const list = [];
+    for (const { name, repeat } of specs) {
+        const cmds = groups[name];
+        if (!cmds)
+            continue;
+        const supported = ignorePlatform ? cmds : cmds.filter((c) => isSupportedOnCurrentPlatform(c));
+        const n = Math.max(1, repeat);
+        for (let i = 0; i < n; i++) {
+            list.push(...supported);
+        }
+    }
+    return list;
+}
+/**
+ * 将组规格展开为「块」数组：每一块为一次组执行（一组命令的一轮），
+ * 用于在块与块之间插入间隔（对重复执行的 group 也生效）。
+ */
+export function getGroupChunks(groups, specs, options = {}) {
+    const { ignorePlatform = false } = options;
+    const chunks = [];
+    for (const { name, repeat } of specs) {
+        const cmds = groups[name];
+        if (!cmds)
+            continue;
+        const supported = ignorePlatform ? cmds : cmds.filter((c) => isSupportedOnCurrentPlatform(c));
+        const n = Math.max(1, repeat);
+        for (let i = 0; i < n; i++) {
+            chunks.push([...supported]);
+        }
+    }
+    return chunks;
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/**
+ * 按块顺序执行：每块内顺序执行命令，块与块之间可选间隔（对重复执行的 group 也生效）。
+ */
+export async function runGroupChunks(chunks, options = {}) {
+    const { stopOnError = false, silent = false, intervalMs = 0, waitForBackground = false } = options;
+    const allResults = [];
+    let failed = false;
+    const aggregateBackground = [];
+    let shuttingDown = false;
+    const cleanupHandlers = [];
+    /** 跨 group 块共享，使 captureToVar 与 {{var}} 可在不同组之间传递 */
+    const commandContext = {};
+    const onSignal = (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        // eslint-disable-next-line @typescript-eslint/no-floating-promises
+        (async () => {
+            if (!silent) {
+                console.log(`\n收到 ${signal}，正在清理后台进程...`);
+            }
+            try {
+                await finalizeBackgroundProcesses(aggregateBackground, false, true);
+            }
+            finally {
+                process.exit(130);
+            }
+        })();
+    };
+    cleanupHandlers.push(withSignalHandler('SIGINT', () => onSignal('SIGINT')));
+    cleanupHandlers.push(withSignalHandler('SIGTERM', () => onSignal('SIGTERM')));
+    if (process.platform === 'win32') {
+        cleanupHandlers.push(withSignalHandler('SIGBREAK', () => onSignal('SIGBREAK')));
+    }
+    // 计算全局命令总数，用于跨组显示统一的 cur/all 进度。
+    const totalCommands = chunks.reduce((sum, c) => sum + c.length, 0);
+    let executedCount = 0;
+    try {
+        for (let i = 0; i < chunks.length; i++) {
+            if (i > 0 && intervalMs > 0 && !silent) {
+                console.log(`\n⏱ 等待 ${intervalMs}ms...`);
+                await sleep(intervalMs);
+            }
+            const chunk = chunks[i];
+            if (chunk.length === 0)
+                continue;
+            const results = await executeAll(chunk, {
+                stopOnError,
+                silent,
+                offset: executedCount,
+                total: totalCommands,
+                aggregateBackgroundChildren: aggregateBackground,
+                commandContext,
+            });
+            allResults.push(...results);
+            executedCount += chunk.length;
+            const chunkFailed = results.some((r) => !r.success);
+            if (chunkFailed)
+                failed = true;
+            if (chunkFailed && stopOnError)
+                break;
+        }
+        if (aggregateBackground.length > 0) {
+            await finalizeBackgroundProcesses(aggregateBackground, waitForBackground, silent);
+        }
+    }
+    finally {
+        cleanupHandlers.forEach((dispose) => dispose());
+    }
+    return { results: allResults, failed };
+}
+//# sourceMappingURL=runGroups.js.map

package/dist/src/runGroups.js.map

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

package/dist/src/runners/builtinFunctionRunner.d.ts

@@ -0,0 +1,7 @@
+import type { CommandDef, CommandResult } from '../types.js';
+import type { CommandRunner, RunnerExecuteOptions } from './types.js';
+export declare class BuiltinFunctionCommandRunner implements CommandRunner {
+    canRun(cmd: CommandDef): boolean;
+    execute(cmd: CommandDef, options: RunnerExecuteOptions): Promise<CommandResult>;
+}
+//# sourceMappingURL=builtinFunctionRunner.d.ts.map

package/dist/src/runners/builtinFunctionRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinFunctionRunner.d.ts","sourceRoot":"","sources":["../../../src/runners/builtinFunctionRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEtE,qBAAa,4BAA6B,YAAW,aAAa;IAChE,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAI1B,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;CAgDtF"}

package/dist/src/runners/builtinFunctionRunner.js

@@ -0,0 +1,56 @@
+import { CommandKind } from '../types.js';
+export class BuiltinFunctionCommandRunner {
+    canRun(cmd) {
+        return cmd.kind === CommandKind.BuiltinFunction;
+    }
+    async execute(cmd, options) {
+        if (typeof cmd.func !== 'function') {
+            return {
+                kind: CommandKind.BuiltinFunction,
+                description: cmd.description ?? 'builtin-function',
+                success: false,
+                exitCode: null,
+                stdout: '',
+                stderr: 'builtin-function 命令缺少 func 函数',
+                durationMs: Date.now() - options.start,
+            };
+        }
+        if (cmd.background) {
+            return {
+                kind: CommandKind.BuiltinFunction,
+                description: cmd.description ?? cmd.func.name ?? 'builtin-function',
+                success: false,
+                exitCode: null,
+                stdout: '',
+                stderr: 'builtin-function 暂不支持 background=true',
+                durationMs: Date.now() - options.start,
+            };
+        }
+        try {
+            const status = await cmd.func(options.commandContext);
+            const success = status !== false;
+            return {
+                kind: CommandKind.BuiltinFunction,
+                description: cmd.description ?? cmd.func.name ?? 'builtin-function',
+                success,
+                exitCode: success ? 0 : 1,
+                stdout: '',
+                stderr: success ? '' : 'builtin-function 返回 false',
+                durationMs: Date.now() - options.start,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                kind: CommandKind.BuiltinFunction,
+                description: cmd.description ?? cmd.func.name ?? 'builtin-function',
+                success: false,
+                exitCode: null,
+                stdout: '',
+                stderr: message,
+                durationMs: Date.now() - options.start,
+            };
+        }
+    }
+}
+//# sourceMappingURL=builtinFunctionRunner.js.map

package/dist/src/runners/builtinFunctionRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinFunctionRunner.js","sourceRoot":"","sources":["../../../src/runners/builtinFunctionRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,OAAO,4BAA4B;IACvC,MAAM,CAAC,GAAe;QACpB,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,eAAe,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAe,EAAE,OAA6B;QAC1D,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACnC,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,eAAe;gBACjC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,kBAAkB;gBAClD,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,+BAA+B;gBACvC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK;aACvC,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,eAAe;gBACjC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,kBAAkB;gBACnE,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,uCAAuC;gBAC/C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK;aACvC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC;YACjC,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,eAAe;gBACjC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,kBAAkB;gBACnE,OAAO;gBACP,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B;gBAClD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK;aACvC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,eAAe;gBACjC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,kBAAkB;gBACnE,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK;aACvC,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/src/runners/embedRunner.d.ts

@@ -0,0 +1,7 @@
+import type { CommandDef, CommandResult } from '../types.js';
+import type { CommandRunner, RunnerExecuteOptions } from './types.js';
+export declare class EmbedCommandRunner implements CommandRunner {
+    canRun(cmd: CommandDef): boolean;
+    execute(cmd: CommandDef, options: RunnerExecuteOptions): Promise<CommandResult>;
+}
+//# sourceMappingURL=embedRunner.d.ts.map

package/dist/src/runners/embedRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedRunner.d.ts","sourceRoot":"","sources":["../../../src/runners/embedRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA6GtE,qBAAa,kBAAmB,YAAW,aAAa;IACtD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAI1B,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;CAetF"}