error-ux-cli 1.0.0

package/lib/utils.js

@@ -0,0 +1,386 @@
+const { exec } = require('child_process');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const FRAMES = ['|', '/', '-', '\\'];
+const ANIMATION_INTERVAL_MS = 90;
+const BOX = {
+    topLeft: '\u250c',
+    topRight: '\u2510',
+    bottomLeft: '\u2514',
+    bottomRight: '\u2518',
+    horizontal: '\u2500',
+    vertical: '\u2502',
+    leftJoin: '\u251c',
+    rightJoin: '\u2524',
+    topJoin: '\u252c',
+    bottomJoin: '\u2534',
+    cross: '\u253c'
+};
+
+function canAnimate() {
+    return Boolean(process.stdout.isTTY && !process.env.CI && process.env.NO_ANIMATION !== '1');
+}
+
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+function clearLine() {
+    if (process.stdout.clearLine && process.stdout.cursorTo) {
+        process.stdout.clearLine(0);
+        process.stdout.cursorTo(0);
+    }
+}
+
+function writeAnimatedLine(message, frameIndex = 0) {
+    clearLine();
+    process.stdout.write(`${FRAMES[frameIndex % FRAMES.length]} ${message}`);
+}
+
+async function animateMessage(message, durationMs = 450, showWhenStatic = true) {
+    if (!canAnimate()) {
+        if (showWhenStatic) {
+            console.log(message);
+        }
+        return;
+    }
+
+    const startedAt = Date.now();
+    let frameIndex = 0;
+    while (Date.now() - startedAt < durationMs) {
+        writeAnimatedLine(message, frameIndex);
+        frameIndex++;
+        await sleep(ANIMATION_INTERVAL_MS);
+    }
+    clearLine();
+}
+
+async function withSpinner(message, task) {
+    if (!canAnimate()) {
+        return task();
+    }
+
+    let frameIndex = 0;
+    const timer = setInterval(() => {
+        writeAnimatedLine(message, frameIndex);
+        frameIndex++;
+    }, ANIMATION_INTERVAL_MS);
+
+    writeAnimatedLine(message, frameIndex);
+    frameIndex++;
+
+    try {
+        return await task();
+    } finally {
+        clearInterval(timer);
+        clearLine();
+    }
+}
+
+async function printAnimatedLines(lines, delayMs = 35) {
+    if (!canAnimate()) {
+        lines.forEach(line => console.log(line));
+        return;
+    }
+
+    for (const line of lines) {
+        console.log(line);
+        await sleep(delayMs);
+    }
+}
+
+async function typeAnimatedLines(lines, charDelayMs = 3, lineDelayMs = 35) {
+    if (!canAnimate()) {
+        lines.forEach(line => console.log(line));
+        return;
+    }
+
+    for (const line of lines) {
+        for (const char of line) {
+            process.stdout.write(char);
+            await sleep(charDelayMs);
+        }
+        process.stdout.write('\n');
+        await sleep(lineDelayMs);
+    }
+}
+
+async function animateIntroName(name, width) {
+    const label = `Welcome ${name}`;
+    const safeWidth = Math.max(width, label.length + 10);
+    const leftPadding = Math.floor((safeWidth - 2 - label.length) / 2);
+    const rightPadding = safeWidth - 2 - label.length - leftPadding;
+    const border = BOX.topLeft + BOX.horizontal.repeat(safeWidth - 2) + BOX.topRight;
+    const bottom = BOX.bottomLeft + BOX.horizontal.repeat(safeWidth - 2) + BOX.bottomRight;
+    const content = BOX.vertical + ' '.repeat(leftPadding) + label + ' '.repeat(rightPadding) + BOX.vertical;
+
+    if (!canAnimate()) {
+        console.log(border);
+        console.log(content);
+        console.log(bottom);
+        return;
+    }
+
+    const frames = [
+        `Starting ${name}`,
+        `Loading ${name}`,
+        `Preparing ${name}`,
+        `Welcome ${name}`
+    ];
+
+    for (const frame of frames) {
+        writeAnimatedLine(frame);
+        await sleep(180);
+    }
+    clearLine();
+
+    await typeAnimatedLines([border, content, bottom], 4, 45);
+    console.log('');
+}
+
+function openBrowser(url) {
+    const platform = os.platform();
+    let command;
+
+    switch (platform) {
+        case 'win32':
+            command = `start "" "${url}"`;
+            break;
+        case 'darwin':
+            command = `open "${url}"`;
+            break;
+        case 'linux':
+            command = `xdg-open "${url}"`;
+            break;
+        default:
+            console.error(`Unsupported platform: ${platform}`);
+            return;
+    }
+
+    exec(command, (error) => {
+        if (error) {
+            console.error(`Failed to open URL: ${error.message}`);
+        }
+    });
+}
+
+function isValidUrl(urlString) {
+    try {
+        new URL(urlString);
+        return true;
+    } catch (e) {
+        return false;
+    }
+}
+
+function isSystemFolder(dirPath) {
+    const home = os.homedir();
+    const systemFolders = [
+        home,
+        path.join(home, 'Downloads'),
+        path.join(home, 'Desktop'),
+        path.join(home, 'Documents'),
+        path.join(home, 'Pictures'),
+        path.join(home, 'Music'),
+        path.join(home, 'Videos')
+    ];
+
+    return systemFolders.some(folder =>
+        path.normalize(dirPath).toLowerCase() === path.normalize(folder).toLowerCase()
+    );
+}
+
+function loadEnv() {
+    const envPath = path.join(process.cwd(), '.env');
+    if (fs.existsSync(envPath)) {
+        const content = fs.readFileSync(envPath, 'utf8');
+        content.split('\n').forEach(line => {
+            const trimmed = line.trim();
+            if (trimmed && !trimmed.startsWith('#')) {
+                const [key, ...valueParts] = trimmed.split('=');
+                if (key && valueParts.length > 0) {
+                    process.env[key.trim()] = valueParts.join('=').trim();
+                }
+            }
+        });
+    }
+}
+
+function saveEnvValue(key, value) {
+    const envPath = path.join(process.cwd(), '.env');
+    const normalizedValue = String(value ?? '').trim();
+    const existing = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf8') : '';
+    const lines = existing ? existing.split(/\r?\n/) : [];
+    let found = false;
+
+    const updatedLines = lines.map((line) => {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            return line;
+        }
+
+        const [existingKey] = trimmed.split('=');
+        if (existingKey && existingKey.trim() === key) {
+            found = true;
+            return `${key}=${normalizedValue}`;
+        }
+        return line;
+    });
+
+    if (!found) {
+        updatedLines.push(`${key}=${normalizedValue}`);
+    }
+
+    fs.writeFileSync(envPath, `${updatedLines.filter((line, index, array) => !(index === array.length - 1 && line === '')).join('\n')}\n`, 'utf8');
+    process.env[key] = normalizedValue;
+}
+
+function generateBox(title, lines, width) {
+    const safeWidth = Math.max(width, title.length + 6);
+    const top = `${BOX.topLeft}${BOX.horizontal.repeat(2)} ${title} ${BOX.horizontal.repeat(safeWidth - title.length - 6)}${BOX.horizontal}${BOX.topRight}`;
+    const bottom = `${BOX.bottomLeft}${BOX.horizontal.repeat(safeWidth - 2)}${BOX.bottomRight}`;
+    const paddedLines = lines.map(line => {
+        const content = line.slice(0, safeWidth - 4);
+        return `${BOX.vertical} ${content}${' '.repeat(safeWidth - 4 - content.length)} ${BOX.vertical}`;
+    });
+
+    if (paddedLines.length === 0) {
+        paddedLines.push(`${BOX.vertical} ${' '.repeat(safeWidth - 4)} ${BOX.vertical}`);
+    }
+
+    return [top, ...paddedLines, bottom];
+}
+
+function fitText(text, width) {
+    const clean = String(text ?? '');
+    if (clean.length <= width) {
+        return clean + ' '.repeat(width - clean.length);
+    }
+
+    if (width <= 1) {
+        return clean.slice(0, width);
+    }
+
+    return clean.slice(0, width - 1) + '\u2026';
+}
+
+function dashboardLine(left, width) {
+    return `${BOX.vertical} ${fitText(left, width - 4)} ${BOX.vertical}`;
+}
+
+function dashboardSeparator(width) {
+    return `${BOX.leftJoin}${BOX.horizontal.repeat(width - 2)}${BOX.rightJoin}`;
+}
+
+function dashboardBorder(width, top = true) {
+    const left = top ? BOX.topLeft : BOX.bottomLeft;
+    const right = top ? BOX.topRight : BOX.bottomRight;
+    return left + BOX.horizontal.repeat(width - 2) + right;
+}
+
+function sideBySide(leftLines, rightLines, gap = 2) {
+    const height = Math.max(leftLines.length, rightLines.length);
+    const leftWidth = leftLines[0]?.length || 0;
+    const rightWidth = rightLines[0]?.length || 0;
+    const output = [];
+    for (let i = 0; i < height; i++) {
+        const left = leftLines[i] || ' '.repeat(leftWidth);
+        const right = rightLines[i] || ' '.repeat(rightWidth);
+        output.push(left + ' '.repeat(gap) + right);
+    }
+    return output;
+}
+
+function equalizeBoxes(leftLines, rightLines) {
+    const left = [...leftLines];
+    const right = [...rightLines];
+
+    while (left.length < right.length) {
+        insertBlankBoxLine(left);
+    }
+
+    while (right.length < left.length) {
+        insertBlankBoxLine(right);
+    }
+
+    return [left, right];
+}
+
+function insertBlankBoxLine(lines) {
+    if (lines.length < 2) return;
+
+    const width = lines[0].length;
+    const blank = `${BOX.vertical} ${' '.repeat(width - 4)} ${BOX.vertical}`;
+    lines.splice(lines.length - 1, 0, blank);
+}
+
+function formatDashboardHeader(width) {
+    const now = new Date();
+    const dateStr = now.toLocaleDateString('en-US', { month: 'short', day: '2-digit' }).toUpperCase();
+    const timeStr = now.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: true });
+    const dateTime = `${dateStr}  ${timeStr}`;
+
+    const menu = ' LINK | PUSH | TODO | NEWS | HELP ';
+    const space = width - menu.length - dateTime.length - 4;
+
+    const content = `${BOX.vertical} ${menu}${' '.repeat(Math.max(0, space))}${dateTime} ${BOX.vertical}`;
+    const border = BOX.topLeft + BOX.horizontal.repeat(width - 2) + BOX.topRight;
+    const bottom = BOX.bottomLeft + BOX.horizontal.repeat(width - 2) + BOX.bottomRight;
+
+    return [border, content, bottom];
+}
+
+function formatConnectedDashboard({ width, menu, dateTime, todoLines, shortcutLines, newsLines }) {
+    const leftWidth = 38;
+    const rightWidth = width - leftWidth - 5;
+    const top = dashboardBorder(width, true);
+    const bottom = dashboardBorder(width, false);
+    const columnSeparator = BOX.leftJoin + BOX.horizontal.repeat(leftWidth) + BOX.cross + BOX.horizontal.repeat(rightWidth) + BOX.rightJoin;
+    const lines = [top];
+    const headerGap = width - menu.length - dateTime.length - 4;
+
+    lines.push(`${BOX.vertical} ${menu}${' '.repeat(Math.max(0, headerGap))}${dateTime} ${BOX.vertical}`);
+    lines.push(dashboardSeparator(width));
+
+    const leftTitle = 'ACTIVE TASKS (todo)';
+    const rightTitle = 'SHORTCUTS (links)';
+
+    lines.push(`${BOX.vertical} ${fitText(leftTitle, leftWidth - 2)} ${BOX.vertical} ${fitText(rightTitle, rightWidth - 2)} ${BOX.vertical}`);
+    lines.push(columnSeparator);
+
+    const rowCount = Math.max(todoLines.length, shortcutLines.length, 4);
+    for (let i = 0; i < rowCount; i++) {
+        lines.push(`${BOX.vertical} ${fitText(todoLines[i] || '', leftWidth - 2)} ${BOX.vertical} ${fitText(shortcutLines[i] || '', rightWidth - 2)} ${BOX.vertical}`);
+    }
+
+    lines.push(dashboardSeparator(width));
+    lines.push(dashboardLine('LATEST NEWS (news)', width));
+    lines.push(dashboardSeparator(width));
+
+    newsLines.forEach(line => {
+        lines.push(dashboardLine(line, width));
+    });
+
+    lines.push(bottom);
+    return lines;
+}
+
+module.exports = {
+    animateMessage,
+    withSpinner,
+    printAnimatedLines,
+    typeAnimatedLines,
+    animateIntroName,
+    openBrowser,
+    isValidUrl,
+    isSystemFolder,
+    loadEnv,
+    saveEnvValue,
+    generateBox,
+    formatConnectedDashboard,
+    sideBySide,
+    equalizeBoxes,
+    formatDashboardHeader
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "error-ux-cli",
+  "version": "1.0.0",
+  "description": "All-in-one developer productivity CLI",
+  "main": "index.js",
+  "bin": {
+    "error-ux-cli": "index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "test": "node test/commands.test.js"
+  },
+  "files": [
+    "index.js",
+    "lib",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "developer",
+    "productivity"
+  ],
+  "author": "Aniruth",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "ink": "^7.0.0",
+    "react": "^19.2.5"
+  }
+}