@nmakarov/cli-toolkit 0.27.0 → 0.29.0

package/dist/init.cjs

@@ -1759,7 +1759,8 @@ var Params = class _Params {
   /**
    * Resolved early in constructor so cleanup does not read params lazily.
    * One of: false (off) | "end" (print at exit) | "top" (print after init,
-   * via context.showUsedParamsIfNeeded()).
+   * via context.showUsedParamsIfNeeded()) | "stop" (print after init, then
+   * exit the process — also via context.showUsedParamsIfNeeded()).
    */
   _showUsedParamsMode = false;
   /** Guard so the dump prints at most once (top OR end, never both). */
@@ -1783,8 +1784,9 @@ var Params = class _Params {
    *   (absent) / --no-showUsedParams / =false   -> false  (off)
    *   --showUsedParams / =true                   -> "end"  (print at exit)
    *   --showUsedParams=top                       -> "top"  (print after init)
-   * Read raw (uncoerced) from args so the string "top" isn't forced to a
-   * boolean, then track it under the "script" module for the dump itself.
+   *   --showUsedParams=stop                      -> "stop" (print after init, then exit)
+   * Read raw (uncoerced) from args so the string "top"/"stop" isn't forced to
+   * a boolean, then track it under the "script" module for the dump itself.
    */
   _resolveShowUsedParams() {
     const raw = this.args.get("showUsedParams");
@@ -1794,6 +1796,8 @@ var Params = class _Params {
       mode = false;
     } else if (typeof raw === "string" && raw.trim().toLowerCase() === "top") {
       mode = "top";
+    } else if (typeof raw === "string" && raw.trim().toLowerCase() === "stop") {
+      mode = "stop";
     } else {
       const s = typeof raw === "string" ? raw.trim().toLowerCase() : raw;
       const falsey = s === false || s === "false" || s === "0" || s === "no" || s === "off";
@@ -1807,7 +1811,7 @@ var Params = class _Params {
   getShowUsedParams() {
     return this._showUsedParamsMode !== false;
   }
-  /** Resolved mode: false | "end" | "top". */
+  /** Resolved mode: false | "end" | "top" | "stop". */
   getShowUsedParamsMode() {
     return this._showUsedParamsMode;
   }
@@ -2522,9 +2526,18 @@ function setup(opts = {}) {
     // the used-params list now (after the script has initialized all its
     // own components), instead of at exit. No-op for the default mode,
     // which prints at exit via the cleanup registered by Params.
+    //
+    // --showUsedParams=stop behaves like "top" but then exits immediately —
+    // a quick "show me the figured params and quit" that skips the flow's
+    // actual work. Like --stopAfter=init, this is a hard exit(0) (registered
+    // cleanups are skipped); call it once components/params are resolved.
     showUsedParamsIfNeeded: () => {
-      if (params.getShowUsedParamsMode?.() === "top") {
-        params.printUsedParams(logger);
+      const mode = params.getShowUsedParamsMode?.();
+      if (mode !== "top" && mode !== "stop") return;
+      params.printUsedParams(logger);
+      if (mode === "stop") {
+        logger.debug?.("[showUsedParams=stop] params printed \u2014 exiting");
+        process.exit(0);
       }
     }
   };