@alcyone-labs/arg-parser 2.13.0 → 2.13.1

package/dist/index.min.mjs

@@ -3002,7 +3002,7 @@ class G {
   };
   #d;
   #b = !1;
-  #c;
+  #l;
   #p = !0;
   #m = !0;
   #y;
@@ -3023,7 +3023,7 @@ class G {
   #g = new sr();
   // Working directory management
   /** The effective working directory for this parser instance */
-  #l = null;
+  #c = null;
   /** The original root path from user's CLI invocation */
   #f = null;
   /** Tracks if effective working directory has been resolved */
@@ -3034,7 +3034,7 @@ class G {
         throwForDuplicateFlags: this.#b
       },
       t || []
-    ), this.#p = e.handleErrors ?? !0, this.#m = e.autoExit ?? !0, this.#u = e.inheritParentFlags ?? !1, this.#v = e.triggerAutoHelpIfNoHandler ?? !1, this.#c = e.description, this.#d = e.handler, this.#o = e.appCommandName, this.#e = e.logger || ne({
+    ), this.#p = e.handleErrors ?? !0, this.#m = e.autoExit ?? !0, this.#u = e.inheritParentFlags ?? !1, this.#v = e.triggerAutoHelpIfNoHandler ?? !1, this.#l = e.description, this.#d = e.handler, this.#o = e.appCommandName, this.#e = e.logger || ne({
       prefix: this.#t,
       mcpMode: !1
     });
@@ -3078,7 +3078,7 @@ class G {
     return this.#n;
   }
   getDescription() {
-    return this.#c;
+    return this.#l;
   }
   getAutoExit() {
     return this.#m;
@@ -3204,7 +3204,7 @@ class G {
       throw new Error(
         `Parser for subcommand '${e.name}' is not an instance of ArgParserBase. Please provide 'new ArgParserBase(...)' for the 'parser' property of an ISubCommand.`
       );
-    if (t.#y = this, t.#n = e.name, !t.#o && this.#o && (t.#o = this.#o), t.#m = this.#m, t.#v = this.#v, t.#u === !0 || t.#u === Ie.DirectParentOnly || t.#u === Ie.AllParents) {
+    if (t.#y = this, t.#n = e.name, !t.#o && this.#o && (t.#o = this.#o), e.description && (t.#l = e.description), t.#m = this.#m, t.#v = this.#v, t.#u === !0 || t.#u === Ie.DirectParentOnly || t.#u === Ie.AllParents) {
       const n = this.#r.flags;
       for (const o of n)
         t.#r.hasFlag(o.name) || t.#r._setProcessedFlagForInheritance(o);
@@ -3312,7 +3312,7 @@ class G {
             const u = e[c + 1];
             if (!u || u.startsWith("-")) continue;
             const f = w.resolve(
-              this.#l || this.#f,
+              this.#c || this.#f,
               u
             );
             if (!C.existsSync(f)) {
@@ -3359,7 +3359,7 @@ class G {
       e,
       r ? [this, r] : [this]
     );
-    this.#l = n, this.#f = o, this.#$ = !0;
+    this.#c = n, this.#f = o, this.#$ = !0;
     const s = !this.#y && !!this.#o;
     if (e.length === 0 && s && !this.#d && !t?.skipHelpHandling)
       return this.#e.info(this.helpText()), this._handleExit(0, "Help displayed", "help");
@@ -3373,19 +3373,19 @@ class G {
     const a = e.findIndex((p) => p === "--s-with-env");
     if (a !== -1) {
       let p = null, $;
-      if ($ = this.#$ && this.#l !== this.#f && a + 1 >= e.length, a + 1 < e.length) {
+      if ($ = this.#$ && this.#c !== this.#f && a + 1 >= e.length, a + 1 < e.length) {
         const g = e[a + 1];
         if (g && !g.startsWith("-")) {
-          const h = this.#l || process.cwd();
+          const h = this.#c || process.cwd();
           p = w.resolve(h, g);
         } else if ($) {
-          const h = this.#l || process.cwd();
+          const h = this.#c || process.cwd();
           p = this.#i.discoverEnvFile(h), p || (console.warn(
             "Warning: No .env file found in working directory. Continuing without environment configuration."
           ), e.splice(a, 1));
         }
       } else if ($) {
-        const g = this.#l || process.cwd();
+        const g = this.#c || process.cwd();
         p = this.#i.discoverEnvFile(g), console.warn(p ? `Auto-discovered env file: ${p}` : "Warning: No .env file found in working directory. Continuing without environment configuration.");
       }
       if (p)
@@ -3424,7 +3424,7 @@ class G {
           );
         }
       if ($) {
-        const g = this.#l || process.cwd();
+        const g = this.#c || process.cwd();
         p = this.#i.discoverEnvFile(g), console.warn(p ? `Auto-discovered env file: ${p}` : "Warning: No .env file found in working directory. Continuing without environment configuration.");
       }
       if (p)
@@ -3460,16 +3460,16 @@ class G {
             "error"
           );
         }
-      if ($ = this.#$ && this.#l !== this.#f && a + 1 >= e.length, $) {
-        const g = this.#l || process.cwd();
+      if ($ = this.#$ && this.#c !== this.#f && a + 1 >= e.length, $) {
+        const g = this.#c || process.cwd();
         p = this.#i.discoverEnvFile(g), console.warn(p ? `Auto-discovered env file: ${p}` : "Warning: No .env file found in working directory. Continuing without environment configuration."), p || e.splice(a, 1);
       }
     }
     const l = e.some(
       (p) => p === "--s-with-env"
     );
-    if (this.#$ && this.#l !== this.#f && !l) {
-      const p = this.#l || process.cwd(), $ = this.#i.discoverEnvFile(p);
+    if (this.#$ && this.#c !== this.#f && !l) {
+      const p = this.#c || process.cwd(), $ = this.#i.discoverEnvFile(p);
       if ($) {
         console.warn(`Auto-discovered env file: ${$}`), Pt.config({
           path: $,
@@ -4050,7 +4050,7 @@ Arguments Remaining After Simulation:`)
     let c = `${e(`${l} Help`)} (${this.#a.mandatoryCharacter} = Mandatory fields):
 
 `;
-    this.#c && (c += `${r(this.#c)}
+    this.#l && (c += `${r(this.#l)}
 
 `);
     const u = (m = 1) => "  ".repeat(m), f = this.#r.flags.filter(
@@ -4073,7 +4073,7 @@ Arguments Remaining After Simulation:`)
       if (!(p instanceof G))
         return `${u()}${t(m.padEnd(20))} [Error: Subcommand '${m}' has an invalid parser configuration]`;
       let $ = `${u()}${t(m)}`;
-      const g = p.#c;
+      const g = p.#l;
       g && ($ += `
 ${u(2)}${r(g)}`);
       const v = ((p && p.#r ? p.#r.flags : void 0) || []).filter(
@@ -4227,7 +4227,7 @@ ${y.dim(`Try '${t} --help' for usage details.`)}`
     const n = "  ".repeat(t), o = "  ".repeat(t + 1), s = "  ".repeat(t + 2);
     this.#e.info(
       `${n}Parser: ${y.blueBright(e.#n || e.#t)}`
-    ), e.#c && this.#e.info(`${o}Description: ${e.#c}`), this.#e.info(`${o}Options:`), this.#e.info(`${s}appName: ${e.#t}`), this.#e.info(
+    ), e.#l && this.#e.info(`${o}Description: ${e.#l}`), this.#e.info(`${o}Options:`), this.#e.info(`${s}appName: ${e.#t}`), this.#e.info(
       `${s}appCommandName: ${e.#o ?? y.dim("undefined")}`
     ), this.#e.info(`${s}handleErrors: ${e.#p}`), this.#e.info(
       `${s}throwForDuplicateFlags: ${e.#b}`
@@ -4275,7 +4275,7 @@ ${y.dim(`Try '${t} --help' for usage details.`)}`
     l(
       `${o}Parser: ${e.#n || e.#t}`
       // #appName is guaranteed
-    ), e.#c && l(`${s}Description: ${e.#c}`), l(`${s}Options:`), l(`${a}appName: ${e.#t}`), l(
+    ), e.#l && l(`${s}Description: ${e.#l}`), l(`${s}Options:`), l(`${a}appName: ${e.#t}`), l(
       `${a}appCommandName: ${e.#o ?? "undefined"}`
     ), l(`${a}handleErrors: ${e.#p}`), l(
       `${a}throwForDuplicateFlags: ${e.#b}`
@@ -4326,7 +4326,7 @@ ${y.dim(`Try '${t} --help' for usage details.`)}`
     const r = {
       parserName: e.#n || e.#t,
       // #appName is guaranteed
-      description: e.#c,
+      description: e.#l,
       options: {
         appName: e.#t,
         appCommandName: e.#o ?? void 0,