xw-devtool-cli 1.0.14 → 1.0.16

package/README.md

@@ -2,7 +2,7 @@
 
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
-主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全等。所有结果均自动复制到剪贴板，极大提升开发效率。
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全、Markdown 语法工具、VS Code 代码段生成等。所有结果均自动复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -30,6 +30,8 @@
   - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
   - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
+  - **Markdown 语法工具**：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
+  - **VS Code 代码段生成器**：将代码转换为 VS Code Snippet JSON，自动生成语法速查表注释。
   - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
 - **便捷操作**：
   - 支持文件选择对话框 (Windows)。
@@ -82,6 +84,8 @@ g. Hash Calculator (MD5/SHA/SM3)
 h. Mock Text
 i. Special Characters (Symbols)
 j. Emoji Picker
+k. Markdown Snippets
+l. VS Code Snippet Generator
 0. Exit
 =================================
 ```
@@ -231,6 +235,28 @@ j. Emoji Picker
 - 分类展示常用 Emoji (表情、手势、动物、食物等)。
 - 输入编号选择并复制 Emoji 到剪贴板。
 
+### 20. Markdown 语法工具 (Markdown Snippets)
+- 选择 `k` 进入。
+- 提供常用的 Markdown 语法模板，分类包括：
+  - **Headers**: 标题 (H1-H6)。
+  - **Emphasis**: 加粗、斜体、删除线。
+  - **Lists**: 无序列表、有序列表、任务列表。
+  - **Links & Images**: 链接、图片插入。
+  - **Code**: 行内代码、代码块。
+  - **Tables**: 表格模板。
+  - **Others**: 引用、分割线、折叠详情等。
+- 选择对应语法后，模板将自动复制到剪贴板。
+
+### 21. VS Code 代码段生成器 (VS Code Snippet Generator)
+- 选择 `l` 进入。
+- **Generate Snippet**: 将任意代码转换为 VS Code 的 `.code-snippets` JSON 格式。
+  - 支持从 **剪贴板**、**文件** 或 **手动输入** 获取代码。
+  - 自动转义双引号和换行符，生成 `body` 数组。
+  - 输入 Snippet Name, Prefix (Trigger), Description。
+  - 结果自动复制到剪贴板，可直接粘贴到 VS Code 的 Snippet 配置文件中。
+  - **注意**：为防止长文本刷屏，结果**仅自动复制到剪贴板**，不会在终端打印。
+  - **提示**：生成的代码段会自动包含语法速查表 (Syntax Cheatsheet) 作为注释，方便参考。
+
 ## 📄 License
 
 ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -20,17 +20,35 @@
   "keywords": [
     "cli",
     "devtools",
+    "developer-tools",
+    "toolbox",
+    "utility",
     "base64",
-    "url",
+    "url-encode",
+    "unicode",
+    "html-entities",
     "uuid",
     "pinyin",
     "mock",
+    "mock-data",
     "timestamp",
     "time",
+    "date-calculation",
     "image",
+    "image-conversion",
     "webp",
     "jpg",
-    "png"
+    "png",
+    "placeholder-image",
+    "qrcode",
+    "json-format",
+    "variable-case",
+    "hash",
+    "encryption",
+    "md5",
+    "color-converter",
+    "emoji",
+    "markdown"
   ],
   "author": "npmxw",
   "license": "ISC",

package/src/commands/markdown.js

@@ -0,0 +1,75 @@
+import { selectFromMenu } from '../utils/menu.js';
+import { copy } from '../utils/clipboard.js';
+import inquirer from 'inquirer';
+
+const MARKDOWN_SNIPPETS = {
+    'headers': [
+        { name: 'H1 Header (#)', value: '# Header 1' },
+        { name: 'H2 Header (##)', value: '## Header 2' },
+        { name: 'H3 Header (###)', value: '### Header 3' },
+        { name: 'H4 Header (####)', value: '#### Header 4' },
+    ],
+    'emphasis': [
+        { name: 'Bold (**text**)', value: '**Bold Text**' },
+        { name: 'Italic (*text*)', value: '*Italic Text*' },
+        { name: 'Bold Italic (***text***)', value: '***Bold Italic Text***' },
+        { name: 'Strikethrough (~~text~~)', value: '~~Strikethrough Text~~' },
+    ],
+    'lists': [
+        { name: 'Unordered List (-)', value: '- Item 1\n- Item 2\n- Item 3' },
+        { name: 'Ordered List (1.)', value: '1. Item 1\n2. Item 2\n3. Item 3' },
+        { name: 'Task List (- [ ])', value: '- [ ] To Do\n- [x] Done' },
+    ],
+    'links_images': [
+        { name: 'Link [text](url)', value: '[Link Text](https://example.com)' },
+        { name: 'Image ![alt](url)', value: '![Alt Text](https://example.com/image.jpg)' },
+        { name: 'Link with Title', value: '[Link Text](https://example.com "Title")' },
+    ],
+    'code': [
+        { name: 'Inline Code (`text`)', value: '`code`' },
+        { name: 'Code Block (```)', value: '```javascript\nconsole.log("Hello World");\n```' },
+    ],
+    'tables': [
+        { name: 'Table (3x3)', value: '| Header 1 | Header 2 | Header 3 |\n| :--- | :---: | ---: |\n| Left | Center | Right |\n| Item 1 | Item 2 | Item 3 |' },
+    ],
+    'others': [
+        { name: 'Blockquote (>)', value: '> This is a quote.' },
+        { name: 'Horizontal Rule (---)', value: '---' },
+        { name: 'Details/Summary (<details>)', value: '<details>\n<summary>Click to expand</summary>\n\nHidden content here.\n</details>' },
+    ]
+};
+
+export async function markdownHandler() {
+    while (true) {
+        const category = await selectFromMenu('Markdown Snippets', [
+            { name: 'Headers (H1-H6)', value: 'headers' },
+            { name: 'Emphasis (Bold, Italic...)', value: 'emphasis' },
+            { name: 'Lists (Bullet, Numbered, Task)', value: 'lists' },
+            { name: 'Links & Images', value: 'links_images' },
+            { name: 'Code (Inline, Block)', value: 'code' },
+            { name: 'Tables', value: 'tables' },
+            { name: 'Others (Quote, HR, Details)', value: 'others' },
+            { name: 'Back to Main Menu', value: 'back' }
+        ]);
+
+        if (category === 'back') {
+            break;
+        }
+
+        const snippets = MARKDOWN_SNIPPETS[category];
+        const snippetValue = await selectFromMenu('Select Snippet', [
+            ...snippets,
+            { name: 'Back', value: 'back' }
+        ]);
+
+        if (snippetValue === 'back') {
+            continue;
+        }
+
+        await copy(snippetValue);
+        
+        // Optional: ask if user wants to continue or exit
+        // For now, loop back to category selection is consistent with other tools or just exit?
+        // Let's loop back to categories to allow picking another one.
+    }
+}

package/src/commands/vscodeSnippet.js

@@ -0,0 +1,95 @@
+import inquirer from 'inquirer';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+import fs from 'fs';
+
+export async function vscodeSnippetHandler() {
+    await generateSnippet();
+}
+
+async function generateSnippet() {
+    const inputSource = await selectFromMenu('VS Code Snippet Generator - Select Code Source', [
+        { name: 'Clipboard (Paste automatically)', value: 'clipboard' },
+        { name: 'Manual Input', value: 'manual' },
+        { name: 'File', value: 'file' }
+    ]);
+
+    let code = '';
+    if (inputSource === 'clipboard') {
+        const clipboardy = (await import('clipboardy')).default;
+        code = await clipboardy.read();
+    } else if (inputSource === 'file') {
+        const { filePath } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'filePath',
+                message: 'Enter file path:'
+            }
+        ]);
+        try {
+            code = fs.readFileSync(filePath.replace(/"/g, ''), 'utf-8');
+        } catch (e) {
+            console.error('Error reading file:', e.message);
+            return;
+        }
+    } else {
+        const { manualInput } = await inquirer.prompt([
+            {
+                type: 'editor',
+                name: 'manualInput',
+                message: 'Enter/Paste your code (Close editor to finish):'
+            }
+        ]);
+        code = manualInput;
+    }
+
+    if (!code) {
+        console.log('No code provided.');
+        return;
+    }
+
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Snippet Name (e.g. "React Component"):',
+            validate: input => input ? true : 'Name is required'
+        },
+        {
+            type: 'input',
+            name: 'prefix',
+            message: 'Snippet Prefix (Trigger) (e.g. "rfc"):',
+            validate: input => input ? true : 'Prefix is required'
+        },
+        {
+            type: 'input',
+            name: 'description',
+            message: 'Description (optional):'
+        }
+    ]);
+
+    // Convert code to array of lines
+    const lines = code.split(/\r?\n/);
+    
+    // We construct the object
+    const snippetObj = {
+        [answers.name]: {
+            prefix: answers.prefix,
+            body: lines,
+            description: answers.description || answers.name
+        }
+    };
+
+    const jsonOutput = JSON.stringify(snippetObj, null, 4);
+    
+    // Add syntax cheatsheet as comments
+    const finalOutput = `// VS Code Snippet Syntax Help:
+// 1. Tabstops: $1, $2... $0 (final cursor position)
+// 2. Placeholders: \${1:default value}
+// 3. Choices: \${1|one,two,three|}
+// 4. Variables: $TM_FILENAME, $CURRENT_YEAR, $CLIPBOARD...
+
+${jsonOutput}`;
+
+    await copy(finalOutput);
+}

package/src/index.js

@@ -19,6 +19,8 @@ import { specialCharsHandler } from './commands/specialChars.js';
 import { emojiHandler } from './commands/emoji.js';
 import { htmlEntitiesHandler } from './commands/htmlEntities.js';
 import { placeholderImgHandler } from './commands/placeholderImg.js';
+import { markdownHandler } from './commands/markdown.js';
+import { vscodeSnippetHandler } from './commands/vscodeSnippet.js';
 
 process.on('SIGINT', () => {
     console.log('\nBye!');
@@ -61,7 +63,9 @@ const features = [
     // Content/Mocking
     { name: 'Mock Text', value: 'mock' },
     { name: 'Special Characters (Symbols)', value: 'specialChars' },
-    { name: 'Emoji Picker', value: 'emoji' }
+    { name: 'Emoji Picker', value: 'emoji' },
+    { name: 'Markdown Snippets', value: 'markdown' },
+    { name: 'VS Code Snippet Generator', value: 'vscodeSnippet' }
 ];
 
 async function main() {
@@ -197,6 +201,12 @@ async function handleAction(action) {
         case 'placeholderImg':
             await placeholderImgHandler();
             break;
+        case 'markdown':
+            await markdownHandler();
+            break;
+        case 'vscodeSnippet':
+            await vscodeSnippetHandler();
+            break;
         default:
             console.log('Feature not implemented yet.');
     }