change-image-suffix 2.0.2 → 2.1.1

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [2.1.1](https://github.com/GuoSirius/change-image-suffix/compare/v2.1.0...v2.1.1) (2026-05-21)
+
+
+### Bug Fixes
+
+* unify format constants, remove dead code, sync docs with source ([c1e7700](https://github.com/GuoSirius/change-image-suffix/commit/c1e7700ee5f5a0142c98f5a1e95bc6453317a4a9))
+
+## [2.1.0](https://github.com/GuoSirius/change-image-suffix/compare/v2.0.2...v2.1.0) (2026-05-21)
+
+
+### Features
+
+* auto context-menu lifecycle hooks, enable declarations, add dev script ([ab44e37](https://github.com/GuoSirius/change-image-suffix/commit/ab44e374040fbfa6715edacb8fb249eeaf746821))
+
+
+### Bug Fixes
+
+* rewrite bat script, remove gif/heif/jp2, same-format copy, quality 90 ([085a589](https://github.com/GuoSirius/change-image-suffix/commit/085a589f96682626834ac9715f7f228d52bfe89d))
+
+
+### Chores
+
+* include .claude/ for cross-device project settings ([c863337](https://github.com/GuoSirius/change-image-suffix/commit/c863337e926826a1799ea0ff4bc6e1f0790afee0))
+
+
+### Documentation
+
+* add CLAUDE.md for project onboarding on other devices ([c7f06bc](https://github.com/GuoSirius/change-image-suffix/commit/c7f06bc9c670b31e3e9af9329cbce96b5d3ed065))
+* add project memory for context-menu fix and codebase context ([e8fb432](https://github.com/GuoSirius/change-image-suffix/commit/e8fb43252cf1288d503c24737b84b2f687e19968))
+
 ### [2.0.2](https://github.com/GuoSirius/change-image-suffix/compare/v2.0.1...v2.0.2) (2026-05-19)
 
 

package/README.md

@@ -8,7 +8,7 @@
 - 🔄 支持递归搜索子目录
 - 📏 支持递归深度限制
 - 🎯 支持指定源文件后缀（png, jpg, gif 等）
-- 🎨 支持多种目标格式（webp, jpg, png, avif, gif）
+- 🎨 支持多种目标格式（webp, jpg, png, avif, tiff）
 - 📤 输出到 `output/` 子目录
 - 🔢 同名不同后缀文件自动编号（`_01`, `_02`）
 - 🖱️ Windows 右键菜单集成
@@ -68,10 +68,7 @@ cis uninstall-menu
   ├── 📷 JPG
   ├── 🖼 PNG
   ├── 📺 AVIF
-  ├── 🎞 GIF
-  ├── 📋 TIFF
-  ├── 🍎 HEIF
-  └── 📐 JPEG2000
+  └── 📋 TIFF
 ```
 
 **适用场景：**
@@ -94,7 +91,7 @@ cis uninstall-menu
 | `-p, --path <dir>` | 指定工作目录 | 当前目录 |
 | `-r, --recursive` | 递归搜索子目录 | 否 |
 | `-d, --depth <n>` | 递归深度限制 | 无限制 |
-| `-e, --extensions` | 指定源后缀，逗号分隔 | png,jpg,jpeg,gif,bmp,tiff,webp |
+| `-e, --extensions` | 指定源后缀，逗号分隔 | png,jpg,jpeg,gif,bmp,tiff,tif,webp,avif |
 | `-t, --to <format>` | 目标格式 | webp |
 | `-f, --file <file>` | 指定单个文件转换 | - |
 | `-h, --help` | 显示帮助 | - |
@@ -152,7 +149,7 @@ cis uninstall-menu
 | 类型 | 格式 |
 |------|------|
 | **输入** | png, jpg, jpeg, gif, bmp, tiff, webp, avif |
-| **输出** | webp, jpg, png, avif, gif, tiff, heif, jp2 |
+| **输出** | webp, jpg, png, avif, tiff |
 
 ---
 
@@ -282,14 +279,21 @@ npm run release:major   # 重大变更
 ## 项目结构
 
 ```
+├── .claude/              # Claude Code 项目记忆与设置
+│   ├── MEMORY.md
+│   ├── memory/
+│   └── settings.local.json
 ├── .github/workflows/   # GitHub Actions 工作流
 │   └── release.yml      # 自动发布工作流
 ├── .husky/              # Git 钩子
 │   └── commit-msg       # 提交信息校验钩子
 ├── scripts/             # 脚本目录
-│   └── release.js       # 一键发布脚本
+│   ├── release.js       # 一键发布脚本
+│   ├── postinstall.js   # npm postinstall 钩子（自动注册右键菜单）
+│   └── preuninstall.js  # npm preuninstall 钩子（自动清理右键菜单）
 ├── src/                 # 源代码
 │   └── index.ts         # 主入口
+├── CLAUDE.md            # 项目上下文文档
 ├── .commitlintrc.json   # commitlint 配置
 ├── CHANGELOG.md         # 变更日志
 └── package.json         # 项目配置

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -42,8 +42,10 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const sharp_1 = __importDefault(require("sharp"));
-// 默认配置
-const DEFAULT_EXTENSIONS = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'tiff', 'webp'];
+// 支持的输入/输出格式
+const SUPPORTED_INPUT_EXTENSIONS = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'tiff', 'tif', 'webp', 'avif'];
+const SUPPORTED_OUTPUT_FORMATS = ['webp', 'jpg', 'jpeg', 'png', 'avif', 'tiff', 'tif'];
+const DEFAULT_EXTENSIONS = [...SUPPORTED_INPUT_EXTENSIONS];
 const DEFAULT_TARGET_FORMAT = 'webp';
 // ─────────────────────────────────────────
 // 右键菜单管理（仅 Windows）
@@ -54,17 +56,6 @@ function requireWindows() {
         process.exit(1);
     }
 }
-/**
- * 写注册表 key（调用 reg.exe，无需管理员权限写 HKCU）
- */
-function regAdd(key, name, value, type = 'REG_SZ') {
-    const cmd = `reg add "${key}" /v "${name}" /t ${type} /d "${value}" /f`;
-    (0, child_process_1.execSync)(cmd, { stdio: 'ignore' });
-}
-function regAddDefault(key, value) {
-    const cmd = `reg add "${key}" /ve /d "${value}" /f`;
-    (0, child_process_1.execSync)(cmd, { stdio: 'ignore' });
-}
 function regDelete(key) {
     try {
         (0, child_process_1.execSync)(`reg delete "${key}" /f`, { stdio: 'ignore' });
@@ -75,17 +66,14 @@ function regDelete(key) {
 }
 function installContextMenu() {
     requireWindows();
-    // ── 查找 cis.cmd 和 node_modules 路径 ──
+    // ── 查找 cis.cmd 路径 ──
     let cisCmd = '';
-    let nodeModulesDir = '';
     try {
         cisCmd = (0, child_process_1.execSync)('where cis.cmd', { encoding: 'utf8' }).trim().split('\n')[0].trim();
-        nodeModulesDir = path.dirname(cisCmd);
     }
     catch {
         try {
             cisCmd = (0, child_process_1.execSync)('where cis', { encoding: 'utf8' }).trim().split('\n')[0].trim();
-            nodeModulesDir = path.dirname(cisCmd);
         }
         catch {
             console.error('❌ 找不到 cis 命令，请先执行 npm link 或 npm install -g change-image-suffix');
@@ -103,146 +91,60 @@ function installContextMenu() {
         fs.copyFileSync(icoSource, icoTarget);
     }
     const iconPath = fs.existsSync(icoTarget) ? icoTarget : cisCmd;
-    // ── 辅助脚本路径定义（需要在 batContent 之前，因为 bat 中引用了 ps1Path）──
     const batPath = path.join(appDataDir, 'cis_file.bat');
-    const ps1Path = path.join(appDataDir, 'cis_getfiles.ps1');
-    // cis_getfiles.ps1: 通过 Shell.Application COM 获取 Explorer 选中文件
-    const cisGetfilesContent = `
-Add-Type -AssemblyName Microsoft.VisualBasic
-Add-Type -AssemblyName UIAutomationClient
-$files = @()
-try {
-    $shell = New-Object -ComObject Shell.Application
-    $windows = $shell.Windows()
-    foreach ($win in $windows) {
-        if ($win -and $win.FullName -like "*explorer.exe") {
-            $selected = $win.Document.SelectedItems()
-            foreach ($item in $selected) {
-                if ($item -and $item.Path) {
-                    $files += $item.Path
-                }
-            }
-        }
-    }
-} catch {}
-if ($files.Count -gt 0) {
-    $files | ForEach-Object { $_ }
-} else {
-    Write-Output "NO_FILES"
-}
-`;
-    fs.writeFileSync(ps1Path, cisGetfilesContent, 'utf8');
-    // ── bat 脚本：接收 Windows 传递的文件路径和格式参数 ──
-    // 根据 Windows ExtendedSubCommandsKey 机制：
-    // - 子命令的 command 参数（格式）在前
-    // - Windows 自动将父命令收到的文件路径追加在末尾
-    // - 最终执行: cmd /c "bat" "格式" "文件路径"
-    // 移除 AppliesTo 限制后，bat 需要过滤非图片文件
+    // ── bat 脚本：接收格式 + 文件/目录路径，直接调用 cis ──
+    // %1 = 格式, %2 %3 ... = Windows 传入的文件/目录路径
     const batContent = `
 @echo off
 chcp 65001 >nul
 setlocal enabledelayedexpansion
 
-REM Get this script's directory (no trailing backslash)
-set "SCRIPT_DIR=%~dp0"
-set "SCRIPT_DIR=!SCRIPT_DIR:~0,-1!"
-
-REM Get cis.cmd path
-for /f "delims=" %%c in ('where cis.cmd 2^>nul') do set "CIS_CMD=%%c"
-
-REM Supported image extensions
-set "SUPPORTED_EXT=.png;.jpg;.jpeg;.gif;.bmp;.tiff;.tif;.webp;.avif"
-
-REM %1 = format (from subcommand), %2 = file path (from Windows)
-if "%~1"=="" (
-    echo Error: No format specified.
-    timeout /t 2 >nul
-    goto :done
+REM Find cis command in PATH
+set "CIS_CMD="
+for /f "delims=" %%c in ('where cis.cmd 2^>nul') do (
+    if "!CIS_CMD!"=="" set "CIS_CMD=%%c"
 )
-set "format=%~1"
-
-REM Collect all image files
-set "fileList="
-
-REM Windows passes file path as %2. If multiple files selected, use PowerShell.
-REM Otherwise use direct argument.
-if "%~2"=="" (
-    REM Multi-file via PowerShell (with retries for reliability)
-    for /f "delims=" %%i in ('powershell -ExecutionPolicy Bypass -File "!SCRIPT_DIR!\\cis_getfiles.ps1"') do (
-        if not "%%i"=="NO_FILES" (
-            call :add_if_image "%%i"
-        )
-    )
-) else (
-    REM Single file or multiple via %2 (space-separated)
-    REM Split space-separated paths
-    for %%F in (%~2) do (
-        call :add_if_image "%%F"
+if "!CIS_CMD!"=="" (
+    for /f "delims=" %%c in ('where cis 2^>nul') do (
+        if "!CIS_CMD!"=="" set "CIS_CMD=%%c"
     )
 )
-
-REM Process all collected files - use start /b to avoid new window
-if not "!fileList!"=="" (
-    start "" /b cmd /c "!CIS_CMD! -t !format! !fileList!"
+if "!CIS_CMD!"=="" (
+    echo [change-image-suffix] cis command not found. Run: npm install -g change-image-suffix
+    pause
+    exit /b 1
 )
-goto :done
 
-:add_if_image
-set "filePath=%~1"
-REM Skip if empty or NO_FILES
-if "!filePath!"=="" exit /b
-if "!filePath!"=="NO_FILES" exit /b
+if "%~1"=="" (
+    echo [change-image-suffix] Error: No format specified.
+    pause
+    exit /b 1
+)
 
-REM Get file extension
-for %%E in ("!filePath!") do set "ext=%%~xE"
-if "!ext!"=="" exit /b
+set "format=%~1"
+shift
 
-REM Convert to lowercase
-set "ext_lower=!ext!"
-call set "ext_lower=%%ext_lower:A=a%%
-call set "ext_lower=%%ext_lower:B=b%%
-call set "ext_lower=%%ext_lower:C=c%%
-call set "ext_lower=%%ext_lower:D=d%%
-call set "ext_lower=%%ext_lower:E=e%%
-call set "ext_lower=%%ext_lower:F=f%%
-call set "ext_lower=%%ext_lower:G=g%%
-call set "ext_lower=%%ext_lower:H=h%%
-call set "ext_lower=%%ext_lower:I=i%%
-call set "ext_lower=%%ext_lower:J=j%%
-call set "ext_lower=%%ext_lower:K=k%%
-call set "ext_lower=%%ext_lower:L=l%%
-call set "ext_lower=%%ext_lower:M=m%%
-call set "ext_lower=%%ext_lower:N=n%%
-call set "ext_lower=%%ext_lower:O=o%%
-call set "ext_lower=%%ext_lower:P=p%%
-call set "ext_lower=%%ext_lower:Q=q%%
-call set "ext_lower=%%ext_lower:R=r%%
-call set "ext_lower=%%ext_lower:S=s%%
-call set "ext_lower=%%ext_lower:T=t%%
-call set "ext_lower=%%ext_lower:U=u%%
-call set "ext_lower=%%ext_lower:V=v%%
-call set "ext_lower=%%ext_lower:W=w%%
-call set "ext_lower=%%ext_lower:X=x%%
-call set "ext_lower=%%ext_lower:Y=y%%
-call set "ext_lower=%%ext_lower:Z=z%%"
+set "args="
+:parse
+if "%~1"=="" goto :run
+if exist "%~1\\*" (
+    set "args=!args! -p "%~1""
+) else (
+    set "args=!args! -f "%~1""
+)
+shift
+goto :parse
 
-REM Check if extension is supported
-echo !SUPPORTED_EXT! | findstr /i /c:"!ext_lower!" >nul 2>&1
-if !errorlevel!==0 (
-    set "fileList=!fileList! -f "!filePath!""
+:run
+if "!args!"=="" (
+    echo [change-image-suffix] No files or directories to process.
+    pause
+    exit /b 1
 )
-exit /b
 
-:done
+"!CIS_CMD!" -t !format! !args!
+if !errorlevel! neq 0 pause
 endlocal
-exit
-
-exit
-
-exit
-
-exit
-
 `;
     fs.writeFileSync(batPath, batContent, 'utf8');
     // ── 格式列表（webp 排第一，其他按常见程度排序）──
@@ -251,15 +153,10 @@ exit
         { verb: 'jpg', label: '📷 JPG' },
         { verb: 'png', label: '🖼 PNG' },
         { verb: 'avif', label: '📺 AVIF' },
-        { verb: 'gif', label: '🎞 GIF' },
         { verb: 'tiff', label: '📋 TIFF' },
-        { verb: 'heif', label: '🍎 HEIF' },
-        { verb: 'jp2', label: '📐 JPEG2000' },
     ];
-    // ── 使用 ExtendedSubCommandsKey 方式（PowerShell 7 同款）──
-    // 主菜单项配置（每个菜单类型有独立的子菜单路径）
-    // 注意：文件右键和目录右键都使用 bat + PowerShell 获取选中文件
-    // 这样混合选择时也能处理所有选中项
+    // ── 使用 ExtendedSubCommandsKey 方式 ──
+    // 文件右键和目录右键均使用 bat 脚本，混合选择时自动分类文件和目录
     const menuBases = [
         { base: 'HKCU\\Software\\Classes\\Directory\\Background\\shell\\cis', subMenu: 'Directory\\ContextMenus\\cis', arg: '-p "%V"' },
         { base: 'HKCU\\Software\\Classes\\Directory\\shell\\cis', subMenu: 'Directory\\ContextMenus\\cis_dir', useBat: true },
@@ -331,18 +228,13 @@ function uninstallContextMenu() {
         }
         catch { /* ignore */ }
     }
-    // 删除批处理文件和 PowerShell 脚本
+    // 删除批处理文件
     const appDataDir = path.join(os.homedir(), 'AppData', 'Roaming', 'change-image-suffix');
     const batPath = path.join(appDataDir, 'cis_file.bat');
-    const ps1Path = path.join(appDataDir, 'cis_getfiles.ps1');
     try {
         fs.unlinkSync(batPath);
     }
     catch { /* ignore */ }
-    try {
-        fs.unlinkSync(ps1Path);
-    }
-    catch { /* ignore */ }
     console.log('✅ 右键菜单已卸载');
 }
 // ─────────────────────────────────────────
@@ -400,7 +292,8 @@ function parseArgs() {
             process.exit(0);
         }
         if (arg === '-v' || arg === '--version') {
-            console.log('change-image-suffix v1.18.0');
+            const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+            console.log(`change-image-suffix v${pkg.version}`);
             process.exit(0);
         }
         if (arg === '-p' || arg === '--path') {
@@ -488,12 +381,12 @@ function printHelp() {
   cis uninstall-menu             # 从 Windows 右键菜单移除
 
 选项:
-  -f, --file <file>       转换单个文件（右键文件时自动传入）
+  -f, --file <file>       转换指定文件（可多个，空格分隔）
   -p, --path <dir>        指定工作目录（默认: 当前目录）
   -r, --recursive         递归搜索子目录
   -d, --depth <n>         递归深度限制（需要 -r 选项）
-  -e, --extensions <ext>  指定要转换的后缀，逗号分隔（不含点号）
-  -t, --to <format>       转换到的目标格式（默认: webp）
+  -e, --extensions <ext>  指定源后缀，逗号分隔（不含点号）
+  -t, --to <format>       目标格式: webp, jpg/jpeg, png, avif, tiff/tif（默认: webp）
   -h, --help              显示帮助信息
   -v, --version           显示版本信息
 
@@ -536,9 +429,7 @@ function getOutputPath(inputPath, targetFormat, allInputFiles) {
     const dir = path.dirname(inputPath);
     const ext = path.extname(inputPath);
     const basename = path.basename(inputPath, ext);
-    const originalExt = ext.slice(1).toLowerCase();
     const targetExt = targetFormat;
-    // 源格式与目标格式相同时，直接覆盖
     let coreName = basename;
     const outputDir = path.join(dir, 'output');
     // 检查输入目录中是否有同名（不含扩展名）但不同后缀的文件
@@ -573,34 +464,39 @@ function getOutputPath(inputPath, targetFormat, allInputFiles) {
 async function convertImage(inputPath, targetFormat, allInputFiles) {
     try {
         const outputPath = getOutputPath(inputPath, targetFormat, allInputFiles);
-        // 确保 output 目录存在
         const outputDir = path.dirname(outputPath);
         if (!fs.existsSync(outputDir)) {
             fs.mkdirSync(outputDir, { recursive: true });
         }
+        const srcExt = path.extname(inputPath).slice(1).toLowerCase();
+        const fmt = targetFormat.toLowerCase();
+        // 同格式直接复制，避免重新编码导致质量损失
+        if (srcExt === fmt || (srcExt === 'jpeg' && fmt === 'jpg') || (srcExt === 'jpg' && fmt === 'jpeg') || (srcExt === 'tif' && fmt === 'tiff') || (srcExt === 'tiff' && fmt === 'tif')) {
+            fs.copyFileSync(inputPath, outputPath);
+            return { success: true, outputPath };
+        }
+        if (!SUPPORTED_OUTPUT_FORMATS.includes(fmt)) {
+            return { success: false, outputPath: inputPath, error: `不支持的目标格式: ${targetFormat}，支持: ${SUPPORTED_OUTPUT_FORMATS.join(', ')}` };
+        }
         const image = (0, sharp_1.default)(inputPath);
-        switch (targetFormat.toLowerCase()) {
+        switch (fmt) {
             case 'webp':
-                await image.webp({ quality: 85 }).toFile(outputPath);
+                await image.webp({ quality: 90 }).toFile(outputPath);
                 break;
             case 'jpg':
             case 'jpeg':
-                await image.jpeg({ quality: 85 }).toFile(outputPath);
+                await image.jpeg({ quality: 90 }).toFile(outputPath);
                 break;
             case 'png':
-                await image.png({ quality: 85 }).toFile(outputPath);
-                break;
-            case 'gif':
-                await image.gif().toFile(outputPath);
+                await image.png({ compressionLevel: 6 }).toFile(outputPath);
                 break;
             case 'tiff':
             case 'tif':
-                await image.tiff({ quality: 85 }).toFile(outputPath);
+                await image.tiff({ quality: 90 }).toFile(outputPath);
                 break;
             case 'avif':
-                await image.avif({ quality: 85 }).toFile(outputPath);
+                await image.avif({ quality: 90 }).toFile(outputPath);
                 break;
-            default: await image.toFormat(targetFormat).toFile(outputPath);
         }
         return { success: true, outputPath };
     }
@@ -634,12 +530,11 @@ async function main() {
         console.log(`🎯 目标格式: ${options.targetFormat}`);
         console.log(`📦 待处理: ${files.length} 个文件\n`);
         console.log('----------------------------------------\n');
-        const supportedExts = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'tiff', 'tif', 'webp', 'avif'];
         let totalSuccess = 0;
         let totalFail = 0;
         for (const filePath of files) {
             const ext = path.extname(filePath).slice(1).toLowerCase();
-            if (!supportedExts.includes(ext)) {
+            if (!SUPPORTED_INPUT_EXTENSIONS.includes(ext)) {
                 console.log(`  ⚠️  跳过（不支持格式）: ${filePath}`);
                 totalFail++;
                 continue;
@@ -674,8 +569,7 @@ async function main() {
             }
             if (stat.isFile()) {
                 const ext = path.extname(inputPath).slice(1).toLowerCase();
-                const supportedExts = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'tiff', 'tif', 'webp', 'avif'];
-                if (!supportedExts.includes(ext)) {
+                if (!SUPPORTED_INPUT_EXTENSIONS.includes(ext)) {
                     console.log(`  ⚠️  跳过（不支持格式）: ${inputPath}`);
                     totalFail++;
                     continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "change-image-suffix",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "description": "批量转换图片格式的CLI工具，支持递归搜索、深度限制、指定后缀、Windows右键菜单等功能",
   "main": "dist/index.js",
   "files": [
@@ -8,7 +8,9 @@
     "assets/",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "scripts/postinstall.js",
+    "scripts/preuninstall.js"
   ],
   "bin": {
     "change-image-suffix": "./dist/index.js",
@@ -21,13 +23,15 @@
   "scripts": {
     "clean": "rimraf dist",
     "build": "tsc",
+    "dev": "tsc --watch",
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js",
     "prepublishOnly": "npm run clean && npm run build",
     "release": "node scripts/release.js",
     "release:patch": "node scripts/release.js --patch",
     "release:minor": "node scripts/release.js --minor",
     "release:major": "node scripts/release.js --major",
-    "lint": "echo \"Linting not configured yet\"",
-    "lint:fix": "echo \"Linting fix not configured yet\"",
+    "lint": "tsc --noEmit",
     "typecheck": "tsc --noEmit"
   },
   "keywords": [

package/scripts/postinstall.js

@@ -0,0 +1,14 @@
+// npm lifecycle hook: runs after npm install/update
+// Auto-registers Windows context menu on global install
+const os = require('os');
+const { execSync } = require('child_process');
+const path = require('path');
+
+if (os.platform() === 'win32' && process.env.npm_config_global === 'true') {
+  try {
+    const indexJs = path.join(__dirname, '..', 'dist', 'index.js');
+    execSync(`node "${indexJs}" install-menu`, { stdio: 'inherit' });
+  } catch (e) {
+    console.warn('⚠️  Context menu auto-register failed. Run "cis install-menu" manually.');
+  }
+}

package/scripts/preuninstall.js

@@ -0,0 +1,14 @@
+// npm lifecycle hook: runs before npm uninstall
+// Cleans up Windows context menu to avoid leftover registry entries
+const os = require('os');
+const { execSync } = require('child_process');
+const path = require('path');
+
+if (os.platform() === 'win32') {
+  try {
+    const indexJs = path.join(__dirname, '..', 'dist', 'index.js');
+    execSync(`node "${indexJs}" uninstall-menu`, { stdio: 'inherit' });
+  } catch (e) {
+    // Ignore cleanup errors — the menu will be orphaned but harmless
+  }
+}