@wwkit/shared 1.0.23 → 1.0.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/shared",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "author": "bluesliu <langcai163@163.com>",
   "description": "Shared utilities for @wwkit packages — config loader, platform detection",
   "type": "module",

package/src/args.js

@@ -0,0 +1,79 @@
+/**
+ * 共享命令行参数解析器 — @wwkit/shared 统一参数解析
+ *
+ * 支持以下格式的参数：
+ *   --flag value        长标志（空格分隔）
+ *   --flag=value        长标志（等号形式）
+ *   -f value           短标志（空格分隔）
+ *   -f=value           短标志（等号形式）
+ *   positional         位置参数（不以 - 开头）
+ *
+ * 布尔标志（见 DEFAULT_BOOLEAN_FLAGS 与 opts.booleans）不消费下一个参数：
+ *   --json、-g、-y 等后跟普通 token 时，token 保持为位置参数/值参数，
+ *   避免 `opm npm install -g typescript` 将 typescript 吞为 -g 的值。
+ * 上下文相关的布尔标志（如 proc 的 -f/--force）由
+ * 调用方通过 opts.booleans 声明。
+ *
+ * @param {string[]} argv - 原始参数数组
+ * @param {{ booleans?: string[] }} [opts] - 上下文布尔标志名（不含 -/-- 前缀）
+ * @returns {{ flags: Record<string, string>, positional: string[] }}
+ */
+export const DEFAULT_BOOLEAN_FLAGS = new Set([
+  'h', 'help',
+  'g', 'global',
+  'y', 'yes',
+  'a', 'all',
+  'j', 'json',
+  'exact',
+  'dry-run',
+  'backup',
+  'delete',
+])
+
+export function parseFlags(argv, opts = {}) {
+  const booleans = new Set([...DEFAULT_BOOLEAN_FLAGS, ...(opts.booleans || [])])
+  const flags = {}
+  const positional = []
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i]
+
+    if (arg.startsWith('--') && arg.includes('=')) {
+      const idx = arg.indexOf('=')
+      flags[arg.slice(2, idx)] = arg.slice(idx + 1)
+    } else if (arg.startsWith('--')) {
+      const name = arg.slice(2)
+      if (booleans.has(name)) {
+        flags[name] = 'true'
+      } else {
+        const next = argv[i + 1]
+        if (next !== undefined && !next.startsWith('-')) {
+          flags[name] = next
+          i++
+        } else {
+          flags[name] = 'true'
+        }
+      }
+    } else if (arg.startsWith('-') && arg.includes('=')) {
+      const idx = arg.indexOf('=')
+      flags[arg.slice(1, idx)] = arg.slice(idx + 1)
+    } else if (arg.startsWith('-') && arg.length > 1) {
+      const name = arg.slice(1)
+      if (booleans.has(name)) {
+        flags[name] = 'true'
+      } else {
+        const next = argv[i + 1]
+        if (next !== undefined && !next.startsWith('-')) {
+          flags[name] = next
+          i++
+        } else {
+          flags[name] = 'true'
+        }
+      }
+    } else {
+      positional.push(arg)
+    }
+  }
+
+  return { flags, positional }
+}

package/src/index.js

@@ -1,3 +1,4 @@
 export { createConfigLoader, getXdgConfigDir, deepMerge, resolveEnvVars, resolvePkgVars } from './config-loader.js'
 export { Shell } from './shell.js'
-export { parseProxy, openTunnel, fetchText, downloadToFile } from './http.js'
+export { parseProxy, openTunnel, fetchText, downloadToFile } from './http.js'
+export { parseFlags, DEFAULT_BOOLEAN_FLAGS } from './args.js'