@twin.org/cli-core 0.0.1-next.6 → 0.0.1-next.60

package/dist/cjs/index.cjs

@@ -81,7 +81,7 @@ class CLIDisplay {
         if (lineBreaks) {
             CLIDisplay.writeError("\n");
         }
-        const formatted = core.ErrorHelper.formatErrors(error);
+        const formatted = core.ErrorHelper.formatErrors(error, true);
         CLIDisplay.writeError(chalk.red(formatted.map(e => `\t${e}`).join("\n")));
         if (lineBreaks) {
             CLIDisplay.writeError("\n");
@@ -298,6 +298,17 @@ class CLIUtils {
             });
         });
     }
+    /**
+     * Run a shell command.
+     * @param command The app to run in the shell.
+     * @param args The args for the app.
+     * @param cwd The working directory to execute the command in.
+     * @returns Promise to wait for command execution to complete.
+     */
+    static async runShellCmd(command, args, cwd) {
+        const osCommand = process.platform.startsWith("win") ? `${command}.cmd` : command;
+        return CLIUtils.runShellApp(osCommand, args, cwd);
+    }
     /**
      * Run a shell app.
      * @param app The app to run in the shell.
@@ -305,10 +316,9 @@ class CLIUtils {
      * @param cwd The working directory to execute the command in.
      * @returns Promise to wait for command execution to complete.
      */
-    static async runShellCmd(app, args, cwd) {
+    static async runShellApp(app, args, cwd) {
         return new Promise((resolve, reject) => {
-            const osCommand = process.platform.startsWith("win") ? `${app}.cmd` : app;
-            const sp = node_child_process.spawn(osCommand, args, {
+            const sp = node_child_process.spawn(app, args, {
                 shell: true,
                 cwd
             });
@@ -346,7 +356,7 @@ class CLIUtils {
             CLIDisplay.task(core.I18n.formatMessage("cli.progress.writingJsonFile"), filename);
             CLIDisplay.break();
             await promises.mkdir(path.dirname(filename), { recursive: true });
-            await promises.writeFile(filename, JSON.stringify(core.ObjectHelper.merge(currentJson, data), undefined, "\t"));
+            await promises.writeFile(filename, `${JSON.stringify(core.ObjectHelper.merge(currentJson, data), undefined, "\t")}\n`);
         }
     }
     /**
@@ -377,7 +387,7 @@ class CLIUtils {
                 for (const line of data) {
                     const parts = line.split("=");
                     const currentIndex = outputKeys.indexOf(parts[0]);
-                    if (currentIndex >= 0) {
+                    if (currentIndex !== -1) {
                         outputKeys.splice(currentIndex, 1);
                     }
                     outputKeys.push(parts[0]);
@@ -627,7 +637,7 @@ class CLIParam {
         return optionValue;
     }
     /**
-     * Check the option to see if it exists.
+     * Check the option to see if the String exists.
      * @param optionName The name of the option.
      * @param optionValue The option value.
      * @param allowEnvVar Allow the option to be read from an env var.
@@ -640,7 +650,7 @@ class CLIParam {
         return optionValue;
     }
     /**
-     * Check the option to see if it a url.
+     * Check the option to see if it is a url.
      * @param optionName The name of the option.
      * @param optionValue The option value.
      * @param allowEnvVar Allow the option to be read from an env var.

package/dist/esm/index.mjs

@@ -60,7 +60,7 @@ class CLIDisplay {
         if (lineBreaks) {
             CLIDisplay.writeError("\n");
         }
-        const formatted = ErrorHelper.formatErrors(error);
+        const formatted = ErrorHelper.formatErrors(error, true);
         CLIDisplay.writeError(chalk.red(formatted.map(e => `\t${e}`).join("\n")));
         if (lineBreaks) {
             CLIDisplay.writeError("\n");
@@ -277,6 +277,17 @@ class CLIUtils {
             });
         });
     }
+    /**
+     * Run a shell command.
+     * @param command The app to run in the shell.
+     * @param args The args for the app.
+     * @param cwd The working directory to execute the command in.
+     * @returns Promise to wait for command execution to complete.
+     */
+    static async runShellCmd(command, args, cwd) {
+        const osCommand = process.platform.startsWith("win") ? `${command}.cmd` : command;
+        return CLIUtils.runShellApp(osCommand, args, cwd);
+    }
     /**
      * Run a shell app.
      * @param app The app to run in the shell.
@@ -284,10 +295,9 @@ class CLIUtils {
      * @param cwd The working directory to execute the command in.
      * @returns Promise to wait for command execution to complete.
      */
-    static async runShellCmd(app, args, cwd) {
+    static async runShellApp(app, args, cwd) {
         return new Promise((resolve, reject) => {
-            const osCommand = process.platform.startsWith("win") ? `${app}.cmd` : app;
-            const sp = spawn(osCommand, args, {
+            const sp = spawn(app, args, {
                 shell: true,
                 cwd
             });
@@ -325,7 +335,7 @@ class CLIUtils {
             CLIDisplay.task(I18n.formatMessage("cli.progress.writingJsonFile"), filename);
             CLIDisplay.break();
             await mkdir(path.dirname(filename), { recursive: true });
-            await writeFile(filename, JSON.stringify(ObjectHelper.merge(currentJson, data), undefined, "\t"));
+            await writeFile(filename, `${JSON.stringify(ObjectHelper.merge(currentJson, data), undefined, "\t")}\n`);
         }
     }
     /**
@@ -356,7 +366,7 @@ class CLIUtils {
                 for (const line of data) {
                     const parts = line.split("=");
                     const currentIndex = outputKeys.indexOf(parts[0]);
-                    if (currentIndex >= 0) {
+                    if (currentIndex !== -1) {
                         outputKeys.splice(currentIndex, 1);
                     }
                     outputKeys.push(parts[0]);
@@ -606,7 +616,7 @@ class CLIParam {
         return optionValue;
     }
     /**
-     * Check the option to see if it exists.
+     * Check the option to see if the String exists.
      * @param optionName The name of the option.
      * @param optionValue The option value.
      * @param allowEnvVar Allow the option to be read from an env var.
@@ -619,7 +629,7 @@ class CLIParam {
         return optionValue;
     }
     /**
-     * Check the option to see if it a url.
+     * Check the option to see if it is a url.
      * @param optionName The name of the option.
      * @param optionValue The option value.
      * @param allowEnvVar Allow the option to be read from an env var.

package/dist/types/cliParam.d.ts

@@ -12,7 +12,7 @@ export declare class CLIParam {
      */
     static env(optionName: string, optionValue: string | undefined, allowEnvVar: boolean): string | undefined;
     /**
-     * Check the option to see if it exists.
+     * Check the option to see if the String exists.
      * @param optionName The name of the option.
      * @param optionValue The option value.
      * @param allowEnvVar Allow the option to be read from an env var.
@@ -21,7 +21,7 @@ export declare class CLIParam {
      */
     static stringValue(optionName: string, optionValue: string | undefined, allowEnvVar?: boolean): string;
     /**
-     * Check the option to see if it a url.
+     * Check the option to see if it is a url.
      * @param optionName The name of the option.
      * @param optionValue The option value.
      * @param allowEnvVar Allow the option to be read from an env var.

package/dist/types/cliUtils.d.ts

@@ -56,6 +56,14 @@ export declare class CLIUtils {
      * @returns The root path.
      */
     static findNpmRoot(rootFolder: string): Promise<string>;
+    /**
+     * Run a shell command.
+     * @param command The app to run in the shell.
+     * @param args The args for the app.
+     * @param cwd The working directory to execute the command in.
+     * @returns Promise to wait for command execution to complete.
+     */
+    static runShellCmd(command: string, args: string[], cwd: string): Promise<void>;
     /**
      * Run a shell app.
      * @param app The app to run in the shell.
@@ -63,7 +71,7 @@ export declare class CLIUtils {
      * @param cwd The working directory to execute the command in.
      * @returns Promise to wait for command execution to complete.
      */
-    static runShellCmd(app: string, args: string[], cwd: string): Promise<void>;
+    static runShellApp(app: string, args: string[], cwd: string): Promise<void>;
     /**
      * Write a JSON file.
      * @param jsonFilename The filename to write.

package/docs/changelog.md

@@ -1,5 +1,170 @@
 # @twin.org/cli-core - Changelog
 
-## 0.0.1-next.6
+## [0.0.1-next.60](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.59...cli-core-v0.0.1-next.60) (2025-06-17)
+
+
+### Features
+
+* improve error display in CLI ([94b6ca8](https://github.com/twinfoundation/framework/commit/94b6ca8bdcfe3ca7671c4095b436ea7bddaae98e))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.59 to 0.0.1-next.60
+    * @twin.org/crypto bumped from 0.0.1-next.59 to 0.0.1-next.60
+
+## [0.0.1-next.59](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.58...cli-core-v0.0.1-next.59) (2025-06-17)
+
+
+### Miscellaneous Chores
+
+* **cli-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.58 to 0.0.1-next.59
+    * @twin.org/crypto bumped from 0.0.1-next.58 to 0.0.1-next.59
+
+## [0.0.1-next.58](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.57...cli-core-v0.0.1-next.58) (2025-06-13)
+
+
+### Bug Fixes
+
+* framework pr naming convention ([#142](https://github.com/twinfoundation/framework/issues/142)) ([e29acee](https://github.com/twinfoundation/framework/commit/e29acee2fbec42506091956d6ba8b8ce25a90008))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.57 to 0.0.1-next.58
+    * @twin.org/crypto bumped from 0.0.1-next.57 to 0.0.1-next.58
+
+## [0.0.1-next.57](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.56...cli-core-v0.0.1-next.57) (2025-06-10)
+
+
+### Features
+
+* add guards arrayEndsWith and arrayStartsWith ([95d875e](https://github.com/twinfoundation/framework/commit/95d875ec8ccb4713c145fdde941d4cfedcec2ed3))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.56 to 0.0.1-next.57
+    * @twin.org/crypto bumped from 0.0.1-next.56 to 0.0.1-next.57
+
+## [0.0.1-next.56](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.55...cli-core-v0.0.1-next.56) (2025-05-08)
+
+
+### Miscellaneous Chores
+
+* **cli-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.55 to 0.0.1-next.56
+    * @twin.org/crypto bumped from 0.0.1-next.55 to 0.0.1-next.56
+
+## [0.0.1-next.55](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.54...cli-core-v0.0.1-next.55) (2025-05-07)
+
+
+### Miscellaneous Chores
+
+* **cli-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.54 to 0.0.1-next.55
+    * @twin.org/crypto bumped from 0.0.1-next.54 to 0.0.1-next.55
+
+## [0.0.1-next.54](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.53...cli-core-v0.0.1-next.54) (2025-05-06)
+
+
+### Miscellaneous Chores
+
+* **cli-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.53 to 0.0.1-next.54
+    * @twin.org/crypto bumped from 0.0.1-next.53 to 0.0.1-next.54
+
+## [0.0.1-next.53](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.52...cli-core-v0.0.1-next.53) (2025-05-01)
+
+
+### Miscellaneous Chores
+
+* **cli-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.52 to 0.0.1-next.53
+    * @twin.org/crypto bumped from 0.0.1-next.52 to 0.0.1-next.53
+
+## [0.0.1-next.52](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.51...cli-core-v0.0.1-next.52) (2025-04-17)
+
+
+### Features
+
+* use new shared store mechanism ([#131](https://github.com/twinfoundation/framework/issues/131)) ([934385b](https://github.com/twinfoundation/framework/commit/934385b2fbaf9f5c00a505ebf9d093bd5a425f55))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.51 to 0.0.1-next.52
+    * @twin.org/crypto bumped from 0.0.1-next.51 to 0.0.1-next.52
+
+## [0.0.1-next.51](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.50...cli-core-v0.0.1-next.51) (2025-03-27)
+
+
+### Miscellaneous Chores
+
+* **cli-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.50 to 0.0.1-next.51
+    * @twin.org/crypto bumped from 0.0.1-next.50 to 0.0.1-next.51
+
+## [0.0.1-next.50](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.1-next.49...cli-core-v0.0.1-next.50) (2025-03-26)
+
+
+### Miscellaneous Chores
+
+* **cli-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.49 to 0.0.1-next.50
+    * @twin.org/crypto bumped from 0.0.1-next.49 to 0.0.1-next.50
+
+## 0.0.1-next.49
 
 - Initial Release

package/docs/reference/classes/CLIBase.md

@@ -4,13 +4,13 @@ The main entry point for the CLI.
 
 ## Constructors
 
-### new CLIBase()
+### Constructor
 
-> **new CLIBase**(): [`CLIBase`](CLIBase.md)
+> **new CLIBase**(): `CLIBase`
 
 #### Returns
 
-[`CLIBase`](CLIBase.md)
+`CLIBase`
 
 ## Methods
 
@@ -22,15 +22,21 @@ Execute the command line processing.
 
 #### Parameters
 
-• **options**: [`ICliOptions`](../interfaces/ICliOptions.md)
+##### options
+
+[`ICliOptions`](../interfaces/ICliOptions.md)
 
 The options for the CLI.
 
-• **localesDirectory**: `string`
+##### localesDirectory
+
+`string`
 
 The path to load the locales from.
 
-• **argv**: `string`[]
+##### argv
+
+`string`[]
 
 The process arguments.
 
@@ -50,7 +56,9 @@ Configure any options or actions at the root program level.
 
 #### Parameters
 
-• **program**: `Command`
+##### program
+
+`Command`
 
 The root program command.
 
@@ -68,7 +76,9 @@ Get the commands for the CLI, override in derived class to supply your own.
 
 #### Parameters
 
-• **program**: `Command`
+##### program
+
+`Command`
 
 The main program that the commands will be added to.
 

package/docs/reference/classes/CLIDisplay.md

@@ -4,13 +4,13 @@ Display utilities for the CLI.
 
 ## Constructors
 
-### new CLIDisplay()
+### Constructor
 
-> **new CLIDisplay**(): [`CLIDisplay`](CLIDisplay.md)
+> **new CLIDisplay**(): `CLIDisplay`
 
 #### Returns
 
-[`CLIDisplay`](CLIDisplay.md)
+`CLIDisplay`
 
 ## Properties
 
@@ -22,10 +22,12 @@ The default output method for writing standard messages.
 
 #### Parameters
 
-• **buffer**: `string` \| `Uint8Array`
+##### buffer
 
 The message to output.
 
+`string` | `Uint8Array`\<`ArrayBufferLike`\>
+
 #### Returns
 
 `void`
@@ -40,10 +42,12 @@ The default output method for writing error messages.
 
 #### Parameters
 
-• **buffer**: `string` \| `Uint8Array`
+##### buffer
 
 The message to output.
 
+`string` | `Uint8Array`\<`ArrayBufferLike`\>
+
 #### Returns
 
 `void`
@@ -70,15 +74,21 @@ Display the header for the CLI.
 
 #### Parameters
 
-• **title**: `string`
+##### title
+
+`string`
 
 The title of the CLI.
 
-• **version**: `string`
+##### version
+
+`string`
 
 The version of the CLI.
 
-• **icon**: `string`
+##### icon
+
+`string`
 
 The icon for the CLI.
 
@@ -96,11 +106,15 @@ Display an error message.
 
 #### Parameters
 
-• **error**: `unknown`
+##### error
+
+`unknown`
 
 The error to display.
 
-• **lineBreaks**: `boolean` = `true`
+##### lineBreaks
+
+`boolean` = `true`
 
 Whether to add a line break after the error.
 
@@ -118,7 +132,9 @@ Display a section.
 
 #### Parameters
 
-• **label**: `string`
+##### label
+
+`string`
 
 The label for the section.
 
@@ -136,15 +152,21 @@ Display a value with a label.
 
 #### Parameters
 
-• **label**: `string`
+##### label
+
+`string`
 
 The label for the value.
 
-• **value**: `unknown`
+##### value
+
+`unknown`
 
 The value to display.
 
-• **indentLevel**: `number` = `0`
+##### indentLevel
+
+`number` = `0`
 
 The level of indentation.
 
@@ -156,17 +178,21 @@ The level of indentation.
 
 ### task()
 
-> `static` **task**(`label`, `task`?): `void`
+> `static` **task**(`label`, `task?`): `void`
 
 Display a task with a label.
 
 #### Parameters
 
-• **label**: `string`
+##### label
+
+`string`
 
 The label for the value.
 
-• **task?**: `string`
+##### task?
+
+`string`
 
 The task to display.
 
@@ -196,7 +222,9 @@ Display formatted and colorized JSON.
 
 #### Parameters
 
-• **obj**: `unknown`
+##### obj
+
+`unknown`
 
 The object to display.
 
@@ -226,15 +254,21 @@ Start the spinner.
 
 #### Parameters
 
-• **i18nMessage**: `string` = `"cli.progress.pleaseWait"`
+##### i18nMessage
+
+`string` = `"cli.progress.pleaseWait"`
 
 The message to display with the spinner.
 
-• **spinnerCharacters**: `string`[] = `...`
+##### spinnerCharacters
+
+`string`[] = `...`
 
 The characters to use in the spinner.
 
-• **interval**: `number` = `100`
+##### interval
+
+`number` = `100`
 
 The interval for the spinner.
 

package/docs/reference/classes/CLIOptions.md

@@ -4,13 +4,13 @@ Utilities for getting standard options.
 
 ## Constructors
 
-### new CLIOptions()
+### Constructor
 
-> **new CLIOptions**(): [`CLIOptions`](CLIOptions.md)
+> **new CLIOptions**(): `CLIOptions`
 
 #### Returns
 
-[`CLIOptions`](CLIOptions.md)
+`CLIOptions`
 
 ## Methods
 
@@ -22,31 +22,43 @@ Get the options for output.
 
 #### Parameters
 
-• **command**: `Command`
+##### command
+
+`Command`
 
 The command to add the options to.
 
-• **opts**
+##### opts
 
 The options of what to include.
 
-• **opts.noConsole**: `boolean`
+###### noConsole
+
+`boolean`
 
 Do not output to the console.
 
-• **opts.json**: `boolean`
+###### json
+
+`boolean`
 
 Output to a JSON file.
 
-• **opts.env**: `boolean`
+###### env
+
+`boolean`
 
 Output to an environment file.
 
-• **opts.mergeJson**: `boolean`
+###### mergeJson
+
+`boolean`
 
 Merge existing JSON file.
 
-• **opts.mergeEnv**: `boolean`
+###### mergeEnv
+
+`boolean`
 
 Merge existing environment file.
 

package/docs/reference/classes/CLIParam.md

@@ -4,13 +4,13 @@ Parameter utilities for the CLI.
 
 ## Constructors
 
-### new CLIParam()
+### Constructor
 
-> **new CLIParam**(): [`CLIParam`](CLIParam.md)
+> **new CLIParam**(): `CLIParam`
 
 #### Returns
 
-[`CLIParam`](CLIParam.md)
+`CLIParam`
 
 ## Methods
 
@@ -22,15 +22,21 @@ Check the option to see if it exists.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean`
 
 Allow the option to be read from an env var.
 
@@ -50,19 +56,25 @@ An error if the option is invalid.
 
 > `static` **stringValue**(`optionName`, `optionValue`, `allowEnvVar`): `string`
 
-Check the option to see if it exists.
+Check the option to see if the String exists.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
@@ -82,19 +94,25 @@ An error if the option is invalid.
 
 > `static` **url**(`optionName`, `optionValue`, `allowEnvVar`): `string`
 
-Check the option to see if it a url.
+Check the option to see if it is a url.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
@@ -112,29 +130,39 @@ An error if the option is invalid.
 
 ### number()
 
-> `static` **number**(`optionName`, `optionValue`, `allowEnvVar`, `minValue`, `maxValue`?): `number`
+> `static` **number**(`optionName`, `optionValue`, `allowEnvVar`, `minValue`, `maxValue?`): `number`
 
 Check the option to see if it exists and is a number.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
-• **minValue**: `number` = `0`
+##### minValue
+
+`number` = `0`
 
 The minimum value.
 
-• **maxValue?**: `number`
+##### maxValue?
+
+`number`
 
 The maximum value.
 
@@ -152,29 +180,39 @@ An error if the option is invalid.
 
 ### integer()
 
-> `static` **integer**(`optionName`, `optionValue`, `allowEnvVar`, `minValue`, `maxValue`?): `number`
+> `static` **integer**(`optionName`, `optionValue`, `allowEnvVar`, `minValue`, `maxValue?`): `number`
 
 Check the option to see if it exists and is an integer.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
-• **minValue**: `number` = `0`
+##### minValue
+
+`number` = `0`
 
 The minimum value.
 
-• **maxValue?**: `number`
+##### maxValue?
+
+`number`
 
 The maximum value.
 
@@ -192,29 +230,39 @@ An error if the option is invalid.
 
 ### bigint()
 
-> `static` **bigint**(`optionName`, `optionValue`, `allowEnvVar`, `minValue`, `maxValue`?): `bigint`
+> `static` **bigint**(`optionName`, `optionValue`, `allowEnvVar`, `minValue`, `maxValue?`): `bigint`
 
 Check the option to see if it exists and is a big number.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
-• **minValue**: `bigint` = `...`
+##### minValue
+
+`bigint` = `0n`
 
 The minimum value.
 
-• **maxValue?**: `bigint`
+##### maxValue?
+
+`bigint`
 
 The maximum value.
 
@@ -238,15 +286,21 @@ Check the option to see if it exists and is a boolean.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
@@ -270,15 +324,21 @@ Check the option to see if it exists and is hex.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
@@ -302,15 +362,21 @@ Check the option to see if it exists and is base64.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
@@ -334,15 +400,21 @@ Check the option to see if it exists and is hex or base64.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 
@@ -366,15 +438,21 @@ Check the option to see if it exists and is bech32.
 
 #### Parameters
 
-• **optionName**: `string`
+##### optionName
+
+`string`
 
 The name of the option.
 
-• **optionValue**: `undefined` \| `string`
+##### optionValue
 
 The option value.
 
-• **allowEnvVar**: `boolean` = `true`
+`undefined` | `string`
+
+##### allowEnvVar
+
+`boolean` = `true`
 
 Allow the option to be read from an env var.
 

package/docs/reference/classes/CLIUtils.md

@@ -4,13 +4,13 @@ Utilities function for helping in the CLI.
 
 ## Constructors
 
-### new CLIUtils()
+### Constructor
 
-> **new CLIUtils**(): [`CLIUtils`](CLIUtils.md)
+> **new CLIUtils**(): `CLIUtils`
 
 #### Returns
 
-[`CLIUtils`](CLIUtils.md)
+`CLIUtils`
 
 ## Methods
 
@@ -22,7 +22,9 @@ Does the specified file exist.
 
 #### Parameters
 
-• **filename**: `string`
+##### filename
+
+`string`
 
 The filename to check for existence.
 
@@ -42,7 +44,9 @@ Does the specified file exist, synchronously.
 
 #### Parameters
 
-• **filename**: `string`
+##### filename
+
+`string`
 
 The filename to check for existence.
 
@@ -62,7 +66,9 @@ Check if the dir exists.
 
 #### Parameters
 
-• **dir**: `string`
+##### dir
+
+`string`
 
 The directory to check.
 
@@ -82,7 +88,9 @@ Check if the dir exists, synchronously.
 
 #### Parameters
 
-• **dir**: `string`
+##### dir
+
+`string`
 
 The directory to check.
 
@@ -102,11 +110,15 @@ Read a JSON file and parse it.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
+
+`T` = `unknown`
 
 #### Parameters
 
-• **filename**: `string`
+##### filename
+
+`string`
 
 The filename to read.
 
@@ -126,11 +138,15 @@ Read a JSON file and parse it, synchronously.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
+
+`T` = `unknown`
 
 #### Parameters
 
-• **filename**: `string`
+##### filename
+
+`string`
 
 The filename to read.
 
@@ -150,7 +166,9 @@ Read a file as lines.
 
 #### Parameters
 
-• **filename**: `string`
+##### filename
+
+`string`
 
 The filename to read.
 
@@ -170,7 +188,9 @@ Read a file as lines, synchronously.
 
 #### Parameters
 
-• **filename**: `string`
+##### filename
+
+`string`
 
 The filename to read.
 
@@ -190,7 +210,9 @@ Find the NPM root based on a package.json path.
 
 #### Parameters
 
-• **rootFolder**: `string`
+##### rootFolder
+
+`string`
 
 The path to the package.json.
 
@@ -204,21 +226,61 @@ The root path.
 
 ### runShellCmd()
 
-> `static` **runShellCmd**(`app`, `args`, `cwd`): `Promise`\<`void`\>
+> `static` **runShellCmd**(`command`, `args`, `cwd`): `Promise`\<`void`\>
+
+Run a shell command.
+
+#### Parameters
+
+##### command
+
+`string`
+
+The app to run in the shell.
+
+##### args
+
+`string`[]
+
+The args for the app.
+
+##### cwd
+
+`string`
+
+The working directory to execute the command in.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise to wait for command execution to complete.
+
+***
+
+### runShellApp()
+
+> `static` **runShellApp**(`app`, `args`, `cwd`): `Promise`\<`void`\>
 
 Run a shell app.
 
 #### Parameters
 
-• **app**: `string`
+##### app
+
+`string`
 
 The app to run in the shell.
 
-• **args**: `string`[]
+##### args
+
+`string`[]
 
 The args for the app.
 
-• **cwd**: `string`
+##### cwd
+
+`string`
 
 The working directory to execute the command in.
 
@@ -238,19 +300,27 @@ Write a JSON file.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
+
+`T` = `unknown`
 
 #### Parameters
 
-• **jsonFilename**: `undefined` \| `string`
+##### jsonFilename
 
 The filename to write.
 
-• **data**: `T`
+`undefined` | `string`
+
+##### data
+
+`T`
 
 The data to write.
 
-• **append**: `boolean`
+##### append
+
+`boolean`
 
 Append to the file.
 
@@ -268,15 +338,21 @@ Write an env file.
 
 #### Parameters
 
-• **envFilename**: `undefined` \| `string`
+##### envFilename
 
 The filename to write.
 
-• **data**: `string`[]
+`undefined` | `string`
+
+##### data
+
+`string`[]
 
 The data to write.
 
-• **append**: `boolean`
+##### append
+
+`boolean`
 
 Append to the file.
 

package/docs/reference/functions/addGlobalOptions.md

@@ -6,15 +6,21 @@ Add the global options.
 
 ## Parameters
 
-• **program**: `Command`
+### program
+
+`Command`
 
 The program to add the options to.
 
-• **supportsLang**: `boolean`
+### supportsLang
+
+`boolean`
 
 Whether the CLI supports different languages.
 
-• **supportsEnvFiles**: `boolean`
+### supportsEnvFiles
+
+`boolean`
 
 Whether the CLI supports loading env files
 

package/docs/reference/functions/initGlobalOptions.md

@@ -6,7 +6,9 @@ Initialize the global options.
 
 ## Parameters
 
-• **localesDirectory**: `string`
+### localesDirectory
+
+`string`
 
 The path to load the locales from.
 

package/docs/reference/type-aliases/CliOutputOptions.md

@@ -1,5 +1,5 @@
 # Type Alias: CliOutputOptions
 
-> **CliOutputOptions**: [`ICliOutputOptionsConsole`](../interfaces/ICliOutputOptionsConsole.md) & [`ICliOutputOptionsEnv`](../interfaces/ICliOutputOptionsEnv.md) & [`ICliOutputOptionsJson`](../interfaces/ICliOutputOptionsJson.md)
+> **CliOutputOptions** = [`ICliOutputOptionsConsole`](../interfaces/ICliOutputOptionsConsole.md) & [`ICliOutputOptionsEnv`](../interfaces/ICliOutputOptionsEnv.md) & [`ICliOutputOptionsJson`](../interfaces/ICliOutputOptionsJson.md)
 
 Options for the CLI Output.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/cli-core",
-	"version": "0.0.1-next.6",
+	"version": "0.0.1-next.60",
 	"description": "Core classes for building a CLI",
 	"repository": {
 		"type": "git",
@@ -14,21 +14,21 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/core": "0.0.1-next.6",
-		"@twin.org/crypto": "0.0.1-next.6",
+		"@twin.org/core": "0.0.1-next.60",
+		"@twin.org/crypto": "0.0.1-next.60",
 		"@twin.org/nameof": "next",
-		"chalk": "5.3.0",
-		"commander": "12.1.0",
-		"dotenv": "16.4.5"
+		"chalk": "5.4.1",
+		"commander": "14.0.0",
+		"dotenv": "16.5.0"
 	},
 	"main": "./dist/cjs/index.cjs",
 	"module": "./dist/esm/index.mjs",
 	"types": "./dist/types/index.d.ts",
 	"exports": {
 		".": {
+			"types": "./dist/types/index.d.ts",
 			"require": "./dist/cjs/index.cjs",
-			"import": "./dist/esm/index.mjs",
-			"types": "./dist/types/index.d.ts"
+			"import": "./dist/esm/index.mjs"
 		}
 	},
 	"files": [