mirror of
https://github.com/garrytan/gstack.git
synced 2026-11-06 00:44:07 +01:00
garrytanandcapy-ai[bot]
1ba2ae0425
Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
56 lines
3.0 KiB
TypeScript
Executable File
56 lines
3.0 KiB
TypeScript
Executable File
#!/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 <file-or-dir ...> [--render] [--url <http://…>]
|
|
// [--scope page|component] [--job <job>] [--json] [--rules]
|
|
//
|
|
// Prints one "LINT: <blocks|ask|polish|waived> <rule-id> <file>:<line> <evidence> | fix: <fix>"
|
|
// line per finding, then "LINT_SUMMARY: blocks=N ask=N waived=N polish=N render=<ran|skipped: reason>".
|
|
// 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 <file-or-dir ...> [--render] [--url <http://…>] [--scope page|component] [--job <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);
|
|
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);
|