find-bottleneck-perf 1.0.0

package/src/utils.js

@@ -0,0 +1,103 @@
+/**
+ * Utility functions and terminal color codes.
+ */
+
+// ANSI color codes for terminal output
+const colors = {
+    reset: "\x1b[0m",
+    bright: "\x1b[1m",
+    dim: "\x1b[2m",
+
+    // Text colors
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    white: "\x1b[37m",
+
+    // Background colors
+    bgRed: "\x1b[41m",
+    bgGreen: "\x1b[42m",
+    bgYellow: "\x1b[43m",
+};
+
+/**
+ * Colorize text for terminal output.
+ * @param {string} text - Text to colorize
+ * @param {string} color - Color key from colors object
+ * @returns {string} Colorized string
+ */
+function colorize(text, color) {
+    return `${colors[color] || ''}${text}${colors.reset}`;
+}
+
+/**
+ * Format milliseconds for display.
+ * @param {number} ms - Milliseconds
+ * @returns {string} Formatted string
+ */
+function formatMs(ms) {
+    if (ms >= 1000) {
+        return `${(ms / 1000).toFixed(2)}s`;
+    }
+    return `${Math.round(ms)}ms`;
+}
+
+/**
+ * Format bytes to human-readable size.
+ * @param {number} bytes - Bytes
+ * @returns {string} Formatted string
+ */
+function formatBytes(bytes) {
+    if (bytes >= 1024 * 1024) {
+        return `${(bytes / 1024 / 1024).toFixed(2)} MB`;
+    }
+    if (bytes >= 1024) {
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    }
+    return `${bytes} B`;
+}
+
+/**
+ * Get status indicator based on value and thresholds.
+ * @param {number} value - Metric value
+ * @param {object} threshold - Object with GOOD and POOR keys
+ * @param {boolean} lowerIsBetter - Default true
+ * @returns {string} Colored status indicator
+ */
+function getStatus(value, threshold, lowerIsBetter = true) {
+    if (lowerIsBetter) {
+        if (value <= threshold.GOOD) return colorize('●', 'green');
+        if (value >= threshold.POOR) return colorize('●', 'red');
+        return colorize('●', 'yellow');
+    } else {
+        if (value >= threshold.GOOD) return colorize('●', 'green');
+        if (value <= threshold.POOR) return colorize('●', 'red');
+        return colorize('●', 'yellow');
+    }
+}
+
+/**
+ * Create a simple progress bar.
+ * @param {number} value - Current value
+ * @param {number} max - Maximum value for scale
+ * @param {number} width - Bar width in characters
+ * @returns {string} ASCII progress bar
+ */
+function progressBar(value, max, width = 20) {
+    const filled = Math.min(Math.round((value / max) * width), width);
+    const empty = width - filled;
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    return bar;
+}
+
+module.exports = {
+    colors,
+    colorize,
+    formatMs,
+    formatBytes,
+    getStatus,
+    progressBar,
+};