@twin.org/cli-core 0.0.2-next.4 → 0.0.2-next.5

package/dist/cjs/index.cjs

@@ -139,6 +139,15 @@ class CLIDisplay {
         CLIDisplay.write(node_util.inspect(obj, false, undefined, true));
         CLIDisplay.write("\n");
     }
+    /**
+     * Display a warning.
+     * @param label The label for the warning.
+     */
+    static warning(label) {
+        CLIDisplay.write("⚠️  ");
+        CLIDisplay.write(chalk.hex("#FFA500").bold(label));
+        CLIDisplay.write("\n\n");
+    }
     /**
      * Display the processing is done.
      */
@@ -443,7 +452,7 @@ function handleGlobalOptions(command) {
         const resolvedEnv = loadEnv.map(e => path.resolve(e));
         CLIDisplay.task(core.I18n.formatMessage("cli.progress.loadingEnvFiles"), resolvedEnv.join(", "));
         CLIDisplay.break();
-        dotenv__namespace.config({ path: resolvedEnv });
+        dotenv__namespace.config({ path: resolvedEnv, quiet: true });
     }
 }
 /**
@@ -510,6 +519,9 @@ class CLIBase {
                 // eslint-disable-next-line no-restricted-syntax
                 throw new Error(err.code === "commander.help" ? "0" : err.exitCode.toString());
             });
+            if (options.showDevToolWarning ?? false) {
+                program.hook("preAction", () => CLIDisplay.warning(core.I18n.formatMessage("warn.common.devOnlyTool")));
+            }
             this.configureRoot(program);
             addGlobalOptions(program, options.supportsLang ?? true, options.supportsEnvFiles ?? false);
             // We parse the options before building the command

package/dist/esm/index.mjs

@@ -118,6 +118,15 @@ class CLIDisplay {
         CLIDisplay.write(inspect(obj, false, undefined, true));
         CLIDisplay.write("\n");
     }
+    /**
+     * Display a warning.
+     * @param label The label for the warning.
+     */
+    static warning(label) {
+        CLIDisplay.write("⚠️  ");
+        CLIDisplay.write(chalk.hex("#FFA500").bold(label));
+        CLIDisplay.write("\n\n");
+    }
     /**
      * Display the processing is done.
      */
@@ -422,7 +431,7 @@ function handleGlobalOptions(command) {
         const resolvedEnv = loadEnv.map(e => path.resolve(e));
         CLIDisplay.task(I18n.formatMessage("cli.progress.loadingEnvFiles"), resolvedEnv.join(", "));
         CLIDisplay.break();
-        dotenv.config({ path: resolvedEnv });
+        dotenv.config({ path: resolvedEnv, quiet: true });
     }
 }
 /**
@@ -489,6 +498,9 @@ class CLIBase {
                 // eslint-disable-next-line no-restricted-syntax
                 throw new Error(err.code === "commander.help" ? "0" : err.exitCode.toString());
             });
+            if (options.showDevToolWarning ?? false) {
+                program.hook("preAction", () => CLIDisplay.warning(I18n.formatMessage("warn.common.devOnlyTool")));
+            }
             this.configureRoot(program);
             addGlobalOptions(program, options.supportsLang ?? true, options.supportsEnvFiles ?? false);
             // We parse the options before building the command

package/dist/types/cliDisplay.d.ts

@@ -56,6 +56,11 @@ export declare class CLIDisplay {
      * @param obj The object to display.
      */
     static json(obj: unknown): void;
+    /**
+     * Display a warning.
+     * @param label The label for the warning.
+     */
+    static warning(label: string): void;
     /**
      * Display the processing is done.
      */

package/dist/types/models/ICliOptions.d.ts

@@ -30,4 +30,8 @@ export interface ICliOptions {
      * Override the default output width.
      */
     overrideOutputWidth?: number;
+    /**
+     * Show a warning that this is a dev tool and not for production use.
+     */
+    showDevToolWarning?: boolean;
 }

package/docs/changelog.md

@@ -1,5 +1,24 @@
 # @twin.org/cli-core - Changelog
 
+## [0.0.2-next.5](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.2-next.4...cli-core-v0.0.2-next.5) (2025-08-19)
+
+
+### Features
+
+* use cause instead of inner for errors ([1f4acc4](https://github.com/twinfoundation/framework/commit/1f4acc4d7a6b71a134d9547da9bf40de1e1e49da))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.2-next.4 to 0.0.2-next.5
+    * @twin.org/crypto bumped from 0.0.2-next.4 to 0.0.2-next.5
+    * @twin.org/nameof bumped from 0.0.2-next.4 to 0.0.2-next.5
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.4 to 0.0.2-next.5
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.4 to 0.0.2-next.5
+
 ## [0.0.2-next.4](https://github.com/twinfoundation/framework/compare/cli-core-v0.0.2-next.3...cli-core-v0.0.2-next.4) (2025-08-15)
 
 

package/docs/reference/classes/CLIBase.md

@@ -1,4 +1,4 @@
-# Class: `abstract` CLIBase
+# Abstract Class: CLIBase
 
 The main entry point for the CLI.
 

package/docs/reference/classes/CLIDisplay.md

@@ -234,6 +234,26 @@ The object to display.
 
 ***
 
+### warning()
+
+> `static` **warning**(`label`): `void`
+
+Display a warning.
+
+#### Parameters
+
+##### label
+
+`string`
+
+The label for the warning.
+
+#### Returns
+
+`void`
+
+***
+
 ### done()
 
 > `static` **done**(): `void`

package/docs/reference/interfaces/ICliOptions.md

@@ -57,3 +57,11 @@ Supports the loading of env files.
 > `optional` **overrideOutputWidth**: `number`
 
 Override the default output width.
+
+***
+
+### showDevToolWarning?
+
+> `optional` **showDevToolWarning**: `boolean`
+
+Show a warning that this is a dev tool and not for production use.

package/locales/en.json

@@ -12,6 +12,11 @@
 			}
 		}
 	},
+	"warn": {
+		"common": {
+			"devOnlyTool": "This tool is intended to be used for development purposes, it is not recommended for use in production scenarios."
+		}
+	},
 	"cli": {
 		"progress": {
 			"done": "Done.",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/cli-core",
-	"version": "0.0.2-next.4",
+	"version": "0.0.2-next.5",
 	"description": "Core classes for building a CLI",
 	"repository": {
 		"type": "git",
@@ -14,12 +14,12 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/core": "0.0.2-next.4",
-		"@twin.org/crypto": "0.0.2-next.4",
-		"@twin.org/nameof": "0.0.2-next.4",
-		"chalk": "5.4.1",
+		"@twin.org/core": "0.0.2-next.5",
+		"@twin.org/crypto": "0.0.2-next.5",
+		"@twin.org/nameof": "0.0.2-next.5",
+		"chalk": "5.6.0",
 		"commander": "14.0.0",
-		"dotenv": "17.2.0"
+		"dotenv": "17.2.1"
 	},
 	"main": "./dist/cjs/index.cjs",
 	"module": "./dist/esm/index.mjs",