xw-devtool-cli 1.0.45 → 1.0.46

package/README.md

@@ -44,6 +44,7 @@
   - **UUID**：生成 UUID v4。
   - **中文转拼音**：将汉字转换为不带声调的拼音。
   - **进制转换**：支持二进制、八进制、十进制、十六进制之间的互相转换。
+  - **数字转大写**：支持普通数字转中文大写与人民币金额大写，输入支持剪贴板/手动输入，结果直接复制到剪贴板。
   - **颜色转换**：Hex <-> RGB 互转，并在结果中显示颜色条预览（支持透明度棋盘背景），自动复制 Hex。
   - **颜色预览**：输入颜色并在终端显示颜色条，便于快速视觉确认，同时自动复制 Hex 到剪贴板。
   - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
@@ -186,6 +187,17 @@ x. 设置 / 语言 (Settings)
   - **复制到剪贴板**：自动复制结果，便于粘贴到文档或 Issue 中。
   - **输出为 txt 文件**：可选择保存位置，默认文件名带时间戳，避免覆盖旧文件。
 
+### 数字转大写
+- 在菜单中选择 `数字转大写` 进入。
+- 支持两种转换模式：
+  - **数字转中文大写**：如 `1203.45` -> `壹仟贰佰零叁点肆伍`。
+  - **数字转人民币大写**：如 `1203.45` -> `壹仟贰佰零叁元肆角伍分`（自动按分四舍五入）。
+- 输入来源支持：
+  - **从剪贴板读取**
+  - **手动输入数字**
+- 输出结果会直接复制到剪贴板。
+- 控制台会同步显示转换结果，便于快速核对。
+
 ### 3. 占位图生成 (Placeholder Image)
 - 选择 `3` 进入。
 - **模式 1：本地图片文件 (Local Image File)**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.45",
+  "version": "1.0.46",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -73,7 +73,9 @@
     "commit-message",
     "conventional-commits",
     "directory-tree",
-    "file-tree"
+    "file-tree",
+    "number-to-chinese-uppercase",
+    "rmb-uppercase"
   ],
   "author": "npmxw",
   "license": "ISC",

package/src/commands/numberUpper.js

@@ -0,0 +1,236 @@
+import inquirer from 'inquirer';
+import clipboardy from 'clipboardy';
+import i18next from '../i18n.js';
+import { read } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+const UPPER_DIGITS = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
+const SECTION_UNITS = ['', '万', '亿', '兆', '京'];
+const POSITION_UNITS = ['', '拾', '佰', '仟'];
+
+function normalizeRawNumber(raw) {
+    return raw.replace(/,/g, '').trim();
+}
+
+function isValidNumberText(text) {
+    return /^-?\d+(\.\d+)?$/.test(text);
+}
+
+function convertFourDigits(section) {
+    const padded = section.padStart(4, '0');
+    let result = '';
+    let needZero = false;
+
+    for (let i = 0; i < 4; i++) {
+        const num = Number(padded[i]);
+        const unit = POSITION_UNITS[3 - i];
+        if (num === 0) {
+            needZero = true;
+            continue;
+        }
+        if (needZero && result) {
+            result += UPPER_DIGITS[0];
+        }
+        result += `${UPPER_DIGITS[num]}${unit}`;
+        needZero = false;
+    }
+    return result;
+}
+
+function convertIntegerPart(integerText) {
+    const normalized = integerText.replace(/^0+/, '') || '0';
+    if (normalized === '0') {
+        return UPPER_DIGITS[0];
+    }
+
+    const sections = [];
+    for (let i = normalized.length; i > 0; i -= 4) {
+        const start = Math.max(0, i - 4);
+        sections.unshift(normalized.slice(start, i));
+    }
+
+    let result = '';
+    let previousZeroSection = false;
+
+    for (let i = 0; i < sections.length; i++) {
+        const section = sections[i];
+        const sectionValue = Number(section);
+        const sectionUnit = SECTION_UNITS[sections.length - 1 - i] || '';
+
+        if (sectionValue === 0) {
+            previousZeroSection = true;
+            continue;
+        }
+
+        if (previousZeroSection && result) {
+            result += UPPER_DIGITS[0];
+        }
+
+        result += `${convertFourDigits(section)}${sectionUnit}`;
+        previousZeroSection = false;
+    }
+
+    return result || UPPER_DIGITS[0];
+}
+
+function normalizeMoney(numberText) {
+    const isNegative = numberText.startsWith('-');
+    const absolute = isNegative ? numberText.slice(1) : numberText;
+    const [integerPartRaw, decimalPartRaw = ''] = absolute.split('.');
+
+    let integerPart = integerPartRaw.replace(/^0+/, '') || '0';
+    const decimal = decimalPartRaw.padEnd(3, '0').slice(0, 3);
+    let jiao = Number(decimal[0]);
+    let fen = Number(decimal[1]);
+    const third = Number(decimal[2]);
+
+    if (third >= 5) {
+        fen += 1;
+        if (fen === 10) {
+            fen = 0;
+            jiao += 1;
+            if (jiao === 10) {
+                jiao = 0;
+                integerPart = (BigInt(integerPart) + 1n).toString();
+            }
+        }
+    }
+
+    return {
+        isNegative,
+        integerPart,
+        jiao,
+        fen
+    };
+}
+
+export function convertNumberToChineseUpper(rawNumber) {
+    const normalized = normalizeRawNumber(rawNumber);
+    if (!isValidNumberText(normalized)) {
+        throw new Error(i18next.t('numberUpper.invalidNumber'));
+    }
+
+    const isNegative = normalized.startsWith('-');
+    const absolute = isNegative ? normalized.slice(1) : normalized;
+    const [integerPart, decimalPart = ''] = absolute.split('.');
+    const integerResult = convertIntegerPart(integerPart || '0');
+    const decimalResult = decimalPart
+        .split('')
+        .map((digit) => UPPER_DIGITS[Number(digit)])
+        .join('');
+
+    let result = integerResult;
+    if (decimalResult) {
+        result = `${result}${i18next.t('numberUpper.dot')}${decimalResult}`;
+    }
+    if (isNegative) {
+        result = `${i18next.t('numberUpper.negative')}${result}`;
+    }
+    return result;
+}
+
+export function convertNumberToRmbUpper(rawNumber) {
+    const normalized = normalizeRawNumber(rawNumber);
+    if (!isValidNumberText(normalized)) {
+        throw new Error(i18next.t('numberUpper.invalidNumber'));
+    }
+
+    const { isNegative, integerPart, jiao, fen } = normalizeMoney(normalized);
+    const integerResult = convertIntegerPart(integerPart);
+    let result = `${integerResult}${i18next.t('numberUpper.yuan')}`;
+
+    if (jiao === 0 && fen === 0) {
+        result += i18next.t('numberUpper.whole');
+    } else if (jiao === 0 && fen > 0) {
+        if (integerPart !== '0') {
+            result += UPPER_DIGITS[0];
+        }
+        result += `${UPPER_DIGITS[fen]}${i18next.t('numberUpper.fen')}`;
+    } else {
+        result += `${UPPER_DIGITS[jiao]}${i18next.t('numberUpper.jiao')}`;
+        if (fen > 0) {
+            result += `${UPPER_DIGITS[fen]}${i18next.t('numberUpper.fen')}`;
+        }
+    }
+
+    if (isNegative) {
+        result = `${i18next.t('numberUpper.negative')}${result}`;
+    }
+
+    return result;
+}
+
+async function resolveInputBySource(source) {
+    if (source === 'clipboard') {
+        const text = (await read()).trim();
+        if (!text) {
+            throw new Error(i18next.t('numberUpper.clipboardEmpty'));
+        }
+        return text;
+    }
+
+    const answer = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'number',
+            message: i18next.t('numberUpper.enterNumber'),
+            validate: (value) => {
+                const normalized = normalizeRawNumber(value);
+                if (!normalized) {
+                    return i18next.t('numberUpper.emptyInput');
+                }
+                return isValidNumberText(normalized) ? true : i18next.t('numberUpper.invalidNumber');
+            }
+        }
+    ]);
+    return answer.number.trim();
+}
+
+export async function numberUpperHandler() {
+    const mode = await selectFromMenu(
+        i18next.t('numberUpper.modeTitle'),
+        [
+            { name: i18next.t('numberUpper.modeDigit'), value: 'digit' },
+            { name: i18next.t('numberUpper.modeRmb'), value: 'rmb' }
+        ],
+        true,
+        i18next.t('common.back')
+    );
+    if (mode === '__BACK__') {
+        return;
+    }
+
+    const source = await selectFromMenu(
+        i18next.t('numberUpper.sourceTitle'),
+        [
+            { name: i18next.t('numberUpper.sourceClipboard'), value: 'clipboard' },
+            { name: i18next.t('numberUpper.sourceManual'), value: 'manual' }
+        ],
+        true,
+        i18next.t('common.back')
+    );
+    if (source === '__BACK__') {
+        return;
+    }
+
+    try {
+        const input = await resolveInputBySource(source);
+        if (input === '__BACK__') {
+            return;
+        }
+
+        const normalized = normalizeRawNumber(input);
+        const result = mode === 'rmb'
+            ? convertNumberToRmbUpper(normalized)
+            : convertNumberToChineseUpper(normalized);
+        console.log(`\n${i18next.t('numberUpper.resultLabel')} ${result}\n`);
+        try {
+            await clipboardy.write(result);
+            console.log(i18next.t('numberUpper.copied'));
+        } catch (copyError) {
+            console.error(i18next.t('numberUpper.copyFailed', { message: copyError.message }));
+        }
+    } catch (error) {
+        console.error(error.message);
+    }
+}

package/src/index.js

@@ -6,6 +6,7 @@ import { saveConfig } from './utils/config.js';
 
 import { urlHandler } from './commands/url.js';
 import { baseConvertHandler } from './commands/baseConvert.js';
+import { numberUpperHandler } from './commands/numberUpper.js';
 import { base64Handler } from './commands/base64.js';
 import { unicodeHandler } from './commands/unicode.js';
 import { imgBase64Handler } from './commands/imgBase64.js';
@@ -77,6 +78,7 @@ function getFeatures() {
         // Encode/Decode & Formatting
         { name: i18next.t('menu.features.url'), value: 'url' },
         { name: i18next.t('menu.features.baseConvert'), value: 'baseConvert' },
+        { name: i18next.t('menu.features.numberUpper'), value: 'numberUpper' },
         { name: i18next.t('menu.features.base64'), value: 'base64' },
         { name: i18next.t('menu.features.unicode'), value: 'unicode' },
         { name: i18next.t('menu.features.htmlEntities'), value: 'htmlEntities' },
@@ -277,6 +279,9 @@ async function handleAction(action) {
         case 'baseConvert':
             await baseConvertHandler();
             break;
+        case 'numberUpper':
+            await numberUpperHandler();
+            break;
         case 'base64':
             await base64Handler();
             break;

package/src/locales/en.js

@@ -53,6 +53,7 @@ export default {
             qrcodeDecode: 'QR Code Reader',
             url: 'URL Encode/Decode',
             baseConvert: 'Number Base Converter',
+            numberUpper: 'Number to Chinese Uppercase',
             base64: 'String Encode/Decode (Base64)',
             unicode: 'Unicode Encode/Decode',
             htmlEntities: 'HTML Entity Encode/Decode',
@@ -173,6 +174,40 @@ export default {
         error: 'Invalid number for the selected base.',
         copyPrompt: 'Select format to copy'
     },
+    numberUpper: {
+        modeTitle: 'Select conversion mode',
+        modeDigit: 'Number to Chinese uppercase',
+        modeRmb: 'Number to RMB uppercase',
+        sourceTitle: 'Select input source',
+        sourceClipboard: 'Read from clipboard',
+        sourceFile: 'Read from local file',
+        sourceManual: 'Enter number manually',
+        fileInputMethod: 'Select file input method',
+        fileInputDialog: 'Select file (dialog)',
+        fileInputManual: 'Enter file path manually',
+        dialogUnavailable: 'File dialog is unavailable or canceled. Please enter the file path manually.',
+        enterFilePath: 'Enter number file path:',
+        fileNotFound: 'File does not exist.',
+        readFileError: 'Failed to read file: {{message}}',
+        clipboardEmpty: 'Clipboard is empty. Please copy the number first.',
+        emptyInput: 'Input cannot be empty.',
+        enterNumber: 'Enter number (supports negative and decimal):',
+        invalidNumber: 'Please enter a valid number (e.g. 123, -45.67)',
+        outputMode: 'Select output method',
+        outputClipboard: 'Copy to clipboard',
+        outputFile: 'Save to file',
+        enterOutputPath: 'Enter output file path:',
+        outputPathRequired: 'Output file path cannot be empty.',
+        negative: 'Negative ',
+        dot: ' point ',
+        yuan: ' Yuan',
+        jiao: ' Jiao',
+        fen: ' Fen',
+        whole: ' Only',
+        resultLabel: 'Result:',
+        copied: 'Copied to clipboard',
+        copyFailed: 'Failed to copy to clipboard: {{message}}'
+    },
     jsonFormat: {
         selectSource: 'Select JSON input source',
         sourceClipboard: 'Read from clipboard',

package/src/locales/zh.js

@@ -53,6 +53,7 @@ export default {
             qrcodeDecode: '二维码识别',
             url: 'URL 编码/解码',
             baseConvert: '进制转换工具',
+            numberUpper: '数字转大写',
             base64: '字符串 编码/解码 (Base64)',
             unicode: 'Unicode 编码/解码',
             htmlEntities: 'HTML 实体 编码/解码',
@@ -173,6 +174,40 @@ export default {
         error: '输入的数字对于所选进制无效。',
         copyPrompt: '选择要复制的格式'
     },
+    numberUpper: {
+        modeTitle: '选择转换模式',
+        modeDigit: '数字转中文大写',
+        modeRmb: '数字转人民币大写',
+        sourceTitle: '选择输入来源',
+        sourceClipboard: '从剪贴板读取',
+        sourceFile: '从本地文件读取',
+        sourceManual: '手动输入数字',
+        fileInputMethod: '选择文件读取方式',
+        fileInputDialog: '选择文件（对话框）',
+        fileInputManual: '手动输入文件路径',
+        dialogUnavailable: '文件对话框不可用或已取消，请手动输入文件路径。',
+        enterFilePath: '请输入数字文件路径:',
+        fileNotFound: '文件不存在。',
+        readFileError: '读取文件失败: {{message}}',
+        clipboardEmpty: '剪贴板为空，请先复制数字。',
+        emptyInput: '输入内容不能为空。',
+        enterNumber: '请输入数字（支持负数和小数）:',
+        invalidNumber: '请输入有效数字（如 123、-45.67）',
+        outputMode: '选择输出方式',
+        outputClipboard: '复制到剪贴板',
+        outputFile: '保存到文件',
+        enterOutputPath: '请输入输出文件路径:',
+        outputPathRequired: '输出文件路径不能为空。',
+        negative: '负',
+        dot: '点',
+        yuan: '元',
+        jiao: '角',
+        fen: '分',
+        whole: '整',
+        resultLabel: '转换结果：',
+        copied: '已复制到剪贴板',
+        copyFailed: '复制到剪贴板失败: {{message}}'
+    },
     jsonFormat: {
         selectSource: '选择 JSON 输入来源',
         sourceClipboard: '从剪贴板读取',