From 1c7222de6bc71ca0445296ad3a15425876dd1cd8 Mon Sep 17 00:00:00 2001
From: zaldih <imzaldih@gmail.com>
Date: Sun, 19 Oct 2025 22:39:22 +0200
Subject: [PATCH 1/2] fix(help): prevent empty lines in command descriptions

---
 src/cli/ui/components/help-command.ui.ts | 54 +++++++++++-------------
 1 file changed, 25 insertions(+), 29 deletions(-)

diff --git a/src/cli/ui/components/help-command.ui.ts b/src/cli/ui/components/help-command.ui.ts
index 0a067b2d..eaa3e5d5 100644
--- a/src/cli/ui/components/help-command.ui.ts
+++ b/src/cli/ui/components/help-command.ui.ts
@@ -1,4 +1,3 @@
-import ansiEscapes from 'ansi-escapes';
 import {
   HELP_HEADER,
   OPTIONS,
@@ -7,7 +6,6 @@ import {
 } from '../../../constants/cli.constants.js';
 import { MARGINS, UI_HELP } from '../../../constants/main.constants.js';
 import { INFO_MSGS } from '../../../constants/messages.constants.js';
-import { IPosition } from '../../interfaces/ui-positions.interface.js';
 import { ConsoleService } from '../../services/console.service.js';
 import { BaseUi } from '../base.ui.js';
 import colors from 'colors';
@@ -27,27 +25,37 @@ export class HelpCommandUi extends BaseUi {
     this.print(HELP_HEADER + '\n\n');
     this.print(HELP_PROGRESSBAR + '\n\n');
 
-    let lineCount = 0;
-    OPTIONS.forEach((option, index) => {
-      this.printAtHelp(
-        option.arg.reduce((text, arg) => text + ', ' + arg),
-        {
-          x: UI_HELP.X_COMMAND_OFFSET,
-          y: index + UI_HELP.Y_OFFSET + lineCount,
-        },
-      );
+    OPTIONS.forEach((option) => {
+      const args = option.arg.reduce((text, arg) => text + ', ' + arg);
+      const padding = ' '.repeat(UI_HELP.X_COMMAND_OFFSET);
+      const commandLength = UI_HELP.X_COMMAND_OFFSET + args.length;
+
+      const commandTooLong = commandLength >= UI_HELP.X_DESCRIPTION_OFFSET;
+
+      if (commandTooLong) {
+        this.print(padding + args + '\n');
+      } else {
+        this.print(padding + args);
+      }
+
       const description = this.consoleService.splitWordsByWidth(
         option.description,
         this.terminal.columns - UI_HELP.X_DESCRIPTION_OFFSET,
       );
 
-      description.forEach((line) => {
-        this.printAtHelp(line, {
-          x: UI_HELP.X_DESCRIPTION_OFFSET,
-          y: index + UI_HELP.Y_OFFSET + lineCount,
-        });
-        ++lineCount;
+      description.forEach((line, index) => {
+        if (index === 0 && !commandTooLong) {
+          const spaceBetween = ' '.repeat(
+            UI_HELP.X_DESCRIPTION_OFFSET - commandLength,
+          );
+          this.print(spaceBetween + line + '\n');
+        } else {
+          const descriptionPadding = ' '.repeat(UI_HELP.X_DESCRIPTION_OFFSET);
+          this.print(descriptionPadding + line + '\n');
+        }
       });
+
+      this.print('\n');
     });
 
     this.print(HELP_FOOTER + '\n');
@@ -58,16 +66,4 @@ export class HelpCommandUi extends BaseUi {
       this.clearLine(row);
     }
   }
-
-  private printAtHelp(message: string, position: IPosition): void {
-    this.setCursorAtHelp(position);
-    this.print(message);
-    if (!/-[a-zA-Z]/.test(message.substring(0, 2)) && message !== '') {
-      this.print('\n\n');
-    }
-  }
-
-  private setCursorAtHelp({ x }: IPosition): void {
-    this.print(ansiEscapes.cursorTo(x));
-  }
 }

From e9ba62d50eb81261581991e5a3cb549cace686c1 Mon Sep 17 00:00:00 2001
From: zaldih <imzaldih@gmail.com>
Date: Sun, 19 Oct 2025 22:53:42 +0200
Subject: [PATCH 2/2] fix(help): improve layout limiting width to 80 characters

---
 src/cli/ui/components/help-command.ui.ts | 31 +++++++++++++++++++++---
 src/constants/main.constants.ts          |  1 +
 2 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/src/cli/ui/components/help-command.ui.ts b/src/cli/ui/components/help-command.ui.ts
index eaa3e5d5..067c1029 100644
--- a/src/cli/ui/components/help-command.ui.ts
+++ b/src/cli/ui/components/help-command.ui.ts
@@ -20,10 +20,29 @@ export class HelpCommandUi extends BaseUi {
   }
 
   show(): void {
+    const maxWidth = Math.min(UI_HELP.MAX_WIDTH, this.terminal.columns);
+
     this.clear();
     this.print(colors.inverse(INFO_MSGS.HELP_TITLE + '\n\n'));
-    this.print(HELP_HEADER + '\n\n');
-    this.print(HELP_PROGRESSBAR + '\n\n');
+
+    const headerLines = this.consoleService.splitWordsByWidth(
+      HELP_HEADER,
+      maxWidth,
+    );
+    headerLines.forEach((line) => this.print(line + '\n'));
+    this.print('\n');
+
+    const progressBarLines = this.consoleService.splitWordsByWidth(
+      HELP_PROGRESSBAR,
+      maxWidth,
+    );
+    progressBarLines.forEach((line) => this.print(line + '\n'));
+    this.print('\n');
+
+    const maxDescriptionWidth = Math.min(
+      maxWidth - UI_HELP.X_DESCRIPTION_OFFSET,
+      this.terminal.columns - UI_HELP.X_DESCRIPTION_OFFSET,
+    );
 
     OPTIONS.forEach((option) => {
       const args = option.arg.reduce((text, arg) => text + ', ' + arg);
@@ -40,7 +59,7 @@ export class HelpCommandUi extends BaseUi {
 
       const description = this.consoleService.splitWordsByWidth(
         option.description,
-        this.terminal.columns - UI_HELP.X_DESCRIPTION_OFFSET,
+        maxDescriptionWidth,
       );
 
       description.forEach((line, index) => {
@@ -58,7 +77,11 @@ export class HelpCommandUi extends BaseUi {
       this.print('\n');
     });
 
-    this.print(HELP_FOOTER + '\n');
+    const footerLines = this.consoleService.splitWordsByWidth(
+      HELP_FOOTER,
+      maxWidth,
+    );
+    footerLines.forEach((line) => this.print(line + '\n'));
   }
 
   clear(): void {
diff --git a/src/constants/main.constants.ts b/src/constants/main.constants.ts
index b161d43c..45c0e9f3 100644
--- a/src/constants/main.constants.ts
+++ b/src/constants/main.constants.ts
@@ -37,6 +37,7 @@ export const UI_HELP = {
   X_COMMAND_OFFSET: 3,
   X_DESCRIPTION_OFFSET: 27,
   Y_OFFSET: 2,
+  MAX_WIDTH: 80,
 };
 
 export const UI_POSITIONS = {