@windagency/valora 2.0.1

package/dist/output/cleanup-scheduler.js

@@ -0,0 +1,115 @@
+/**
+ * Automated cleanup scheduler service
+ * Runs log cleanup operations on a configurable schedule
+ */
+import { BYTES_PER_MB } from '../config/constants.js';
+import { BaseCleanupScheduler } from '../utils/base-cleanup-scheduler.js';
+import { formatErrorMessage } from '../utils/error-handler.js';
+export class CleanupScheduler extends BaseCleanupScheduler {
+    retentionManager;
+    constructor(retentionManager, schedule) {
+        super(schedule, 'Log cleanup scheduler');
+        this.retentionManager = retentionManager;
+    }
+    /**
+     * Run cleanup on all configured directories
+     */
+    async runCleanup() {
+        if (!this.isRunning)
+            return;
+        const startTime = Date.now();
+        this.logger.debug('Running scheduled log cleanup');
+        // Process all directories in parallel
+        const results = await Promise.allSettled(this.schedule.logDirs.map(async (logDir) => {
+            const result = await this.retentionManager.cleanup(logDir);
+            if (result.errors.length > 0) {
+                this.logger.warn('Cleanup completed with errors', {
+                    compressedCount: result.compressedFiles.length,
+                    deletedCount: result.deletedFiles.length,
+                    errorCount: result.errors.length,
+                    errors: result.errors,
+                    logDir
+                });
+            }
+            else {
+                this.logger.debug('Cleanup completed successfully', {
+                    compressedCount: result.compressedFiles.length,
+                    deletedCount: result.deletedFiles.length,
+                    logDir,
+                    sizeAfterMB: (result.totalSizeAfter / BYTES_PER_MB).toFixed(2),
+                    sizeBeforeMB: (result.totalSizeBefore / BYTES_PER_MB).toFixed(2)
+                });
+            }
+            return result;
+        }));
+        // Aggregate totals from all results
+        const { totalCompressed, totalDeleted, totalErrors } = results.reduce((totals, result, index) => {
+            if (result.status === 'fulfilled') {
+                return {
+                    totalCompressed: totals.totalCompressed + result.value.compressedFiles.length,
+                    totalDeleted: totals.totalDeleted + result.value.deletedFiles.length,
+                    totalErrors: totals.totalErrors + result.value.errors.length
+                };
+            }
+            else {
+                this.logger.error('Failed to cleanup directory', result.reason instanceof Error ? result.reason : undefined, {
+                    logDir: this.schedule.logDirs[index]
+                });
+                return {
+                    ...totals,
+                    totalErrors: totals.totalErrors + 1
+                };
+            }
+        }, { totalCompressed: 0, totalDeleted: 0, totalErrors: 0 });
+        const duration = Date.now() - startTime;
+        this.logger.debug('Scheduled cleanup cycle completed', {
+            durationMs: duration,
+            totalCompressed,
+            totalDeleted,
+            totalDirectories: this.schedule.logDirs.length,
+            totalErrors
+        });
+    }
+    /**
+     * Run cleanup immediately (manual trigger)
+     */
+    async runNow() {
+        this.logger.info('Running manual cleanup');
+        // Process all directories in parallel
+        const cleanupResults = await Promise.allSettled(this.schedule.logDirs.map((logDir) => this.retentionManager.cleanup(logDir).then((result) => ({ logDir, result }))));
+        // Build results object from settled promises
+        const results = cleanupResults.reduce((acc, settledResult, index) => {
+            const logDir = this.schedule.logDirs[index];
+            // Guard against undefined logDir (should never happen but satisfies TypeScript)
+            if (logDir === undefined) {
+                this.logger.error('Unexpected undefined logDir at index', undefined, { index });
+                return acc;
+            }
+            if (settledResult.status === 'fulfilled') {
+                acc[logDir] = settledResult.value.result;
+            }
+            else {
+                const error = settledResult.reason;
+                this.logger.error('Manual cleanup failed for directory', error instanceof Error ? error : undefined, {
+                    logDir
+                });
+                acc[logDir] = {
+                    compressedFiles: [],
+                    compressedItems: [],
+                    deletedFiles: [],
+                    deletedItems: [],
+                    errors: [formatErrorMessage(error)],
+                    totalSizeAfter: 0,
+                    totalSizeBefore: 0
+                };
+            }
+            return acc;
+        }, {});
+        this.logger.info('Manual cleanup completed');
+        this.logger.debug('Manual cleanup details', {
+            directoryCount: Object.keys(results).length
+        });
+        return results;
+    }
+}
+//# sourceMappingURL=cleanup-scheduler.js.map

package/dist/output/cleanup-scheduler.js.map

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

package/dist/output/color-adapter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Chalk Color Adapter - Chalk.js implementation of the color styling adapter
+ *
+ * This is a concrete implementation of ColorAdapter using the Chalk library.
+ * The interfaces are defined separately to allow for other implementations (colors, kleur, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic ColorAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Provides the familiar Chalk API through the adapter
+ */
+import type { ChainableColorFn, Color, ColorAdapter, Modifier } from './color-adapter.interface.js';
+/**
+ * Chalk Adapter Implementation
+ *
+ * Concrete implementation of ColorAdapter using the Chalk library.
+ */
+export declare class ChalkAdapter implements ColorAdapter {
+    /**
+     * Color mapping to chalk functions
+     */
+    private readonly colorMap;
+    /**
+     * Modifier mapping to chalk functions
+     */
+    private readonly modifierMap;
+    /**
+     * Whether colors are disabled (NO_COLOR environment variable)
+     */
+    private readonly noColor;
+    constructor();
+    color(color: Color, text: string): string;
+    colorModifier(color: Color, modifier: Modifier, text: string): string;
+    getColorFn(color: Color): ChainableColorFn;
+    getRawFn(path: string): (text: string) => string;
+    modifier(modifier: Modifier, text: string): string;
+    blue(text: string): string;
+    bold(text: string): string;
+    cyan(text: string): string;
+    dim(text: string): string;
+    gray(text: string): string;
+    green(text: string): string;
+    inverse(text: string): string;
+    italic(text: string): string;
+    magenta(text: string): string;
+    red(text: string): string;
+    underline(text: string): string;
+    white(text: string): string;
+    yellow(text: string): string;
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getColorAdapter function in the interface
+ */
+export declare function createDefaultColorAdapter(): ColorAdapter;
+//# sourceMappingURL=color-adapter.d.ts.map

package/dist/output/color-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-adapter.d.ts","sourceRoot":"","sources":["../../src/output/color-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEjG;;;;GAIG;AACH,qBAAa,YAAa,YAAW,YAAY;IAChD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CASvB;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAM1B;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;;IAMlC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAMzC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAarE,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB;IAI1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;IAehD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAOlD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CAExD"}

package/dist/output/color-adapter.interface.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Color Adapter Interface
+ *
+ * Library-agnostic terminal styling interface.
+ * Implementations can use Chalk, Colors, Kleur, or any other styling library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+/**
+ * Color options available for styling
+ */
+export type Color = 'blue' | 'cyan' | 'gray' | 'green' | 'magenta' | 'red' | 'white' | 'yellow';
+/**
+ * Modifier options for text styling
+ */
+export type Modifier = 'bold' | 'dim' | 'inverse' | 'italic' | 'underline';
+/**
+ * Chainable color function that supports modifiers
+ */
+export interface ChainableColorFn {
+    (text: string): string;
+    bold: ChainableColorFn;
+    dim: ChainableColorFn;
+    inverse: ChainableColorFn;
+    italic: ChainableColorFn;
+    underline: ChainableColorFn;
+}
+/**
+ * Color Adapter Interface
+ *
+ * Defines the contract for terminal color/styling implementations.
+ * All styling operations should go through this interface.
+ */
+export interface ColorAdapter {
+    /**
+     * Apply a color to text
+     *
+     * @param color - The color to apply
+     * @param text - The text to colorize
+     * @returns Colored text
+     *
+     * @example
+     * adapter.color('blue', 'Hello'); // Returns blue text
+     */
+    color(color: Color, text: string): string;
+    /**
+     * Apply a modifier to text
+     *
+     * @param modifier - The modifier to apply
+     * @param text - The text to modify
+     * @returns Modified text
+     *
+     * @example
+     * adapter.modifier('bold', 'Hello'); // Returns bold text
+     */
+    modifier(modifier: Modifier, text: string): string;
+    /**
+     * Apply both color and modifier to text
+     *
+     * @param color - The color to apply
+     * @param modifier - The modifier to apply
+     * @param text - The text to style
+     * @returns Styled text
+     *
+     * @example
+     * adapter.colorModifier('blue', 'bold', 'Hello'); // Returns bold blue text
+     */
+    colorModifier(color: Color, modifier: Modifier, text: string): string;
+    /**
+     * Get a chainable color function for advanced usage
+     *
+     * @param color - The color to use
+     * @returns Chainable color function
+     *
+     * @example
+     * const blueFn = adapter.getColorFn('blue');
+     * blueFn.bold('Hello'); // Returns bold blue text
+     */
+    getColorFn(color: Color): ChainableColorFn;
+    /**
+     * Get a raw styling function (for direct chalk-like usage)
+     *
+     * @param path - Dot-notation path to the styling function (e.g., 'blue.bold', 'red')
+     * @returns Styling function
+     *
+     * @example
+     * const styleFn = adapter.getRawFn('blue.bold');
+     * styleFn('Hello'); // Returns bold blue text
+     */
+    getRawFn(path: string): (text: string) => string;
+    blue(text: string): string;
+    cyan(text: string): string;
+    gray(text: string): string;
+    green(text: string): string;
+    magenta(text: string): string;
+    red(text: string): string;
+    white(text: string): string;
+    yellow(text: string): string;
+    bold(text: string): string;
+    dim(text: string): string;
+    inverse(text: string): string;
+    italic(text: string): string;
+    underline(text: string): string;
+}
+/**
+ * Factory function type for creating ColorAdapter instances
+ */
+export type ColorAdapterFactory = () => ColorAdapter;
+/**
+ * Get the singleton ColorAdapter instance
+ *
+ * @returns ColorAdapter instance
+ *
+ * @example
+ * import { getColorAdapter } from './color-adapter.interface.js';
+ *
+ * const color = getColorAdapter();
+ * console.log(color.blue('Hello World'));
+ * console.log(color.colorModifier('green', 'bold', 'Success!'));
+ */
+export declare function getColorAdapter(): ColorAdapter;
+/**
+ * Set a custom ColorAdapter implementation
+ * Useful for testing or switching to different styling libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setColorAdapter } from './color-adapter.interface.js';
+ *
+ * const mockAdapter = new MockColorAdapter();
+ * setColorAdapter(mockAdapter);
+ */
+export declare function setColorAdapter(adapter: ColorAdapter): void;
+//# sourceMappingURL=color-adapter.interface.d.ts.map

package/dist/output/color-adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-adapter.interface.d.ts","sourceRoot":"","sources":["../../src/output/color-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhG;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnD;;;;;;;;;;OAUG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtE;;;;;;;;;OASG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAE3C;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAGjD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAG7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,YAAY,CAAC;AAOrD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE3D"}

package/dist/output/color-adapter.interface.js

@@ -0,0 +1,49 @@
+/**
+ * Color Adapter Interface
+ *
+ * Library-agnostic terminal styling interface.
+ * Implementations can use Chalk, Colors, Kleur, or any other styling library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+import { createDefaultColorAdapter } from './color-adapter.js';
+/**
+ * Singleton instance
+ */
+let adapterInstance = null;
+/**
+ * Get the singleton ColorAdapter instance
+ *
+ * @returns ColorAdapter instance
+ *
+ * @example
+ * import { getColorAdapter } from './color-adapter.interface.js';
+ *
+ * const color = getColorAdapter();
+ * console.log(color.blue('Hello World'));
+ * console.log(color.colorModifier('green', 'bold', 'Success!'));
+ */
+export function getColorAdapter() {
+    adapterInstance ??= createDefaultColorAdapter();
+    return adapterInstance;
+}
+/**
+ * Set a custom ColorAdapter implementation
+ * Useful for testing or switching to different styling libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setColorAdapter } from './color-adapter.interface.js';
+ *
+ * const mockAdapter = new MockColorAdapter();
+ * setColorAdapter(mockAdapter);
+ */
+export function setColorAdapter(adapter) {
+    adapterInstance = adapter;
+}
+//# sourceMappingURL=color-adapter.interface.js.map

package/dist/output/color-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-adapter.interface.js","sourceRoot":"","sources":["../../src/output/color-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAmH5D;;GAEG;AACH,IAAI,eAAe,GAAwB,IAAI,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe;IAC9B,eAAe,KAAK,yBAAyB,EAAE,CAAC;IAChD,OAAO,eAAgB,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqB;IACpD,eAAe,GAAG,OAAO,CAAC;AAC3B,CAAC"}

package/dist/output/color-adapter.js

@@ -0,0 +1,163 @@
+/**
+ * Chalk Color Adapter - Chalk.js implementation of the color styling adapter
+ *
+ * This is a concrete implementation of ColorAdapter using the Chalk library.
+ * The interfaces are defined separately to allow for other implementations (colors, kleur, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic ColorAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Provides the familiar Chalk API through the adapter
+ */
+import chalk from 'chalk';
+/**
+ * Chalk Adapter Implementation
+ *
+ * Concrete implementation of ColorAdapter using the Chalk library.
+ */
+export class ChalkAdapter {
+    /**
+     * Color mapping to chalk functions
+     */
+    colorMap = {
+        blue: chalk.blue,
+        cyan: chalk.cyan,
+        gray: chalk.gray,
+        green: chalk.green,
+        magenta: chalk.magenta,
+        red: chalk.red,
+        white: chalk.white,
+        yellow: chalk.yellow
+    };
+    /**
+     * Modifier mapping to chalk functions
+     */
+    modifierMap = {
+        bold: chalk.bold,
+        dim: chalk.dim,
+        inverse: chalk.inverse,
+        italic: chalk.italic,
+        underline: chalk.underline
+    };
+    /**
+     * Whether colors are disabled (NO_COLOR environment variable)
+     */
+    noColor;
+    constructor() {
+        this.noColor = process.env['NO_COLOR'] !== undefined;
+    }
+    color(color, text) {
+        if (this.noColor)
+            return text;
+        const colorFn = this.colorMap[color];
+        return colorFn(text);
+    }
+    colorModifier(color, modifier, text) {
+        if (this.noColor)
+            return text;
+        const colorFn = this.colorMap[color];
+        // Chain the functions: chalk.blue.bold is same as chalk.bold(chalk.blue())
+        // but chalk supports chaining, so we use the fluent API
+        const chainable = colorFn;
+        const modifierFn = chainable[modifier];
+        if (!modifierFn) {
+            throw new Error(`Modifier '${modifier}' not found on color '${color}'`);
+        }
+        return modifierFn(text);
+    }
+    getColorFn(color) {
+        return this.colorMap[color];
+    }
+    getRawFn(path) {
+        const parts = path.split('.');
+        let fn = chalk;
+        for (const part of parts) {
+            const record = fn;
+            fn = record[part];
+            if (!fn) {
+                throw new Error(`Invalid chalk path: ${path}`);
+            }
+        }
+        return fn;
+    }
+    modifier(modifier, text) {
+        if (this.noColor)
+            return text;
+        const modifierFn = this.modifierMap[modifier];
+        return modifierFn(text);
+    }
+    // Convenience methods
+    blue(text) {
+        if (this.noColor)
+            return text;
+        return chalk.blue(text);
+    }
+    bold(text) {
+        if (this.noColor)
+            return text;
+        return chalk.bold(text);
+    }
+    cyan(text) {
+        if (this.noColor)
+            return text;
+        return chalk.cyan(text);
+    }
+    dim(text) {
+        if (this.noColor)
+            return text;
+        return chalk.dim(text);
+    }
+    gray(text) {
+        if (this.noColor)
+            return text;
+        return chalk.gray(text);
+    }
+    green(text) {
+        if (this.noColor)
+            return text;
+        return chalk.green(text);
+    }
+    inverse(text) {
+        if (this.noColor)
+            return text;
+        return chalk.inverse(text);
+    }
+    italic(text) {
+        if (this.noColor)
+            return text;
+        return chalk.italic(text);
+    }
+    magenta(text) {
+        if (this.noColor)
+            return text;
+        return chalk.magenta(text);
+    }
+    red(text) {
+        if (this.noColor)
+            return text;
+        return chalk.red(text);
+    }
+    underline(text) {
+        if (this.noColor)
+            return text;
+        return chalk.underline(text);
+    }
+    white(text) {
+        if (this.noColor)
+            return text;
+        return chalk.white(text);
+    }
+    yellow(text) {
+        if (this.noColor)
+            return text;
+        return chalk.yellow(text);
+    }
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getColorAdapter function in the interface
+ */
+export function createDefaultColorAdapter() {
+    return new ChalkAdapter();
+}
+//# sourceMappingURL=color-adapter.js.map

package/dist/output/color-adapter.js.map

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