dsh-desktop-kit 0.0.0-stage → 2.0.0

package/skills/seo/assets/scripts/lib/args.mjs

@@ -0,0 +1,105 @@
+// Мини-парсер CLI-аргументов для инструментов design-qa.
+// Поддерживает: --flag, --no-flag, --key value, --key=value, короткие алиасы (-h),
+// позиционные аргументы (в result._), значения-списки через запятую.
+
+export class UsageError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'UsageError';
+    this.isUsageError = true;
+  }
+}
+
+const camel = (s) => s.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+
+/**
+ * @param {string[]} argv  process.argv.slice(2)
+ * @param {{booleans?: string[], values?: string[], aliases?: Record<string,string>, defaults?: Record<string, any>}} spec
+ */
+export function parseArgs(argv, { booleans = [], values = [], aliases = {}, defaults = {} } = {}) {
+  const boolSet = new Set(booleans.map(camel));
+  const valueSet = new Set(values.map(camel));
+  const aliasMap = new Map(Object.entries(aliases)); // alias -> canonical (camelCase)
+  const out = { ...defaults, _: [] };
+
+  for (let i = 0; i < argv.length; i++) {
+    const raw = argv[i];
+    if (raw === '--') {
+      out._.push(...argv.slice(i + 1));
+      break;
+    }
+    if (raw.startsWith('--') || (raw.startsWith('-') && raw.length === 2 && !/^-?\d/.test(raw))) {
+      let body = raw.startsWith('--') ? raw.slice(2) : raw.slice(1);
+      let val;
+      const eq = body.indexOf('=');
+      if (eq !== -1) {
+        val = body.slice(eq + 1);
+        body = body.slice(0, eq);
+      }
+
+      // --no-xxx для булевых флагов
+      if (body.startsWith('no-') && boolSet.has(camel(body.slice(3)))) {
+        const key = camel(body.slice(3));
+        out[key] = val === undefined ? false : !isTruthy(val);
+        continue;
+      }
+
+      const canonical = aliasMap.get(body) ?? camel(body);
+      if (boolSet.has(canonical)) {
+        out[canonical] = val === undefined ? true : isTruthy(val);
+        continue;
+      }
+      if (valueSet.has(canonical)) {
+        if (val === undefined) {
+          const next = argv[i + 1];
+          if (next === undefined || next.startsWith('--')) {
+            throw new UsageError(`Опция ${raw} требует значения`);
+          }
+          val = next;
+          i++;
+        }
+        out[canonical] = val;
+        continue;
+      }
+      throw new UsageError(`Неизвестная опция ${raw}`);
+    }
+    out._.push(raw);
+  }
+  return out;
+}
+
+function isTruthy(v) {
+  return !['false', '0', 'no', 'off'].includes(String(v).toLowerCase());
+}
+
+/** "a,b, c" -> ['a','b','c'] (trim, без пустых, без дублей) */
+export function csv(value) {
+  if (value === undefined || value === null) return [];
+  const arr = Array.isArray(value) ? value : String(value).split(',');
+  const seen = new Set();
+  const out = [];
+  for (const item of arr) {
+    const v = String(item).trim();
+    if (v && !seen.has(v)) {
+      seen.add(v);
+      out.push(v);
+    }
+  }
+  return out;
+}
+
+/** Положить строку в безопасное имя файла. */
+export function safeFileName(value, fallback = 'page') {
+  const s = String(value ?? '')
+    .normalize('NFKD')
+    .replace(/[^\w.\-]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 80);
+  return s || fallback;
+}
+
+/** Вывести строку-справку и завершиться с кодом 0. */
+export function printHelpAndExit(text) {
+  process.stdout.write(text.trimEnd() + '\n');
+  process.exit(0);
+}