snapshot-checker 0.2.2 → 0.4.0

package/dist/src/runners/builtinFunctionRunner.js

@@ -1,4 +1,5 @@
-import { CommandKind } from "../types.js";
+import { CommandKind, unsupportedBackgroundCommandResult } from "../types.js";
+/** `CommandKind.BuiltinFunction`：调用 `CommandDef.func` */
 export class BuiltinFunctionCommandRunner {
     canRun(cmd) {
         return cmd.kind === CommandKind.BuiltinFunction;
@@ -15,17 +16,9 @@ export class BuiltinFunctionCommandRunner {
                 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,
-            };
-        }
+        const bgErr = unsupportedBackgroundCommandResult(cmd, options.start);
+        if (bgErr)
+            return bgErr;
         try {
             const status = await cmd.func(options.commandContext);
             const success = status !== false;

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

@@ -1 +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,CACX,GAAe,EACf,OAA6B;QAE7B,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"}
+{"version":3,"file":"builtinFunctionRunner.js","sourceRoot":"","sources":["../../../src/runners/builtinFunctionRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kCAAkC,EAAE,MAAM,aAAa,CAAC;AAI9E,yDAAyD;AACzD,MAAM,OAAO,4BAA4B;IACvC,MAAM,CAAC,GAAe;QACpB,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,eAAe,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CACX,GAAe,EACf,OAA6B;QAE7B,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,MAAM,KAAK,GAAG,kCAAkC,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,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

@@ -1,5 +1,6 @@
 import type { CommandDef, CommandResult } from "../types.js";
 import type { CommandRunner, RunnerExecuteOptions } from "./types.js";
+/** `CommandKind.Embed`：`sleep`、`timeout`/`timieout` */
 export declare class EmbedCommandRunner implements CommandRunner {
     canRun(cmd: CommandDef): boolean;
     execute(cmd: CommandDef, options: RunnerExecuteOptions): Promise<CommandResult>;

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

@@ -1 +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;AAqHtE,qBAAa,kBAAmB,YAAW,aAAa;IACtD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAI1B,OAAO,CACX,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;CAmB1B"}
+{"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;AAqHtE,uDAAuD;AACvD,qBAAa,kBAAmB,YAAW,aAAa;IACtD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAI1B,OAAO,CACX,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;CAqB1B"}

package/dist/src/runners/embedRunner.js

@@ -1,4 +1,4 @@
-import { CommandKind } from "../types.js";
+import { CommandKind, unsupportedBackgroundCommandResult } from "../types.js";
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -106,11 +106,15 @@ function runEmbedTimeout(cmd, start, streamOutput) {
         }
     });
 }
+/** `CommandKind.Embed`：`sleep`、`timeout`/`timieout` */
 export class EmbedCommandRunner {
     canRun(cmd) {
         return cmd.kind === CommandKind.Embed;
     }
     async execute(cmd, options) {
+        const bgErr = unsupportedBackgroundCommandResult(cmd, options.start);
+        if (bgErr)
+            return bgErr;
         const sleepResult = runEmbedSleep(cmd, options.start);
         if (sleepResult)
             return sleepResult;

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

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

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

@@ -1,5 +1,6 @@
 import type { CommandDef, CommandResult } from "../types.js";
 import type { CommandRunner, RunnerExecuteOptions } from "./types.js";
+/** `linux`/`mac`/`windows`：子进程执行 `run` 或 `file`+`args` */
 export declare class ShellCommandRunner implements CommandRunner {
     private readonly kinds;
     canRun(cmd: CommandDef): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"shellRunner.d.ts","sourceRoot":"","sources":["../../../src/runners/shellRunner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAsCtE,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAInB;IAEH,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAIhC,OAAO,CACL,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;CA2G1B"}
+{"version":3,"file":"shellRunner.d.ts","sourceRoot":"","sources":["../../../src/runners/shellRunner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAsCtE,0DAA0D;AAC1D,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAInB;IAEH,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAIhC,OAAO,CACL,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;CA4I1B"}

package/dist/src/runners/shellRunner.js

@@ -24,10 +24,11 @@ function normalizeCommandForSpawn(cmd) {
     }
     const file = cmd.file;
     if (!file)
-        throw new Error("CommandDef 必须提供 run 或 file");
+        throw new Error("CommandDef 需提供 `run` 或 `file`");
     const args = cmd.args ?? [];
     return { command: file, args, displayText: [file, ...args].join(" ") };
 }
+/** `linux`/`mac`/`windows`：子进程执行 `run` 或 `file`+`args` */
 export class ShellCommandRunner {
     kinds = new Set([
         CommandKind.Linux,
@@ -42,16 +43,47 @@ export class ShellCommandRunner {
         const cwd = cmd.cwd ?? process.cwd();
         const shouldCaptureOutput = Boolean(cmd.captureToVar);
         if (cmd.background && options.registerBackgroundProcess) {
-            const child = spawn(command, args, {
+            const delayMs = Math.max(0, cmd.backgroundDelayMs ?? 0);
+            const stdio = [
+                "ignore",
+                options.streamOutput ? "inherit" : "ignore",
+                options.streamOutput ? "inherit" : "ignore",
+            ];
+            const spawnBg = () => spawn(command, args, {
                 cwd,
                 shell: false,
-                stdio: [
-                    "ignore",
-                    options.streamOutput ? "inherit" : "ignore",
-                    options.streamOutput ? "inherit" : "ignore",
-                ],
+                stdio,
             });
-            options.registerBackgroundProcess(child);
+            if (delayMs === 0) {
+                const child = spawnBg();
+                options.registerBackgroundProcess(child);
+            }
+            else {
+                if (!options.registerPendingBackgroundSpawn) {
+                    return Promise.resolve({
+                        kind: cmd.kind,
+                        description: cmd.description,
+                        success: false,
+                        exitCode: null,
+                        stdout: "",
+                        stderr: "backgroundDelayMs>0 时需要由 executeAll/executeOne 注入 registerPendingBackgroundSpawn",
+                        durationMs: Date.now() - options.start,
+                    });
+                }
+                const done = new Promise((resolve, reject) => {
+                    setTimeout(() => {
+                        try {
+                            const child = spawnBg();
+                            options.registerBackgroundProcess(child);
+                            resolve();
+                        }
+                        catch (err) {
+                            reject(err instanceof Error ? err : new Error(String(err)));
+                        }
+                    }, delayMs);
+                });
+                options.registerPendingBackgroundSpawn(done);
+            }
             return Promise.resolve({
                 kind: cmd.kind,
                 description: cmd.description,

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

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

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

@@ -1,11 +1,20 @@
 import type { ChildProcess } from "node:child_process";
 import type { CommandContext, CommandDef, CommandResult } from "../types.js";
+/** `CommandRunner.execute` 入参 */
 export interface RunnerExecuteOptions {
     streamOutput: boolean;
     registerBackgroundProcess?: (child: ChildProcess) => void;
+    /**
+     * 后台命令在延时计时器之后才 spawn 时调用，传入的 Promise 在子进程已登记进
+     * `registerBackgroundProcess` 后落地；{@link executeAll} 在收尾前会 `await` 这些 Promise，
+     * 避免尚未 spawn 就收掉后台列表。
+     */
+    registerPendingBackgroundSpawn?: (done: Promise<void>) => void;
     commandContext: CommandContext;
+    /** `executeOne` 起始时间戳（毫秒） */
     start: number;
 }
+/** 与 {@link CommandKind} 子集对应的执行策略 */
 export interface CommandRunner {
     canRun(cmd: CommandDef): boolean;
     execute(cmd: CommandDef, options: RunnerExecuteOptions): Promise<CommandResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runners/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1D,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;IACjC,OAAO,CACL,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runners/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7E,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1D;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC/D,cAAc,EAAE,cAAc,CAAC;IAC/B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;IACjC,OAAO,CACL,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B"}

package/dist/src/types.d.ts

@@ -1,10 +1,6 @@
 /**
- * 命令类型枚举：与系统平台或内置行为关联
- * - linux: 仅在 Linux 下执行
- * - mac: 仅在 macOS 下执行
- * - windows: 仅在 Windows 下执行
- * - embed: 内置命令（如 sleep），由执行器内部实现，全平台可用
- * - builtin-function: 内置函数命令（JS/TS 函数），由执行器直接调用，全平台可用
+ * 命令执行通道类别。
+ * `linux` / `mac` / `windows`：对应平台 Shell；`embed` / `builtin-function`：进程内执行，各平台可用。
  */
 export declare enum CommandKind {
     Linux = "linux",
@@ -13,95 +9,70 @@ export declare enum CommandKind {
     Embed = "embed",
     BuiltinFunction = "builtin-function"
 }
-/**
- * 根据当前系统类型返回对应的命令类型枚举
- */
+/** 将 `os.platform()` 映射为与当前主机匹配的 {@link CommandKind}（非 win32/darwin 归类为 `linux`）。 */
 export declare function getCurrentPlatformKind(): CommandKind;
-/**
- * 单条命令定义
- */
+/** 单条可调度命令的描述 */
 export interface CommandDef {
-    /** 命令类型 */
+    /** 选用的执行通道 */
     kind: CommandKind;
-    /** 命令描述（可选，用于日志） */
+    /** 日志与展示用摘要 */
     description?: string;
-    /** 要执行的命令或脚本内容（优先级高于 file+args） */
+    /** Shell 内联脚本；与 `file` 二选一，优先于 `file`+`args` */
     run?: string;
-    /** 可执行文件路径（当未提供 run 时生效） */
+    /** 可执行文件路径；在缺少 `run` 时使用 */
     file?: string;
     /**
-     * 内置函数（kind 为 builtin-function 时生效）
-     * - 返回 true / false 时：分别表示成功 / 失败（等价退出码 0 / 1）
-     * - 返回 void 时：视为成功
+     * `builtin-function` 时调用；返回 `false` 记为失败，其余为成功（`void` 同成功）。
      */
     func?: (context: CommandContext) => boolean | void | Promise<boolean | void>;
-    /** 传给 file 的参数数组（当未提供 run 时生效） */
+    /** `file` 模式下的参数列表 */
     args?: string[];
-    /** 可选：工作目录，不填则使用当前目录 */
+    /** 工作目录；缺省为进程当前目录 */
     cwd?: string;
-    /** 为 true 时在后台运行，执行器不等待其结束即继续下一条；默认全部前台命令结束后会优雅结束后台进程；传 CLI --wait 则改为等到后台进程全部退出后再退出 */
+    /**
+     * 后台执行：不阻塞后续命令；前台结束后依 `waitForBackground` 或 CLI `--wait` 回收。
+     * 在 `executeAll`/`executeOne` 的 `streamOutput` 为 `true` 时（与默认非静默一致），本子进程 stdout/stderr
+     * 继承当前终端，可与仍在运行的并行前台子进程写入同一控制台，从而在时间上交错显示输出。
+     * 使用 `--silent`/静默时请见 `backgroundDelayMs` 说明。
+     */
     background?: boolean;
     /**
-     * 可选：将本条命令的输出写入上下文变量，供后续命令使用。
+     * `background: true` 时：延迟多少毫秒后再启动子进程（不阻塞队列中后续命令）。
+     * 缺省或未设视为 0，与同批其它后台命令一样尽快 spawn。
+     *
+     * 延后启动的后台命令与随后开始的前台长时间任务若均开启流式输出，则二者的终端输出通常会在同一控制台交错出现；
+     * 若为静默（`silent`/`streamOutput: false`），后台子进程标准流将被忽略，无法在采集中穿插看到其输出。
      */
+    backgroundDelayMs?: number;
+    /** 将输出写入 `CommandContext`，供后续模板或内置函数使用 */
     captureToVar?: CaptureToVarDef;
 }
 /**
- * 命令执行上下文：用于在同一批次命令之间传递的变量。
- * key 为变量名（仅建议使用字母/数字/下划线），value 可为任意类型。
- * - 在 builtin-function 中请通过 get / set 读写。
- * - 在命令模板 {{var}} 替换场景中，仅允许 string 类型参与替换。
+ * 同批次命令间共享的键值存储；`{{name}}` 替换仅接受 `string` 值。
  */
 export interface CommandContext {
-    /**
-     * 读取上下文中的变量：
-     * - 不存在时返回 undefined
-     * - 调用方通过泛型参数标注期望类型：const pid = ctx.get<number>('pid')
-     */
     get<T = unknown>(key: string): T | undefined;
-    /**
-     * 读取变量并提供默认值：
-     * - 不存在（或值为 undefined）时返回 defaultValue
-     */
+    /** 键不存在或值为 `undefined` 时返回 `defaultValue` */
     get<T = unknown>(key: string, defaultValue: T): T;
     set(key: string, value: unknown): void;
-    /** 是否包含该 key（与 get 返回 undefined 区分：可能显式存了 undefined） */
+    /** 键是否已定义（含显式写入的 `undefined`） */
     has(key: string): boolean;
 }
-/** 创建空的命令上下文实例 */
+/** 构造空 {@link CommandContext} */
 export declare function createCommandContext(): CommandContext;
 /**
- * 命令输出到上下文变量的映射规则。
- *
- * 使用方式示例：
- * - 将整段 stdout 写入变量：
- *   { captureToVar: { name: 'foo' } }
- * - 用正则从 stdout 中抽取一部分：
- *   { captureToVar: { name: 'pid', pattern: '^(\\d+)', groupIndex: 1 } }
+ * 将命令输出映射到上下文变量。
+ * 无 `pattern` 时使用去空白后的全文；有 `pattern` 时默认取捕获组 `groupIndex`（默认 `1`）。
  */
 export interface CaptureToVarDef {
-    /** 变量名 */
     name: string;
-    /**
-     * 从哪一个输出源读取：
-     * - stdout：标准输出（默认）
-     * - stderr：标准错误输出
-     */
+    /** 截取来源；默认 `stdout` */
     from?: "stdout" | "stderr";
-    /**
-     * 可选：用于从输出中提取变量值的正则表达式。
-     * - 若未提供，则使用整个输出（去除首尾空白）作为变量值。
-     * - 若提供，则默认使用第 1 个捕获组（groupIndex 默认为 1）。
-     */
     pattern?: string;
-    /**
-     * 指定要取的捕获组下标，默认 1。
-     */
+    /** `pattern` 的捕获组下标；默认 `1` */
     groupIndex?: number;
 }
-/**
- * 命令执行结果
- */
+/** 单条命令执行产物 */
 export interface CommandResult {
     kind: CommandKind;
     description?: string;
@@ -111,31 +82,30 @@ export interface CommandResult {
     stderr: string;
     durationMs: number;
 }
+/** 仅 `linux` / `mac` / `windows` 的 Shell 子进程可调后台执行 */
+export declare function commandKindSupportsBackground(kind: CommandKind): boolean;
 /**
- * 命令组：组名 -> 该组下的命令列表
+ * 是否显式配置了与后台相关的选项：`background:true`，或正的 `backgroundDelayMs`。
  */
-export type Groups = Record<string, CommandDef[]>;
+export declare function commandRequestsBackgroundOptions(cmd: CommandDef): boolean;
 /**
- * 执行配置
+ * 不支持后台的 {@link CommandKind} 却在配置中带了 `background` / `backgroundDelayMs` 时的错误产物。
  */
+export declare function unsupportedBackgroundCommandResult(cmd: CommandDef, startMs: number): CommandResult | null;
+/** 命名组到命令序列的映射 */
+export type Groups = Record<string, CommandDef[]>;
+/** {@link runGroupChunks} 与 CLI 的执行开关 */
 export interface RunOptions {
-    /** 是否在单条命令失败时停止后续命令 */
     stopOnError?: boolean;
-    /** 是否静默（少输出） */
+    /** 与 `ExecuteAllOptions.silent` 一致（参见 `runCommand` 模块） */
     silent?: boolean;
-    /**
-     * 为 true 时：所有前台命令执行完后仍等待后台进程自然退出，再结束 CLI。
-     * 默认 false：前台全部结束后优雅终止后台进程并退出。
-     */
+    /** 全部前台结束后是否阻塞至后台子进程退出；否则发送终止 */
     waitForBackground?: boolean;
-    /**
-     * 为 true 时忽略命令 kind 与当前系统的匹配关系，直接尝试执行全部命令。
-     * 该模式存在较高风险（例如在非目标平台执行失败），建议仅在明确知晓后果时使用。
-     */
+    /** 忽略 `CommandKind` 与宿主 OS 是否一致 */
     ignorePlatform?: boolean;
-    /** 指定要执行的组名列表，按顺序执行；未指定时执行当前系统支持的所有命令 */
+    /** 组名过滤；语义由调用方约定 */
     groups?: string[];
-    /** 每组命令之间的执行间隔（毫秒），默认无间隔；对重复执行的 group 也生效（每次重复后间隔） */
+    /** 相邻命令块之间的间隔（毫秒）；对 `repeat` 产生的多块同样生效 */
     intervalMs?: number;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,eAAe,qBAAqB;CACrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,CAcpD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC7E,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7C;;;OAGG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAwBD,kBAAkB;AAClB,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/types.js

@@ -1,11 +1,7 @@
 import { platform } from "node:os";
 /**
- * 命令类型枚举：与系统平台或内置行为关联
- * - linux: 仅在 Linux 下执行
- * - mac: 仅在 macOS 下执行
- * - windows: 仅在 Windows 下执行
- * - embed: 内置命令（如 sleep），由执行器内部实现，全平台可用
- * - builtin-function: 内置函数命令（JS/TS 函数），由执行器直接调用，全平台可用
+ * 命令执行通道类别。
+ * `linux` / `mac` / `windows`：对应平台 Shell；`embed` / `builtin-function`：进程内执行，各平台可用。
  */
 export var CommandKind;
 (function (CommandKind) {
@@ -15,9 +11,7 @@ export var CommandKind;
     CommandKind["Embed"] = "embed";
     CommandKind["BuiltinFunction"] = "builtin-function";
 })(CommandKind || (CommandKind = {}));
-/**
- * 根据当前系统类型返回对应的命令类型枚举
- */
+/** 将 `os.platform()` 映射为与当前主机匹配的 {@link CommandKind}（非 win32/darwin 归类为 `linux`）。 */
 export function getCurrentPlatformKind() {
     const p = platform();
     if (p === "win32")
@@ -49,8 +43,41 @@ class CommandContextStore {
         return Object.prototype.hasOwnProperty.call(this.data, key);
     }
 }
-/** 创建空的命令上下文实例 */
+/** 构造空 {@link CommandContext} */
 export function createCommandContext() {
     return new CommandContextStore();
 }
+/** 仅 `linux` / `mac` / `windows` 的 Shell 子进程可调后台执行 */
+export function commandKindSupportsBackground(kind) {
+    return (kind === CommandKind.Linux ||
+        kind === CommandKind.Mac ||
+        kind === CommandKind.Windows);
+}
+/**
+ * 是否显式配置了与后台相关的选项：`background:true`，或正的 `backgroundDelayMs`。
+ */
+export function commandRequestsBackgroundOptions(cmd) {
+    if (cmd.background === true)
+        return true;
+    const d = cmd.backgroundDelayMs;
+    return typeof d === "number" && d > 0;
+}
+/**
+ * 不支持后台的 {@link CommandKind} 却在配置中带了 `background` / `backgroundDelayMs` 时的错误产物。
+ */
+export function unsupportedBackgroundCommandResult(cmd, startMs) {
+    if (!commandRequestsBackgroundOptions(cmd))
+        return null;
+    if (commandKindSupportsBackground(cmd.kind))
+        return null;
+    return {
+        kind: cmd.kind,
+        description: cmd.description,
+        success: false,
+        exitCode: null,
+        stdout: "",
+        stderr: `kind「${cmd.kind}」不支持后台执行，请勿设置 background 或 backgroundDelayMs`,
+        durationMs: Date.now() - startMs,
+    };
+}
 //# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,0BAAW,CAAA;IACX,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,mDAAoC,CAAA;AACtC,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC,OAAO,CAAC;IAC9C,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC;IAC3C,IACE,CAAC,KAAK,OAAO;QACb,CAAC,KAAK,KAAK;QACX,CAAC,KAAK,SAAS;QACf,CAAC,KAAK,SAAS;QACf,CAAC,KAAK,OAAO,EACb,CAAC;QACD,OAAO,WAAW,CAAC,KAAK,CAAC;IAC3B,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC;AAC3B,CAAC;AAuDD,MAAM,mBAAmB;IACN,IAAI,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAIrE,GAAG,CAAc,GAAW,EAAE,YAAgB;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAc;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,kBAAkB;AAClB,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,mBAAmB,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,0BAAW,CAAA;IACX,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,mDAAoC,CAAA;AACtC,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,qFAAqF;AACrF,MAAM,UAAU,sBAAsB;IACpC,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC,OAAO,CAAC;IAC9C,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC;IAC3C,IACE,CAAC,KAAK,OAAO;QACb,CAAC,KAAK,KAAK;QACX,CAAC,KAAK,SAAS;QACf,CAAC,KAAK,SAAS;QACf,CAAC,KAAK,OAAO,EACb,CAAC;QACD,OAAO,WAAW,CAAC,KAAK,CAAC;IAC3B,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC;AAC3B,CAAC;AAmDD,MAAM,mBAAmB;IACN,IAAI,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAIrE,GAAG,CAAc,GAAW,EAAE,YAAgB;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAc;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,iCAAiC;AACjC,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,mBAAmB,EAAE,CAAC;AACnC,CAAC;AA0BD,sDAAsD;AACtD,MAAM,UAAU,6BAA6B,CAAC,IAAiB;IAC7D,OAAO,CACL,IAAI,KAAK,WAAW,CAAC,KAAK;QAC1B,IAAI,KAAK,WAAW,CAAC,GAAG;QACxB,IAAI,KAAK,WAAW,CAAC,OAAO,CAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAAC,GAAe;IAC9D,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,GAAG,CAAC,iBAAiB,CAAC;IAChC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC,CAChD,GAAe,EACf,OAAe;IAEf,IAAI,CAAC,gCAAgC,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,6BAA6B,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,QAAQ,GAAG,CAAC,IAAI,8CAA8C;QACtE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KACjC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snapshot-checker",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "CLI 工具：按顺序执行 bat / mac / shell 命令",
   "type": "module",
   "main": "dist/src/index.js",
@@ -15,6 +15,11 @@
       "types": "./dist/commands/*.d.ts",
       "import": "./dist/commands/*.js",
       "default": "./dist/commands/*.js"
+    },
+    "./demos/*": {
+      "types": "./dist/demos/*.d.ts",
+      "import": "./dist/demos/*.js",
+      "default": "./dist/demos/*.js"
     }
   },
   "files": [
@@ -27,7 +32,7 @@
   },
   "scripts": {
     "clean": "rimraf dist",
-    "build": "tsc",
+    "build": "rimraf dist && tsc",
     "test": "tsx --test tests/**/*.test.ts",
     "prepublishOnly": "npm run build",
     "start": "node dist/src/cli.js",
@@ -49,7 +54,9 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "hiperf_txt_parser": "^1.1.0"
+    "consola": "^3.4.2",
+    "hiperf_txt_parser": "^1.2.5",
+    "hmtrace-parser": "^0.3.0"
   },
   "engines": {
     "node": ">=18"

package/dist/commands/context_demo.d.ts

@@ -1,18 +0,0 @@
-import { type Groups } from "../src/types.js";
-/**
- * 示例场景：演示如何在命令之间传递变量（含跨不同 group）。
- *
- * 使用方式（开发态）：
- *   npm run dev -- context_demo
- *
- * 使用方式（构建后）：
- *   node dist/cli.js context_demo
- *
- * 作为 npm 包被外部项目引用时：
- *   import { resolveScenario, runScenarioGroups } from 'snapshot-checker';
- *   import * as contextDemo from 'snapshot-checker/commands/context_demo';
- * 完整示例见 demos/consumer-app（需先发布包并 npm install snapshot-checker）。
- */
-export declare const groups: Groups;
-export declare const defaultGroupOrder: string[];
-//# sourceMappingURL=context_demo.d.ts.map

package/dist/commands/context_demo.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context_demo.d.ts","sourceRoot":"","sources":["../../commands/context_demo.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACZ,MAAM,iBAAiB,CAAC;AAMzB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,EAAE,MA8CpB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAKrC,CAAC"}

package/dist/commands/context_demo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context_demo.js","sourceRoot":"","sources":["../../commands/context_demo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,sBAAsB,GAGvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,oCAAoC;AACpC,MAAM,IAAI,GAAG,sBAAsB,EAAE,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,OAAO,EAAE;QACP;YACE,IAAI;YACJ,WAAW,EAAE,oBAAoB;YACjC,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE;gBACZ,IAAI,EAAE,MAAM;aACb;SACF;KACF;IACD,KAAK,EAAE;QACL;YACE,IAAI;YACJ,WAAW,EAAE,eAAe;YAC5B,GAAG,EAAE,wBAAwB;SAC9B;KACF;IACD,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW,CAAC,eAAe;YACjC,WAAW,EAAE,sBAAsB;YACnC,IAAI,EAAE,CAAC,GAAmB,EAAE,EAAE;gBAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAS,MAAM,CAAC,IAAI,SAAS,CAAC;gBAClD,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;gBAChD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,CAAC;SACF;QACD;YACE,IAAI;YACJ,WAAW,EAAE,aAAa;YAC1B,GAAG,EAAE,qCAAqC;SAC3C;KACF;IACD,WAAW,EAAE;QACX;YACE,IAAI,EAAE,WAAW,CAAC,eAAe;YACjC,WAAW,EAAE,uCAAuC;YACpD,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK;SAClB;QACD;YACE,IAAI;YACJ,WAAW,EAAE,6BAA6B;YAC1C,GAAG,EAAE,qDAAqD;SAC3D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAa;IACzC,SAAS;IACT,OAAO;IACP,WAAW;IACX,aAAa;CACd,CAAC"}

package/dist/commands/mac-example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mac-example.d.ts","sourceRoot":"","sources":["../../commands/mac-example.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAQpB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAAoB,CAAC;AAE3D,eAAO,MAAM,OAAO;;;GAEnB,CAAC;AAEF,UAAU,iBAAiB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAuBlD"}

package/dist/commands/mac-example.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mac-example.js","sourceRoot":"","sources":["../../commands/mac-example.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,WAAW,CAAC,GAAG;YACrB,WAAW,EAAE,oBAAoB;YACjC,GAAG,EAAE,UAAU;SAChB;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE;CACxD,CAAC;AAMF,MAAM,UAAU,YAAY,CAAC,GAI5B;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAE3C,MAAM,QAAQ,GACZ,GAAG,KAAK,EAAE;QACR,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,WAAW,CAAC,GAAG;gBACrB,WAAW,EAAE,yBAAyB;gBACtC,GAAG,EAAE,QAAQ,GAAG,EAAE;aACnB;SACF,CAAC;IAER,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/D,OAAO;QACL,MAAM,EAAE;YACN,GAAG,UAAU;YACb,GAAG,EAAE,QAAQ;SACd;QACD,iBAAiB,EAAE,KAAK;KACzB,CAAC;AACJ,CAAC"}

package/dist/commands/timeout_demo.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"timeout_demo.d.ts","sourceRoot":"","sources":["../../commands/timeout_demo.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,iBAAiB,CAAC;AAmBzB,eAAO,MAAM,MAAM,EAAE,MA4BpB,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAAsB,CAAC"}