Files
OmniRoute/scripts/dev/gen-icon-map.mjs
diegosouzapw e0d613861e fix(dashboard): F4 — distinct missing-icon glyph, CDN guard, coverage hint
Review follow-ups for KEA-7886 F4-A:
- M1: an unmapped <Icon> name draws SquareDashedBottom (exported as MISSING_ICON_GLYPH)
  instead of CircleDashed, which is ICON_MAP.pending; a test pins that the placeholder
  is neither an ICON_MAP value nor the same drawing as one.
- M2: restore the #3695 guard lost with material-icons-self-hosted.test.ts: neither
  src/app/layout.tsx nor globals.css loads fonts from fonts.googleapis/gstatic.com.
- M3: icon-map-coverage and gen-icon-map point non-icon strings to NOT_ICON_NAMES
  instead of a fake Lucide mapping.
- N6: resolveIcon resolves own keys only (constructor/toString return null), pinned.
- N1/N2: stale dashboard-layout-flag reference; single-file loop inlined.
2026-10-22 02:33:46 -03:00

105 lines
4.5 KiB
JavaScript

#!/usr/bin/env node
// Lista os nomes de ícone em uso (props icon=/iconRight=/emptyIcon=/leadingIcon=, `<Icon name>` e
// `icon: "..."` em constantes) e imprime um esqueleto de ICON_MAP para os que ainda faltam.
// O vocabulário é o dos nomes Material Symbols que as telas já usam, mas a fonte e o pacote
// `material-symbols` saíram no F4 (KEA-7886): todo nome capturado precisa mapear para um ícone
// Lucide em src/shared/constants/iconMap.ts, exceto as strings de NOT_ICON_NAMES abaixo.
// node scripts/dev/gen-icon-map.mjs # esqueleto TS com os nomes que faltam no mapa atual
// node scripts/dev/gen-icon-map.mjs --names # só os nomes, um por linha (usado pelo teste de cobertura)
import fs from "node:fs";
import path from "node:path";
import { fileURLToPath, pathToFileURL } from "node:url";
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
const DIRS = ["src/app", "src/shared"];
// `(?<![-\w])` keeps `data-provider-icon="generic"` and similar attributes out of the icon slots.
const PATTERNS = [
/(?<![-\w])(?:icon|iconRight|emptyIcon|leadingIcon)=\"([a-z][a-z0-9_]+)\"/g, // prop icon="name"
/\bicon:\s*\"([a-z][a-z0-9_]+)\"/g, // { icon: "name" } (sidebar sections, tabs)
/<Icon\b[^>]*\bname=\"([a-z][a-z0-9_]+)\"/g, // <Icon name="name" />
];
// Ternários (`cond ? "a" : "b"`) só contam quando estão num slot de ícone: a expressão de uma prop
// icon=/iconRight=/emptyIcon=/leadingIcon={…} ou de <Icon name={…} />.
const SLOT_PATTERNS = [
/(?<![-\w])(?:icon|iconRight|emptyIcon|leadingIcon)=\{([^{}]*(?:\{[^{}]*\}[^{}]*)*)\}/g, // icon={cond ? "a" : "b"}
/<Icon\b[^>]*\bname=\{([^{}]*(?:\{[^{}]*\}[^{}]*)*)\}/g, // <Icon name={cond ? "a" : "b"} />
];
const TERNARY_RE = /\?\s*\"([a-z][a-z0-9_]+)\"\s*:\s*\"([a-z][a-z0-9_]+)\"/g;
/**
* Strings the scanner sees in an `icon:` slot that never reach <Icon>. Each one was checked by
* hand (2026-10-21): provider-catalog `icon` fields are logo keys (no `<Icon name={provider.icon}>`
* exists), RoutingTab's tile `icon` field is never read, and Button's `icon: "icon"` is a size key.
* Add a name here only with the same proof; a real icon name belongs in ICON_MAP instead.
*/
export const NOT_ICON_NAMES = new Set([
"anthropic", // RoutingTab PROVIDER_TILE_DISPLAY.icon (field unused)
"dahl", // provider catalog logo keys (src/shared/constants/providers/**) ↓
"opencode",
"openference",
"proxy",
"server",
"unorouter",
"vector_polygon",
"icon", // Button ICON_SIZE / size map key `icon: "icon"`
]);
function walk(dir, out = []) {
for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
const p = path.join(dir, e.name);
if (e.isDirectory()) {
if (!/node_modules|__tests__/.test(e.name)) walk(p, out);
} else if (/\.(tsx?|mjs)$/.test(e.name) && !/\.test\./.test(e.name)) out.push(p);
}
return out;
}
/** Icon names used in one source text (sorted, NOT_ICON_NAMES removed). */
export function collectNamesFromSource(text) {
const names = new Set();
const add = (g) => {
if (g && !NOT_ICON_NAMES.has(g)) names.add(g);
};
if (/icon[:=]|<Icon\b/.test(text)) {
for (const re of PATTERNS)
for (const m of text.matchAll(re)) for (const g of m.slice(1)) add(g);
for (const re of SLOT_PATTERNS)
for (const slot of text.matchAll(re))
for (const m of slot[1].matchAll(TERNARY_RE)) for (const g of m.slice(1)) add(g);
}
return [...names].sort();
}
export function collectNames(root = ROOT) {
const names = new Set();
for (const dir of DIRS)
for (const file of walk(path.join(root, dir)))
for (const n of collectNamesFromSource(fs.readFileSync(file, "utf8"))) names.add(n);
return [...names].sort();
}
function existingMap() {
const file = path.join(ROOT, "src/shared/constants/iconMap.ts");
if (!fs.existsSync(file)) return new Set();
return new Set(
[...fs.readFileSync(file, "utf8").matchAll(/^\s+"?([a-z][a-z0-9_]+)"?:\s/gm)].map((m) => m[1])
);
}
if (import.meta.url === pathToFileURL(process.argv[1]).href) {
const names = collectNames();
if (process.argv.includes("--names")) {
console.log(names.join("\n"));
process.exit(0);
}
const have = existingMap();
const missing = names.filter((n) => !have.has(n));
console.log(
`// ${names.length} icon names in use; ${missing.length} missing from ICON_MAP. Map each real icon to a Lucide import in iconMap.ts;`
);
console.log(
"// not an icon (logo key, size key… that never reaches <Icon>)? add it to NOT_ICON_NAMES above, with the proof."
);
for (const n of missing) console.log(` ${n}: /* Lucide */,`);
}