xw-devtool-cli 1.0.0

package/README.md

@@ -0,0 +1,73 @@
+# xw-devtool-cli
+
+一个上手即用的命令行工具箱，帮你快速完成常见开发小任务：URL 编解码、字符串 Base64、图片与 Base64 互转、时间格式化与当前时间戳、Mock 文本（中/英）、UUID、中文转拼音等,且工具持续添加中......,结果会自动复制到剪贴板，方便粘贴到代码或文档。
+
+## 安装
+- 全局安装：`npm i -g xw-devtool-cli`
+- 启动：在终端运行 `xw-devtool`
+- 免安装一次性使用：`npx xw-devtool@latest`
+
+## 快速开始
+启动后显示主菜单，输入数字选择功能：
+```
+1. URL Encode/Decode
+2. String Encode/Decode (Base64)
+3. Image <-> Base64
+4. Time Format
+5. Get Current Timestamp
+6. Mock Text
+7. Get UUID
+8. Chinese to Pinyin
+0. Exit
+```
+
+## 常用操作
+- URL 编解码
+  - 选择 `1` → 选择 `Encode` 或 `Decode` → 输入 URL → 结果自动复制
+- 字符串 Base64
+  - 选择 `2` → 选择 `Encode` 或 `Decode`
+  - 选择输入来源：`Clipboard`（推荐长文本）/ `File` / `Manual input`
+  - 选择输出方式：`Copy to clipboard` / `Save to file` / `Preview + copy`
+  - 保存文件会给出默认文件名：`base64-[encode|decode]-<timestamp>.txt`
+- 图片 ↔ Base64
+  - 图片 → Base64：选择 `3` → 选择 `Image -> Base64` → 选择图片（对话框或手动路径）→ 选择输出方式（复制或保存为 `.txt`）
+  - Base64 → 图片：选择 `3` → 选择 `Base64 -> Image` → 选择输入来源（剪贴板、文件或手动输入）→ 自动识别 `data:image/*` 前缀并推断扩展名 → 保存图片（默认名：`image-<timestamp>.<ext>`）
+- 时间工具
+  - 时间格式化：选择 `4` → 输入时间戳（秒/毫秒）或日期字符串，或直接回车使用当前时间 → 输出 `YYYY-MM-DD HH:mm:ss`
+  - 当前时间戳：选择 `5` → 显示毫秒级时间戳并复制
+- Mock 文本
+  - 选择 `6` → 选择语言（英文/中文）
+  - 英文：输入段落数生成 Lorem Ipsum
+  - 中文：输入字数生成随机常用汉字
+- UUID
+  - 选择 `7` → 生成 UUID v4 并复制
+- 中文转拼音
+  - 选择 `8` → 输入中文 → 输出不带声调的拼音（空格分词）
+
+## 输入与输出
+- 输入来源
+  - `Clipboard`：直接读取剪贴板（适合非常长的内容）
+  - `File`：支持文件对话框或手动输入路径
+  - `Manual input`：命令行输入（适合短文本）
+- 文件输入方式（当选择 `File`）
+  - `Select file (dialog)`：弹出系统文件选择框（Windows）
+  - `Enter file path manually`：手动输入路径
+- 输出方式
+  - `Copy to clipboard`：不打印全文，直接复制
+  - `Save to file`：弹出保存对话框（Windows），或手动输入路径；默认文件名为“工具名 + 时间戳”
+  - `Preview + copy`：显示长度与头尾少量字符预览，并复制完整结果
+
+## 提示
+- 粘贴超长文本到控制台会很慢，建议使用 `Clipboard` 或 `File` 作为输入来源，并使用 `Save to file` 或 `Preview + copy` 作为输出方式
+- 在任何步骤按 `Ctrl+C` 会优雅退出并显示 `Bye!`
+- 工具在本地离线运行，不依赖网络
+
+## 系统要求
+- Node.js `>= 18`
+- Windows：支持文件选择/保存对话框
+- macOS/Linux：使用手动路径输入（可按需扩展对话框支持）
+
+## 卸载
+- 全局卸载：`npm uninstall -g xw-devtool-cli`
+
+

package/bin/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/index.js';

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "xw-devtool-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "基于node的开发者助手cli",
+  "main": "index.js",
+  "bin": {
+    "xw-devtool": "./bin/index.js",
+    "xw-dev": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "devtools",
+    "base64",
+    "url",
+    "uuid",
+    "pinyin",
+    "mock",
+    "timestamp",
+    "time",
+    "image"
+  ],
+  "author": "npmxw",
+  "license": "ISC",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://example.com/xw-devtool-cli.git"
+  },
+  "bugs": {
+    "url": "https://example.com/xw-devtool-cli/issues"
+  },
+  "dependencies": {
+    "clipboardy": "^5.0.2",
+    "commander": "^14.0.2",
+    "dayjs": "^1.11.19",
+    "inquirer": "^13.1.0",
+    "lorem-ipsum": "^2.0.8",
+    "pinyin": "^4.0.0",
+    "uuid": "^13.0.0"
+  }
+}

package/src/commands/base64.js

@@ -0,0 +1,108 @@
+import inquirer from 'inquirer';
+import clipboardy from 'clipboardy';
+import fs from 'fs';
+import { selectFromMenu } from '../utils/menu.js';
+import { outputText, defaultFileName } from '../utils/output.js';
+import { selectFile, saveFile } from '../utils/fileDialog.js';
+
+export async function base64Handler() {
+    const mode = await selectFromMenu('Base64 Encode/Decode', [
+        { name: 'Encode (String -> Base64)', value: 'encode' },
+        { name: 'Decode (Base64 -> String)', value: 'decode' }
+    ]);
+
+    const source = await selectFromMenu('Input Source', [
+        { name: 'Clipboard', value: 'clip' },
+        { name: 'File', value: 'file' },
+        { name: 'Manual input', value: 'manual' }
+    ]);
+
+    let input = '';
+    if (source === 'clip') {
+        try {
+            input = await clipboardy.read();
+            if (!input) {
+                console.log('Clipboard is empty.');
+                return;
+            }
+        } catch (e) {
+            console.error('Failed to read clipboard:', e.message);
+            return;
+        }
+    } else if (source === 'file') {
+        const method = await selectFromMenu('File input method', [
+            { name: 'Select file (dialog)', value: 'dialog' },
+            { name: 'Enter file path manually', value: 'manual' }
+        ]);
+        let p = '';
+        if (method === 'dialog') {
+            p = selectFile('Text Files|*.txt;*.log;*.md|All Files|*.*') || '';
+            if (!p) {
+                console.log('File dialog not available or canceled. Please enter path manually.');
+            }
+        }
+        if (!p) {
+            const ans = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'path',
+                    message: 'Enter input file path:',
+                    validate: (x) => (fs.existsSync(x) ? true : 'File does not exist.')
+                }
+            ]);
+            p = ans.path;
+        }
+        try {
+            input = fs.readFileSync(p, 'utf-8');
+        } catch (e) {
+            console.error('Failed to read file:', e.message);
+            return;
+        }
+    } else {
+        const { text } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'text',
+                message: `Enter string to ${mode}:`
+            }
+        ]);
+        input = text;
+    }
+
+    let result;
+    try {
+        if (mode === 'encode') {
+            result = Buffer.from(input).toString('base64');
+        } else {
+            result = Buffer.from(input, 'base64').toString('utf-8');
+        }
+        const outputMethod = await selectFromMenu('Output', [
+            { name: 'Copy to clipboard', value: 'copy' },
+            { name: 'Save to file', value: 'file' },
+            { name: 'Preview + copy', value: 'preview' }
+        ]);
+
+        if (outputMethod === 'file') {
+            const def = defaultFileName(mode === 'encode' ? 'base64-encode' : 'base64-decode', 'txt');
+            let out = saveFile(def, 'Text Files|*.txt|All Files|*.*');
+            if (!out) {
+                const { path } = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'path',
+                        message: 'Enter output file path:',
+                        default: def
+                    }
+                ]);
+                out = path;
+            }
+            await outputText(result, { showPreview: false, savePath: out });
+        } else if (outputMethod === 'preview') {
+            await outputText(result, { showPreview: true, threshold: 500, previewHead: 80, previewTail: 80 });
+        } else {
+            await outputText(result, { showPreview: false });
+        }
+    } catch (e) {
+        console.error('Error processing Base64:', e.message);
+    }
+}

package/src/commands/imgBase64.js

@@ -0,0 +1,164 @@
+import inquirer from 'inquirer';
+import fs from 'fs';
+import path from 'path';
+import { selectFromMenu } from '../utils/menu.js';
+import { outputText, defaultFileName } from '../utils/output.js';
+import clipboardy from 'clipboardy';
+import { selectFile, saveFile } from '../utils/fileDialog.js';
+
+export async function imgBase64Handler() {
+    const mode = await selectFromMenu('Image <-> Base64', [
+        { name: 'Image -> Base64', value: 'img2b64' },
+        { name: 'Base64 -> Image', value: 'b642img' }
+    ]);
+
+    if (mode === 'img2b64') {
+        const method = await selectFromMenu('File input method', [
+            { name: 'Select file (dialog)', value: 'dialog' },
+            { name: 'Enter file path manually', value: 'manual' }
+        ]);
+        let filePath = '';
+        if (method === 'dialog') {
+            filePath = selectFile('Image Files|*.png;*.jpg;*.jpeg;*.gif;*.bmp;*.webp|All Files|*.*') || '';
+            if (!filePath) {
+                console.log('File dialog not available or canceled. Please enter path manually.');
+            }
+        }
+        if (!filePath) {
+            const ans = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'filePath',
+                    message: 'Enter image file path:',
+                    validate: (input) => (fs.existsSync(input) ? true : 'File does not exist.')
+                }
+            ]);
+            filePath = ans.filePath;
+        }
+
+        try {
+            const fileData = fs.readFileSync(filePath);
+            const base64 = fileData.toString('base64');
+            const outputMethod = await selectFromMenu('Output', [
+                { name: 'Copy to clipboard', value: 'copy' },
+                { name: 'Save base64 to file', value: 'file' },
+                { name: 'Preview + copy', value: 'preview' }
+            ]);
+
+            if (outputMethod === 'file') {
+                const def = defaultFileName('image-base64', 'txt');
+                let outPath = saveFile(def, 'Text Files|*.txt|All Files|*.*');
+                if (!outPath) {
+                    const ans = await inquirer.prompt([
+                        {
+                            type: 'input',
+                            name: 'path',
+                            message: 'Enter output file path (e.g. base64.txt):',
+                            default: def
+                        }
+                    ]);
+                    outPath = ans.path;
+                }
+                await outputText(base64, { showPreview: false, savePath: outPath });
+            } else if (outputMethod === 'preview') {
+                await outputText(base64, { showPreview: true, threshold: 500, previewHead: 80, previewTail: 80 });
+            } else {
+                await outputText(base64, { showPreview: false });
+            }
+        } catch (e) {
+            console.error('Error reading file:', e.message);
+        }
+
+    } else {
+        const src = await selectFromMenu('Input Source', [
+            { name: 'Clipboard', value: 'clip' },
+            { name: 'File', value: 'file' },
+            { name: 'Manual input', value: 'manual' }
+        ]);
+
+        let content = '';
+        if (src === 'clip') {
+            try {
+                content = await clipboardy.read();
+                if (!content) {
+                    console.log('Clipboard is empty.');
+                    return;
+                }
+            } catch (e) {
+                console.error('Failed to read clipboard:', e.message);
+                return;
+            }
+        } else if (src === 'file') {
+            const method2 = await selectFromMenu('File input method', [
+                { name: 'Select file (dialog)', value: 'dialog' },
+                { name: 'Enter file path manually', value: 'manual' }
+            ]);
+            let inPath = '';
+            if (method2 === 'dialog') {
+                inPath = selectFile('Text Files|*.txt;*.log;*.md|All Files|*.*') || '';
+                if (!inPath) {
+                    console.log('File dialog not available or canceled. Please enter path manually.');
+                }
+            }
+            if (!inPath) {
+                const ans = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'path',
+                        message: 'Enter file path containing base64:',
+                        validate: (p) => (fs.existsSync(p) ? true : 'File does not exist.')
+                    }
+                ]);
+                inPath = ans.path;
+            }
+            try {
+                content = fs.readFileSync(inPath, 'utf-8');
+            } catch (e) {
+                console.error('Failed to read file:', e.message);
+                return;
+            }
+        } else {
+            const { base64Str } = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'base64Str',
+                    message: 'Enter Base64 string:'
+                }
+            ]);
+            content = base64Str;
+        }
+        
+        // Strip prefix if exists
+        const matches = content.match(/^data:([A-Za-z-+\/]+);base64,(.+)$/);
+        if (matches && matches.length === 3) {
+            content = matches[2];
+        }
+
+        let ext = 'png';
+        if (matches && matches[1] && matches[1].startsWith('image/')) {
+            const type = matches[1].split('/')[1];
+            if (type) ext = type;
+        }
+
+        let outputPath = saveFile(defaultFileName('image', ext), `Image Files|*.png;*.jpg;*.jpeg;*.gif;*.bmp;*.webp|All Files|*.*`);
+        if (!outputPath) {
+            const ans2 = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'outputPath',
+                    message: 'Enter output image path (e.g. output.png):',
+                    default: defaultFileName('image', ext)
+                }
+            ]);
+            outputPath = ans2.outputPath;
+        }
+
+        try {
+            const buffer = Buffer.from(content, 'base64');
+            fs.writeFileSync(outputPath, buffer);
+            console.log(`Image saved to ${outputPath}`);
+        } catch (e) {
+            console.error('Error saving image:', e.message);
+        }
+    }
+}

package/src/commands/mock.js

@@ -0,0 +1,60 @@
+import inquirer from 'inquirer';
+import { LoremIpsum } from 'lorem-ipsum';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+const lorem = new LoremIpsum({
+    sentencesPerParagraph: {
+        max: 8,
+        min: 4
+    },
+    wordsPerSentence: {
+        max: 16,
+        min: 4
+    }
+});
+
+function generateChinese(length) {
+    // Common Chinese characters (simplified)
+    const commonChars = "的一是在不了有和人这中大为上个国我以要他时来用们生到作地于出就分对成会可主发年动同工也能下过子说产种面而方后多定行学法所民得经十三之进着等部度家电力里如水化高自二理起小物现实加量都两体制机当使点从业本去把性好应开它合还因由其些然前外天政四日那社义事平形相全表间样与关各重新线内数角路最题验打果指气流接南情场变由规德问展七九几欲问无程和气光料村员真眼体别";
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        const randomIndex = Math.floor(Math.random() * commonChars.length);
+        result += commonChars[randomIndex];
+    }
+    return result;
+}
+
+export async function mockHandler() {
+    const type = await selectFromMenu('Mock Text', [
+        { name: 'English', value: 'en' },
+        { name: 'Chinese', value: 'cn' }
+    ]);
+
+    let result = '';
+
+    if (type === 'en') {
+        const { count } = await inquirer.prompt([
+            {
+                type: 'number',
+                name: 'count',
+                message: 'How many paragraphs?',
+                default: 1
+            }
+        ]);
+        result = lorem.generateParagraphs(count);
+    } else {
+        const { count } = await inquirer.prompt([
+            {
+                type: 'number',
+                name: 'count',
+                message: 'How many characters?',
+                default: 50
+            }
+        ]);
+        result = generateChinese(count);
+    }
+
+    console.log(`\nResult:\n${result}\n`);
+    await copy(result);
+}

package/src/commands/pinyin.js

@@ -0,0 +1,25 @@
+import inquirer from 'inquirer';
+import { pinyin } from 'pinyin';
+import { copy } from '../utils/clipboard.js';
+
+export async function pinyinHandler() {
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: 'Enter Chinese text:'
+        }
+    ]);
+
+    // Default style: Normal (no tone)
+    const result = pinyin(input, {
+        style: pinyin.STYLE_NORMAL, // No tone
+        heteronym: false // No heteronym
+    });
+    
+    // Result is an array of arrays. Join them.
+    const flatResult = result.flat().join(' ');
+    
+    console.log(`\nPinyin: ${flatResult}\n`);
+    await copy(flatResult);
+}

package/src/commands/timeFormat.js

@@ -0,0 +1,41 @@
+import inquirer from 'inquirer';
+import dayjs from 'dayjs';
+import { copy } from '../utils/clipboard.js';
+
+export async function timeFormatHandler() {
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: 'Enter timestamp or date string (leave empty for current time):'
+        }
+    ]);
+
+    let date;
+    if (!input) {
+        date = dayjs();
+    } else {
+        // Check if numeric (timestamp)
+        if (/^\d+$/.test(input)) {
+            const ts = parseInt(input);
+            // Handle seconds vs milliseconds (rough guess)
+            // If length is 10, it's likely seconds. 13 is ms.
+            if (input.length === 10) {
+                date = dayjs.unix(ts);
+            } else {
+                date = dayjs(ts);
+            }
+        } else {
+            date = dayjs(input);
+        }
+    }
+
+    if (!date.isValid()) {
+        console.error('Invalid date format.');
+        return;
+    }
+
+    const formatted = date.format('YYYY-MM-DD HH:mm:ss');
+    console.log(`\nFormatted: ${formatted}\n`);
+    await copy(formatted);
+}

package/src/commands/timestamp.js

@@ -0,0 +1,7 @@
+import { copy } from '../utils/clipboard.js';
+
+export async function timestampHandler() {
+    const now = Date.now();
+    console.log(`\nCurrent Timestamp: ${now}\n`);
+    await copy(String(now));
+}

package/src/commands/url.js

@@ -0,0 +1,31 @@
+import inquirer from 'inquirer';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+export async function urlHandler() {
+    const mode = await selectFromMenu('URL Encode/Decode', [
+        { name: 'Encode', value: 'encode' },
+        { name: 'Decode', value: 'decode' }
+    ]);
+
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: `Enter URL to ${mode}:`
+        }
+    ]);
+
+    let result;
+    try {
+        if (mode === 'encode') {
+            result = encodeURIComponent(input);
+        } else {
+            result = decodeURIComponent(input);
+        }
+        console.log(`\nResult:\n${result}\n`);
+        await copy(result);
+    } catch (e) {
+        console.error('Error processing URL:', e.message);
+    }
+}

package/src/commands/uuid.js

@@ -0,0 +1,8 @@
+import { v4 as uuidv4 } from 'uuid';
+import { copy } from '../utils/clipboard.js';
+
+export async function uuidHandler() {
+    const id = uuidv4();
+    console.log(`\nUUID: ${id}\n`);
+    await copy(id);
+}

package/src/index.js

@@ -0,0 +1,125 @@
+import inquirer from 'inquirer';
+import { program } from 'commander';
+import { urlHandler } from './commands/url.js';
+import { base64Handler } from './commands/base64.js';
+import { imgBase64Handler } from './commands/imgBase64.js';
+import { timeFormatHandler } from './commands/timeFormat.js';
+import { timestampHandler } from './commands/timestamp.js';
+import { mockHandler } from './commands/mock.js';
+import { uuidHandler } from './commands/uuid.js';
+import { pinyinHandler } from './commands/pinyin.js';
+
+process.on('SIGINT', () => {
+    console.log('\nBye!');
+    process.exit(0);
+});
+process.on('unhandledRejection', (err) => {
+    const msg = (err && err.message) ? err.message : String(err);
+    if (msg.includes('SIGINT') || (err && err.name === 'ExitPromptError')) {
+        console.log('\nBye!');
+        process.exit(0);
+    } else {
+        console.error('Unhandled error:', err);
+        process.exit(1);
+    }
+});
+
+const features = [
+    { name: 'URL Encode/Decode', value: 'url' },
+    { name: 'String Encode/Decode (Base64)', value: 'base64' },
+    { name: 'Image <-> Base64', value: 'imgBase64' },
+    { name: 'Time Format', value: 'timeFormat' },
+    { name: 'Get Current Timestamp', value: 'timestamp' },
+    { name: 'Mock Text', value: 'mock' },
+    { name: 'Get UUID', value: 'uuid' },
+    { name: 'Chinese to Pinyin', value: 'pinyin' }
+];
+
+async function main() {
+    program
+        .version('1.0.0')
+        .description('Developer Assistant CLI')
+        .action(async () => {
+            await showMenu();
+        });
+
+    program.parse(process.argv);
+}
+
+async function showMenu() {
+    console.log('\n=================================');
+    console.log('      xw-devtool-cli Menu');
+    console.log('=================================');
+    features.forEach((feature, index) => {
+        console.log(`${index + 1}. ${feature.name}`);
+    });
+    console.log('0. Exit');
+    console.log('=================================\n');
+
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'choice',
+            message: 'Please enter the feature number (0-8):',
+            validate: (input) => {
+                const num = parseInt(input);
+                if (isNaN(num) || num < 0 || num > features.length) {
+                    return `Please enter a number between 0 and ${features.length}`;
+                }
+                return true;
+            }
+        }
+    ]);
+
+    const index = parseInt(choice);
+
+    if (index === 0) {
+        console.log('Bye!');
+        process.exit(0);
+    }
+
+    const selectedFeature = features[index - 1];
+    
+    try {
+        await handleAction(selectedFeature.value);
+    } catch (error) {
+        console.error('Error:', error.message);
+    }
+    
+    // Wait a bit or ask to continue? 
+    // Usually just looping back is fine.
+    await showMenu();
+}
+
+async function handleAction(action) {
+    switch (action) {
+        case 'url':
+            await urlHandler();
+            break;
+        case 'base64':
+            await base64Handler();
+            break;
+        case 'imgBase64':
+            await imgBase64Handler();
+            break;
+        case 'timeFormat':
+            await timeFormatHandler();
+            break;
+        case 'timestamp':
+            await timestampHandler();
+            break;
+        case 'mock':
+            await mockHandler();
+            break;
+        case 'uuid':
+            await uuidHandler();
+            break;
+        case 'pinyin':
+            await pinyinHandler();
+            break;
+        default:
+            console.log('Feature not implemented yet.');
+    }
+}
+
+main();

package/src/utils/clipboard.js

@@ -0,0 +1,10 @@
+import clipboardy from 'clipboardy';
+
+export async function copy(text) {
+    try {
+        await clipboardy.write(text);
+        console.log('Result copied to clipboard!');
+    } catch (e) {
+        console.error('Failed to copy to clipboard (might not be supported in this environment):', e.message);
+    }
+}

package/src/utils/fileDialog.js

@@ -0,0 +1,28 @@
+import { execSync } from 'child_process';
+
+function isWindows() {
+    return process.platform === 'win32';
+}
+
+export function selectFile(filter = 'All Files|*.*') {
+    if (!isWindows()) return null;
+    try {
+        const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $fd = New-Object System.Windows.Forms.OpenFileDialog; $fd.Filter='${filter.replace(/"/g, '\\"')}'; $fd.Multiselect=$false; if($fd.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK){ Write-Output $fd.FileName }"`;
+        const output = execSync(cmd, { stdio: ['pipe', 'pipe', 'ignore'] }).toString().trim();
+        return output || null;
+    } catch {
+        return null;
+    }
+}
+
+export function saveFile(defaultName = 'output.txt', filter = 'All Files|*.*') {
+    if (!isWindows()) return null;
+    try {
+        const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $sd = New-Object System.Windows.Forms.SaveFileDialog; $sd.Filter='${filter.replace(/"/g, '\\"')}'; $sd.FileName='${defaultName.replace(/"/g, '\\"')}'; if($sd.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK){ Write-Output $sd.FileName }"`;
+        const output = execSync(cmd, { stdio: ['pipe', 'pipe', 'ignore'] }).toString().trim();
+        return output || null;
+    } catch {
+        return null;
+    }
+}
+

package/src/utils/menu.js

@@ -0,0 +1,32 @@
+import inquirer from 'inquirer';
+
+/**
+ * Display a numbered menu and get user selection.
+ * @param {string} title - The title of the menu.
+ * @param {Array<{name: string, value: any}>} options - List of options.
+ * @returns {Promise<any>} - The selected value.
+ */
+export async function selectFromMenu(title, options) {
+    console.log(`\n=== ${title} ===`);
+    options.forEach((opt, index) => {
+        console.log(`${index + 1}. ${opt.name}`);
+    });
+    console.log('=================\n');
+
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'choice',
+            message: `Select option (1-${options.length}):`,
+            validate: (input) => {
+                const num = parseInt(input);
+                if (isNaN(num) || num < 1 || num > options.length) {
+                    return `Please enter a number between 1 and ${options.length}`;
+                }
+                return true;
+            }
+        }
+    ]);
+
+    return options[parseInt(choice) - 1].value;
+}

package/src/utils/output.js

@@ -0,0 +1,35 @@
+import fs from 'fs';
+import { copy } from './clipboard.js';
+
+export async function outputText(text, options = {}) {
+    const {
+        showPreview = true,
+        previewHead = 50,
+        previewTail = 50,
+        threshold = 500,
+        savePath
+    } = options;
+
+    if (savePath) {
+        fs.writeFileSync(savePath, text, 'utf-8');
+        console.log(`Saved to ${savePath}`);
+    }
+
+    if (showPreview) {
+        if (text.length > threshold) {
+            console.log(`Length: ${text.length}`);
+            const head = text.slice(0, previewHead);
+            const tail = text.slice(-previewTail);
+            console.log(`${head}...${tail}`);
+        } else {
+            console.log(`Result:\n${text}\n`);
+        }
+    }
+
+    await copy(text);
+}
+
+export function defaultFileName(tool, ext = 'txt') {
+    const ts = Date.now();
+    return `${tool}-${ts}.${ext}`;
+}