@sorrell/cli-utilities 1.0.37 → 1.0.39

package/Distribution/Command/Command.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file      Command.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * For a given command, get the name of that command, such that it will
+ * work, even if the command will be run inside of a Windows shell terminal.
+ *
+ * @note The {@link process!platform} is used to determine whether `.cmd`
+ * should be appended.
+ *
+ * @param {string} PlainName - The name of the command, without `.cmd` appended.
+ * @returns {string} The command, with `.cmd` appended, if needed.
+ *
+ * @example
+ * Suppose that the following code belongs to a script that is being run within
+ * a Windows shell terminal,
+ * ```typescript
+ * const MyCommand: string = GetCommandName("MyCommand");
+ * // `MyCommand` <- `"MyCommand.cmd"`
+ * ```
+ *
+ * Now suppose that the following code belongs to a script that is *not* being run
+ * within a Windows shell terminal,
+ * ```typescript
+ * const MyCommand: string = GetCommandName("MyCommand");
+ * // `MyCommand` <- `"MyCommand"`
+ * ```
+ */
+export declare function GetCommandName(PlainName: string): string;
+//# sourceMappingURL=Command.d.ts.map

package/Distribution/Command/Command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../Source/Command/Command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD"}

package/Distribution/Command/Command.js

@@ -0,0 +1,37 @@
+/**
+ * @file      Command.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * For a given command, get the name of that command, such that it will
+ * work, even if the command will be run inside of a Windows shell terminal.
+ *
+ * @note The {@link process!platform} is used to determine whether `.cmd`
+ * should be appended.
+ *
+ * @param {string} PlainName - The name of the command, without `.cmd` appended.
+ * @returns {string} The command, with `.cmd` appended, if needed.
+ *
+ * @example
+ * Suppose that the following code belongs to a script that is being run within
+ * a Windows shell terminal,
+ * ```typescript
+ * const MyCommand: string = GetCommandName("MyCommand");
+ * // `MyCommand` <- `"MyCommand.cmd"`
+ * ```
+ *
+ * Now suppose that the following code belongs to a script that is *not* being run
+ * within a Windows shell terminal,
+ * ```typescript
+ * const MyCommand: string = GetCommandName("MyCommand");
+ * // `MyCommand` <- `"MyCommand"`
+ * ```
+ */
+export function GetCommandName(PlainName) {
+    return process.platform === "win32"
+        ? `${PlainName}.cmd`
+        : PlainName;
+}
+//# sourceMappingURL=Command.js.map

package/Distribution/Command/Command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../Source/Command/Command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAE5C,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC/B,CAAC,CAAC,GAAI,SAAU,MAAM;QACtB,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC"}

package/Distribution/Command/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./Command.js";
+//# sourceMappingURL=index.d.ts.map

package/Distribution/Command/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Source/Command/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC"}

package/Distribution/Command/index.js

@@ -0,0 +1,8 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./Command.js";
+//# sourceMappingURL=index.js.map

package/Distribution/Command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Source/Command/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC"}

package/Distribution/PseudoTerminal/PseudoTerminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PseudoTerminal.d.ts","sourceRoot":"","sources":["../../Source/PseudoTerminal/PseudoTerminal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAS,MAAM,UAAU,CAAC;AAE/F,wBAAgB,KAAK,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EACxB,OAAO,EAAE,eAAe,GAAG,sBAAsB,GAClD,IAAI,CAkBN"}
+{"version":3,"file":"PseudoTerminal.d.ts","sourceRoot":"","sources":["../../Source/PseudoTerminal/PseudoTerminal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAS,MAAM,UAAU,CAAC;AAG/F,wBAAgB,KAAK,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EACxB,OAAO,EAAE,eAAe,GAAG,sBAAsB,GAClD,IAAI,CAsBN"}

package/Distribution/PseudoTerminal/PseudoTerminal.js

@@ -5,6 +5,7 @@
  * @license   MIT
  */
 import { spawn } from "node-pty";
+import { GetCommandName } from "../Command/Command.js";
 export function Spawn(Command, Arguments, Options) {
     const DefaultOptions = {
         cols: process.stdout.columns || 80,
@@ -17,6 +18,6 @@ export function Spawn(Command, Arguments, Options) {
         ...DefaultOptions,
         ...Options
     };
-    return spawn(Command, Arguments, OutOptions);
+    return spawn(GetCommandName(Command), Arguments, OutOptions);
 }
 //# sourceMappingURL=PseudoTerminal.js.map

package/Distribution/PseudoTerminal/PseudoTerminal.js.map

@@ -1 +1 @@
-{"version":3,"file":"PseudoTerminal.js","sourceRoot":"","sources":["../../Source/PseudoTerminal/PseudoTerminal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgE,KAAK,EAAE,MAAM,UAAU,CAAC;AAE/F,MAAM,UAAU,KAAK,CACjB,OAAe,EACf,SAAwB,EACxB,OAAiD;IAGjD,MAAM,cAAc,GAChB;QACI,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;QAClC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAA6B;QAC1C,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;KAClC,CAAC;IAEN,MAAM,UAAU,GACZ;QACI,GAAG,cAAc;QACjB,GAAG,OAAO;KACb,CAAC;IAEN,OAAO,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"PseudoTerminal.js","sourceRoot":"","sources":["../../Source/PseudoTerminal/PseudoTerminal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,KAAK,CACjB,OAAe,EACf,SAAwB,EACxB,OAAiD;IAGjD,MAAM,cAAc,GAChB;QACI,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;QAClC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAA6B;QAC1C,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;KAClC,CAAC;IAEN,MAAM,UAAU,GACZ;QACI,GAAG,cAAc;QACjB,GAAG,OAAO;KACb,CAAC;IAEN,OAAO,KAAK,CACR,cAAc,CAAC,OAAO,CAAC,EACvB,SAAS,EACT,UAAU,CACb,CAAC;AACN,CAAC"}

package/Distribution/index.d.ts

@@ -5,8 +5,10 @@
  * @license   MIT
  */
 export * from "./Inquirer/Confirm.js";
+export * as Command from "./Command/index.js";
 export * as Listr from "./Listr/index.js";
 export * as Inquirer from "./Inquirer/index.js";
+export * as PseudoTerminal from "./PseudoTerminal/index.js";
 export * as Format from "./Format/index.js";
 export * as Ora from "./Ora/index.js";
 //# sourceMappingURL=index.d.ts.map

package/Distribution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/Distribution/index.js

@@ -5,8 +5,10 @@
  * @license   MIT
  */
 export * from "./Inquirer/Confirm.js";
+export * as Command from "./Command/index.js";
 export * as Listr from "./Listr/index.js";
 export * as Inquirer from "./Inquirer/index.js";
+export * as PseudoTerminal from "./PseudoTerminal/index.js";
 export * as Format from "./Format/index.js";
 export * as Ora from "./Ora/index.js";
 //# sourceMappingURL=index.js.map

package/Distribution/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sorrell/cli-utilities",
-  "version": "1.0.37",
+  "version": "1.0.39",
   "description": "Utilities for CLI tools.",
   "keywords": [
     "cli",
@@ -46,6 +46,12 @@
       "require": "./Distribution/Inquirer/index.js",
       "types": "./Distribution/Inquirer/index.d.ts"
     },
+    "./command": {
+      "default": "./Distribution/Command/index.js",
+      "import": "./Distribution/Command/index.js",
+      "require": "./Distribution/Command/index.js",
+      "types": "./Distribution/Command/index.d.ts"
+    },
     "./listr": {
       "default": "./Distribution/Listr/index.js",
       "import": "./Distribution/Listr/index.js",