@windagency/valora 2.0.1

package/dist/output/diagnostic-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-formatter.js","sourceRoot":"","sources":["../../src/output/diagnostic-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,OAAO,mBAAmB;IAC/B;;OAEG;IACH,YAAY;QACX,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,wCAAwC,CAAC;QAEvD,OAAO,eAAe,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAwB;QAChD,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,WAAW,GAAqC;YACrD,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YACpB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;YACtB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;SACvB,CAAC;QAEF,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAY,EAAE,MAAwB;QAClD,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAEjE,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAA0D;QACvE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAErD,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;YACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,OAA0D;QACxE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAEnE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,aAAa,QAAQ,CAAC,MAAM,GAAG,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,aAAa,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE;YAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAA0D;QACtE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAEjE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,WAAW,MAAM,CAAC,MAAM,GAAG,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE;YAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAA0D;QACvE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAExE,2DAA2D;QAC3D,MAAM,cAAc,GAIf;YACJ;gBACC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC;gBAC/C,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC;gBACrD,OAAO,EAAE,GAAG,EAAE,CAAC,qBAAqB;aACpC;YACD;gBACC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,CAAC;gBAC7B,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC;gBACtD,OAAO,EAAE,GAAG,EAAE,CAAC,wBAAwB,QAAQ,WAAW,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;aACpF;YACD;gBACC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,eAAe;gBACtC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC;gBACnD,OAAO,EAAE,GAAG,EAAE,CAAC,wBAAwB,MAAM,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;aAC9E;SACD,CAAC;QAEF,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAE,CAAC;QAC7E,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;QAE9C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEjD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;QAEnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CACT,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,YAAY,QAAQ,cAAc,MAAM,YAAY,OAAO,CAAC,MAAM,gBAAgB,CAAC,CACzG,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,sDAAsD;QACtD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;QACxE,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CACT,KAAK,CAAC,IAAI,CAAC,8CAA8C,YAAY,SAAS,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAC5G,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAA0D;QACtE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QAExC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAA0D;QACtE,OAAO,IAAI,CAAC,SAAS,CACpB;YACC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,KAAK;gBAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;gBACzB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;gBACvB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU;aAC/B,CAAC,CAAC;YACH,OAAO,EAAE;gBACR,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;gBAChE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;gBAChE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;aAClE;SACD,EACD,IAAI,EACJ,CAAC,CACD,CAAC;IACH,CAAC;CACD;AAED;;GAEG;AACH,IAAI,iBAAiB,GAA+B,IAAI,CAAC;AAEzD,MAAM,UAAU,sBAAsB;IACrC,iBAAiB,KAAK,IAAI,mBAAmB,EAAE,CAAC;IAChD,OAAO,iBAAiB,CAAC;AAC1B,CAAC"}

package/dist/output/header-formatter.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Header Formatter Service
+ *
+ * Centralized service for creating consistent, formatted headers throughout the CLI.
+ * Follows dependency injection pattern and separation of concerns.
+ *
+ * Provides:
+ * - Box-drawing headers with customizable width and styling
+ * - Single or multi-line headers (title, subtitle, etc.)
+ * - Consistent padding and alignment
+ * - Color theming support
+ */
+import { type Color } from './color-adapter.interface.js';
+/**
+ * Color options for header styling
+ * Re-export from ColorAdapter for backward compatibility
+ */
+export type HeaderColor = Color;
+/**
+ * Options for header formatting
+ */
+export interface HeaderOptions {
+    /**
+     * Primary color for box borders and title
+     * @default 'cyan'
+     */
+    color?: HeaderColor;
+    /**
+     * Maximum width of the header box
+     * If not specified, auto-calculates based on content
+     * @default auto-calculated from content
+     */
+    width?: number;
+    /**
+     * Minimum width of the header box
+     * @default 40
+     */
+    minWidth?: number;
+    /**
+     * Maximum width of the header box
+     * @default 70
+     */
+    maxWidth?: number;
+    /**
+     * Padding on each side of content
+     * @default 4
+     */
+    padding?: number;
+    /**
+     * Whether to make the title bold
+     * @default true
+     */
+    bold?: boolean;
+    /**
+     * Whether to center-align text
+     * @default true
+     */
+    centered?: boolean;
+}
+/**
+ * Header Formatter Service
+ *
+ * Provides consistent header formatting across the CLI application.
+ */
+export declare class HeaderFormatter {
+    private readonly defaultOptions;
+    /**
+     * Format a simple header with a single title
+     *
+     * @param title - The main header text
+     * @param options - Formatting options
+     * @returns Formatted header string ready for console output
+     *
+     * @example
+     * const header = formatter.formatHeader('My App');
+     * console.log(header);
+     * // ╔════════════════╗
+     * // ║    My App      ║
+     * // ╚════════════════╝
+     */
+    formatHeader(title: string, options?: HeaderOptions): string;
+    /**
+     * Format a header with multiple lines of text
+     *
+     * @param lines - Array of text lines to display
+     * @param options - Formatting options
+     * @returns Formatted header string ready for console output
+     *
+     * @example
+     * const header = formatter.formatMultiLineHeader(['Title', 'Line 2', 'Line 3']);
+     * console.log(header);
+     */
+    formatMultiLineHeader(lines: string[], options?: HeaderOptions): string;
+    /**
+     * Format a simple separator line
+     *
+     * @param width - Width of the separator
+     * @param options - Formatting options
+     * @returns Formatted separator string
+     */
+    formatSeparator(width?: number, options?: Pick<HeaderOptions, 'color'>): string;
+    /**
+     * Display a header directly to console
+     *
+     * @param title - The main header text
+     * @param options - Formatting options
+     */
+    displayHeader(title: string, options?: HeaderOptions): void;
+    /**
+     * Wrap text to fit within a maximum width
+     */
+    private wrapText;
+    /**
+     * Build a header box with styled content lines
+     * Core method that handles box-drawing logic for all header types
+     *
+     * @param styledLines - Array of lines with their styling functions
+     * @param opts - Merged header options
+     * @returns Formatted header string
+     */
+    private buildHeaderBox;
+    /**
+     * Center-align text within a given width
+     */
+    private centerText;
+    /**
+     * Left-align text with padding
+     */
+    private leftAlignText;
+    /**
+     * Get color function by name using the ColorAdapter
+     */
+    private getColorFunction;
+}
+/**
+ * Get singleton header formatter instance
+ *
+ * @returns HeaderFormatter instance
+ *
+ * @example
+ * import { getHeaderFormatter } from './header-formatter.js';
+ *
+ * const formatter = getHeaderFormatter();
+ * console.log(formatter.formatHeader('My Title'));
+ */
+export declare function getHeaderFormatter(): HeaderFormatter;
+//# sourceMappingURL=header-formatter.d.ts.map

package/dist/output/header-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-formatter.d.ts","sourceRoot":"","sources":["../../src/output/header-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAmB,MAAM,2BAA2B,CAAC;AAGxE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAQ7B;IAEF;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAI5D;;;;;;;;;;OAUG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAwBvE;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,GAAE,MAAW,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM;IAKnF;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAI3D;;OAEG;IACH,OAAO,CAAC,QAAQ;IA2BhB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAuCtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAexB;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD"}

package/dist/output/header-formatter.js

@@ -0,0 +1,232 @@
+/**
+ * Header Formatter Service
+ *
+ * Centralized service for creating consistent, formatted headers throughout the CLI.
+ * Follows dependency injection pattern and separation of concerns.
+ *
+ * Provides:
+ * - Box-drawing headers with customizable width and styling
+ * - Single or multi-line headers (title, subtitle, etc.)
+ * - Consistent padding and alignment
+ * - Color theming support
+ */
+import { getColorAdapter } from './color-adapter.interface.js';
+import { getConsoleOutput } from './console-output.js';
+/**
+ * Header Formatter Service
+ *
+ * Provides consistent header formatting across the CLI application.
+ */
+export class HeaderFormatter {
+    defaultOptions = {
+        bold: true,
+        centered: true,
+        color: 'cyan',
+        maxWidth: 70,
+        minWidth: 40,
+        padding: 4,
+        width: 0 // 0 means auto-calculate
+    };
+    /**
+     * Format a simple header with a single title
+     *
+     * @param title - The main header text
+     * @param options - Formatting options
+     * @returns Formatted header string ready for console output
+     *
+     * @example
+     * const header = formatter.formatHeader('My App');
+     * console.log(header);
+     * // ╔════════════════╗
+     * // ║    My App      ║
+     * // ╚════════════════╝
+     */
+    formatHeader(title, options) {
+        return this.formatMultiLineHeader([title], options);
+    }
+    /**
+     * Format a header with multiple lines of text
+     *
+     * @param lines - Array of text lines to display
+     * @param options - Formatting options
+     * @returns Formatted header string ready for console output
+     *
+     * @example
+     * const header = formatter.formatMultiLineHeader(['Title', 'Line 2', 'Line 3']);
+     * console.log(header);
+     */
+    formatMultiLineHeader(lines, options) {
+        const opts = { ...this.defaultOptions, ...options };
+        const colorAdapter = getColorAdapter();
+        // Determine styling function based on options
+        const styleFn = opts.bold ? (text) => colorAdapter.bold(text) : (text) => text;
+        // ENFORCE: First line uses cyan color only when no color option is explicitly passed
+        const shouldEnforceCyan = !options?.color && lines.length > 0;
+        // Prepare styled content lines with uniform styling
+        const styledLines = lines.map((text, index) => ({
+            colorFn: index === 0 && shouldEnforceCyan
+                ? opts.bold
+                    ? (text) => colorAdapter.cyan(colorAdapter.bold(text))
+                    : (text) => colorAdapter.cyan(text)
+                : styleFn,
+            text
+        }));
+        return this.buildHeaderBox(styledLines, opts);
+    }
+    /**
+     * Format a simple separator line
+     *
+     * @param width - Width of the separator
+     * @param options - Formatting options
+     * @returns Formatted separator string
+     */
+    formatSeparator(width = 60, options) {
+        const colorFn = this.getColorFunction(options?.color ?? 'gray');
+        return colorFn('─'.repeat(width));
+    }
+    /**
+     * Display a header directly to console
+     *
+     * @param title - The main header text
+     * @param options - Formatting options
+     */
+    displayHeader(title, options) {
+        getConsoleOutput().print(this.formatHeader(title, options));
+    }
+    /**
+     * Wrap text to fit within a maximum width
+     */
+    wrapText(text, maxWidth) {
+        if (text.length <= maxWidth) {
+            return [text];
+        }
+        const words = text.split(' ');
+        const lines = [];
+        let currentLine = '';
+        for (const word of words) {
+            if (currentLine.length === 0) {
+                currentLine = word;
+            }
+            else if (currentLine.length + 1 + word.length <= maxWidth) {
+                currentLine += ' ' + word;
+            }
+            else {
+                lines.push(currentLine);
+                currentLine = word;
+            }
+        }
+        if (currentLine.length > 0) {
+            lines.push(currentLine);
+        }
+        return lines;
+    }
+    /**
+     * Build a header box with styled content lines
+     * Core method that handles box-drawing logic for all header types
+     *
+     * @param styledLines - Array of lines with their styling functions
+     * @param opts - Merged header options
+     * @returns Formatted header string
+     */
+    buildHeaderBox(styledLines, opts) {
+        // Calculate available content width (inner box width minus padding)
+        const innerContentWidth = opts.maxWidth - opts.padding * 2;
+        // Wrap lines that exceed the inner content width
+        const wrappedLines = [];
+        for (const line of styledLines) {
+            const wrapped = this.wrapText(line.text, innerContentWidth);
+            for (const wrappedText of wrapped) {
+                wrappedLines.push({ colorFn: line.colorFn, text: wrappedText });
+            }
+        }
+        // Calculate width based on longest wrapped line
+        const contentWidth = Math.max(...wrappedLines.map((line) => line.text.length));
+        const calculatedWidth = contentWidth + opts.padding * 2;
+        // Ensure box fits content - don't cap at maxWidth if content is wider
+        const width = opts.width || Math.max(opts.minWidth, calculatedWidth);
+        // Get color function for borders
+        const borderColorFn = this.getColorFunction(opts.color);
+        // Build header using functional composition
+        const topBorder = borderColorFn('╔' + '═'.repeat(width) + '╗');
+        const bottomBorder = borderColorFn('╚' + '═'.repeat(width) + '╝');
+        const contentLines = wrappedLines.map(({ colorFn, text }) => {
+            const content = opts.centered
+                ? this.centerText(text, width, false, colorFn)
+                : this.leftAlignText(text, width, false, colorFn);
+            return borderColorFn('║') + content + borderColorFn('║');
+        });
+        return '\n' + [topBorder, ...contentLines, bottomBorder].join('\n') + '\n';
+    }
+    /**
+     * Center-align text within a given width
+     */
+    centerText(text, width, bold, colorFn) {
+        const padding = Math.max(0, Math.round((width - text.length) / 2));
+        const paddingStr = ' '.repeat(padding);
+        const remainingPadding = width - text.length - padding;
+        const remainingPaddingStr = ' '.repeat(Math.max(0, remainingPadding));
+        const colorAdapter = getColorAdapter();
+        const styleStrategies = {
+            default: () => text,
+            withBold: () => colorAdapter.bold(text),
+            withColor: () => colorFn(text)
+        };
+        const strategy = colorFn ? 'withColor' : bold ? 'withBold' : 'default';
+        const styleFn = styleStrategies[strategy];
+        const styledText = styleFn ? styleFn() : text;
+        return paddingStr + styledText + remainingPaddingStr;
+    }
+    /**
+     * Left-align text with padding
+     */
+    leftAlignText(text, width, bold, colorFn) {
+        const colorAdapter = getColorAdapter();
+        const styleStrategies = {
+            default: () => text,
+            withBold: () => colorAdapter.bold(text),
+            withColor: () => colorFn(text)
+        };
+        const strategy = colorFn ? 'withColor' : bold ? 'withBold' : 'default';
+        const styleFn = styleStrategies[strategy];
+        const styledText = styleFn ? styleFn() : text;
+        const padding = ' '.repeat(Math.max(0, width - text.length - 2));
+        return '  ' + styledText + padding;
+    }
+    /**
+     * Get color function by name using the ColorAdapter
+     */
+    getColorFunction(color) {
+        const colorAdapter = getColorAdapter();
+        const colorMap = {
+            blue: (text) => colorAdapter.blue(text),
+            cyan: (text) => colorAdapter.cyan(text),
+            gray: (text) => colorAdapter.gray(text),
+            green: (text) => colorAdapter.green(text),
+            magenta: (text) => colorAdapter.magenta(text),
+            red: (text) => colorAdapter.red(text),
+            white: (text) => colorAdapter.white(text),
+            yellow: (text) => colorAdapter.yellow(text)
+        };
+        return colorMap[color] || ((text) => colorAdapter.cyan(text));
+    }
+}
+/**
+ * Singleton instance
+ */
+let instance = null;
+/**
+ * Get singleton header formatter instance
+ *
+ * @returns HeaderFormatter instance
+ *
+ * @example
+ * import { getHeaderFormatter } from './header-formatter.js';
+ *
+ * const formatter = getHeaderFormatter();
+ * console.log(formatter.formatHeader('My Title'));
+ */
+export function getHeaderFormatter() {
+    instance ??= new HeaderFormatter();
+    return instance;
+}
+//# sourceMappingURL=header-formatter.js.map

package/dist/output/header-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-formatter.js","sourceRoot":"","sources":["../../src/output/header-formatter.ts"],"names":[],"mappings":"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"}

package/dist/output/help-formatter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Rich formatting utilities for help output using box-drawing characters
+ */
+import { type CommandHelp, type SubcommandHelp } from '../utils/help-content.js';
+export declare class HelpFormatter {
+    /**
+     * Format the help header with box
+     */
+    formatHeader(title: string, subtitle?: string): string;
+    /**
+     * Format a section header
+     */
+    formatSection(title: string): string;
+    /**
+     * Format workflow phase indicator
+     */
+    formatWorkflowPhase(phase: string): string;
+    /**
+     * Get color function by name using object lookup
+     */
+    private getColorFunction;
+    /**
+     * Format command usage
+     */
+    formatUsage(commandName: string, argumentHint?: string): string;
+    /**
+     * Format examples section
+     */
+    formatExamples(examples: Array<{
+        code: string;
+        description: string;
+    }>): string;
+    /**
+     * Format options section
+     */
+    formatOptions(options: Array<{
+        default?: string;
+        description: string;
+        flag: string;
+    }>): string;
+    /**
+     * Format related commands as a tree
+     */
+    formatRelatedCommands(relatedCommands: string[]): string;
+    /**
+     * Format agent information
+     */
+    formatAgent(agent: string): string;
+    /**
+     * Format subcommands section
+     */
+    formatSubcommands(subcommands: SubcommandHelp[], parentCommand: string): string;
+    /**
+     * Format global flags section
+     */
+    formatGlobalFlags(): string;
+    /**
+     * Format common global flags for command help (subset of most useful flags)
+     */
+    formatCommonGlobalFlags(): string;
+    /**
+     * Format full command help
+     */
+    formatCommandHelp(help: CommandHelp): string;
+    /**
+     * Format command list
+     */
+    formatCommandList(commands: string[]): string;
+    /**
+     * Format search results
+     */
+    formatSearchResults(results: CommandHelp[]): string;
+    /**
+     * Format help overview (when no command specified)
+     */
+    formatOverview(): string;
+}
+export declare function getHelpFormatter(): HelpFormatter;
+//# sourceMappingURL=help-formatter.d.ts.map

package/dist/output/help-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-formatter.d.ts","sourceRoot":"","sources":["../../src/output/help-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,WAAW,EAA4B,KAAK,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AAKtH,qBAAa,aAAa;IACzB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAQtD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMpC;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQ1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAM/D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM;IAW9E;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM;IAgB9F;;OAEG;IACH,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM;IAgBxD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQlC;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAwB/E;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAgB3B;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAiBjC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IAsE5C;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAoB7C;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM;IAmBnD;;OAEG;IACH,cAAc,IAAI,MAAM;CA+GxB;AAOD,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD"}