@lark-apaas/coding-steering 0.1.70-alpha.20261021140057 → 0.1.71

package/steering/nestjs-react-fullstack/skills/browser-compat/scripts/check-browser-compat.mjs

@@ -1,799 +0,0 @@
-#!/usr/bin/env node
-/**
- * 浏览器兼容验证：扫描构建产物，判断指定浏览器能否正常运行。
- *
- * 用法（在项目根目录执行，先完成构建）：
- *   node <skill 目录>/scripts/check-browser-compat.mjs --browser "<浏览器>" [--dir <产物目录>] [--bcd <目录>]
- *     --browser  完整 UA 字符串，或简写：chrome 93 / android 93 / webview 93 / ios 15.4 / safari 16 / firefox 92 / edge 90 / samsung 14
- *     --dir      构建产物目录，默认 dist
- *     --bcd      （可选）已有的 @mdn/browser-compat-data 目录，离线或测试时用
- *
- * 浏览器支持数据全部运行时现查 MDN（@mdn/browser-compat-data，首次运行装到 node_modules/.cache/browser-compat/bcd，
- * 不改项目 package.json / lockfile），脚本里不写任何版本号。
- *   - JS：浏览器不认识的语法会让所在脚本整份解析失败。脚本里只有一张「代码节点 → MDN 条目」的对照表（SYNTAX），
- *     覆盖面由测试对照 MDN 数据校验：MDN 新增语法条目时测试会失败，提醒补一行。
- *   - CSS：反查 MDN —— 列出目标浏览器不支持的 @规则、属性、选择器、函数，再到产物里找。MDN 条目名就是 CSS 写法，不需要对照表。
- *
- * 退出码：
- *   0 兼容
- *   1 有 JS 语法在该浏览器上无法解析（所在脚本整份加载失败；打包产物里的通常表现为白屏）
- *   3 JS 都能解析，但有打包配置修不了的问题：运行时构造的正则执行到时会报错，或大面积样式会被丢弃
- *   2 参数、网络、环境问题或无法判断（看 stderr），不要据此改配置
- * 依赖：项目里的 Vite（用它导出的 parseAst 解析 JS、它依赖的 postcss 解析 CSS；已验证 Vite 7、8）。
- */
-import { execFileSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { createRequire } from 'node:module';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-
-// ---------- JS：代码节点 → MDN 条目（只有对应关系，版本号运行时查） ----------
-
-const isPrivate = (n) => n?.type === 'PrivateIdentifier';
-const isLiteral = (n) => n?.type === 'Literal';
-const usesAssert = (n, c) => /^\s*assert\b/.test(c.code.slice(n.source?.end, n.end));
-
-/** [MDN 条目（可多个）, 节点类型, 判断条件]。正则里的语法由 analyzeRegex 识别，见 REGEX_KEYS */
-// prettier-ignore
-export const SYNTAX = [
-  ['javascript.classes.public_class_fields', 'PropertyDefinition', (n) => !n.static && !isPrivate(n.key)],
-  ['javascript.classes.static.class_fields', 'PropertyDefinition', (n) => n.static && !isPrivate(n.key)],
-  ['javascript.classes.private_class_fields', 'PropertyDefinition', (n) => isPrivate(n.key)],
-  ['javascript.classes.private_class_methods', 'MethodDefinition', (n) => isPrivate(n.key)],
-  ['javascript.classes.private_class_fields_in', 'BinaryExpression', (n) => n.operator === 'in' && isPrivate(n.left)],
-  ['javascript.classes.static.initialization_blocks', 'StaticBlock'],
-  ['javascript.functions.method_definitions.async_generator_methods', 'FunctionExpression', (n, c) => n.async && n.generator && c.isMethod],
-  ['javascript.operators.async_generator_function', 'FunctionExpression', (n, c) => n.async && n.generator && !c.isMethod],
-  ['javascript.statements.async_generator_function', 'FunctionDeclaration', (n) => n.async && n.generator],
-  ['javascript.grammar.hashbang_comments', 'Program', (_, c) => c.code.startsWith('#!')],
-  ['javascript.builtins.BigInt', 'Literal', (n) => n.bigint != null],
-  ['javascript.builtins.JSON.json_superset', 'Literal', (n, c) => typeof n.value === 'string' && /[\u2028\u2029]/.test(c.code.slice(n.start, n.end))],
-  ['javascript.functions.rest_parameters.destructuring', 'RestElement', (n, c) => /Function/.test(c.parent?.type ?? '') && /Pattern$/.test(n.argument.type)],
-  ['javascript.operators.generator_function.trailing_comma', 'FunctionExpression', (n, c) => n.generator && n.params.length > 0 && /^\s*,/.test(c.code.slice(n.params.at(-1).end, n.body.start))],
-  ['javascript.grammar.numeric_separators', 'Literal', (n) => (typeof n.value === 'number' || n.bigint != null) && String(n.raw).includes('_')],
-  ['javascript.grammar.template_literals.template_literal_revision', 'TaggedTemplateExpression', (n) => n.quasi.quasis.some((q) => q.value.cooked == null)],
-  ['javascript.grammar.trailing_commas.trailing_commas_in_dynamic_import', 'ImportExpression', (n, c) => /,\s*\)$/.test(c.code.slice(n.start, n.end))],
-  ['javascript.operators.await.top_level', 'AwaitExpression', (_, c) => c.fnDepth === 0],
-  ['javascript.operators.await.top_level', 'ForOfStatement', (n, c) => n.await && c.fnDepth === 0],
-  ['javascript.operators.destructuring.rest_in_objects', 'ObjectPattern', (n) => n.properties.some((p) => p.type === 'RestElement')],
-  ['javascript.operators.import', 'ImportExpression'],
-  ['javascript.operators.import.options_parameter', 'ImportExpression', (n) => n.options != null],
-  ['javascript.operators.import_meta', 'MetaProperty', (n) => n.meta.name === 'import'],
-  ['javascript.operators.new_target', 'MetaProperty', (n) => n.meta.name === 'new'],
-  ['javascript.operators.logical_and_assignment', 'AssignmentExpression', (n) => n.operator === '&&='],
-  ['javascript.operators.logical_or_assignment', 'AssignmentExpression', (n) => n.operator === '||='],
-  ['javascript.operators.nullish_coalescing_assignment', 'AssignmentExpression', (n) => n.operator === '??='],
-  ['javascript.operators.nullish_coalescing', 'LogicalExpression', (n) => n.operator === '??'],
-  ['javascript.operators.optional_chaining', 'ChainExpression'],
-  [['javascript.operators.object_initializer.spread_properties', 'javascript.operators.spread.spread_in_object_literals'], 'ObjectExpression', (n) => n.properties.some((p) => p.type === 'SpreadElement')],
-  [['javascript.statements.for_await_of', 'javascript.statements.for_of.async_iterators'], 'ForOfStatement', (n) => n.await],
-  ['javascript.statements.try_catch.optional_catch_binding', 'CatchClause', (n) => !n.param],
-  ['javascript.statements.using', 'VariableDeclaration', (n) => n.kind === 'using'],
-  ['javascript.statements.await_using', 'VariableDeclaration', (n) => n.kind === 'await using'],
-  ['javascript.statements.export.namespace', 'ExportAllDeclaration', (n) => n.exported != null],
-  ['javascript.statements.export.arbitrary_module_namespace_identifier_names', 'ExportSpecifier', (n) => isLiteral(n.exported) || isLiteral(n.local)],
-  ['javascript.statements.export.arbitrary_module_namespace_identifier_names', 'ExportAllDeclaration', (n) => isLiteral(n.exported)],
-  ['javascript.statements.import.arbitrary_module_namespace_identifier_names', 'ImportSpecifier', (n) => isLiteral(n.imported)],
-  ...['ImportDeclaration', 'ExportNamedDeclaration', 'ExportAllDeclaration'].flatMap((type) => [
-    ['javascript.statements.import.import_attributes', type, (n, c) => n.attributes?.length > 0 && !usesAssert(n, c)],
-    ['javascript.statements.import.import_assertions', type, (n, c) => n.attributes?.length > 0 && usesAssert(n, c)],
-  ]),
-];
-
-export const REGEX_KEYS = {
-  lookbehind: 'javascript.regular_expressions.lookbehind_assertion',
-  namedGroup: 'javascript.regular_expressions.named_capturing_group',
-  duplicateNames:
-    'javascript.regular_expressions.named_capturing_group.duplicate_named_capturing_groups',
-  namedBackreference: 'javascript.regular_expressions.named_backreference',
-  modifier: 'javascript.regular_expressions.modifier',
-  unicodeProperty: 'javascript.regular_expressions.unicode_character_class_escape',
-  s: 'javascript.builtins.RegExp.dotAll',
-  d: 'javascript.builtins.RegExp.hasIndices',
-  v: 'javascript.builtins.RegExp.unicodeSets',
-};
-
-/** 逐字符扫描正则，返回用到的 MDN 条目：跳过转义字符，字符类 [...] 里的内容不当作分组 */
-export function analyzeRegex(pattern, flags = '') {
-  const out = new Set(
-    [...flags].filter((f) => REGEX_KEYS[f] && f.length === 1).map((f) => REGEX_KEYS[f]),
-  );
-  const unicode = flags.includes('u') || flags.includes('v');
-  const names = new Map();
-  let backref = false;
-  let classDepth = 0;
-  for (let i = 0; i < pattern.length; i++) {
-    const c = pattern[i];
-    if (c === '\\') {
-      const n = pattern[i + 1];
-      if (unicode && (n === 'p' || n === 'P') && pattern[i + 2] === '{')
-        out.add(REGEX_KEYS.unicodeProperty);
-      if (n === 'k' && pattern[i + 2] === '<') backref = true;
-      i++;
-    } else if (c === '[') {
-      classDepth = flags.includes('v') ? classDepth + 1 : 1; // 只有 v 标志下字符类能嵌套
-    } else if (c === ']' && classDepth > 0) {
-      classDepth--;
-    } else if (classDepth === 0 && c === '(' && pattern[i + 1] === '?') {
-      const rest = pattern.slice(i + 2);
-      let m;
-      if (rest.startsWith('<=') || rest.startsWith('<!')) out.add(REGEX_KEYS.lookbehind);
-      else if ((m = rest.match(/^<([^>]+)>/))) names.set(m[1], (names.get(m[1]) || 0) + 1);
-      else if (rest[0] !== ':' && /^[ims]*(?:-[ims]+)?:/.test(rest)) out.add(REGEX_KEYS.modifier);
-    }
-  }
-  if (names.size) out.add(REGEX_KEYS.namedGroup);
-  if ([...names.values()].some((n) => n > 1)) out.add(REGEX_KEYS.duplicateNames);
-  if (backref && (names.size || unicode)) out.add(REGEX_KEYS.namedBackreference); // 否则 \k 只是普通转义
-  return out;
-}
-
-// ---------- 通用工具 ----------
-
-class UsageError extends Error {}
-const fail = (msg) => {
-  throw new UsageError(msg);
-};
-
-export function cmpVersion(a, b) {
-  const pa = String(a).split('.').map(Number);
-  const pb = String(b).split('.').map(Number);
-  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
-    const d = (pa[i] || 0) - (pb[i] || 0);
-    if (d) return d;
-  }
-  return 0;
-}
-
-/** 浏览器 version 是否满足最低版本 need；need === false 表示该浏览器任何版本都不支持 */
-const supports = (version, need) => need !== false && cmpVersion(version, need) >= 0;
-
-/**
- * 从 MDN 条目取「最早能用」的版本：排除需开 flag、带前缀、换名的实现；部分实现也算。
- * 返回 null 表示 MDN 里没有这个条目或没有该浏览器的数据（调用方当作无法判断）；false 表示不支持。
- */
-export function minVersion(bcd, key, browser) {
-  const support = key.split('.').reduce((o, k) => o?.[k], bcd)?.__compat?.support;
-  if (!support || !(browser in support)) return null;
-  const versions = []
-    .concat(support[browser])
-    .filter(
-      (e) =>
-        !e.flags &&
-        !e.prefix &&
-        !e.alternative_name &&
-        /^≤?\d+(\.\d+)*$/.test(String(e.version_added)),
-    )
-    .map((e) => e.version_added.replace(/^≤/, ''))
-    .sort(cmpVersion);
-  return versions[0] ?? false;
-}
-
-/** MDN 条目的说明文字（去掉 HTML） */
-function describe(bcd, key) {
-  const d = key.split('.').reduce((o, k) => o?.[k], bcd)?.__compat?.description;
-  const text = (d || key.split('.').pop().replace(/_/g, ' ')).replace(/<[^>]+>/g, '');
-  return text
-    .replace(/&lt;/g, '<')
-    .replace(/&gt;/g, '>')
-    .replace(/&amp;/g, '&')
-    .replace(/&quot;/g, '"');
-}
-
-const BROWSER_ALIASES = {
-  chrome: 'chrome',
-  android: 'chrome_android',
-  webview: 'webview_android',
-  edge: 'edge',
-  firefox: 'firefox',
-  safari: 'safari',
-  ios: 'safari_ios',
-  samsung: 'samsunginternet_android',
-};
-
-/** 识别浏览器；返回 { id, label, version }，无法识别返回 null，能识别但无法验证的返回 { error } */
-export function parseBrowser(input) {
-  if (!input) return null;
-  const ua = String(input).trim();
-  let m;
-  if (
-    (m = ua.match(
-      /^(chrome|android|webview|edge|firefox|safari|ios|samsung)\s*v?(\d+(?:\.\d+)*)$/i,
-    ))
-  ) {
-    const id = BROWSER_ALIASES[m[1].toLowerCase()];
-    if ((id === 'chrome_android' || id === 'webview_android') && Number(m[2].split('.')[0]) < 30)
-      return {
-        error: `「${ua}」看起来是安卓系统版本，不是浏览器内核版本。请改用 Chrome 内核版本（chrome://version 里 Chrome/ 后面的数字），或直接传完整 UA`,
-      };
-    return { id, label: `${m[1]} ${m[2]}`, version: m[2] };
-  }
-  // iOS 上所有浏览器和 App 内页面都用系统 WebKit：Safari 的 UA 带 Version/x，比可能被冻结的系统版本号更准
-  if ((m = ua.match(/(?:iPhone|iPad|iPod).*?OS (\d+)[_.](\d+)/))) {
-    const version = ua.match(/Version\/(\d+(?:\.\d+)?)/)?.[1] ?? `${m[1]}.${m[2]}`;
-    return { id: 'safari_ios', label: `iOS ${version}（WebKit）`, version };
-  }
-  if ((m = ua.match(/SamsungBrowser\/(\d+(?:\.\d+)?)/)))
-    return { id: 'samsunginternet_android', label: `Samsung Internet ${m[1]}`, version: m[1] };
-  if ((m = ua.match(/Edg(?:e|A)?\/(\d+)/)))
-    return { id: 'edge', label: `Edge ${m[1]}`, version: m[1] };
-  if ((m = ua.match(/Firefox\/(\d+(?:\.\d+)?)/)))
-    return { id: 'firefox', label: `Firefox ${m[1]}`, version: m[1] };
-  if ((m = ua.match(/Chrome\/(\d+)/))) {
-    if (!/Android/i.test(ua)) return { id: 'chrome', label: `Chrome ${m[1]}`, version: m[1] };
-    const webview = /; wv\)/.test(ua);
-    return {
-      id: webview ? 'webview_android' : 'chrome_android',
-      label: `Android ${webview ? 'WebView' : 'Chrome 内核'} ${m[1]}`,
-      version: m[1],
-    };
-  }
-  if (/Android/i.test(ua))
-    return {
-      error:
-        '这个安卓 UA 里没有 Chrome/ 内核版本号（老系统自带浏览器、部分厂商浏览器），判断不了内核版本，无法验证。可以请用户换 Chrome 内核的浏览器复现',
-    };
-  if ((m = ua.match(/Version\/(\d+(?:\.\d+)?).*Safari/)))
-    return { id: 'safari', label: `Safari ${m[1]}`, version: m[1] };
-  return null;
-}
-
-// ---------- 收集产物 ----------
-
-function walkFiles(dir, out = []) {
-  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
-    const p = path.join(dir, e.name);
-    if (e.isDirectory()) e.name !== 'node_modules' && walkFiles(p, out);
-    else out.push(p);
-  }
-  return out;
-}
-
-/** 产物里的 JS 文件和 HTML 内联脚本、CSS 文件和 HTML 内联样式 */
-export function collect(dir) {
-  const scripts = [];
-  const styles = [];
-  for (const p of walkFiles(dir)) {
-    if (/\.m?js$/.test(p))
-      scripts.push({ file: p, code: fs.readFileSync(p, 'utf8'), sourceType: 'module' });
-    else if (p.endsWith('.css')) styles.push({ file: p, code: fs.readFileSync(p, 'utf8') });
-    else if (/\.html?$/.test(p)) {
-      const html = fs.readFileSync(p, 'utf8');
-      let i = 0;
-      for (const m of html.matchAll(/<script\b([^>]*)>([\s\S]*?)<\/script>/gi)) {
-        const type = m[1].match(/\btype\s*=\s*["']?([^"'\s>]+)/i)?.[1];
-        if (/\bsrc\s*=/.test(m[1]) || !m[2].trim()) continue;
-        if (type && !/^(module|text\/javascript|application\/javascript)$/i.test(type)) continue; // json / importmap 等
-        scripts.push({
-          file: `${p}#inline-script-${++i}`,
-          code: m[2],
-          sourceType: type === 'module' ? 'module' : 'script',
-        });
-      }
-      let j = 0;
-      for (const m of html.matchAll(/<style\b[^>]*>([\s\S]*?)<\/style>/gi))
-        if (m[1].trim()) styles.push({ file: `${p}#inline-style-${++j}`, code: m[1] });
-    }
-  }
-  return { scripts, styles };
-}
-
-// ---------- JS 识别 ----------
-
-const staticString = (n) =>
-  n?.type === 'Literal' && typeof n.value === 'string'
-    ? n.value
-    : n?.type === 'TemplateLiteral' && n.expressions.length === 0
-      ? n.quasis[0]?.value?.cooked
-      : undefined;
-const calleeName = (n) =>
-  n?.type === 'Identifier'
-    ? n.name
-    : n?.type === 'MemberExpression' && !n.computed
-      ? n.property?.name
-      : null;
-
-/**
- * 识别产物用到的语法。每个条目在每个文件只记第一处。
- *   hits：解析期就要支持的语法；loadTime：模块顶层的 RegExp(...)（脚本一加载就执行，等同于整份失败）；
- *   runtime：函数里的 RegExp(...)（执行到才报错）；
- *   tryRegExp：写在 try 块里的 RegExp（多为特性检测，不计入结论）；unparsable：解析失败的脚本
- */
-export function detectJs(scripts, parseAst) {
-  const rules = new Map();
-  for (const [keys, type, when] of SYNTAX)
-    rules.set(type, [...(rules.get(type) || []), { keys: [].concat(keys), when }]);
-  const hits = new Map();
-  const loadTime = new Map();
-  const runtime = new Map();
-  const tryRegExp = [];
-  const unparsable = [];
-  const add = (map, key, file, pos) => {
-    const list = map.get(key) || [];
-    if (!list.some((l) => l.file === file)) list.push({ file, pos });
-    map.set(key, list);
-  };
-  for (const { file, code, sourceType } of scripts) {
-    let ast;
-    let error;
-    // 先按模块解析，失败再按经典脚本试一次（public/ 里的老 SDK 等不是模块）
-    for (const type of sourceType === 'module' ? ['module', 'script'] : ['script']) {
-      try {
-        ast = parseAst(code, { lang: 'js', sourceType: type });
-        break;
-      } catch (e) {
-        error ??= e;
-      }
-    }
-    if (!ast) {
-      const lines = String(error?.message || error)
-        .split('\n')
-        .map((l) => l.trim());
-      const useful = lines.filter((l) => l && !/^Parse failed with/.test(l));
-      unparsable.push({ file, error: useful.slice(0, 2).join(' ').slice(0, 200) });
-      continue;
-    }
-    // 用显式栈遍历，避免超深的表达式把调用栈撑爆
-    const stack = [[ast, null, 0, false]];
-    while (stack.length) {
-      const [n, parent, fnDepth, inTry] = stack.pop();
-      const ctx = {
-        code,
-        fnDepth,
-        parent,
-        isMethod:
-          parent?.type === 'MethodDefinition' || (parent?.type === 'Property' && parent.method),
-      };
-      for (const r of rules.get(n.type) || [])
-        if (!r.when || r.when(n, ctx)) for (const k of r.keys) add(hits, k, file, n.start ?? 0);
-      if (n.type === 'Literal' && n.regex)
-        for (const k of analyzeRegex(n.regex.pattern, n.regex.flags)) add(hits, k, file, n.start);
-      // 打包器把目标浏览器不支持的正则字面量改写成 RegExp("…")，报错从解析期推迟到执行时
-      if (
-        (n.type === 'CallExpression' || n.type === 'NewExpression') &&
-        calleeName(n.callee) === 'RegExp'
-      ) {
-        const pattern = staticString(n.arguments[0]);
-        const flags = n.arguments[1] ? staticString(n.arguments[1]) : '';
-        const keys = analyzeRegex(pattern ?? '', flags ?? ''); // pattern 是变量时只能检查标志
-        if (keys.size && inTry) tryRegExp.push({ file, pos: n.start });
-        else for (const k of keys) add(fnDepth === 0 ? loadTime : runtime, k, file, n.start);
-      }
-      const isFn =
-        n.type === 'FunctionDeclaration' ||
-        n.type === 'FunctionExpression' ||
-        n.type === 'ArrowFunctionExpression';
-      for (const k in n) {
-        if (k === 'parent') continue;
-        for (const c of [].concat(n[k] ?? []))
-          if (c && typeof c.type === 'string')
-            // 进入函数体就不再算在 try 里：函数可能在 try 之外被调用
-            stack.push([
-              c,
-              n,
-              fnDepth + (isFn ? 1 : 0),
-              isFn ? false : inTry || (n.type === 'TryStatement' && k === 'block'),
-            ]);
-      }
-    }
-  }
-  return { hits, loadTime, runtime, tryRegExp, unparsable };
-}
-
-// ---------- CSS：反查 MDN ----------
-
-const lastUrlSegment = (c) =>
-  decodeURIComponent(
-    String(c?.mdn_url || '')
-      .split('/')
-      .pop(),
-  );
-
-/** 列出目标浏览器不支持的 CSS 条目：@规则、属性、选择器（伪类/伪元素、嵌套 &）、值函数 */
-export function cssUnsupported(bcd, target) {
-  const out = [];
-  const consider = (kind, key, token) => {
-    const need = minVersion(bcd, key, target.id);
-    if (need !== null && !supports(target.version, need)) out.push({ kind, key, token, need });
-  };
-  for (const name of Object.keys(bcd.css['at-rules']))
-    consider('at-rule', `css.at-rules.${name}`, name);
-  for (const name of Object.keys(bcd.css.properties))
-    if (!name.startsWith('-')) consider('property', `css.properties.${name}`, name);
-  for (const [name, node] of Object.entries(bcd.css.selectors)) {
-    if (name === 'nesting') consider('nesting', 'css.selectors.nesting', '&');
-    else if (lastUrlSegment(node.__compat).startsWith(':'))
-      consider('selector', `css.selectors.${name}`, lastUrlSegment(node.__compat).toLowerCase());
-  }
-  (function walk(obj, key) {
-    for (const [name, node] of Object.entries(obj)) {
-      if (name === '__compat' || typeof node !== 'object') continue;
-      // 文档页名与条目名一致的才是函数（如 color-mix）；<color> 这类数据类型本身的页名是 color_value
-      if (node.__compat && lastUrlSegment(node.__compat) === name)
-        consider('function', `${key}.${name}`, name);
-      walk(node, `${key}.${name}`);
-    }
-  })(bcd.css.types, 'css.types');
-  return out;
-}
-
-// 带浏览器前缀的同名属性（-webkit-user-select 之于 user-select）也算兜底写法
-const unprefixed = (prop) => prop.toLowerCase().replace(/^-(webkit|moz|ms|o)-/, '');
-const pseudoTokens = (selector) =>
-  (
-    selector
-      .replace(/\\./g, '')
-      .replace(/"[^"]*"|'[^']*'/g, '')
-      .replace(/\[[^\]]*\]/g, '')
-      .match(/::?[a-z][a-z-]*/gi) || []
-  ).map((t) => t.toLowerCase());
-const valueFunctions = (value) =>
-  [
-    ...value
-      .replace(/"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'/g, '""')
-      .matchAll(/(?<![\w-])([a-z][a-z0-9-]*)\(/gi),
-  ].map((m) => m[1].toLowerCase());
-
-/**
- * 在样式里找出这些不支持的条目。写在 @supports 里、条件提到了该写法的，以及同一规则里前面已有同名属性兜底的，算渐进增强，不计。
- * 返回 { found: Map(key -> { feature, nodes }), lengthOf, totalBytes, unparsable }
- */
-export function detectCss(styles, postcss, unsupported) {
-  const index = {
-    'at-rule': new Map(),
-    property: new Map(),
-    selector: new Map(),
-    function: new Map(),
-    nesting: new Map(),
-  };
-  for (const f of unsupported) index[f.kind].set(f.token, f);
-  const found = new Map();
-  const unparsable = [];
-  let totalBytes = 0;
-  const guarded = (node, token) => {
-    for (let p = node.parent; p; p = p.parent)
-      if (
-        p.type === 'atrule' &&
-        p.name.toLowerCase() === 'supports' &&
-        p.params.toLowerCase().includes(token)
-      )
-        return true;
-    if (node.type !== 'decl') return false;
-    const siblings = node.parent?.nodes || [];
-    return siblings
-      .slice(0, siblings.indexOf(node))
-      .some((s) => s.type === 'decl' && unprefixed(s.prop) === unprefixed(node.prop));
-  };
-  const hit = (feature, node, token) => {
-    if (!feature || guarded(node, token)) return;
-    const entry = found.get(feature.key) || { feature, nodes: [] };
-    entry.nodes.push(node);
-    found.set(feature.key, entry);
-  };
-  for (const { file, code } of styles) {
-    let root;
-    try {
-      root = postcss.parse(code, { from: file });
-    } catch (e) {
-      unparsable.push({
-        file,
-        error: String(e?.message || e)
-          .split('\n')[0]
-          .slice(0, 160),
-      });
-      continue;
-    }
-    totalBytes += root.toString().length;
-    root.walk((node) => {
-      if (node.type === 'atrule')
-        hit(index['at-rule'].get(node.name.toLowerCase()), node, `@${node.name.toLowerCase()}`);
-      else if (node.type === 'rule') {
-        for (const t of pseudoTokens(node.selector)) hit(index.selector.get(t), node, t);
-        if (node.parent?.type === 'rule') hit(index.nesting.get('&'), node, '&');
-      } else if (node.type === 'decl') {
-        if (!node.prop.startsWith('--'))
-          hit(index.property.get(node.prop.toLowerCase()), node, node.prop.toLowerCase());
-        for (const fn of new Set(valueFunctions(node.value)))
-          hit(index.function.get(fn), node, `${fn}(`);
-      }
-    });
-  }
-  const lengths = new Map();
-  const lengthOf = (n) =>
-    lengths.has(n) ? lengths.get(n) : lengths.set(n, n.toString().length).get(n);
-  return { found, lengthOf, totalBytes, unparsable };
-}
-
-/** 版本 version 下会被丢弃的样式占比：只算最外层被丢弃的节点，嵌在里面的不重复计算 */
-function droppedShare(css, version, keys = [...css.found.keys()]) {
-  const nodes = new Set();
-  for (const k of keys) {
-    const { feature, nodes: list } = css.found.get(k);
-    if (!supports(version, feature.need)) list.forEach((n) => nodes.add(n));
-  }
-  let bytes = 0;
-  for (const n of nodes) {
-    let covered = false;
-    for (let p = n.parent; p && !covered; p = p.parent) covered = nodes.has(p);
-    if (!covered) bytes += css.lengthOf(n);
-  }
-  return css.totalBytes ? bytes / css.totalBytes : 0;
-}
-
-/** 丢弃超过这个比例算「样式大面积缺失」 */
-const CSS_MAJOR_LOSS = 0.1;
-
-// ---------- MDN 数据 ----------
-
-function readJson(file) {
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-/** 优先 --bcd；否则用缓存，没有或损坏就现装一份（先装到临时目录再改名，中途失败不会留下半装的缓存） */
-function loadBcd(project, bcdArg) {
-  if (bcdArg) {
-    const data = readJson(path.join(path.resolve(project, bcdArg), 'data.json'));
-    if (!data) fail(`--bcd 指定的目录里没有可读的 @mdn/browser-compat-data data.json：${bcdArg}`);
-    return data;
-  }
-  const cacheDir = path.join(project, 'node_modules', '.cache', 'browser-compat', 'bcd');
-  const dataFile = (d) => path.join(d, 'node_modules', '@mdn', 'browser-compat-data', 'data.json');
-  const cached = readJson(dataFile(cacheDir));
-  if (cached) return cached;
-  const tmpDir = `${cacheDir}.tmp-${process.pid}`;
-  try {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-    fs.mkdirSync(tmpDir, { recursive: true });
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      '{"name":"browser-compat-bcd-cache","private":true}\n',
-    );
-    // 用项目自己的 npm 源（.npmrc），沙箱里不一定能直连公网 npm；锁大版本，数据结构变化时由维护者升级
-    const registry = execFileSync('npm', ['config', 'get', 'registry'], {
-      cwd: project,
-      encoding: 'utf8',
-    }).trim();
-    execFileSync(
-      'npm',
-      [
-        'install',
-        '@mdn/browser-compat-data@8',
-        '--no-save',
-        '--no-package-lock',
-        '--no-audit',
-        '--no-fund',
-        '--ignore-scripts',
-        `--registry=${registry}`,
-      ],
-      { cwd: tmpDir, stdio: ['ignore', 'ignore', 'pipe'], timeout: 120000 },
-    );
-    const fresh = readJson(dataFile(tmpDir));
-    if (!fresh) throw new Error('安装后读不到 data.json');
-    fs.rmSync(cacheDir, { recursive: true, force: true });
-    try {
-      fs.renameSync(tmpDir, cacheDir);
-    } catch {
-      /* 并发时别的进程先放好了缓存，直接用这次装的数据 */
-    }
-    return fresh;
-  } catch (e) {
-    const msg =
-      String(e?.stderr || e?.message || e)
-        .split('\n')
-        .find((l) => l.trim()) || '';
-    return fail(
-      `无法获取 MDN 浏览器兼容数据（需要访问 npm 源安装 @mdn/browser-compat-data）：${msg.slice(0, 200)}`,
-    );
-  } finally {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  }
-}
-
-// ---------- 主流程 ----------
-
-async function main() {
-  const argv = process.argv.slice(2);
-  const opt = (k) => {
-    const i = argv.indexOf(`--${k}`);
-    return i >= 0 ? argv[i + 1] : undefined;
-  };
-  const project = process.cwd();
-  const dir = path.resolve(project, opt('dir') || 'dist');
-  const target = parseBrowser(opt('browser'));
-  if (target?.error) fail(target.error);
-  if (!target)
-    fail(
-      `无法识别浏览器：${opt('browser') ?? '（未提供 --browser）'}。请传完整 UA，或简写：chrome 93 / android 93 / ios 15.4 / safari 16 / firefox 92 / edge 90 / samsung 14`,
-    );
-  if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory())
-    fail(`产物目录不存在：${path.relative(project, dir) || dir}。先构建，再用 --dir 指向产物目录`);
-
-  let vite;
-  let postcss;
-  try {
-    const req = createRequire(path.join(project, 'package.json'));
-    const viteEntry = req.resolve('vite');
-    vite = await import(pathToFileURL(viteEntry).href);
-    const pc = await import(pathToFileURL(createRequire(viteEntry).resolve('postcss')).href);
-    postcss = pc.default ?? pc;
-  } catch {
-    /* 下面统一报错 */
-  }
-  if (typeof vite?.parseAst !== 'function' || typeof postcss?.parse !== 'function')
-    fail(
-      '当前项目的 vite 不提供 parseAst / postcss（Vite 版本过旧；已验证 Vite 7、8 可用），本脚本无法验证',
-    );
-
-  const bcd = loadBcd(project, opt('bcd'));
-  const { scripts, styles } = collect(dir);
-  if (!scripts.length)
-    fail(`产物目录 ${path.relative(project, dir)} 下没有找到 JS，确认构建是否成功、--dir 是否指对`);
-
-  // 不支持 ES 模块的浏览器根本不会执行 Vite 产物
-  const esm = minVersion(bcd, 'javascript.statements.import', target.id);
-  const js = detectJs(scripts, vite.parseAst);
-  const keysOf = (map) => [...map.keys()];
-  const missing = [
-    ...new Set([...keysOf(js.hits), ...keysOf(js.loadTime), ...keysOf(js.runtime)]),
-  ].filter((k) => minVersion(bcd, k, target.id) === null);
-  if (esm === null || missing.length)
-    fail(
-      `无法判断：MDN 数据（${bcd.__meta?.version ?? '未知版本'}）里没有 ${target.id} 的这些条目：${[esm === null ? 'javascript.statements.import' : '', ...missing].filter(Boolean).join('、')}`,
-    );
-  const issues = (map) =>
-    keysOf(map)
-      .map((key) => ({ key, need: minVersion(bcd, key, target.id), locs: map.get(key) }))
-      .filter((i) => !supports(target.version, i.need))
-      .sort((a, b) => (a.need === false ? -1 : b.need === false ? 1 : cmpVersion(b.need, a.need)));
-  const parseIssues = issues(js.hits);
-  if (!supports(target.version, esm))
-    parseIssues.unshift({ key: 'javascript.statements.import', need: esm, locs: [] });
-  const loadIssues = issues(js.loadTime);
-  const runtimeIssues = issues(js.runtime);
-  // 从能运行 Vite 产物的最低版本（ES 模块）开始收集不支持的样式，才能算出「从哪个版本起样式基本可用」
-  const cssFloor = typeof esm === 'string' ? esm : target.version;
-  const css = detectCss(styles, postcss, cssUnsupported(bcd, { id: target.id, version: cssFloor }));
-  const cssShare = droppedShare(css, target.version);
-
-  const rel = (f) => {
-    const [file, frag] = f.split('#');
-    const r = path.relative(project, file);
-    return (r.startsWith('..') ? file : r) + (frag ? `#${frag}` : '');
-  };
-  const codeOf = new Map(scripts.map((s) => [s.file, s.code]));
-  const snippet = (f, pos) =>
-    (codeOf.get(f) || '').slice(Math.max(0, pos - 40), pos + 80).replace(/\s+/g, ' ');
-  const ver = (need) => (need === false ? '（该浏览器任何版本都不支持）' : `≥ ${need}`);
-  const pct = (x) => `${x > 0 && x < 0.01 ? '<1' : Math.round(x * 100)}%`;
-  const printIssues = (list) => {
-    for (const i of list) {
-      console.log(`  ✗ ${describe(bcd, i.key)}（${i.key}）：需要 ${target.id} ${ver(i.need)}`);
-      for (const l of i.locs.slice(0, 3))
-        console.log(`      ${rel(l.file)}  …${snippet(l.file, l.pos)}…`);
-      if (i.locs.length > 3) console.log(`      ……另有 ${i.locs.length - 3} 个文件`);
-    }
-  };
-
-  console.log(`目标浏览器：${target.label}（${target.id} ${target.version}）`);
-  console.log(
-    `数据：MDN @mdn/browser-compat-data ${bcd.__meta?.version ?? ''}；扫描 ${scripts.length} 段脚本、${styles.length} 份样式（${rel(dir) || '.'}）`,
-  );
-
-  console.log('\n【JS】');
-  if (!supports(target.version, esm))
-    console.log('  该浏览器不支持 ES 模块（<script type="module">），Vite 产物整体不会执行');
-  const syntaxIssues = parseIssues.filter((i) => i.locs.length);
-  if (syntaxIssues.length) {
-    console.log(`  有 ${syntaxIssues.length} 种语法在该浏览器上无法解析，所在脚本会整份加载失败：`);
-    printIssues(syntaxIssues);
-  } else if (supports(target.version, esm)) console.log('  没有该浏览器无法解析的语法');
-  if (loadIssues.length) {
-    console.log('  在模块顶层构造的正则（RegExp(…)，脚本一加载就执行，所在脚本整份失败）：');
-    printIssues(loadIssues);
-  }
-  if (runtimeIssues.length) {
-    console.log(
-      '  函数里构造的正则（RegExp(…)，执行到这里时报错；如果这个函数在页面加载过程中就被调用，仍会白屏）：',
-    );
-    printIssues(runtimeIssues);
-  }
-  if (js.tryRegExp.length)
-    console.log(
-      `  · ${js.tryRegExp.length} 处写在 try 块里的 RegExp 用到了新正则语法，按特性检测处理，未计入结论（${[...new Set(js.tryRegExp.map((t) => rel(t.file)))].slice(0, 3).join('、')}）`,
-    );
-  if (js.unparsable.length) {
-    console.log(`  ⚠ ${js.unparsable.length} 段脚本无法解析，没有参与判断：`);
-    for (const u of js.unparsable.slice(0, 5)) console.log(`    - ${rel(u.file)}：${u.error}`);
-  }
-  const jsNeeds = [...js.hits.keys()]
-    .map((k) => minVersion(bcd, k, target.id))
-    .filter((v) => typeof v === 'string');
-  if (jsNeeds.length) console.log(`  JS 能解析所需的最低版本：${jsNeeds.sort(cmpVersion).pop()}`);
-
-  console.log('\n【CSS】');
-  if (!styles.length) console.log('  产物里没有样式');
-  else if (![...css.found.values()].some((e) => !supports(target.version, e.feature.need)))
-    console.log('  没有该浏览器不支持的样式写法');
-  else {
-    console.log(`  该浏览器上会被丢弃的样式：约 ${pct(cssShare)}（按字节估算）`);
-    const all = [...css.found.values()];
-    const entries = all
-      .filter((e) => !supports(target.version, e.feature.need))
-      .map((e) => ({ ...e, share: droppedShare(css, target.version, [e.feature.key]) }));
-    entries.sort((a, b) => b.share - a.share || b.nodes.length - a.nodes.length);
-    for (const e of entries.slice(0, 12)) {
-      const f = e.feature;
-      const effect =
-        f.kind === 'at-rule'
-          ? `${e.nodes.length} 个 @${f.token} 块整块丢弃，约占样式 ${pct(e.share)}`
-          : f.kind === 'selector' || f.kind === 'nesting'
-            ? `${e.nodes.length} 条规则整条失效`
-            : `${e.nodes.length} 条声明失效`;
-      const name =
-        f.kind === 'at-rule' ? `@${f.token}` : f.kind === 'function' ? `${f.token}()` : f.token;
-      console.log(
-        `  ${e.share >= CSS_MAJOR_LOSS ? '✗' : '·'} ${name}（${f.key}）：需要 ${target.id} ${ver(f.need)}；${effect}`,
-      );
-    }
-    if (entries.length > 12) console.log(`  · 另有 ${entries.length - 12} 项影响较小`);
-    // 样式基本可用 / 全部生效分别需要的版本：从 ES 模块的最低版本起，在检测到的条目的最低版本里逐个试
-    const candidates = [
-      ...new Set([cssFloor, ...all.map((e) => e.feature.need).filter((v) => v !== false)]),
-    ].sort(cmpVersion);
-    const basic = candidates.find((v) => droppedShare(css, v) < CSS_MAJOR_LOSS);
-    const never = all.filter((e) => e.feature.need === false).map((e) => e.feature.token);
-    const full = candidates.at(-1);
-    console.log(
-      `  样式基本可用（丢弃 < ${pct(CSS_MAJOR_LOSS)}）：${basic ? `${target.id} ${basic} 起${cmpVersion(target.version, basic) >= 0 ? '，当前版本已满足' : ''}` : '更高版本也达不到'}`,
-    );
-    console.log(
-      `  全部生效：${target.id} ${full} 起` +
-        (never.length
-          ? `（不含 ${target.id} 任何版本都不支持的 ${never.length} 项：${never.slice(0, 5).join('、')}，影响见上方）`
-          : ''),
-    );
-  }
-  if (css.unparsable.length)
-    for (const u of css.unparsable)
-      console.log(`  ⚠ 样式无法解析，没有参与判断：${rel(u.file)}：${u.error}`);
-
-  let code;
-  if (parseIssues.length || loadIssues.length) {
-    code = 1;
-    console.log(
-      `\n结论：不兼容 —— ${parseIssues.length ? '有 JS 语法在该浏览器上无法解析' : '有正则在脚本加载时就会报错'}`,
-    );
-  } else if (runtimeIssues.length || cssShare >= CSS_MAJOR_LOSS) {
-    code = 3;
-    const why = [
-      runtimeIssues.length ? '有正则执行到时会报错（若在页面加载时执行仍会白屏）' : '',
-      cssShare >= CSS_MAJOR_LOSS ? `约 ${pct(cssShare)} 的样式会被丢弃` : '',
-    ].filter(Boolean);
-    console.log(`\n结论：JS 都能解析，但${why.join('，')}；这些打包配置修不了`);
-  } else if (js.unparsable.length) {
-    code = 2;
-    console.log('\n结论：无法完整判断 —— 有脚本解析失败（见上方 ⚠），其余部分没有发现问题');
-  } else {
-    code = 0;
-    console.log('\n结论：兼容 —— JS 都能解析，样式没有大面积缺失');
-  }
-  return code;
-}
-
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-  try {
-    process.exitCode = await main();
-  } catch (e) {
-    // 任何意外都按「无法判断」处理（退出码 2），不能和「不兼容」（1）混在一起
-    console.error(
-      e instanceof UsageError
-        ? e.message
-        : `检查脚本内部错误，本次无法判断：${String(e?.message || e).slice(0, 300)}`,
-    );
-    process.exitCode = 2;
-  }
-}