Web SDK 1.11 upgrade check for custom CSS and JS

#!/usr/bin/env node
// Yuno Web SDK 1.6 -> 1.11 pre-upgrade check for merchant custom CSS/JS.
// Usage: node yuno-upgrade-check.mjs <file-or-dir> [...more]
// Scans .css .scss .less .js .mjs .ts .jsx .tsx .html .vue .liquid .hbs for yuno-* / Yuno-* names and
// reports, per hit, what happens to that name on SDK 1.11. Exit code 1 when something breaks.
// The rename map is read from ./rename-map.json next to this script when present, or from
// YUNO_RENAME_MAP, or fetched from docs.y.uno.
import fs from 'node:fs'; import path from 'node:path';
const MAP_URL = 'https://docs.y.uno/files/validators/web-sdk-1.11-upgrade-check/rename-map.json';
async function loadMap() {
  const local = process.env.YUNO_RENAME_MAP || new URL('./rename-map.json', import.meta.url);
  try { return JSON.parse(fs.readFileSync(local, 'utf8')); } catch {}
  const res = await fetch(MAP_URL);
  if (!res.ok) throw new Error(`cannot load the rename map (${res.status}) from ${MAP_URL}; download it next to this script`);
  return res.json();
}
const MAP = await loadMap();
const EXT = new Set(['.css','.scss','.less','.js','.mjs','.ts','.jsx','.tsx','.html','.vue','.liquid','.hbs']);
const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build']);
const files = [];
const walk = (p) => {
  const st = fs.statSync(p);
  if (st.isDirectory()) {
    for (const f of fs.readdirSync(p)) {
      if (SKIP_DIRS.has(f)) continue; // skip only folders inside the argument, never the argument itself
      walk(path.join(p, f));
    }
  } else if (EXT.has(path.extname(p))) files.push(p);
};
process.argv.slice(2).forEach(a => walk(a));
const NAMES = Object.keys(MAP.names);
const lookup = name => {
  if (MAP.names[name]) return [name, MAP.names[name]];
  // BEM modifier or element of a known block: yuno-status__title--small -> yuno-status__title
  const base = NAMES.filter(k => name.startsWith(k) && /^(__|--)/.test(name.slice(k.length))).sort((a, b) => b.length - a.length)[0];
  return base ? [base, MAP.names[base]] : [null, null];
};
const rows = []; const seen = new Set();
for (const f of files) {
  fs.readFileSync(f, 'utf8').split('\n').forEach((line, i) => {
    for (const m of line.matchAll(/\b[yY]uno-[A-Za-z0-9_-]+/g)) {
      const name = m[0]; const [base, entry] = lookup(name);
      let status, action;
      if (!entry) { status = 'not-sdk'; action = 'not a Yuno SDK 1.6 name: likely your own id/class, no change'; }
      else if (entry.status === 'renamed') { status = 'BREAKS'; action = `rename to ${name.replace(base, entry.to)}`; }
      else if (entry.status === 'removed') { status = 'BREAKS'; action = 'element no longer exists under this name in 1.11: re-check the selector on the 1.11 DOM'; }
      else if (entry.status === 'vtex-layer') { status = 'ok'; action = 'VTEX layer name, unchanged'; }
      else { status = 'ok'; action = 'unchanged (alias kept)'; }
      if (entry?.note && status === 'BREAKS') action += ` (${entry.note})`;
      const key = `${f}:${i + 1}:${name}`; if (seen.has(key)) continue; seen.add(key);
      rows.push({ file: f, line: i + 1, name, status, action });
    }
  });
}
const breaks = rows.filter(r => r.status === 'BREAKS');
for (const r of rows) console.log(`${r.status.padEnd(7)} ${r.file}:${r.line}  ${r.name}  ->  ${r.action}`);
console.log(`\n${files.length} files scanned, ${rows.length} Yuno-looking names, ${breaks.length} break on 1.11.`);
console.log(breaks.length ? 'Fix the BREAKS lines before the upgrade, then test on sandbox (SDK 1.11).' : 'Nothing here depends on the old names.');
process.exit(breaks.length ? 1 : 0);