xw-devtool-cli 1.0.7 → 1.0.8

package/README.md

@@ -26,6 +26,7 @@
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。
   - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
+  - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
 - **便捷操作**：
   - 支持文件选择对话框 (Windows)。
   - 结果自动复制到剪贴板。
@@ -72,6 +73,7 @@ b. Hash Calculator (MD5/SHA/SM3)
 c. QR Code Generator
 d. Special Characters (Symbols)
 e. Emoji Picker
+f. HTML Entity Encode/Decode
 0. Exit
 =================================
 ```
@@ -158,6 +160,14 @@ e. Emoji Picker
 - 分类展示常用 Emoji (表情、手势、动物、食物等)。
 - 输入编号选择并复制 Emoji 到剪贴板。
 
+### 15. HTML 实体编码/解码
+- 选择 `f` 进入。
+- 支持两种编码模式：
+  - **Standard**: 仅编码特殊字符（如 `<` `>` `&` 及非 ASCII 字符）。
+  - **Everything**: 编码所有字符（包括 ASCII 字母数字）。
+- 支持直接回车读取剪贴板内容。
+- 结果自动复制到剪贴板。
+
 ## 📄 License
 
 ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -48,6 +48,7 @@
     "clipboardy": "^5.0.2",
     "commander": "^14.0.2",
     "dayjs": "^1.11.19",
+    "he": "^1.2.0",
     "inquirer": "^13.1.0",
     "lorem-ipsum": "^2.0.8",
     "pinyin": "^4.0.0",

package/src/commands/htmlEntities.js

@@ -0,0 +1,57 @@
+import inquirer from 'inquirer';
+import he from 'he';
+import { copy, read } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+export async function htmlEntitiesHandler() {
+    const mode = await selectFromMenu('HTML Entity Encode/Decode', [
+        { name: 'Encode (Standard - Special chars only)', value: 'encode' },
+        { name: 'Encode (Everything - All chars)', value: 'encodeAll' },
+        { name: 'Decode (HTML Entities -> Text)', value: 'decode' }
+    ]);
+
+    const actionName = mode.startsWith('encode') ? 'encode' : 'decode';
+
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: `Enter text to ${actionName} (Press Enter to paste from clipboard):`
+        }
+    ]);
+
+    let textToProcess = input;
+
+    if (!textToProcess || textToProcess.trim().length === 0) {
+        textToProcess = await read();
+        if (!textToProcess || textToProcess.trim().length === 0) {
+            console.log('Clipboard is empty or could not be read.');
+            return;
+        }
+        console.log(`\nUsing clipboard content: "${textToProcess.length > 50 ? textToProcess.substring(0, 47) + '...' : textToProcess}"`);
+    }
+
+    let result;
+    try {
+        if (mode === 'encode') {
+            // Standard encode: only special chars like < > & " ' and non-ASCII
+            result = he.encode(textToProcess, { encodeEverything: false });
+        } else if (mode === 'encodeAll') {
+            // Encode everything: includes ASCII alphanumeric
+            result = he.encode(textToProcess, { encodeEverything: true });
+        } else {
+            result = he.decode(textToProcess);
+        }
+        
+        console.log(`\nResult:\n${result}\n`);
+        
+        if (mode === 'encode' && result === textToProcess) {
+             console.log('(Note: No special characters were found to encode. Use "Encode (Everything)" if you want to encode standard letters.)\n');
+        }
+
+        await copy(result);
+        console.log('Result copied to clipboard!');
+    } catch (e) {
+        console.error(`Error processing HTML entities (${mode}):`, e.message);
+    }
+}

package/src/index.js

@@ -14,6 +14,7 @@ import { hashingHandler } from './commands/hashing.js';
 import { qrcodeHandler } from './commands/qrcode.js';
 import { specialCharsHandler } from './commands/specialChars.js';
 import { emojiHandler } from './commands/emoji.js';
+import { htmlEntitiesHandler } from './commands/htmlEntities.js';
 
 process.on('SIGINT', () => {
     console.log('\nBye!');
@@ -44,7 +45,8 @@ const features = [
     { name: 'Hash Calculator (MD5/SHA/SM3)', value: 'hashing' },
     { name: 'QR Code Generator', value: 'qrcode' },
     { name: 'Special Characters (Symbols)', value: 'specialChars' },
-    { name: 'Emoji Picker', value: 'emoji' }
+    { name: 'Emoji Picker', value: 'emoji' },
+    { name: 'HTML Entity Encode/Decode', value: 'htmlEntities' }
 ];
 
 async function main() {
@@ -165,6 +167,9 @@ async function handleAction(action) {
         case 'emoji':
             await emojiHandler();
             break;
+        case 'htmlEntities':
+            await htmlEntitiesHandler();
+            break;
         default:
             console.log('Feature not implemented yet.');
     }