#!/usr/bin/env -S bun --no-env-file --config=/dev/null // gstack-design-lint — the free, deterministic design lint behind /design-html // and /design-review. Static tier over .html .css .jsx .tsx .vue .svelte .astro // (Tailwind class strings included); --render measures the page in gstack's own // browser (Aside first, the browse daemon otherwise). // // Usage: gstack-design-lint [--render] [--url ] // [--scope page|component] [--job ] [--json] [--rules] // // Prints one "LINT: : | fix: " // line per finding, then "LINT_SUMMARY: blocks=N ask=N waived=N polish=N render=". // Exit 2 on blocks, 1 on unanswered asks, 0 otherwise; 3 on a usage error. // docs/design-lint.md is the contract. import { formatResult, lint, type LintOptions } from '../lib/design-lint/index'; import { ruleTable } from '../lib/design-lint/report'; const USAGE = 'usage: gstack-design-lint [--render] [--url ] [--scope page|component] [--job ] [--json] [--rules]'; const args = process.argv.slice(2); const opts: LintOptions & { json: boolean; rules: boolean } = { render: false, urls: [], scope: 'page', job: null, json: false, rules: false }; const paths: string[] = []; const take = (flag: string): string => { const v = args[++i]; if (v === undefined) { console.error(`${flag} needs a value`); console.error(USAGE); process.exit(3); } return v; }; let i = 0; for (; i < args.length; i++) { const a = args[i]; if (a === '--render') opts.render = true; else if (a === '--url') { opts.urls!.push(take(a)); opts.render = true; } else if (a === '--scope') { const s = take(a); if (s !== 'page' && s !== 'component') { console.error('--scope must be page or component'); process.exit(3); } opts.scope = s; } else if (a === '--job') opts.job = take(a).trim().toLowerCase(); else if (a === '--json') opts.json = true; else if (a === '--rules') opts.rules = true; else if (a === '--help' || a === '-h') { console.log(USAGE); process.exit(0); } else if (a.startsWith('--')) { console.error(`unknown flag ${a}`); console.error(USAGE); process.exit(3); } else paths.push(a); } if (opts.rules) { for (const r of ruleTable()) console.log(`${r.tier.padEnd(6)} ${r.id.padEnd(26)} ${r.gate.padEnd(7)} ${r.title}`); process.exit(0); } if (!paths.length && !opts.urls!.length) { console.error(USAGE); process.exit(3); } if (opts.urls!.some((u) => !/^https?:\/\//.test(u))) { console.error('--url takes an http or https address'); process.exit(3); } const result = await lint(paths, opts).catch((e: Error) => { console.error(`gstack-design-lint: ${e.message}`); process.exit(3); }); if (!result.files.length && !opts.urls!.length) { console.error('gstack-design-lint: no .html, .css, .jsx, .tsx, .vue, .svelte or .astro files found'); process.exit(3); } if (opts.json) console.log(JSON.stringify({ summary: result.summary, files: result.files.length, findings: result.findings }, null, 2)); else console.log(formatResult(result)); process.exit(result.exitCode);