xw-devtool-cli 1.0.23 → 1.0.24

package/README.md

@@ -28,6 +28,7 @@
   - **UUID**：生成 UUID v4。
   - **中文转拼音**：将汉字转换为不带声调的拼音。
   - **颜色转换**：Hex <-> RGB 互转。
+  - **颜色预览**：输入颜色并在终端显示颜色条，便于快速视觉确认，同时自动复制 Hex 到剪贴板。
   - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
   - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。

package/README_EN.md

@@ -27,6 +27,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **UUID**: Generate UUID v4.
   - **Pinyin**: Convert Chinese characters to Pinyin (without tone).
   - **Color Converter**: Hex <-> RGB.
+  - **Color Preview**: Enter a color and display a color bar in terminal for quick visual confirmation; Hex is auto-copied to clipboard.
   - **Variable Format**: CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
   - **Hash Calculator**: MD5, SHA1, SHA256, SHA512, SM3.
   - **QR Code**: Display QR codes in terminal, save as PNG.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",

package/src/commands/colorPreview.js

@@ -0,0 +1,72 @@
+import inquirer from 'inquirer';
+import tinycolor from 'tinycolor2';
+import { copy } from '../utils/clipboard.js';
+import i18next from '../i18n.js';
+// No width/height selection per user request; fixed size preview
+
+function blend(fg, bg, alpha) {
+    const a = Math.max(0, Math.min(1, alpha ?? 1));
+    return {
+        r: Math.round(a * fg.r + (1 - a) * bg.r),
+        g: Math.round(a * fg.g + (1 - a) * bg.g),
+        b: Math.round(a * fg.b + (1 - a) * bg.b),
+    };
+}
+
+function printColorBar(rgb, width = 50, height = 2, label = '', alpha = 1) {
+    const reset = '\x1b[0m';
+    const block = ' ';
+    if (label) {
+        console.log(label);
+    }
+    const useChecker = alpha < 1;
+    const bg1 = { r: 255, g: 255, b: 255 };
+    const bg2 = { r: 204, g: 204, b: 204 };
+    for (let row = 0; row < height; row++) {
+        let line = '';
+        for (let col = 0; col < width; col++) {
+            const checker = ((Math.floor(row / 1) + Math.floor(col / 2)) % 2 === 0) ? bg1 : bg2;
+            const blended = useChecker ? blend(rgb, checker, alpha) : rgb;
+            const bg = `\x1b[48;2;${blended.r};${blended.g};${blended.b}m`;
+            line += `${bg}${block}`;
+        }
+        line += reset;
+        console.log(line);
+    }
+}
+
+function isAllowedColorFormat(val) {
+    if (!val || typeof val !== 'string') return false;
+    const s = val.trim();
+    const hex = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+    const rgb = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i;
+    const rgba = /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(?:0|1|0?\.\d+)\s*\)$/i;
+    const hsl = /^hsl\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*\)$/i;
+    const hsla = /^hsla\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*,\s*(?:0|1|0?\.\d+)\s*\)$/i;
+    return hex.test(s) || rgb.test(s) || rgba.test(s) || hsl.test(s) || hsla.test(s);
+}
+
+export async function colorPreviewHandler() {
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: i18next.t('colorPreview.input'),
+            validate: (val) => isAllowedColorFormat(val) || i18next.t('colorPreview.invalid')
+        }
+    ]);
+
+    const color = tinycolor(input);
+    const rgb = color.toRgb();
+    const alpha = typeof rgb.a === 'number' ? rgb.a : 1;
+    const hex = alpha < 1 ? color.toHex8String().toUpperCase() : color.toHexString().toUpperCase();
+
+    const width = 50;
+    const height = 2;
+
+    const label = `${i18next.t('colorPreview.preview')} ${hex} ${color.toRgbString()} ${color.toHslString()}`;
+    printColorBar(rgb, width, height, label, alpha);
+
+    await copy(hex);
+    console.log(i18next.t('colorPreview.copied', { value: hex }));
+}

package/src/index.js

@@ -15,6 +15,7 @@ import { mockHandler } from './commands/mock.js';
 import { uuidHandler } from './commands/uuid.js';
 import { pinyinHandler } from './commands/pinyin.js';
 import { colorHandler } from './commands/color.js';
+import { colorPreviewHandler } from './commands/colorPreview.js';
 import { variableFormatHandler } from './commands/variableFormat.js';
 import { jsonFormatHandler } from './commands/jsonFormat.js';
 import { hashingHandler } from './commands/hashing.js';
@@ -65,6 +66,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.timeFormat'), value: 'timeFormat' },
         { name: i18next.t('menu.features.timeCalc'), value: 'timeCalc' },
         { name: i18next.t('menu.features.color'), value: 'color' },
+        { name: i18next.t('menu.features.colorPreview'), value: 'colorPreview' },
         { name: i18next.t('menu.features.uuid'), value: 'uuid' },
         { name: i18next.t('menu.features.hashing'), value: 'hashing' },
 
@@ -200,6 +202,9 @@ async function handleAction(action) {
         case 'color':
             await colorHandler();
             break;
+        case 'colorPreview':
+            await colorPreviewHandler();
+            break;
         case 'variableFormat':
             await variableFormatHandler();
             break;

package/src/locales/en.js

@@ -22,6 +22,7 @@ export default {
             timeFormat: 'Time Format / Timestamp',
             timeCalc: 'Time Calculation (Diff/Offset)',
             color: 'Color Converter (Hex <-> RGB)',
+            colorPreview: 'Color Preview',
             uuid: 'Get UUID',
             hashing: 'Hash Calculator (MD5/SHA/SM3)',
             mock: 'Mock Text',
@@ -37,6 +38,12 @@ export default {
         saved: 'Language saved. Please restart the tool or continue using the menu.',
         backToMenu: 'Back to Menu'
     },
+    colorPreview: {
+        input: 'Enter color (Hex/RGB/HSL):',
+        invalid: 'Invalid color format',
+        preview: 'Preview:',
+        copied: 'Copied to clipboard: {{value}}'
+    },
     url: {
         title: 'URL Encode/Decode',
         encode: 'Encode',

package/src/locales/zh.js

@@ -22,6 +22,7 @@ export default {
             timeFormat: '时间格式化 / 时间戳',
             timeCalc: '时间计算 (差值/偏移)',
             color: '颜色转换 (Hex <-> RGB)',
+            colorPreview: '颜色预览',
             uuid: '生成 UUID',
             hashing: '哈希计算 (MD5/SHA/SM3)',
             mock: 'Mock 文本生成',
@@ -37,6 +38,12 @@ export default {
         saved: '语言已保存。请继续使用。',
         backToMenu: '返回主菜单'
     },
+    colorPreview: {
+        input: '输入颜色 (Hex/RGB/HSL):',
+        invalid: '颜色格式无效',
+        preview: '预览:',
+        copied: '已复制到剪贴板: {{value}}'
+    },
     url: {
         title: 'URL 编码/解码',
         encode: '编码',