@iyowei/sweep-node-modules-cli 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -111,6 +111,9 @@ sweep-nm init
111
111
  sweep-nm update
112
112
  sweep-nm update --check
113
113
 
114
+ # print version (also -V)
115
+ sweep-nm --version
116
+
114
117
  # full option list (also -h)
115
118
  sweep-nm --help
116
119
  ```
package/README.zh-CN.md CHANGED
@@ -111,6 +111,9 @@ sweep-nm init
111
111
  sweep-nm update
112
112
  sweep-nm update --check
113
113
 
114
+ # 显示版本号 (亦可 -V)
115
+ sweep-nm --version
116
+
114
117
  # 完整选项表 (亦可 -h)
115
118
  sweep-nm --help
116
119
  ```
package/dist/cli.js CHANGED
@@ -1,4 +1,4 @@
1
- import{readFileSync as readFileSync5}from"node:fs";import{lstat as lstat5,mkdir,writeFile}from"node:fs/promises";import{homedir as homedir8}from"node:os";import{dirname as dirname2}from"node:path";import{readFileSync as readFileSync4}from"node:fs";import{dirname,join as join2}from"node:path";import{fileURLToPath}from"node:url";import{existsSync,realpathSync}from"node:fs";import{posix,win32}from"node:path";var SUPPORTED_PACKAGE_MANAGERS=["bun","npm","pnpm","yarn","volta"],LIB_NODE_MODULES_HEURISTIC_REASON="命中标准 <prefix>/lib/node_modules 全局目录";function normalizeSlashes(path){return path.replaceAll("\\","/").replace(/\/+$/,"")}function joinForPath(base,...parts){return/^(?:[A-Za-z]:[/\\]|\\\\)/.test(base)||base.includes("\\")?win32.join(base,...parts):posix.join(base,...parts)}function foldPath(path){return normalizeSlashes(path).toLowerCase()}function isWithinDir(child,parent){let normParent=foldPath(parent);if(normParent==="")return!1;let normChild=foldPath(child);return normChild===normParent||normChild.startsWith(`${normParent}/`)}function collectRawFoldedCandidates(foldedRoot,rawPaths){let seen=new Set([foldedRoot]),out=[];for(let raw of rawPaths??[]){if(typeof raw!=="string"||raw.trim()==="")continue;let folded=foldPath(raw);if(!seen.has(folded))seen.add(folded),out.push(folded)}return out}function expandRootVariants(root,realpath){let trimmed=root.trim();if(trimmed==="")return[];let out=[trimmed],resolved=realpath(trimmed);if(foldPath(resolved)!==foldPath(trimmed))out.push(resolved);return out}function detectEphemeral(candidates,packageRoot){for(let p of candidates){if(p.includes("/_npx/"))return{kind:"ephemeral",runner:"npx",reason:"位于 npx 临时缓存目录 (_npx)",packageRoot};if(p.includes("/bunx-"))return{kind:"ephemeral",runner:"bunx",reason:"位于 bunx 临时执行目录",packageRoot};if(p.includes("/pnpm/dlx/")||p.includes("/pnpm-cache/dlx/")||p.includes("/pnpm-dlx/"))return{kind:"ephemeral",runner:"pnpm-dlx",reason:"位于 pnpm dlx 临时缓存目录",packageRoot};if(p.includes("/xfs-")&&p.includes("/dlx-")||p.includes("/berry/cache/")&&p.includes("/dlx"))return{kind:"ephemeral",runner:"yarn-dlx",reason:"位于 yarn dlx 临时执行目录",packageRoot};if(p.includes("/deno/npm/"))return{kind:"ephemeral",runner:"deno",reason:"位于 Deno npm 缓存目录 (/deno/npm/)",packageRoot}}return null}function buildEnvRootRules(env,realpath){let rules=[],directSpecs=[["volta",env.VOLTA_HOME,"位于环境变量 VOLTA_HOME 目录内"],["bun",env.BUN_INSTALL,"位于环境变量 BUN_INSTALL 目录内"],["bun",env.BUN_INSTALL_GLOBAL_DIR,"位于环境变量 BUN_INSTALL_GLOBAL_DIR 目录内"],["pnpm",env.PNPM_HOME,"位于环境变量 PNPM_HOME 目录内"]];for(let[pm,rawRoot,reason]of directSpecs){if(rawRoot===void 0||rawRoot.trim()==="")continue;let roots=expandRootVariants(rawRoot,realpath);if(roots.length>0)rules.push({pm,roots,reason})}let npmPrefix=env.NPM_CONFIG_PREFIX??env.npm_config_prefix;if(npmPrefix!==void 0&&npmPrefix.trim()!==""){let npmRoots=[];for(let base of expandRootVariants(npmPrefix,realpath)){let norm=normalizeSlashes(base);if(norm==="")continue;npmRoots.push(`${norm}/lib/node_modules`,`${norm}/node_modules`)}if(npmRoots.length>0)rules.push({pm:"npm",roots:npmRoots,reason:"位于环境变量 NPM_CONFIG_PREFIX 目录内"})}return rules}function detectFromEnvRoots(candidates,env,packageRoot,realpath){if(candidates.length===0)return null;let rules=buildEnvRootRules(env,realpath);for(let candidate of candidates)for(let rule of rules)if(rule.roots.some((root)=>isWithinDir(candidate,root)))return{kind:"global",pm:rule.pm,reason:rule.reason,packageRoot};return null}var GLOBAL_PATH_SIGNATURES=[["volta",["/.volta/tools/","/volta/tools/","/.volta/bin/","/volta/bin/"],"命中 Volta 全局工具安装目录"],["bun",["/.bun/install/global/","/.bun/bin/"],"命中 Bun 全局安装目录 (~/.bun)"],["pnpm",["/pnpm/global/","/library/pnpm/global/","/.local/share/pnpm/global/","/appdata/local/pnpm/global/","/pnpm-global/"],"命中 pnpm 全局安装目录"],["yarn",["/.config/yarn/global/","/yarn/data/global/","/yarn/config/global/","/yarn/global/","/.yarn/global/"],"命中 Yarn 全局安装目录"],["npm",["/appdata/roaming/npm/node_modules/","/usr/local/lib/node_modules/","/usr/lib/node_modules/","/opt/homebrew/lib/node_modules/","/.nvm/versions/node/","/nvm4w/","/fnm/node-versions/","/.fnm/node-versions/","/fnm_multishells/","/.asdf/installs/nodejs/","/.local/share/mise/installs/node/","/.mise/installs/node/","/mise/installs/node/","/.nodenv/versions/","/.n/lib/node_modules/","/program files/nodejs/node_modules/","/scoop/apps/nodejs/"],"命中 npm 全局安装目录"]];function detectFromStandardPaths(candidates,packageRoot){for(let candidate of candidates)for(let[pm,markers,reason]of GLOBAL_PATH_SIGNATURES)if(markers.some((marker)=>candidate.includes(marker)))return{kind:"global",pm,reason,packageRoot};return null}function detectFromGlobalRoots(candidates,globalRoots,packageRoot,realpath){if(globalRoots===void 0||candidates.length===0)return null;for(let candidate of candidates)for(let pm of SUPPORTED_PACKAGE_MANAGERS){let root=globalRoots[pm];if(root===void 0||root.trim()==="")continue;if(expandRootVariants(root,realpath).some((v)=>isWithinDir(candidate,v)))return{kind:"global",pm,reason:`匹配 ${pm} 实查全局目录 (${root})`,packageRoot}}return null}function detectFromLibNodeModulesHeuristic(packageRoot,pathExists){let libIdx=packageRoot.toLowerCase().lastIndexOf("/lib/node_modules/");if(libIdx<=0)return null;let prefixDir=packageRoot.slice(0,libIdx);if(pathExists(joinForPath(prefixDir,"package.json")))return null;return{kind:"global",pm:"npm",reason:LIB_NODE_MODULES_HEURISTIC_REASON,packageRoot}}function detectProjectPm(projectDir,pathExists){if(pathExists(joinForPath(projectDir,"bun.lock"))||pathExists(joinForPath(projectDir,"bun.lockb")))return"bun";if(pathExists(joinForPath(projectDir,"pnpm-lock.yaml")))return"pnpm";if(pathExists(joinForPath(projectDir,"yarn.lock")))return"yarn";return"npm"}function detectGlobalForCandidates(candidates,input){if(candidates.length===0)return null;return detectFromEnvRoots(candidates,input.env,input.packageRoot,input.realpath)??detectFromStandardPaths(candidates,input.packageRoot)??detectFromGlobalRoots(candidates,input.globalRoots,input.packageRoot,input.realpath)}function detectInstallOriginFromPath(input){let env=input.env??process.env,pathExists=input.pathExists??existsSync,realpath=input.realpath??safeRealpath,packageRoot=normalizeSlashes(input.packageRoot),foldedRoot=packageRoot.toLowerCase(),rawCandidates=collectRawFoldedCandidates(foldedRoot,input.rawPaths);if(!foldedRoot.includes("/node_modules/")&&pathExists(joinForPath(input.packageRoot,"src","cli.ts")))return{kind:"source",reason:"包根目录位于本地源码工作树 (存在 src/cli.ts)",packageRoot};let ephemeral=detectEphemeral([foldedRoot,...rawCandidates],packageRoot);if(ephemeral!==null)return ephemeral;let fromRoot=detectGlobalForCandidates([foldedRoot],{env,globalRoots:input.globalRoots,packageRoot,realpath});if(fromRoot!==null)return fromRoot;let fromRaw=detectGlobalForCandidates(rawCandidates,{env,globalRoots:input.globalRoots,packageRoot,realpath});if(fromRaw!==null)return fromRaw;let fromHeuristic=detectFromLibNodeModulesHeuristic(packageRoot,pathExists);if(fromHeuristic!==null)return fromHeuristic;let nmIdx=foldedRoot.indexOf("/node_modules/");if(nmIdx>0){let projectDir=packageRoot.slice(0,nmIdx),probeDir=input.packageRoot.startsWith("\\\\")?`\\\\${projectDir.slice(2)}`:projectDir;if(pathExists(joinForPath(probeDir,"package.json")))return{kind:"local-project",projectDir,suggestedPm:detectProjectPm(probeDir,pathExists),reason:`位于项目本地 node_modules (${projectDir})`,packageRoot}}return{kind:"unknown",reason:"未匹配已知全局包管理器路径或本地源码工作树",packageRoot}}function safeRealpath(path){try{return(realpathSync.native??realpathSync)(path)}catch{return path}}var PACKAGE_NAME_RE=/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/,SEMVER_RE=/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/,TARGET_SPEC_RE=/^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/;function isValidPackageName(name){return name.length>0&&name.length<=214&&PACKAGE_NAME_RE.test(name)}function isValidTargetSpec(spec){return TARGET_SPEC_RE.test(spec)}function isValidRegistryUrl(raw){if(raw.length===0||/[\s"'`$|;&<>\\?#\p{Cc}]/u.test(raw))return!1;try{let parsed=new URL(raw);if(parsed.protocol!=="https:"&&parsed.protocol!=="http:")return!1;if(parsed.username!==""||parsed.password!==""||parsed.search!==""||parsed.hash!=="")return!1;return parsed.hostname.length>0}catch{return!1}}function parseSemver(raw){let match=SEMVER_RE.exec(raw.trim());if(match===null)return null;let major=Number(match[1]),minor=Number(match[2]),patch=Number(match[3]);if(!Number.isSafeInteger(major)||!Number.isSafeInteger(minor)||!Number.isSafeInteger(patch))return null;let prerelease=match[4]===void 0?[]:match[4].split(".");return{major,minor,patch,prerelease}}function comparePrereleaseId(a,b){let aNum=/^\d+$/.test(a),bNum=/^\d+$/.test(b);if(aNum&&bNum)return Math.sign(Number(a)-Number(b));if(aNum&&!bNum)return-1;if(!aNum&&bNum)return 1;if(a===b)return 0;return a<b?-1:1}function compareSemver(a,b){let left=parseSemver(a),right=parseSemver(b);if(left===null||right===null)return null;if(left.major!==right.major)return left.major<right.major?-1:1;if(left.minor!==right.minor)return left.minor<right.minor?-1:1;if(left.patch!==right.patch)return left.patch<right.patch?-1:1;let lPre=left.prerelease,rPre=right.prerelease;if(lPre.length===0&&rPre.length===0)return 0;if(lPre.length===0)return 1;if(rPre.length===0)return-1;let limit=Math.min(lPre.length,rPre.length);for(let i=0;i<limit;i+=1){let diff=comparePrereleaseId(lPre[i],rPre[i]);if(diff!==0)return diff<0?-1:1}if(lPre.length===rPre.length)return 0;return lPre.length<rPre.length?-1:1}var PM_SET=new Set(SUPPORTED_PACKAGE_MANAGERS);function isPackageManager(value){return PM_SET.has(value)}function applyPm(options,value){let normalized=value.trim().toLowerCase();if(!isPackageManager(normalized))return`参数 --pm 不支持 "${value}" (可选值: ${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`;return options.pm=normalized,null}function applyRegistry(options,value){let trimmed=value.trim();if(!isValidRegistryUrl(trimmed))return`参数 --registry 不是合法的 http(s) URL: "${value}"`;return options.registry=trimmed,null}function nextValueToken(argv,index){let next=argv[index+1];if(next===void 0||next===""||next.startsWith("-"))return null;return next}function parseUpdateArgs(argv){let options={check:!1,force:!1,help:!1};for(let i=0;i<argv.length;i+=1){let arg=argv[i];if(arg==="--help"||arg==="-h"){options.help=!0;continue}if(arg==="--check"){options.check=!0;continue}if(arg==="--force"){options.force=!0;continue}if(arg==="--pm"){let val=nextValueToken(argv,i);if(val===null)return{ok:!1,message:`参数 --pm 缺少取值 (可选值: ${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`};let err=applyPm(options,val);if(err!==null)return{ok:!1,message:err};i+=1;continue}if(arg.startsWith("--pm=")){let val=arg.slice(5);if(val==="")return{ok:!1,message:`参数 --pm 缺少取值 (可选值: ${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`};let err=applyPm(options,val);if(err!==null)return{ok:!1,message:err};continue}if(arg==="--registry"){let val=nextValueToken(argv,i);if(val===null)return{ok:!1,message:"参数 --registry 缺少取值"};let err=applyRegistry(options,val);if(err!==null)return{ok:!1,message:err};i+=1;continue}if(arg.startsWith("--registry=")){let val=arg.slice(11);if(val==="")return{ok:!1,message:"参数 --registry 缺少取值"};let err=applyRegistry(options,val);if(err!==null)return{ok:!1,message:err};continue}return{ok:!1,message:`子命令 update 不支持参数: ${arg} (用 update --help 查看用法)`}}return{ok:!0,options}}function formatUpdateHelp(binName,packageName){return[`${binName} update: 自动识别当前安装方式 (bun / npm / pnpm / yarn / volta) 并更新 ${packageName}`,"",`用法: ${binName} update [选项]`,"","选项:"," --check 仅检查最新版本与当前安装方式, 不执行更新",` --pm <管理器> 手动指定更新所用的包管理器 (${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`," --registry <url> 临时指定本次查询与更新所用的 npm registry"," --force 即使已是最新版本仍强制重新安装"," -h, --help 显示本帮助","","说明:"," • 安装方式按当前包在磁盘上的真实落位路径判定, 不受运行时的 bun/node 切换影响"," • 通过 npx / bunx / pnpm dlx / yarn dlx 临时运行, 或处于本地源码开发态时不会盲目覆盖全局"," • 更新子进程在独立临时空目录执行, 隔绝当前工作目录的 .npmrc / bunfig.toml / package.json 干扰"].join(`
1
+ import{readFileSync as readFileSync5}from"node:fs";import{lstat as lstat5,mkdir,writeFile}from"node:fs/promises";import{homedir as homedir8}from"node:os";import{dirname as dirname2}from"node:path";import{readFileSync as readFileSync4}from"node:fs";import{dirname,join as join2}from"node:path";import{fileURLToPath}from"node:url";import{existsSync,realpathSync}from"node:fs";import{posix,win32}from"node:path";var SUPPORTED_PACKAGE_MANAGERS=["bun","npm","pnpm","yarn","volta"],LIB_NODE_MODULES_HEURISTIC_REASON="命中标准 <prefix>/lib/node_modules 全局目录";function normalizeSlashes(path){return path.replaceAll("\\","/").replace(/\/+$/,"")}function joinForPath(base,...parts){return/^(?:[A-Za-z]:[/\\]|\\\\)/.test(base)||base.includes("\\")?win32.join(base,...parts):posix.join(base,...parts)}function foldPath(path){return normalizeSlashes(path).toLowerCase()}function isWithinDir(child,parent){let normParent=foldPath(parent);if(normParent==="")return!1;let normChild=foldPath(child);return normChild===normParent||normChild.startsWith(`${normParent}/`)}function collectRawFoldedCandidates(foldedRoot,rawPaths){let seen=new Set([foldedRoot]),out=[];for(let raw of rawPaths??[]){if(typeof raw!=="string"||raw.trim()==="")continue;let folded=foldPath(raw);if(!seen.has(folded))seen.add(folded),out.push(folded)}return out}function expandRootVariants(root,realpath){let trimmed=root.trim();if(trimmed==="")return[];let out=[trimmed],resolved=realpath(trimmed);if(foldPath(resolved)!==foldPath(trimmed))out.push(resolved);return out}function detectEphemeral(candidates,packageRoot){for(let p of candidates){if(p.includes("/_npx/"))return{kind:"ephemeral",runner:"npx",reason:"位于 npx 临时缓存目录 (_npx)",packageRoot};if(p.includes("/bunx-"))return{kind:"ephemeral",runner:"bunx",reason:"位于 bunx 临时执行目录",packageRoot};if(p.includes("/pnpm/dlx/")||p.includes("/pnpm-cache/dlx/")||p.includes("/pnpm-dlx/"))return{kind:"ephemeral",runner:"pnpm-dlx",reason:"位于 pnpm dlx 临时缓存目录",packageRoot};if(p.includes("/xfs-")&&p.includes("/dlx-")||p.includes("/berry/cache/")&&p.includes("/dlx"))return{kind:"ephemeral",runner:"yarn-dlx",reason:"位于 yarn dlx 临时执行目录",packageRoot};if(p.includes("/deno/npm/"))return{kind:"ephemeral",runner:"deno",reason:"位于 Deno npm 缓存目录 (/deno/npm/)",packageRoot}}return null}function buildEnvRootRules(env,realpath){let rules=[],directSpecs=[["volta",env.VOLTA_HOME,"位于环境变量 VOLTA_HOME 目录内"],["bun",env.BUN_INSTALL,"位于环境变量 BUN_INSTALL 目录内"],["bun",env.BUN_INSTALL_GLOBAL_DIR,"位于环境变量 BUN_INSTALL_GLOBAL_DIR 目录内"],["pnpm",env.PNPM_HOME,"位于环境变量 PNPM_HOME 目录内"]];for(let[pm,rawRoot,reason]of directSpecs){if(rawRoot===void 0||rawRoot.trim()==="")continue;let roots=expandRootVariants(rawRoot,realpath);if(roots.length>0)rules.push({pm,roots,reason})}let npmPrefix=env.NPM_CONFIG_PREFIX??env.npm_config_prefix;if(npmPrefix!==void 0&&npmPrefix.trim()!==""){let npmRoots=[];for(let base of expandRootVariants(npmPrefix,realpath)){let norm=normalizeSlashes(base);if(norm==="")continue;npmRoots.push(`${norm}/lib/node_modules`,`${norm}/node_modules`)}if(npmRoots.length>0)rules.push({pm:"npm",roots:npmRoots,reason:"位于环境变量 NPM_CONFIG_PREFIX 目录内"})}return rules}function detectFromEnvRoots(candidates,env,packageRoot,realpath){if(candidates.length===0)return null;let rules=buildEnvRootRules(env,realpath);for(let candidate of candidates)for(let rule of rules)if(rule.roots.some((root)=>isWithinDir(candidate,root)))return{kind:"global",pm:rule.pm,reason:rule.reason,packageRoot};return null}var GLOBAL_PATH_SIGNATURES=[["volta",["/.volta/tools/","/volta/tools/","/.volta/bin/","/volta/bin/"],"命中 Volta 全局工具安装目录"],["bun",["/.bun/install/global/","/.bun/bin/"],"命中 Bun 全局安装目录 (~/.bun)"],["pnpm",["/pnpm/global/","/library/pnpm/global/","/.local/share/pnpm/global/","/appdata/local/pnpm/global/","/pnpm-global/"],"命中 pnpm 全局安装目录"],["yarn",["/.config/yarn/global/","/yarn/data/global/","/yarn/config/global/","/yarn/global/","/.yarn/global/"],"命中 Yarn 全局安装目录"],["npm",["/appdata/roaming/npm/node_modules/","/usr/local/lib/node_modules/","/usr/lib/node_modules/","/opt/homebrew/lib/node_modules/","/.nvm/versions/node/","/nvm4w/","/fnm/node-versions/","/.fnm/node-versions/","/fnm_multishells/","/.asdf/installs/nodejs/","/.local/share/mise/installs/node/","/.mise/installs/node/","/mise/installs/node/","/.nodenv/versions/","/.n/lib/node_modules/","/program files/nodejs/node_modules/","/scoop/apps/nodejs/"],"命中 npm 全局安装目录"]];function detectFromStandardPaths(candidates,packageRoot){for(let candidate of candidates)for(let[pm,markers,reason]of GLOBAL_PATH_SIGNATURES)if(markers.some((marker)=>candidate.includes(marker)))return{kind:"global",pm,reason,packageRoot};return null}function detectFromGlobalRoots(candidates,globalRoots,packageRoot,realpath){if(globalRoots===void 0||candidates.length===0)return null;for(let candidate of candidates)for(let pm of SUPPORTED_PACKAGE_MANAGERS){let root=globalRoots[pm];if(root===void 0||root.trim()==="")continue;if(expandRootVariants(root,realpath).some((v)=>isWithinDir(candidate,v)))return{kind:"global",pm,reason:`匹配 ${pm} 实查全局目录 (${root})`,packageRoot}}return null}function detectFromLibNodeModulesHeuristic(packageRoot,pathExists){let libIdx=packageRoot.toLowerCase().lastIndexOf("/lib/node_modules/");if(libIdx<=0)return null;let prefixDir=packageRoot.slice(0,libIdx);if(pathExists(joinForPath(prefixDir,"package.json")))return null;return{kind:"global",pm:"npm",reason:LIB_NODE_MODULES_HEURISTIC_REASON,packageRoot}}function detectProjectPm(projectDir,pathExists){if(pathExists(joinForPath(projectDir,"bun.lock"))||pathExists(joinForPath(projectDir,"bun.lockb")))return"bun";if(pathExists(joinForPath(projectDir,"pnpm-lock.yaml")))return"pnpm";if(pathExists(joinForPath(projectDir,"yarn.lock")))return"yarn";return"npm"}function detectGlobalForCandidates(candidates,input){if(candidates.length===0)return null;return detectFromEnvRoots(candidates,input.env,input.packageRoot,input.realpath)??detectFromStandardPaths(candidates,input.packageRoot)??detectFromGlobalRoots(candidates,input.globalRoots,input.packageRoot,input.realpath)}function detectInstallOriginFromPath(input){let env=input.env??process.env,pathExists=input.pathExists??existsSync,realpath=input.realpath??safeRealpath,packageRoot=normalizeSlashes(input.packageRoot),foldedRoot=packageRoot.toLowerCase(),rawCandidates=collectRawFoldedCandidates(foldedRoot,input.rawPaths);if(!foldedRoot.includes("/node_modules/")&&pathExists(joinForPath(input.packageRoot,"src","cli.ts")))return{kind:"source",reason:"包根目录位于本地源码工作树 (存在 src/cli.ts)",packageRoot};let ephemeral=detectEphemeral([foldedRoot,...rawCandidates],packageRoot);if(ephemeral!==null)return ephemeral;let fromRoot=detectGlobalForCandidates([foldedRoot],{env,globalRoots:input.globalRoots,packageRoot,realpath});if(fromRoot!==null)return fromRoot;let fromRaw=detectGlobalForCandidates(rawCandidates,{env,globalRoots:input.globalRoots,packageRoot,realpath});if(fromRaw!==null)return fromRaw;let fromHeuristic=detectFromLibNodeModulesHeuristic(packageRoot,pathExists);if(fromHeuristic!==null)return fromHeuristic;let nmIdx=foldedRoot.indexOf("/node_modules/");if(nmIdx>0){let projectDir=packageRoot.slice(0,nmIdx),probeDir=input.packageRoot.startsWith("\\\\")?`\\\\${projectDir.slice(2)}`:projectDir;if(pathExists(joinForPath(probeDir,"package.json")))return{kind:"local-project",projectDir,suggestedPm:detectProjectPm(probeDir,pathExists),reason:`位于项目本地 node_modules (${projectDir})`,packageRoot}}return{kind:"unknown",reason:"未匹配已知全局包管理器路径或本地源码工作树",packageRoot}}function safeRealpath(path){try{return(realpathSync.native??realpathSync)(path)}catch{return path}}var PACKAGE_NAME_RE=/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/,SEMVER_RE=/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/,TARGET_SPEC_RE=/^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/;function isValidPackageName(name){return name.length>0&&name.length<=214&&PACKAGE_NAME_RE.test(name)}function isValidTargetSpec(spec){return TARGET_SPEC_RE.test(spec)}function isValidRegistryUrl(raw){if(raw.length===0||/[\s"'`$|;&<>\\?#\p{Cc}]/u.test(raw))return!1;try{let parsed=new URL(raw);if(parsed.protocol!=="https:"&&parsed.protocol!=="http:")return!1;if(parsed.username!==""||parsed.password!==""||parsed.search!==""||parsed.hash!=="")return!1;return parsed.hostname.length>0}catch{return!1}}function parseSemver(raw){let match=SEMVER_RE.exec(raw.trim());if(match===null)return null;let major=Number(match[1]),minor=Number(match[2]),patch=Number(match[3]);if(!Number.isSafeInteger(major)||!Number.isSafeInteger(minor)||!Number.isSafeInteger(patch))return null;let prerelease=match[4]===void 0?[]:match[4].split(".");return{major,minor,patch,prerelease}}function comparePrereleaseId(a,b){let aNum=/^\d+$/.test(a),bNum=/^\d+$/.test(b);if(aNum&&bNum)return Math.sign(Number(a)-Number(b));if(aNum&&!bNum)return-1;if(!aNum&&bNum)return 1;if(a===b)return 0;return a<b?-1:1}function compareSemver(a,b){let left=parseSemver(a),right=parseSemver(b);if(left===null||right===null)return null;if(left.major!==right.major)return left.major<right.major?-1:1;if(left.minor!==right.minor)return left.minor<right.minor?-1:1;if(left.patch!==right.patch)return left.patch<right.patch?-1:1;let lPre=left.prerelease,rPre=right.prerelease;if(lPre.length===0&&rPre.length===0)return 0;if(lPre.length===0)return 1;if(rPre.length===0)return-1;let limit=Math.min(lPre.length,rPre.length);for(let i=0;i<limit;i+=1){let diff=comparePrereleaseId(lPre[i],rPre[i]);if(diff!==0)return diff<0?-1:1}if(lPre.length===rPre.length)return 0;return lPre.length<rPre.length?-1:1}var PM_SET=new Set(SUPPORTED_PACKAGE_MANAGERS);function isPackageManager(value){return PM_SET.has(value)}function applyPm(options,value){let normalized=value.trim().toLowerCase();if(!isPackageManager(normalized))return`参数 --pm 不支持 "${value}" (可选值: ${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`;return options.pm=normalized,null}function applyRegistry(options,value){let trimmed=value.trim();if(!isValidRegistryUrl(trimmed))return`参数 --registry 不是合法的 http(s) URL: "${value}"`;return options.registry=trimmed,null}function nextValueToken(argv,index){let next=argv[index+1];if(next===void 0||next===""||next.startsWith("-"))return null;return next}function parseUpdateArgs(argv){let options={check:!1,force:!1,help:!1};for(let i=0;i<argv.length;i+=1){let arg=argv[i];if(arg==="--help"||arg==="-h"){options.help=!0;continue}if(arg==="--check"){options.check=!0;continue}if(arg==="--force"){options.force=!0;continue}if(arg==="--pm"){let val=nextValueToken(argv,i);if(val===null)return{ok:!1,message:`参数 --pm 缺少取值 (可选值: ${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`};let err=applyPm(options,val);if(err!==null)return{ok:!1,message:err};i+=1;continue}if(arg.startsWith("--pm=")){let val=arg.slice(5);if(val==="")return{ok:!1,message:`参数 --pm 缺少取值 (可选值: ${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`};let err=applyPm(options,val);if(err!==null)return{ok:!1,message:err};continue}if(arg==="--registry"){let val=nextValueToken(argv,i);if(val===null)return{ok:!1,message:"参数 --registry 缺少取值"};let err=applyRegistry(options,val);if(err!==null)return{ok:!1,message:err};i+=1;continue}if(arg.startsWith("--registry=")){let val=arg.slice(11);if(val==="")return{ok:!1,message:"参数 --registry 缺少取值"};let err=applyRegistry(options,val);if(err!==null)return{ok:!1,message:err};continue}return{ok:!1,message:`子命令 update 不支持参数: ${arg} (用 update --help 查看用法)`}}return{ok:!0,options}}function formatUpdateHelp(binName,packageName){return["",` ${binName} update 自更新工具 (${packageName})`," 自动识别当前安装器 (bun / npm / pnpm / yarn / volta) 并原地升级。"," ────────────────────────────────────────────────────────────────────────────",""," 用法",` ${binName} update [选项]`,""," 选项"," --check 仅检查最新版本与当前安装方式, 不执行更新",` --pm <管理器> 手动指定更新所用的包管理器 (${SUPPORTED_PACKAGE_MANAGERS.join(" | ")})`," --registry <url> 临时指定本次查询与更新所用的 npm registry"," --force 即使已是最新版本仍强制重新安装",""," -h, --help 显示本帮助",""," 说明"," 识别依据 按当前包在磁盘上的真实落位路径判定, 不受 bun / node 运行时切换影响"," 安全边界 npx / bunx / dlx 临时运行或本地源码态不盲目覆盖全局安装"," 环境隔离 更新子进程在独立临时空目录执行, 隔绝 cwd 配置干扰"," 镜像源 默认走官方源 registry.npmjs.org, 自动遵循本机 ~/.bunfig.toml 或 ~/.npmrc",""].join(`
2
2
  `)}import{spawnSync}from"node:child_process";import{existsSync as existsSync2,mkdtempSync,readFileSync as readFileSync2,rmSync,statSync}from"node:fs";import{homedir as homedir2,tmpdir}from"node:os";import{join,posix as posix2,win32 as win323}from"node:path";function normalizeRegistryUrl(url){return url.trim().replace(/\/+$/,"")}function extractScope(packageName){if(!packageName.startsWith("@"))return null;let slash=packageName.indexOf("/");return slash>1?packageName.slice(0,slash):null}function unquotePair(raw){let trimmed=raw.trim();if(trimmed.length>=2&&(trimmed.startsWith('"')&&trimmed.endsWith('"')||trimmed.startsWith("'")&&trimmed.endsWith("'")))return trimmed.slice(1,-1);return trimmed}function stripTomlComment(line){let inDouble=!1,inSingle=!1,escaped=!1;for(let i=0;i<line.length;i+=1){let ch=line[i];if(inDouble){if(escaped)escaped=!1;else if(ch==="\\")escaped=!0;else if(ch==='"')inDouble=!1;continue}if(inSingle){if(ch==="'")inSingle=!1;continue}if(ch==="#")return line.slice(0,i).trim();if(ch==='"')inDouble=!0;else if(ch==="'")inSingle=!0}return line.trim()}function parseTomlString(raw){let trimmed=raw.trim();if(trimmed.length<2)return null;let quote=trimmed[0];if(quote!=='"'&&quote!=="'")return null;if(quote==="'"){let end=trimmed.indexOf("'",1);return end===trimmed.length-1?trimmed.slice(1,end):null}let out="",escaped=!1;for(let i=1;i<trimmed.length;i+=1){let ch=trimmed[i];if(escaped){out+=ch,escaped=!1;continue}if(ch==="\\"){escaped=!0;continue}if(ch==='"')return i===trimmed.length-1?out:null;out+=ch}return null}function extractInlineField(body,fieldName){let m=new RegExp(`(?:^|[,{])\\s*${fieldName}\\s*=\\s*("[^"\\\\]*(?:\\\\.[^"\\\\]*)*"|'[^']*')`).exec(body);return m===null?null:parseTomlString(m[1])}function normalizeUrlPath(pathname){let trimmed=pathname.replace(/\/+$/,"");return trimmed===""?"/":`${trimmed}/`}function expandEnvToken(raw,env,allowBareDollar){let missing=!1,expanded=raw.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g,(_m,name)=>{let val=env[name];if(typeof val!=="string"||val==="")return missing=!0,"";return val});if(missing||expanded.includes("${"))return null;if(allowBareDollar){if(expanded=expanded.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g,(_m,name)=>{let val=env[name];if(typeof val!=="string"||val==="")return missing=!0,"";return val}),missing)return null}let trimmed=expanded.trim();if(trimmed===""||/[\s\p{Cc}]/u.test(trimmed))return null;return trimmed}function parseRegistryFromNpmrc(content,packageName){let scope=extractScope(packageName),globalReg=null,scopedReg=null;for(let rawLine of content.split(/\r?\n/)){let line=rawLine.trim();if(line===""||line.startsWith("#")||line.startsWith(";"))continue;let eq=line.indexOf("=");if(eq<=0)continue;let key=line.slice(0,eq).trim(),value=unquotePair(line.slice(eq+1));if(!isValidRegistryUrl(value))continue;if(scope!==null&&key===`${scope}:registry`)scopedReg=value;else if(key==="registry")globalReg=value}return scopedReg??globalReg}function parseAuthTokenFromNpmrc(content,registryUrl,env=process.env){let target;try{target=new URL(normalizeRegistryUrl(registryUrl))}catch{return null}let targetHost=target.host.toLowerCase(),targetPath=normalizeUrlPath(target.pathname),matched=null;for(let rawLine of content.split(/\r?\n/)){let line=rawLine.trim();if(line===""||line.startsWith("#")||line.startsWith(";"))continue;let eq=line.indexOf("=");if(eq<=0)continue;let key=line.slice(0,eq).trim();if(!key.startsWith("//")||!key.endsWith(":_authToken"))continue;let hostPath=key.slice(2,-11);if(hostPath==="")continue;let entry;try{entry=new URL(`https://${hostPath}`)}catch{continue}if(entry.host.toLowerCase()!==targetHost||normalizeUrlPath(entry.pathname)!==targetPath)continue;let token=expandEnvToken(unquotePair(line.slice(eq+1)),env,!1);if(token!==null)matched=token}return matched}function parseScopedSubtableHeader(section){let m=/^install\.scopes\.(?:"([^"]+)"|'([^']+)'|([^\s.\]]+))$/.exec(section);if(m===null)return null;let scopeName=(m[1]??m[2]??m[3]??"").trim();return scopeName.startsWith("@")?scopeName:null}function applyBunfigKeyValue(target,key,rhs){let str=parseTomlString(rhs);if(str===null)return;if(key==="url"&&isValidRegistryUrl(str))target.url=str;else if(key==="token"&&str.trim()!=="")target.token=str}function applyBunfigRegistryRhs(target,rhs){let str=parseTomlString(rhs);if(str!==null){if(isValidRegistryUrl(str))target.url=str;return}if(!rhs.startsWith("{")||!rhs.endsWith("}"))return;let url=extractInlineField(rhs,"url");if(url!==null&&isValidRegistryUrl(url))target.url=url;let token=extractInlineField(rhs,"token");if(token!==null&&token.trim()!=="")target.token=token}function parseBunfigInstall(content){let result={globalEntry:{},scopes:new Map,globalDir:null},section="",getScopeEntry=(scopeName)=>{let existing=result.scopes.get(scopeName);if(existing!==void 0)return existing;let created={};return result.scopes.set(scopeName,created),created};for(let rawLine of content.split(/\r?\n/)){let line=stripTomlComment(rawLine);if(line==="")continue;let secMatch=/^\[([^\]]+)\]$/.exec(line);if(secMatch!==null){section=secMatch[1].trim();continue}let eq=line.indexOf("=");if(eq<=0)continue;let rawKey=line.slice(0,eq).trim(),rhs=line.slice(eq+1).trim();if(section==="install"){if(rawKey==="registry")applyBunfigRegistryRhs(result.globalEntry,rhs);else if(rawKey==="globalDir"){let dir=parseTomlString(rhs);if(dir!==null&&dir.trim()!=="")result.globalDir=dir.trim()}continue}if(section==="install.registry"){applyBunfigKeyValue(result.globalEntry,rawKey,rhs);continue}if(section==="install.scopes"){let scopeName=unquotePair(rawKey);if(scopeName.startsWith("@"))applyBunfigRegistryRhs(getScopeEntry(scopeName),rhs);continue}let subScope=parseScopedSubtableHeader(section);if(subScope!==null)applyBunfigKeyValue(getScopeEntry(subScope),rawKey,rhs)}return result}function parseRegistryFromBunfig(content,packageName){let parsed=parseBunfigInstall(content),scope=extractScope(packageName);return(scope!==null?parsed.scopes.get(scope)?.url:void 0)??parsed.globalEntry.url??null}function matchesRegistryOriginAndPath(targetUrl,entryUrl){try{let a=new URL(normalizeRegistryUrl(targetUrl)),b=new URL(normalizeRegistryUrl(entryUrl));return a.protocol===b.protocol&&a.host.toLowerCase()===b.host.toLowerCase()&&normalizeUrlPath(a.pathname)===normalizeUrlPath(b.pathname)}catch{return!1}}function parseAuthTokenFromBunfig(content,registryUrl,packageName,env=process.env){let parsed=parseBunfigInstall(content),scope=extractScope(packageName),ordered=[];if(scope!==null){let scoped=parsed.scopes.get(scope);if(scoped!==void 0)ordered.push(scoped)}ordered.push(parsed.globalEntry);for(let[k,entry]of parsed.scopes.entries())if(k!==scope)ordered.push(entry);for(let entry of ordered){if(entry.url===void 0||entry.token===void 0)continue;if(!matchesRegistryOriginAndPath(registryUrl,entry.url))continue;let expanded=expandEnvToken(entry.token,env,!0);if(expanded!==null)return expanded}return null}function parseGlobalDirFromBunfig(content){return parseBunfigInstall(content).globalDir}import{readFileSync}from"node:fs";import{homedir}from"node:os";var DEFAULT_REGISTRY="https://registry.npmjs.org",DEFAULT_FETCH_TIMEOUT_MS=1e4;function defaultReadText(path){try{return readFileSync(path,"utf8")}catch{return null}}function resolveRegistry(input){if(input.flagRegistry!==void 0&&isValidRegistryUrl(input.flagRegistry))return normalizeRegistryUrl(input.flagRegistry);let env=input.env??process.env,envReg=env.NPM_CONFIG_REGISTRY??env.npm_config_registry;if(typeof envReg==="string"&&isValidRegistryUrl(envReg))return normalizeRegistryUrl(envReg);let home=input.homeDir??homedir(),readText=input.readText??defaultReadText;if(input.pm==="bun"){let bunfig=readText(joinForPath(home,".bunfig.toml"));if(bunfig!==null){let found=parseRegistryFromBunfig(bunfig,input.packageName);if(found!==null)return normalizeRegistryUrl(found)}}let npmrc=readText(joinForPath(home,".npmrc"));if(npmrc!==null){let found=parseRegistryFromNpmrc(npmrc,input.packageName);if(found!==null)return normalizeRegistryUrl(found)}if(input.pm===void 0){let bunfig=readText(joinForPath(home,".bunfig.toml"));if(bunfig!==null){let found=parseRegistryFromBunfig(bunfig,input.packageName);if(found!==null)return normalizeRegistryUrl(found)}}return DEFAULT_REGISTRY}function resolveRegistryAuthToken(input){if(!isValidRegistryUrl(input.registry))return;let env=input.env??process.env,home=input.homeDir??homedir(),readText=input.readText??defaultReadText,base=normalizeRegistryUrl(input.registry);if(input.pm==="bun"){let bunfig=readText(joinForPath(home,".bunfig.toml"));if(bunfig!==null){let token=parseAuthTokenFromBunfig(bunfig,base,input.packageName,env);if(token!==null)return token}}let npmrc=readText(joinForPath(home,".npmrc"));if(npmrc!==null){let token=parseAuthTokenFromNpmrc(npmrc,base,env);if(token!==null)return token}if(input.pm===void 0){let bunfig=readText(joinForPath(home,".bunfig.toml"));if(bunfig!==null){let token=parseAuthTokenFromBunfig(bunfig,base,input.packageName,env);if(token!==null)return token}}return}function cleanMessage(raw,secret){return(secret!==void 0&&secret!==""?raw.replaceAll(secret,"[REDACTED]"):raw).replace(/\p{Cc}/gu," ").replace(/\s+/g," ").trim()}async function fetchLatestVersion(input){let tag=input.tag??"latest";if(!isValidPackageName(input.packageName))return{ok:!1,code:"invalid-response",message:`非法包名: ${cleanMessage(input.packageName)}`};if(!isValidTargetSpec(tag)||!isValidRegistryUrl(input.registry))return{ok:!1,code:"invalid-response",message:"非法的 registry 地址或版本标签"};let base=normalizeRegistryUrl(input.registry),url=`${base}/${encodeURIComponent(input.packageName)}/${encodeURIComponent(tag)}`,fetchFn=input.fetchFn??fetch,timeoutMs=input.timeoutMs??DEFAULT_FETCH_TIMEOUT_MS,authToken=typeof input.authToken==="string"&&input.authToken.trim()!==""&&!/[\s\p{Cc}]/u.test(input.authToken)?input.authToken.trim():void 0,headers={accept:"application/vnd.npm.install-v1+json, application/json"};if(authToken!==void 0)headers.authorization=`Bearer ${authToken}`;let response;try{response=await fetchFn(url,{headers,signal:AbortSignal.timeout(timeoutMs)})}catch(error){let detail=error instanceof Error?cleanMessage(error.message,authToken):"";return{ok:!1,code:"network",message:detail===""?`无法连接包注册表 (${base})`:`无法连接包注册表 (${base}): ${detail}`}}if(response.status===401||response.status===403)return{ok:!1,code:"auth",status:response.status,message:`访问包注册表 ${base} 鉴权失败 (HTTP ${response.status}), 请检查 ~/.npmrc / ~/.bunfig.toml 认证凭据或登录状态`};if(response.status===404)return{ok:!1,code:"not-found",status:404,message:`${input.packageName} 尚未在 ${base} 发布 (HTTP 404)`};if(!response.ok)return{ok:!1,code:"http",status:response.status,message:`包注册表返回异常状态 HTTP ${response.status} (${base})`};let body;try{body=await response.json()}catch{return{ok:!1,code:"invalid-response",message:`包注册表返回的内容不是合法 JSON (${base})`}}let version=typeof body==="object"&&body!==null&&!Array.isArray(body)?body.version:void 0;if(typeof version!=="string"||!isValidTargetSpec(version))return{ok:!1,code:"invalid-response",message:`包注册表响应缺少合法 version 字段 (${base})`};return{ok:!0,version,registry:base}}import{win32 as win322}from"node:path";function isWin32AbsolutePath(dir){return/^(?:[A-Za-z]:[/\\]|\\\\[^\\]+\\[^\\]+)/.test(dir)}var CMD_META_OR_SPACE_RE=/[\s&|<>^()%!]/,CMD_FORBIDDEN_RE=/[\r\n\0"]/;function wrapDoubleQuotes(segment){return`"${segment.replace(/(\\+)$/,"$1$1")}"`}function escapeBatchPath(batchPath){if(batchPath===""||CMD_FORBIDDEN_RE.test(batchPath))return null;if(!/[%!]/.test(batchPath))return wrapDoubleQuotes(batchPath);let out="",buf="";for(let ch of batchPath)if(ch==="%"||ch==="!"){if(buf!=="")out+=wrapDoubleQuotes(buf),buf="";out+=`^${ch}`}else buf+=ch;if(buf!=="")out+=wrapDoubleQuotes(buf);return out}function escapeBatchArg(arg){if(CMD_FORBIDDEN_RE.test(arg))return null;if(arg==="")return'""';if(!CMD_META_OR_SPACE_RE.test(arg))return arg;if(!/[%!]/.test(arg))return wrapDoubleQuotes(arg);let out="",buf="";for(let ch of arg)if(ch==="%"||ch==="!"){if(buf!=="")out+=wrapDoubleQuotes(buf),buf="";out+=`^^^${ch}`}else buf+=ch;if(buf!=="")out+=wrapDoubleQuotes(buf);return out}function buildWindowsBatchCommandLine(batchPath,pmArgs){let escapedPath=escapeBatchPath(batchPath);if(escapedPath===null)return null;let escapedArgs=[];for(let arg of pmArgs){let escaped=escapeBatchArg(arg);if(escaped===null)return null;escapedArgs.push(escaped)}return`"${escapedArgs.length===0?escapedPath:`${escapedPath} ${escapedArgs.join(" ")}`}"`}function resolveNodeExeForDir(dir,isFile,findNativeNode){let sibling=win322.join(dir,"node.exe");if(isFile(sibling))return sibling;return findNativeNode()}function resolveWindowsBatchDirectJs(pm,batchPath,args,isFile,findNativeNode){let dir=win322.dirname(batchPath),candidates=[];if(pm==="npm")candidates=[win322.join(dir,"node_modules","npm","bin","npm-cli.js")];else if(pm==="pnpm")candidates=[win322.join(dir,"node_modules","pnpm","bin","pnpm.cjs"),win322.join(dir,"node_modules","corepack","dist","pnpm.js")];else if(pm==="yarn")candidates=[win322.join(dir,"yarn.js"),win322.join(dir,"node_modules","yarn","bin","yarn.js"),win322.join(dir,"node_modules","corepack","dist","yarn.js")];else return null;for(let entryJs of candidates){if(!isFile(entryJs))continue;let nodeExe=resolveNodeExeForDir(dir,isFile,findNativeNode);if(nodeExe!==null)return{command:nodeExe,args:[entryJs,...args]}}return null}function resolveWindowsBatchInvocation(pm,batchPath,pmArgs,env,isFile,findNativeNode){let directJs=resolveWindowsBatchDirectJs(pm,batchPath,pmArgs,isFile,findNativeNode);if(directJs!==null)return directJs;let cmdLine=buildWindowsBatchCommandLine(batchPath,pmArgs);if(cmdLine===null)return null;return{command:env.ComSpec??env.COMSPEC??"cmd.exe",args:["/d","/s","/c",cmdLine],windowsVerbatimArguments:!0}}var WIN32_NATIVE_EXTS=[".exe",".com"],WIN32_BATCH_EXTS=[".cmd",".bat"],PROBE_ENV_OVERLAY={COREPACK_ENABLE_DOWNLOAD_PROMPT:"0"};function defaultIsFile(path){try{return statSync(path).isFile()}catch{return!1}}function defaultReadText2(path){try{return readFileSync2(path,"utf8")}catch{return null}}function parseAbsolutePathDirs(env,platform){let raw=platform==="win32"?env.PATH??env.Path??"":env.PATH??"",sep=platform==="win32"?";":":",out=[];for(let item of raw.split(sep)){let trimmed=item.trim(),cleaned=trimmed.length>1&&trimmed.startsWith('"')&&trimmed.endsWith('"')?trimmed.slice(1,-1):trimmed;if(cleaned==="")continue;if(platform==="win32"?isWin32AbsolutePath(cleaned):cleaned.startsWith("/"))out.push(cleaned)}return out}function resolveExecutableInPath(name,platform=process.platform,env=process.env,isFile=defaultIsFile){let dirs=parseAbsolutePathDirs(env,platform);if(platform!=="win32"){for(let dir of dirs){let candidate=posix2.join(dir,name);if(isFile(candidate))return{path:candidate,isBatch:!1}}return null}for(let dir of dirs){for(let ext of WIN32_NATIVE_EXTS){let candidate=win323.join(dir,`${name}${ext}`);if(isFile(candidate))return{path:candidate,isBatch:!1}}for(let ext of WIN32_BATCH_EXTS){let candidate=win323.join(dir,`${name}${ext}`);if(isFile(candidate))return{path:candidate,isBatch:!0}}}return null}function resolvePmInvocation(pm,pmArgs,platform=process.platform,env=process.env,isFile=defaultIsFile){let found=resolveExecutableInPath(pm,platform,env,isFile);if(found===null)return null;if(platform==="win32"&&found.isBatch){let findNativeNode=()=>{let nodeFound=resolveExecutableInPath("node","win32",env,isFile);return nodeFound!==null&&!nodeFound.isBatch?nodeFound.path:null};return resolveWindowsBatchInvocation(pm,found.path,pmArgs,env,isFile,findNativeNode)}return{command:found.path,args:[...pmArgs]}}function formatUpgradeDisplayCommand(pm,packageName,targetSpec="latest",explicitRegistry){let spec=`${packageName}@${targetSpec}`,reg=explicitRegistry!==void 0?normalizeRegistryUrl(explicitRegistry):void 0;switch(pm){case"bun":return reg===void 0?`bun add -g ${spec}`:`bun add -g ${spec} --registry=${reg}`;case"npm":return reg===void 0?`npm install -g ${spec}`:`npm install -g ${spec} --registry=${reg}`;case"pnpm":return reg===void 0?`pnpm add -g ${spec}`:`pnpm add -g ${spec} --registry=${reg}`;case"yarn":return reg===void 0?`yarn global add ${spec}`:`yarn global add ${spec} --registry ${reg}`;case"volta":return reg===void 0?`volta install ${spec}`:`NPM_CONFIG_REGISTRY=${reg} volta install ${spec}`}}function isYarnBerryVersion(versionText){if(versionText===null)return!1;let m=/^v?(\d+)\./.exec(versionText.trim());if(m===null)return!1;return Number(m[1])>=2}function buildPmUpgradeArgs(pm,spec,reg){if(pm==="volta")return["install",spec];if(pm==="yarn")return reg===void 0?["global","add",spec]:["global","add",spec,"--registry",reg];let base=pm==="npm"?["install","-g",spec]:["add","-g",spec];return reg===void 0?base:[...base,`--registry=${reg}`]}function buildUpgradePlan(input){let targetSpec=input.targetSpec??"latest";if(!isValidPackageName(input.packageName))return{ok:!1,reason:`非法包名: ${input.packageName}`};if(!isValidTargetSpec(targetSpec))return{ok:!1,reason:`非法目标版本标签: ${targetSpec}`};if(input.explicitRegistry!==void 0&&!isValidRegistryUrl(input.explicitRegistry))return{ok:!1,reason:`非法 registry 地址: ${input.explicitRegistry}`};let platform=input.platform??process.platform,env=input.env??process.env,isFile=input.isFile??defaultIsFile,reg=input.explicitRegistry!==void 0?normalizeRegistryUrl(input.explicitRegistry):void 0,displayCommand=formatUpgradeDisplayCommand(input.pm,input.packageName,targetSpec,reg);if(input.pm==="yarn"&&isYarnBerryVersion(input.yarnVersion??null))return{ok:!1,reason:`当前环境的 Yarn (${input.yarnVersion?.trim()}) 为 v2+ (Berry), 官方已移除 yarn global add 命令, `+"请改用 --pm bun / --pm npm / --pm pnpm 执行全局更新"};let spec=`${input.packageName}@${targetSpec}`,pmArgs=buildPmUpgradeArgs(input.pm,spec,reg),invocation=resolvePmInvocation(input.pm,pmArgs,platform,env,isFile);if(invocation===null)return{ok:!1,reason:`当前 PATH 中未找到 ${input.pm} 可执行文件, 无法自动执行更新`,fallbackCommand:displayCommand};let envOverlay=reg===void 0?void 0:{npm_config_registry:reg,NPM_CONFIG_REGISTRY:reg};return{ok:!0,plan:{command:invocation.command,args:invocation.args,displayCommand,envOverlay,...invocation.windowsVerbatimArguments===!0?{windowsVerbatimArguments:!0}:{}}}}function buildIsolatedEnv(baseEnv,overlay){let next={...baseEnv};if(delete next.npm_execpath,delete next.npm_lifecycle_event,delete next.npm_lifecycle_script,delete next.npm_package_json,delete next.INIT_CWD,overlay!==void 0)Object.assign(next,overlay);return next}function withIsolatedCwd(fn){let dir=mkdtempSync(join(tmpdir(),"cli-update-"));try{return fn(dir)}finally{try{rmSync(dir,{recursive:!0,force:!0,maxRetries:3,retryDelay:50})}catch{}}}function runIsolatedProbe(cwd,invocation,env,spawnFn){let res=spawnFn(invocation.command,invocation.args,{cwd,env:buildIsolatedEnv(env,PROBE_ENV_OVERLAY),encoding:"utf8",stdio:["ignore","pipe","ignore"],timeout:3000,...invocation.windowsVerbatimArguments===!0?{windowsVerbatimArguments:!0}:{}});if(res.status!==0||typeof res.stdout!=="string")return null;let text=res.stdout.trim();return text===""?null:text}function probeYarnVersion(platform=process.platform,env=process.env,spawnFn=spawnSync){let invocation=resolvePmInvocation("yarn",["--version"],platform,env);if(invocation===null)return null;return withIsolatedCwd((cwd)=>runIsolatedProbe(cwd,invocation,env,spawnFn))}var joinForPlatform=(p,...parts)=>p==="win32"?win323.join(...parts):posix2.join(...parts);function expandHomeDir(raw,home,p){if(raw==="~")return home;if(raw.startsWith("~/")||raw.startsWith("~\\"))return joinForPlatform(p,home,raw.slice(2));return raw}function resolveBunGlobalDirFromConfig(home,platform,readText,pathExists){let bunfig=readText(joinForPlatform(platform,home,".bunfig.toml"));if(bunfig===null)return null;let rawDir=parseGlobalDirFromBunfig(bunfig);if(rawDir===null)return null;let expanded=expandHomeDir(rawDir,home,platform);return pathExists(expanded)?safeRealpath(expanded):null}function probeGlobalRoots(platform=process.platform,env=process.env,spawnFn=spawnSync,options){let roots={},home=options?.homeDir??homedir2(),readText=options?.readText??defaultReadText2,pathExists=options?.pathExists??existsSync2,isFile=options?.isFile??defaultIsFile,bunDir=resolveBunGlobalDirFromConfig(home,platform,readText,pathExists);if(bunDir!==null)roots.bun=bunDir;return withIsolatedCwd((cwd)=>{let probeDir=(pm,args)=>{let invocation=resolvePmInvocation(pm,args,platform,env,isFile);if(invocation===null)return null;let stdout=runIsolatedProbe(cwd,invocation,env,spawnFn);if(stdout===null)return null;let line=stdout.split(/\r?\n/)[0]?.trim()??"";if(line===""||!pathExists(line))return null;return safeRealpath(line)},pnpmRoot=probeDir("pnpm",["root","-g"]);if(pnpmRoot!==null)roots.pnpm=pnpmRoot;let npmRoot=probeDir("npm",["root","-g"]);if(npmRoot!==null)roots.npm=npmRoot;let yarnVerInv=resolvePmInvocation("yarn",["--version"],platform,env,isFile),yarnVer=yarnVerInv!==null?runIsolatedProbe(cwd,yarnVerInv,env,spawnFn):null;if(yarnVer!==null&&!isYarnBerryVersion(yarnVer)){let yarnDir=probeDir("yarn",["global","dir"]);if(yarnDir!==null)roots.yarn=yarnDir}}),roots}function executeUpgradePlan(plan,env=process.env,spawnFn=spawnSync){return withIsolatedCwd((cwd)=>{let res=spawnFn(plan.command,plan.args,{cwd,env:buildIsolatedEnv(env,plan.envOverlay),stdio:"inherit",...plan.windowsVerbatimArguments===!0?{windowsVerbatimArguments:!0}:{}});return{status:res.status,signal:res.signal,error:res.error}})}import{existsSync as existsSync3,readFileSync as readFileSync3}from"node:fs";function sanitize(raw){return raw.replace(/\p{Cc}/gu," ").replace(/\s+/g," ").trim()}function formatVersionLabel(spec){return/^\d/.test(spec)?`v${spec}`:spec}function defaultReadText3(path){try{return readFileSync3(path,"utf8")}catch{return null}}function ephemeralHintCommand(runner,packageName){switch(runner){case"bunx":return`bunx ${packageName}@latest`;case"npx":return`npx ${packageName}@latest`;case"pnpm-dlx":return`pnpm dlx ${packageName}@latest`;case"yarn-dlx":return`yarn dlx ${packageName}@latest`;case"deno":return`deno run -A npm:${packageName}@latest`}}function localProjectHintCommand(pm,packageName){switch(pm){case"bun":return`bun add -D ${packageName}@latest`;case"pnpm":return`pnpm add -D ${packageName}@latest`;case"yarn":return`yarn add -D ${packageName}@latest`;case"npm":return`npm install -D ${packageName}@latest`}}function describeOrigin(origin){switch(origin.kind){case"global":return`${origin.pm} 全局安装 (${origin.reason})`;case"ephemeral":return`${origin.runner} 临时运行 (${origin.reason})`;case"source":return`本地源码开发态 (${origin.packageRoot})`;case"local-project":return`项目本地依赖 (${origin.projectDir})`;case"unknown":return`未知安装位置 (${origin.packageRoot})`}}function warnCrossPmOverride(origin,targetPm,io){if(origin.kind==="global"&&origin.pm!==targetPm){io.out(`注意: 当前命令实际由 ${origin.pm} 全局安装, 改用 ${targetPm} 安装会在磁盘产生双份副本, PATH 靠前的旧副本可能遮蔽新版本!`);return}if(origin.kind==="source"){io.out(`注意: 当前运行在本地源码工作树 (${origin.packageRoot}), 通过 ${targetPm} 全局安装会产生独立全局副本, 请核对 PATH 优先级避免版本阴影!`);return}if(origin.kind==="local-project")io.out(`注意: 当前运行在项目本地依赖 (${origin.projectDir}), 通过 ${targetPm} 全局安装不会更新项目本地依赖, 且可能被本地副本遮蔽!`)}function resolveOrigin(meta,deps){let env=deps.env??process.env,pathExists=deps.pathExists??existsSync3,platform=deps.platform??process.platform,rawPaths=[meta.rawPackageRoot],entryArg=deps.argvEntry??process.argv[1];if(typeof entryArg==="string"&&entryArg!=="")rawPaths.push(entryArg);let firstPass=detectInstallOriginFromPath({packageRoot:meta.packageRoot,rawPaths,env,pathExists});if(!(firstPass.kind==="unknown"||firstPass.kind==="local-project"||firstPass.kind==="global"&&firstPass.reason===LIB_NODE_MODULES_HEURISTIC_REASON))return firstPass;if(meta.packageRoot.replaceAll("\\","/").toLowerCase().includes("/node_modules/")){let globalRoots=deps.probeRoots!==void 0?deps.probeRoots():probeGlobalRoots(platform,env,deps.spawnFn,{homeDir:deps.homeDir,readText:deps.readText,pathExists,isFile:deps.isFile});if(Object.keys(globalRoots).length>0)return detectInstallOriginFromPath({packageRoot:meta.packageRoot,rawPaths,env,pathExists,globalRoots})}return firstPass}function verifyPostUpgrade(input){let pkgText=(input.readText??defaultReadText3)(joinForPath(input.meta.packageRoot,"package.json")),unchangedAtOldRoot=!1;if(pkgText!==null)try{let parsed=JSON.parse(pkgText),afterVersion=typeof parsed.version==="string"?parsed.version:void 0;if(input.targetSpec!=="latest"&&compareSemver(input.meta.version,input.targetSpec)===-1&&afterVersion!==void 0&&afterVersion===input.meta.version)unchangedAtOldRoot=!0,input.io.out(`提示: 原安装目录 (${input.meta.packageRoot}) 的版本仍为 ${formatVersionLabel(afterVersion)}, 新版本可能安装到了其他位置, 请运行 ${input.binName} --version 核查。`)}catch{}let resolvedBin=resolveExecutableInPath(input.binName,input.platform,input.env,input.isFile);if(resolvedBin===null)return;let resolvedReal=safeRealpath(resolvedBin.path),oldGlobalPm=input.origin.kind==="global"&&input.origin.pm!==input.targetPm?input.origin.pm:null,isCrossGlobal=oldGlobalPm!==null,pointsToOldRoot=isWithinDir(resolvedReal,input.meta.packageRoot),pointsToOldPm=!1;if(oldGlobalPm!==null){let binOrigin=detectInstallOriginFromPath({packageRoot:resolvedReal,rawPaths:[resolvedBin.path],env:input.env,pathExists:()=>!1});pointsToOldPm=binOrigin.kind==="global"&&binOrigin.pm===oldGlobalPm}if(pointsToOldPm||pointsToOldRoot&&(isCrossGlobal||input.origin.kind==="source"||unchangedAtOldRoot))input.io.out(`提示: 当前 PATH 中的 ${input.binName} 仍指向旧路径 (${resolvedBin.path}), 可能遮蔽 ${input.targetPm} 新安装的版本, 请检查 PATH 优先级。`)}async function handleNonGlobalOrigin(ctx){let{meta,origin,hasExplicitRegistry,io,fetchVersion,registry}=ctx;if(io.out(`当前版本: ${meta.name}@${meta.version}`),io.out(`安装方式: ${describeOrigin(origin)}`),meta.isPrivate!==!0||hasExplicitRegistry){let remote=await fetchVersion(registry);if(remote.ok){let cmp=compareSemver(meta.version,remote.version),status;if(cmp===-1)status=`发现新版本 ${remote.version} (源: ${remote.registry})`;else if(cmp===null)status=`远端版本为 ${remote.version} (无法按 SemVer 比较, 源: ${remote.registry})`;else status=`远端最新版为 ${remote.version} (源: ${remote.registry})`;io.out(`版本检查: ${status}`)}else if(remote.code!=="not-found")io.out(`版本检查: 暂未获取远端版本 (${sanitize(remote.message)})`)}if(origin.kind==="source")return io.out("更新方式: 当前运行在本地源码工作树, 不通过包管理器覆盖。"),io.out(" 请在仓库根目录运行: git pull && bun install && bun run build"),io.out(" 若要通过包管理器安装全局发布版, 可显式指定 --pm <bun|npm|pnpm|yarn|volta>"),0;if(origin.kind==="ephemeral")return io.out(`更新方式: 当前经 ${origin.runner} 临时运行, 无需原地升级。`),io.out(` 下次获取最新版请运行: ${ephemeralHintCommand(origin.runner,meta.name)}`),io.out(" 若希望改为全局安装, 可运行带 --pm <bun|npm|pnpm|yarn|volta> 的 update 或直接全局安装"),0;return io.out(`更新方式: 当前作为项目本地依赖运行 (${origin.projectDir}), 为避免静默改写项目锁文件, 不自动覆盖。`),io.out(` 请在项目目录执行: ${localProjectHintCommand(origin.suggestedPm,meta.name)}`),0}function readPackageMeta(entryMetaUrl){let entryPath=fileURLToPath(entryMetaUrl),rawPackageRoot=dirname(dirname(entryPath)),packageRoot=safeRealpath(rawPackageRoot),pkgPath=join2(packageRoot,"package.json"),parsed=JSON.parse(readFileSync4(pkgPath,"utf8"));if(typeof parsed.name!=="string"||parsed.name==="")throw Error(`无法从 ${pkgPath} 读取合法包名`);let version=typeof parsed.version==="string"&&parsed.version!==""?parsed.version:"0.0.0";return{name:parsed.name,version,isPrivate:parsed.private===!0,rawPackageRoot,packageRoot}}function performUpgrade(ctx){let{binName,meta,origin,targetPm,targetSpec,opts,io,deps}=ctx,platform=deps.platform??process.platform,env=deps.env??process.env,yarnVersion=null;if(targetPm==="yarn")yarnVersion=deps.probeYarn!==void 0?deps.probeYarn():probeYarnVersion(platform,env,deps.spawnFn);let built=buildUpgradePlan({pm:targetPm,packageName:meta.name,targetSpec,explicitRegistry:opts.registry,platform,env,isFile:deps.isFile,yarnVersion});if(!built.ok){if(io.err(`无法自动更新: ${built.reason}`),built.fallbackCommand!==void 0)io.err(` 手动更新命令: ${built.fallbackCommand}`);return 1}io.out(`即将执行: ${built.plan.displayCommand}`);let result=(deps.execPlan??executeUpgradePlan)(built.plan,env,deps.spawnFn);if(result.error!==void 0)return io.err(`更新命令启动失败: ${sanitize(result.error.message)}`),io.err(` 手动更新命令: ${built.plan.displayCommand}`),1;if(result.signal!==void 0&&result.signal!==null)return io.err(`更新进程被信号中断 (${result.signal})`),io.err(` 手动更新命令: ${built.plan.displayCommand}`),1;if(result.status!==0){if(io.err(`更新失败 (${targetPm} 退出码 ${String(result.status??1)})`),platform==="win32")io.err(` Windows 提示: 当前正在运行的 ${binName} 自身可执行/shim 文件可能被系统锁定 (EBUSY / EPERM), 请退出当前命令并关闭其他占用终端后直接执行下方命令:`);if(targetPm==="pnpm")io.err(" pnpm 提示: 若提示未配置全局 bin 目录, 请检查 PNPM_HOME 环境变量或先运行 pnpm setup。");return io.err(` 手动更新命令: ${built.plan.displayCommand}`),1}return io.out(`已通过 ${targetPm} 更新 ${meta.name} 至 ${formatVersionLabel(targetSpec)} ✓`),verifyPostUpgrade({binName,meta,origin,targetPm,targetSpec,platform,env,readText:deps.readText,isFile:deps.isFile,io}),0}function handleFetchFailure(ctx){let{binName,meta,origin,targetPm,registry,remote,opts,io,deps}=ctx;if(opts.force&&!opts.check&&targetPm!==void 0)return io.err(`警示: 远端版本查询失败 (${sanitize(remote.message)})`),io.out(`强制重装模式 (--force): 跳过远端版本校验, 将直接通过 ${targetPm} 安装 ${meta.name}@latest`),performUpgrade({binName,meta,origin,targetPm,targetSpec:"latest",opts,io,deps});if(remote.code==="not-found")return io.err(`${meta.name} 尚未在 ${registry} 发布 (HTTP 404), 无法在线更新`+(meta.isPrivate?" (当前包标记为 private)":"")),io.err(" 若已发布到私有源, 请加 --registry <url> 后重试"),1;if(remote.code==="auth")io.err(`检查最新版本失败: ${sanitize(remote.message)}`),io.err(" 请先完成源登录或在 ~/.npmrc / ~/.bunfig.toml 配置同源访问 token, 或加 --force 直接委托包管理器安装");else io.err(`检查最新版本失败: ${sanitize(remote.message)}`);if(targetPm!==void 0){let cmd=formatUpgradeDisplayCommand(targetPm,meta.name,"latest",opts.registry);io.err(` 可稍后重试或手动执行: ${cmd}`)}return 1}async function runSelfUpdate(options){let io=options.io??{out:(line)=>process.stdout.write(`${line}
3
3
  `),err:(line)=>process.stderr.write(`${line}
4
4
  `)},deps=options.deps??{},parsed=parseUpdateArgs(options.argv);if(!parsed.ok)return io.err(`参数错误: ${parsed.message}`),1;let opts=parsed.options,meta;try{if(options.meta!==void 0)meta=options.meta;else if(options.entryMetaUrl!==void 0)meta=readPackageMeta(options.entryMetaUrl);else throw Error("缺少 entryMetaUrl 或 meta, 无法定位当前包信息")}catch(error){let msg=error instanceof Error?error.message:String(error);return io.err(`读取当前包信息失败: ${sanitize(msg)}`),1}if(opts.help){for(let line of formatUpdateHelp(options.binName,meta.name).split(`
@@ -7,7 +7,7 @@ import{readFileSync as readFileSync5}from"node:fs";import{lstat as lstat5,mkdir,
7
7
  `)){let match=/^(\d+)\t(.+)$/.exec(line);if(match===null)continue;let sizeKiB=match[1],path=match[2];if(sizeKiB===void 0||path===void 0)continue;if(sizes.has(path))duplicated=!0;sizes.set(path,Number(sizeKiB)*1024)}return{sizes,duplicated}}function assessDuOutput(stdout,safeTargets){let safeSet=new Set(safeTargets),parsed=parseDuSizes(stdout),unexpected=!1;for(let path of parsed.sizes.keys())if(!safeSet.has(path))unexpected=!0;let intact=!parsed.duplicated&&parsed.sizes.size<=safeTargets.length&&!unexpected;return{sizes:parsed.sizes,intact,duplicated:parsed.duplicated,unexpected}}function describeAnomaly(assessment){let shapes=[];if(assessment.duplicated)shapes.push("同一路径多行");if(assessment.unexpected)shapes.push("含输入之外的路径");if(shapes.length===0)shapes.push("行数与输入不符");return shapes.join(" / ")}async function measureDuBatches(bin,safeTargets,maxBatchBytes,signal){let sizes=new Map,failures=new Map,degraded=new Set,warnings=[];for(let batch of chunkTargetsByBytes(safeTargets,maxBatchBytes)){if(signal?.aborted)throw new SweepError("CANCELLED","体积统计在批量统计前被取消",{phase:"measure"});let run=await runDu(bin,batch);if(run.spawnError!==null||run.signal!==null){for(let target of batch)degraded.add(target);let errno=run.spawnError?.code,reason=run.spawnError!==null?`du 执行失败 (${run.spawnError.message})`:`du 被信号 ${run.signal} 中止`;warnings.push({code:"SIZE_DU_UNAVAILABLE",message:`${reason}: 本批 ${batch.length} 个目标的体积均未采信`,...typeof errno==="string"?{errno}:{}});continue}let{stdout,stderr}=run,batchSet=new Set(batch),assessment=assessDuOutput(stdout,batch);if(!assessment.intact){for(let target of batch)degraded.add(target);warnings.push({code:"SIZE_DU_OUTPUT_MISMATCH",message:`du 输出与输入集合不符 (${describeAnomaly(assessment)}): 本批 ${batch.length} 个目标的体积均未采信`})}else for(let[path,bytes]of assessment.sizes)sizes.set(path,bytes);for(let line of stderr.split(`
8
8
  `)){if(line.trim()==="")continue;let errorLine=parseDuErrorLine(line);if(errorLine===null){warnings.push({code:"SIZE_DU_LINE_UNATTRIBUTED",message:`体积统计失败 (未归因): ${line.replace(PROG_PREFIX_RE,"").trim()}`});continue}let failure=describeDuFailure(errorLine.detail);if(!batchSet.has(errorLine.path)){warnings.push({code:"SIZE_SUBPATH_FAILED",message:`体积统计失败 (${failure.reason}): ${errorLine.path}`,path:errorLine.path});continue}failures.set(errorLine.path,failure)}}for(let path of failures.keys())sizes.delete(path);return{sizes,failures,degraded,warnings}}function createDuSizer(bin=findDu(),maxBatchBytes=DU_BATCH_MAX_BYTES){return{name:"du",basis:"disk-usage",async measure(targets,options){if(options?.signal?.aborted)throw new SweepError("CANCELLED","体积统计在批量统计前被取消",{phase:"measure"});let sorted=[...new Set(targets)].sort(),emit=options?.onProgress;if(bin===null){let unmeasured=[],reason="du 候选不可用";for(let target of sorted){if(options?.signal?.aborted)throw new SweepError("CANCELLED","体积统计在逐目标检查点被取消",{phase:"measure"});unmeasured.push({target,code:"SIZE_UNMEASURED_OTHER",reason:"du 候选不可用"}),emit?.({kind:"unmeasured",target,code:"SIZE_UNMEASURED_OTHER",reason:"du 候选不可用"})}return{entries:[],basis:"disk-usage",warnings:[{code:"SIZE_DU_UNAVAILABLE",message:"du 候选不可用: /usr/bin/du 与 /bin/du 均不存在, 本候选跳过体积统计"}],unmeasured,gone:[]}}if(sorted.length===0)return{entries:[],basis:"disk-usage",warnings:[],unmeasured:[],gone:[]};let entries=[],unmeasured=[],gone=[],safeTargets=sorted.filter((target)=>!hasControlChar(target)),{sizes,failures,degraded,warnings}=safeTargets.length>0?await measureDuBatches(bin,safeTargets,maxBatchBytes,options?.signal):{sizes:new Map,failures:new Map,degraded:new Set,warnings:[]},pushUnmeasured=(target,code,reason)=>{unmeasured.push({target,code,reason}),emit?.({kind:"unmeasured",target,code,reason})};for(let target of sorted){if(options?.signal?.aborted)throw new SweepError("CANCELLED","体积统计在逐目标检查点被取消",{phase:"measure"});if(hasControlChar(target)){pushUnmeasured(target,"SIZE_UNMEASURED_CONTROL_CHAR","路径含控制字符");continue}if(degraded.has(target)){pushUnmeasured(target,"SIZE_UNMEASURED_UNPARSEABLE","输出不可解析");continue}let bytes=sizes.get(target);if(bytes!==void 0){entries.push({target,bytes}),emit?.({kind:"measured",target,bytes,basis:"disk-usage"});continue}let failure=failures.get(target);if(failure===void 0){pushUnmeasured(target,"SIZE_UNMEASURED_UNPARSEABLE","输出不可解析");continue}if(failure.missing){gone.push(target),warnings.push({code:"SIZE_TARGET_VANISHED",message:`体积统计失败 (不存在): ${target}`,path:target}),emit?.({kind:"gone",target});continue}pushUnmeasured(target,failure.code,failure.reason)}return{entries,basis:"disk-usage",warnings,unmeasured,gone}}}}import{lstat as lstat4,readdir as readdir2}from"node:fs/promises";import{join as join4}from"node:path";function describeFailure(code){switch(code){case"ENOENT":return{missing:!0,reason:"不存在"};case"EACCES":case"EPERM":return{missing:!1,code:"SIZE_UNMEASURED_PERMISSION",reason:"权限不足, 无法读取"};case"ENOTDIR":return{missing:!1,code:"SIZE_UNMEASURED_NOT_DIR",reason:"不是目录"};case"ELOOP":return{missing:!1,code:"SIZE_UNMEASURED_LOOP",reason:"符号链接层级过深"};default:return{missing:!1,code:"SIZE_UNMEASURED_OTHER",reason:code===void 0?"读取失败":`读取失败 (${code})`}}}function errorCode(error){return error?.code}var SIZE_CONCURRENCY=32;function pushSubpathWarning(warnings,path,error){let errno=errorCode(error);warnings.push({code:"SIZE_SUBPATH_FAILED",message:`体积统计失败 (${describeFailure(errno).reason}): ${path}`,path,...errno!==void 0?{errno}:{}})}function enqueueDirents(stack,dir,dirents){for(let dirent of dirents){if(dirent.isSymbolicLink())continue;let path=join4(dir,dirent.name);if(dirent.isDirectory())stack.push({kind:"dir",path});else if(dirent.isFile())stack.push({kind:"file",path})}}async function sumEntries(dirents,dir,warnings,signal){let stack=[];enqueueDirents(stack,dir,dirents);let total=0,active=0,failures=[],resolveDrained=null,drained=new Promise((resolve)=>{resolveDrained=resolve});function pump(){while(active<SIZE_CONCURRENCY&&stack.length>0&&failures.length===0&&!signal?.aborted){let item=stack.pop();active+=1,processItem(item)}let stopped=failures.length>0||signal?.aborted===!0;if(active===0&&(stack.length===0||stopped)&&resolveDrained!==null){let resolve=resolveDrained;resolveDrained=null,resolve()}}async function processItem(item){try{if(signal?.aborted)throw new SweepError("CANCELLED","体积统计在目录遍历检查点被取消",{phase:"measure"});if(item.kind==="dir"){try{let children=await readdir2(item.path,{withFileTypes:!0});enqueueDirents(stack,item.path,children)}catch(error){pushSubpathWarning(warnings,item.path,error)}return}try{let stats=await lstat4(item.path);if(stats.isFile())total+=stats.size}catch(error){pushSubpathWarning(warnings,item.path,error)}}catch(error){if(failures.length===0)failures.push(error)}finally{active-=1,pump()}}if(pump(),await drained,failures.length>0)throw failures[0];if(signal?.aborted)throw new SweepError("CANCELLED","体积统计在目录遍历检查点被取消",{phase:"measure"});return total}function createJsSizer(){return{name:"js",basis:"logical-bytes",async measure(targets,options){if(options?.signal?.aborted)throw new SweepError("CANCELLED","体积统计在逐目标检查点被取消",{phase:"measure"});let warnings=[],entries=[],unmeasured=[],gone=[],emit=options?.onProgress,pushUnmeasured=(target,code,reason)=>{unmeasured.push({target,code,reason}),emit?.({kind:"unmeasured",target,code,reason})};for(let target of[...new Set(targets)].sort()){if(options?.signal?.aborted)throw new SweepError("CANCELLED","体积统计在逐目标检查点被取消",{phase:"measure"});let dirents;try{if((await lstat4(target)).isSymbolicLink()){pushUnmeasured(target,"SIZE_UNMEASURED_NOT_DIR","不是目录");continue}dirents=await readdir2(target,{withFileTypes:!0})}catch(error){let failure=describeFailure(errorCode(error));if(failure.missing)gone.push(target),warnings.push({code:"SIZE_TARGET_VANISHED",message:`体积统计失败 (${failure.reason}): ${target}`,path:target}),emit?.({kind:"gone",target});else pushUnmeasured(target,failure.code,failure.reason);continue}let bytes=await sumEntries(dirents,target,warnings,options?.signal);entries.push({target,bytes}),emit?.({kind:"measured",target,bytes,basis:"logical-bytes"})}return{entries,basis:"logical-bytes",warnings,unmeasured,gone}}}}function createSizer(){let bin=findDu();return bin!==null?createDuSizer(bin):createJsSizer()}var invalidArgument=(field,message)=>new SweepError("INVALID_ARGUMENT",`${message} (字段: ${field})`,{field});function assertNameArray(value,field,required){if(value===void 0){if(required)throw invalidArgument(field,"为必填项");return}if(!Array.isArray(value)||value.some((item)=>typeof item!=="string"||item===""))throw invalidArgument(field,"必须是非空字符串数组");if(required&&value.length===0)throw invalidArgument(field,"不能为空数组")}var WIN32_ABS_ROOT_RE=/^(?:[A-Za-z]:[/\\]|[/\\]{2}[^/\\]+[/\\][^/\\]+)/;function isAbsoluteRoot(root,style){return style.name==="win32"?WIN32_ABS_ROOT_RE.test(root):style.ops.isAbsolute(root)}function assertShape(options){if(typeof options!=="object"||options===null)throw invalidArgument("options","构造选项必须是对象");assertNameArray(options.roots,"roots",!0);let style=options.style??nativeStyle();if(options.roots.some((root)=>!isAbsoluteRoot(root,style)))throw invalidArgument("roots","必须是绝对路径");if(assertNameArray(options.exclude,"exclude",!1),assertNameArray(options.include,"include",!1),options.home!==void 0&&options.home!==null&&(typeof options.home!=="string"||options.home===""))throw invalidArgument("home","必须是非空字符串或 null");if(options.policy!==void 0&&(typeof options.policy!=="object"||options.policy===null||typeof options.policy.releaseSuspects!=="boolean"))throw invalidArgument("policy","releaseSuspects 必须是布尔值")}function resolveOptions(options){return assertShape(options),Object.freeze({roots:Object.freeze([...options.roots]),exclude:Object.freeze(mergeNames(options.exclude??[...DEFAULT_EXCLUDE],[])),include:Object.freeze(mergeNames(options.include??[],[])),home:options.home===void 0?homedir6():options.home,style:options.style??nativeStyle(),policy:Object.freeze({releaseSuspects:options.policy?.releaseSuspects??!1})})}var cancelledAt=(phase)=>new SweepError("CANCELLED",`清理在 ${phase} 阶段被取消`,{phase});async function withPhase(phase,emit,signal,work){if(signal?.aborted)throw cancelledAt(phase);let startedAt=Date.now();emit?.({kind:"phase",phase,status:"start"});let value=await work();return emit?.({kind:"phase",phase,status:"done",elapsedMs:Date.now()-startedAt}),value}async function executePlan(resolved,options,signal){let emit=options?.onProgress,roots=[...resolved.roots],scanResult=await withPhase("scan",emit,signal,async()=>{let result=await createScanner().scan({roots:[...roots],exclude:[...resolved.exclude],include:[...resolved.include],signal,onProgress:(event)=>emit?.(event)});for(let warning of result.warnings)emit?.({kind:"warning",warning});return result}),targets=scanResult.hits.map((hit)=>hit.target),sizeResult=await withPhase("measure",emit,signal,async()=>{let result=await createSizer().measure(targets,{signal,onProgress:(event)=>{if(event.kind==="gone")return;emit?.(event)}});for(let warning of result.warnings)emit?.({kind:"warning",warning});return result}),classifications=await withPhase("classify",emit,signal,()=>scanResult.hits.map((hit)=>classifyTarget(hit.target,{home:resolved.home,style:resolved.style}))),crossDevice=await withPhase("device",emit,signal,async()=>crossDeviceIndex(await findCrossDeviceTargets(targets,{roots,style:resolved.style})));return withPhase("plan",emit,signal,()=>{let policy=resolved.policy,bytesOf=new Map(sizeResult.entries.map((entry)=>[entry.target,entry.bytes])),unmeasuredOf=new Map(sizeResult.unmeasured.map((item)=>[item.target,item])),goneSet=new Set(sizeResult.gone),prepared=[];for(let index=0;index<scanResult.hits.length;index+=1){let hit=scanResult.hits[index],classification=classifications[index];if(hit===void 0||classification===void 0)continue;if(goneSet.has(hit.target))continue;let bytes=bytesOf.get(hit.target);prepared.push({hit,classification,candidate:{target:hit.target,bytes,unmeasuredReason:bytes===void 0?unmeasuredOf.get(hit.target)?.reason:void 0,suspect:classification.kind==="suspect-install-tree"}})}let candidates=prepared.map((item)=>item.candidate),batch=deletionBatch(candidates,crossDevice,policy),book=collectSkips(candidates,crossDevice,policy),noteOf=new Map(book.entries.map((item)=>[item.target,item.note])),entries=[];for(let{hit,classification,candidate}of prepared){let reason=skipReasonOf(candidate,crossDevice,policy),deviceKind=crossDevice.get(hit.target),unmeasured=unmeasuredOf.get(hit.target);if(entries.push({target:hit.target,project:hit.project,root:hit.root,bytes:candidate.bytes,basis:candidate.bytes===void 0?void 0:sizeResult.basis,kind:classification.kind,kindReason:classification.reason,crossDevice:deviceKind,unmeasuredCode:unmeasured?.code,unmeasuredReason:unmeasured?.reason,inBatch:reason===null,skipReason:reason??void 0,skipNote:reason===null?void 0:noteOf.get(hit.target)}),reason!==null)emit?.({kind:"skipped",target:hit.target,reason})}return{roots:[...resolved.roots],exclude:[...resolved.exclude],include:[...resolved.include],policy:{releaseSuspects:policy.releaseSuspects},basis:entries.length>0?sizeResult.basis:void 0,entries,batch,skipped:[...book.entries],trailer:[...book.trailer],warnings:[...scanResult.warnings,...sizeResult.warnings],nameMatches:{exclude:scanResult.excludeMatches,include:scanResult.includeMatches}}})}function buildOutcomeEntries(plan,expectedSet,stale,rejected,mappings,removal){let staleSet=new Set(stale),rejectedMap;if(rejected.length>0){rejectedMap=new Map;for(let item of rejected)if(!rejectedMap.has(item.target))rejectedMap.set(item.target,item)}let realOf=new Map(mappings.map((item)=>[item.original,item.real])),removedSet=new Set(removal?.removed??[]),missingSet=new Set(removal?.missing??[]),failedMap=new Map((removal?.failed??[]).map((item)=>[item.target,item])),outcomeOf=(entry)=>{if(!entry.inBatch)return{kind:"skipped",reason:entry.skipReason};if(expectedSet!==void 0&&!expectedSet.has(entry.target))return{kind:"not-expected"};if(staleSet.has(entry.target))return{kind:"stale"};if(rejectedMap!==void 0){let rejection=rejectedMap.get(entry.target);return rejection!==void 0?{kind:"rejected",rejection}:{kind:"not-attempted",code:"BATCH_REJECTED"}}let realTarget=realOf.get(entry.target)??entry.target;if(removedSet.has(realTarget))return{kind:"removed"};if(missingSet.has(realTarget))return{kind:"missing"};let failure=failedMap.get(realTarget);if(failure!==void 0)return{kind:"failed",failure};return{kind:"not-attempted",code:removal.aborted.code}};return plan.entries.map((entry)=>({...entry,outcome:outcomeOf(entry)}))}async function executeRun(resolved,options,signal){let emit=options?.onProgress,startedAt=Date.now(),plan=await executePlan(resolved,options,signal),expected=options?.expectedBatch,expectedSet=expected===void 0?void 0:new Set(expected),face=expectedSet===void 0?plan.batch:plan.batch.filter((target)=>expectedSet.has(target)),liveSet=new Set(plan.batch),drift=expected===void 0||expectedSet===void 0?void 0:{added:plan.batch.filter((target)=>!expectedSet.has(target)),removed:expected.filter((target)=>!liveSet.has(target))},validation,removal,stale=[],rejected=[];if(face.length>0){let raw=await withPhase("validate",emit,signal,()=>validateTargets(face,{roots:[...resolved.roots],home:resolved.home,style:resolved.style,signal})),split=splitStaleRejections(raw.rejected,options?.staleTargets);if(stale=split.stale,rejected=split.rejected,validation={accepted:raw.accepted,rejected,mappings:raw.mappings},rejected.length===0)removal=await withPhase("remove",emit,signal,async()=>removeTargets(raw.accepted,{roots:await toTrustRoots([...resolved.roots]),style:resolved.style,signal,onProgress:(event)=>{if(event.kind==="removed"||event.kind==="missing"){emit?.({kind:"removed",target:event.target,outcome:event.kind});return}emit?.(event)}}))}let status;if(face.length===0)status="nothing-to-do";else if(rejected.length>0)status="rejected";else status="executed";let entries=buildOutcomeEntries(plan,expectedSet,stale,rejected,validation?.mappings??[],removal),releasedBytes=entries.reduce((sum,entry)=>isSuccessOutcome(entry.outcome)?sum+(entry.bytes??0):sum,0),report={status,plan,validation,removal,entries,stale,releasedBytes,drift};return emit?.({kind:"done",status,elapsedMs:Date.now()-startedAt}),report}function createSweeper(options){let resolved=resolveOptions(options);return{options:resolved,async plan(planOptions){let startedAt=Date.now(),plan=await executePlan(resolved,planOptions,planOptions?.signal);return planOptions?.onProgress?.({kind:"plan-done",plan,elapsedMs:Date.now()-startedAt}),plan},run(runOptions){return executeRun(resolved,runOptions,runOptions?.signal)}}}var VALUE_FLAGS=new Set(["--exclude","--include","--config"]);function applyValueFlag(options,flag,value){if(flag==="--exclude")return options.exclude.push(value),null;if(flag==="--include")return options.include.push(value),null;if(options.config!==void 0)return"参数 --config 不能重复指定";return options.config=value,null}function splitEqualsFlag(arg){let eqIndex=arg.indexOf("=");if(eqIndex<=0)return null;let flag=arg.slice(0,eqIndex);if(!VALUE_FLAGS.has(flag))return null;return{flag,value:arg.slice(eqIndex+1)}}function parseArgs(argv){if(argv[0]==="update")return{ok:!0,options:{command:"update",yes:!1,force:!1,exclude:[],include:[],updateArgs:argv.slice(1),help:!1,version:!1}};let options={command:"sweep",yes:!1,force:!1,exclude:[],include:[],help:!1,version:!1},positionals=[];for(let index=0;index<argv.length;index+=1){let arg=argv[index];if(arg===void 0)continue;if(arg==="--yes"){options.yes=!0;continue}if(arg==="--force"){options.force=!0;continue}if(arg==="--help"||arg==="-h"){options.help=!0;continue}if(arg==="--version"||arg==="-V"){options.version=!0;continue}if(VALUE_FLAGS.has(arg)){let value=argv[index+1];if(value===void 0||value===""||value.startsWith("-"))return{ok:!1,message:`参数 ${arg} 缺少取值`};let err=applyValueFlag(options,arg,value);if(err!==null)return{ok:!1,message:err};index+=1;continue}let eq=splitEqualsFlag(arg);if(eq!==null){if(eq.value==="")return{ok:!1,message:`参数 ${eq.flag} 缺少取值`};let err=applyValueFlag(options,eq.flag,eq.value);if(err!==null)return{ok:!1,message:err};continue}if(arg.startsWith("-"))return{ok:!1,message:`未知参数: ${arg}`};positionals.push(arg)}let[only]=positionals;if(positionals.includes("update"))return{ok:!1,message:"子命令 update 必须位于参数首位 (用法: sweep-nm update [选项])"};if(positionals.length>1||only!==void 0&&only!=="init"&&only!=="config")return{ok:!1,message:`未知参数: ${positionals.join(" ")}`};if(only==="init"||only==="config"){options.command=only;let disallowed=[];if(options.yes)disallowed.push("--yes");if(options.force)disallowed.push("--force");if(options.exclude.length>0)disallowed.push("--exclude");if(options.include.length>0)disallowed.push("--include");if(disallowed.length>0)return{ok:!1,message:`子命令 ${options.command} 不支持参数: ${disallowed.join(", ")}`}}return{ok:!0,options}}var BANNER="SWEEP-NM",BAR_BLOCK="▍",TOTAL_BLOCK="█",NEUTRAL_BLOCK="░",PLATFORM_STYLE=nativeStyle(),NEUTRAL_TIER={block:NEUTRAL_BLOCK,sgr:"2"},ROOT_LIST_LIMIT=3,bannerLine=(suffix,color)=>paint(`${BAR_BLOCK} ${BANNER} ${suffix}`,"1;7",color),neutralLine=(text,color)=>` ${paint(`${NEUTRAL_BLOCK} ${text}`,"2",color)}`,TIER_BIG=536870912,TIER_MID=104857600;function render(options){let{mode,roots,entries,color,home,releasedBytes,pathStyle}=options,style=pathStyle??PLATFORM_STYLE,scope=roots.length>0&&roots.length<=ROOT_LIST_LIMIT?`${roots.length} 个根: ${roots.map((root)=>sanitizeLine(shortenPath(root,style,home))).join(" · ")}`:`${roots.length} 个根`,runtime=options.runtime?` · ${sanitizeLine(options.runtime)}`:"",head=bannerLine(`${mode==="execute"?"执行":"预览"} · ${scope}${runtime}`,color),notes=(options.notes??[]).map((note)=>neutralLine(sanitizeLine(note),color)),trailer=(options.trailer??[]).map((line)=>neutralLine(sanitizeLine(line),color));if(entries.length===0)return[head,...notes,` ${paint(`${NEUTRAL_BLOCK} 未发现 node_modules`,"2",color)}`,...trailer].join(`
9
9
  `);let rows=[...entries].sort((a,b)=>(b.bytes??-1)-(a.bytes??-1)),volumeWidth=rows.reduce((max,row)=>Math.max(max,displayWidth(volumeOf(row))),0),nameWidth=rows.reduce((max,row)=>Math.max(max,displayWidth(sanitizeLine(row.project))),0),body=rows.map((row)=>{let fail=mode==="execute"&&row.ok===!1,tier=row.bytes===void 0?NEUTRAL_TIER:tierOf(row.bytes),mark=mode==="execute"?paint(fail?"✗":"✓",fail?"31":"32",color):paint(tier.block,tier.sgr,color),volume=padStart(volumeOf(row),volumeWidth),name=sanitizeLine(row.project),rawPath=displayPath(row.target,style,home,row.suspect===!0),path=sanitizeLine(rawPath),rewritten=name!==row.project||path!==rawPath,tail=tailsOf(row,fail,rewritten),shown=`${paint(padEnd(name,nameWidth),"1",color)} ${paint(path,"2",color)}`;return` ${mark} ${volume} ${shown}${tail?` ${paint(tail,"2",color)}`:""}`}),hint=[paint("加","2",color),paint("--yes","1",color),paint("执行删除","2",color)].join(" "),foot=mode==="execute"?footExecute(rows,color,releasedBytes):` ${paint(TOTAL_BLOCK,"7",color)} ${paint(`合计 ${rows.length} 处 · ${formatBytes(sum(rows))}`,"1",color)} ${hint}`;return[head,...notes,...body,foot,...trailer].join(`
10
- `)}function footExecute(rows,color,releasedBytes){let failed=rows.filter((row)=>row.ok===!1).length,released=releasedBytes===void 0?"":` · 释放 ${formatBytes(releasedBytes)}`;return` ${paint(TOTAL_BLOCK,"7",color)} ${paint(`汇总 成功 ${rows.length-failed} 处${released} · 失败 ${failed} 处`,"1",color)}`}var volumeOf=(row)=>row.bytes===void 0?"?":formatBytes(row.bytes),SANITIZED_NOTE="名字已净化显示";function tailsOf(row,fail,rewritten){let parts=[];if(rewritten)parts.push(SANITIZED_NOTE);if(row.note)parts.push(sanitizeLine(row.note));if(fail&&row.error)parts.push(sanitizeLine(row.error));return parts.join(" ")}function tierOf(bytes){if(bytes>=TIER_BIG)return{block:"█",sgr:"31"};if(bytes>=TIER_MID)return{block:"▓",sgr:"33"};return{block:"▒",sgr:"36"}}var paint=(text,sgr,color)=>color?`\x1B[${sgr}m${text}\x1B[0m`:text,sum=(rows)=>rows.reduce((total,row)=>total+(row.bytes??0),0),fold3=(text,style)=>style.caseInsensitive?text.toLowerCase():text;function shortenPath(path,style,home){if(!home)return path;let sep=style.ops.sep,fsRoot=style.ops.parse(home).root,normalizedHome=home;while(normalizedHome.length>fsRoot.length&&normalizedHome.endsWith(sep))normalizedHome=normalizedHome.slice(0,-sep.length);if(fold3(path,style)===fold3(normalizedHome,style))return"~";let prefix=normalizedHome.endsWith(sep)?normalizedHome:`${normalizedHome}${sep}`;return fold3(path,style).startsWith(fold3(prefix,style))?`~${sep}${path.slice(prefix.length)}`:path}function shortenHome(path,home,style=PLATFORM_STYLE){return shortenPath(path,style,home)}function displayPath(target,style,home,keepSuffix=!1){let suffix=`${style.ops.sep}node_modules`,dir=target;if(!keepSuffix&&fold3(target,style).endsWith(fold3(suffix,style))){let stripped=target.slice(0,-suffix.length);dir=stripped===""?style.ops.sep:stripped}return shortenPath(dir,style,home)}var padEnd=(text,width)=>text+" ".repeat(Math.max(0,width-displayWidth(text))),padStart=(text,width)=>" ".repeat(Math.max(0,width-displayWidth(text)))+text,ZERO_WIDTH_MARK_RE=/[\p{Mn}\p{Me}]/u;function displayWidth(text){let width=0;for(let char of text){let code=char.codePointAt(0)??0;if(code===8205||code===65038||code===65039||ZERO_WIDTH_MARK_RE.test(char))continue;width+=isFullWidth(code)?2:1}return width}function isFullWidth(code){return code>=4352&&code<=4447||code>=11904&&code<=42191||code>=44032&&code<=55203||code>=63744&&code<=64255||code>=65072&&code<=65135||code>=65280&&code<=65376||code>=65504&&code<=65510||code>=127744&&code<=128591||code>=128640&&code<=128767||code>=129280&&code<=129791||code>=131072&&code<=262141}var COMMANDS=[["sweep-nm","预览: 清单 + 体积 + 合计, 零副作用"],["sweep-nm --yes","执行删除"],["sweep-nm --force","连同疑似安装树一并删除 (默认跳过)"],["sweep-nm --exclude <name>","临时追加排除 (可重复, 与配置合并)"],["sweep-nm --include <name>","只清理命中名单的目录 (可重复, 与配置合并)"],["sweep-nm --config <path>","指定配置文件 (优先于 SWEEP_NM_CONFIG)"],["sweep-nm config","查看实际生效的配置: 来源 + 路径 + 文件状态"],["sweep-nm init","初始化向导: 交互生成配置文件"],["sweep-nm update","自更新: 自动识别安装器升级到最新版 (--check 仅检查)"],["sweep-nm --version","显示版本号"],["sweep-nm -V","--version 的别名"],["sweep-nm --help","帮助"],["sweep-nm -h","--help 的别名"]],COMMAND_COLUMN=COMMANDS.reduce((max,[command])=>Math.max(max,command.length),0);function defaultConfigPath(){return resolveConfigPath({env:{}}).path}function helpText(color){let rows=COMMANDS.map(([command,desc])=>` ${command.padEnd(COMMAND_COLUMN)} ${desc}`);return[bannerLine("工作区 node_modules 清理",color),"",...rows,"","说明:"," --exclude 按目录名精确匹配 (区分大小写), 从根到命中点的任意一级命中即跳过"," --include 同款匹配口径, 命中才纳入; 同时命中 exclude 的照旧跳过"," 配置未写 exclude 字段时使用内置默认名单 (包管理器 / 版本管理器 / 编辑器扩展等安装树目录)"," --force 只放行「疑似安装树」(安装树形态的目标), 不放宽删除安全闸"," 删除侧要求扫描根为真实路径 (根及其祖先链不含符号链接): 命中 (如 /tmp、/var 形态) 则 --yes 整批拒绝, 改写为真实路径形态 (如 /private/tmp/x) 即放行"," 设置 NO_COLOR (任意非空值) 或非 TTY 输出时自动降级为无颜色纯文本",` 默认配置位置 (平台自适应; 用了 --config 或 SWEEP_NM_CONFIG 时实际读的不是它): ${sanitizeLine(defaultConfigPath())}`," 查实际生效的路径: sweep-nm config","","退出码: 0 成功 (含预览、空结果、config、update 与 --help); 1 删除失败、跳过、整批拒绝或中止 / 无配置 --yes / 配置损坏 / 参数错误"].join(`
10
+ `)}function footExecute(rows,color,releasedBytes){let failed=rows.filter((row)=>row.ok===!1).length,released=releasedBytes===void 0?"":` · 释放 ${formatBytes(releasedBytes)}`;return` ${paint(TOTAL_BLOCK,"7",color)} ${paint(`汇总 成功 ${rows.length-failed} 处${released} · 失败 ${failed} 处`,"1",color)}`}var volumeOf=(row)=>row.bytes===void 0?"?":formatBytes(row.bytes),SANITIZED_NOTE="名字已净化显示";function tailsOf(row,fail,rewritten){let parts=[];if(rewritten)parts.push(SANITIZED_NOTE);if(row.note)parts.push(sanitizeLine(row.note));if(fail&&row.error)parts.push(sanitizeLine(row.error));return parts.join(" ")}function tierOf(bytes){if(bytes>=TIER_BIG)return{block:"█",sgr:"31"};if(bytes>=TIER_MID)return{block:"▓",sgr:"33"};return{block:"▒",sgr:"36"}}var paint=(text,sgr,color)=>color?`\x1B[${sgr}m${text}\x1B[0m`:text,sum=(rows)=>rows.reduce((total,row)=>total+(row.bytes??0),0),fold3=(text,style)=>style.caseInsensitive?text.toLowerCase():text;function shortenPath(path,style,home){if(!home)return path;let sep=style.ops.sep,fsRoot=style.ops.parse(home).root,normalizedHome=home;while(normalizedHome.length>fsRoot.length&&normalizedHome.endsWith(sep))normalizedHome=normalizedHome.slice(0,-sep.length);if(fold3(path,style)===fold3(normalizedHome,style))return"~";let prefix=normalizedHome.endsWith(sep)?normalizedHome:`${normalizedHome}${sep}`;return fold3(path,style).startsWith(fold3(prefix,style))?`~${sep}${path.slice(prefix.length)}`:path}function shortenHome(path,home,style=PLATFORM_STYLE){return shortenPath(path,style,home)}function displayPath(target,style,home,keepSuffix=!1){let suffix=`${style.ops.sep}node_modules`,dir=target;if(!keepSuffix&&fold3(target,style).endsWith(fold3(suffix,style))){let stripped=target.slice(0,-suffix.length);dir=stripped===""?style.ops.sep:stripped}return shortenPath(dir,style,home)}var padEnd=(text,width)=>text+" ".repeat(Math.max(0,width-displayWidth(text))),padStart=(text,width)=>" ".repeat(Math.max(0,width-displayWidth(text)))+text,ZERO_WIDTH_MARK_RE=/[\p{Mn}\p{Me}]/u;function displayWidth(text){let width=0;for(let char of text){let code=char.codePointAt(0)??0;if(code===8205||code===65038||code===65039||ZERO_WIDTH_MARK_RE.test(char))continue;width+=isFullWidth(code)?2:1}return width}function isFullWidth(code){return code>=4352&&code<=4447||code>=11904&&code<=42191||code>=44032&&code<=55203||code>=63744&&code<=64255||code>=65072&&code<=65135||code>=65280&&code<=65376||code>=65504&&code<=65510||code>=127744&&code<=128591||code>=128640&&code<=128767||code>=129280&&code<=129791||code>=131072&&code<=262141}var WHITE=["255;255;255","255"],DARK_PALETTE={primary:["245;245;247","255"],secondary:["161;161;166","248"],tertiary:["110;110;115","242"],separator:["56;56;58","238"],blue:["10;132;255","39"],cyan:["100;210;255","81"],green:["48;209;88","42"],red:["255;69;58","203"]},LIGHT_PALETTE={primary:["29;29;31","234"],secondary:["110;110;115","242"],tertiary:["142;142;147","246"],separator:["210;210;215","252"],blue:["0;122;255","27"],cyan:["0;102;204","26"],green:["40;167;69","34"],red:["215;0;21","160"]},TRUECOLOR_TERMS=["iterm","vscode","ghostty","warp","wezterm"];function supportsTrueColor(){if(process.env.WT_SESSION)return!0;let ct=(process.env.COLORTERM??"").toLowerCase();if(ct.includes("truecolor")||ct.includes("24bit"))return!0;let termProg=(process.env.TERM_PROGRAM??"").toLowerCase();return TRUECOLOR_TERMS.some((term)=>termProg.includes(term))}function isLightTerminal(){let fgbg=process.env.COLORFGBG;if(!fgbg)return!1;let parts=fgbg.split(";"),bg=Number(parts[parts.length-1]);return Number.isFinite(bg)&&bg>=7&&bg!==8}function createStyler(color){let theme=isLightTerminal()?LIGHT_PALETTE:DARK_PALETTE,trueColor=color&&supportsTrueColor(),fg=(tok,text,bold=!1)=>{if(!color)return text;let b=bold?"1;":"";return trueColor?`\x1B[${b}38;2;${tok[0]}m${text}\x1B[0m`:`\x1B[${b}38;5;${tok[1]}m${text}\x1B[0m`};return{badge:(text)=>{let label=` ${text} `;if(!color)return label;return trueColor?`\x1B[1;38;2;${WHITE[0]};48;2;${theme.blue[0]}m${label}\x1B[0m`:`\x1B[1;38;5;${WHITE[1]};48;5;${theme.blue[1]}m${label}\x1B[0m`},title:(t)=>fg(theme.primary,t,!0),primary:(t)=>fg(theme.primary,t,!1),muted:(t)=>fg(theme.secondary,t,!1),dim:(t)=>fg(theme.tertiary,t,!1),rule:(t)=>fg(theme.separator,t,!1),section:(t)=>fg(theme.blue,t,!0),token:(t)=>fg(theme.cyan,t,!1),green:(t)=>fg(theme.green,t,!0),red:(t)=>fg(theme.red,t,!0)}}var SUBCOMMANDS=[{name:"init",desc:"交互式向导, 生成配置文件"},{name:"config",desc:"查看实际生效的配置 (来源 / 路径 / 状态)"},{name:"update",desc:"自动识别安装器升级到最新版 (--check 仅检查)"}],ACTION_OPTIONS=[{flag:"--yes",desc:"执行删除 (默认仅预览, 零副作用)"},{flag:"--force",desc:"连同疑似安装树一并删除 (默认跳过)"},{flag:"--exclude",arg:"<name>",desc:"按目录名临时追加排除 (可重复, 与配置合并)"},{flag:"--include",arg:"<name>",desc:"仅清理命中目录名的项目 (可重复, 与配置合并)"},{flag:"--config",arg:"<path>",desc:"指定配置文件路径 (优先于 SWEEP_NM_CONFIG)"}],META_OPTIONS=[{flag:"-V, --version",desc:"显示当前版本号"},{flag:"-h, --help",desc:"显示本帮助"}],EXAMPLES=[{cmd:"sweep-nm",desc:"预览所有工作区的 node_modules"},{cmd:"sweep-nm",flag:"--yes",desc:"确认清单后执行删除"},{cmd:"sweep-nm",flag:"--exclude",arg:"my-kits",desc:"临时排除指定目录"}],LEFT_COL=20,EXAMPLE_COL=28,RULE_WIDTH=76;function defaultConfigPath(){return resolveConfigPath({env:{}}).path}function formatOptionRow(row,s){let plain=row.arg===void 0?row.flag:`${row.flag} ${row.arg}`,pad=" ".repeat(Math.max(2,LEFT_COL-plain.length));return` ${row.arg===void 0?s.token(row.flag):`${s.token(row.flag)} ${s.dim(row.arg)}`}${pad}${s.muted(row.desc)}`}function formatExampleRow(row,s){let plain=[row.cmd,row.flag,row.arg].filter((part)=>part!==void 0).join(" "),pad=" ".repeat(Math.max(2,EXAMPLE_COL-plain.length)),styledParts=[s.primary(row.cmd)];if(row.flag!==void 0)styledParts.push(s.token(row.flag));if(row.arg!==void 0)styledParts.push(s.dim(row.arg));return` ${styledParts.join(" ")}${pad}${s.muted(row.desc)}`}function helpText(color){let s=createStyler(color),configPath=sanitizeLine(defaultConfigPath()),commandRows=SUBCOMMANDS.map((row)=>{let pad=" ".repeat(Math.max(2,LEFT_COL-row.name.length));return` ${s.title(row.name)}${pad}${s.muted(row.desc)}`}),actionRows=ACTION_OPTIONS.map((row)=>formatOptionRow(row,s)),metaRows=META_OPTIONS.map((row)=>formatOptionRow(row,s)),exampleRows=EXAMPLES.map((row)=>formatExampleRow(row,s));return["",` ${s.badge("SWEEP-NM")} ${s.title("工作区 node_modules 清理")}`,` ${s.muted("扫描多工作区根目录下的 node_modules, 先预览体积, 确认后批量清理。")}`,` ${s.rule("─".repeat(RULE_WIDTH))}`,"",` ${s.section("用法")}`,` ${s.title("sweep-nm")} ${s.dim("[选项]")}`,` ${s.title("sweep-nm")} ${s.dim("<子命令> [选项]")}`,"",` ${s.section("子命令")}`,...commandRows,"",` ${s.section("选项")}`,...actionRows,"",...metaRows,"",` ${s.section("示例")}`,...exampleRows,"",` ${s.section("配置与安全")}`,` ${s.primary("默认配置")} ${s.token(configPath)}`,` ${s.dim("仅平台默认; 用了 --config / SWEEP_NM_CONFIG 请跑 sweep-nm config")}`,` ${s.primary("名单口径")} ${s.muted("--exclude / --include 按目录名精确匹配 (区分大小写, 任一级命中)")}`,` ${s.muted("同时命中 exclude 优先; 省略 exclude 启用内置安装树默认名单")}`,` ${s.primary("删除安全")} ${s.muted("--force 仅放行疑似安装树, 不放宽安全闸; 根及祖先链须为真实路径")}`,` ${s.muted("命中 /tmp、/var 软链时 --yes 整批拒绝, 改如 /private/tmp/x 即放行")}`,` ${s.primary("输出降级")} ${s.muted("设置 NO_COLOR、TERM=dumb 或非 TTY 时自动降级为无颜色纯文本")}`,"",` ${s.section("退出码")}`,` ${s.green("0")} ${s.muted("成功 (预览、空结果、config、update、--version、--help)")}`,` ${s.red("1")} ${s.muted("失败 (删除失败 / 跳过 / 拒绝中止 / 无配置 --yes / 配置或参数错误)")}`,""].join(`
11
11
  `)}import{homedir as homedir7}from"node:os";import{join as join5,resolve}from"node:path";import{createInterface}from"node:readline/promises";var WHITESPACE=/\s/;function expandHome(token,home){if(token==="~")return home;if(token.startsWith("~/")||token.startsWith("~\\"))return join5(home,token.slice(2));return token}function splitAnswer(answer){let items=[],current="",openQuote=null;for(let index=0;index<answer.length;index+=1){let char=answer[index];if(openQuote!==null){if(char===openQuote){openQuote=null;continue}current+=char;continue}if(char==='"'||char==="'"){if(answer.indexOf(char,index+1)!==-1){openQuote=char;continue}current+=char;continue}if(char===","||char===","||WHITESPACE.test(char)){if(current.length>0)items.push(current);current="";continue}current+=char}if(current.length>0)items.push(current);return items}function parsePathList(answer,fallback,home=homedir7()){if(answer===null)return[...fallback];let items=[...new Set(splitAnswer(answer).map((token)=>resolve(expandHome(token,home))))];return items.length>0?items:[...fallback]}function parseNameList(answer,fallback){if(answer===null)return[...fallback];let items=splitAnswer(answer);return items.length>0?items:[...fallback]}var hasPathSeparator=(name)=>name.includes("/")||name.includes("\\");async function checkRoots(roots,deps){let missing=[],notDir=[],symlinked=[];for(let root of roots){if(deps.rootExists!==void 0&&!await deps.rootExists(root)){missing.push(root);continue}let link=await deps.firstSymlinkOnRoot(root);if(link!==null){symlinked.push({root,link});continue}if(!await deps.rootIsDirectory(root))if(deps.rootExists!==void 0)notDir.push(root);else missing.push(root)}return{missing,notDir,symlinked}}async function runInit(deps){let{configPath,configExists,firstSymlinkOnTarget,writeFile,io}=deps,{color}=io,home=deps.home??homedir7();function cancelled(){return io.print("已取消, 未写入配置"),{state:"cancelled"}}async function checkConfigTarget(){if(deps.configIsDirectory!==void 0&&await deps.configIsDirectory(configPath))return io.print(` ${paint("✗","31",color)} 配置路径是既有目录, 无法写入文件: ${sanitizeLine(configPath)}; 请用 --config 指定文件路径或先移走该目录`),!1;let link=await firstSymlinkOnTarget(configPath);if(link!==null)return io.print(` ${paint("✗","31",color)} 配置路径锚点链上有符号链接: ${sanitizeLine(link)} (配置: ${sanitizeLine(configPath)}); 写入会跟随符号链接改写其目标, 改写为不含符号链接的形态 (macOS 上如 /tmp/x 写成 /private/tmp/x)`),!1;return!0}try{if(io.print(bannerLine("初始化向导",color)),!await checkConfigTarget())return cancelled();if(await configExists(configPath)){if(!await io.confirm(`配置已存在 (${sanitizeLine(configPath)}), 是否覆盖?`,!1))return{state:"declined-overwrite"}}io.print(neutralLine("首次使用, 先确定扫描范围",color));let roots=[];for(;;){let rootsAnswer=await io.ask("扫描根 (逗号或空白分隔多个)",`默认: ${sanitizeLine(shortenHome(home,home))}`);if(rootsAnswer===null)return cancelled();roots=parsePathList(rootsAnswer,[home],home);let{missing,notDir,symlinked}=await checkRoots(roots,deps);if(missing.length===0&&notDir.length===0&&symlinked.length===0)break;for(let path of missing)io.print(` ${paint("✗","31",color)} 根不存在: ${sanitizeLine(path)}`);for(let path of notDir)io.print(` ${paint("✗","31",color)} 根不是目录: ${sanitizeLine(path)}`);for(let item of symlinked)io.print(` ${paint("✗","31",color)} 根锚点链上有符号链接: ${sanitizeLine(item.link)} (根: ${sanitizeLine(item.root)}); 删除侧要求真实路径, 改写为不含符号链接的形态 (macOS 上如 /tmp/x 写成 /private/tmp/x)`)}let excludeAnswer=await io.ask("排除名单 (目录名)",`回车采用默认名单 (${DEFAULT_EXCLUDE.length} 条)`);if(excludeAnswer===null)return cancelled();let exclude=parseNameList(excludeAnswer,[...DEFAULT_EXCLUDE]);for(let bad of exclude.filter(hasPathSeparator))io.print(` ${paint("!","33",color)} 排除名含路径分隔符, 不会命中任何目录 (请填写单级目录名): ${sanitizeLine(bad)}`);let includeAnswer=await io.ask("包含名单 (目录名, 可留空)","回车跳过");if(includeAnswer===null)return cancelled();let include=parseNameList(includeAnswer,[]);for(let bad of include.filter(hasPathSeparator))io.print(` ${paint("!","33",color)} 包含名含路径分隔符, 不会命中任何目录 (请填写单级目录名): ${sanitizeLine(bad)}`);io.print(neutralLine(`将写入 ${roots.length} 个扫描根 · 排除 ${exclude.length} 条 · 包含 ${include.length} 条`,color));let confirmDefault=!0;for(;;){if(!await io.confirm("确认写入?",confirmDefault))return cancelled();if(await checkConfigTarget())break;confirmDefault=!1}let config={roots,exclude,include},text=`${JSON.stringify(config,null,2)}
12
12
  `;return await writeFile(configPath,text),io.print(` 配置已写入: ${sanitizeLine(shortenHome(configPath,home))} ${paint("✓","32",color)}`),io.print(""),io.print(text.trimEnd().split(`
13
13
  `).map((line)=>` ${line}`).join(`
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "commit": "ef6a77921ac909467b7e743f28976426255b2fd3",
3
+ "commit": "f48bd174289d2bb717d8f57810f0134a106ee7a2",
4
4
  "dirty": false,
5
- "cliSha256": "54f216720e26e956cadf8a4a9aa6ec993a2112b36c3956620404a75924c71de4",
6
- "builtAt": "2026-11-20T04:01:18.867Z"
5
+ "cliSha256": "37658c7b5f6e116d4305f14c4432911cc235691cfd4b14b6bca6d6ab1b9cb5a6",
6
+ "builtAt": "2026-11-20T04:38:01.958Z"
7
7
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@iyowei/sweep-node-modules-cli",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "CLI to find and delete node_modules across projects: scan multiple workspace roots (monorepo friendly), bulk-remove them to free up disk space, preview first and delete after confirmation. 工作区级 node_modules 批量清理工具。",
5
5
  "keywords": [
6
6
  "cli",
@@ -59,7 +59,7 @@
59
59
  },
60
60
  "devDependencies": {
61
61
  "@iyowei/cli-updater": "1.0.0",
62
- "@iyowei/sweep-node-modules": "1.0.0"
62
+ "@iyowei/sweep-node-modules": "1.1.0"
63
63
  },
64
64
  "scripts": {
65
65
  "build": "bun build src/cli.ts --target=node --minify-whitespace --minify-syntax --outfile=dist/cli.js && bun scripts/write-dist-manifest.ts",