@ac-kit/cmd-docker 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,57 +1,36 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to
-[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Changed
-
-- Adds `rm`, `network`, `addHost`, and `volume` options to `dockerContainerRun`
-
-### Added
-
-- `dockerContainerExec` mimics `docker exec` command to execute a command in a
-  running container.
-- `dockerContainerStop` mimics `docker stop` command to stop a running
-  container.
-- `dockerNetworkCreate` mimics `docker network create` command to create a new
-  network.
-- `dockerNetworkRemove` mimics `docker network rm` command to remove a network.
-
-## [0.1.5] - 2026-08-08
-
-### Changed
-
-- Upgrade `@ac-essentials/util` dependency to `^0.7.0`.
-
-## [0.1.4] - 2026-03-01
-
-### Changed
-
-- Upgrade `@ac-essentials/util` dependency to `^0.6.0`.
-
-## [0.1.3] - 2025-09-20
-
-### Fixed
-
-- Fix unchecked indexed access.
-
-### Changed
-
-- Bump `type-fest` dependency to `^5.0.1`.
-
-## [0.1.2] - 2025-09-20
-
-### Fixed
-
-- Fixed dependencies binding in `package.json`.
-
-## [0.1.1] - 2025-09-13
+## 0.2.0
+
+### Minor Changes
+
+- a493b4a: Every command accepts a `context`, and the invocation is assembled in one place.
+  
+  - `DockerCommonOptions` adds `context` to all ten commands, emitted as
+    `docker --context <name> <subcommand>`. Naming the context per command leaves
+    the daemon the rest of the machine talks to alone, which `dockerContextUse`
+    does not. `dockerNetworkRm` and `dockerContextShow` gain an options parameter
+    to carry it.
+  - The new internal `execDocker` owns where the CLI's global flags go — before
+    the subcommand, which is the only position docker accepts them in — so no
+    command interpolates its own string any more. Every command now asks
+    `execAsync` for `utf8`; `dockerContainerRun` and the others that did not used
+    to would have returned a `Buffer` had they read their output.
+  - `DockerImageId` is exported, alongside `DockerContainerId` and
+    `DockerContainerName`.
+
+### Patch Changes
+
+- 732a70b: Fix dockerContextShow() function
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [70c1269]
+  - @ac-kit/node@0.2.0
+  - @ac-kit/format-shell@0.2.0
+
+## [0.1.0] - 2026-09-01
 
 ### Added
 
-- Added `sideEffects: false` to package.json for better tree-shaking.
+- Initial release.

package/dist/_docker-command.d.ts

@@ -0,0 +1,14 @@
+import type { DockerCommonOptions } from "./types.js";
+/** Quote one value for the shell `execDocker` hands the command line to. */
+export declare function dockerArg(value: string): string;
+/**
+ * Run a docker subcommand.
+ *
+ * The CLI only accepts its global flags before the subcommand, so this is the
+ * one place that knows where they go.
+ */
+export declare function execDocker(subcommand: string, args: readonly string[], options?: DockerCommonOptions): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+//# sourceMappingURL=_docker-command.d.ts.map

package/dist/_docker-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_docker-command.d.ts","sourceRoot":"","sources":["../src/_docker-command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAU7C"}

package/dist/_docker-command.js

@@ -0,0 +1,23 @@
+import { platform } from "node:process";
+import { escapeCommandArg, shellDialectForPlatform, } from "@ac-kit/format-shell";
+import { execAsync } from "@ac-kit/node";
+const SHELL_DIALECT_ = shellDialectForPlatform(platform);
+/** Quote one value for the shell `execDocker` hands the command line to. */
+export function dockerArg(value) {
+    return escapeCommandArg(value, SHELL_DIALECT_);
+}
+/**
+ * Run a docker subcommand.
+ *
+ * The CLI only accepts its global flags before the subcommand, so this is the
+ * one place that knows where they go.
+ */
+export async function execDocker(subcommand, args, options) {
+    const words = ["docker"];
+    if (options?.context !== undefined && options.context.length > 0) {
+        words.push("--context", dockerArg(options.context));
+    }
+    words.push(subcommand, ...args);
+    return execAsync(words.join(" "), { encoding: "utf8" });
+}
+//# sourceMappingURL=_docker-command.js.map

package/dist/_docker-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_docker-command.js","sourceRoot":"","sources":["../src/_docker-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EACN,gBAAgB,EAChB,uBAAuB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,MAAM,cAAc,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAEzD,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,KAAa;IACtC,OAAO,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,UAAkB,EAClB,IAAuB,EACvB,OAA6B;IAE7B,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEzB,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAEhC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/buildx/buildx-build.d.ts

@@ -1,5 +1,6 @@
 import type { Url } from "node:url";
-export type DockerBuildxBuildOptions = {
+import type { DockerCommonOptions } from "../types.js";
+export type DockerBuildxBuildOptions = DockerCommonOptions & {
     tags?: string[];
 };
 export declare function dockerBuildxBuild(pathOrUrl: string | Url, options?: DockerBuildxBuildOptions): Promise<void>;

package/dist/buildx/buildx-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildx-build.d.ts","sourceRoot":"","sources":["../../src/buildx/buildx-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAsB,iBAAiB,CACtC,SAAS,EAAE,MAAM,GAAG,GAAG,EACvB,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAWf"}
+{"version":3,"file":"buildx-build.d.ts","sourceRoot":"","sources":["../../src/buildx/buildx-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAGpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG;IAC5D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAsB,iBAAiB,CACtC,SAAS,EAAE,MAAM,GAAG,GAAG,EACvB,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/buildx/buildx-build.js

@@ -1,11 +1,11 @@
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
+import { dockerArg, execDocker } from "../_docker-command.js";
 export async function dockerBuildxBuild(pathOrUrl, options) {
     const execArgs = [];
     for (const tag of options?.tags ?? []) {
-        execArgs.push(`--tag ${escapeCommandArg(tag)}`);
+        execArgs.push(`--tag ${dockerArg(tag)}`);
     }
     // oxlint-disable-next-line typescript/no-base-to-string
-    execArgs.push(escapeCommandArg(pathOrUrl.toString()));
-    await execAsync(`docker buildx build ${execArgs.join(" ")}`);
+    execArgs.push(dockerArg(pathOrUrl.toString()));
+    await execDocker("buildx build", execArgs, options);
 }
 //# sourceMappingURL=buildx-build.js.map

package/dist/buildx/buildx-build.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildx-build.js","sourceRoot":"","sources":["../../src/buildx/buildx-build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,SAAuB,EACvB,OAAkC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEtD,MAAM,SAAS,CAAC,uBAAuB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"buildx-build.js","sourceRoot":"","sources":["../../src/buildx/buildx-build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAO9D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,SAAuB,EACvB,OAAkC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAE/C,MAAM,UAAU,CAAC,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/container/container-exec.d.ts

@@ -1,10 +1,12 @@
-import type { DockerContainerId, DockerContainerName } from "../types.js";
-export type DockerContainerExecOptions = {
-    env?: Record<string, string | number | bigint | boolean | null>;
+import { EnvVariables } from "@ac-kit/format-shell";
+import type { DockerCommonOptions, DockerContainerId, DockerContainerName } from "../types.js";
+export type DockerContainerExecOptions = DockerCommonOptions & {
+    commandArgs?: string[];
+    env?: EnvVariables;
     user?: string;
     workdir?: string;
 };
-export declare function dockerContainerExec(container: DockerContainerId | DockerContainerName, command: string, commandArgs?: string[], options?: DockerContainerExecOptions): Promise<{
+export declare function dockerContainerExec(container: DockerContainerId | DockerContainerName, command: string, options?: DockerContainerExecOptions): Promise<{
     stdout: string;
     stderr: string;
 }>;

package/dist/container/container-exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-exec.d.ts","sourceRoot":"","sources":["../../src/container/container-exec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,SAAS,EAAE,iBAAiB,GAAG,mBAAmB,EAClD,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B7C"}
+{"version":3,"file":"container-exec.d.ts","sourceRoot":"","sources":["../../src/container/container-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,sBAAsB,CAAC;AAGxE,OAAO,KAAK,EACX,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG;IAC9D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,SAAS,EAAE,iBAAiB,GAAG,mBAAmB,EAClD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB7C"}

package/dist/container/container-exec.js

@@ -1,22 +1,21 @@
-import { stringifyEnvVariable } from "@ac-kit/core";
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
-export async function dockerContainerExec(container, command, commandArgs, options) {
+import { printEnvAssignment } from "@ac-kit/format-shell";
+import { dockerArg, execDocker } from "../_docker-command.js";
+export async function dockerContainerExec(container, command, options) {
     const execArgs = [];
-    for (const [k, v] of Object.entries(options?.env ?? {})) {
-        execArgs.push(`--env ${escapeCommandArg(stringifyEnvVariable(k, v))}`);
+    for (const [name, value] of Object.entries(options?.env ?? {})) {
+        execArgs.push(`--env ${dockerArg(printEnvAssignment(name, value))}`);
     }
     if (options?.user && options.user.length > 0) {
-        execArgs.push(`--user ${escapeCommandArg(options.user)}`);
+        execArgs.push(`--user ${dockerArg(options.user)}`);
     }
     if (options?.workdir && options.workdir.length > 0) {
-        execArgs.push(`--workdir ${escapeCommandArg(options.workdir)}`);
+        execArgs.push(`--workdir ${dockerArg(options.workdir)}`);
     }
-    execArgs.push(escapeCommandArg(container));
-    execArgs.push(escapeCommandArg(command));
-    for (const commandArg of commandArgs ?? []) {
-        execArgs.push(escapeCommandArg(commandArg));
+    execArgs.push(dockerArg(container));
+    execArgs.push(dockerArg(command));
+    for (const commandArg of options?.commandArgs ?? []) {
+        execArgs.push(dockerArg(commandArg));
     }
-    const { stdout, stderr } = await execAsync(`docker container exec ${execArgs.join(" ")}`, { encoding: "utf8" });
-    return { stdout, stderr };
+    return execDocker("container exec", execArgs, options);
 }
 //# sourceMappingURL=container-exec.js.map

package/dist/container/container-exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"container-exec.js","sourceRoot":"","sources":["../../src/container/container-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,SAAkD,EAClD,OAAe,EACf,WAAsB,EACtB,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,UAAU,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,aAAa,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzC,KAAK,MAAM,UAAU,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CACzC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAC7C,EAAE,QAAQ,EAAE,MAAM,EAAE,CACpB,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"container-exec.js","sourceRoot":"","sources":["../../src/container/container-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAc9D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,SAAkD,EAClD,OAAe,EACf,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,QAAQ,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAElC,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,UAAU,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/container/container-rm.d.ts

@@ -1,5 +1,5 @@
-import type { DockerContainerId, DockerContainerName } from "../types.js";
-export type DockerContainerRmOptions = {
+import type { DockerCommonOptions, DockerContainerId, DockerContainerName } from "../types.js";
+export type DockerContainerRmOptions = DockerCommonOptions & {
     force?: boolean;
     link?: boolean;
     volumes?: boolean;

package/dist/container/container-rm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-rm.d.ts","sourceRoot":"","sources":["../../src/container/container-rm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,wBAAwB,GAAG;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAkBf"}
+{"version":3,"file":"container-rm.d.ts","sourceRoot":"","sources":["../../src/container/container-rm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/container/container-rm.js

@@ -1,4 +1,4 @@
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
+import { dockerArg, execDocker } from "../_docker-command.js";
 export async function dockerContainerRm(containers, options) {
     const execArgs = [];
     if (options?.force) {
@@ -11,8 +11,8 @@ export async function dockerContainerRm(containers, options) {
         execArgs.push("--volumes");
     }
     for (const container of containers) {
-        execArgs.push(escapeCommandArg(container));
+        execArgs.push(dockerArg(container));
     }
-    await execAsync(`docker container rm ${execArgs.join(" ")}`);
+    await execDocker("container rm", execArgs, options);
 }
 //# sourceMappingURL=container-rm.js.map

package/dist/container/container-rm.js.map

@@ -1 +1 @@
-{"version":3,"file":"container-rm.js","sourceRoot":"","sources":["../../src/container/container-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,UAAuD,EACvD,OAAkC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,CAAC,uBAAuB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"container-rm.js","sourceRoot":"","sources":["../../src/container/container-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAa9D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,UAAuD,EACvD,OAAkC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,UAAU,CAAC,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/container/container-run.d.ts

@@ -1,13 +1,16 @@
-import type { DockerContainerName } from "../types.js";
-export type DockerContainerRunOptions = {
+import { EnvVariables } from "@ac-kit/format-shell";
+import type { DockerCommonOptions, DockerContainerName } from "../types.js";
+export type DockerContainerRunOptions = DockerCommonOptions & {
+    command?: string;
+    commandArgs?: string[];
     rm?: boolean;
     detach?: boolean;
     name?: DockerContainerName;
     network?: string;
     addHost?: string[];
-    env?: Record<string, string | number | bigint | boolean | null>;
+    env?: EnvVariables;
     publish?: string[];
     volume?: string[];
 };
-export declare function dockerContainerRun(image: string, command?: string, commandArgs?: string[], options?: DockerContainerRunOptions): Promise<void>;
+export declare function dockerContainerRun(image: string, options?: DockerContainerRunOptions): Promise<void>;
 //# sourceMappingURL=container-run.d.ts.map

package/dist/container/container-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-run.d.ts","sourceRoot":"","sources":["../../src/container/container-run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,yBAAyB,GAAG;IACvC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAuCf"}
+{"version":3,"file":"container-run.d.ts","sourceRoot":"","sources":["../../src/container/container-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,sBAAsB,CAAC;AAGxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/container/container-run.js

@@ -1,6 +1,6 @@
-import { stringifyEnvVariable } from "@ac-kit/core";
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
-export async function dockerContainerRun(image, command, commandArgs, options) {
+import { printEnvAssignment } from "@ac-kit/format-shell";
+import { dockerArg, execDocker } from "../_docker-command.js";
+export async function dockerContainerRun(image, options) {
     const execArgs = [];
     if (options?.rm) {
         execArgs.push("--rm");
@@ -9,30 +9,30 @@ export async function dockerContainerRun(image, command, commandArgs, options) {
         execArgs.push("--detach");
     }
     if (options?.name && options.name.length > 0) {
-        execArgs.push(`--name ${escapeCommandArg(options.name)}`);
+        execArgs.push(`--name ${dockerArg(options.name)}`);
     }
     if (options?.network && options.network.length > 0) {
-        execArgs.push(`--network ${escapeCommandArg(options.network)}`);
+        execArgs.push(`--network ${dockerArg(options.network)}`);
     }
-    for (const h of options?.addHost ?? []) {
-        execArgs.push(`--add-host ${escapeCommandArg(h)}`);
+    for (const addHost of options?.addHost ?? []) {
+        execArgs.push(`--add-host ${dockerArg(addHost)}`);
     }
-    for (const [k, v] of Object.entries(options?.env ?? {})) {
-        execArgs.push(`--env ${escapeCommandArg(stringifyEnvVariable(k, v))}`);
+    for (const [name, value] of Object.entries(options?.env ?? {})) {
+        execArgs.push(`--env ${dockerArg(printEnvAssignment(name, value))}`);
     }
-    for (const e of options?.publish ?? []) {
-        execArgs.push(`--publish ${escapeCommandArg(e)}`);
+    for (const publish of options?.publish ?? []) {
+        execArgs.push(`--publish ${dockerArg(publish)}`);
     }
-    for (const v of options?.volume ?? []) {
-        execArgs.push(`--volume ${escapeCommandArg(v)}`);
+    for (const volume of options?.volume ?? []) {
+        execArgs.push(`--volume ${dockerArg(volume)}`);
     }
-    execArgs.push(escapeCommandArg(image));
-    if (command) {
-        execArgs.push(escapeCommandArg(command));
-        for (const commandArg of commandArgs ?? []) {
-            execArgs.push(escapeCommandArg(commandArg));
+    execArgs.push(dockerArg(image));
+    if (options?.command) {
+        execArgs.push(dockerArg(options.command));
+        for (const commandArg of options?.commandArgs ?? []) {
+            execArgs.push(dockerArg(commandArg));
         }
     }
-    await execAsync(`docker container run ${execArgs.join(" ")}`);
+    await execDocker("container run", execArgs, options);
 }
 //# sourceMappingURL=container-run.js.map

package/dist/container/container-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"container-run.js","sourceRoot":"","sources":["../../src/container/container-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAe3D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,KAAa,EACb,OAAgB,EAChB,WAAsB,EACtB,OAAmC;IAEnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,EAAE,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,UAAU,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,aAAa,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,cAAc,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,aAAa,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvC,IAAI,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QAEzC,KAAK,MAAM,UAAU,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7C,CAAC;IACF,CAAC;IAED,MAAM,SAAS,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"container-run.js","sourceRoot":"","sources":["../../src/container/container-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAgB9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,KAAa,EACb,OAAmC;IAEnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,EAAE,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,QAAQ,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAEhC,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAE1C,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC;YACrD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAED,MAAM,UAAU,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/container/container-stop.d.ts

@@ -1,5 +1,5 @@
-import type { DockerContainerId, DockerContainerName } from "../types.js";
-export type DockerContainerStopOptions = {
+import type { DockerCommonOptions, DockerContainerId, DockerContainerName } from "../types.js";
+export type DockerContainerStopOptions = DockerCommonOptions & {
     /** Seconds to wait before killing the container. */
     time?: number;
 };

package/dist/container/container-stop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-stop.d.ts","sourceRoot":"","sources":["../../src/container/container-stop.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,0BAA0B,GAAG;IACxC,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,UAAU,EAAE,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"container-stop.d.ts","sourceRoot":"","sources":["../../src/container/container-stop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG;IAC9D,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,UAAU,EAAE,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/container/container-stop.js

@@ -1,12 +1,12 @@
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
+import { dockerArg, execDocker } from "../_docker-command.js";
 export async function dockerContainerStop(containers, options) {
     const execArgs = [];
     if (options?.time !== undefined) {
         execArgs.push(`--time ${options.time}`);
     }
     for (const container of containers) {
-        execArgs.push(escapeCommandArg(container));
+        execArgs.push(dockerArg(container));
     }
-    await execAsync(`docker container stop ${execArgs.join(" ")}`);
+    await execDocker("container stop", execArgs, options);
 }
 //# sourceMappingURL=container-stop.js.map

package/dist/container/container-stop.js.map

@@ -1 +1 @@
-{"version":3,"file":"container-stop.js","sourceRoot":"","sources":["../../src/container/container-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAS3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,UAAuD,EACvD,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,CAAC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"container-stop.js","sourceRoot":"","sources":["../../src/container/container-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAY9D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,UAAuD,EACvD,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,UAAU,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/dist/context/context-show.d.ts

@@ -1,2 +1,4 @@
-export declare function dockerContextShow(): Promise<string>;
+import type { DockerCommonOptions } from "../types.js";
+export type DockerContextShowOptions = DockerCommonOptions;
+export declare function dockerContextShow(options?: DockerContextShowOptions): Promise<string>;
 //# sourceMappingURL=context-show.d.ts.map

package/dist/context/context-show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-show.d.ts","sourceRoot":"","sources":["../../src/context/context-show.ts"],"names":[],"mappings":"AAEA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAMzD"}
+{"version":3,"file":"context-show.d.ts","sourceRoot":"","sources":["../../src/context/context-show.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAE3D,wBAAsB,iBAAiB,CACtC,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/context/context-show.js

@@ -1,8 +1,6 @@
-import { execAsync } from "@ac-kit/node";
-export async function dockerContextShow() {
-    const { stdout } = await execAsync("docker context show", {
-        encoding: "utf8",
-    });
-    return stdout;
+import { execDocker } from "../_docker-command.js";
+export async function dockerContextShow(options) {
+    const { stdout } = await execDocker("context show", [], options);
+    return stdout.trim();
 }
 //# sourceMappingURL=context-show.js.map

package/dist/context/context-show.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-show.js","sourceRoot":"","sources":["../../src/context/context-show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACzD,QAAQ,EAAE,MAAM;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"context-show.js","sourceRoot":"","sources":["../../src/context/context-show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKnD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAkC;IAElC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAEjE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/context/context-use.js

@@ -1,5 +1,5 @@
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
+import { dockerArg, execDocker } from "../_docker-command.js";
 export async function dockerContextUse(context) {
-    await execAsync(`docker context use ${escapeCommandArg(context)}`);
+    await execDocker("context use", [dockerArg(context)]);
 }
 //# sourceMappingURL=context-use.js.map

package/dist/context/context-use.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-use.js","sourceRoot":"","sources":["../../src/context/context-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACrD,MAAM,SAAS,CAAC,sBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"context-use.js","sourceRoot":"","sources":["../../src/context/context-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACrD,MAAM,UAAU,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/image/image-rm.d.ts

@@ -1,8 +1,7 @@
-type DockerImageId = string;
-export type DockerImageRmOptions = {
+import type { DockerCommonOptions, DockerImageId } from "../types.js";
+export type DockerImageRmOptions = DockerCommonOptions & {
     force?: boolean;
     noPrune?: boolean;
 };
 export declare function dockerImageRm(images: DockerImageId[], options?: DockerImageRmOptions): Promise<void>;
-export {};
 //# sourceMappingURL=image-rm.d.ts.map

package/dist/image/image-rm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-rm.d.ts","sourceRoot":"","sources":["../../src/image/image-rm.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG,MAAM,CAAC;AAE5B,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,aAAa,CAClC,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef"}
+{"version":3,"file":"image-rm.d.ts","sourceRoot":"","sources":["../../src/image/image-rm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,aAAa,CAClC,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/image/image-rm.js

@@ -1,4 +1,4 @@
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
+import { dockerArg, execDocker } from "../_docker-command.js";
 export async function dockerImageRm(images, options) {
     const execArgs = [];
     if (options?.force) {
@@ -8,8 +8,8 @@ export async function dockerImageRm(images, options) {
         execArgs.push("--no-prune");
     }
     for (const image of images) {
-        execArgs.push(escapeCommandArg(image));
+        execArgs.push(dockerArg(image));
     }
-    await execAsync(`docker image rm ${execArgs.join(" ")}`);
+    await execDocker("image rm", execArgs, options);
 }
 //# sourceMappingURL=image-rm.js.map

package/dist/image/image-rm.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-rm.js","sourceRoot":"","sources":["../../src/image/image-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAS3D,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAAuB,EACvB,OAA8B;IAE9B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,SAAS,CAAC,mBAAmB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"image-rm.js","sourceRoot":"","sources":["../../src/image/image-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQ9D,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAAuB,EACvB,OAA8B;IAE9B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/network/network-create.d.ts

@@ -1,4 +1,5 @@
-export type DockerNetworkCreateOptions = {
+import type { DockerCommonOptions } from "../types.js";
+export type DockerNetworkCreateOptions = DockerCommonOptions & {
     driver?: string;
 };
 export declare function dockerNetworkCreate(network: string, options?: DockerNetworkCreateOptions): Promise<void>;

package/dist/network/network-create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-create.d.ts","sourceRoot":"","sources":["../../src/network/network-create.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,0BAA0B,GAAG;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"network-create.d.ts","sourceRoot":"","sources":["../../src/network/network-create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/network/network-create.js

@@ -1,10 +1,10 @@
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
+import { dockerArg, execDocker } from "../_docker-command.js";
 export async function dockerNetworkCreate(network, options) {
     const execArgs = [];
     if (options?.driver && options.driver.length > 0) {
-        execArgs.push(`--driver ${escapeCommandArg(options.driver)}`);
+        execArgs.push(`--driver ${dockerArg(options.driver)}`);
     }
-    execArgs.push(escapeCommandArg(network));
-    await execAsync(`docker network create ${execArgs.join(" ")}`);
+    execArgs.push(dockerArg(network));
+    await execDocker("network create", execArgs, options);
 }
 //# sourceMappingURL=network-create.js.map

package/dist/network/network-create.js.map

@@ -1 +1 @@
-{"version":3,"file":"network-create.js","sourceRoot":"","sources":["../../src/network/network-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAe,EACf,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,YAAY,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzC,MAAM,SAAS,CAAC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"network-create.js","sourceRoot":"","sources":["../../src/network/network-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAO9D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAe,EACf,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAElC,MAAM,UAAU,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/dist/network/network-rm.d.ts

@@ -1,2 +1,4 @@
-export declare function dockerNetworkRm(networks: string[]): Promise<void>;
+import type { DockerCommonOptions } from "../types.js";
+export type DockerNetworkRmOptions = DockerCommonOptions;
+export declare function dockerNetworkRm(networks: string[], options?: DockerNetworkRmOptions): Promise<void>;
 //# sourceMappingURL=network-rm.d.ts.map

package/dist/network/network-rm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-rm.d.ts","sourceRoot":"","sources":["../../src/network/network-rm.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}
+{"version":3,"file":"network-rm.d.ts","sourceRoot":"","sources":["../../src/network/network-rm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAEzD,wBAAsB,eAAe,CACpC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/network/network-rm.js

@@ -1,6 +1,5 @@
-import { escapeCommandArg, execAsync } from "@ac-kit/node";
-export async function dockerNetworkRm(networks) {
-    const execArgs = networks.map((n) => escapeCommandArg(n));
-    await execAsync(`docker network rm ${execArgs.join(" ")}`);
+import { dockerArg, execDocker } from "../_docker-command.js";
+export async function dockerNetworkRm(networks, options) {
+    await execDocker("network rm", networks.map(dockerArg), options);
 }
 //# sourceMappingURL=network-rm.js.map

package/dist/network/network-rm.js.map

@@ -1 +1 @@
-{"version":3,"file":"network-rm.js","sourceRoot":"","sources":["../../src/network/network-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAkB;IACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1D,MAAM,SAAS,CAAC,qBAAqB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"network-rm.js","sourceRoot":"","sources":["../../src/network/network-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAK9D,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,QAAkB,EAClB,OAAgC;IAEhC,MAAM,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/types.d.ts

@@ -1,3 +1,14 @@
 export type DockerContainerId = string;
 export type DockerContainerName = string;
+export type DockerImageId = string;
+/** Options every docker command accepts, whatever its subcommand. */
+export type DockerCommonOptions = {
+    /**
+     * The docker context to run against, as `docker --context` takes it.
+     *
+     * Naming the context per command leaves the daemon the rest of the machine
+     * talks to alone, which `docker context use` would not.
+     */
+    context?: string;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACvC,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACvC,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACzC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG;IACjC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ac-kit/cmd-docker",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Typed wrapper over the docker CLI: invocation plus output parsing.",
   "keywords": [
     "cli",
@@ -38,13 +38,13 @@
     "prepack": "yarn build"
   },
   "dependencies": {
-    "@ac-kit/core": "^0.1.0",
-    "@ac-kit/node": "^0.1.0"
+    "@ac-kit/format-shell": "^0.1.0",
+    "@ac-kit/node": "^0.2.0"
   },
   "devDependencies": {
     "@ac-kit/tsconfig": "0.1.0",
     "@ac-kit/typedoc-config": "0.1.0",
-    "@ac-kit/vitest-config": "0.1.0",
+    "@ac-kit/vitest-config": "0.1.1",
     "@types/node": "26.5.1",
     "@typescript/native": "typescript@7.0.2",
     "rimraf": "6.1.3",