xw-devtool-cli 1.0.43 → 1.0.45

package/README_EN.md

@@ -4,7 +4,7 @@
 
 A Node.js-based developer command-line toolbox designed to provide out-of-the-box common development tools to help developers handle daily tasks quickly.
 
-Key features include: Base64 encoding/decoding, image format conversion, image <-> Base64, Mock data generation, timestamp/date formatting, time calculation, URL encoding/decoding, UUID generation, Chinese pinyin conversion, color conversion, variable format conversion, hash calculation, QR code generation, QR code recognition, special symbols, Markdown snippets, VS Code snippet generation, current directory tree generation, etc. Most results can be copied to the clipboard in one step, greatly improving development efficiency.
+Key features include: Base64 encoding/decoding, image format conversion, image <-> Base64, Mock data generation, timestamp/date formatting, time calculation, console clock, countdown timer, stopwatch, URL encoding/decoding, UUID generation, Chinese pinyin conversion, color conversion, variable format conversion, hash calculation, QR code generation, QR code recognition, special symbols, Markdown snippets, VS Code snippet generation, current directory tree generation, etc. Most results can be copied to the clipboard in one step, greatly improving development efficiency.
 
 ## ✨ Features
 
@@ -29,6 +29,9 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Formatting**: Timestamp/Date string -> `YYYY-MM-DD HH:mm:ss`.
   - **Timestamp**: Quickly get current millisecond timestamp.
   - **Calculation**: Calculate date differences or offsets (Add/Subtract).
+  - **Console Clock**: Show real-time current time in terminal, press `Enter` or `Q` to go back.
+  - **Countdown Timer**: Select seconds/minutes/hours first, then enter the value to start; once it reaches zero, it keeps counting with a negative sign (such as `-00:00:05`).
+  - **Stopwatch**: Start from `00:00:00` and count up every second in terminal.
 - **Dev Tools**:
   - **URL Encode/Decode**
   - **Unicode Encode/Decode**: Text <-> Unicode escape sequences (\uXXXX).
@@ -224,6 +227,22 @@ s. Settings (Language)
 - **Diff**: Calculate difference between two dates.
 - **Offset**: Calculate date after add/subtract time units.
 
+### Console Clock
+- Select `Console Clock` in the menu.
+- Current time refreshes every second in terminal.
+- Press `Enter` or `Q` to go back.
+
+### Countdown Timer
+- Select `Countdown Timer` in the menu.
+- Select unit first (Seconds / Minutes / Hours), then enter the value.
+- After reaching zero, the timer continues with a negative sign (for example `-00:00:01`).
+- Press `Enter` or `Q` to go back.
+
+### Stopwatch
+- Select `Stopwatch` in the menu.
+- It starts from `00:00:00` and updates every second.
+- Press `Enter` or `Q` to go back.
+
 ### 14. Color Converter
 - Select `e`.
 - Hex <-> RGB.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.43",
+  "version": "1.0.45",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -34,6 +34,12 @@
     "mock-data",
     "timestamp",
     "time",
+    "clock",
+    "console-clock",
+    "countdown",
+    "countdown-timer",
+    "stopwatch",
+    "stopwatch-timer",
     "date-calculation",
     "image",
     "image-conversion",

package/src/commands/clock.js

@@ -0,0 +1,142 @@
+import readline from 'readline';
+import i18next from '../i18n.js';
+
+function getLocale() {
+    return i18next.language && i18next.language.toLowerCase().startsWith('zh') ? 'zh-CN' : 'en-US';
+}
+
+function getNowDisplay(locale) {
+    const now = new Date();
+    const timeText = new Intl.DateTimeFormat(locale, {
+        hour12: false,
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit'
+    }).format(now);
+    const dateText = new Intl.DateTimeFormat(locale, {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        weekday: 'long'
+    }).format(now);
+    return { timeText, dateText };
+}
+
+function getCharDisplayWidth(char) {
+    if (/[\u0000-\u001f\u007f]/.test(char)) {
+        return 0;
+    }
+    if (
+        /[\u1100-\u115f\u2329\u232a\u2e80-\u303e\u3040-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6]/.test(char)
+    ) {
+        return 2;
+    }
+    return 1;
+}
+
+function getDisplayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += getCharDisplayWidth(char);
+    }
+    return width;
+}
+
+function fitText(text, width) {
+    let result = '';
+    let currentWidth = 0;
+    for (const char of text) {
+        const charWidth = getCharDisplayWidth(char);
+        if (currentWidth + charWidth > width) {
+            break;
+        }
+        result += char;
+        currentWidth += charWidth;
+    }
+    const remaining = width - getDisplayWidth(result);
+    if (remaining > 0) {
+        return `${result}${' '.repeat(remaining)}`;
+    }
+    return result;
+}
+
+function renderClockBlock() {
+    const { timeText, dateText } = getNowDisplay(getLocale());
+    const contentLines = [
+        i18next.t('clock.title'),
+        '',
+        `${i18next.t('clock.now')}${timeText}`,
+        dateText,
+        i18next.t('clock.exitTip')
+    ];
+    const innerWidth = Math.max(34, ...contentLines.map((text) => getDisplayWidth(text)));
+    const top = `┌${'─'.repeat(innerWidth + 2)}┐`;
+    const bottom = `└${'─'.repeat(innerWidth + 2)}┘`;
+    const line = (text) => `│ ${fitText(text, innerWidth)} │`;
+    return [
+        top,
+        line(contentLines[0]),
+        line(''),
+        line(contentLines[2]),
+        line(contentLines[3]),
+        line(contentLines[4]),
+        bottom
+    ];
+}
+
+export async function clockHandler() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        const { timeText, dateText } = getNowDisplay(getLocale());
+        console.log(`${i18next.t('clock.now')}${timeText} (${dateText})`);
+        return;
+    }
+
+    await new Promise((resolve) => {
+        let renderedLineCount = 0;
+        let shouldExitApp = false;
+
+        const render = () => {
+            const lines = renderClockBlock();
+            if (renderedLineCount > 0) {
+                readline.moveCursor(process.stdout, 0, -renderedLineCount);
+                readline.cursorTo(process.stdout, 0);
+                readline.clearScreenDown(process.stdout);
+            }
+            process.stdout.write(`${lines.join('\n')}\n`);
+            renderedLineCount = lines.length;
+        };
+
+        const cleanup = () => {
+            clearInterval(timer);
+            process.stdin.off('data', onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            readline.cursorTo(process.stdout, 0);
+            readline.clearScreenDown(process.stdout);
+            process.stdout.write('\n');
+            if (shouldExitApp) {
+                console.log(i18next.t('menu.bye'));
+                process.exit(0);
+            }
+            resolve();
+        };
+
+        const onData = (chunk) => {
+            const key = chunk.toString().toLowerCase();
+            if (key === '0') {
+                shouldExitApp = true;
+                cleanup();
+                return;
+            }
+            if (key === '\r' || key === 'q' || key === '\u0003') {
+                cleanup();
+            }
+        };
+
+        const timer = setInterval(render, 1000);
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+        render();
+    });
+}

package/src/commands/countdown.js

@@ -0,0 +1,195 @@
+import inquirer from 'inquirer';
+import readline from 'readline';
+import i18next from '../i18n.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+function getCharDisplayWidth(char) {
+    if (/[\u0000-\u001f\u007f]/.test(char)) {
+        return 0;
+    }
+    if (
+        /[\u1100-\u115f\u2329\u232a\u2e80-\u303e\u3040-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6]/.test(char)
+    ) {
+        return 2;
+    }
+    return 1;
+}
+
+function getDisplayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += getCharDisplayWidth(char);
+    }
+    return width;
+}
+
+function fitText(text, width) {
+    let result = '';
+    let currentWidth = 0;
+    for (const char of text) {
+        const charWidth = getCharDisplayWidth(char);
+        if (currentWidth + charWidth > width) {
+            break;
+        }
+        result += char;
+        currentWidth += charWidth;
+    }
+    const remaining = width - getDisplayWidth(result);
+    if (remaining > 0) {
+        return `${result}${' '.repeat(remaining)}`;
+    }
+    return result;
+}
+
+function formatSeconds(seconds) {
+    const isNegative = seconds < 0;
+    const absSeconds = Math.abs(seconds);
+    const hours = Math.floor(absSeconds / 3600);
+    const minutes = Math.floor((absSeconds % 3600) / 60);
+    const secs = absSeconds % 60;
+    const sign = isNegative ? '-' : '';
+    return `${sign}${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(secs).padStart(2, '0')}`;
+}
+
+function parseAmount(input) {
+    const value = Number(input);
+    if (!Number.isFinite(value) || value < 0) {
+        return null;
+    }
+    return value;
+}
+
+function renderCountdownBlock(totalSeconds, elapsedSeconds) {
+    const remainSeconds = totalSeconds - elapsedSeconds;
+    const contentLines = [
+        i18next.t('countdown.title'),
+        '',
+        `${i18next.t('countdown.remaining')}${formatSeconds(remainSeconds)}`,
+        `${i18next.t('countdown.total')}${formatSeconds(totalSeconds)}`,
+        `${i18next.t('countdown.status')}${remainSeconds < 0 ? i18next.t('countdown.statusOvertime') : i18next.t('countdown.statusCounting')}`,
+        i18next.t('countdown.exitTip')
+    ];
+    const innerWidth = Math.max(34, ...contentLines.map((text) => getDisplayWidth(text)));
+    const top = `┌${'─'.repeat(innerWidth + 2)}┐`;
+    const bottom = `└${'─'.repeat(innerWidth + 2)}┘`;
+    const line = (text) => `│ ${fitText(text, innerWidth)} │`;
+
+    return [
+        top,
+        line(contentLines[0]),
+        line(''),
+        line(contentLines[2]),
+        line(contentLines[3]),
+        line(contentLines[4]),
+        line(contentLines[5]),
+        bottom
+    ];
+}
+
+export async function countdownHandler() {
+    const unitOptions = [
+        { name: i18next.t('countdown.unitSecond'), value: 'second' },
+        { name: i18next.t('countdown.unitMinute'), value: 'minute' },
+        { name: i18next.t('countdown.unitHour'), value: 'hour' }
+    ];
+
+    const unit = await selectFromMenu(
+        i18next.t('countdown.selectUnit'),
+        unitOptions,
+        true,
+        i18next.t('common.back')
+    );
+
+    if (unit === '__BACK__') {
+        return;
+    }
+
+    const unitNameMap = {
+        second: i18next.t('countdown.unitSecond'),
+        minute: i18next.t('countdown.unitMinute'),
+        hour: i18next.t('countdown.unitHour')
+    };
+
+    const { amountInput } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'amountInput',
+            message: i18next.t('countdown.inputPrompt', { unit: unitNameMap[unit] }),
+            default: '1',
+            validate: (input) => {
+                const value = parseAmount(input);
+                if (value === null) {
+                    return i18next.t('countdown.invalidAmount');
+                }
+                return true;
+            }
+        }
+    ]);
+
+    const amount = parseAmount(amountInput);
+    const multiplierMap = {
+        second: 1,
+        minute: 60,
+        hour: 3600
+    };
+    const totalSeconds = Math.round(amount * multiplierMap[unit]);
+
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        console.log(i18next.t('countdown.nonTtyTip', { value: formatSeconds(totalSeconds) }));
+        return;
+    }
+
+    await new Promise((resolve) => {
+        let renderedLineCount = 0;
+        let elapsedSeconds = 0;
+        let shouldExitApp = false;
+
+        const render = () => {
+            const lines = renderCountdownBlock(totalSeconds, elapsedSeconds);
+            if (renderedLineCount > 0) {
+                readline.moveCursor(process.stdout, 0, -renderedLineCount);
+                readline.cursorTo(process.stdout, 0);
+                readline.clearScreenDown(process.stdout);
+            }
+            process.stdout.write(`${lines.join('\n')}\n`);
+            renderedLineCount = lines.length;
+        };
+
+        const cleanup = () => {
+            clearInterval(timer);
+            process.stdin.off('data', onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            readline.cursorTo(process.stdout, 0);
+            readline.clearScreenDown(process.stdout);
+            process.stdout.write('\n');
+            if (shouldExitApp) {
+                console.log(i18next.t('menu.bye'));
+                process.exit(0);
+            }
+            resolve();
+        };
+
+        const onData = (chunk) => {
+            const key = chunk.toString().toLowerCase();
+            if (key === '0') {
+                shouldExitApp = true;
+                cleanup();
+                return;
+            }
+            if (key === '\r' || key === 'q' || key === '\u0003') {
+                cleanup();
+            }
+        };
+
+        const timer = setInterval(() => {
+            elapsedSeconds += 1;
+            render();
+        }, 1000);
+
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+        render();
+    });
+}

package/src/commands/stopwatch.js

@@ -0,0 +1,132 @@
+import readline from 'readline';
+import i18next from '../i18n.js';
+
+function getCharDisplayWidth(char) {
+    if (/[\u0000-\u001f\u007f]/.test(char)) {
+        return 0;
+    }
+    if (
+        /[\u1100-\u115f\u2329\u232a\u2e80-\u303e\u3040-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6]/.test(char)
+    ) {
+        return 2;
+    }
+    return 1;
+}
+
+function getDisplayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += getCharDisplayWidth(char);
+    }
+    return width;
+}
+
+function fitText(text, width) {
+    let result = '';
+    let currentWidth = 0;
+    for (const char of text) {
+        const charWidth = getCharDisplayWidth(char);
+        if (currentWidth + charWidth > width) {
+            break;
+        }
+        result += char;
+        currentWidth += charWidth;
+    }
+    const remaining = width - getDisplayWidth(result);
+    if (remaining > 0) {
+        return `${result}${' '.repeat(remaining)}`;
+    }
+    return result;
+}
+
+function formatSeconds(seconds) {
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const secs = seconds % 60;
+    return `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(secs).padStart(2, '0')}`;
+}
+
+function renderStopwatchBlock(elapsedSeconds) {
+    const contentLines = [
+        i18next.t('stopwatch.title'),
+        '',
+        `${i18next.t('stopwatch.elapsed')}${formatSeconds(elapsedSeconds)}`,
+        `${i18next.t('stopwatch.status')}${i18next.t('stopwatch.statusRunning')}`,
+        i18next.t('stopwatch.exitTip')
+    ];
+    const innerWidth = Math.max(34, ...contentLines.map((text) => getDisplayWidth(text)));
+    const top = `┌${'─'.repeat(innerWidth + 2)}┐`;
+    const bottom = `└${'─'.repeat(innerWidth + 2)}┘`;
+    const line = (text) => `│ ${fitText(text, innerWidth)} │`;
+
+    return [
+        top,
+        line(contentLines[0]),
+        line(''),
+        line(contentLines[2]),
+        line(contentLines[3]),
+        line(contentLines[4]),
+        bottom
+    ];
+}
+
+export async function stopwatchHandler() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        console.log(i18next.t('stopwatch.nonTtyTip'));
+        return;
+    }
+
+    await new Promise((resolve) => {
+        let renderedLineCount = 0;
+        let elapsedSeconds = 0;
+        let shouldExitApp = false;
+
+        const render = () => {
+            const lines = renderStopwatchBlock(elapsedSeconds);
+            if (renderedLineCount > 0) {
+                readline.moveCursor(process.stdout, 0, -renderedLineCount);
+                readline.cursorTo(process.stdout, 0);
+                readline.clearScreenDown(process.stdout);
+            }
+            process.stdout.write(`${lines.join('\n')}\n`);
+            renderedLineCount = lines.length;
+        };
+
+        const cleanup = () => {
+            clearInterval(timer);
+            process.stdin.off('data', onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            readline.cursorTo(process.stdout, 0);
+            readline.clearScreenDown(process.stdout);
+            process.stdout.write('\n');
+            if (shouldExitApp) {
+                console.log(i18next.t('menu.bye'));
+                process.exit(0);
+            }
+            resolve();
+        };
+
+        const onData = (chunk) => {
+            const key = chunk.toString().toLowerCase();
+            if (key === '0') {
+                shouldExitApp = true;
+                cleanup();
+                return;
+            }
+            if (key === '\r' || key === 'q' || key === '\u0003') {
+                cleanup();
+            }
+        };
+
+        const timer = setInterval(() => {
+            elapsedSeconds += 1;
+            render();
+        }, 1000);
+
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+        render();
+    });
+}

package/src/commands/url.js

@@ -7,7 +7,10 @@ export async function urlHandler() {
     const mode = await selectFromMenu(i18next.t('url.title'), [
         { name: i18next.t('url.encode'), value: 'encode' },
         { name: i18next.t('url.decode'), value: 'decode' }
-    ]);
+    ], true, i18next.t('common.back'));
+    if (mode === '__BACK__') {
+        return;
+    }
 
     const { input } = await inquirer.prompt([
         {

package/src/index.js

@@ -14,6 +14,9 @@ import { imgSplitHandler } from './commands/imgSplit.js';
 import { imgMergeHandler } from './commands/imgMerge.js';
 import { timeFormatHandler } from './commands/timeFormat.js';
 import { timeCalcHandler } from './commands/timeCalc.js';
+import { clockHandler } from './commands/clock.js';
+import { countdownHandler } from './commands/countdown.js';
+import { stopwatchHandler } from './commands/stopwatch.js';
 import { mockHandler } from './commands/mock.js';
 import { uuidHandler } from './commands/uuid.js';
 import { pinyinHandler } from './commands/pinyin.js';
@@ -84,6 +87,9 @@ function getFeatures() {
         // Utils (Time, Color, UUID, Hash)
         { name: i18next.t('menu.features.timeFormat'), value: 'timeFormat' },
         { name: i18next.t('menu.features.timeCalc'), value: 'timeCalc' },
+        { name: i18next.t('menu.features.clock'), value: 'clock' },
+        { name: i18next.t('menu.features.countdown'), value: 'countdown' },
+        { name: i18next.t('menu.features.stopwatch'), value: 'stopwatch' },
         { name: i18next.t('menu.features.color'), value: 'color' },
         { name: i18next.t('menu.features.colorPreview'), value: 'colorPreview' },
         { name: i18next.t('menu.features.uuid'), value: 'uuid' },
@@ -310,6 +316,15 @@ async function handleAction(action) {
         case 'timeCalc':
             await timeCalcHandler();
             break;
+        case 'clock':
+            await clockHandler();
+            break;
+        case 'countdown':
+            await countdownHandler();
+            break;
+        case 'stopwatch':
+            await stopwatchHandler();
+            break;
         case 'mock':
             await mockHandler();
             break;

package/src/locales/en.js

@@ -61,6 +61,9 @@ export default {
             pinyin: 'Chinese to Pinyin',
             timeFormat: 'Time Format / Timestamp',
             timeCalc: 'Time Calculation (Diff/Offset)',
+            clock: 'Console Clock',
+            countdown: 'Countdown Timer',
+            stopwatch: 'Stopwatch',
             color: 'Color Converter (Hex <-> RGB)',
             colorPreview: 'Color Preview',
             uuid: 'Get UUID',
@@ -131,6 +134,36 @@ export default {
         result: 'Result:',
         error: 'Error processing URL:'
     },
+    clock: {
+        title: 'Console Clock',
+        start: 'Console clock started. Press Enter / Q to go back.',
+        now: 'Current time: ',
+        exitTip: 'Press Enter / Q to go back, 0 to exit app'
+    },
+    countdown: {
+        title: 'Countdown Timer',
+        selectUnit: 'Select countdown unit',
+        unitSecond: 'Seconds',
+        unitMinute: 'Minutes',
+        unitHour: 'Hours',
+        inputPrompt: 'Enter countdown {{unit}} value:',
+        invalidAmount: 'Please enter a number greater than or equal to 0',
+        remaining: 'Remaining: ',
+        total: 'Total: ',
+        status: 'Status: ',
+        statusCounting: 'Counting down',
+        statusOvertime: 'Overtime',
+        exitTip: 'Press Enter / Q to go back, 0 to exit app',
+        nonTtyTip: 'Current terminal does not support dynamic countdown. Target duration: {{value}}'
+    },
+    stopwatch: {
+        title: 'Stopwatch',
+        elapsed: 'Elapsed: ',
+        status: 'Status: ',
+        statusRunning: 'Running',
+        exitTip: 'Press Enter / Q to go back, 0 to exit app',
+        nonTtyTip: 'Current terminal does not support dynamic stopwatch.'
+    },
     baseConvert: {
         inputPrompt: 'Enter number:',
         invalidInput: 'Please enter a valid number',

package/src/locales/zh.js

@@ -61,6 +61,9 @@ export default {
             pinyin: '汉字转拼音',
             timeFormat: '时间格式化 / 时间戳',
             timeCalc: '时间计算 (差值/偏移)',
+            clock: '控制台时钟',
+            countdown: '倒计时工具',
+            stopwatch: '计时工具',
             color: '颜色转换 (Hex <-> RGB)',
             colorPreview: '颜色预览',
             uuid: '生成 UUID',
@@ -131,6 +134,36 @@ export default {
         result: '结果:',
         error: '处理 URL 时出错:'
     },
+    clock: {
+        title: '控制台时钟',
+        start: '控制台时钟已启动，按 Enter / Q 返回上一步。',
+        now: '当前时间: ',
+        exitTip: '按 Enter / Q 返回上一步，按 0 直接退出'
+    },
+    countdown: {
+        title: '倒计时工具',
+        selectUnit: '请选择倒计时单位',
+        unitSecond: '秒',
+        unitMinute: '分钟',
+        unitHour: '小时',
+        inputPrompt: '请输入倒计时{{unit}}数值:',
+        invalidAmount: '请输入大于等于 0 的数字',
+        remaining: '剩余时间: ',
+        total: '倒计总时: ',
+        status: '当前状态: ',
+        statusCounting: '倒计时中',
+        statusOvertime: '已超时',
+        exitTip: '按 Enter / Q 返回上一步，按 0 直接退出',
+        nonTtyTip: '当前终端不支持动态倒计时。目标时长: {{value}}'
+    },
+    stopwatch: {
+        title: '计时工具',
+        elapsed: '已计时: ',
+        status: '当前状态: ',
+        statusRunning: '计时中',
+        exitTip: '按 Enter / Q 返回上一步，按 0 直接退出',
+        nonTtyTip: '当前终端不支持动态计时。'
+    },
     baseConvert: {
         inputPrompt: '请输入数字:',
         invalidInput: '请输入有效的数字',